Devices                                               usb_mid(7D)
  
  
  
  NAME
       usb_mid - USB Multi Interface Driver
  
  SYNOPSIS
       device@unit-address
  
  DESCRIPTION
       The usb_mid 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 usb_mid
|      driver creates interface nodes or interface assocition nodes
|      and attempts to bind drivers to them. If no driver found for
|      interface association nodes, usb_ia(7D) is bound by default.
|      It will create nodes for the internal interfaces and attempt
|      to bind drivers to them.
|      
    UGEN (Generic USB)
       The usb_mid 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  usb_mid  driver
       creates a ugen interface only if none of  its  children  are
       explicitly  bound  to  the  ugen(7D)  driver.  Additionally,
       usb_mid does not create children.
  
  FILES
       /kernel/drv/usb_mid             32-bit x86 ELF kernel module
  
  
  
       /kernel/drv/amd64/usb_mid       64-bit x86 ELF kernel module
  
  
  
       /kernel/drv/sparcv9/usb_mid     64-bit  SPARC   ELF   kernel
                                       module
  
  
  
       /dev/usb/*/*/*                  ugen(7D) nodes.
  
  
  
  ATTRIBUTES
       See attributes(5) for descriptions of the  following  attri-
       butes:
  
  
  
  
  
  
  
  
  
  SunOS 5.10           Last change: 1 Dec 2005                    1
  
  
  
  
  
  
  Devices                                               usb_mid(7D)
  
  
  
       _____________________________________________________________
      |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE       |
      |_____________________________|______________________________|
      | Architecture                | SPARC, x86, PCI-based systems|
      |_____________________________|______________________________|
      | Availability                | SUNWusb                      |
      |_____________________________|______________________________|
  
  
  SEE ALSO
|      cfgadm_usb(1M),   libusb(3LIB),   attributes(5),   usba(7D),
|      usb_ia(7D)
  
       Writing Device Drivers
  
|      Universal Serial Bus Specification 2.0
  
|      Interface Association Descriptor Engineering Change Notice (ECN)
| 
       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: <device path> (usb_mid<instance number>): Error Message...
  
       Cannot access <device>. 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.
  
  
  
       Please disconnect and reconnect this device.
  
           A hotplug of the device  is  needed  before  it  can  be
           restored.
  
  
  
  
  
  
  SunOS 5.10           Last change: 1 Dec 2005                    2
  
  
  
  
  
  
  Devices                                               usb_mid(7D)
  
  
  
       The following messages may be logged into  the  system  log.
       They are formatted in the following manner:
  
       <device path><usb_mid<instance number>): message...
  
       No driver found for interface <n> (nodename: <string>) of
       <device>.
  
           No driver is available for this interface.
  
  
  
       No driver found for device <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.10           Last change: 1 Dec 2005                    3