1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * fwnode helpers for the MDIO (Ethernet PHY) API
  4 *
  5 * This file provides helper functions for extracting PHY device information
  6 * out of the fwnode and using it to populate an mii_bus.
  7 */
  8
  9#include <linux/acpi.h>
 10#include <linux/fwnode_mdio.h>
 11#include <linux/of.h>
 12#include <linux/phy.h>
 13
 14MODULE_AUTHOR("Calvin Johnson <calvin.johnson@oss.nxp.com>");
 15MODULE_LICENSE("GPL");
 16
 17static struct mii_timestamper *
 18fwnode_find_mii_timestamper(struct fwnode_handle *fwnode)
 19{
 20	struct of_phandle_args arg;
 21	int err;
 22
 23	if (is_acpi_node(fwnode))
 24		return NULL;
 25
 26	err = of_parse_phandle_with_fixed_args(to_of_node(fwnode),
 27					       "timestamper", 1, 0, &arg);
 28	if (err == -ENOENT)
 29		return NULL;
 30	else if (err)
 31		return ERR_PTR(err);
 32
 33	if (arg.args_count != 1)
 34		return ERR_PTR(-EINVAL);
 35
 36	return register_mii_timestamper(arg.np, arg.args[0]);
 37}
 38
 39int fwnode_mdiobus_phy_device_register(struct mii_bus *mdio,
 40				       struct phy_device *phy,
 41				       struct fwnode_handle *child, u32 addr)
 42{
 43	int rc;
 44
 45	rc = fwnode_irq_get(child, 0);
 46	if (rc == -EPROBE_DEFER)
 47		return rc;
 48
 49	if (rc > 0) {
 50		phy->irq = rc;
 51		mdio->irq[addr] = rc;
 52	} else {
 53		phy->irq = mdio->irq[addr];
 54	}
 55
 56	if (fwnode_property_read_bool(child, "broken-turn-around"))
 57		mdio->phy_ignore_ta_mask |= 1 << addr;
 58
 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);
 63
 64	/* Associate the fwnode with the device structure so it
 65	 * can be looked up later
 66	 */
 67	fwnode_handle_get(child);
 68	device_set_node(&phy->mdio.dev, child);
 69
 70	/* All data is now stored in the phy struct;
 71	 * register it
 72	 */
 73	rc = phy_device_register(phy);
 74	if (rc) {
 75		fwnode_handle_put(child);
 76		return rc;
 77	}
 78
 79	dev_dbg(&mdio->dev, "registered phy %p fwnode at address %i\n",
 80		child, addr);
 81	return 0;
 82}
 83EXPORT_SYMBOL(fwnode_mdiobus_phy_device_register);
 84
 85int fwnode_mdiobus_register_phy(struct mii_bus *bus,
 86				struct fwnode_handle *child, u32 addr)
 87{
 88	struct mii_timestamper *mii_ts = NULL;
 89	struct phy_device *phy;
 90	bool is_c45 = false;
 91	u32 phy_id;
 92	int rc;
 93
 94	mii_ts = fwnode_find_mii_timestamper(child);
 95	if (IS_ERR(mii_ts))
 96		return PTR_ERR(mii_ts);
 97
 98	rc = fwnode_property_match_string(child, "compatible",
 99					  "ethernet-phy-ieee802.3-c45");
100	if (rc >= 0)
101		is_c45 = true;
102
103	if (is_c45 || fwnode_get_phy_id(child, &phy_id))
104		phy = get_phy_device(bus, addr, is_c45);
105	else
106		phy = phy_device_create(bus, addr, phy_id, 0, NULL);
107	if (IS_ERR(phy)) {
108		unregister_mii_timestamper(mii_ts);
109		return PTR_ERR(phy);
110	}
111
112	if (is_acpi_node(child)) {
113		phy->irq = bus->irq[addr];
114
115		/* Associate the fwnode with the device structure so it
116		 * can be looked up later.
117		 */
118		phy->mdio.dev.fwnode = child;
119
120		/* All data is now stored in the phy struct, so register it */
121		rc = phy_device_register(phy);
122		if (rc) {
123			phy_device_free(phy);
124			fwnode_handle_put(phy->mdio.dev.fwnode);
125			return rc;
126		}
127	} else if (is_of_node(child)) {
128		rc = fwnode_mdiobus_phy_device_register(bus, phy, child, addr);
129		if (rc) {
130			unregister_mii_timestamper(mii_ts);
131			phy_device_free(phy);
132			return rc;
133		}
134	}
135
136	/* phy->mii_ts may already be defined by the PHY driver. A
137	 * mii_timestamper probed via the device tree will still have
138	 * precedence.
139	 */
140	if (mii_ts)
141		phy->mii_ts = mii_ts;
142	return 0;
143}
144EXPORT_SYMBOL(fwnode_mdiobus_register_phy);