usba(7D)

NAME | DESCRIPTION | FILES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS

NAME

usba– Solaris USB Architecture (USBA)

DESCRIPTION

USB provides a low-cost means for attaching peripheral devices, 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 framework 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.

In this release, the original USBA framework operates all USB 1.0 and USB 1.1 ports (including on-board ports), and the USB 1.0 framework operates all USB 2.0 ports (such as PCI USB 2.0, or USB 2.0/1394 combo cards). 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.

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.

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 USB 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

ATTRIBUTES

See attributes(5) for a description of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	Original USBA drivers and files: PCI-based systems
	USBA 1.0 drivers and files: PCI-based SPARC systems
Availability	SUNWusb, SUNWusbx

SEE ALSO

cfgadm_usb(1M), attributes(5), ehci(7D), hid(7D), hubd(7D), ohci(7D), scsa2usb(7D), uhci(7D), usb_ac(7D), usb_ah(7D), usb_as(7D), usbkbm(7D), usb_mid(7D), usbms(7D), usbprn(7D)

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 console 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 <device_name> (interface <number> node name=<node_name>)

The installed Solaris software does not contain a supported driver for this hardware. <number> is the interface number.

No driver found for device <name>.

The installed Solaris software does not contain a supported 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 USBA1.0.

A device plugged into a port managed by the USBA1.0 framework has only an original-USBA-framework compatible driver installed. Please plug into a port managed by the original USBA framework. (Please see the DESCRIPTION section above regarding the dual framework.)

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.

NAME | DESCRIPTION | FILES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS