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
84                         ; where y is the right 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 ------------------------
133 ----------------------
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
202 either axis and the Y=0 origin at the top of the screen, and joystick event
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 -----------------------
250                         ;  where y=1, mouse key press causes absolute report
260 -------------------------------------
268 threshold in either axis (see SET MOUSE THRESHOLD). Depending upon the mouse
274 ------------------------------
281     YMSB                ; Y maximum (in scaled mouse clicks)
284 Set absolute mouse position maintenance. Resets the ikbd maintained X and Y
292 ----------------------
298     deltay              ; distance in Y clicks to return (UP) or (DOWN)
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 ---------------
328     Y                   ; vertical mouse ticks per internal Y
339 --------------------------
353             YMSB       ; Y coordinate
360 -------------------
368     YMSB                ; Y coordinate
374 SET Y=0 AT BOTTOM
375 -----------------
381 This command makes the origin of the Y axis to be at the bottom of the
386 SET Y=0 AT TOP
387 --------------
393 Makes the origin of the Y axis to be at the top of the logical coordinate
399 ------
411 -------------
425 ------------
438 normal threshold limits to produce the minimum number of packets necessary for
453 ----------------------------
463 -------------------------------
473 --------------------
484 -----------------------
491             %000000xy   ; where y is JOYSTICK1 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
687             0x90    ( returns       0x0F Y=0 at bottom
688                             0x10 Y=0 at top )
727 0C	\-
736 15	Y
789 4A	KEYPAD -