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 87
88 This entry describes the HDRCA 88 This entry describes the HDRCAP of the master controller
89 driving the bus. 89 driving the bus.
90 90
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- 91 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>
107 KernelVersion: 5.0 92 KernelVersion: 5.0
108 Contact: linux-i3c@vger.kernel.org 93 Contact: linux-i3c@vger.kernel.org
109 Description: 94 Description:
110 An I3C device present on I3C b 95 An I3C device present on I3C bus identified by <bus-id>. Note
111 that all devices are represent 96 that all devices are represented including the master driving
112 the bus. 97 the bus.
113 98
114 What: /sys/bus/i3c/devices/i3c-<bus- 99 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address
115 KernelVersion: 5.0 100 KernelVersion: 5.0
116 Contact: linux-i3c@vger.kernel.org 101 Contact: linux-i3c@vger.kernel.org
117 Description: 102 Description:
118 Dynamic address assigned to de 103 Dynamic address assigned to device <bus-id>-<device-pid>. This
119 address may change if the bus 104 address may change if the bus is re-initialized.
120 105
121 What: /sys/bus/i3c/devices/i3c-<bus- 106 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr
122 KernelVersion: 5.0 107 KernelVersion: 5.0
123 Contact: linux-i3c@vger.kernel.org 108 Contact: linux-i3c@vger.kernel.org
124 Description: 109 Description:
125 BCR stands for Bus Characteris 110 BCR stands for Bus Characteristics Register and express the
126 device capabilities in term of 111 device capabilities in term of speed, maximum read/write
127 length, etc. See the I3C speci 112 length, etc. See the I3C specification for more details.
128 113
129 What: /sys/bus/i3c/devices/i3c-<bus- 114 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr
130 KernelVersion: 5.0 115 KernelVersion: 5.0
131 Contact: linux-i3c@vger.kernel.org 116 Contact: linux-i3c@vger.kernel.org
132 Description: 117 Description:
133 DCR stands for Device Characte 118 DCR stands for Device Characteristics Register and express the
134 device capabilities in term of 119 device capabilities in term of exposed features. See the I3C
135 specification for more details 120 specification for more details.
136 121
137 What: /sys/bus/i3c/devices/i3c-<bus- 122 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid
138 KernelVersion: 5.0 123 KernelVersion: 5.0
139 Contact: linux-i3c@vger.kernel.org 124 Contact: linux-i3c@vger.kernel.org
140 Description: 125 Description:
141 PID stands for Provisioned ID !! 126 PID stands for Provisional ID and is used to uniquely identify
142 a device on a bus. This PID co 127 a device on a bus. This PID contains information about the
143 vendor, the part and an instan 128 vendor, the part and an instance ID so that several devices of
144 the same type can be connected 129 the same type can be connected on the same bus.
145 See the I3C specification for 130 See the I3C specification for more details.
146 131
147 What: /sys/bus/i3c/devices/i3c-<bus- 132 What: /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap
148 KernelVersion: 5.0 133 KernelVersion: 5.0
149 Contact: linux-i3c@vger.kernel.org 134 Contact: linux-i3c@vger.kernel.org
150 Description: 135 Description:
151 Expose the HDR (High Data Rate 136 Expose the HDR (High Data Rate) capabilities of a device.
152 Returns a list of supported HD 137 Returns a list of supported HDR mode, each element is separated
153 by space. Modes can be "hdr-dd 138 by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
154 139
155 See the I3C specification for 140 See the I3C specification for more details about these HDR
156 modes. 141 modes.
157 142
158 What: /sys/bus/i3c/devices/<bus-id>- 143 What: /sys/bus/i3c/devices/<bus-id>-<device-pid>
159 KernelVersion: 5.0 144 KernelVersion: 5.0
160 Contact: linux-i3c@vger.kernel.org 145 Contact: linux-i3c@vger.kernel.org
161 Description: 146 Description:
162 These directories are just sym 147 These directories are just symbolic links to
163 /sys/bus/i3c/devices/i3c-<bus- 148 /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.