Commit 2ca065dc authored by Philipp Zabel's avatar Philipp Zabel
Browse files

dt-bindings: reset: st,sti-powerdown: Convert to yaml 



Convert the device tree bindings for the STMicroelectronics STi
Peripheral Powerdown reset controller to YAML schema to allow
participating in DT validation.

Signed-off-by: default avatarPhilipp Zabel <p.zabel@pengutronix.de>
Cc: Srinivas Kandagatla <srinivas.kandagatla@st.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220407154338.4190674-13-p.zabel@pengutronix.de
parent b550b8a4

Documentation/devicetree/bindings/reset/st,sti-powerdown.txt

deleted100644 → 0
+0 −45
Original line number Diff line number Diff line 
STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller

=============================================================================



This binding describes a reset controller device that is used to enable and

disable on-chip peripheral controllers such as USB and SATA, using

"powerdown" control bits found in the STi family SoC system configuration

registers. These have been grouped together into a single reset controller

device for convenience.



The actual action taken when powerdown is asserted is hardware dependent.

However, when asserted it may not be possible to access the hardware's

registers and after an assert/deassert sequence the hardware's previous state

may no longer be valid.



Please refer to reset.txt in this directory for common reset

controller binding usage.



Required properties:

- compatible: Should be "st,stih407-powerdown"

- #reset-cells: 1, see below



example:



	powerdown: powerdown-controller {

		compatible = "st,stih407-powerdown";

		#reset-cells = <1>;

	};





Specifying powerdown control of devices

=======================================



Device nodes should specify the reset channel required in their "resets"

property, containing a phandle to the powerdown device node and an

index specifying which channel to use, as described in reset.txt



example:



	st_dwc3: dwc3@8f94000 {

		resets          = <&powerdown STIH407_USB3_POWERDOWN>,

	};



Macro definitions for the supported reset channels can be found in:



include/dt-bindings/reset/stih407-resets.h

Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml

0 → 100644
+49 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/reset/st,stih407-powerdown.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: STMicroelectronics STi family Sysconfig Peripheral Powerdown Reset Controller



maintainers:

  - Srinivas Kandagatla <srinivas.kandagatla@st.com>



description: |

  This binding describes a reset controller device that is used to enable and

  disable on-chip peripheral controllers such as USB and SATA, using

  "powerdown" control bits found in the STi family SoC system configuration

  registers. These have been grouped together into a single reset controller

  device for convenience.



  The actual action taken when powerdown is asserted is hardware dependent.

  However, when asserted it may not be possible to access the hardware's

  registers and after an assert/deassert sequence the hardware's previous state

  may no longer be valid.



properties:

  compatible:

    const: st,stih407-powerdown



  '#reset-cells':

    const: 1



required:

  - compatible

  - '#reset-cells'



additionalProperties: false



examples:

  - |

    #include <dt-bindings/reset/stih407-resets.h>



    powerdown: powerdown-controller {

        compatible = "st,stih407-powerdown";

        #reset-cells = <1>;

    };



    // Specifying powerdown control of devices:

    st_dwc3: dwc3 {

        resets = <&powerdown STIH407_USB3_POWERDOWN>;

    };