| Andreas Dannenberg | 4cfdf4d | 2018-08-27 15:57:41 +0530 | [diff] [blame] | 1 | Texas Instruments TI SCI Reset Controller |
| 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 | Reset Controller Node |
| 12 | ===================== |
| 13 | The reset controller node represents the resets of various hardware modules |
| 14 | present on the SoC managed by the SYSFW. Because this relies on the TI SCI |
| 15 | protocol to communicate with the SYSFW it must be a child of the sysfw node. |
| 16 | |
| 17 | Required Properties: |
| 18 | -------------------- |
| 19 | - compatible: Must be "ti,sci-reset" |
| 20 | - #reset-cells: Must be 2. Please see the reset consumer node below for |
| 21 | usage details. |
| 22 | |
| 23 | Example (AM65x): |
| 24 | ---------------- |
| 25 | sysfw: sysfw { |
| 26 | compatible = "ti,am654-system-controller"; |
| 27 | ... |
| 28 | k3_reset: reset-controller { |
| 29 | compatible = "ti,sci-reset"; |
| 30 | #reset-cells = <2>; |
| 31 | }; |
| 32 | }; |
| 33 | |
| 34 | Reset Consumers |
| 35 | =============== |
| 36 | Each of the reset consumer nodes should have the following properties, |
| 37 | in addition to their own properties. |
| 38 | |
| 39 | Required Properties: |
| 40 | -------------------- |
| 41 | - resets: A phandle and reset specifier pair, one pair for each reset signal |
| 42 | that affects the device, or that the device manages. The phandle |
| 43 | should point to the TI SCI reset controller node, and the reset |
| 44 | specifier should have 2 cell-values. The first cell should contain |
| 45 | the device ID. The second cell should contain the reset mask value |
| 46 | used by system controller. |
| 47 | |
| 48 | Example (AM65x): |
| 49 | ---------------- |
| 50 | uart2: serial@02800000 { |
| 51 | compatible = "ti,omap4-uart"; |
| 52 | ... |
| 53 | resets = <&k3_reset 5 1>; |
| 54 | }; |