1Texas Instruments TI-SCI Generic Power Domain
2---------------------------------------------
3
4Some TI SoCs contain a system controller (like the PMMC, 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] Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
10
11PM Domain Node
12==============
13The PM domain node represents the global PM domain managed by the PMMC, which
14in this case is the implementation as documented by the generic PM domain
15bindings in Documentation/devicetree/bindings/power/power_domain.txt.  Because
16this relies on the TI SCI protocol to communicate with the PMMC it must be a
17child of the pmmc node.
18
19Required Properties:
20--------------------
21- compatible: should be "ti,sci-pm-domain"
22- #power-domain-cells: Must be 1 so that an id can be provided in each
23		       device node.
24
25Example (K2G):
26-------------
27	pmmc: pmmc {
28		compatible = "ti,k2g-sci";
29		...
30
31		k2g_pds: power-controller {
32			compatible = "ti,sci-pm-domain";
33			#power-domain-cells = <1>;
34		};
35	};
36
37PM Domain Consumers
38===================
39Hardware blocks belonging to a PM domain should contain a "power-domains"
40property that is a phandle pointing to the corresponding PM domain node
41along with an index representing the device id to be passed to the PMMC
42for device control.
43
44Required Properties:
45--------------------
46- power-domains: phandle pointing to the corresponding PM domain node
47		 and an ID representing the device.
48
49See http://processors.wiki.ti.com/index.php/TISCI#66AK2G02_Data for the list
50of valid identifiers for k2g.
51
52Example (K2G):
53--------------------
54	uart0: serial@2530c00 {
55		compatible = "ns16550a";
56		...
57		power-domains = <&k2g_pds 0x002c>;
58	};
59