1 What: /sys/bus/i3c/devices/i3c-<bus-id>
3 Contact: linux-i3c@vger.kernel.org
5 An I3C bus. This directory will contain one sub-directory per
6 I3C device present on the bus.
8 What: /sys/bus/i3c/devices/i3c-<bus-id>/current_master
10 Contact: linux-i3c@vger.kernel.org
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.
17 What: /sys/bus/i3c/devices/i3c-<bus-id>/mode
19 Contact: linux-i3c@vger.kernel.org
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.
25 What: /sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency
27 Contact: linux-i3c@vger.kernel.org
29 The frequency (expressed in Hz) of the SCL signal when
30 operating in I3C SDR mode.
32 What: /sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency
34 Contact: linux-i3c@vger.kernel.org
36 The frequency (expressed in Hz) of the SCL signal when
37 operating in I2C mode.
39 What: /sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address
41 Contact: linux-i3c@vger.kernel.org
43 Dynamic address assigned to the master controller. This
44 address may change if the bus is re-initialized.
46 What: /sys/bus/i3c/devices/i3c-<bus-id>/bcr
48 Contact: linux-i3c@vger.kernel.org
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
56 What: /sys/bus/i3c/devices/i3c-<bus-id>/dcr
58 Contact: linux-i3c@vger.kernel.org
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
66 What: /sys/bus/i3c/devices/i3c-<bus-id>/pid
68 Contact: linux-i3c@vger.kernel.org
70 PID stands for Provisioned 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
78 What: /sys/bus/i3c/devices/i3c-<bus-id>/hdrcap
80 Contact: linux-i3c@vger.kernel.org
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
88 This entry describes the HDRCAP of the master controller
91 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>
93 Contact: linux-i3c@vger.kernel.org
95 An I3C device present on I3C bus identified by <bus-id>. Note
96 that all devices are represented including the master driving
99 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address
101 Contact: linux-i3c@vger.kernel.org
103 Dynamic address assigned to device <bus-id>-<device-pid>. This
104 address may change if the bus is re-initialized.
106 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr
108 Contact: linux-i3c@vger.kernel.org
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.
114 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr
116 Contact: linux-i3c@vger.kernel.org
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.
122 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid
124 Contact: linux-i3c@vger.kernel.org
126 PID stands for Provisioned 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.
132 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap
134 Contact: linux-i3c@vger.kernel.org
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".
140 See the I3C specification for more details about these HDR
143 What: /sys/bus/i3c/devices/<bus-id>-<device-pid>
145 Contact: linux-i3c@vger.kernel.org
147 These directories are just symbolic links to
148 /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>.