xref: /freebsd-src/sys/contrib/device-tree/Bindings/i3c/cdns,i3c-master.txt (revision 2eb4d8dc723da3cf7d735a3226ae49da4c8c5dbc)
1c66ec88fSEmmanuel VadotBindings for cadence I3C master block
2c66ec88fSEmmanuel Vadot=====================================
3c66ec88fSEmmanuel Vadot
4c66ec88fSEmmanuel VadotRequired properties:
5c66ec88fSEmmanuel Vadot--------------------
6c66ec88fSEmmanuel Vadot- compatible: shall be "cdns,i3c-master"
7c66ec88fSEmmanuel Vadot- clocks: shall reference the pclk and sysclk
8c66ec88fSEmmanuel Vadot- clock-names: shall contain "pclk" and "sysclk"
9c66ec88fSEmmanuel Vadot- interrupts: the interrupt line connected to this I3C master
10c66ec88fSEmmanuel Vadot- reg: I3C master registers
11c66ec88fSEmmanuel Vadot
12c66ec88fSEmmanuel VadotMandatory properties defined by the generic binding (see
13*2eb4d8dcSEmmanuel VadotDocumentation/devicetree/bindings/i3c/i3c.yaml for more details):
14c66ec88fSEmmanuel Vadot
15c66ec88fSEmmanuel Vadot- #address-cells: shall be set to 1
16c66ec88fSEmmanuel Vadot- #size-cells: shall be set to 0
17c66ec88fSEmmanuel Vadot
18c66ec88fSEmmanuel VadotOptional properties defined by the generic binding (see
19*2eb4d8dcSEmmanuel VadotDocumentation/devicetree/bindings/i3c/i3c.yaml for more details):
20c66ec88fSEmmanuel Vadot
21c66ec88fSEmmanuel Vadot- i2c-scl-hz
22c66ec88fSEmmanuel Vadot- i3c-scl-hz
23c66ec88fSEmmanuel Vadot
24c66ec88fSEmmanuel VadotI3C device connected on the bus follow the generic description (see
25*2eb4d8dcSEmmanuel VadotDocumentation/devicetree/bindings/i3c/i3c.yaml for more details).
26c66ec88fSEmmanuel Vadot
27c66ec88fSEmmanuel VadotExample:
28c66ec88fSEmmanuel Vadot
29c66ec88fSEmmanuel Vadot	i3c-master@0d040000 {
30c66ec88fSEmmanuel Vadot		compatible = "cdns,i3c-master";
31c66ec88fSEmmanuel Vadot		clocks = <&coreclock>, <&i3csysclock>;
32c66ec88fSEmmanuel Vadot		clock-names = "pclk", "sysclk";
33c66ec88fSEmmanuel Vadot		interrupts = <3 0>;
34c66ec88fSEmmanuel Vadot		reg = <0x0d040000 0x1000>;
35c66ec88fSEmmanuel Vadot		#address-cells = <1>;
36c66ec88fSEmmanuel Vadot		#size-cells = <0>;
37c66ec88fSEmmanuel Vadot		i2c-scl-hz = <100000>;
38c66ec88fSEmmanuel Vadot
39c66ec88fSEmmanuel Vadot		nunchuk: nunchuk@52 {
40c66ec88fSEmmanuel Vadot			compatible = "nintendo,nunchuk";
41c66ec88fSEmmanuel Vadot			reg = <0x52 0x0 0x10>;
42c66ec88fSEmmanuel Vadot		};
43c66ec88fSEmmanuel Vadot	};
44