| Andreas Dannenberg | 1a88a04 | 2018-08-27 15:57:45 +0530 | [diff] [blame] | 1 | Texas Instruments TI SCI Generic Power Domain |
| 2 | ============================================= |
| 3 | |
| 4 | Some TI SoCs contain a system controller (like the SYSFW, etc...) that is |
| 5 | responsible for controlling the state of the IPs that are present. |
| 6 | Communication between the host processor running an OS and the system |
| 7 | controller happens through a protocol known as TI SCI [1]. |
| 8 | |
| 9 | [1] http://processors.wiki.ti.com/index.php/TISCI |
| 10 | |
| 11 | PM Domain Node |
| 12 | ============== |
| 13 | The PM domain node represents the global PM domain managed by the SYSFW. Because |
| 14 | this relies on the TI SCI protocol to communicate with the SYSFW it must be a |
| 15 | child of the sysfw node. |
| 16 | |
| 17 | Required Properties: |
| 18 | -------------------- |
| 19 | - compatible: Must be "ti,sci-pm-domain" |
| Lokesh Vutla | c163af6 | 2019-06-07 19:24:45 +0530 | [diff] [blame] | 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. |
| Andreas Dannenberg | 1a88a04 | 2018-08-27 15:57:45 +0530 | [diff] [blame] | 29 | |
| 30 | Example (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 | |
| 41 | PM Domain Consumers |
| 42 | =================== |
| 43 | Hardware blocks belonging to a PM domain should contain a "power-domains" |
| 44 | property that is a phandle pointing to the corresponding PM domain node |
| 45 | along with an index representing the device id to be passed to the PMMC |
| 46 | for device control. |
| 47 | |
| 48 | Required Properties: |
| 49 | -------------------- |
| 50 | - power-domains: phandle pointing to the corresponding PM domain node |
| 51 | and an ID representing the device. |
| 52 | |
| 53 | Example (AM65x): |
| 54 | ---------------- |
| 55 | uart2: serial@02800000 { |
| 56 | compatible = "ti,omap4-uart"; |
| 57 | ... |
| 58 | power-domains = <&k3_pds 0x3f>; |
| 59 | }; |