1Texas Instruments TI SCI Generic Power Domain
2=============================================
3
4Some TI SoCs contain a system controller (like the SYSFW, etc...) that is
5responsible for controlling the state of the IPs that are present.
6Communication between the host processor running an OS and the system
7controller happens through a protocol known as TI SCI [1].
8
9[1] http://processors.wiki.ti.com/index.php/TISCI
10
11PM Domain Node
12==============
13The PM domain node represents the global PM domain managed by the SYSFW. Because
14this relies on the TI SCI protocol to communicate with the SYSFW it must be a
15child of the sysfw node.
16
17Required Properties:
18--------------------
19- compatible: Must be "ti,sci-pm-domain"
20- #power-domain-cells: Can be one of the following:
21			1: Containing the device id of each node
22			2: First entry should be device id
23			   Second entry should be one of the floowing:
24			   TI_SCI_PD_EXCLUSIVE: To allow device to be
25						exclusively controlled by
26						the requesting hosts.
27			   TI_SCI_PD_SHARED: To allow device to be shared
28					     by multiple hosts.
29
30Example (AM65x):
31----------------
32	sysfw: sysfw {
33		compatible = "ti,am654-system-controller";
34		...
35		k3_pds: power-controller {
36			compatible = "ti,sci-pm-domain";
37			#power-domain-cells = <1>;
38		};
39	};
40
41PM Domain Consumers
42===================
43Hardware blocks belonging to a PM domain should contain a "power-domains"
44property that is a phandle pointing to the corresponding PM domain node
45along with an index representing the device id to be passed to the PMMC
46for device control.
47
48Required Properties:
49--------------------
50- power-domains: phandle pointing to the corresponding PM domain node
51		 and an ID representing the device.
52
53Example (AM65x):
54----------------
55	uart2: serial@02800000 {
56		compatible = "ti,omap4-uart";
57		...
58		power-domains = <&k3_pds 0x3f>;
59	};
60