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
41     0xF8-0xFB       relative mouse position records (lsbs determined by
43     0xFC            time-of-day
67 ---------------------------
72 settable threshold of motion. Regardless of the threshold, all bits of
75 significantly more than the threshold delta x or y. This may happen since no
85                         ; and x is the left button state
86     X                   ; delta x as twos complement integer
87     Y                   ; delta y as twos complement integer
92 +127...-128 range, the motion is broken into multiple packets.
93 Note that the sign of the delta y reported is a function of the Y origin
97 ---------------------------
100 resetting the mouse position, setting X/Y scaling, and interrogating the
104 ---------------------
120 ------------------------
127     %1111111x           ; Joystick event marker
128                         ; where x is Joystick 0 or 1
130                         ; and x is the trigger
133 ----------------------
143                         ; where x is the trigger
147 -------------------
156 ----------------------
167 ----------------------
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
201 The ikbd defaults to a mouse position reporting with threshold of 1 unit in
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
241 -----------------------
251                         ;  and x=1, mouse key release causes absolute report
260 -------------------------------------
268 threshold in either axis (see SET MOUSE THRESHOLD). Depending upon the mouse
274 ------------------------------
279     XMSB                ; X maximum (in scaled mouse clicks)
284 Set absolute mouse position maintenance. Resets the ikbd maintained X and Y
292 ----------------------
297     deltax              ; distance in X clicks to return (LEFT) or (RIGHT)
307 SET MOUSE THRESHOLD
308 -------------------
313     X                   ; x threshold in mouse ticks (positive integers)
314     Y                   ; y threshold in mouse ticks (positive integers)
316 This command sets the threshold before a mouse event is generated. Note that
319 default to 1 at RESET (or power-up).
322 ---------------
327     X                   ; horizontal mouse ticks per internal X
339 --------------------------
351             XMSB       ; X coordinate
360 -------------------
366     XMSB                ; X coordinate
375 -----------------
387 --------------
399 ------
411 -------------
425 ------------
438 normal threshold limits to produce the minimum number of packets necessary for
453 ----------------------------
463 -------------------------------
473 --------------------
484 -----------------------
492                         ; and x is JOYSTICK0 Fire button
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 -------------------------
545 every Vn tenths of seconds. This provides a velocity (auto-repeat) breakpoint
552 -----------------
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 ----------------
657                         ; DELTA X is KEYCODE
660                         ; DELTA Y is KEYCODE
684             0x8B    mnouse threshold
727 0C	\-
760 2D	X
789 4A	KEYPAD -