Devices                                               usbmid(7D)



NAME
     usbmid - USB Multi Interface Driver

SYNOPSIS
     device@unit-address


DESCRIPTION
     The usbmid driver is a USBA (Solaris Universal  Serial  Bus
     Architecture)-compliant   nexus  driver that binds to device
     level nodes of a composite (multi interface)  device  if  no
     vendor  or  class-specific  driver is available. The usbmid
     driver creates  interface  nodes  or  interface  association
     nodes  and attempts to bind drivers to them. If no driver is
     found for interface association nodes, usbia(7D)  is  bound
     by default.

  UGEN (Generic USB)
     The usbmid driver also supports a ugen(7D) interface allow-
     ing  raw  access  to the device, for example by libusb(3LIB)
     applications, by passing the drivers bound  to  each  inter-
     face.  Since  a libusb application might change the state of
     the device, you should not access  the  device  through  the
     child  interface  drivers.  Note  that  the  usbmid  driver
     creates a ugen interface only if none of  its  children  are
     explicitly  bound  to  the  ugen(7D)  driver.  Additionally,
     usbmid does not create children.

FILES
     /kernel/drv/usbmid

         32-bit x86 ELF kernel module


     /kernel/drv/amd64/usbmid

         64-bit x86 ELF kernel module


     /kernel/drv/sparcv9/usbmid

         64-bit SPARC ELF kernel module


     /dev/usb/*/*/*

         ugen(7D) nodes.


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



SunOS 5.11          Last change: 22 Dec 2006                    1






Devices                                               usbmid(7D)



     
           ATRIBUTE TYPE                ATRIBUTE VALUE        
    
     Architecture                 SPARC & x86, PCI-based systems
    
     Availability                 SUNWusb                       
    


SEE ALSO
     cfgadmusb(1M),   libusb(3LIB),   attributes(5),   usba(7D),
     usbia(7D)


     Writing Device Drivers


     Universal Serial Bus Specification 2.0-2000


     Interface Association Descriptor Engineering  Change  Notice
     (ECN)-2003


     System Administration Guide: Basic Administration


     http:/www.sun.com/io

DIAGNOSTICS
     In addition to being  logged,  the  following  messages  may
     appear  on the system console. All messages are formatted in
     the following manner:

       Warning:  (usbmid): Error Message...



     Cannot access . Please reconnect.

         This device has been disconnected because a device other
         than  the  original  one  has  been inserted. The driver
         informs you of this fact by displaying the name  of  the
         original device.


     Device not identical to the previous one on this port.
     Please disconnect and reconnect.

         Same condition as described above; however in this case,
         the  driver  is  unable  to identify the original device
         with a name string.



SunOS 5.11          Last change: 22 Dec 2006                    2






Devices                                               usbmid(7D)



     Please disconnect and reconnect this device.

         A hotplug of the device  is  needed  before  it  can  be
         restored.



     The following messages may be logged into  the  system  log.
     They are formatted in the following manner:

       ): message...



     No driver found for interface  (nodename: ) of
     .

         No driver is available for this interface.


     No driver found for device .

         No driver is available for this interface.


     Can't support ugen for multiple configuration devices that
     have attached child interface drivers.

         No ugen interface is available and  libusb(3LIB)  cannot
         work with this device.

























SunOS 5.11          Last change: 22 Dec 2006                    3