2 * Copyright (c) 1998-2001 Vojtech Pavlik
6 * FP-Gaming Assassin 3D joystick driver for Linux
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 * Should you need to contact me, the author, you can do so either by
25 * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail:
26 * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic
29 #include <linux/kernel.h>
30 #include <linux/module.h>
31 #include <linux/slab.h>
32 #include <linux/init.h>
33 #include <linux/gameport.h>
34 #include <linux/input.h>
35 #include <linux/jiffies.h>
37 #define DRIVER_DESC "FP-Gaming Assassin 3D joystick driver"
39 MODULE_AUTHOR("Vojtech Pavlik <vojtech@ucw.cz>");
40 MODULE_DESCRIPTION(DRIVER_DESC
);
41 MODULE_LICENSE("GPL");
43 #define A3D_MAX_START 600 /* 600 us */
44 #define A3D_MAX_STROBE 80 /* 80 us */
45 #define A3D_MAX_LENGTH 40 /* 40*3 bits */
47 #define A3D_MODE_A3D 1 /* Assassin 3D */
48 #define A3D_MODE_PAN 2 /* Panther */
49 #define A3D_MODE_OEM 3 /* Panther OEM version */
50 #define A3D_MODE_PXL 4 /* Panther XL */
52 static char *a3d_names
[] = { NULL
, "FP-Gaming Assassin 3D", "MadCatz Panther", "OEM Panther",
53 "MadCatz Panther XL", "MadCatz Panther XL w/ rudder" };
56 struct gameport
*gameport
;
58 struct input_dev
*dev
;
69 * a3d_read_packet() reads an Assassin 3D packet.
72 static int a3d_read_packet(struct gameport
*gameport
, int length
, char *data
)
80 t
= gameport_time(gameport
, A3D_MAX_START
);
81 s
= gameport_time(gameport
, A3D_MAX_STROBE
);
83 local_irq_save(flags
);
84 gameport_trigger(gameport
);
85 v
= gameport_read(gameport
);
87 while (t
> 0 && i
< length
) {
89 u
= v
; v
= gameport_read(gameport
);
96 local_irq_restore(flags
);
102 * a3d_csum() computes checksum of triplet packet
105 static int a3d_csum(char *data
, int count
)
109 for (i
= 0; i
< count
- 2; i
++)
111 return (csum
& 0x3f) != ((data
[count
- 2] << 3) | data
[count
- 1]);
114 static void a3d_read(struct a3d
*a3d
, unsigned char *data
)
116 struct input_dev
*dev
= a3d
->dev
;
124 input_report_rel(dev
, REL_X
, ((data
[5] << 6) | (data
[6] << 3) | data
[ 7]) - ((data
[5] & 4) << 7));
125 input_report_rel(dev
, REL_Y
, ((data
[8] << 6) | (data
[9] << 3) | data
[10]) - ((data
[8] & 4) << 7));
127 input_report_key(dev
, BTN_RIGHT
, data
[2] & 1);
128 input_report_key(dev
, BTN_LEFT
, data
[3] & 2);
129 input_report_key(dev
, BTN_MIDDLE
, data
[3] & 4);
133 a3d
->axes
[0] = ((signed char)((data
[11] << 6) | (data
[12] << 3) | (data
[13]))) + 128;
134 a3d
->axes
[1] = ((signed char)((data
[14] << 6) | (data
[15] << 3) | (data
[16]))) + 128;
135 a3d
->axes
[2] = ((signed char)((data
[17] << 6) | (data
[18] << 3) | (data
[19]))) + 128;
136 a3d
->axes
[3] = ((signed char)((data
[20] << 6) | (data
[21] << 3) | (data
[22]))) + 128;
138 a3d
->buttons
= ((data
[3] << 3) | data
[4]) & 0xf;
144 input_report_rel(dev
, REL_X
, ((data
[ 9] << 6) | (data
[10] << 3) | data
[11]) - ((data
[ 9] & 4) << 7));
145 input_report_rel(dev
, REL_Y
, ((data
[12] << 6) | (data
[13] << 3) | data
[14]) - ((data
[12] & 4) << 7));
147 input_report_key(dev
, BTN_RIGHT
, data
[2] & 1);
148 input_report_key(dev
, BTN_LEFT
, data
[3] & 2);
149 input_report_key(dev
, BTN_MIDDLE
, data
[3] & 4);
150 input_report_key(dev
, BTN_SIDE
, data
[7] & 2);
151 input_report_key(dev
, BTN_EXTRA
, data
[7] & 4);
153 input_report_abs(dev
, ABS_X
, ((signed char)((data
[15] << 6) | (data
[16] << 3) | (data
[17]))) + 128);
154 input_report_abs(dev
, ABS_Y
, ((signed char)((data
[18] << 6) | (data
[19] << 3) | (data
[20]))) + 128);
155 input_report_abs(dev
, ABS_RUDDER
, ((signed char)((data
[21] << 6) | (data
[22] << 3) | (data
[23]))) + 128);
156 input_report_abs(dev
, ABS_THROTTLE
, ((signed char)((data
[24] << 6) | (data
[25] << 3) | (data
[26]))) + 128);
158 input_report_abs(dev
, ABS_HAT0X
, ( data
[5] & 1) - ((data
[5] >> 2) & 1));
159 input_report_abs(dev
, ABS_HAT0Y
, ((data
[5] >> 1) & 1) - ((data
[6] >> 2) & 1));
160 input_report_abs(dev
, ABS_HAT1X
, ((data
[4] >> 1) & 1) - ( data
[3] & 1));
161 input_report_abs(dev
, ABS_HAT1Y
, ((data
[4] >> 2) & 1) - ( data
[4] & 1));
163 input_report_key(dev
, BTN_TRIGGER
, data
[8] & 1);
164 input_report_key(dev
, BTN_THUMB
, data
[8] & 2);
165 input_report_key(dev
, BTN_TOP
, data
[8] & 4);
166 input_report_key(dev
, BTN_PINKIE
, data
[7] & 1);
176 * a3d_poll() reads and analyzes A3D joystick data.
179 static void a3d_poll(struct gameport
*gameport
)
181 struct a3d
*a3d
= gameport_get_drvdata(gameport
);
182 unsigned char data
[A3D_MAX_LENGTH
];
185 if (a3d_read_packet(a3d
->gameport
, a3d
->length
, data
) != a3d
->length
||
186 data
[0] != a3d
->mode
|| a3d_csum(data
, a3d
->length
))
193 * a3d_adc_cooked_read() copies the acis and button data to the
194 * callers arrays. It could do the read itself, but the caller could
195 * call this more than 50 times a second, which would use too much CPU.
198 static int a3d_adc_cooked_read(struct gameport
*gameport
, int *axes
, int *buttons
)
200 struct a3d
*a3d
= gameport
->port_data
;
203 for (i
= 0; i
< 4; i
++)
204 axes
[i
] = (a3d
->axes
[i
] < 254) ? a3d
->axes
[i
] : -1;
205 *buttons
= a3d
->buttons
;
210 * a3d_adc_open() is the gameport open routine. It refuses to serve
211 * any but cooked data.
214 static int a3d_adc_open(struct gameport
*gameport
, int mode
)
216 struct a3d
*a3d
= gameport
->port_data
;
218 if (mode
!= GAMEPORT_MODE_COOKED
)
221 gameport_start_polling(a3d
->gameport
);
226 * a3d_adc_close() is a callback from the input close routine.
229 static void a3d_adc_close(struct gameport
*gameport
)
231 struct a3d
*a3d
= gameport
->port_data
;
233 gameport_stop_polling(a3d
->gameport
);
237 * a3d_open() is a callback from the input open routine.
240 static int a3d_open(struct input_dev
*dev
)
242 struct a3d
*a3d
= input_get_drvdata(dev
);
244 gameport_start_polling(a3d
->gameport
);
249 * a3d_close() is a callback from the input close routine.
252 static void a3d_close(struct input_dev
*dev
)
254 struct a3d
*a3d
= input_get_drvdata(dev
);
256 gameport_stop_polling(a3d
->gameport
);
260 * a3d_connect() probes for A3D joysticks.
263 static int a3d_connect(struct gameport
*gameport
, struct gameport_driver
*drv
)
266 struct input_dev
*input_dev
;
267 struct gameport
*adc
;
268 unsigned char data
[A3D_MAX_LENGTH
];
272 a3d
= kzalloc(sizeof(struct a3d
), GFP_KERNEL
);
273 input_dev
= input_allocate_device();
274 if (!a3d
|| !input_dev
) {
279 a3d
->dev
= input_dev
;
280 a3d
->gameport
= gameport
;
282 gameport_set_drvdata(gameport
, a3d
);
284 err
= gameport_open(gameport
, drv
, GAMEPORT_MODE_RAW
);
288 i
= a3d_read_packet(gameport
, A3D_MAX_LENGTH
, data
);
290 if (!i
|| a3d_csum(data
, i
)) {
297 if (!a3d
->mode
|| a3d
->mode
> 5) {
298 printk(KERN_WARNING
"a3d.c: Unknown A3D device detected "
299 "(%s, id=%d), contact <vojtech@ucw.cz>\n", gameport
->phys
, a3d
->mode
);
304 gameport_set_poll_handler(gameport
, a3d_poll
);
305 gameport_set_poll_interval(gameport
, 20);
307 snprintf(a3d
->phys
, sizeof(a3d
->phys
), "%s/input0", gameport
->phys
);
309 input_dev
->name
= a3d_names
[a3d
->mode
];
310 input_dev
->phys
= a3d
->phys
;
311 input_dev
->id
.bustype
= BUS_GAMEPORT
;
312 input_dev
->id
.vendor
= GAMEPORT_ID_VENDOR_MADCATZ
;
313 input_dev
->id
.product
= a3d
->mode
;
314 input_dev
->id
.version
= 0x0100;
315 input_dev
->dev
.parent
= &gameport
->dev
;
316 input_dev
->open
= a3d_open
;
317 input_dev
->close
= a3d_close
;
319 input_set_drvdata(input_dev
, a3d
);
321 if (a3d
->mode
== A3D_MODE_PXL
) {
323 int axes
[] = { ABS_X
, ABS_Y
, ABS_THROTTLE
, ABS_RUDDER
};
327 input_dev
->evbit
[0] |= BIT_MASK(EV_ABS
) | BIT_MASK(EV_KEY
) |
329 input_dev
->relbit
[0] |= BIT_MASK(REL_X
) | BIT_MASK(REL_Y
);
330 input_dev
->absbit
[0] |= BIT_MASK(ABS_X
) | BIT_MASK(ABS_Y
) |
331 BIT_MASK(ABS_THROTTLE
) | BIT_MASK(ABS_RUDDER
) |
332 BIT_MASK(ABS_HAT0X
) | BIT_MASK(ABS_HAT0Y
) |
333 BIT_MASK(ABS_HAT1X
) | BIT_MASK(ABS_HAT1Y
);
334 input_dev
->keybit
[BIT_WORD(BTN_MOUSE
)] |= BIT_MASK(BTN_RIGHT
) |
335 BIT_MASK(BTN_LEFT
) | BIT_MASK(BTN_MIDDLE
) |
336 BIT_MASK(BTN_SIDE
) | BIT_MASK(BTN_EXTRA
);
337 input_dev
->keybit
[BIT_WORD(BTN_JOYSTICK
)] |=
338 BIT_MASK(BTN_TRIGGER
) | BIT_MASK(BTN_THUMB
) |
339 BIT_MASK(BTN_TOP
) | BIT_MASK(BTN_PINKIE
);
343 for (i
= 0; i
< 4; i
++) {
345 input_set_abs_params(input_dev
, axes
[i
],
346 48, input_abs_get_val(input_dev
, axes
[i
]) * 2 - 48, 0, 8);
348 input_set_abs_params(input_dev
, axes
[i
], 2, 253, 0, 0);
349 input_set_abs_params(input_dev
, ABS_HAT0X
+ i
, -1, 1, 0, 0);
355 input_dev
->evbit
[0] |= BIT_MASK(EV_KEY
) | BIT_MASK(EV_REL
);
356 input_dev
->relbit
[0] |= BIT_MASK(REL_X
) | BIT_MASK(REL_Y
);
357 input_dev
->keybit
[BIT_WORD(BTN_MOUSE
)] |= BIT_MASK(BTN_RIGHT
) |
358 BIT_MASK(BTN_LEFT
) | BIT_MASK(BTN_MIDDLE
);
362 if (!(a3d
->adc
= adc
= gameport_allocate_port()))
363 printk(KERN_ERR
"a3d: Not enough memory for ADC port\n");
365 adc
->port_data
= a3d
;
366 adc
->open
= a3d_adc_open
;
367 adc
->close
= a3d_adc_close
;
368 adc
->cooked_read
= a3d_adc_cooked_read
;
371 gameport_set_name(adc
, a3d_names
[a3d
->mode
]);
372 gameport_set_phys(adc
, "%s/gameport0", gameport
->phys
);
373 adc
->dev
.parent
= &gameport
->dev
;
375 gameport_register_port(adc
);
379 err
= input_register_device(a3d
->dev
);
386 gameport_unregister_port(a3d
->adc
);
387 fail2
: gameport_close(gameport
);
388 fail1
: gameport_set_drvdata(gameport
, NULL
);
389 input_free_device(input_dev
);
394 static void a3d_disconnect(struct gameport
*gameport
)
396 struct a3d
*a3d
= gameport_get_drvdata(gameport
);
398 input_unregister_device(a3d
->dev
);
400 gameport_unregister_port(a3d
->adc
);
401 gameport_close(gameport
);
402 gameport_set_drvdata(gameport
, NULL
);
406 static struct gameport_driver a3d_drv
= {
409 .owner
= THIS_MODULE
,
411 .description
= DRIVER_DESC
,
412 .connect
= a3d_connect
,
413 .disconnect
= a3d_disconnect
,
416 static int __init
a3d_init(void)
418 return gameport_register_driver(&a3d_drv
);
421 static void __exit
a3d_exit(void)
423 gameport_unregister_driver(&a3d_drv
);
426 module_init(a3d_init
);
427 module_exit(a3d_exit
);