usbkbm(7M)                                                                                                                              usbkbm(7M)

NAME

       usbkbm - keyboard STREAMS module for Sun USB Keyboard

SYNOPSIS

       open("/dev/kbd", O_RDWR)

       The   usbkbm  STREAMS  module  processes  byte streams generated by a keyboard attached to a  USB port.   USB keyboard is a member of Human
       Interface Device (HID) Class, and usbkbm only supports the keyboard protocol defined in the specification.  Definitions for  altering  key-
       board translation and reading events from the keyboard are in  <sys/kbio.h> and  <sys/kbd.h>.

       The   usbkbm  STREAMS module adheres to the interfaces exported by kb(7M). Refer to the  DESCRIPTION section of  kb(7M) for a discussion of
       the keyboard translation modes and the IOCTL section for the supported  ioctl(2) requests.

       USB Keyboard usbkbm returns different values  for the following ioctls than kb(7M):

       KIOCTYPE

           This  ioctl() returns a new keyboard type defined for the  USB keyboard. All types are listed below:

              KB_SUN3   Sun Type 3 keyboard
              KB_SUN4   Sun Type 4 keyboard
              KB_ASCII  ASCII terminal masquerading as keyboard
              KB_PC     Type 101 PC keyboard
              KB_USB    USB keyboard

              The  USB keyboard type is KB_USB; usbkbm will return  KB_USB in response to the  KIOCTYPE ioctl.

       KIOCLAYOUT

           The argument is a pointer to an  int. The layout code specified by the bCountryCode value returned in the HID descriptor is returned in
           the int pointed to by the argument. The countrycodes are defined in 6.2.1 of the  HID 1.0 specifications.

       KIOCCMD

           KBD_CMD_CLICK/KBD_CMD_NOCLICK

               The kb(7M) indicates that inappropriate commands for particular keyboards are ignored. Because clicking is not supported on the USB
               keyboard, usbkbm ignores this command

           KBD_CMD_SETLED

               Set keyboard LEDs. Same as  kb(7M).

           KBD_CMD_GETLAYOUT

               The country codes defined in 6.2.1 of the HID 1.0 specification are returned.

           KBD_CMD_BELL/KBD_CMD_NOBELL

               This command is supported although the USB keyboard does not have a buzzer.  The request for the bell is rerouted.

           KBD_CMD_RESET

               There is no notion of resetting the keyboard as there is for the type4 keyboard. usbkbm ignores this command and  does  not  return
               an error.

FILES

       /kernel/strmod/usbkbm

           32-bit ELF kernel STREAMS module ( platform only)

       /kernel/strmod/sparcv9/usbkbm

           SPARC 64-bit ELF kernel STREAMS module

       See attributes(5) for a description of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Architecture                 |PCI-based  systems           |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWusb                      |
       +-----------------------------+-----------------------------+

       dumpkeys(1), kbd(1), loadkeys(1), ioctl(2), keytables(4), attributes(5), hid(7D), usba(7D), virtualkm(7D), kb(7M)

       STREAMS Programming Guide

       System Administration Guide: Basic Administration

       http://www.sun.com/io

DIAGN0STICS
       None

                                                                   27 June 2005                                                         usbkbm(7M)