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

Documentation: net: phy: improve explanation when to specify the PHY ID

The old description basically read like "ethernet-phy-idAAAA.BBBB" can
be specified when you know the actual PHY ID. However, specifying this
has a side-effect: it forces Linux to bind to a certain PHY driver (the
one that matches the ID given in the compatible string), ignoring the ID
which is reported by the actual PHY.
Whenever a device is shipped with (multiple) different PHYs during it's
production lifetime then explicitly specifying
"ethernet-phy-idAAAA.BBBB" could break certain revisions of that device.

Signed-off-by: Martin Blumenstingl <martin.blumenstingl@googlemail.com>
Reviewed-by: Andrew Lunn <andrew@lunn.ch>
Acked-by: Rob Herring <robh@kernel.org>
Reviewed-by: Florian Fainelli <f.fainelli@gmail.com>
Signed-off-by: David S. Miller <davem@davemloft.net>

authored by

Martin Blumenstingl and committed by
David S. Miller
7630ea4b f39aac7e

+3 -2
+3 -2
Documentation/devicetree/bindings/net/phy.txt
··· 19 19 specifications. If neither of these are specified, the default is to 20 20 assume clause 22. 21 21 22 - If the phy's identifier is known then the list may contain an entry 23 - of the form: "ethernet-phy-idAAAA.BBBB" where 22 + If the PHY reports an incorrect ID (or none at all) then the 23 + "compatible" list may contain an entry with the correct PHY ID in the 24 + form: "ethernet-phy-idAAAA.BBBB" where 24 25 AAAA - The value of the 16 bit Phy Identifier 1 register as 25 26 4 hex digits. This is the chip vendor OUI bits 3:18 26 27 BBBB - The value of the 16 bit Phy Identifier 2 register as