bindings/i3c/i3c.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Alexandre Belloni <alexandre.belloni@bootlin.com>
11   - Miquel Raynal <miquel.raynal@bootlin.com>
15   and a set of child nodes for each I2C or I3C slave on the bus. Each of them
20     pattern: "^i3c-master@[0-9a-f]+$"
22   "#address-cells":
25       Each I2C device connected to the bus should be described in a subnode.
35       this I3C device has a static I2C address and we want to assign it a
39   "#size-cells":
42   i3c-scl-hz:
44       Frequency of the SCL signal used for I3C transfers. When undefined, the
49   i2c-scl-hz:
51       Frequency of the SCL signal used for I2C transfers. When undefined, the
53       I2C devices described in the device tree to determine the maximum I2C
58   mctp-controller:
65   - "#address-cells"
66   - "#size-cells"
69   "@[0-9a-f]+$":
72       I2C child, should be named: <device-type>@<i2c-address>
74       All properties described in Documentation/devicetree/bindings/i2c/i2c.txt
80           Compatible of the I2C device.
84           - items:
85               - description: |
86                   I2C address. 10 bit addressing is not supported. Devices with
87                   10-bit address can't be properly passed through DEFSLVS
91               - const: 0
92               - description: |
95                     bit[7:5]: I2C device index. Possible values:
96                       * 0: I2C device has a 50 ns spike filter
97                       * 1: I2C device does not have a 50 ns spike filter but
98                            supports high frequency on SCL
99                       * 2: I2C device does not have a 50 ns spike filter and is
101                       * 3-7: reserved
107                       * 0-15: reserved
110       - compatible
111       - reg
113   "@[0-9a-f]+,[0-9a-f]+$":
116       I3C child, should be named: <device-type>@<static-i2c-address>,<i3c-pid>
121           - items:
122               - description: |
123                   Encodes the static I2C address. Should be 0 if the device does
124                   not have one (0 is not a valid I2C address).
127               - description: |
131                   Contains the manufacturer ID left-shifted by 1.
132               - description: |
136                   Contains the ORing of the part ID left-shifted by 16,
137                   the instance ID left-shifted by 12 and extra information.
139       assigned-address:
150       - reg
155   - |
156     i3c-master@d040000 {
157         compatible = "cdns,i3c-master";
159         clock-names = "pclk", "sysclk";
162         #address-cells = <3>;
163         #size-cells = <0>;
164         i2c-scl-hz = <100000>;
166         /* I2C device. */
173         /* I3C device with a static I2C address and assigned address. */
176             assigned-address = <0xa>;
182             assigned-address = <0xc>;
186          * I3C device without a static I2C address but requiring