Documentation/admin-guide/thunderbolt.rst

13 software connection manager and the later USB4 compliant devices follow
28 a database of the authorized devices and prompts users for new connections.
30 More details about the sysfs interface for Thunderbolt devices can be
39 This will authorize all devices automatically when they appear. However,
45 (usbonly). The reason for these is the fact that the connected devices can
56     All devices are automatically connected by the firmware. No user
63     ``/sys/bus/thunderbolt/devices``, the user then can make the decision.
88 ``/sys/bus/thunderbolt/devices/domainX/security`` where ``domainX`` is
97 ``/sys/bus/thunderbolt/devices``. The device directory carries
101 Authorizing devices when security level is ``user`` or ``secure``
105   /sys/bus/thunderbolt/devices/0-1/authorized	- 0
106   /sys/bus/thunderbolt/devices/0-1/device	- 0x8004
107   /sys/bus/thunderbolt/devices/0-1/device_name	- Thunderbolt to FireWire Adapter
108   /sys/bus/thunderbolt/devices/0-1/vendor	- 0x1
109   /sys/bus/thunderbolt/devices/0-1/vendor_name	- Apple, Inc.
110   /sys/bus/thunderbolt/devices/0-1/unique_id	- e0376f00-0300-0100-ffff-ffffffffffff
115   # echo 1 > /sys/bus/thunderbolt/devices/0-1/authorized
124   /sys/bus/thunderbolt/devices/0-3/authorized	- 0
125   /sys/bus/thunderbolt/devices/0-3/device	- 0x305
126   /sys/bus/thunderbolt/devices/0-3/device_name	- AKiTiO Thunder3 PCIe Box
127   /sys/bus/thunderbolt/devices/0-3/key		-
128   /sys/bus/thunderbolt/devices/0-3/vendor	- 0x41
129   /sys/bus/thunderbolt/devices/0-3/vendor_name	- inXtron
130   /sys/bus/thunderbolt/devices/0-3/unique_id	- dc010000-0000-8508-a22d-32ca6421cb16
142   # echo $key > /sys/bus/thunderbolt/devices/0-3/key
143   # echo 1 > /sys/bus/thunderbolt/devices/0-3/authorized
151   # echo $key > /sys/bus/thunderbolt/devices/0-3/key
152   # echo 2 > /sys/bus/thunderbolt/devices/0-3/authorized
163 De-authorizing devices
165 It is possible to de-authorize devices by writing ``0`` to their
183 so connected devices cannot access memory regions outside of what is
187 ``/sys/bus/thunderbolt/devices/domainX/iommu_dma_protection`` attribute.
194 authorize devices when IOMMU DMA protection is enabled can use the
231   # dd if=KYK_TBT_FW_0018.bin of=/sys/bus/thunderbolt/devices/0-0/nvm_non_active0/nvmem
236   # echo 1 > /sys/bus/thunderbolt/devices/0-0/nvm_authenticate
246   # cat /sys/bus/thunderbolt/devices/0-0/nvm_authenticate
248   # cat /sys/bus/thunderbolt/devices/0-0/nvm_version
255 Note names of the NVMem devices ``nvm_activeN`` and ``nvm_non_activeN``
263 ports. When this is the case the ``usb4_portX`` devices have two special
267   # echo 1 > /sys/bus/thunderbolt/devices/0-0/usb4_port1/offline
273   # echo 1 > /sys/bus/thunderbolt/devices/0-0/usb4_port1/rescan
281   # echo 1 > /sys/bus/thunderbolt/devices/0-0/usb4_port1/rescan
286   # echo 0 > /sys/bus/thunderbolt/devices/0-0/usb4_port1/offline
331   /sys/bus/wmi/devices/86CCFD48-205E-4A77-9C48-2021CBEDE341/force_power