xref: /freebsd/sys/contrib/device-tree/Bindings/net/can/rcar_can.txt (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
1Renesas R-Car CAN controller Device Tree Bindings
2-------------------------------------------------
3
4Required properties:
5- compatible: "renesas,can-r8a7743" if CAN controller is a part of R8A7743 SoC.
6	      "renesas,can-r8a7744" if CAN controller is a part of R8A7744 SoC.
7	      "renesas,can-r8a7745" if CAN controller is a part of R8A7745 SoC.
8	      "renesas,can-r8a77470" if CAN controller is a part of R8A77470 SoC.
9	      "renesas,can-r8a774a1" if CAN controller is a part of R8A774A1 SoC.
10	      "renesas,can-r8a774b1" if CAN controller is a part of R8A774B1 SoC.
11	      "renesas,can-r8a774c0" if CAN controller is a part of R8A774C0 SoC.
12	      "renesas,can-r8a7778" if CAN controller is a part of R8A7778 SoC.
13	      "renesas,can-r8a7779" if CAN controller is a part of R8A7779 SoC.
14	      "renesas,can-r8a7790" if CAN controller is a part of R8A7790 SoC.
15	      "renesas,can-r8a7791" if CAN controller is a part of R8A7791 SoC.
16	      "renesas,can-r8a7792" if CAN controller is a part of R8A7792 SoC.
17	      "renesas,can-r8a7793" if CAN controller is a part of R8A7793 SoC.
18	      "renesas,can-r8a7794" if CAN controller is a part of R8A7794 SoC.
19	      "renesas,can-r8a7795" if CAN controller is a part of R8A7795 SoC.
20	      "renesas,can-r8a7796" if CAN controller is a part of R8A7796 SoC.
21	      "renesas,can-r8a77965" if CAN controller is a part of R8A77965 SoC.
22	      "renesas,can-r8a77990" if CAN controller is a part of R8A77990 SoC.
23	      "renesas,can-r8a77995" if CAN controller is a part of R8A77995 SoC.
24	      "renesas,rcar-gen1-can" for a generic R-Car Gen1 compatible device.
25	      "renesas,rcar-gen2-can" for a generic R-Car Gen2 or RZ/G1
26	      compatible device.
27	      "renesas,rcar-gen3-can" for a generic R-Car Gen3 or RZ/G2
28	      compatible device.
29	      When compatible with the generic version, nodes must list the
30	      SoC-specific version corresponding to the platform first
31	      followed by the generic version.
32
33- reg: physical base address and size of the R-Car CAN register map.
34- interrupts: interrupt specifier for the sole interrupt.
35- clocks: phandles and clock specifiers for 3 CAN clock inputs.
36- clock-names: 3 clock input name strings: "clkp1", "clkp2", and "can_clk".
37- pinctrl-0: pin control group to be used for this controller.
38- pinctrl-names: must be "default".
39
40Required properties for R8A774A1, R8A774B1, R8A774C0, R8A7795, R8A7796,
41R8A77965, R8A77990, and R8A77995:
42For the denoted SoCs, "clkp2" can be CANFD clock. This is a div6 clock and can
43be used by both CAN and CAN FD controller at the same time. It needs to be
44scaled to maximum frequency if any of these controllers use it. This is done
45using the below properties:
46
47- assigned-clocks: phandle of clkp2(CANFD) clock.
48- assigned-clock-rates: maximum frequency of this clock.
49
50Optional properties:
51- renesas,can-clock-select: R-Car CAN Clock Source Select. Valid values are:
52			    <0x0> (default) : Peripheral clock (clkp1)
53			    <0x1> : Peripheral clock (clkp2)
54			    <0x3> : External input clock
55
56Example
57-------
58
59SoC common .dtsi file:
60
61	can0: can@e6e80000 {
62		compatible = "renesas,can-r8a7791", "renesas,rcar-gen2-can";
63		reg = <0 0xe6e80000 0 0x1000>;
64		interrupts = <0 186 IRQ_TYPE_LEVEL_HIGH>;
65		clocks = <&mstp9_clks R8A7791_CLK_RCAN0>,
66			 <&cpg_clocks R8A7791_CLK_RCAN>, <&can_clk>;
67		clock-names = "clkp1", "clkp2", "can_clk";
68		status = "disabled";
69	};
70
71Board specific .dts file:
72
73&can0 {
74	pinctrl-0 = <&can0_pins>;
75	pinctrl-names = "default";
76	status = "okay";
77};
78