Merge branch 'work.splice_read' of git://git.kernel.org/pub/scm/linux/kernel/git...
[cascardo/linux.git] / Documentation / devicetree / bindings / arm / samsung / pmu.txt
1 SAMSUNG Exynos SoC series PMU Registers
2
3 Properties:
4  - compatible : should contain two values. First value must be one from following list:
5                    - "samsung,exynos3250-pmu" - for Exynos3250 SoC,
6                    - "samsung,exynos4210-pmu" - for Exynos4210 SoC,
7                    - "samsung,exynos4212-pmu" - for Exynos4212 SoC,
8                    - "samsung,exynos4412-pmu" - for Exynos4412 SoC,
9                    - "samsung,exynos5250-pmu" - for Exynos5250 SoC,
10                    - "samsung,exynos5260-pmu" - for Exynos5260 SoC.
11                    - "samsung,exynos5410-pmu" - for Exynos5410 SoC,
12                    - "samsung,exynos5420-pmu" - for Exynos5420 SoC.
13                    - "samsung,exynos5433-pmu" - for Exynos5433 SoC.
14                    - "samsung,exynos7-pmu" - for Exynos7 SoC.
15                 second value must be always "syscon".
16
17  - reg : offset and length of the register set.
18
19  - #clock-cells : must be <1>, since PMU requires once cell as clock specifier.
20                 The single specifier cell is used as index to list of clocks
21                 provided by PMU, which is currently:
22                         0 : SoC clock output (CLKOUT pin)
23
24  - clock-names : list of clock names for particular CLKOUT mux inputs in
25                 following format:
26                         "clkoutN", where N is a decimal number corresponding to
27                         CLKOUT mux control bits value for given input, e.g.
28                                 "clkout0", "clkout7", "clkout15".
29
30  - clocks : list of phandles and specifiers to all input clocks listed in
31                 clock-names property.
32
33 Optional properties:
34
35 Some PMUs are capable of behaving as an interrupt controller (mostly
36 to wake up a suspended PMU). In which case, they can have the
37 following properties:
38
39 - interrupt-controller: indicate that said PMU is an interrupt controller
40
41 - #interrupt-cells: must be identical to the that of the parent interrupt
42   controller.
43
44 - interrupt-parent: a phandle indicating which interrupt controller
45   this PMU signals interrupts to.
46
47 Example :
48 pmu_system_controller: system-controller@10040000 {
49         compatible = "samsung,exynos5250-pmu", "syscon";
50         reg = <0x10040000 0x5000>;
51         interrupt-controller;
52         #interrupt-cells = <3>;
53         interrupt-parent = <&gic>;
54         #clock-cells = <1>;
55         clock-names = "clkout0", "clkout1", "clkout2", "clkout3",
56                         "clkout4", "clkout8", "clkout9";
57         clocks = <&clock CLK_OUT_DMC>, <&clock CLK_OUT_TOP>,
58                 <&clock CLK_OUT_LEFTBUS>, <&clock CLK_OUT_RIGHTBUS>,
59                 <&clock CLK_OUT_CPU>, <&clock CLK_XXTI>,
60                 <&clock CLK_XUSBXTI>;
61 };
62
63 Example of clock consumer :
64
65 usb3503: usb3503@08 {
66         /* ... */
67         clock-names = "refclk";
68         clocks = <&pmu_system_controller 0>;
69         /* ... */
70 };