[PATCH v2 2/4] doc: bindings: use upstream bindings for aquantia phy

Beiyan Yun
2025-10-14T11:56:44Z

Prepare for the switch to upstream bindings and generic firmware loader,
remove reference to upstreamed bindings, also add a firmware-name example.

Signed-off-by: Beiyan Yun <root@infi.wang>

---

Changes in v2:
- New

doc/device-tree-bindings/net/aquantia-phy.txt | 15 +++------------
1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/doc/device-tree-bindings/net/aquantia-phy.txt b/doc/device-tree-bindings/net/aquantia-phy.txt
index 89ce61e05bb..80de0e8b158 100644
--- a/doc/device-tree-bindings/net/aquantia-phy.txt
+++ b/doc/device-tree-bindings/net/aquantia-phy.txt
@@ -1,25 +1,16 @@
PHY nodes for Aquantia devices.

This text describes properties that are applicable to Aquantia PHY nodes in
-addition to the bindings in phy.txt.
-
-Aquantia PHYs allow some flexibility in the way they are wired in a system,
-they allow MDI pins to be reversed, LEDs linked up in different weays, have an
-I2C slave interface that can be used for debug. Normally the configuration
-corresponding to these is driven by the PHY firmware with the downside that
-a custom firmware is needed for each integration of a PHY.
-Several optional bindings are defined that allow these configuration points to
-be driven by the PHY driver and reduce dependency on specific FW versions.
+addition to the bindings in upstream and phy.txt.

Optional properties:
-mdi-reversal: 0 or 1 indicating that reversal must be disabled/enabled.
- Firmware default is used if the property is missing.
smb-addr: I2C/SMBus address to use, firmware default is used if the property
is missing.

Example node:
phy@00 {
reg = <0x00>;
- mdi-reversal = <1>;
+ marvell,mdi-cfg-order = <1>;
smb-addr = <0x25>;
+ firmware-name = "aqr-firmware.cld";
};
--
2.47.3