1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 $id: http://devicetree.org/schemas/i3c/i3c.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10 - Alexandre Belloni <alexandre.belloni@bootlin.com>
11 - Miquel Raynal <miquel.raynal@bootlin.com>
14 I3C busses can be described with a node for the primary I3C controller device
15 and a set of child nodes for each I2C or I3C slave on the bus. Each of them
16 may, during the life of the bus, request mastership.
20 pattern: "^i3c-master@[0-9a-f]+$"
25 Each I2C device connected to the bus should be described in a subnode.
27 All I3C devices are supposed to support DAA (Dynamic Address Assignment),
28 and are thus discoverable. So, by default, I3C devices do not have to be
29 described in the device tree. This being said, one might want to attach
30 extra resources to these devices, and those resources may have to be
31 described in the device tree, which in turn means we have to describe
34 Another use case for describing an I3C device in the device tree is when
35 this I3C device has a static I2C address and we want to assign it a
36 specific I3C dynamic address before the DAA takes place (so that other
37 devices on the bus can't take this dynamic address).
44 Frequency of the SCL signal used for I3C transfers. When undefined, the
45 default value should be 12.5MHz.
47 May not be supported by all controllers.
51 Frequency of the SCL signal used for I2C transfers. When undefined, the
52 default should be to look at LVR (Legacy Virtual Register) values of
53 I2C devices described in the device tree to determine the maximum I2C
56 May not be supported by all controllers.
66 I2C child, should be named: <device-type>@<i2c-address>
68 All properties described in Documentation/devicetree/bindings/i2c/i2c.txt
69 are valid here, except the reg property whose content is changed.
74 Compatible of the I2C device.
80 I2C address. 10 bit addressing is not supported. Devices with
81 10-bit address can't be properly passed through DEFSLVS
87 Shall encode the I3C LVR (Legacy Virtual Register):
88 bit[31:8]: unused/ignored
89 bit[7:5]: I2C device index. Possible values:
90 * 0: I2C device has a 50 ns spike filter
91 * 1: I2C device does not have a 50 ns spike filter but
92 supports high frequency on SCL
93 * 2: I2C device does not have a 50 ns spike filter and is
94 not tolerant to high frequencies
96 bit[4]: tell whether the device operates in FM (Fast Mode)
100 bit[3:0]: device type
107 "@[0-9a-f]+,[0-9a-f]+$":
110 I3C child, should be named: <device-type>@<static-i2c-address>,<i3c-pid>
117 Encodes the static I2C address. Should be 0 if the device does
118 not have one (0 is not a valid I2C address).
122 First half of the Provisional ID (following the PID
123 definition provided by the I3C specification).
125 Contains the manufacturer ID left-shifted by 1.
127 Second half of the Provisional ID (following the PID
128 definition provided by the I3C specification).
130 Contains the ORing of the part ID left-shifted by 16,
131 the instance ID left-shifted by 12 and extra information.
134 $ref: /schemas/types.yaml#/definitions/uint32
138 Dynamic address to be assigned to this device. In case static address is
139 present (first cell of the reg property != 0), this address is assigned
140 through SETDASA. If static address is not present, this address is assigned
141 through SETNEWDA after assigning a temporary address via ENTDAA.
146 additionalProperties: true
151 compatible = "cdns,i3c-master";
152 clocks = <&coreclock>, <&i3csysclock>;
153 clock-names = "pclk", "sysclk";
155 reg = <0x0d040000 0x1000>;
156 #address-cells = <3>;
158 i2c-scl-hz = <100000>;
162 compatible = "atmel,24c01";
163 reg = <0x57 0x0 0x10>;
167 /* I3C device with a static I2C address and assigned address. */
168 thermal_sensor: sensor@68,39200144004 {
169 reg = <0x68 0x392 0x144004>;
170 assigned-address = <0xa>;
173 /* I3C device with only assigned address. */
174 pressure_sensor: sensor@0,39200124004 {
175 reg = <0x0 0x392 0x124000>;
176 assigned-address = <0xc>;
180 * I3C device without a static I2C address but requiring
181 * resources described in the DT.
183 sensor@0,39200154004 {
184 reg = <0x0 0x392 0x154004>;
185 clocks = <&clock_provider 0>;