[deliverable/linux.git] / Documentation / devicetree / bindings / arm / samsung / pmu.txt

SAMSUNG Exynos SoC series PMU Registers

Properties:
 - compatible : should contain two values. First value must be one from following list:
		   - "samsung,exynos3250-pmu" - for Exynos3250 SoC,
		   - "samsung,exynos4210-pmu" - for Exynos4210 SoC,
		   - "samsung,exynos4212-pmu" - for Exynos4212 SoC,
		   - "samsung,exynos4412-pmu" - for Exynos4412 SoC,
		   - "samsung,exynos5250-pmu" - for Exynos5250 SoC,
		   - "samsung,exynos5260-pmu" - for Exynos5260 SoC.
		   - "samsung,exynos5410-pmu" - for Exynos5410 SoC,
		   - "samsung,exynos5420-pmu" - for Exynos5420 SoC.
		   - "samsung,exynos7-pmu" - for Exynos7 SoC.
		second value must be always "syscon".

 - reg : offset and length of the register set.

 - #clock-cells : must be <1>, since PMU requires once cell as clock specifier.
		The single specifier cell is used as index to list of clocks
		provided by PMU, which is currently:
			0 : SoC clock output (CLKOUT pin)

 - clock-names : list of clock names for particular CLKOUT mux inputs in
		following format:
			"clkoutN", where N is a decimal number corresponding to
			CLKOUT mux control bits value for given input, e.g.
				"clkout0", "clkout7", "clkout15".

 - clocks : list of phandles and specifiers to all input clocks listed in
		clock-names property.

Optional properties:

Some PMUs are capable of behaving as an interrupt controller (mostly
to wake up a suspended PMU). In which case, they can have the
following properties:

- interrupt-controller: indicate that said PMU is an interrupt controller

- #interrupt-cells: must be identical to the that of the parent interrupt
  controller.

- interrupt-parent: a phandle indicating which interrupt controller
  this PMU signals interrupts to.

Example :
pmu_system_controller: system-controller@10040000 {
	compatible = "samsung,exynos5250-pmu", "syscon";
	reg = <0x10040000 0x5000>;
	interrupt-controller;
	#interrupt-cells = <3>;
	interrupt-parent = <&gic>;
	#clock-cells = <1>;
	clock-names = "clkout0", "clkout1", "clkout2", "clkout3",
			"clkout4", "clkout8", "clkout9";
	clocks = <&clock CLK_OUT_DMC>, <&clock CLK_OUT_TOP>,
		<&clock CLK_OUT_LEFTBUS>, <&clock CLK_OUT_RIGHTBUS>,
		<&clock CLK_OUT_CPU>, <&clock CLK_XXTI>,
		<&clock CLK_XUSBXTI>;
};

Example of clock consumer :

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