2 * Copyright (c) 1998-2001 Vojtech Pavlik
6 * FP-Gaming Assasin 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 Assasin 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], 48, input_dev->abs[axes[i]] * 2 - 48, 0, 8);
347 input_set_abs_params(input_dev, axes[i], 2, 253, 0, 0);
348 input_set_abs_params(input_dev, ABS_HAT0X + i, -1, 1, 0, 0);
354 input_dev->evbit[0] |= BIT_MASK(EV_KEY) | BIT_MASK(EV_REL);
355 input_dev->relbit[0] |= BIT_MASK(REL_X) | BIT_MASK(REL_Y);
356 input_dev->keybit[BIT_WORD(BTN_MOUSE)] |= BIT_MASK(BTN_RIGHT) |
357 BIT_MASK(BTN_LEFT) | BIT_MASK(BTN_MIDDLE);
361 if (!(a3d->adc = adc = gameport_allocate_port()))
362 printk(KERN_ERR "a3d: Not enough memory for ADC port\n");
364 adc->port_data = a3d;
365 adc->open = a3d_adc_open;
366 adc->close = a3d_adc_close;
367 adc->cooked_read = a3d_adc_cooked_read;
370 gameport_set_name(adc, a3d_names[a3d->mode]);
371 gameport_set_phys(adc, "%s/gameport0", gameport->phys);
372 adc->dev.parent = &gameport->dev;
374 gameport_register_port(adc);
378 err = input_register_device(a3d->dev);
385 gameport_unregister_port(a3d->adc);
386 fail2: gameport_close(gameport);
387 fail1: gameport_set_drvdata(gameport, NULL);
388 input_free_device(input_dev);
393 static void a3d_disconnect(struct gameport *gameport)
395 struct a3d *a3d = gameport_get_drvdata(gameport);
397 input_unregister_device(a3d->dev);
399 gameport_unregister_port(a3d->adc);
400 gameport_close(gameport);
401 gameport_set_drvdata(gameport, NULL);
405 static struct gameport_driver a3d_drv = {
408 .owner = THIS_MODULE,
410 .description = DRIVER_DESC,
411 .connect = a3d_connect,
412 .disconnect = a3d_disconnect,
415 static int __init a3d_init(void)
417 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);