xref: /freebsd/sys/contrib/device-tree/Bindings/clock/renesas,r8a7779-cpg-clocks.txt (revision 19fae0f66023a97a9b464b3beeeabb2081f575b3)
1* Renesas R8A7779 Clock Pulse Generator (CPG)
2
3The CPG generates core clocks for the R8A7779. It includes one PLL and
4several fixed ratio dividers.
5The CPG also provides a Clock Domain for SoC devices, in combination with the
6CPG Module Stop (MSTP) Clocks.
7
8Required Properties:
9
10  - compatible: Must be "renesas,r8a7779-cpg-clocks"
11  - reg: Base address and length of the memory resource used by the CPG
12
13  - clocks: Reference to the parent clock
14  - #clock-cells: Must be 1
15  - clock-output-names: The names of the clocks. Supported clocks are "plla",
16    "z", "zs", "s", "s1", "p", "b", "out".
17  - #power-domain-cells: Must be 0
18
19SoC devices that are part of the CPG/MSTP Clock Domain and can be power-managed
20through an MSTP clock should refer to the CPG device node in their
21"power-domains" property, as documented by the generic PM domain bindings in
22Documentation/devicetree/bindings/power/power_domain.txt.
23
24
25Examples
26--------
27
28  - CPG device node:
29
30	cpg_clocks: cpg_clocks@ffc80000 {
31		compatible = "renesas,r8a7779-cpg-clocks";
32		reg = <0xffc80000 0x30>;
33		clocks = <&extal_clk>;
34		#clock-cells = <1>;
35		clock-output-names = "plla", "z", "zs", "s", "s1", "p",
36		                     "b", "out";
37		#power-domain-cells = <0>;
38	};
39
40
41  - CPG/MSTP Clock Domain member device node:
42
43	sata: sata@fc600000 {
44		compatible = "renesas,sata-r8a7779", "renesas,rcar-sata";
45		reg = <0xfc600000 0x2000>;
46		interrupts = <0 100 IRQ_TYPE_LEVEL_HIGH>;
47		clocks = <&mstp1_clks R8A7779_CLK_SATA>;
48		power-domains = <&cpg_clocks>;
49	};
50