Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) What: /sys/bus/thunderbolt/devices/.../domainX/boot_acl
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) Date:		Jun 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) KernelVersion:	4.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5) Description:	Holds a comma separated list of device unique_ids that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6) 		are allowed to be connected automatically during system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7) 		startup (e.g boot devices). The list always contains
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8) 		maximum supported number of unique_ids where unused
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9) 		entries are empty. This allows the userspace software
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10) 		to determine how many entries the controller supports.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11) 		If there are multiple controllers, each controller has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12) 		its own ACL list and size may be different between the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13) 		controllers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15) 		System BIOS may have an option "Preboot ACL" or similar
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16) 		that needs to be selected before this list is taken into
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17) 		consideration.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19) 		Software always updates a full list in each write.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 		If a device is authorized automatically during boot its
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) 		boot attribute is set to 1.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) What: /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25) Date:		Mar 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) KernelVersion:	4.21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) Description:	This attribute tells whether the system uses IOMMU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) 		for DMA protection. Value of 1 means IOMMU is used 0 means
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 		it is not (DMA protection is solely based on Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) 		security levels).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) What: /sys/bus/thunderbolt/devices/.../domainX/security
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37) Description:	This attribute holds current Thunderbolt security level
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) 		set by the system BIOS. Possible values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) 		=======  ==================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41) 		none     All devices are automatically authorized
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) 		user     Devices are only authorized based on writing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43) 		         appropriate value to the authorized attribute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 		secure   Require devices that support secure connect at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45) 			 minimum. User needs to authorize each device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) 		dponly   Automatically tunnel Display port (and USB). No
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47) 			 PCIe tunnels are created.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) 		usbonly  Automatically tunnel USB controller of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49) 			 connected Thunderbolt dock (and Display Port). All
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) 			 PCIe links downstream of the dock are removed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51) 		=======  ==================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53) What: /sys/bus/thunderbolt/devices/.../authorized
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57) Description:	This attribute is used to authorize Thunderbolt devices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) 		after they have been connected. If the device is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59) 		authorized, no devices such as PCIe and Display port are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) 		available to the system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) 		Contents of this attribute will be 0 when the device is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63) 		yet authorized.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65) 		Possible values are supported:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67) 		==  ===========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) 		1   The device will be authorized and connected
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69) 		==  ===========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71) 		When key attribute contains 32 byte hex string the possible
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) 		values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) 		==  ========================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75) 		1   The 32 byte hex string is added to the device NVM and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) 		    the device is authorized.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77) 		2   Send a challenge based on the 32 byte hex string. If the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) 		    challenge response from device is valid, the device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79) 		    authorized. In case of failure errno will be ENOKEY if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) 		    the device did not contain a key at all, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81) 		    EKEYREJECTED if the challenge response did not match.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) 		==  ========================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) What: /sys/bus/thunderbolt/devices/.../boot
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) Date:		Jun 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) KernelVersion:	4.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) Description:	This attribute contains 1 if Thunderbolt device was already
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 		authorized on boot and 0 otherwise.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) What: /sys/bus/thunderbolt/devices/.../generation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) Date:		Jan 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) KernelVersion:	5.5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) Contact:	Christian Kellner <christian@kellner.me>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) Description:	This attribute contains the generation of the Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) 		controller associated with the device. It will contain 4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) 		for USB4.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) What: /sys/bus/thunderbolt/devices/.../key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) Description:	When a devices supports Thunderbolt secure connect it will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) 		have this attribute. Writing 32 byte hex string changes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) 		authorization to use the secure connection method instead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) 		Writing an empty string clears the key and regular connection
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) 		method can be used again.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) What:		/sys/bus/thunderbolt/devices/.../device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) Description:	This attribute contains id of this device extracted from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) 		the device DROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) What:		/sys/bus/thunderbolt/devices/.../device_name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) Description:	This attribute contains name of this device extracted from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) 		the device DROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) What:		/sys/bus/thunderbolt/devices/.../rx_speed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) Date:		Jan 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) KernelVersion:	5.5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) Description:	This attribute reports the device RX speed per lane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) 		All RX lanes run at the same speed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) What:		/sys/bus/thunderbolt/devices/.../rx_lanes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) Date:		Jan 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) KernelVersion:	5.5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) Description:	This attribute reports number of RX lanes the device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) 		using simultaneusly through its upstream port.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) What:		/sys/bus/thunderbolt/devices/.../tx_speed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) Date:		Jan 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) KernelVersion:	5.5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) Description:	This attribute reports the TX speed per lane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) 		All TX lanes run at the same speed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) What:		/sys/bus/thunderbolt/devices/.../tx_lanes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) Date:		Jan 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) KernelVersion:	5.5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) Description:	This attribute reports number of TX lanes the device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) 		using simultaneusly through its upstream port.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) What:		/sys/bus/thunderbolt/devices/.../vendor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) Description:	This attribute contains vendor id of this device extracted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) 		from the device DROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) What:		/sys/bus/thunderbolt/devices/.../vendor_name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) Description:	This attribute contains vendor name of this device extracted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) 		from the device DROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) What:		/sys/bus/thunderbolt/devices/.../unique_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) Description:	This attribute contains unique_id string of this device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) 		This is either read from hardware registers (UUID on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) 		newer hardware) or based on UID from the device DROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) 		Can be used to uniquely identify particular device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) What:		/sys/bus/thunderbolt/devices/.../nvm_version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) Description:	If the device has upgradeable firmware the version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) 		number is available here. Format: %x.%x, major.minor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) 		If the device is in safe mode reading the file returns
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) 		-ENODATA instead as the NVM version is not available.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) What:		/sys/bus/thunderbolt/devices/.../nvm_authenticate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) Date:		Sep 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) KernelVersion:	4.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) Description:	When new NVM image is written to the non-active NVM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) 		area (through non_activeX NVMem device), the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) 		authentication procedure is started by writing to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) 		this file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) 		If everything goes well, the device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) 		restarted with the new NVM firmware. If the image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) 		verification fails an error code is returned instead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) 		This file will accept writing values "1" or "2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) 		- Writing "1" will flush the image to the storage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) 		  area and authenticate the image in one action.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) 		- Writing "2" will run some basic validation on the image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) 		  and flush it to the storage area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) 		When read holds status of the last authentication
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) 		operation if an error occurred during the process. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) 		is directly the status value from the DMA configuration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) 		based mailbox before the device is power cycled. Writing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) 		0 here clears the status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) Description:	This contains name of the property directory the XDomain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) 		service exposes. This entry describes the protocol in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) 		question. Following directories are already reserved by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) 		the Apple XDomain specification:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) 		========  ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) 		network   IP/ethernet over Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) 		targetdm  Target disk mode protocol over Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) 		extdisp   External display mode protocol over Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) 		========  ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) Description:	Stores the same MODALIAS value emitted by uevent for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) 		the XDomain service. Format: tbtsvc:kSpNvNrN
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) Description:	This contains XDomain protocol identifier the XDomain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) 		service supports.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) Description:	This contains XDomain protocol version the XDomain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) 		service supports.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) Description:	This contains XDomain software version the XDomain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249) 		service supports.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) Date:		Jan 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) KernelVersion:	4.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) Contact:	thunderbolt-software@lists.01.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) Description:	This contains XDomain service specific settings as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) 		bitmask. Format: %x
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) What:		/sys/bus/thunderbolt/devices/<device>:<port>.<index>/device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259) Date:		Oct 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) KernelVersion:	v5.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) Description:	Retimer device identifier read from the hardware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) What:		/sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_authenticate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) Date:		Oct 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) KernelVersion:	v5.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) Description:	When new NVM image is written to the non-active NVM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269) 		area (through non_activeX NVMem device), the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) 		authentication procedure is started by writing 1 to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) 		this file. If everything goes well, the device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) 		restarted with the new NVM firmware. If the image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) 		verification fails an error code is returned instead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) 		When read holds status of the last authentication
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) 		operation if an error occurred during the process.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) 		Format: %x.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) What:		/sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) Date:		Oct 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) KernelVersion:	v5.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) Description:	Holds retimer NVM version number. Format: %x.%x, major.minor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) What:		/sys/bus/thunderbolt/devices/<device>:<port>.<index>/vendor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) Date:		Oct 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) KernelVersion:	v5.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288) Contact:	Mika Westerberg <mika.westerberg@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) Description:	Retimer vendor identifier read from the hardware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) What:		/sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) Date:		Oct 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) KernelVersion:	v5.9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) Contact:	Mario Limonciello <mario.limonciello@dell.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) Description:	For supported devices, automatically authenticate the new Thunderbolt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) 		image when the device is disconnected from the host system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) 		This file will accept writing values "1" or "2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) 		- Writing "1" will flush the image to the storage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) 		  area and prepare the device for authentication on disconnect.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) 		- Writing "2" will run some basic validation on the image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) 		  and flush it to the storage area.