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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, 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 documentation 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>
60 #define JOYDEV_NEW "/dev/input/js%d"
61 #define JOYDEV_OLD "/dev/js%d"
63 #ifdef HAVE_SYS_ERRNO_H
64 #include <sys/errno.h>
73 #include "wine/debug.h"
75 #include "wine/unicode.h"
77 WINE_DEFAULT_DEBUG_CHANNEL(joystick);
79 #define MAXJOYSTICK (JOYSTICKID2 + 30)
81 typedef struct tagWINE_JSTCK {
84 /* Some extra info we need to make this actually work under the
86 First of all, we cannot keep closing and reopening the device file -
87 that blows away the state of the stick device, and we lose events. So, we
88 need to open the low-level device once, and close it when we are done.
90 Secondly, the event API only gives us what's changed. However, Windows apps
91 want the whole state every time, so we have to cache the data.
94 int dev; /* Linux level device file descriptor */
104 char axesMap[ABS_MAX + 1];
107 static WINE_JSTCK JSTCK_Data[MAXJOYSTICK];
109 /**************************************************************************
110 * JSTCK_drvGet [internal]
112 static WINE_JSTCK *JSTCK_drvGet(DWORD_PTR dwDevID)
116 if ((dwDevID - (DWORD_PTR)JSTCK_Data) % sizeof(JSTCK_Data[0]) != 0)
118 p = (dwDevID - (DWORD_PTR)JSTCK_Data) / sizeof(JSTCK_Data[0]);
119 if (p < 0 || p >= MAXJOYSTICK || !((WINE_JSTCK*)dwDevID)->in_use)
122 return (WINE_JSTCK*)dwDevID;
125 /**************************************************************************
126 * JSTCK_drvOpen [internal]
128 static LRESULT JSTCK_drvOpen(LPSTR str, DWORD dwIntf)
130 if (dwIntf >= MAXJOYSTICK || JSTCK_Data[dwIntf].in_use)
133 JSTCK_Data[dwIntf].joyIntf = dwIntf;
134 JSTCK_Data[dwIntf].in_use = 1;
135 return (LRESULT)&JSTCK_Data[dwIntf];
138 /**************************************************************************
139 * JSTCK_drvClose [internal]
141 static LRESULT JSTCK_drvClose(DWORD_PTR dwDevID)
143 WINE_JSTCK* jstck = JSTCK_drvGet(dwDevID);
163 /**************************************************************************
164 * JSTCK_OpenDevice [internal]
166 static int JSTCK_OpenDevice(WINE_JSTCK* jstick)
174 sprintf(buf, JOYDEV_NEW, jstick->joyIntf);
175 #ifdef HAVE_LINUX_22_JOYSTICK_API
176 flags = O_RDONLY | O_NONBLOCK;
180 if ((jstick->dev = open(buf, flags)) < 0) {
181 sprintf(buf, JOYDEV_OLD, jstick->joyIntf);
182 if ((jstick->dev = open(buf, flags)) < 0)
185 #ifdef HAVE_LINUX_22_JOYSTICK_API
186 ioctl(jstick->dev, JSIOCGAXMAP, jstick->axesMap);
192 /**************************************************************************
193 * JoyGetDevCaps [MMSYSTEM.102]
195 static LRESULT JSTCK_GetDevCaps(DWORD_PTR dwDevID, LPJOYCAPSW lpCaps, DWORD dwSize)
198 #ifdef HAVE_LINUX_22_JOYSTICK_API
202 char identString[MAXPNAMELEN];
206 static const WCHAR ini[] = {'W','i','n','e',' ','J','o','y','s','t','i','c','k',' ','D','r','i','v','e','r',0};
209 if ((jstck = JSTCK_drvGet(dwDevID)) == NULL)
210 return MMSYSERR_NODRIVER;
212 #ifdef HAVE_LINUX_22_JOYSTICK_API
213 if ((dev = JSTCK_OpenDevice(jstck)) < 0) return JOYERR_PARMS;
214 ioctl(dev, JSIOCGAXES, &nrOfAxes);
215 ioctl(dev, JSIOCGBUTTONS, &nrOfButtons);
216 ioctl(dev, JSIOCGVERSION, &driverVersion);
217 ioctl(dev, JSIOCGNAME(sizeof(identString)), identString);
218 TRACE("Driver: 0x%06x, Name: %s, #Axes: %d, #Buttons: %d\n",
219 driverVersion, identString, nrOfAxes, nrOfButtons);
220 lpCaps->wMid = MM_MICROSOFT;
221 lpCaps->wPid = MM_PC_JOYSTICK;
222 MultiByteToWideChar(CP_UNIXCP, 0, identString, -1, lpCaps->szPname, MAXPNAMELEN);
223 lpCaps->szPname[MAXPNAMELEN-1] = '\0';
225 lpCaps->wXmax = 0xFFFF;
227 lpCaps->wYmax = 0xFFFF;
229 lpCaps->wZmax = (nrOfAxes >= 3) ? 0xFFFF : 0;
231 /* Half-Life won't allow you to map an axis event to things like
232 "next weapon" and "use". Linux reports the hat on my stick as
233 axis U and V. So, IFF BODGE_THE_HAT is defined, lie through our
234 teeth and say we have 32 buttons, and we will map the axes to
235 the high buttons. Really, perhaps this should be a registry entry,
236 or even a parameter to the Linux joystick driver (which would completely
237 remove the need for this.)
239 lpCaps->wNumButtons = 32;
241 lpCaps->wNumButtons = nrOfButtons;
243 if (dwSize == sizeof(JOYCAPSW)) {
244 /* complete 95 structure */
246 lpCaps->wRmax = 0xFFFF;
248 lpCaps->wUmax = 0xFFFF;
250 lpCaps->wVmax = 0xFFFF;
251 lpCaps->wMaxAxes = 6; /* same as MS Joystick Driver */
252 lpCaps->wNumAxes = 0; /* nr of axes in use */
253 lpCaps->wMaxButtons = 32; /* same as MS Joystick Driver */
254 lpCaps->szRegKey[0] = 0;
255 lpCaps->szOEMVxD[0] = 0;
257 for (i = 0; i < nrOfAxes; i++) {
258 switch (jstck->axesMap[i]) {
264 case 6: /* Throttle */
266 lpCaps->wCaps |= JOYCAPS_HASZ;
271 lpCaps->wCaps |= JOYCAPS_HASR;
275 lpCaps->wCaps |= JOYCAPS_HASU;
279 lpCaps->wCaps |= JOYCAPS_HASV;
281 case 16: /* Hat 0 X */
282 case 17: /* Hat 0 Y */
283 lpCaps->wCaps |= JOYCAPS_HASPOV | JOYCAPS_POV4DIR;
284 /* TODO: JOYCAPS_POVCTS handling */
287 WARN("Unknown axis %hhu(%u). Skipped.\n", jstck->axesMap[i], i);
292 lpCaps->wMid = MM_MICROSOFT;
293 lpCaps->wPid = MM_PC_JOYSTICK;
294 strcpyW(lpCaps->szPname, ini); /* joystick product name */
296 lpCaps->wXmax = 0xFFFF;
298 lpCaps->wYmax = 0xFFFF;
301 lpCaps->wNumButtons = 2;
302 if (dwSize == sizeof(JOYCAPSW)) {
303 /* complete 95 structure */
311 lpCaps->wMaxAxes = 2;
312 lpCaps->wNumAxes = 2;
313 lpCaps->wMaxButtons = 4;
314 lpCaps->szRegKey[0] = 0;
315 lpCaps->szOEMVxD[0] = 0;
319 return JOYERR_NOERROR;
322 /**************************************************************************
323 * JSTCK_GetPos [internal]
325 static LRESULT JSTCK_GetPosEx(DWORD_PTR dwDevID, LPJOYINFOEX lpInfo)
329 #ifdef HAVE_LINUX_22_JOYSTICK_API
336 if ((jstck = JSTCK_drvGet(dwDevID)) == NULL)
337 return MMSYSERR_NODRIVER;
339 if ((dev = JSTCK_OpenDevice(jstck)) < 0) return JOYERR_PARMS;
341 #ifdef HAVE_LINUX_22_JOYSTICK_API
342 while ((read(dev, &ev, sizeof(struct js_event))) > 0) {
343 if (ev.type == (JS_EVENT_AXIS)) {
344 switch (jstck->axesMap[ev.number]) {
352 case 6: /* Throttle */
365 case 16: /* Hat 0 X */
366 jstck->pov_x = ev.value;
368 case 17: /* Hat 0 Y */
369 jstck->pov_y = ev.value;
372 FIXME("Unknown joystick event '%d'\n", ev.number);
374 } else if (ev.type == (JS_EVENT_BUTTON)) {
376 jstck->buttons |= (1 << ev.number);
377 /* FIXME: what to do for this field when
378 * multiple buttons are depressed ?
380 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
381 lpInfo->dwButtonNumber = ev.number + 1;
384 jstck->buttons &= ~(1 << ev.number);
387 /* EAGAIN is returned when the queue is empty */
388 if (errno != EAGAIN) {
389 /* FIXME: error should not be ignored */
390 ERR("Error while reading joystick state (%s)\n", strerror(errno));
392 /* Now, copy the cached values into Window's structure... */
393 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
394 lpInfo->dwButtons = jstck->buttons;
395 if (lpInfo->dwFlags & JOY_RETURNX)
396 lpInfo->dwXpos = jstck->x + 32767;
397 if (lpInfo->dwFlags & JOY_RETURNY)
398 lpInfo->dwYpos = jstck->y + 32767;
399 if (lpInfo->dwFlags & JOY_RETURNZ)
400 lpInfo->dwZpos = jstck->z + 32767;
401 if (lpInfo->dwFlags & JOY_RETURNR)
402 lpInfo->dwRpos = jstck->r + 32767;
403 # ifdef BODGE_THE_HAT
404 else if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
407 lpInfo->dwButtons |= 1<<7;
408 else if (jstck->r < 0)
409 lpInfo->dwButtons |= 1<<8;
412 if (lpInfo->dwFlags & JOY_RETURNU)
413 lpInfo->dwUpos = jstck->u + 32767;
414 # ifdef BODGE_THE_HAT
415 else if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
418 lpInfo->dwButtons |= 1<<9;
419 else if (jstck->u < 0)
420 lpInfo->dwButtons |= 1<<10;
423 if (lpInfo->dwFlags & JOY_RETURNV)
424 lpInfo->dwVpos = jstck->v + 32767;
425 if (lpInfo->dwFlags & JOY_RETURNPOV) {
426 if (jstck->pov_y > 0) {
427 if (jstck->pov_x < 0)
428 lpInfo->dwPOV = 22500; /* SW */
429 else if (jstck->pov_x > 0)
430 lpInfo->dwPOV = 13500; /* SE */
432 lpInfo->dwPOV = 18000; /* S, JOY_POVBACKWARD */
433 } else if (jstck->pov_y < 0) {
434 if (jstck->pov_x < 0)
435 lpInfo->dwPOV = 31500; /* NW */
436 else if (jstck->pov_x > 0)
437 lpInfo->dwPOV = 4500; /* NE */
439 lpInfo->dwPOV = 0; /* N, JOY_POVFORWARD */
440 } else if (jstck->pov_x < 0)
441 lpInfo->dwPOV = 27000; /* W, JOY_POVLEFT */
442 else if (jstck->pov_x > 0)
443 lpInfo->dwPOV = 9000; /* E, JOY_POVRIGHT */
445 lpInfo->dwPOV = JOY_POVCENTERED; /* Center */
449 dev_stat = read(dev, &js, sizeof(js));
450 if (dev_stat != sizeof(js)) {
451 return JOYERR_UNPLUGGED; /* FIXME: perhaps wrong, but what should I return else ? */
455 if (lpInfo->dwFlags & JOY_RETURNX)
456 lpInfo->dwXpos = js.x; /* FIXME: perhaps multiply it somehow ? */
457 if (lpInfo->dwFlags & JOY_RETURNY)
458 lpInfo->dwYpos = js.y;
459 if (lpInfo->dwFlags & JOY_RETURNBUTTONS)
460 lpInfo->dwButtons = js.buttons;
463 TRACE("x: %d, y: %d, z: %d, r: %d, u: %d, v: %d, buttons: 0x%04x, flags: 0x%04x (fd %d)\n",
464 lpInfo->dwXpos, lpInfo->dwYpos, lpInfo->dwZpos,
465 lpInfo->dwRpos, lpInfo->dwUpos, lpInfo->dwVpos,
466 lpInfo->dwButtons, lpInfo->dwFlags, dev
469 return JOYERR_NOERROR;
472 /**************************************************************************
473 * JSTCK_GetPos [internal]
475 static LRESULT JSTCK_GetPos(DWORD_PTR dwDevID, LPJOYINFO lpInfo)
480 memset(&ji, 0, sizeof(ji));
482 ji.dwSize = sizeof(ji);
483 ji.dwFlags = JOY_RETURNX | JOY_RETURNY | JOY_RETURNZ | JOY_RETURNBUTTONS;
484 ret = JSTCK_GetPosEx(dwDevID, &ji);
485 if (ret == JOYERR_NOERROR) {
486 lpInfo->wXpos = ji.dwXpos;
487 lpInfo->wYpos = ji.dwYpos;
488 lpInfo->wZpos = ji.dwZpos;
489 lpInfo->wButtons = ji.dwButtons;
495 /**************************************************************************
496 * DriverProc (JOYSTICK.@)
498 LRESULT CALLBACK JSTCK_DriverProc(DWORD_PTR dwDevID, HDRVR hDriv, UINT wMsg,
499 LPARAM dwParam1, LPARAM dwParam2)
501 /* EPP TRACE("(%08lX, %04X, %08lX, %08lX, %08lX)\n", */
502 /* EPP dwDevID, hDriv, wMsg, dwParam1, dwParam2); */
505 case DRV_LOAD: return 1;
506 case DRV_FREE: return 1;
507 case DRV_OPEN: return JSTCK_drvOpen((LPSTR)dwParam1, dwParam2);
508 case DRV_CLOSE: return JSTCK_drvClose(dwDevID);
509 case DRV_ENABLE: return 1;
510 case DRV_DISABLE: return 1;
511 case DRV_QUERYCONFIGURE: return 1;
512 case DRV_CONFIGURE: MessageBoxA(0, "JoyStick MultiMedia Driver !", "JoyStick Driver", MB_OK); return 1;
513 case DRV_INSTALL: return DRVCNF_RESTART;
514 case DRV_REMOVE: return DRVCNF_RESTART;
516 case JDD_GETNUMDEVS: return 1;
517 case JDD_GETDEVCAPS: return JSTCK_GetDevCaps(dwDevID, (LPJOYCAPSW)dwParam1, dwParam2);
518 case JDD_GETPOS: return JSTCK_GetPos(dwDevID, (LPJOYINFO)dwParam1);
519 case JDD_SETCALIBRATION:
520 case JDD_CONFIGCHANGED: return JOYERR_NOCANDO;
521 case JDD_GETPOSEX: return JSTCK_GetPosEx(dwDevID, (LPJOYINFOEX)dwParam1);
523 return DefDriverProc(dwDevID, hDriv, wMsg, dwParam1, dwParam2);