Devices                                                   hid(7D)

NAME
     hid - Human interface device (HID) class driver

SYNOPSIS
     keyboard@unit-address
     mouse@unit-address

DESCRIPTION
     The hid driver  is a USBA (Solaris USB Architecture) compli-
     ant  client  driver that supports the Human Interface Device
     Class (HID) 1.0 specification. The  Human  Interface  Device
     (HID)  class   encompasses  devices  controlled by humans to
     operate computer systems. Typical examples  of  HID  devices
     include keyboards, mice, trackballs, and joysticks. HID also
     covers front-panel controls such  as  knobs,  switches,  and
     buttons.  A USB device with multiple interfaces may have one
     interface for audio and a HID interface to define  the  but-
     tons that control the audio.

     The  hid driver is general and  primarily  handles  the  USB
     functionality  of  the device and generic HID functionality.
     For example, HID interfaces are required to have  an  inter-
     rupt  pipe for the device to send data packets, and the  hid
     driver opens the pipe to the interrupt endpoint  and  starts
     polling. The hid driver is also responsible for managing the
     device through the default control  pipe.   In  addition  to
     being  a USB client driver, the hid driver is also a STREAMS
     driver so that modules may be pushed on top of it.

     The HID specification is flexible, and HID  devices  dynami-
     cally  describe  their  packets and other parameters through
     the HID report descriptor. The HID parser is a  misc  module
     that parses the HID report descriptor and creates a database
     of information about the device. The hid driver queries  the
     HID  parser  to find out the type and characteristics of the
     HID device. The HID specification predefines packet  formats
     for the boot protocol keyboard and mouse.

FILES
      /kernel/drv/hid
           32 bit ELF kernel module

     /kernel/drv/sparcv9/hid
           64 bit ELF kernel module

     /kernel/misc/hidparser
           /kernel/misc/sparcv9/hidparser

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

SunOS 5.8           Last change: 10 Oct 2000                    1

Devices                                                   hid(7D)

     ______________________________________________________________
    |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE        |
    |_____________________________|_______________________________|
    | Architecture                | Limited to  PCI-based  systems|
    |_____________________________|_______________________________|
    | Availability                | SUNWusb, SUNWusbx             |
    |_____________________________|_______________________________|

SEE ALSO
     hubd(7D),  ohci(7D),  uhci(7D),   usb_mid(7D),   usbkbm(7M),
     usbms(7M), usba(7D)

     Writing Device Drivers

     STREAMS Programming Guide

     Universal Serial Bus Specification 1.0 and 1.1

     Device Class Definition for Human  Interface  Devices  (HID)
     1.0

     System Administration Guide: Basic Administration

DIAGNOSTICS
     None.

NOTES
     The hid driver currently supports only keyboards and mice.

SunOS 5.8           Last change: 10 Oct 2000                    2