xref: /linux/Documentation/devicetree/bindings/reset/ti,sci-reset.yaml (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800)
1440b075bSKrzysztof Kozlowski# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
29a81b8cbSNishanth Menon%YAML 1.2
39a81b8cbSNishanth Menon---
49a81b8cbSNishanth Menon$id: http://devicetree.org/schemas/reset/ti,sci-reset.yaml#
59a81b8cbSNishanth Menon$schema: http://devicetree.org/meta-schemas/core.yaml#
69a81b8cbSNishanth Menon
79fa3ad1aSKrzysztof Kozlowskititle: TI-SCI reset controller
89a81b8cbSNishanth Menon
99a81b8cbSNishanth Menonmaintainers:
109a81b8cbSNishanth Menon  - Nishanth Menon <nm@ti.com>
119a81b8cbSNishanth Menon
129a81b8cbSNishanth Menondescription: |
139a81b8cbSNishanth Menon  Some TI SoCs contain a system controller (like the Power Management Micro
149a81b8cbSNishanth Menon  Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling
159a81b8cbSNishanth Menon  the state of the various hardware modules present on the SoC. Communication
169a81b8cbSNishanth Menon  between the host processor running an OS and the system controller happens
179a81b8cbSNishanth Menon  through a protocol called TI System Control Interface (TI-SCI protocol).
189a81b8cbSNishanth Menon
199a81b8cbSNishanth Menon  This reset controller node uses the TI SCI protocol to perform the reset
209a81b8cbSNishanth Menon  management of various hardware modules present on the SoC. Must be a child
219a81b8cbSNishanth Menon  node of the associated TI-SCI system controller node.
229a81b8cbSNishanth Menon
239a81b8cbSNishanth Menonproperties:
249a81b8cbSNishanth Menon  $nodename:
259a81b8cbSNishanth Menon    pattern: "^reset-controller$"
269a81b8cbSNishanth Menon
279a81b8cbSNishanth Menon  compatible:
289a81b8cbSNishanth Menon    const: ti,sci-reset
299a81b8cbSNishanth Menon
309a81b8cbSNishanth Menon  "#reset-cells":
319a81b8cbSNishanth Menon    const: 2
329a81b8cbSNishanth Menon    description:
339a81b8cbSNishanth Menon      The two cells represent values that the TI-SCI controller defines.
349a81b8cbSNishanth Menon
359a81b8cbSNishanth Menon      The first cell should contain the device ID.
369a81b8cbSNishanth Menon
379a81b8cbSNishanth Menon      The second cell should contain the reset mask corresponding to the device
389a81b8cbSNishanth Menon      used by system controller.
399a81b8cbSNishanth Menon
40*9040d64fSRichard Genoud      Please see https://software-dl.ti.com/tisci/esd/latest/index.html for
419a81b8cbSNishanth Menon      protocol documentation for the values to be used for different devices.
429a81b8cbSNishanth Menon
439a81b8cbSNishanth Menon
449a81b8cbSNishanth MenonadditionalProperties: false
459a81b8cbSNishanth Menon
469a81b8cbSNishanth Menonexamples:
479a81b8cbSNishanth Menon  - |
489a81b8cbSNishanth Menon    k3_reset: reset-controller {
499a81b8cbSNishanth Menon        compatible = "ti,sci-reset";
509a81b8cbSNishanth Menon        #reset-cells = <2>;
519a81b8cbSNishanth Menon    };
52