[PATCH v7 2/7] dt-bindings: net: add amlogic,t7-dwmac
From: Lucas Tanure
Date: Fri Nov 13 2026 - 11:05:23 EST
The T7 has the same ethernet glue as the G12A but needs two clocks of
its own. The controller reaches memory through a pipeline stage with
its own gate; nothing else claims it, so it is switched off as unused
and transfers never finish. The glue registers share a gate with the
MDIO multiplexer, which probes after the controller has programmed
them: the writes are lost and the port keeps the bootloader's delays.
With a newer core, a clock list of its own and delays that follow
ethernet-controller.yaml, the T7 gets a binding of its own: the PHY
adds the 2ns, and only the receive delay line offers fine tuning, so
only rx-internal-delay-ps is valid here.
Signed-off-by: Lucas Tanure <tanure@xxxxxxxxx>
---
.../bindings/net/amlogic,t7-dwmac.yaml | 112 ++++++++++++++++++
1 file changed, 112 insertions(+)
create mode 100644 Documentation/devicetree/bindings/net/amlogic,t7-dwmac.yaml
diff --git a/Documentation/devicetree/bindings/net/amlogic,t7-dwmac.yaml b/Documentation/devicetree/bindings/net/amlogic,t7-dwmac.yaml
new file mode 100644
index 000000000000..9b7c3864cd29
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/amlogic,t7-dwmac.yaml
@@ -0,0 +1,112 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/amlogic,t7-dwmac.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Amlogic T7 DWMAC Ethernet controller
+
+maintainers:
+ - Lucas Tanure <tanure@xxxxxxxxx>
+
+# The select keeps this schema from matching every "snps,dwmac-5.10a" node.
+select:
+ properties:
+ compatible:
+ contains:
+ const: amlogic,t7-dwmac
+ required:
+ - compatible
+
+allOf:
+ - $ref: snps,dwmac.yaml#
+
+properties:
+ compatible:
+ items:
+ - const: amlogic,t7-dwmac
+ - const: snps,dwmac-5.10a
+
+ reg:
+ items:
+ - description: registers of the DWMAC controller
+ - description: the glue registers PRG_ETH0 and PRG_ETH1
+
+ interrupts:
+ maxItems: 1
+
+ interrupt-names:
+ const: macirq
+
+ clocks:
+ items:
+ - description: GMAC main clock
+ - description: First parent clock of the internal mux
+ - description: Second parent clock of the internal mux
+ - description:
+ clock of the pipeline stage inserted in the bus path between
+ the controller and the DRAM. Without it, the controller cannot
+ complete DMA transfers.
+ - description:
+ APB clock of the glue registers PRG_ETH0 and PRG_ETH1.
+ Without it, they read as zero and ignore writes.
+
+ clock-names:
+ items:
+ - const: stmmaceth
+ - const: clkin0
+ - const: clkin1
+ - const: pipeline
+ - const: pclk
+
+ power-domains:
+ maxItems: 1
+
+ rx-internal-delay-ps:
+ description:
+ Fine tuning of the RX clock, added on top of the delays that
+ phy-mode describes. The PHY adds the 2ns RGMII delays, see
+ ethernet-controller.yaml.
+ default: 0
+ maximum: 3000
+ multipleOf: 200
+
+ # The TX clock has no fine tuning, its only step is a quarter of the
+ # clock period, the full 2ns at 1Gbit/s. The PHY adds the TX delay, so
+ # the property is not accepted.
+ tx-internal-delay-ps: false
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - interrupt-names
+ - clocks
+ - clock-names
+ - phy-mode
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/clock/amlogic,t7-peripherals-clkc.h>
+ #include <dt-bindings/clock/amlogic,t7-pll-clkc.h>
+ #include <dt-bindings/clock/amlogic,t7-scmi.h>
+ #include <dt-bindings/power/amlogic,t7-pwrc.h>
+
+ ethernet@fdc00000 {
+ compatible = "amlogic,t7-dwmac", "snps,dwmac-5.10a";
+ reg = <0xfdc00000 0x10000>, <0xfe024000 0x8>;
+ interrupts = <GIC_SPI 74 IRQ_TYPE_LEVEL_HIGH>;
+ interrupt-names = "macirq";
+ clocks = <&clkc_periphs CLKID_SYS_ETH>,
+ <&scmi_clk CLKID_FCLK_DIV2>,
+ <&mpll CLKID_MPLL2>,
+ <&clkc_periphs CLKID_SYS_AMPIPE_ETH>,
+ <&clkc_periphs CLKID_SYS_ETHPHY>;
+ clock-names = "stmmaceth", "clkin0", "clkin1", "pipeline", "pclk";
+ power-domains = <&pwrc PWRC_T7_ETH_ID>;
+ phy-mode = "rgmii-id";
+ };
--
2.56.1