1usb_mid(7D)                         Devices                        usb_mid(7D)
2
3
4

NAME

6       usb_mid - USB Multi Interface Driver
7

SYNOPSIS

9       device@unit-address
10
11

DESCRIPTION

13       The  usb_mid  driver  is a USBA (Solaris Universal Serial Bus Architec‐
14       ture)-compliant  nexus  driver that binds to device level  nodes  of  a
15       composite  (multi  interface)  device  if  no  vendor or class-specific
16       driver is available. The usb_mid  driver  creates  interface  nodes  or
17       interface association nodes and attempts to bind drivers to them. If no
18       driver is found for interface association nodes, usb_ia(7D) is bound by
19       default.
20
21   UGEN (Generic USB)
22       The  usb_mid  driver  also  supports  a ugen(7D) interface allowing raw
23       access to the device, for  example  by  libusb(3LIB)  applications,  by
24       passing the drivers bound to each interface. Since a libusb application
25       might change the state of the device, you should not access the  device
26       through  the child interface drivers. Note that the usb_mid driver cre‐
27       ates a ugen interface only if none of its children are explicitly bound
28       to the ugen(7D) driver. Additionally, usb_mid does not create children.
29

FILES

31       /kernel/drv/usb_mid
32
33           32-bit x86 ELF kernel module
34
35
36       /kernel/drv/amd64/usb_mid
37
38           64-bit x86 ELF kernel module
39
40
41       /kernel/drv/sparcv9/usb_mid
42
43           64-bit SPARC ELF kernel module
44
45
46       /dev/usb/*/*/*
47
48           ugen(7D) nodes.
49
50

ATTRIBUTES

52       See attributes(5) for descriptions of the following attributes:
53
54
55
56
57       ┌─────────────────────────────┬───────────────────────────────┐
58       │      ATTRIBUTE TYPE         │       ATTRIBUTE VALUE         │
59       ├─────────────────────────────┼───────────────────────────────┤
60       │Architecture                 │SPARC & x86, PCI-based systems │
61       ├─────────────────────────────┼───────────────────────────────┤
62       │Availability                 │SUNWusb                        │
63       └─────────────────────────────┴───────────────────────────────┘
64

SEE ALSO

66       cfgadm_usb(1M), libusb(3LIB), attributes(5), usba(7D), usb_ia(7D)
67
68
69       Writing Device Drivers
70
71
72       Universal Serial Bus Specification 2.0—2000
73
74
75       Interface Association Descriptor Engineering Change Notice (ECN)—2003
76
77
78       System Administration Guide: Basic Administration
79
80
81       http://www.sun.com/io
82

DIAGNOSTICS

84       In  addition  to being logged, the following messages may appear on the
85       system console. All messages are formatted in the following manner:
86
87         Warning: <device path> (usb_mid<instance number>): Error Message...
88
89
90
91       Cannot access <device>. Please reconnect.
92
93           This device has been disconnected because a device other  than  the
94           original one has been inserted. The driver informs you of this fact
95           by displaying the name of the original device.
96
97
98       Device not identical to the previous one on this port. Please discon‐
99       nect and reconnect.
100
101           Same condition as described above; however in this case, the driver
102           is unable to identify the original device with a name string.
103
104
105       Please disconnect and reconnect this device.
106
107           A hotplug of the device is needed before it can be restored.
108
109
110
111       The following messages may be logged into the system log. They are for‐
112       matted in the following manner:
113
114         <device path><usb_mid<instance number>): message...
115
116
117
118       No driver found for interface <n> (nodename: <string>) of <device>.
119
120           No driver is available for this interface.
121
122
123       No driver found for device <device>.
124
125           No driver is available for this interface.
126
127
128       Can't support ugen for multiple configuration devices that have
129       attached child interface drivers.
130
131           No ugen interface is available and libusb(3LIB)  cannot  work  with
132           this device.
133
134
135
136
137SunOS 5.11                        22 Dec 2006                      usb_mid(7D)
Impressum