[PATCH v2 0/4] IPQ5018: Add and enable GEPHY RX and TX clocks

From: George Moussalem via B4 Relay

Date: Tue Jun 02 2026 - 02:56:00 EST


Greetings,

This patch series addresses a missing hardware description issue for the
Qualcomm IPQ5018 Internal Ethernet PHY, where the data paths fail to
function correctly unless their dedicated RX and TX clocks are
explicitly enabled.

Further testing revealed that leaving these clocks unmanaged by the
kernel, they were inadvertently left enabled by the bootloader / QSDK
platform, which masked the issue. Testing a fresh network configuration
path exposed that the data link fails to work without explicit software
gating.

To correctly introduce the required multi-clock properties, the IPQ5018
binding definition must first be split away from the shared
qca,ar803x.yaml schema. This isolation is required because ar803x
references the generic ethernet-phy.yaml, which enforces a strict
single-clock limit constraint.

- Patch 1: Moves the clocks property and its restriction out of the
generic ethernet-phy.yaml schema to individual bindings files
that need it to allow for PHYs that require multiple clocks.
- Patch 2: Add clocks property to qca,ar803x.yaml for the IPQ5018 PHY.
- Patch 3: Appends the missing RX/TX clock definitions into the IPQ5018
device tree before driver modification to avoid the driver
failing to probe.
- Patch 4: Updates the Qualcomm AT803x PHY driver framework to acquire,
enable, and gate these clocks upon link state changes for
runtime power optimization.

Signed-off-by: George Moussalem <george.moussalem@xxxxxxxxxxx>
---
Changes in v2:
- Added patch 1 to move the clocks property and its restriction out of
the generic ethernet-phy.yaml schema to individual bindings files that
need it to allow for PHYs that require multiple clocks.
- Reverted splitting out IPQ5018 from the shared qca,ar803x.yaml schema
and simply added the clocks and clock-names properties to the
definition of the IPQ5018 PHY.
- Corrected / updated commit title of patch 4 (qca,at803x -> at803x)
- Link to v1: https://lore.kernel.org/r/20260601-ipq5018-gephy-clocks-v1-0-2df8287712c3@xxxxxxxxxxx

---
George Moussalem (4):
dt-bindings: net: ethernet-phy: move clocks property to invidivual PHY bindings
dt-bindings: net: qca,ar803x: Add clocks property for IPQ5018 PHY
arm64: qcom: ipq5018: Add GEPHY RX and TX clocks
net: phy: at803x: add RX and TX clock management for IPQ5018 PHY

.../devicetree/bindings/net/ethernet-phy.yaml | 6 ------
.../devicetree/bindings/net/qca,ar803x.yaml | 14 +++++++++++++
.../devicetree/bindings/net/realtek,rtl82xx.yaml | 6 ++++++
arch/arm64/boot/dts/qcom/ipq5018.dtsi | 3 +++
drivers/net/phy/qcom/at803x.c | 23 ++++++++++++++++++++++
5 files changed, 46 insertions(+), 6 deletions(-)
---
base-commit: 7da7f07112610a520567421dd2ffcb51beaefbcc
change-id: 20260601-ipq5018-gephy-clocks-e8a2440178a0

Best regards,
--
George Moussalem <george.moussalem@xxxxxxxxxxx>