4 * Copyright 1997 Andreas Mohr
5 * Copyright 2000 Wolfgang Schwotzer
6 * Copyright 2002 David Hagood
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 * - nearly all joystick functions can be regarded as obsolete,
25 * as Linux (2.1.x) now supports extended joysticks with a completely
26 * new joystick driver interface
27 * New driver's docu says:
28 * "For backward compatibility the old interface is still included,
29 * but will be dropped in the future."
30 * Thus we should implement the new interface and at most keep the old
31 * routines for backward compatibility.
32 * - better support of enhanced joysticks (Linux 2.2 interface is available)
33 * - support more joystick drivers (like the XInput extension)
34 * - should load joystick DLL as any other driver (instead of hardcoding)
35 * the driver's name, and load it as any low lever driver.
39 #include "wine/port.h"
49 #ifdef HAVE_SYS_IOCTL_H
50 #include <sys/ioctl.h>
52 #ifdef HAVE_LINUX_IOCTL_H
53 #include <linux/ioctl.h>
55 #ifdef HAVE_LINUX_JOYSTICK_H
56 #include <linux/joystick.h>
57 #define JOYDEV "/dev/js%d"
59 #ifdef HAVE_SYS_ERRNO_H
60 #include <sys/errno.h>
69 #include "wine/debug.h"
71 #include "wine/unicode.h"
73 WINE_DEFAULT_DEBUG_CHANNEL(joystick);
75 #ifdef HAVE_LINUX_JOYSTICK_H
77 #define MAXJOYSTICK (JOYSTICKID2 + 1)
79 typedef struct tagWINE_JSTCK {
82 /* Some extra info we need to make this acutaly work under the
84 First of all, we cannot keep closing and reopening the device file -
85 that blows away the state of the stick device, and we lose events. So, we
86 need to open the low-level device once, and close it when we are done.
88 Secondly, the event API only gives us what's changed. However, Windows apps
89 want the whole state every time, so we have to cache the data.
92 int dev; /* Linux level device file descriptor */
102 static WINE_JSTCK JSTCK_Data[MAXJOYSTICK];
104 /**************************************************************************
105 * JSTCK_drvGet [internal]
107 static WINE_JSTCK *JSTCK_drvGet(DWORD_PTR dwDevID)
111 if ((dwDevID - (DWORD_PTR)JSTCK_Data) % sizeof(JSTCK_Data[0]) != 0)
113 p = (dwDevID - (DWORD_PTR)JSTCK_Data) / sizeof(JSTCK_Data[0]);
114 if (p < 0 || p >= MAXJOYSTICK || !((WINE_JSTCK*)dwDevID)->in_use)
117 return (WINE_JSTCK*)dwDevID;
120 /**************************************************************************
121 * JSTCK_drvOpen [internal]
123 static LRESULT JSTCK_drvOpen(LPSTR str, DWORD dwIntf)
125 if (dwIntf >= MAXJOYSTICK || JSTCK_Data[dwIntf].in_use)
128 JSTCK_Data[dwIntf].joyIntf = dwIntf;
129 JSTCK_Data[dwIntf].in_use = 1;
130 return (LRESULT)&JSTCK_Data[dwIntf];
133 /**************************************************************************
134 * JSTCK_drvClose [internal]
136 static LRESULT JSTCK_drvClose(DWORD_PTR dwDevID)
138 WINE_JSTCK* jstck = JSTCK_drvGet(dwDevID);
158 /**************************************************************************
159 * JSTCK_OpenDevice [internal]
161 static int JSTCK_OpenDevice(WINE_JSTCK* jstick)
169 sprintf(buf, JOYDEV, jstick->joyIntf);
170 #ifdef HAVE_LINUX_22_JOYSTICK_API
171 flags = O_RDONLY | O_NONBLOCK;
175 return (jstick->dev = open(buf, flags));
179 /**************************************************************************
180 * JoyGetDevCaps [MMSYSTEM.102]
182 static LRESULT JSTCK_GetDevCaps(DWORD_PTR dwDevID, LPJOYCAPSW lpCaps, DWORD dwSize)
185 #ifdef HAVE_LINUX_22_JOYSTICK_API
189 char identString[MAXPNAMELEN];
192 static const WCHAR ini[] = {'W','i','n','e',' ','J','o','y','s','t','i','c','k',' ','D','r','i','v','e','r',0};
195 if ((jstck = JSTCK_drvGet(dwDevID)) == NULL)
196 return MMSYSERR_NODRIVER;
198 #ifdef HAVE_LINUX_22_JOYSTICK_API
199 if ((dev = JSTCK_OpenDevice(jstck)) < 0) return JOYERR_PARMS;
200 ioctl(dev, JSIOCGAXES, &nrOfAxes);
201 ioctl(dev, JSIOCGBUTTONS, &nrOfButtons);
202 ioctl(dev, JSIOCGVERSION, &driverVersion);
203 ioctl(dev, JSIOCGNAME(sizeof(identString)), &identString);
204 TRACE("Driver: 0x%06x, Name: %s, #Axes: %d, #Buttons: %d\n",
205 driverVersion, identString, nrOfAxes, nrOfButtons);
206 lpCaps->wMid = MM_MICROSOFT;
207 lpCaps->wPid = MM_PC_JOYSTICK;
208 MultiByteToWideChar(CP_ACP, 0, identString, -1, lpCaps->szPname, MAXPNAMELEN);
209 lpCaps->szPname[MAXPNAMELEN-1] = '\0';
211 lpCaps->wXmax = 0xFFFF;
213 lpCaps->wYmax = 0xFFFF;
215 lpCaps->wZmax = (nrOfAxes >= 3) ? 0xFFFF : 0;
217 /* HalfLife won't allow you to map an axis event to things like
218 "next weapon" and "use". Linux reports the hat on my stick as
219 axis U and V. So, IFF BODGE_THE_HAT is defined, lie through our
220 teeth and say we have 32 buttons, and we will map the axises to
221 the high buttons. Really, perhaps this should be a registry entry,
222 or even a parameter to the Linux joystick driver (which would completely
223 remove the need for this.)
225 lpCaps->wNumButtons = 32;
227 lpCaps->wNumButtons = nrOfButtons;
229 if (dwSize == sizeof(JOYCAPSW)) {
230 /* since we suppose ntOfAxes <= 6 in the following code, do it explicitly */
231 if (nrOfAxes > 6) nrOfAxes = 6;
232 /* complete 95 structure */
234 lpCaps->wRmax = nrOfAxes >= 4 ? 0xFFFF : 0;
236 lpCaps->wUmax = nrOfAxes >= 5 ? 0xFFFF : 0;
238 lpCaps->wVmax = nrOfAxes >= 6 ? 0xFFFF : 0;
239 lpCaps->wMaxAxes = 6; /* same as MS Joystick Driver */
240 lpCaps->wNumAxes = nrOfAxes; /* nr of axes in use */
241 lpCaps->wMaxButtons = 32; /* same as MS Joystick Driver */
242 lpCaps->szRegKey[0] = 0;
243 lpCaps->szOEMVxD[0] = 0;
246 case 6: lpCaps->wCaps |= JOYCAPS_HASV;
247 case 5: lpCaps->wCaps |= JOYCAPS_HASU;
248 case 4: lpCaps->wCaps |= JOYCAPS_HASR;
249 case 3: lpCaps->wCaps |= JOYCAPS_HASZ;
250 /* FIXME: don't know how to detect for
251 JOYCAPS_HASPOV, JOYCAPS_POV4DIR, JOYCAPS_POVCTS */
255 lpCaps->wMid = MM_MICROSOFT;
256 lpCaps->wPid = MM_PC_JOYSTICK;
257 strcpyW(lpCaps->szPname, ini); /* joystick product name */
259 lpCaps->wXmax = 0xFFFF;
261 lpCaps->wYmax = 0xFFFF;
264 lpCaps->wNumButtons = 2;
265 if (dwSize == sizeof(JOYCAPSW)) {
266 /* complete 95 structure */
274 lpCaps->wMaxAxes = 2;
275 lpCaps->wNumAxes = 2;
276 lpCaps->wMaxButtons = 4;
277 lpCaps->szRegKey[0] = 0;
278 lpCaps->szOEMVxD[0] = 0;
282 return JOYERR_NOERROR;
285 /**************************************************************************
286 * JSTCK_GetPos [internal]
288 static LRESULT JSTCK_GetPosEx(DWORD_PTR dwDevID, LPJOYINFOEX lpInfo)
292 #ifdef HAVE_LINUX_22_JOYSTICK_API
299 if ((jstck = JSTCK_drvGet(dwDevID)) == NULL)
300 return MMSYSERR_NODRIVER;
302 if ((dev = JSTCK_OpenDevice(jstck)) < 0) return JOYERR_PARMS;
304 #ifdef HAVE_LINUX_22_JOYSTICK_API
305 while ((read(dev, &ev, sizeof(struct js_event))) > 0) {
306 if (ev.type == (JS_EVENT_AXIS)) {
327 FIXME("Unknown joystick event '%d'\n", ev.number);
329 } else if (ev.type == (JS_EVENT_BUTTON)) {
331 jstck->buttons |= (1 << ev.number);
332 /* FIXME: what to do for this field when
333 * multiple buttons are depressed ?
335 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
336 lpInfo->dwButtonNumber = ev.number + 1;
339 jstck->buttons &= ~(1 << ev.number);
342 /* EAGAIN is returned when the queue is empty */
343 if (errno != EAGAIN) {
344 /* FIXME: error should not be ignored */
345 ERR("Error while reading joystick state (%s)\n", strerror(errno));
347 /* Now, copy the cached values into Window's structure... */
348 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
349 lpInfo->dwButtons = jstck->buttons;
350 if (lpInfo->dwFlags & JOY_RETURNX)
351 lpInfo->dwXpos = jstck->x + 32767;
352 if (lpInfo->dwFlags & JOY_RETURNY)
353 lpInfo->dwYpos = jstck->y + 32767;
354 if (lpInfo->dwFlags & JOY_RETURNZ)
355 lpInfo->dwZpos = jstck->z + 32767;
356 if (lpInfo->dwFlags & JOY_RETURNR)
357 lpInfo->dwRpos = jstck->r + 32767;
358 # ifdef BODGE_THE_HAT
359 else if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
362 lpInfo->dwButtons |= 1<<7;
363 else if (jstck->r < 0)
364 lpInfo->dwButtons |= 1<<8;
367 if (lpInfo->dwFlags & JOY_RETURNU)
368 lpInfo->dwUpos = jstck->u + 32767;
369 # ifdef BODGE_THE_HAT
370 else if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
373 lpInfo->dwButtons |= 1<<9;
374 else if (jstck->u < 0)
375 lpInfo->dwButtons |= 1<<10;
378 if (lpInfo->dwFlags & JOY_RETURNV)
379 lpInfo->dwVpos = jstck->v + 32767;
382 dev_stat = read(dev, &js, sizeof(js));
383 if (dev_stat != sizeof(js)) {
384 return JOYERR_UNPLUGGED; /* FIXME: perhaps wrong, but what should I return else ? */
388 if (lpInfo->dwFlags & JOY_RETURNX)
389 lpInfo->dwXpos = js.x; /* FIXME: perhaps multiply it somehow ? */
390 if (lpInfo->dwFlags & JOY_RETURNY)
391 lpInfo->dwYpos = js.y;
392 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
393 lpInfo->dwButtons = js.buttons;
396 TRACE("x: %ld, y: %ld, z: %ld, r: %ld, u: %ld, v: %ld, buttons: 0x%04x, flags: 0x%04x (fd %d)\n",
397 lpInfo->dwXpos, lpInfo->dwYpos, lpInfo->dwZpos,
398 lpInfo->dwRpos, lpInfo->dwUpos, lpInfo->dwVpos,
399 (unsigned int)lpInfo->dwButtons,
400 (unsigned int)lpInfo->dwFlags,
404 return JOYERR_NOERROR;
407 /**************************************************************************
408 * JSTCK_GetPos [internal]
410 static LRESULT JSTCK_GetPos(DWORD_PTR dwDevID, LPJOYINFO lpInfo)
415 memset(&ji, 0, sizeof(ji));
417 ji.dwSize = sizeof(ji);
418 ji.dwFlags = JOY_RETURNX | JOY_RETURNY | JOY_RETURNZ | JOY_RETURNBUTTONS;
419 ret = JSTCK_GetPosEx(dwDevID, &ji);
420 if (ret == JOYERR_NOERROR) {
421 lpInfo->wXpos = ji.dwXpos;
422 lpInfo->wYpos = ji.dwYpos;
423 lpInfo->wZpos = ji.dwZpos;
424 lpInfo->wButtons = ji.dwButtons;
430 /**************************************************************************
431 * DriverProc (JOYSTICK.@)
433 LRESULT CALLBACK JSTCK_DriverProc(DWORD_PTR dwDevID, HDRVR hDriv, UINT wMsg,
434 LPARAM dwParam1, LPARAM dwParam2)
436 /* EPP TRACE("(%08lX, %04X, %08lX, %08lX, %08lX)\n", */
437 /* EPP dwDevID, hDriv, wMsg, dwParam1, dwParam2); */
440 case DRV_LOAD: return 1;
441 case DRV_FREE: return 1;
442 case DRV_OPEN: return JSTCK_drvOpen((LPSTR)dwParam1, dwParam2);
443 case DRV_CLOSE: return JSTCK_drvClose(dwDevID);
444 case DRV_ENABLE: return 1;
445 case DRV_DISABLE: return 1;
446 case DRV_QUERYCONFIGURE: return 1;
447 case DRV_CONFIGURE: MessageBoxA(0, "JoyStick MultiMedia Driver !", "JoyStick Driver", MB_OK); return 1;
448 case DRV_INSTALL: return DRVCNF_RESTART;
449 case DRV_REMOVE: return DRVCNF_RESTART;
451 case JDD_GETNUMDEVS: return 1;
452 case JDD_GETDEVCAPS: return JSTCK_GetDevCaps(dwDevID, (LPJOYCAPSW)dwParam1, dwParam2);
453 case JDD_GETPOS: return JSTCK_GetPos(dwDevID, (LPJOYINFO)dwParam1);
454 case JDD_SETCALIBRATION:
455 case JDD_CONFIGCHANGED: return JOYERR_NOCANDO;
456 case JDD_GETPOSEX: return JSTCK_GetPosEx(dwDevID, (LPJOYINFOEX)dwParam1);
458 return DefDriverProc(dwDevID, hDriv, wMsg, dwParam1, dwParam2);
464 /**************************************************************************
465 * DriverProc (JOYSTICK.@)
467 LRESULT CALLBACK JSTCK_DriverProc(DWORD_PTR dwDevID, HDRVR hDriv, UINT wMsg,
468 LPARAM dwParam1, LPARAM dwParam2)
470 /* EPP TRACE("(%08lX, %04X, %08lX, %08lX, %08lX)\n", */
471 /* EPP dwDevID, hDriv, wMsg, dwParam1, dwParam2); */
480 case DRV_QUERYCONFIGURE: return 0;
481 case DRV_CONFIGURE: MessageBoxA(0, "JoyStick MultiMedia Driver !", "JoyStick Driver", MB_OK); return 1;
482 case DRV_INSTALL: return DRVCNF_RESTART;
483 case DRV_REMOVE: return DRVCNF_RESTART;
485 return DefDriverProc(dwDevID, hDriv, wMsg, dwParam1, dwParam2);