[PATCH net-next 1/4] dt-bindings: net: phy: Add Allwinner AC300 EPHY binding

[Alastair D'Silva <alastair@d-silva.org>]

Add device tree binding documentation for the Allwinner AC300
Fast Ethernet Physical Layer (EPHY) co-packaged on Allwinner
H616 and H618 SoCs.

Assisted-by: LLM
Signed-off-by: Alastair D'Silva <alastair@d-silva.org>
---

Notes:
    Tested on Mellow Fly-C5 (Allwinner H618) under Armbian with Linux 6.18 and
    7.x kernels, verifying schema validation with dt_binding_check.

 .../net/allwinner,sun50i-h618-ac300-ephy.yaml | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/net/allwinner,sun50i-h618-ac300-ephy.yaml

diff --git a/Documentation/devicetree/bindings/net/allwinner,sun50i-h618-ac300-ephy.yaml b/Documentation/devicetree/bindings/net/allwinner,sun50i-h618-ac300-ephy.yaml
new file mode 100644
index 000000000000..a04416e78138
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/allwinner,sun50i-h618-ac300-ephy.yaml
@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/allwinner,sun50i-h618-ac300-ephy.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Allwinner AC300 Ethernet PHY
+
+maintainers:
+  - Alastair D'Silva <alastair@d-silva.org>
+
+description:
+  The AC300 is an integrated Fast Ethernet Physical Layer (EPHY) co-packaged
+  with Allwinner H616 and H618 SoCs, communicated with over MDIO.
+
+allOf:
+  - $ref: ethernet-phy.yaml#
+
+select:
+  properties:
+    compatible:
+      contains:
+        const: allwinner,sun50i-h618-ac300-ephy
+  required:
+    - compatible
+
+properties:
+  compatible:
+    items:
+      - const: ethernet-phy-id0044.1400
+      - const: allwinner,sun50i-h618-ac300-ephy
+      - const: ethernet-phy-ieee802.3-c22
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    minItems: 1
+    items:
+      - description: 25MHz reference clock from CCU
+      - description: 2MHz reference clock from PWM
+
+  clock-names:
+    minItems: 1
+    items:
+      - const: ephy
+      - const: pwm
+
+  nvmem-cells:
+    items:
+      - description: Calibration data from SID
+
+  nvmem-cell-names:
+    items:
+      - const: calibration
+
+required:
+  - compatible
+  - reg
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    mdio {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        ethernet-phy@0 {
+            compatible = "ethernet-phy-id0044.1400",
+                         "allwinner,sun50i-h618-ac300-ephy",
+                         "ethernet-phy-ieee802.3-c22";
+            reg = <0>;
+            clocks = <&ccu 81>, <&ac300_pwm_clk>;
+            clock-names = "ephy", "pwm";
+            nvmem-cells = <&ephy_calibration>;
+            nvmem-cell-names = "calibration";
+        };
+    };
-- 
2.53.0