input/devices/atarikbd.rst

12 provides a convenient connection point for a mouse and switch-type joysticks.
13 The ikbd processor also maintains a time-of-day clock with one second
18 The ikbd communicates with the main processor over a high speed bi-directional
27 The keyboard always returns key make/break scan codes. The ikbd generates
28 keyboard scan codes for each key press and release. The key scan make (key
30 ISO key position in the scan code table should exist even if no keyswitch
31 exists in that position on a particular keyboard. The break code for each key
41     0xF8-0xFB       relative mouse position records (lsbs determined by
43     0xFC            time-of-day
49 The two shift keys return different scan codes in this mode. The ENTER key
50 and the RETurn key are also distinct.
62 key equivalents.
67 ---------------------------
92 +127...-128 range, the motion is broken into multiple packets.
97 ---------------------------
103 Mouse Cursor Key Mode
104 ---------------------
109 highest resolution available, and merely generates a pair of cursor key events
111 Mouse motion produces the cursor key make code immediately followed by the
112 break code for the appropriate cursor key. The mouse buttons produce scan
120 ------------------------
133 ----------------------
147 -------------------
156 ----------------------
166 Joystick Key Code Mode
167 ----------------------
174 joysticks produce pseudo key scan codes above those used by the largest key
177 Time-of-Day Clock
180 The ikbd also maintains a time-of-day clock for the system. Commands are
181 available to set and interrogate the timer-of-day clock. Time-keeping is
190 Power-Up Mode
193 The keyboard controller will perform a simple self-test on power-up to detect
195 keys. Any keys down at power-up are presumed to be stuck, and their BREAK
197 keyboard error). If the controller self-test completes without error, the code
206 DISABLE) then causes port 0 to again be scanned as if it were a mouse, and
207 both buttons are logically connected to it. If a mouse disable command is
219 -----
231 Executing the RESET command returns the keyboard to its default (power-up)
232 mode and parameter settings. It does not affect the time-of-day clock.
233 The RESET command or function causes the ikbd to perform a simple self-test.
235 of receipt of the RESET command (or the end of the break, or power-up). The
236 ikbd will then scan the key matrix for any stuck (closed) keys. Any keys found
238 without being preceded by the make code is a flag for a key matrix error).
241 -----------------------
250                         ;  where y=1, mouse key press causes absolute report
251                         ;  and x=1, mouse key release causes absolute report
260 -------------------------------------
269 key mode, mouse position reports may also be generated when either mouse
274 ------------------------------
292 ----------------------
303 either axis. When the keyboard is in key scan code mode, mouse motion will
308 -------------------
319 default to 1 at RESET (or power-up).
322 ---------------
339 --------------------------
360 -------------------
375 -----------------
387 --------------
399 ------
410 DISABLE MOUSE
411 -------------
425 ------------
431 Stop sending data to the host until another valid command is received. Key
453 ----------------------------
463 -------------------------------
473 --------------------
484 -----------------------
497 time-of-day clock, and monitor the joystick. The rate sets the interval
503 --------------------------
513 time-of-day clock, and monitor the fire button on Joystick 1. The fire button
519 -------------------------
529                         ; until horizontal cursor key is generated before RX
532                         ; until vertical cursor key is generated before RY
545 every Vn tenths of seconds. This provides a velocity (auto-repeat) breakpoint
551 DISABLE JOYSTICKS
552 -----------------
558 Disable the generation of any joystick events (and scanning may be internally
564 TIME-OF-DAY CLOCK SET
565 ---------------------
577 All time-of-day data should be sent to the ikbd in packed BCD format.
580 only some subfields of the time-of-day clock.
582 INTERROGATE TIME-OF-DAT CLOCK
583 -----------------------------
589             0xFC        ; time-of-day event header
597     All time-of-day is sent in packed BCD format.
600 -----------
607     NUM                 ; number of bytes (0-128)
614 -----------
629 ------------------
641 ----------------
689             0x92    mouse enable/disable
695             0x9A    joystick enable/disable
708 The key scan codes returned by the ikbd are chosen to simplify the
727 0C	\-
789 4A	KEYPAD -
801 60	ISO KEY