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

NAME

6       usba, usb - Solaris USB Architecture (USBA)
7

DESCRIPTION

9       USB provides a low-cost means for attaching peripheral devices, includ‐
10       ing mass-storage devices, keyboards, mice, and printers, to  a  system.
11       For complete information on the USB architecture, visit the USB website
12       at http://www.usb.org.
13
14
15       USBA supports 126 hot-pluggable USB devices per USB  bus.  The  maximum
16       data  transfer  rate is 1.5 Mbits (low speed USB 1.x) or 12 Mbits (full
17       speed USB 1.x) or 480 MBits (high  speed  USB  2.0)  Mbits  per  second
18       (Mbps).
19
20
21       USBA adheres to the Universal Serial Bus 2.0 specification and provides
22       a transport layer abstraction to USB client drivers.
23
24
25       For information on how to write USB client drivers, see Writing  Device
26       Drivers.  For  the  latest  information  on  writing USB drivers, visit
27       http://developers.sun.com/solaris/developer/support/driver/usb.html.
28       For a complete list of USBA interfaces, see Intro(9F) and Intro(9S).
29
30
31       Devices without a driver may have a  libusb(3LIB) application. For more
32       information, see /usr/sfw/share/doc/libusb/libusb.txt.
33

FILES

35       Listed below are drivers and modules which either utilize or  are  uti‐
36       lized  by  USBA.  Drivers in /kernel/drv are 32 bit drivers (x86 only).
37       Drivers in /kernel/drv/sparcv9 or /kernel/drv/amd64 are 64 bit drivers.
38
39         Client Driver                           Function/Device
40
41         kernel/drv/[sparcv9|amd64/]hid          HID class
42         kernel/drv/[sparcv9|amd64/]hubd         hub class
43         kernel/drv/[sparcv9|amd64/]hwahc        HWA Host Controller class
44         kernel/drv/[sparcv9|amd64/]hwarc        HWA Radio Controller class
45         kernel/drv/[sparcv9|amd64/]scsa2usb     mass storage class
46         kernel/drv/[sparcv9|amd64/]usbprn       printer class
47         kernel/drv/[sparcv9|amd64/]usb_as       audio streaming class
48         kernel/drv/[sparcv9|amd64/]usb_ac       audio control class
49         kernel/drv/[sparcv9|amd64/]usbvc        video class
50         kernel/drv/[sparcv9|amd64/]usb_mid      multi-interface device
51         kernel/drv/[sparcv9|amd64/]usb_ia       interface-association driver
52         kernel/drv/[sparcv9|amd64/]usbser_edge  Edgeport USB to serial port
53         kernel/drv/[sparcv9|amd64/]usbsksp      Keyspan USB to serial port
54         kernel/drv/[sparcv9|amd64/]usbsprl      pl2303 USB to serial port
55         kernel/drv/[sparcv9|amd64/]usbsacm      CDC ACM class to serial port
56         kernel/drv/[sparcv9|amd64/]ugen         generic USB driver
57         kernel/drv/[sparcv9|amd64/]wusb_ca      WUSB Cable Association class
58         kernel/drv/[sparcv9|amd64/]ohci         open host controller driver
59         kernel/drv/[sparcv9|amd64/]uhci         universal host controller driver
60         kernel/drv/[sparcv9|amd64/]ehci         enhanced host controller driver
61
62
63
64         Client Streams Modules                   Function/Device
65         /kernel/strmod/[sparcv9|amd64]usbkbm     Keyboad
66         /kernel/strmod/[sparcv9|amd64]usbms      Mouse
67         /kernel/strmod/[sparcv9|amd64]usb_ah     Audio HID
68
69
70
71         Host Controller Interface Drivers   Device
72
73         /kernel/drv/[sparcv9|amd64]ehci     Enhanced HCI
74         /kernel/drv/[sparcv9|amd64]ohci     Open HCI
75         /kernel/drv/[sparcv|amd64/]uhci     Univeral HCI
76
77
78

ATTRIBUTES

80       See attributes(5) for a description of the following attributes:
81
82
83
84
85       ┌─────────────────────────────┬─────────────────────────────┐
86       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
87       ├─────────────────────────────┼─────────────────────────────┤
88       │Architecture                 │PCI-based  systems           │
89       ├─────────────────────────────┼─────────────────────────────┤
90       │Availability                 │SUNWusb, SUNWusbu            │
91       └─────────────────────────────┴─────────────────────────────┘
92

SEE ALSO

94       cfgadm_usb(1M),   libusb(3LIB),   attributes(5),   ehci(7D),   hid(7D),
95       hubd(7D),  ohci(7D),  scsa2usb(7D),  uhci(7D),  usb_ac(7D), usb_as(7D),
96       usb_ia(7D), usb_mid(7D), usbprn(7D), usbsacm(7D), usbser_edge(7D), usb‐
97       sksp(7D),  usbsprl(7D),  usbvc(7D), ugen(7D), virtualkm(7D). Intro(9F),
98       Intro(9S)
99
100
101       Writing Device Drivers
102
103
104       Universal Serial Bus Specification 2.0.
105
106
107       Interface Association Descriptor Engineering Change Notice (ECN)
108
109
110       System Administration Guide: Basic Administration
111
112
113       http://www.sun.com
114

NOTES

116       Booting from USB mass-storage devices is not supported on SPARC, but is
117       supported on X86.
118

DIAGNOSTICS

120       The  messages  described below may appear on the system console as well
121       as being logged. All  messages are formatted in the following manner:
122
123         WARNING: Error message...
124
125
126
127       No driver found for device <device_name> (interface <number> node
128       name=<node_name>)
129
130           The  installed Solaris software does not contain a supported driver
131           for this hardware. <number> is the  interface  number.   <name>  is
132           either the device path name or the device name.
133
134
135       Draining callbacks timed out!
136
137           An  internal  error  occured.   Please reboot your system.  If this
138           problem persists, contact your system vendor.
139
140
141
142       The following messages may be logged into the system log. They are for‐
143       matted in the following manner:
144
145         <device path><usba<instance number>): message...
146
147
148
149       Incorrect USB driver version for <n.m>.
150
151           Driver is incompatible with USBA framework.
152
153
154
155
156SunOS 5.11                        22 Apr 2009                         usba(7D)
Impressum