dt-bindings: net: Convert APM XGene MDIO to DT schema

Convert the APM XGene MDIO bus binding to DT schema format. It's a
straight-forward conversion.

Reviewed-by: Jacob Keller <jacob.e.keller@intel.com>
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20250908231016.2070305-2-robh@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>

diff --git a/Documentation/devicetree/bindings/net/apm,xgene-mdio-rgmii.yaml b/Documentation/devicetree/bindings/net/apm,xgene-mdio-rgmii.yaml
new file mode 100644 (file)
index 0000000..470fb5f
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/apm,xgene-mdio-rgmii.yaml
@@ -0,0 +1,54 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/apm,xgene-mdio-rgmii.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: APM X-Gene SoC MDIO
+
+maintainers:
+  - Iyappan Subramanian <iyappan@os.amperecomputing.com>
+  - Keyur Chudgar <keyur@os.amperecomputing.com>
+  - Quan Nguyen <quan@os.amperecomputing.com>
+
+allOf:
+  - $ref: mdio.yaml#
+
+properties:
+  compatible:
+    enum:
+      - apm,xgene-mdio-rgmii
+      - apm,xgene-mdio-xfi
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    maxItems: 1
+
+unevaluatedProperties: false
+
+required:
+  - compatible
+  - reg
+  - clocks
+
+examples:
+  - |
+    mdio@17020000 {
+        compatible = "apm,xgene-mdio-rgmii";
+        #address-cells = <1>;
+        #size-cells = <0>;
+        reg = <0x17020000 0xd100>;
+        clocks = <&menetclk 0>;
+
+        phy@3 {
+            reg = <0x3>;
+        };
+        phy@4 {
+            reg = <0x4>;
+        };
+        phy@5 {
+            reg = <0x5>;
+        };
+    };

diff --git a/Documentation/devicetree/bindings/net/apm-xgene-mdio.txt b/Documentation/devicetree/bindings/net/apm-xgene-mdio.txt
deleted file mode 100644 (file)
index 78722d7..0000000
--- a/Documentation/devicetree/bindings/net/apm-xgene-mdio.txt
+++ /dev/null
@@ -1,37 +0,0 @@
-APM X-Gene SoC MDIO node
-
-MDIO node is defined to describe on-chip MDIO controller.
-
-Required properties:
-       - compatible: Must be "apm,xgene-mdio-rgmii" or "apm,xgene-mdio-xfi"
-       - #address-cells: Must be <1>.
-       - #size-cells: Must be <0>.
-       - reg: Address and length of the register set
-       - clocks: Reference to the clock entry
-
-For the phys on the mdio bus, there must be a node with the following fields:
-       - compatible: PHY identifier.  Please refer ./phy.txt for the format.
-       - reg: The ID number for the phy.
-
-Example:
-
-       mdio: mdio@17020000 {
-               compatible = "apm,xgene-mdio-rgmii";
-               #address-cells = <1>;
-               #size-cells = <0>;
-               reg = <0x0 0x17020000 0x0 0xd100>;
-               clocks = <&menetclk 0>;
-       };
-
-       /* Board-specific peripheral configurations */
-       &mdio {
-               menetphy: phy@3 {
-                       reg = <0x3>;
-               };
-               sgenet0phy: phy@4 {
-                       reg = <0x4>;
-               };
-               sgenet1phy: phy@5 {
-                       reg = <0x5>;
-               };
-       };

diff --git a/MAINTAINERS b/MAINTAINERS
index 6b82739e26c82ced996d162573ca38a920ec454d..c930a961435e08654dd116e448e999777ce909eb 100644 (file)
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1887,7 +1887,7 @@ M:        Keyur Chudgar <keyur@os.amperecomputing.com>
 M:     Quan Nguyen <quan@os.amperecomputing.com>
 S:     Maintained
 F:     Documentation/devicetree/bindings/net/apm,xgene-enet.yaml
-F:     Documentation/devicetree/bindings/net/apm-xgene-mdio.txt
+F:     Documentation/devicetree/bindings/net/apm,xgene-mdio-rgmii.yaml
 F:     drivers/net/ethernet/apm/xgene/
 F:     drivers/net/mdio/mdio-xgene.c