1 // SPDX-License-Identifier: GPL-2.0-only
3 * fwnode helpers for the MDIO (Ethernet PHY) API
5 * This file provides helper functions for extracting PHY device information
6 * out of the fwnode and using it to populate an mii_bus.
9 #include <linux/acpi.h>
10 #include <linux/fwnode_mdio.h>
12 #include <linux/phy.h>
15 MODULE_LICENSE("GPL");
17 static struct mii_timestamper *
18 fwnode_find_mii_timestamper(struct fwnode_handle *fwnode)
20 struct of_phandle_args arg;
23 if (is_acpi_node(fwnode))
26 err = of_parse_phandle_with_fixed_args(to_of_node(fwnode),
27 "timestamper", 1, 0, &arg);
33 if (arg.args_count != 1)
34 return ERR_PTR(-EINVAL);
36 return register_mii_timestamper(arg.np, arg.args[0]);
39 int fwnode_mdiobus_phy_device_register(struct mii_bus *mdio,
40 struct phy_device *phy,
41 struct fwnode_handle *child, u32 addr)
45 rc = fwnode_irq_get(child, 0);
46 if (rc == -EPROBE_DEFER)
53 phy->irq = mdio->irq[addr];
56 if (fwnode_property_read_bool(child, "broken-turn-around"))
57 mdio->phy_ignore_ta_mask |= 1 << addr;
59 fwnode_property_read_u32(child, "reset-assert-us",
60 &phy->mdio.reset_assert_delay);
61 fwnode_property_read_u32(child, "reset-deassert-us",
62 &phy->mdio.reset_deassert_delay);
64 /* Associate the fwnode with the device structure so it
65 * can be looked up later
67 fwnode_handle_get(child);
68 device_set_node(&phy->mdio.dev, child);
70 /* All data is now stored in the phy struct;
73 rc = phy_device_register(phy);
75 fwnode_handle_put(child);
79 dev_dbg(&mdio->dev, "registered phy %p fwnode at address %i\n",
83 EXPORT_SYMBOL(fwnode_mdiobus_phy_device_register);
85 int fwnode_mdiobus_register_phy(struct mii_bus *bus,
86 struct fwnode_handle *child, u32 addr)
88 struct mii_timestamper *mii_ts = NULL;
89 struct phy_device *phy;
94 mii_ts = fwnode_find_mii_timestamper(child);
96 return PTR_ERR(mii_ts);
98 rc = fwnode_property_match_string(child, "compatible",
99 "ethernet-phy-ieee802.3-c45");
103 if (is_c45 || fwnode_get_phy_id(child, &phy_id))
104 phy = get_phy_device(bus, addr, is_c45);
106 phy = phy_device_create(bus, addr, phy_id, 0, NULL);
108 unregister_mii_timestamper(mii_ts);
112 if (is_acpi_node(child)) {
113 phy->irq = bus->irq[addr];
115 /* Associate the fwnode with the device structure so it
116 * can be looked up later.
118 phy->mdio.dev.fwnode = child;
120 /* All data is now stored in the phy struct, so register it */
121 rc = phy_device_register(phy);
123 phy_device_free(phy);
124 fwnode_handle_put(phy->mdio.dev.fwnode);
127 } else if (is_of_node(child)) {
128 rc = fwnode_mdiobus_phy_device_register(bus, phy, child, addr);
130 unregister_mii_timestamper(mii_ts);
131 phy_device_free(phy);
136 /* phy->mii_ts may already be defined by the PHY driver. A
137 * mii_timestamper probed via the device tree will still have
141 phy->mii_ts = mii_ts;
144 EXPORT_SYMBOL(fwnode_mdiobus_register_phy);