[PATCH 1/2] dt-bindings: reset: convert zynq-reset.txt to yaml

From: Radhey Shyam Pandey

Date: Wed Nov 11 2026 - 10:34:09 EST


Convert the Xilinx Zynq reset manager binding to DT schema format.

The reset output list is kept, hung off #reset-cells since that is what
the numbers describe. It is preceded by the encoding the text version
left implicit: the cell is the register's position in the block times 32
plus the bit number within that register. This also explains the gaps in
the list, which are reserved bits and, in the case of 0x23c, a reserved
register.

No dt-bindings header is added. Unlike the firmware-defined IDs in
xlnx,zynqmp-reset, these indices are derived from the SLCR register map
in UG585, and no in-tree device tree references them.

Signed-off-by: Radhey Shyam Pandey <radhey.shyam.pandey@xxxxxxx>
---
.../bindings/reset/xlnx,zynq-reset.yaml | 99 +++++++++++++++++++
.../devicetree/bindings/reset/zynq-reset.txt | 68 -------------
2 files changed, 99 insertions(+), 68 deletions(-)
create mode 100644 Documentation/devicetree/bindings/reset/xlnx,zynq-reset.yaml
delete mode 100644 Documentation/devicetree/bindings/reset/zynq-reset.txt

diff --git a/Documentation/devicetree/bindings/reset/xlnx,zynq-reset.yaml b/Documentation/devicetree/bindings/reset/xlnx,zynq-reset.yaml
new file mode 100644
index 000000000000..a91c999f6243
--- /dev/null
+++ b/Documentation/devicetree/bindings/reset/xlnx,zynq-reset.yaml
@@ -0,0 +1,99 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/reset/xlnx,zynq-reset.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Xilinx Zynq Reset Manager
+
+maintainers:
+ - Michal Simek <michal.simek@xxxxxxx>
+
+description:
+ The Zynq AP-SoC has several different resets, driven from registers in the
+ System Level Control Registers (SLCR). The reset manager is a child node of
+ the SLCR. See Chapter 26 of the Zynq TRM (UG585) for more information about
+ Zynq resets.
+
+properties:
+ compatible:
+ const: xlnx,zynq-reset
+
+ reg:
+ maxItems: 1
+ description:
+ Offset and length of the reset registers within the SLCR.
+
+ syscon:
+ $ref: /schemas/types.yaml#/definitions/phandle
+ description: phandle to the SLCR registers
+
+ "#reset-cells":
+ const: 1
+ description: |
+ The single cell indexes the reset within the register block at 32
+ resets per register, so it is the register's position in the block
+ times 32 plus the bit number within that register:
+
+ 0 soft
+ 32 ddr
+ 64 topsw
+ 96 dmac
+ 128 usb0
+ 129 usb1
+ 160 gem0
+ 161 gem1
+ 164 gem0 rx
+ 165 gem1 rx
+ 166 gem0 ref
+ 167 gem1 ref
+ 192 sdio0
+ 193 sdio1
+ 196 sdio0 ref
+ 197 sdio1 ref
+ 224 spi0
+ 225 spi1
+ 226 spi0 ref
+ 227 spi1 ref
+ 256 can0
+ 257 can1
+ 258 can0 ref
+ 259 can1 ref
+ 288 i2c0
+ 289 i2c1
+ 320 uart0
+ 321 uart1
+ 322 uart0 ref
+ 323 uart1 ref
+ 352 gpio
+ 384 lqspi
+ 385 qspi ref
+ 416 smc
+ 417 smc ref
+ 448 ocm
+ 512 fpga0 out
+ 513 fpga1 out
+ 514 fpga2 out
+ 515 fpga3 out
+ 544 a9 reset 0
+ 545 a9 reset 1
+ 552 peri
+
+required:
+ - compatible
+ - reg
+ - syscon
+ - "#reset-cells"
+
+additionalProperties: false
+
+examples:
+ - |
+ reset-controller@200 {
+ compatible = "xlnx,zynq-reset";
+ reg = <0x200 0x48>;
+ #reset-cells = <1>;
+ syscon = <&slcr>;
+ };
+
+...
diff --git a/Documentation/devicetree/bindings/reset/zynq-reset.txt b/Documentation/devicetree/bindings/reset/zynq-reset.txt
deleted file mode 100644
index 5860120e3064..000000000000
--- a/Documentation/devicetree/bindings/reset/zynq-reset.txt
+++ /dev/null
@@ -1,68 +0,0 @@
-Xilinx Zynq Reset Manager
-
-The Zynq AP-SoC has several different resets.
-
-See Chapter 26 of the Zynq TRM (UG585) for more information about Zynq resets.
-
-Required properties:
-- compatible: "xlnx,zynq-reset"
-- reg: SLCR offset and size taken via syscon <0x200 0x48>
-- syscon: <&slcr>
- This should be a phandle to the Zynq's SLCR registers.
-- #reset-cells: Must be 1
-
-The Zynq Reset Manager needs to be a childnode of the SLCR.
-
-Example:
- rstc: rstc@200 {
- compatible = "xlnx,zynq-reset";
- reg = <0x200 0x48>;
- #reset-cells = <1>;
- syscon = <&slcr>;
- };
-
-Reset outputs:
- 0 : soft reset
- 32 : ddr reset
- 64 : topsw reset
- 96 : dmac reset
- 128: usb0 reset
- 129: usb1 reset
- 160: gem0 reset
- 161: gem1 reset
- 164: gem0 rx reset
- 165: gem1 rx reset
- 166: gem0 ref reset
- 167: gem1 ref reset
- 192: sdio0 reset
- 193: sdio1 reset
- 196: sdio0 ref reset
- 197: sdio1 ref reset
- 224: spi0 reset
- 225: spi1 reset
- 226: spi0 ref reset
- 227: spi1 ref reset
- 256: can0 reset
- 257: can1 reset
- 258: can0 ref reset
- 259: can1 ref reset
- 288: i2c0 reset
- 289: i2c1 reset
- 320: uart0 reset
- 321: uart1 reset
- 322: uart0 ref reset
- 323: uart1 ref reset
- 352: gpio reset
- 384: lqspi reset
- 385: qspi ref reset
- 416: smc reset
- 417: smc ref reset
- 448: ocm reset
- 512: fpga0 out reset
- 513: fpga1 out reset
- 514: fpga2 out reset
- 515: fpga3 out reset
- 544: a9 reset 0
- 545: a9 reset 1
- 552: peri reset
-
--
2.44.4