^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/bus/pci/drivers/xhci_hcd/.../dbc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: June 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Lu Baolu <baolu.lu@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) xHCI compatible USB host controllers (i.e. super-speed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) USB3 controllers) are often implemented with the Debug
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Capability (DbC). It can present a debug device which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) is fully compliant with the USB framework and provides
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) the equivalent of a very high performance full-duplex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) serial link for debug purpose.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) The DbC debug device shares a root port with xHCI host.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) When the DbC is enabled, the root port will be assigned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) to the Debug Capability. Otherwise, it will be assigned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) to xHCI.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Writing "enable" to this attribute will enable the DbC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) functionality and the shared root port will be assigned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) to the DbC device. Writing "disable" to this attribute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) will disable the DbC functionality and the shared root
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) port will roll back to the xHCI.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Reading this attribute gives the state of the DbC. It
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) can be one of the following states: disabled, enabled,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) initialized, connected, configured and stalled.