1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (c) 1998-2001 Vojtech Pavlik
7 * PDPI Lightning 4 gamecard driver for Linux.
14 #include <linux/delay.h>
15 #include <linux/errno.h>
16 #include <linux/ioport.h>
17 #include <linux/kernel.h>
18 #include <linux/module.h>
19 #include <linux/init.h>
20 #include <linux/gameport.h>
23 #define L4_SELECT_ANALOG 0xa4
24 #define L4_SELECT_DIGITAL 0xa5
25 #define L4_SELECT_SECONDARY 0xa6
26 #define L4_CMD_ID 0x80
27 #define L4_CMD_GETCAL 0x92
28 #define L4_CMD_SETCAL 0x93
31 #define L4_TIMEOUT 80 /* 80 us */
33 MODULE_AUTHOR("Vojtech Pavlik <vojtech@ucw.cz>");
34 MODULE_DESCRIPTION("PDPI Lightning 4 gamecard driver");
35 MODULE_LICENSE("GPL");
38 struct gameport
*gameport
;
42 static struct l4 l4_ports
[8];
45 * l4_wait_ready() waits for the L4 to become ready.
48 static int l4_wait_ready(void)
50 unsigned int t
= L4_TIMEOUT
;
52 while ((inb(L4_PORT
) & L4_BUSY
) && t
> 0) t
--;
57 * l4_cooked_read() reads data from the Lightning 4.
60 static int l4_cooked_read(struct gameport
*gameport
, int *axes
, int *buttons
)
62 struct l4
*l4
= gameport
->port_data
;
66 outb(L4_SELECT_ANALOG
, L4_PORT
);
67 outb(L4_SELECT_DIGITAL
+ (l4
->port
>> 2), L4_PORT
);
69 if (inb(L4_PORT
) & L4_BUSY
) goto fail
;
70 outb(l4
->port
& 3, L4_PORT
);
72 if (l4_wait_ready()) goto fail
;
73 status
= inb(L4_PORT
);
75 for (i
= 0; i
< 4; i
++)
76 if (status
& (1 << i
)) {
77 if (l4_wait_ready()) goto fail
;
78 axes
[i
] = inb(L4_PORT
);
79 if (axes
[i
] > 252) axes
[i
] = -1;
83 if (l4_wait_ready()) goto fail
;
84 *buttons
= inb(L4_PORT
) & 0x0f;
89 fail
: outb(L4_SELECT_ANALOG
, L4_PORT
);
93 static int l4_open(struct gameport
*gameport
, int mode
)
95 struct l4
*l4
= gameport
->port_data
;
97 if (l4
->port
!= 0 && mode
!= GAMEPORT_MODE_COOKED
)
99 outb(L4_SELECT_ANALOG
, L4_PORT
);
104 * l4_getcal() reads the L4 with calibration values.
107 static int l4_getcal(int port
, int *cal
)
111 outb(L4_SELECT_ANALOG
, L4_PORT
);
112 outb(L4_SELECT_DIGITAL
+ (port
>> 2), L4_PORT
);
113 if (inb(L4_PORT
) & L4_BUSY
)
116 outb(L4_CMD_GETCAL
, L4_PORT
);
120 if (inb(L4_PORT
) != L4_SELECT_DIGITAL
+ (port
>> 2))
125 outb(port
& 3, L4_PORT
);
127 for (i
= 0; i
< 4; i
++) {
130 cal
[i
] = inb(L4_PORT
);
135 out
: outb(L4_SELECT_ANALOG
, L4_PORT
);
140 * l4_setcal() programs the L4 with calibration values.
143 static int l4_setcal(int port
, int *cal
)
147 outb(L4_SELECT_ANALOG
, L4_PORT
);
148 outb(L4_SELECT_DIGITAL
+ (port
>> 2), L4_PORT
);
149 if (inb(L4_PORT
) & L4_BUSY
)
152 outb(L4_CMD_SETCAL
, L4_PORT
);
156 if (inb(L4_PORT
) != L4_SELECT_DIGITAL
+ (port
>> 2))
161 outb(port
& 3, L4_PORT
);
163 for (i
= 0; i
< 4; i
++) {
166 outb(cal
[i
], L4_PORT
);
171 out
: outb(L4_SELECT_ANALOG
, L4_PORT
);
176 * l4_calibrate() calibrates the L4 for the attached device, so
177 * that the device's resistance fits into the L4's 8-bit range.
180 static int l4_calibrate(struct gameport
*gameport
, int *axes
, int *max
)
184 struct l4
*l4
= gameport
->port_data
;
186 if (l4_getcal(l4
->port
, cal
))
189 for (i
= 0; i
< 4; i
++) {
190 t
= (max
[i
] * cal
[i
]) / 200;
191 t
= (t
< 1) ? 1 : ((t
> 255) ? 255 : t
);
192 axes
[i
] = (axes
[i
] < 0) ? -1 : (axes
[i
] * cal
[i
]) / t
;
193 axes
[i
] = (axes
[i
] > 252) ? 252 : axes
[i
];
197 if (l4_setcal(l4
->port
, cal
))
203 static int __init
l4_create_ports(int card_no
)
206 struct gameport
*port
;
209 for (i
= 0; i
< 4; i
++) {
211 idx
= card_no
* 4 + i
;
214 if (!(l4
->gameport
= port
= gameport_allocate_port())) {
215 printk(KERN_ERR
"lightning: Memory allocation failed\n");
217 gameport_free_port(l4
->gameport
);
224 port
->port_data
= l4
;
225 port
->open
= l4_open
;
226 port
->cooked_read
= l4_cooked_read
;
227 port
->calibrate
= l4_calibrate
;
229 gameport_set_name(port
, "PDPI Lightning 4");
230 gameport_set_phys(port
, "isa%04x/gameport%d", L4_PORT
, idx
);
239 static int __init
l4_add_card(int card_no
)
241 int cal
[4] = { 255, 255, 255, 255 };
245 outb(L4_SELECT_ANALOG
, L4_PORT
);
246 outb(L4_SELECT_DIGITAL
+ card_no
, L4_PORT
);
248 if (inb(L4_PORT
) & L4_BUSY
)
250 outb(L4_CMD_ID
, L4_PORT
);
255 if (inb(L4_PORT
) != L4_SELECT_DIGITAL
+ card_no
)
260 if (inb(L4_PORT
) != L4_ID
)
270 result
= l4_create_ports(card_no
);
274 printk(KERN_INFO
"gameport: PDPI Lightning 4 %s card v%d.%d at %#x\n",
275 card_no
? "secondary" : "primary", rev
>> 4, rev
, L4_PORT
);
277 for (i
= 0; i
< 4; i
++) {
278 l4
= &l4_ports
[card_no
* 4 + i
];
280 if (rev
> 0x28) /* on 2.9+ the setcal command works correctly */
281 l4_setcal(l4
->port
, cal
);
282 gameport_register_port(l4
->gameport
);
288 static int __init
l4_init(void)
292 if (!request_region(L4_PORT
, 1, "lightning"))
295 for (i
= 0; i
< 2; i
++)
296 if (l4_add_card(i
) == 0)
299 outb(L4_SELECT_ANALOG
, L4_PORT
);
302 release_region(L4_PORT
, 1);
309 static void __exit
l4_exit(void)
312 int cal
[4] = { 59, 59, 59, 59 };
314 for (i
= 0; i
< 8; i
++)
315 if (l4_ports
[i
].gameport
) {
316 l4_setcal(l4_ports
[i
].port
, cal
);
317 gameport_unregister_port(l4_ports
[i
].gameport
);
320 outb(L4_SELECT_ANALOG
, L4_PORT
);
321 release_region(L4_PORT
, 1);
324 module_init(l4_init
);
325 module_exit(l4_exit
);