1 XHCI(7D)                            Devices                           XHCI(7D)
   2 
   3 NAME
   4      xhci - Extensible Host Controller Interface Driver
   5 
   6 SYNOPSIS
   7      usb@unit-address
   8 
   9 DESCRIPTION
  10      The xhci driver supports PCI devices that implement versions 1.0 and 1.1
  11      of the Extensible Host Controller Inteface Specification.  These devices
  12      provide support for USB 3.0, USB 2.x, and USB 1.x devices and is
  13      integrated into the broader illumos USB Architecture (USBA).
  14 
  15      The xhci driver supports all four USB transfer types: bulk transfers,
  16      control transfers, interrupt transfers, and isochronous transfers.
  17 
  18      Administrators do not interact with the xhci driver directly.  USB
  19      devices are managed with cfgadm(1M).  See cfgadm_usb(1M) for more
  20      information on how to specifically manage USB devices and how they are
  21      laid out in the system.  cfgadm(1M) is only used to manage devices at a
  22      USB level.  For example, a USB NIC would still be managed with dladm(1M)
  23      at a networking level.
  24 
  25      On some x86 systems USB ports may be routed to either an instance of the
  26      xhci driver or an instance of the ehci(7D) driver.  By default, all such
  27      ports are routed to the xhci driver, allowing those devices to operate at
  28      USB 3.x speed by default.  This is most common on Intel platforms and
  29      chipsets.  While this is controlled with the xhci-reroute property
  30      discussed below, changing it may not be sufficient to change the
  31      behavior.  The BIOS or ACPI data for many x86 systems may toggle this
  32      automatically.
  33 
  34 PROPERTIES
  35      The xhci driver supports the following properties which may be tuned in
  36      the xhci driver's driver.conf(4) file.
  37 
  38      xhci-reroute
  39              The xhci-reroute property determines whether or not USB ports are
  40              re-routed to the xhci driver.  The default behavior is to route
  41              such ports.  To disable this, the property should be set to 0.
  42              Any other value, or the lack of the property, cause the default
  43              behavior to take place.
  44 
  45 ARCHITECTURE
  46      The xhci driver is only supported on x86 systems at this time.
  47 
  48 FILES
  49      /kernel/drv/xhci                  32-bit device driver (x86).
  50 
  51      /kernel/drv/amd64/xhci            64-bit device driver (x86).
  52 
  53      /kernel/drv/xhci.conf             Driver configuration file.
  54 
  55 SEE ALSO
  56      cfgadm(1M), cfgadm_usb(1M), dladm(1M), driver.conf(4), ehci(7D), usba(7D)
  57 
  58 illumos                        October 17, 2016                        illumos

   1 XHCI(7D)                            Devices                           XHCI(7D)
   2 
   3 NAME
   4      xhci - Extensible Host Controller Interface Driver
   5 
   6 SYNOPSIS
   7      usb@unit-address
   8 
   9 DESCRIPTION
  10      The xhci driver supports PCI devices that implement versions 1.0 and 1.1
  11      of the Extensible Host Controller Interface Specification.  These devices
  12      provide support for USB 3.0, USB 2.x, and USB 1.x devices and is
  13      integrated into the broader illumos USB Architecture (USBA).
  14 
  15      The xhci driver supports all four USB transfer types: bulk transfers,
  16      control transfers, interrupt transfers, and isochronous transfers.
  17 
  18      Administrators do not interact with the xhci driver directly.  USB
  19      devices are managed with cfgadm(1M).  See cfgadm_usb(1M) for more
  20      information on how to specifically manage USB devices and how they are
  21      laid out in the system.  cfgadm(1M) is only used to manage devices at a
  22      USB level.  For example, a USB NIC would still be managed with dladm(1M)
  23      at a networking level.
  24 
  25      On some x86 systems USB ports may be routed to either an instance of the
  26      xhci driver or an instance of the ehci(7D) driver.  By default, all such
  27      ports are routed to the xhci driver, allowing those devices to operate at
  28      USB 3.x speed by default.  This is most common on Intel platforms and
  29      chipsets.  While this is controlled with the xhci-reroute property
  30      discussed below, changing it may not be sufficient to change the
  31      behavior.  The BIOS or ACPI data for many x86 systems may toggle this
  32      automatically.
  33 
  34 PROPERTIES
  35      The xhci driver supports the following properties which may be tuned in
  36      the xhci driver's driver.conf(4) file.
  37 
  38      xhci-reroute
  39              The xhci-reroute property determines whether or not USB ports are
  40              re-routed to the xhci driver.  The default behavior is to route
  41              such ports.  To disable this, the property should be set to 0.
  42              Any other value, or the lack of the property, cause the default
  43              behavior to take place.
  44 
  45 ARCHITECTURE
  46      The xhci driver is only supported on x86 systems at this time.
  47 
  48 FILES
  49      /kernel/drv/amd64/xhci            Device driver (x86)
  50 
  51      /kernel/drv/xhci.conf             Driver configuration file
  52 


  53 SEE ALSO
  54      cfgadm(1M), cfgadm_usb(1M), dladm(1M), driver.conf(4), ehci(7D), usba(7D)
  55 
  56 illumos                        January 10, 2020                        illumos