[PATCH 1/1] dt-bindings: gpio: convert gpio-74xx-mmio.txt to yaml format

[PATCH 1/1] dt-bindings: gpio: convert gpio-74xx-mmio.txt to yaml format

[Frank Li]

Convert gpio-74xx-mmio.txt to yaml format.

Additional changes:
- remove label in example.

Signed-off-by: Frank Li <Frank.Li@nxp.com>
---
 .../bindings/gpio/gpio-74xx-mmio.txt          | 30 ----------
 .../devicetree/bindings/gpio/ti,7416374.yaml  | 56 +++++++++++++++++++
 2 files changed, 56 insertions(+), 30 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/gpio/gpio-74xx-mmio.txt
 create mode 100644 Documentation/devicetree/bindings/gpio/ti,7416374.yaml

diff --git a/Documentation/devicetree/bindings/gpio/gpio-74xx-mmio.txt b/Documentation/devicetree/bindings/gpio/gpio-74xx-mmio.txt
deleted file mode 100644
index 7bb1a9d601331..0000000000000
--- a/Documentation/devicetree/bindings/gpio/gpio-74xx-mmio.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-* 74XX MMIO GPIO driver
-
-Required properties:
-- compatible: Should contain one of the following:
-   "ti,741g125": for 741G125 (1-bit Input),
-   "ti,741g174": for 741G74 (1-bit Output),
-   "ti,742g125": for 742G125 (2-bit Input),
-   "ti,7474"   : for 7474 (2-bit Output),
-   "ti,74125"  : for 74125 (4-bit Input),
-   "ti,74175"  : for 74175 (4-bit Output),
-   "ti,74365"  : for 74365 (6-bit Input),
-   "ti,74174"  : for 74174 (6-bit Output),
-   "ti,74244"  : for 74244 (8-bit Input),
-   "ti,74273"  : for 74273 (8-bit Output),
-   "ti,741624" : for 741624 (16-bit Input),
-   "ti,7416374": for 7416374 (16-bit Output).
-- reg: Physical base address and length where IC resides.
-- gpio-controller: Marks the device node as a gpio controller.
-- #gpio-cells: Should be two. The first cell is the pin number and
-   the second cell is used to specify the GPIO polarity:
-    0 = Active High,
-    1 = Active Low.
-
-Example:
-	ctrl: gpio@30008004 {
-		compatible = "ti,74174";
-		reg = <0x30008004 0x1>;
-		gpio-controller;
-		#gpio-cells = <2>;
-	};
diff --git a/Documentation/devicetree/bindings/gpio/ti,7416374.yaml b/Documentation/devicetree/bindings/gpio/ti,7416374.yaml
new file mode 100644
index 0000000000000..2ec33248dfce1
--- /dev/null
+++ b/Documentation/devicetree/bindings/gpio/ti,7416374.yaml
@@ -0,0 +1,56 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/gpio/ti,7416374.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: 74XX MMIO GPIO driver
+
+maintainers:
+  - Frank Li <Frank.Li@nxp.com>
+
+properties:
+  compatible:
+    enum:
+      - ti,741g125 # for 741G125 (1-bit Input),
+      - ti,741g174 # for 741G74 (1-bit Output),
+      - ti,742g125 # for 742G125 (2-bit Input),
+      - ti,7474    # for 7474 (2-bit Output),
+      - ti,74125   # for 74125 (4-bit Input),
+      - ti,74175   # for 74175 (4-bit Output),
+      - ti,74365   # for 74365 (6-bit Input),
+      - ti,74174   # for 74174 (6-bit Output),
+      - ti,74244   # for 74244 (8-bit Input),
+      - ti,74273   # for 74273 (8-bit Output),
+      - ti,741624  # for 741624 (16-bit Input),
+      - ti,7416374 # for 7416374 (16-bit Output).
+
+  reg:
+    maxItems: 1
+
+  gpio-controller: true
+
+  '#gpio-cells':
+    const: 2
+    description: |
+      The first cell is the pin number and
+      the second cell is used to specify the GPIO polarity:
+        0 = Active High,
+        1 = Active Low.
+
+required:
+  - compatible
+  - reg
+  - gpio-controller
+  - '#gpio-cells'
+
+additionalProperties: true
+
+examples:
+  - |
+    gpio@30008004 {
+        compatible = "ti,74174";
+        reg = <0x30008004 0x1>;
+        gpio-controller;
+        #gpio-cells = <2>;
+    };
-- 
2.34.1

Re: [PATCH 1/1] dt-bindings: gpio: convert gpio-74xx-mmio.txt to yaml format

[Krzysztof Kozlowski]

On 02/06/2025 16:50, Frank Li wrote:
> Convert gpio-74xx-mmio.txt to yaml format.
> 
> Additional changes:
> - remove label in example.

No need to mention trivial changes in example. We ask to describe
changes in the BINDING.

> 
> Signed-off-by: Frank Li <Frank.Li@nxp.com

...

> new file mode 100644
> index 0000000000000..2ec33248dfce1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/gpio/ti,7416374.yaml
> @@ -0,0 +1,56 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/gpio/ti,7416374.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: 74XX MMIO GPIO driver

TI 74XX MMIO GPIO Controller

> +
> +maintainers:
> +  - Frank Li <Frank.Li@nxp.com>
> +
> +properties:
> +  compatible:
> +    enum:
> +      - ti,741g125 # for 741G125 (1-bit Input),
> +      - ti,741g174 # for 741G74 (1-bit Output),
> +      - ti,742g125 # for 742G125 (2-bit Input),
> +      - ti,7474    # for 7474 (2-bit Output),
> +      - ti,74125   # for 74125 (4-bit Input),
> +      - ti,74175   # for 74175 (4-bit Output),
> +      - ti,74365   # for 74365 (6-bit Input),
> +      - ti,74174   # for 74174 (6-bit Output),
> +      - ti,74244   # for 74244 (8-bit Input),
> +      - ti,74273   # for 74273 (8-bit Output),
> +      - ti,741624  # for 741624 (16-bit Input),
> +      - ti,7416374 # for 7416374 (16-bit Output).
> +
> +  reg:
> +    maxItems: 1
> +
> +  gpio-controller: true
> +
> +  '#gpio-cells':
> +    const: 2
> +    description: |
> +      The first cell is the pin number and
> +      the second cell is used to specify the GPIO polarity:
> +        0 = Active High,
> +        1 = Active Low.
> +
> +required:
> +  - compatible
> +  - reg
> +  - gpio-controller
> +  - '#gpio-cells'
> +
> +additionalProperties: true

This cannot be true.


Best regards,
Krzysztof