XHCI(4D) Devices XHCI(4D)
NAME
xhci - Extensible Host Controller Interface Driver
SYNOPSIS
usb@unit-addressDESCRIPTION
The
xhci driver supports PCI devices that implement versions 1.0 and
1.1 of the Extensible Host Controller Interface Specification. These
devices provide support for USB 3.0, USB 2.x, and USB 1.x devices and
is integrated into the broader illumos USB Architecture (USBA).
The
xhci driver supports all four USB transfer types:
bulk transfers,
control transfers,
interrupt transfers, and
isochronous transfers.
Administrators do not interact with the
xhci driver directly. USB
devices are managed with
cfgadm(8). See
cfgadm_usb(8) for more
information on how to specifically manage USB devices and how they are
laid out in the system.
cfgadm(8) is only used to manage devices at a
USB level. For example, a USB NIC would still be managed with
dladm(8) at a networking level.
On some x86 systems USB ports may be routed to either an instance of
the
xhci driver or an instance of the
ehci(4D) driver. By default, all
such ports are routed to the
xhci driver, allowing those devices to
operate at USB 3.x speed by default. This is most common on Intel
platforms and chipsets. While this is controlled with the
xhci-reroute property discussed below, changing it may not be sufficient to change
the behavior. The BIOS or ACPI data for many x86 systems may toggle
this automatically.
PROPERTIES
The
xhci driver supports the following properties which may be tuned in
the
xhci driver's
driver.conf(5) file.
xhci-reroute The
xhci-reroute property determines whether or not USB ports
are re-routed to the
xhci driver. The default behavior is to
route such ports. To disable this, the property should be set
to
0. Any other value, or the lack of the property, cause the
default behavior to take place.
ARCHITECTURE
The
xhci driver is only supported on
x86 systems at this time.
FILES
/kernel/drv/amd64/xhci Device driver (x86)
/kernel/drv/xhci.conf Driver configuration file
SEE ALSO
ehci(4D),
usba(4D),
driver.conf(5),
cfgadm(8),
cfgadm_usb(8),
dladm(8)illumos January 10, 2020 illumos