2 * Atari Keyboard driver for 680x0 Linux
4 * This file is subject to the terms and conditions of the GNU General Public
5 * License. See the file COPYING in the main directory of this archive
10 * Atari support by Robert de Vries
11 * enhanced by Bjoern Brauel and Roman Hodek
13 * 2.6 and input cleanup (removed autorepeat stuff) for 2.6.21
14 * 06/07 Michael Schmitz
17 #include <linux/module.h>
18 #include <linux/sched.h>
19 #include <linux/kernel.h>
20 #include <linux/interrupt.h>
21 #include <linux/errno.h>
22 #include <linux/keyboard.h>
23 #include <linux/delay.h>
24 #include <linux/timer.h>
26 #include <linux/random.h>
27 #include <linux/init.h>
28 #include <linux/kbd_kern.h>
30 #include <asm/atariints.h>
31 #include <asm/atarihw.h>
32 #include <asm/atarikb.h>
33 #include <asm/atari_joystick.h>
37 /* Hook for MIDI serial driver */
38 void (*atari_MIDI_interrupt_hook
) (void);
39 /* Hook for mouse driver */
40 void (*atari_mouse_interrupt_hook
) (char *);
41 /* Hook for keyboard inputdev driver */
42 void (*atari_input_keyboard_interrupt_hook
) (unsigned char, char);
43 /* Hook for mouse inputdev driver */
44 void (*atari_input_mouse_interrupt_hook
) (char *);
45 EXPORT_SYMBOL(atari_mouse_interrupt_hook
);
46 EXPORT_SYMBOL(atari_input_keyboard_interrupt_hook
);
47 EXPORT_SYMBOL(atari_input_mouse_interrupt_hook
);
49 /* variables for IKBD self test: */
51 /* state: 0: off; >0: in progress; >1: 0xf1 received */
52 static volatile int ikbd_self_test
;
53 /* timestamp when last received a char */
54 static volatile unsigned long self_test_last_rcv
;
55 /* bitmap of keys reported as broken */
56 static unsigned long broken_keys
[128/(sizeof(unsigned long)*8)] = { 0, };
58 #define BREAK_MASK (0x80)
61 * ++roman: The following changes were applied manually:
63 * - The Alt (= Meta) key works in combination with Shift and
64 * Control, e.g. Alt+Shift+a sends Meta-A (0xc1), Alt+Control+A sends
65 * Meta-Ctrl-A (0x81) ...
67 * - The parentheses on the keypad send '(' and ')' with all
68 * modifiers (as would do e.g. keypad '+'), but they cannot be used as
69 * application keys (i.e. sending Esc O c).
71 * - HELP and UNDO are mapped to be F21 and F24, resp, that send the
72 * codes "\E[M" and "\E[P". (This is better than the old mapping to
73 * F11 and F12, because these codes are on Shift+F1/2 anyway.) This
74 * way, applications that allow their own keyboard mappings
75 * (e.g. tcsh, X Windows) can be configured to use them in the way
76 * the label suggests (providing help or undoing).
78 * - Console switching is done with Alt+Fx (consoles 1..10) and
79 * Shift+Alt+Fx (consoles 11..20).
81 * - The misc. special function implemented in the kernel are mapped
82 * to the following key combinations:
84 * ClrHome -> Home/Find
85 * Shift + ClrHome -> End/Select
86 * Shift + Up -> Page Up
87 * Shift + Down -> Page Down
88 * Alt + Help -> show system status
89 * Shift + Help -> show memory info
90 * Ctrl + Help -> show registers
91 * Ctrl + Alt + Del -> Reboot
92 * Alt + Undo -> switch to last console
93 * Shift + Undo -> send interrupt
94 * Alt + Insert -> stop/start output (same as ^S/^Q)
95 * Alt + Up -> Scroll back console (if implemented)
96 * Alt + Down -> Scroll forward console (if implemented)
97 * Alt + CapsLock -> NumLock
101 * - Help mapped to K_HELP
102 * - Undo mapped to K_UNDO (= K_F246)
103 * - Keypad Left/Right Parenthesis mapped to new K_PPAREN[LR]
106 typedef enum kb_state_t
{
107 KEYBOARD
, AMOUSE
, RMOUSE
, JOYSTICK
, CLOCK
, RESYNC
110 #define IS_SYNC_CODE(sc) ((sc) >= 0x04 && (sc) <= 0xfb)
112 typedef struct keyboard_state
{
113 unsigned char buf
[6];
118 KEYBOARD_STATE kb_state
;
120 /* ++roman: If a keyboard overrun happened, we can't tell in general how much
121 * bytes have been lost and in which state of the packet structure we are now.
122 * This usually causes keyboards bytes to be interpreted as mouse movements
123 * and vice versa, which is very annoying. It seems better to throw away some
124 * bytes (that are usually mouse bytes) than to misinterpret them. Therefor I
125 * introduced the RESYNC state for IKBD data. In this state, the bytes up to
126 * one that really looks like a key event (0x04..0xf2) or the start of a mouse
127 * packet (0xf8..0xfb) are thrown away, but at most 2 bytes. This at least
128 * speeds up the resynchronization of the event structure, even if maybe a
129 * mouse movement is lost. However, nothing is perfect. For bytes 0x01..0x03,
130 * it's really hard to decide whether they're mouse or keyboard bytes. Since
131 * overruns usually occur when moving the Atari mouse rapidly, they're seen as
132 * mouse bytes here. If this is wrong, only a make code of the keyboard gets
133 * lost, which isn't too bad. Loosing a break code would be disastrous,
134 * because then the keyboard repeat strikes...
137 static irqreturn_t
atari_keyboard_interrupt(int irq
, void *dummy
)
144 if (acia
.mid_ctrl
& ACIA_IRQ
)
145 if (atari_MIDI_interrupt_hook
)
146 atari_MIDI_interrupt_hook();
147 acia_stat
= acia
.key_ctrl
;
148 /* check out if the interrupt came from this ACIA */
149 if (!((acia_stat
| acia
.mid_ctrl
) & ACIA_IRQ
))
152 if (acia_stat
& ACIA_OVRN
) {
153 /* a very fast typist or a slow system, give a warning */
154 /* ...happens often if interrupts were disabled for too long */
155 printk(KERN_DEBUG
"Keyboard overrun\n");
156 scancode
= acia
.key_data
;
158 /* During self test, don't do resyncing, just process the code */
159 goto interpret_scancode
;
160 else if (IS_SYNC_CODE(scancode
)) {
161 /* This code seem already to be the start of a new packet or a
163 kb_state
.state
= KEYBOARD
;
164 goto interpret_scancode
;
166 /* Go to RESYNC state and skip this byte */
167 kb_state
.state
= RESYNC
;
168 kb_state
.len
= 1; /* skip max. 1 another byte */
173 if (acia_stat
& ACIA_RDRF
) {
174 /* received a character */
175 scancode
= acia
.key_data
; /* get it or reset the ACIA, I'll get it! */
176 tasklet_schedule(&keyboard_tasklet
);
178 switch (kb_state
.state
) {
182 kb_state
.state
= AMOUSE
;
190 kb_state
.state
= RMOUSE
;
192 kb_state
.buf
[0] = scancode
;
196 kb_state
.state
= CLOCK
;
202 kb_state
.state
= JOYSTICK
;
204 kb_state
.buf
[0] = scancode
;
208 /* during self-test, note that 0xf1 received */
209 if (ikbd_self_test
) {
211 self_test_last_rcv
= jiffies
;
217 break_flag
= scancode
& BREAK_MASK
;
218 scancode
&= ~BREAK_MASK
;
219 if (ikbd_self_test
) {
220 /* Scancodes sent during the self-test stand for broken
221 * keys (keys being down). The code *should* be a break
222 * code, but nevertheless some AT keyboard interfaces send
223 * make codes instead. Therefore, simply ignore
228 set_bit(scancode
, broken_keys
);
229 self_test_last_rcv
= jiffies
;
230 /* new Linux scancodes; approx. */
232 keytyp
= KTYP(keyval
) - 0xf0;
233 keyval
= KVAL(keyval
);
235 printk(KERN_WARNING
"Key with scancode %d ", scancode
);
236 if (keytyp
== KT_LATIN
|| keytyp
== KT_LETTER
) {
238 printk("('^%c') ", keyval
+ '@');
240 printk("('%c') ", keyval
);
242 printk("is broken -- will be ignored.\n");
244 } else if (test_bit(scancode
, broken_keys
))
247 if (atari_input_keyboard_interrupt_hook
)
248 atari_input_keyboard_interrupt_hook((unsigned char)scancode
, !break_flag
);
254 kb_state
.buf
[kb_state
.len
++] = scancode
;
255 if (kb_state
.len
== 5) {
256 kb_state
.state
= KEYBOARD
;
258 /* wake up someone waiting for this */
263 kb_state
.buf
[kb_state
.len
++] = scancode
;
264 if (kb_state
.len
== 3) {
265 kb_state
.state
= KEYBOARD
;
266 if (atari_mouse_interrupt_hook
)
267 atari_mouse_interrupt_hook(kb_state
.buf
);
272 kb_state
.buf
[1] = scancode
;
273 kb_state
.state
= KEYBOARD
;
274 #ifdef FIXED_ATARI_JOYSTICK
275 atari_joystick_interrupt(kb_state
.buf
);
280 kb_state
.buf
[kb_state
.len
++] = scancode
;
281 if (kb_state
.len
== 6) {
282 kb_state
.state
= KEYBOARD
;
283 /* wake up someone waiting for this.
284 But will this ever be used, as Linux keeps its own time.
285 Perhaps for synchronization purposes? */
286 /* wake_up_interruptible(&clock_wait); */
291 if (kb_state
.len
<= 0 || IS_SYNC_CODE(scancode
)) {
292 kb_state
.state
= KEYBOARD
;
293 goto interpret_scancode
;
301 if (acia_stat
& ACIA_CTS
)
305 if (acia_stat
& (ACIA_FE
| ACIA_PE
)) {
306 printk("Error in keyboard communication\n");
309 /* handle_scancode() can take a lot of time, so check again if
310 * some character arrived
316 * I write to the keyboard without using interrupts, I poll instead.
317 * This takes for the maximum length string allowed (7) at 7812.5 baud
318 * 8 data 1 start 1 stop bit: 9.0 ms
319 * If this takes too long for normal operation, interrupt driven writing
320 * is the solution. (I made a feeble attempt in that direction but I
321 * kept it simple for now.)
323 void ikbd_write(const char *str
, int len
)
327 if ((len
< 1) || (len
> 7))
328 panic("ikbd: maximum string length exceeded");
330 acia_stat
= acia
.key_ctrl
;
331 if (acia_stat
& ACIA_TDRE
) {
332 acia
.key_data
= *str
++;
338 /* Reset (without touching the clock) */
339 void ikbd_reset(void)
341 static const char cmd
[2] = { 0x80, 0x01 };
346 * if all's well code 0xF1 is returned, else the break codes of
347 * all keys making contact
351 /* Set mouse button action */
352 void ikbd_mouse_button_action(int mode
)
354 char cmd
[2] = { 0x07, mode
};
359 /* Set relative mouse position reporting */
360 void ikbd_mouse_rel_pos(void)
362 static const char cmd
[1] = { 0x08 };
366 EXPORT_SYMBOL(ikbd_mouse_rel_pos
);
368 /* Set absolute mouse position reporting */
369 void ikbd_mouse_abs_pos(int xmax
, int ymax
)
371 char cmd
[5] = { 0x09, xmax
>>8, xmax
&0xFF, ymax
>>8, ymax
&0xFF };
376 /* Set mouse keycode mode */
377 void ikbd_mouse_kbd_mode(int dx
, int dy
)
379 char cmd
[3] = { 0x0A, dx
, dy
};
384 /* Set mouse threshold */
385 void ikbd_mouse_thresh(int x
, int y
)
387 char cmd
[3] = { 0x0B, x
, y
};
391 EXPORT_SYMBOL(ikbd_mouse_thresh
);
393 /* Set mouse scale */
394 void ikbd_mouse_scale(int x
, int y
)
396 char cmd
[3] = { 0x0C, x
, y
};
401 /* Interrogate mouse position */
402 void ikbd_mouse_pos_get(int *x
, int *y
)
404 static const char cmd
[1] = { 0x0D };
408 /* wait for returning bytes */
411 /* Load mouse position */
412 void ikbd_mouse_pos_set(int x
, int y
)
414 char cmd
[6] = { 0x0E, 0x00, x
>>8, x
&0xFF, y
>>8, y
&0xFF };
419 /* Set Y=0 at bottom */
420 void ikbd_mouse_y0_bot(void)
422 static const char cmd
[1] = { 0x0F };
428 void ikbd_mouse_y0_top(void)
430 static const char cmd
[1] = { 0x10 };
434 EXPORT_SYMBOL(ikbd_mouse_y0_top
);
437 void ikbd_resume(void)
439 static const char cmd
[1] = { 0x11 };
445 void ikbd_mouse_disable(void)
447 static const char cmd
[1] = { 0x12 };
451 EXPORT_SYMBOL(ikbd_mouse_disable
);
454 void ikbd_pause(void)
456 static const char cmd
[1] = { 0x13 };
461 /* Set joystick event reporting */
462 void ikbd_joystick_event_on(void)
464 static const char cmd
[1] = { 0x14 };
469 /* Set joystick interrogation mode */
470 void ikbd_joystick_event_off(void)
472 static const char cmd
[1] = { 0x15 };
477 /* Joystick interrogation */
478 void ikbd_joystick_get_state(void)
480 static const char cmd
[1] = { 0x16 };
486 /* This disables all other ikbd activities !!!! */
487 /* Set joystick monitoring */
488 void ikbd_joystick_monitor(int rate
)
490 static const char cmd
[2] = { 0x17, rate
};
494 kb_state
.state
= JOYSTICK_MONITOR
;
498 /* some joystick routines not in yet (0x18-0x19) */
500 /* Disable joysticks */
501 void ikbd_joystick_disable(void)
503 static const char cmd
[1] = { 0x1A };
508 /* Time-of-day clock set */
509 void ikbd_clock_set(int year
, int month
, int day
, int hour
, int minute
, int second
)
511 char cmd
[7] = { 0x1B, year
, month
, day
, hour
, minute
, second
};
516 /* Interrogate time-of-day clock */
517 void ikbd_clock_get(int *year
, int *month
, int *day
, int *hour
, int *minute
, int second
)
519 static const char cmd
[1] = { 0x1C };
525 void ikbd_mem_write(int address
, int size
, char *data
)
527 panic("Attempt to write data into keyboard memory");
531 void ikbd_mem_read(int address
, char data
[6])
533 char cmd
[3] = { 0x21, address
>>8, address
&0xFF };
537 /* receive data and put it in data */
540 /* Controller execute */
541 void ikbd_exec(int address
)
543 char cmd
[3] = { 0x22, address
>>8, address
&0xFF };
548 /* Status inquiries (0x87-0x9A) not yet implemented */
550 /* Set the state of the caps lock led. */
551 void atari_kbd_leds(unsigned int leds
)
553 char cmd
[6] = {32, 0, 4, 1, 254 + ((leds
& 4) != 0), 0};
559 * The original code sometimes left the interrupt line of
560 * the ACIAs low forever. I hope, it is fixed now.
562 * Martin Rogge, 20 Aug 1995
565 static int atari_keyb_done
= 0;
567 int atari_keyb_init(void)
574 kb_state
.state
= KEYBOARD
;
577 error
= request_irq(IRQ_MFP_ACIA
, atari_keyboard_interrupt
,
578 IRQ_TYPE_SLOW
, "keyboard/mouse/MIDI",
579 atari_keyboard_interrupt
);
583 atari_turnoff_irq(IRQ_MFP_ACIA
);
585 /* reset IKBD ACIA */
586 acia
.key_ctrl
= ACIA_RESET
|
587 ((atari_switches
& ATARI_SWITCH_IKBD
) ?
592 /* reset MIDI ACIA */
593 acia
.mid_ctrl
= ACIA_RESET
|
594 ((atari_switches
& ATARI_SWITCH_MIDI
) ?
599 /* divide 500kHz by 64 gives 7812.5 baud */
600 /* 8 data no parity 1 start 1 stop bit */
601 /* receive interrupt enabled */
602 /* RTS low (except if switch selected), transmit interrupt disabled */
603 acia
.key_ctrl
= (ACIA_DIV64
|ACIA_D8N1S
|ACIA_RIE
) |
604 ((atari_switches
& ATARI_SWITCH_IKBD
) ?
605 ACIA_RHTID
: ACIA_RLTID
);
607 acia
.mid_ctrl
= ACIA_DIV16
| ACIA_D8N1S
|
608 ((atari_switches
& ATARI_SWITCH_MIDI
) ?
611 /* make sure the interrupt line is up */
612 } while ((st_mfp
.par_dt_reg
& 0x10) == 0);
614 /* enable ACIA Interrupts */
615 st_mfp
.active_edge
&= ~0x10;
616 atari_turnon_irq(IRQ_MFP_ACIA
);
620 /* wait for a period of inactivity (here: 0.25s), then assume the IKBD's
621 * self-test is finished */
622 self_test_last_rcv
= jiffies
;
623 while (time_before(jiffies
, self_test_last_rcv
+ HZ
/4))
625 /* if not incremented: no 0xf1 received */
626 if (ikbd_self_test
== 1)
627 printk(KERN_ERR
"WARNING: keyboard self test failed!\n");
630 ikbd_mouse_disable();
631 ikbd_joystick_disable();
633 #ifdef FIXED_ATARI_JOYSTICK
634 atari_joystick_init();
641 EXPORT_SYMBOL_GPL(atari_keyb_init
);