Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: net: ethernet-phy: clarify when compatible must specify PHY ID

Change PHY ID description in ethernet-phy.yaml to clarify that a
PHY ID is required (may -> must) when the PHY requires special
initialization sequence.

Link: https://lore.kernel.org/netdev/20251026212026.GA2959311-robh@kernel.org/
Link: https://lore.kernel.org/netdev/aQIZvDt5gooZSTcp@debianbuilder/

Signed-off-by: Buday Csaba <buday.csaba@prolan.hu>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Reviewed-by: Andrew Lunn <andrew@lunn.ch>
Reviewed-by: Florian Fainelli <florian.fainelli@broadcom.com>
Link: https://patch.msgid.link/64c52d1a726944a68a308355433e8ef0f82c4240.1762157515.git.buday.csaba@prolan.hu
Signed-off-by: Jakub Kicinski <kuba@kernel.org>

authored by

Buday Csaba and committed by
Jakub Kicinski
e0c78fca f2143e28

+7 -3
+7 -3
Documentation/devicetree/bindings/net/ethernet-phy.yaml
··· 35 35 description: PHYs that implement IEEE802.3 clause 45 36 36 - pattern: "^ethernet-phy-id[a-f0-9]{4}\\.[a-f0-9]{4}$" 37 37 description: 38 - If the PHY reports an incorrect ID (or none at all) then the 39 - compatible list may contain an entry with the correct PHY ID 40 - in the above form. 38 + PHYs contain identification registers. These will be read to 39 + identify the PHY. If the PHY reports an incorrect ID, or the 40 + PHY requires a specific initialization sequence (like a 41 + particular order of clocks, resets, power supplies), in 42 + order to be able to read the ID registers, then the 43 + compatible list must contain an entry with the correct PHY 44 + ID in the above form. 41 45 The first group of digits is the 16 bit Phy Identifier 1 42 46 register, this is the chip vendor OUI bits 3:18. The 43 47 second group of digits is the Phy Identifier 2 register,