| Texas Instruments System Control Interface (TI-SCI) Reset Controller |
| ===================================================================== |
| |
| Some TI SoCs contain a system controller (like the Power Management Micro |
| Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling |
| the state of the various hardware modules present on the SoC. Communication |
| between the host processor running an OS and the system controller happens |
| through a protocol called TI System Control Interface (TI-SCI protocol). |
| For TI SCI details, please refer to the document, |
| Documentation/devicetree/bindings/arm/keystone/ti,sci.txt |
| |
| TI-SCI Reset Controller Node |
| ============================ |
| This reset controller node uses the TI SCI protocol to perform the reset |
| management of various hardware modules present on the SoC. Must be a child |
| node of the associated TI-SCI system controller node. |
| |
| Required properties: |
| -------------------- |
| - compatible : Should be "ti,sci-reset" |
| - #reset-cells : Should be 2. Please see the reset consumer node below for |
| usage details. |
| |
| TI-SCI Reset Consumer Nodes |
| =========================== |
| Each of the reset consumer nodes should have the following properties, |
| in addition to their own properties. |
| |
| Required properties: |
| -------------------- |
| - resets : A phandle and reset specifier pair, one pair for each reset |
| signal that affects the device, or that the device manages. |
| The phandle should point to the TI-SCI reset controller node, |
| and the reset specifier should have 2 cell-values. The first |
| cell should contain the device ID. The second cell should |
| contain the reset mask value used by system controller. |
| Please refer to the protocol documentation for these values |
| to be used for different devices, |
| http://processors.wiki.ti.com/index.php/TISCI#66AK2G02_Data |
| |
| Please also refer to Documentation/devicetree/bindings/reset/reset.txt for |
| common reset controller usage by consumers. |
| |
| Example: |
| -------- |
| The following example demonstrates both a TI-SCI reset controller node and a |
| consumer (a DSP device) on the 66AK2G SoC. |
| |
| pmmc: pmmc { |
| compatible = "ti,k2g-sci"; |
| |
| k2g_reset: reset-controller { |
| compatible = "ti,sci-reset"; |
| #reset-cells = <2>; |
| }; |
| }; |
| |
| dsp0: dsp@10800000 { |
| ... |
| resets = <&k2g_reset 0x0046 0x1>; |
| ... |
| }; |