xref: /freebsd/sys/contrib/device-tree/Bindings/i2c/renesas,iic.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotDevice tree configuration for Renesas IIC (sh_mobile) driver
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotRequired properties:
4*c66ec88fSEmmanuel Vadot- compatible      :
5*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a73a4" (R-Mobile APE6)
6*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7740" (R-Mobile A1)
7*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7742" (RZ/G1H)
8*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7743" (RZ/G1M)
9*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7744" (RZ/G1N)
10*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7745" (RZ/G1E)
11*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a774a1" (RZ/G2M)
12*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a774b1" (RZ/G2N)
13*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a774c0" (RZ/G2E)
14*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a774e1" (RZ/G2H)
15*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7790" (R-Car H2)
16*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7791" (R-Car M2-W)
17*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7792" (R-Car V2H)
18*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7793" (R-Car M2-N)
19*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7794" (R-Car E2)
20*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7795" (R-Car H3)
21*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a7796" (R-Car M3-W)
22*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a77961" (R-Car M3-W+)
23*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a77965" (R-Car M3-N)
24*c66ec88fSEmmanuel Vadot			- "renesas,iic-r8a77990" (R-Car E3)
25*c66ec88fSEmmanuel Vadot			- "renesas,iic-sh73a0" (SH-Mobile AG5)
26*c66ec88fSEmmanuel Vadot			- "renesas,rcar-gen2-iic" (generic R-Car Gen2 or RZ/G1
27*c66ec88fSEmmanuel Vadot							compatible device)
28*c66ec88fSEmmanuel Vadot			- "renesas,rcar-gen3-iic" (generic R-Car Gen3 or RZ/G2
29*c66ec88fSEmmanuel Vadot							compatible device)
30*c66ec88fSEmmanuel Vadot			- "renesas,rmobile-iic" (generic device)
31*c66ec88fSEmmanuel Vadot
32*c66ec88fSEmmanuel Vadot			When compatible with a generic R-Car version, nodes
33*c66ec88fSEmmanuel Vadot			must list the SoC-specific version corresponding to
34*c66ec88fSEmmanuel Vadot			the platform first followed by the generic R-Car
35*c66ec88fSEmmanuel Vadot			version.
36*c66ec88fSEmmanuel Vadot
37*c66ec88fSEmmanuel Vadot			When compatible with "renesas,rmobile-iic" it should
38*c66ec88fSEmmanuel Vadot			be the last compatibility string listed.
39*c66ec88fSEmmanuel Vadot
40*c66ec88fSEmmanuel Vadot			The r8a77990 (R-Car E3) and r8a774c0 (RZ/G2E)
41*c66ec88fSEmmanuel Vadot			controllers are not considered compatible with
42*c66ec88fSEmmanuel Vadot			"renesas,rcar-gen3-iic" or "renesas,rmobile-iic"
43*c66ec88fSEmmanuel Vadot			due to the absence of automatic transmission registers.
44*c66ec88fSEmmanuel Vadot
45*c66ec88fSEmmanuel Vadot- reg             : address start and address range size of device
46*c66ec88fSEmmanuel Vadot- interrupts      : interrupt of device
47*c66ec88fSEmmanuel Vadot- clocks          : clock for device
48*c66ec88fSEmmanuel Vadot- #address-cells  : should be <1>
49*c66ec88fSEmmanuel Vadot- #size-cells     : should be <0>
50*c66ec88fSEmmanuel Vadot
51*c66ec88fSEmmanuel VadotOptional properties:
52*c66ec88fSEmmanuel Vadot- clock-frequency : frequency of bus clock in Hz. Default 100kHz if unset.
53*c66ec88fSEmmanuel Vadot- dmas            : Must contain a list of two references to DMA
54*c66ec88fSEmmanuel Vadot		    specifiers, one for transmission, and one for
55*c66ec88fSEmmanuel Vadot		    reception.
56*c66ec88fSEmmanuel Vadot- dma-names       : Must contain a list of two DMA names, "tx" and "rx".
57*c66ec88fSEmmanuel Vadot
58*c66ec88fSEmmanuel Vadot
59*c66ec88fSEmmanuel VadotPinctrl properties might be needed, too. See there.
60*c66ec88fSEmmanuel Vadot
61*c66ec88fSEmmanuel VadotExample:
62*c66ec88fSEmmanuel Vadot
63*c66ec88fSEmmanuel Vadot	iic0: i2c@e6500000 {
64*c66ec88fSEmmanuel Vadot		compatible = "renesas,iic-r8a7790", "renesas,rcar-gen2-iic",
65*c66ec88fSEmmanuel Vadot			     "renesas,rmobile-iic";
66*c66ec88fSEmmanuel Vadot		reg = <0 0xe6500000 0 0x425>;
67*c66ec88fSEmmanuel Vadot		interrupts = <0 174 IRQ_TYPE_LEVEL_HIGH>;
68*c66ec88fSEmmanuel Vadot		clocks = <&mstp3_clks R8A7790_CLK_IIC0>;
69*c66ec88fSEmmanuel Vadot		clock-frequency = <400000>;
70*c66ec88fSEmmanuel Vadot		#address-cells = <1>;
71*c66ec88fSEmmanuel Vadot		#size-cells = <0>;
72*c66ec88fSEmmanuel Vadot	};
73