usba(7D)
NAME
usba - Solaris USB Architecture (USBA)
DESCRIPTION
USB provides a low-cost means for attaching peripheral dev-
ices, including mass-storage devices, keyboards, mice, and
printers, to a system. USB supports 126 hot-pluggable USB
devices per USB bus. For complete information on USB, go to
the USB website at http://www.usb.org.
The USBA consists of the original USBA framework and a more
evolved framework called USBA 1.0. The original USBA frame-
work provides compatibility with all drivers which worked
before the current release. The USBA 1.0 framework supports
more devices (including USB 2.0 devices), and offers better
performance than the original USBA framework.
The USBA 1.0 framework adheres to the Universal Serial Bus
2.0 specification, and supports a maximum data transfer rate
of 480 Mbits per second (Mbps). The original USBA framework
adheres to the USB 1.1 specification and supports a maximum
data transfer rate of 12 Mbps. Both provide a transport
layer abstraction to USB client drivers.
FRAMEWORK/PORT BINDINGS
In this release for SPARC, the original USBA framework
operates all USB 1.0 and USB 1.1 ports (including on-board
ports), and the USBA 1.0 framework operates all USB 2.0
ports (such as PCI USB 2.0, or USB 2.0/1394 combo cards).
In this release for x86, the USBA 1.0 framework operates all
ports. However, the original framework is still included.
For all architectures, output of prtconf(1M) with the -D
option associates devices with drivers whose names begin
with "usba10" when the USBA 1.0 framework services those
devices.
Please see www.sun.com/desktop/whitepapers.html for more
information regarding the USB dual framework, including the
usbconfig script for changing which framework operates which
ports. Use of the USBA 1.0 framework for all ports is recom-
mended.
FILES
Drivers and modules of the original USB framework are:
_________________________________________________________
| FRAMEWORK MODULE |
|________________________________________________________|
| /kernel/misc/[sparcv9]/usba |
|________________________________________________________|
_______________________________________________________________
| CLIENT DRIVER | FUNCTION/DEVICE |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/hid | HID class |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/hubd | hub class |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/scsa2usb | mass storage class |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usbprn | printer class |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usb_as | audio streaming |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usb_ac | audio control |
|________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usb_mid | multi-interface device |
|________________________________|_____________________________|
| /kernel/drv/sparcv9/usbser_edge| Edgeport USB to serial port|
|________________________________|_____________________________|
_______________________________________________________________
| CLIENT STREAMS MODULES | FUNCTION/DEVICE |
|________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usbkbm| Keyboard |
|________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usbms | Mouse |
|________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usb_ah| audio HID |
|________________________________|_____________________________|
____________________________________________________________
| HOST CONTROLLER INTERFACE DRIVERS | DEVICE |
|__________________________________________|________________|
| /kernel/drv/[sparcv9]/ohci | Open HCI |
|__________________________________________|________________|
| /kernel/drv/[sparcv9]/uhci | Universal HCI |
|__________________________________________|________________|
Drivers and modules of the USBA 1.0 framework are:
_________________________________________________________
| FRAMEWORK MODULE |
|________________________________________________________|
| /kernel/misc/[sparcv9]/usba10 |
|________________________________________________________|
______________________________________________________________________
| CLIENT DRIVER | FUNCTION/DEVICE |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_hid | HID class |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_hubd | hub class |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_scsa2usb | mass storage class |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_usbprn | printer class |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_usb_as | audio streaming |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_usb_ac | audio control |
|_______________________________________|_____________________________|
| /kernel/drv/[sparcv9]/usba10_usb_mid | multi-interface device |
|_______________________________________|_____________________________|
| /kernel/drv/sparcv9/usba10_usbser_edge| Edgeport USB to serial port|
|_______________________________________|_____________________________|
__________________________________________________________________
| CLIENT STREAMS MODULES | FUNCTION/DEVICE |
|___________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usbkb1 | Keyboard |
|___________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usbms1 | Mouse |
|___________________________________|_____________________________|
| /kernel/strmod/[sparcv9]/usb_ah1 | audio HID |
|___________________________________|_____________________________|
____________________________________________________________
| HOST CONTROLLER INTERFACE DRIVERS | DEVICE |
|__________________________________________|________________|
| /kernel/drv/[sparcv9]/usba10_ehci | Enhanced HCI |
|__________________________________________|________________|
| /kernel/drv/[sparcv9]/usba10_ohci | Open HCI |
|__________________________________________|________________|
| /kernel/drv/[sparcv9]/usba10_uhci | Universal HCI |
|__________________________________________|________________|
ATTRIBUTES
See attributes(5) for a description of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|____________________________|______________________________|
| Architecture | PCI-based systems |
|____________________________|______________________________|
| Availability | SUNWusb (All architectures)|
| | SUNWusbx (SPARC only) |
|____________________________|______________________________|
SEE ALSO
cfgadm_usb(1M), prtconf(1M), attributes(5), ehci(7D),
hid(7D), hubd(7D), ohci(7D), scsa2usb(7D), uhci(7D),
usb_ac(7D), usb_as(7D), usb_mid(7D), usbprn(7D),
usbser_edge(7D), usb_ah(7M), usbkbm(7M), usbms(7M)
Universal Serial Bus Specification 1.0 and 2.0.
System Administration Guide: Basic Administration
http://www.sun.com/desktop/whitepapers.html
http://www.sun.com/io
DIAGNOSTICS
The messages described below may appear on the system con-
sole as well as being logged. All messages are formatted in
the following manner:
WARNING: Error message...
<name><number>: obsolete driver: usb_pipe_policy is
<actual_version>, expecting <version>
The driver is using an older revision of USBA. The
pipe policy revision used is older and this driver is
not supported on the current platform. <name><number>
refer to the driver name and its instance number,
respectively.
No driver found for device <name>.
The installed Solaris software does not contain a sup-
ported driver for this hardware. <name> could be the
device path name or the device name.
Onlining <path name> failed (<number>).
The USB device driver could not be brought online due
to internal kernel errors. <number> is the value
returned due to the failure.
The driver for <name> is not for USBA 1.0.
A device plugged into a port managed by the USBA 1.0
framework has only an original-USBA-framework compati-
ble driver installed. Please plug into a port managed
by the original USBA framework. (Please see the
DESCRIPTION section above regarding the dual frame-
work.)
The driver for <driver> is not for USBA 0.0.
A device with only a USBA 1.0 framework compatible
driver installed was plugged into a port managed by
the original USBA framework. The framework tried to
load an incompatible driver. Please plug into a port
managed by the USBA 1.0 framework (Please see the
DESCRIPTION section above regarding the dual frame-
work).
Attempt to corrupt USB list at <address>.
An internal USB data structure is inconsistent. Please
reboot the system.
Draining callbacks timed out.
A USB device or its driver is malfunctioning. Please
hot-remove and reconnect the device, or reboot.
Man(1) output converted with
man2html