| Message ID | 20240131221957.213717-2-afd@ti.com |
|---|---|
| State | New |
| Headers | show |
| Series | [01/12] dt-bindings: power: reset: Document ti,sci-reboot compatible | expand |
On Wed, Jan 31, 2024 at 04:19:46PM -0600, Andrew Davis wrote: > This calls into the system firmware using TI-SCI to reboot the system. > Used as a fallback when PSCI is unable or not available to reboot > the system. > > Signed-off-by: Andrew Davis <afd@ti.com> > --- > .../bindings/power/reset/ti,sci-reboot.yaml | 33 +++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 34 insertions(+) > create mode 100644 Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml > > diff --git a/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml b/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml > new file mode 100644 > index 0000000000000..aa628be33d122 > --- /dev/null > +++ b/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml > @@ -0,0 +1,33 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/power/reset/ti,sci-reboot.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: TI-SCI reboot controller > + > +maintainers: > + - Andrew Davis <afd@ti.com> > + > +description: | > + 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). > + > + This reboot controller node uses the TI SCI protocol to perform a device reboot. > + > + Must be a child node of the associated TI-SCI system controller node. > + > +properties: > + compatible: > + const: ti,sci-reboot > + > +additionalProperties: false > + > +examples: > + - | > + k3_reboot: reboot-controller { > + compatible = "ti,sci-reboot"; > + }; I'd drop the example since this has no use standalone and just rely on the one in the parent. Otherwise I think this is fine. Acked-by: Conor Dooley <conor.dooley@microchip.com>
diff --git a/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml b/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml new file mode 100644 index 0000000000000..aa628be33d122 --- /dev/null +++ b/Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml @@ -0,0 +1,33 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/power/reset/ti,sci-reboot.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI-SCI reboot controller + +maintainers: + - Andrew Davis <afd@ti.com> + +description: | + 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). + + This reboot controller node uses the TI SCI protocol to perform a device reboot. + + Must be a child node of the associated TI-SCI system controller node. + +properties: + compatible: + const: ti,sci-reboot + +additionalProperties: false + +examples: + - | + k3_reboot: reboot-controller { + compatible = "ti,sci-reboot"; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 8999497011a26..45983bb174fe4 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -21751,6 +21751,7 @@ F: Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml F: Documentation/devicetree/bindings/clock/ti,sci-clk.yaml F: Documentation/devicetree/bindings/interrupt-controller/ti,sci-inta.yaml F: Documentation/devicetree/bindings/interrupt-controller/ti,sci-intr.yaml +F: Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml F: Documentation/devicetree/bindings/reset/ti,sci-reset.yaml F: Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml F: drivers/clk/keystone/sci-clk.c
This calls into the system firmware using TI-SCI to reboot the system. Used as a fallback when PSCI is unable or not available to reboot the system. Signed-off-by: Andrew Davis <afd@ti.com> --- .../bindings/power/reset/ti,sci-reboot.yaml | 33 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 34 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/reset/ti,sci-reboot.yaml