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@[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>
74       All properties described in dtschema schemas/i2c/i2c-controller.yaml
84           - items:
85               - description: |
87                   10-bit address can't be properly passed through DEFSLVS
91               - const: 0
92               - description: |
94                   See include/dt-bindings/i3c/i3c.h
102                       * 3-7: reserved
108                       * 0-15: reserved
111       - compatible
112       - reg
114   "@[0-9a-f]+,[0-9a-f]+$":
117       I3C child, should be named: <device-type>@<static-i2c-address>,<i3c-pid>
122           - items:
123               - description: |
128               - description: |
129                   First half of the Provisioned ID (following the PID
132                   Contains the manufacturer ID left-shifted by 1.
133               - description: |
134                   Second half of the Provisioned ID (following the PID
137                   Contains the ORing of the part ID left-shifted by 16,
138                   the instance ID left-shifted by 12 and extra information.
140       assigned-address:
151       - reg
156   - |
157     #include <dt-bindings/i3c/i3c.h>
160         compatible = "cdns,i3c-master";
162         clock-names = "pclk", "sysclk";
165         #address-cells = <3>;
166         #size-cells = <0>;
167         i2c-scl-hz = <100000>;
179             assigned-address = <0xa>;
185             assigned-address = <0xc>;