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