GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / clock / amlogic,gxbb-clkc.txt
1 * Amlogic GXBB Clock and Reset Unit
2
3 The Amlogic GXBB clock controller generates and supplies clock to various
4 controllers within the SoC.
5
6 Required Properties:
7
8 - compatible: should be:
9                 "amlogic,gxbb-clkc" for GXBB SoC,
10                 "amlogic,gxl-clkc" for GXL and GXM SoC,
11                 "amlogic,axg-clkc" for AXG SoC.
12
13 - #clock-cells: should be 1.
14
15 Each clock is assigned an identifier and client nodes can use this identifier
16 to specify the clock which they consume. All available clocks are defined as
17 preprocessor macros in the dt-bindings/clock/gxbb-clkc.h header and can be
18 used in device tree sources.
19
20 Parent node should have the following properties :
21 - compatible: "syscon", "simple-mfd, and "amlogic,meson-gx-hhi-sysctrl" or
22               "amlogic,meson-axg-hhi-sysctrl"
23 - reg: base address and size of the HHI system control register space.
24
25 Example: Clock controller node:
26
27 sysctrl: system-controller@0 {
28         compatible = "amlogic,meson-gx-hhi-sysctrl", "syscon", "simple-mfd";
29         reg = <0 0 0 0x400>;
30
31         clkc: clock-controller {
32                 #clock-cells = <1>;
33                 compatible = "amlogic,gxbb-clkc";
34         };
35 };
36
37 Example: UART controller node that consumes the clock generated by the clock
38   controller:
39
40         uart_AO: serial@c81004c0 {
41                 compatible = "amlogic,meson-uart";
42                 reg = <0xc81004c0 0x14>;
43                 interrupts = <0 90 1>;
44                 clocks = <&clkc CLKID_CLK81>;
45         };