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#
7 title: I3C bus
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
16   may, during the life of the bus, request mastership.
20     pattern: "^i3c-master@[0-9a-f]+$"
22   "#address-cells":
25       Each I2C device connected to the bus should be described in a subnode.
37       devices on the bus can't take this dynamic address).
39   "#size-cells":
42   i3c-scl-hz:
49   i2c-scl-hz:
58   mctp-controller:
61       Indicates that the system is accessible via this bus as an endpoint for
65   - "#address-cells"
66   - "#size-cells"
69   "@[0-9a-f]+$":
72       I2C child, should be named: <device-type>@<i2c-address>
84           - items:
85               - description: |
87                   10-bit address can't be properly passed through DEFSLVS
91               - const: 0
92               - description: |
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: |
127               - description: |
128                   First half of the Provisioned ID (following the PID
131                   Contains the manufacturer ID left-shifted by 1.
132               - description: |
133                   Second half of the Provisioned ID (following the PID
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>;
176             assigned-address = <0xa>;
182             assigned-address = <0xc>;