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>
20     pattern: "^i3c@[0-9a-f]+$"
22   "#address-cells":
27       All I3C devices are supposed to support DAA (Dynamic Address Assignment),
36       specific I3C dynamic address before the DAA takes place (so that other
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:
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
103                     bit[4]: tell whether the device operates in FM (Fast Mode)
104                             or FM+ mode:
105                       * 0: FM+ mode
106                       * 1: FM mode
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: |
132                   Contains the manufacturer ID left-shifted by 1.
133               - description: |
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:
145           Dynamic address to be assigned to this device. In case static address is
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>;