/* @(#)kbd.h 1.1 86/02/03 SMI */ /* (C) Copyright 1983 by Sun Microsystems, Inc. */ /* * Header file for Sun Microsystems keyboard routines * which is disgustingly similar to ../mon/keyboard.h. * Since the Sun kernel uses these constants to decode * at least the keybid passed by the monitor, these files * must be kept in sync, or merged. * * The keyboard is a standard Micro Switch, or otherwise, keyboard, * with an 8048/8748 on the board. This has been modified to produce * up/down keycodes. * * On Sun-1 keyboards these keycodes are output on 8 parallel output lines. * Each keycode is held stable on these lines for a minimum of 2.5 ms in * order that the main processor can read it during its refresh * routine, which executes every 2 ms or so. * * On Sun-2 keyboards, the keycodes are transmitted on a serial line * at 1200 baud. * * When no physical keys are depressed, the keyboard transmits a keycode of * "IDLE" (7F hex), to indicate that. Thus, when the last key is released, * a keycode for its release is sent, then an IDLE. Note that virtual * keys on the VT100 kbd (eg CAPS LOCK) can be down when the IDLE code * is received. * * The Sun-1 VT100 keyboard will follow each of its IDLE's with a * keyboard id code, identifying the key layout or other factors * which host programs might want to automatically determine. * * The low 4 bits of the id byte contain the keyboard ID (currently * 1 for VT100 keyboard); the high order bit is set (to make sure * there's a transition between the IDLE (7F) and the identification * byte); the -XXX---- bits contain state information about the keyboard. * These bits are allocated from opposite ends in case we need to shift * the boundary. The only state bit currently defined is 0x40, which is * the current state of the CAPS LOCK LED. * * The Sun-2 keyboard also transmits two other "special" keycodes: * * RESETKEY upon power-up, when no errors are detected, * this code is sent and followed by the keyboard id, * a byte containing 0x02. * * ERRORKEY upon power-up, when errors are detected, * this code is sent and followed by a "cause" byte * giving more details. There is only one cause byte * defined so far -- checksum error on PROM. */ /* * Various special characters that might show up on the port */ /* Both of these are followed by 1 byte of parameters. */ #define RESETKEY 0xFF /* Keyboard was just reset */ #define ERRORKEY 0x7E /* Keyboard detected an error */ #define NOTPRESENT 0xFF /* Keyboard is not plugged in */ #define IDLEKEY 0x7F /* Keyboard is idle; no keys down */ #define PRESSED 0x00 /* 0x80 bit off: key was pressed */ #define RELEASED 0x80 /* 0x80 bit on : key was released */ /* * Keyboard ID codes...transmitted by the various keyboards * after the IDLEKEY code. See top of file for more details. * The value of KB_UNKNOWN above must not match any of these, * if KBDID is set. */ #define KB_KLUNK 0x00 /* Micro Switch 103SD32-2 */ #define KB_VT100 0x01 /* Keytronics VT100 compatible */ #define KB_SUN2 0x02 /* Sun-2 custom keyboard */ #define KB_SUN3 0x03 /* Sun-3 custom keyboard */ #define KB_ASCII 0x0F /* Ascii terminal masquerading as kbd */ /* * Commands to the Sun-2 keyboard. */ #define KBD_CMD_RESET 0x01 /* Reset keyboard as if power-up */ #define KBD_CMD_BELL 0x02 /* Turn on the bell */ #define KBD_CMD_NOBELL 0x03 /* Turn off the bell */ #define KBD_CMD_LED1 0x04 /* Turn on LED 1 */ #define KBD_CMD_NOLED1 0x05 /* Turn off LED 1 */ #define KBD_CMD_LED2 0x06 /* Turn on LED 2 */ #define KBD_CMD_NOLED2 0x07 /* Turn off LED 2 */ /* * Commands to the Sun-3 keyboard. KBD_CMD_BELL & KBD_CMD_NOBELL work * as well. */ #define KBD_CMD_CLICK 0x0A /* Turn on the click annunciator */ #define KBD_CMD_NOCLICK 0x0B /* Turn off the click annunciator */ /* * Software related definitions */ /* * These are the states that the keyboard scanner can be in. * * It starts out in NORMAL state. */ #define NORMAL 0 /* The usual (ho, hum) */ #define ABORT1 1 /* Got KEYABORT1 */ #define IDLE1 2 /* Got IDLE */ #define IDLE2 3 /* Got id byte, IDLE probably follows */ /* * These are how you can have your input translated. * TR_EVENT means that each keystroke is sent as a firm event. */ #define TR_NONE 0 #define TR_ASCII 1 #define TR_EVENT 2 /* * These bits can appear in the result of TR_NONE getkey()s. */ #define STATEOF(key) ((key) & 0x80) /* 0 = key down, 0x80 = key up */ #define KEYOF(key) ((key) & 0x7F) /* The key number that moved */ #define NOKEY (-1) /* The argument was 0, and no key was depressed. They were all elated. */ /* * These bits can appear in the result of TR_ASCII getkey()s. * (NOKEY can also appear if no keypress was queued up.) */ #define METABIT 0 /* Meta key depressed with key */ #define METAMASK 0x000080 #define SYSTEMBIT 1 /* Upper left key was down w/key */ #define SYSTEMMASK 0x000100 /* other "bucky" bits can be defined at will. See "BUCKYBITS" below. */ /* * This defines the bit positions used within "shiftmask" to * indicate the "pressed" (1) or "released" (0) state of shift keys. * Both the bit numbers, and the aggregate masks, are defined. * * The "UPMASK" is a minor kludge. Since whether the key is going * up or down determines the translation table (just as the shift * keys' positions do), we OR it with "shiftmask" to get "tempmask", * which is the mask which is actually used to determine the * translation table to use. Don't reassign 0x0080 for anything * else, or we'll have to shift and such to squeeze in UPMASK, * since it comes in from the hardware as 0x80. */ #ifndef CAPSLOCK /* Same as sunwindow/win_input.h */ #define CAPSLOCK 0 /* Caps Lock key */ #define CAPSMASK 0x0001 #define SHIFTLOCK 1 /* Shift Lock key */ #define LEFTSHIFT 2 /* Left-hand shift key */ #define RIGHTSHIFT 3 /* Right-hand shift key */ #define SHIFTMASK 0x000E #define LEFTCTRL 4 /* Left-hand (or only) control key */ #define RIGHTCTRL 5 /* Right-hand control key */ #define CTRLMASK 0x0030 #endif CAPSLOCK /* unused... 0x0040 */ #define UPMASK 0x0080 #define CTLSMASK 0x0100 /* Set if ^S was last keyed of ^S, ^Q; determines which NOSCOLL sends. */ #define ALT 6 /* ALT key on Sun-3 keyboard */ /* * This defines the format of translation tables. * * A translation table is 128 bytes of "entries", which are bytes * (unsigned chars). The top 4 bits of each entry are decoded by * a case statement in getkey.c. If the entry is less than 0x80, it * is sent out as an ASCII character (possibly with bucky bits * OR-ed in). "Special" entries are 0x80 or greater, and * invoke more complicated actions. */ struct keymap { unsigned char keymap[128]; /* maps keycodes to actions */ }; /* * A keyboard is defined by its keymaps and what state it resets at idle. * * The masks k_idleshifts and k_idlebuckys are AND-ed with the current * state of shiftmask and buckybits when a "keyboard idle" code * is received. This ensures that where we "think" the shift & bucky * keys are, more accurately reflects where they really are, since the * keyboard knows better than us. However, some keyboards don't know * about shift states that should be remembered across idles. Such * shifts are described by k_toggleshifts. k_toggleshifts are used to * identify such shifts. A toggle shift state is maintained separately * from the general shift state. The toggle shift state is OR-ed * with the state general shift state when an idle is received. * k_toggleshifts should not appear in the k_up table. */ struct keyboard { struct keymap *k_normal; /* Unshifted */ struct keymap *k_shifted; /* Shifted */ struct keymap *k_caps; /* Caps locked */ struct keymap *k_control; /* Controlled */ struct keymap *k_up; /* Key went up */ int k_idleshifts; /* Shifts that keep across idle */ int k_idlebuckys; /* Bucky bits that keep across idle */ unsigned char k_abort1; /* 1st key of abort sequence */ unsigned char k_abort2; /* 2nd key of abort sequence */ int k_toggleshifts; /* Shifts that toggle on down from kbd * and keep across idle */ }; /* * The "special" entries' top 4 bits are defined below. Generally they are * used with a 4-bit parameter (such as a bit number) in the low 4 bits. * The bytes whose top 4 bits are 0x0 thru 0x7 happen to be ascii * characters. They are not special cased, but just normal cased. */ #define SHIFTKEYS 0x80 /* thru 0x8F. This key helps to determine the translation table used. The bit position of its bit in "shiftmask" is added to the entry, eg SHIFTKEYS+LEFTCTRL. When this entry is invoked, the bit in "shiftmask" is toggled. Depending which tables you put it in, this works well for hold-down keys or press-on, press-off keys. */ #define BUCKYBITS 0x90 /* thru 0x9F. This key determines the state of one of the "bucky" bits above the returned ASCII character. This is basically a way to pass mode-key-up/down information back to the caller with each "real" key depressed. The concept, and name "bucky" (derivation unknown) comes from the MIT/SAIL "TV" system...they had TOP, META, CTRL, and a few other bucky bits. The bit position of its bit in "buckybits", minus 7, is added to the entry; eg bit 0x00000400 is BUCKYBITS+3. The "-7" prevents us from messing up the ASCII char, and gives us 16 useful bucky bits. When this entry is invoked, the designated bit in "buckybits" is toggled. Depending which tables you put it in, this works well for hold-down keys or press-on, press-off keys. */ #define FUNNY 0xA0 /* thru 0xAF. This key does one of 16 funny things based on the low 4 bits: */ #define NOP 0xA0 /* This key does nothing. */ #define OOPS 0xA1 /* This key exists but is undefined. */ #define HOLE 0xA2 /* This key does not exist on the keyboard. Its position code should never be generated. This indicates a software/ hardware mismatch, or bugs. */ #define NOSCROLL 0xA3 /* This key alternately sends ^S or ^Q */ #define CTRLS 0xA4 /* This sends ^S and lets NOSCROLL know */ #define CTRLQ 0xA5 /* This sends ^Q and lets NOSCROLL know */ #define RESET 0xA6 /* Kbd was just reset */ #define ERROR 0xA7 /* Kbd just detected an internal error */ #define IDLE 0xA8 /* Kbd is idle (no keys down) */ /* Combinations 0xA9 to 0xAF are reserved for non-parameterized functions */ #define STRING 0xB0 /* thru 0xBF. The low-order 4 bits index a table select a string to be returned, char by char. Each entry the table is null terminated. */ #define KTAB_STRLEN 10 /* Maximum string length (including null) */ /* Definitions for the individual string numbers: */ #define HOMEARROW 0x00 #define UPARROW 0x01 #define DOWNARROW 0x02 #define LEFTARROW 0x03 #define RIGHTARROW 0x04 /* string numbers 5 thru F are available to users making custom entries */ /* In the following function key groupings, the low-order 4 bits indicate the function key number with in the group. */ #define LEFTFUNC 0xC0 /* thru 0xCF. The "left" group. */ #define RIGHTFUNC 0xD0 /* thru 0xDF. The "right" group. */ #define TOPFUNC 0xE0 /* thru 0xEF. The "top" group. */ #define BOTTOMFUNC 0xF0 /* thru 0xFF. The "bottom" group. */ #define LF(n) (LEFTFUNC+(n)-1) #define RF(n) (RIGHTFUNC+(n)-1) #define TF(n) (TOPFUNC+(n)-1) #define BF(n) (BOTTOMFUNC+(n)-1) /* The actual keyboard positions may not be on the left/right/top/bottom of the physical keyboard (although they usually are). What is important is that we have reserved 64 keys for function keys. Normally, striking a function key will cause the following escape sequence to be sent through the character stream: ESC[0..9z where ESC is a single escape character and 0..9 indicate some number of digits needed to encode the function key as a decimal number. */