All of lore.kernel.org
 help / color / mirror / Atom feed
From: Philipp Zabel <p.zabel@pengutronix.de>
To: devicetree@vger.kernel.org
Cc: Rob Herring <robh+dt@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Neil Armstrong <narmstrong@baylibre.com>,
	linux-kernel@vger.kernel.org,
	Srinivas Kandagatla <srinivas.kandagatla@st.com>
Subject: [PATCH 13/14] dt-bindings: reset: st,sti-powerdown: Convert to yaml
Date: Thu,  7 Apr 2022 17:43:37 +0200	[thread overview]
Message-ID: <20220407154338.4190674-13-p.zabel@pengutronix.de> (raw)
In-Reply-To: <20220407154338.4190674-1-p.zabel@pengutronix.de>

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: Philipp Zabel <p.zabel@pengutronix.de>
Cc: Srinivas Kandagatla <srinivas.kandagatla@st.com>
---
 .../bindings/reset/st,sti-powerdown.txt       | 45 -----------------
 .../bindings/reset/st,stih407-powerdown.yaml  | 49 +++++++++++++++++++
 2 files changed, 49 insertions(+), 45 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/reset/st,sti-powerdown.txt
 create mode 100644 Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml

diff --git a/Documentation/devicetree/bindings/reset/st,sti-powerdown.txt b/Documentation/devicetree/bindings/reset/st,sti-powerdown.txt
deleted file mode 100644
index 92527138bc93..000000000000
--- a/Documentation/devicetree/bindings/reset/st,sti-powerdown.txt
+++ /dev/null
@@ -1,45 +0,0 @@
-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
diff --git a/Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml b/Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml
new file mode 100644
index 000000000000..d3790e602659
--- /dev/null
+++ b/Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml
@@ -0,0 +1,49 @@
+# 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>;
+    };
-- 
2.30.2


  parent reply	other threads:[~2022-04-07 15:44 UTC|newest]

Thread overview: 36+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-04-07 15:43 [PATCH 01/14] dt-bindings: reset: amlogic,meson-axg-audio-arb: Convert to yaml Philipp Zabel
2022-04-07 15:43 ` [PATCH 02/14] dt-bindings: reset: ath79: " Philipp Zabel
2022-04-08 21:03   ` Rob Herring
2022-04-07 15:43 ` [PATCH 03/14] dt-bindings: reset: berlin: " Philipp Zabel
2022-04-08 21:04   ` Rob Herring
2022-04-07 15:43 ` [PATCH 04/14] dt-bindings: reset: bitmain,bm1880-reset: " Philipp Zabel
2022-04-08 21:05   ` Rob Herring
2022-04-07 15:43 ` [PATCH 05/14] dt-bindings: reset: lantiq,reset: " Philipp Zabel
2022-04-08 21:07   ` Rob Herring
2022-04-18 16:34   ` Martin Blumenstingl
2022-05-02 15:39     ` Philipp Zabel
2022-04-07 15:43 ` [PATCH 06/14] dt-bindings: reset: nuvoton,npcm-reset: " Philipp Zabel
2022-04-08 21:08   ` Rob Herring
2022-04-07 15:43 ` [PATCH 07/14] dt-bindings: reset: oxsemi,oxnas-reset: " Philipp Zabel
2022-04-08 15:43   ` Rob Herring
2022-04-07 15:43 ` [PATCH 08/14] dt-bindings: reset: snps,axs10x-reset: " Philipp Zabel
2022-04-08 21:09   ` Rob Herring
2022-04-07 15:43 ` [PATCH 09/14] dt-bindings: reset: snps,dw-reset: " Philipp Zabel
2022-04-08 15:43   ` Rob Herring
2022-04-08 18:25   ` Rob Herring
2022-04-11 13:59     ` Philipp Zabel
2022-04-07 15:43 ` [PATCH 10/14] dt-bindings: reset: snps,hsdk-reset: " Philipp Zabel
2022-04-08 21:12   ` Rob Herring
2022-04-07 15:43 ` [PATCH 11/14] dt-bindings: reset: socfpga: " Philipp Zabel
2022-04-08 21:12   ` Rob Herring
2022-04-07 15:43 ` [PATCH 12/14] dt-bindings: reset: st,sti-picophyreset: " Philipp Zabel
2022-04-08 21:13   ` Rob Herring
2022-04-07 15:43 ` Philipp Zabel [this message]
2022-04-08 21:14   ` [PATCH 13/14] dt-bindings: reset: st,sti-powerdown: " Rob Herring
2022-04-07 15:43 ` [PATCH 14/14] dt-bindings: reset: " Philipp Zabel
2022-04-07 20:04   ` Rob Herring
2022-05-05  1:08     ` Stephen Warren
2022-08-25 15:53       ` Rob Herring
2022-08-25 16:17         ` Stephen Warren
2022-04-08 21:03 ` [PATCH 01/14] dt-bindings: reset: amlogic,meson-axg-audio-arb: " Rob Herring
2022-04-18 16:32 ` Martin Blumenstingl

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20220407154338.4190674-13-p.zabel@pengutronix.de \
    --to=p.zabel@pengutronix.de \
    --cc=devicetree@vger.kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=narmstrong@baylibre.com \
    --cc=robh+dt@kernel.org \
    --cc=srinivas.kandagatla@st.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.