KBD(7-SysV)         RISC/os Reference Manual          KBD(7-SysV)



NAME
     kbd - RS2030 Display Keyboard Driver

SYNOPSIS
     display keyboard on RS2030 IOP

DESCRIPTION
     The kbd driver supports input from the RS2030 display key-
     board and control functions for the keyboard lights and the
     system buzzer.

     This driver serves as both a terminal driver and a special-
     ized driver for more direct control of the system keyboard.

     /dev/ttykeybd represents the terminal driver.  This device
     functions as a standard serial streams device, using the
     keyboard for input and the raw display character painting
     functions for output to the system display.  This driver
     converts keyboard input codes to ASCII characters.

     /dev/keybd represents the specialized keyboard control
     driver.  This driver returns keyboard input codes unchanged.
     They may be timestamped by using the KTCSETTIMESTAMP ioctl.
     The driver also supports several other specialized functions
     for using the system buzzer and keyboard lights (see below).
     Output to this driver goes to where the system console is
     linked.

     The following ioctl calls apply only to /dev/keybd:

     KTCSETTIMESTAMP
                    Turns on timestamping of all input from the
                    keyboard.  Each character received from the
                    keyboard is presented in a timestamp struc-
                    ture. These are composed of sync characters,
                    the keyboard character, and the time in HZ
                    since boot.  The structure is defined in
                    /usr/include/sys/kbd_ioctl.h.

     KTCCLRTIMESTAMP
                    Turns off keyboard input timestamping.

     KTCPRGMBUZZER  Allows sending a buzzer structure to the sys-
                    tem to program the system buzzer.  This
                    structure is defined in
                    /usr/include/sys/buzzer.h.

     KTCRINGBELL    Rings the buzzer to emulate a terminal bell
                    (control-g).  This function uses only the
                    command field of the ioctl.

     KTCSETLIGHTS   Turns on and off keyboard lights.  The lights



                         Printed 1/28/91                   Page 1

KBD(7-SysV)         RISC/os Reference Manual          KBD(7-SysV)



                    are turned on based on the bits set in the
                    parameter passed.  The values for each light
                    are in /usr/include/sys/kbd_ioctl.h. The old
                    state of the lights are not maintained. To
                    just turn one light on or off, you must use
                    KTCGETLIGHTS and/or the new light state into
                    that value for the KTCSETLIGHTS.

     KTCGETLIGHTS   Returns last value of KTCSETLIGHTS.

     KTCWRTCOLOR    Write the color map.  The following structure
                    defines which color map registers are writ-
                    ten:

      struct colorm {
         unsigned short cmstart;     /* starting map register number */
         unsigned short cmcount;     /* number of registers to write */
         unsigned char cmap[3*256];  /* register values */
      };

                    The map is written on the next valid vertical
                    retrace interrupt.

FILES
     /dev/ttykeybd
     /dev/keydb

SEE ALSO
     tty(7).


























 Page 2                  Printed 1/28/91