1What: /sys/bus/i3c/devices/i3c-<bus-id> 2KernelVersion: 5.0 3Contact: linux-i3c@vger.kernel.org 4Description: 5 An I3C bus. This directory will contain one sub-directory per 6 I3C device present on the bus. 7 8What: /sys/bus/i3c/devices/i3c-<bus-id>/current_master 9KernelVersion: 5.0 10Contact: linux-i3c@vger.kernel.org 11Description: 12 Expose the master that owns the bus (<bus-id>-<master-pid>) at 13 the time this file is read. Note that bus ownership can change 14 overtime, so there's no guarantee that when the read() call 15 returns, the value returned is still valid. 16 17What: /sys/bus/i3c/devices/i3c-<bus-id>/mode 18KernelVersion: 5.0 19Contact: linux-i3c@vger.kernel.org 20Description: 21 I3C bus mode. Can be "pure", "mixed-fast" or "mixed-slow". See 22 the I3C specification for a detailed description of what each 23 of these modes implies. 24 25What: /sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency 26KernelVersion: 5.0 27Contact: linux-i3c@vger.kernel.org 28Description: 29 The frequency (expressed in Hz) of the SCL signal when 30 operating in I3C SDR mode. 31 32What: /sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency 33KernelVersion: 5.0 34Contact: linux-i3c@vger.kernel.org 35Description: 36 The frequency (expressed in Hz) of the SCL signal when 37 operating in I2C mode. 38 39What: /sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address 40KernelVersion: 5.0 41Contact: linux-i3c@vger.kernel.org 42Description: 43 Dynamic address assigned to the master controller. This 44 address may change if the bus is re-initialized. 45 46What: /sys/bus/i3c/devices/i3c-<bus-id>/bcr 47KernelVersion: 5.0 48Contact: linux-i3c@vger.kernel.org 49Description: 50 BCR stands for Bus Characteristics Register and express the 51 device capabilities in term of speed, maximum read/write 52 length, etc. See the I3C specification for more details. 53 This entry describes the BCR of the master controller driving 54 the bus. 55 56What: /sys/bus/i3c/devices/i3c-<bus-id>/dcr 57KernelVersion: 5.0 58Contact: linux-i3c@vger.kernel.org 59Description: 60 DCR stands for Device Characteristics Register and express the 61 device capabilities in term of exposed features. See the I3C 62 specification for more details. 63 This entry describes the DCR of the master controller driving 64 the bus. 65 66What: /sys/bus/i3c/devices/i3c-<bus-id>/pid 67KernelVersion: 5.0 68Contact: linux-i3c@vger.kernel.org 69Description: 70 PID stands for Provisional ID and is used to uniquely identify 71 a device on a bus. This PID contains information about the 72 vendor, the part and an instance ID so that several devices of 73 the same type can be connected on the same bus. 74 See the I3C specification for more details. 75 This entry describes the PID of the master controller driving 76 the bus. 77 78What: /sys/bus/i3c/devices/i3c-<bus-id>/hdrcap 79KernelVersion: 5.0 80Contact: linux-i3c@vger.kernel.org 81Description: 82 Expose the HDR (High Data Rate) capabilities of a device. 83 Returns a list of supported HDR mode, each element is separated 84 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl". 85 See the I3C specification for more details about these HDR 86 modes. 87 88 This entry describes the HDRCAP of the master controller 89 driving the bus. 90 91What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid> 92KernelVersion: 5.0 93Contact: linux-i3c@vger.kernel.org 94Description: 95 An I3C device present on I3C bus identified by <bus-id>. Note 96 that all devices are represented including the master driving 97 the bus. 98 99What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address 100KernelVersion: 5.0 101Contact: linux-i3c@vger.kernel.org 102Description: 103 Dynamic address assigned to device <bus-id>-<device-pid>. This 104 address may change if the bus is re-initialized. 105 106What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr 107KernelVersion: 5.0 108Contact: linux-i3c@vger.kernel.org 109Description: 110 BCR stands for Bus Characteristics Register and express the 111 device capabilities in term of speed, maximum read/write 112 length, etc. See the I3C specification for more details. 113 114What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr 115KernelVersion: 5.0 116Contact: linux-i3c@vger.kernel.org 117Description: 118 DCR stands for Device Characteristics Register and express the 119 device capabilities in term of exposed features. See the I3C 120 specification for more details. 121 122What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid 123KernelVersion: 5.0 124Contact: linux-i3c@vger.kernel.org 125Description: 126 PID stands for Provisional ID and is used to uniquely identify 127 a device on a bus. This PID contains information about the 128 vendor, the part and an instance ID so that several devices of 129 the same type can be connected on the same bus. 130 See the I3C specification for more details. 131 132What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap 133KernelVersion: 5.0 134Contact: linux-i3c@vger.kernel.org 135Description: 136 Expose the HDR (High Data Rate) capabilities of a device. 137 Returns a list of supported HDR mode, each element is separated 138 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl". 139 140 See the I3C specification for more details about these HDR 141 modes. 142 143What: /sys/bus/i3c/devices/<bus-id>-<device-pid> 144KernelVersion: 5.0 145Contact: linux-i3c@vger.kernel.org 146Description: 147 These directories are just symbolic links to 148 /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>. 149
