of: provide a binding for fixed link PHYs
authorThomas Petazzoni <thomas.petazzoni@free-electrons.com>
Fri, 16 May 2014 14:14:05 +0000 (16:14 +0200)
committerDavid S. Miller <davem@davemloft.net>
Fri, 16 May 2014 21:19:22 +0000 (17:19 -0400)
commit3be2a49e5c08d268f8af0dd4fe89a24ea8cdc339
tree83d32019dd08257b68821bafa59bbcd4e089ce76
parenta75951217472c522c324adb0a4de3ba69d656ef5
of: provide a binding for fixed link PHYs

Some Ethernet MACs have a "fixed link", and are not connected to a
normal MDIO-managed PHY device. For those situations, a Device Tree
binding allows to describe a "fixed link" using a special PHY node.

This patch adds:

 * A documentation for the fixed PHY Device Tree binding.

 * An of_phy_is_fixed_link() function that an Ethernet driver can call
   on its PHY phandle to find out whether it's a fixed link PHY or
   not. It should typically be used to know if
   of_phy_register_fixed_link() should be called.

 * An of_phy_register_fixed_link() function that instantiates the
   fixed PHY into the PHY subsystem, so that when the driver calls
   of_phy_connect(), the PHY device associated to the OF node will be
   found.

These two additional functions also support the old fixed-link Device
Tree binding used on PowerPC platforms, so that ultimately, the
network device drivers for those platforms could be converted to use
of_phy_is_fixed_link() and of_phy_register_fixed_link() instead of
of_phy_connect_fixed_link(), while keeping compatibility with their
respective Device Tree bindings.

Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Reviewed-by: Florian Fainelli <f.fainelli@gmail.com>
Tested-by: Florian Fainelli <f.fainelli@gmail.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
Documentation/devicetree/bindings/net/fixed-link.txt [new file with mode: 0644]
drivers/of/of_mdio.c
include/linux/of_mdio.h