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 association
nodes and attempts to bind drivers to them. If no driver is
found for interface association nodes, usb_ia(7D) is bound
by default.
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.11 Last change: 22 Dec 2006 1
Devices usb_mid(7D)
______________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_______________________________|
| Architecture | SPARC & x86, PCI-based systems|
|_____________________________|_______________________________|
| Availability | driver/usb |
|_____________________________|_______________________________|
SEE ALSO
cfgadm_usb(1M), libusb(3LIB), attributes(5), usba(7D),
usb_ia(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: (usb_mid): 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 usb_mid(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