xref: /linux/drivers/net/mdio/fwnode_mdio.c (revision e7d759f31ca295d589f7420719c311870bb3166f)
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 #include <linux/pse-pd/pse.h>
14 
15 MODULE_AUTHOR("Calvin Johnson <calvin.johnson@oss.nxp.com>");
16 MODULE_LICENSE("GPL");
17 MODULE_DESCRIPTION("FWNODE MDIO bus (Ethernet PHY) accessors");
18 
19 static struct pse_control *
20 fwnode_find_pse_control(struct fwnode_handle *fwnode)
21 {
22 	struct pse_control *psec;
23 	struct device_node *np;
24 
25 	if (!IS_ENABLED(CONFIG_PSE_CONTROLLER))
26 		return NULL;
27 
28 	np = to_of_node(fwnode);
29 	if (!np)
30 		return NULL;
31 
32 	psec = of_pse_control_get(np);
33 	if (PTR_ERR(psec) == -ENOENT)
34 		return NULL;
35 
36 	return psec;
37 }
38 
39 static struct mii_timestamper *
40 fwnode_find_mii_timestamper(struct fwnode_handle *fwnode)
41 {
42 	struct of_phandle_args arg;
43 	int err;
44 
45 	if (is_acpi_node(fwnode))
46 		return NULL;
47 
48 	err = of_parse_phandle_with_fixed_args(to_of_node(fwnode),
49 					       "timestamper", 1, 0, &arg);
50 	if (err == -ENOENT)
51 		return NULL;
52 	else if (err)
53 		return ERR_PTR(err);
54 
55 	if (arg.args_count != 1)
56 		return ERR_PTR(-EINVAL);
57 
58 	return register_mii_timestamper(arg.np, arg.args[0]);
59 }
60 
61 int fwnode_mdiobus_phy_device_register(struct mii_bus *mdio,
62 				       struct phy_device *phy,
63 				       struct fwnode_handle *child, u32 addr)
64 {
65 	int rc;
66 
67 	rc = fwnode_irq_get(child, 0);
68 	/* Don't wait forever if the IRQ provider doesn't become available,
69 	 * just fall back to poll mode
70 	 */
71 	if (rc == -EPROBE_DEFER)
72 		rc = driver_deferred_probe_check_state(&phy->mdio.dev);
73 	if (rc == -EPROBE_DEFER)
74 		return rc;
75 
76 	if (rc > 0) {
77 		phy->irq = rc;
78 		mdio->irq[addr] = rc;
79 	} else {
80 		phy->irq = mdio->irq[addr];
81 	}
82 
83 	if (fwnode_property_read_bool(child, "broken-turn-around"))
84 		mdio->phy_ignore_ta_mask |= 1 << addr;
85 
86 	fwnode_property_read_u32(child, "reset-assert-us",
87 				 &phy->mdio.reset_assert_delay);
88 	fwnode_property_read_u32(child, "reset-deassert-us",
89 				 &phy->mdio.reset_deassert_delay);
90 
91 	/* Associate the fwnode with the device structure so it
92 	 * can be looked up later
93 	 */
94 	fwnode_handle_get(child);
95 	device_set_node(&phy->mdio.dev, child);
96 
97 	/* All data is now stored in the phy struct;
98 	 * register it
99 	 */
100 	rc = phy_device_register(phy);
101 	if (rc) {
102 		device_set_node(&phy->mdio.dev, NULL);
103 		fwnode_handle_put(child);
104 		return rc;
105 	}
106 
107 	dev_dbg(&mdio->dev, "registered phy %p fwnode at address %i\n",
108 		child, addr);
109 	return 0;
110 }
111 EXPORT_SYMBOL(fwnode_mdiobus_phy_device_register);
112 
113 int fwnode_mdiobus_register_phy(struct mii_bus *bus,
114 				struct fwnode_handle *child, u32 addr)
115 {
116 	struct mii_timestamper *mii_ts = NULL;
117 	struct pse_control *psec = NULL;
118 	struct phy_device *phy;
119 	bool is_c45;
120 	u32 phy_id;
121 	int rc;
122 
123 	psec = fwnode_find_pse_control(child);
124 	if (IS_ERR(psec))
125 		return PTR_ERR(psec);
126 
127 	mii_ts = fwnode_find_mii_timestamper(child);
128 	if (IS_ERR(mii_ts)) {
129 		rc = PTR_ERR(mii_ts);
130 		goto clean_pse;
131 	}
132 
133 	is_c45 = fwnode_device_is_compatible(child, "ethernet-phy-ieee802.3-c45");
134 	if (is_c45 || fwnode_get_phy_id(child, &phy_id))
135 		phy = get_phy_device(bus, addr, is_c45);
136 	else
137 		phy = phy_device_create(bus, addr, phy_id, 0, NULL);
138 	if (IS_ERR(phy)) {
139 		rc = PTR_ERR(phy);
140 		goto clean_mii_ts;
141 	}
142 
143 	if (is_acpi_node(child)) {
144 		phy->irq = bus->irq[addr];
145 
146 		/* Associate the fwnode with the device structure so it
147 		 * can be looked up later.
148 		 */
149 		phy->mdio.dev.fwnode = fwnode_handle_get(child);
150 
151 		/* All data is now stored in the phy struct, so register it */
152 		rc = phy_device_register(phy);
153 		if (rc) {
154 			phy->mdio.dev.fwnode = NULL;
155 			fwnode_handle_put(child);
156 			goto clean_phy;
157 		}
158 	} else if (is_of_node(child)) {
159 		rc = fwnode_mdiobus_phy_device_register(bus, phy, child, addr);
160 		if (rc)
161 			goto clean_phy;
162 	}
163 
164 	phy->psec = psec;
165 
166 	/* phy->mii_ts may already be defined by the PHY driver. A
167 	 * mii_timestamper probed via the device tree will still have
168 	 * precedence.
169 	 */
170 	if (mii_ts)
171 		phy->mii_ts = mii_ts;
172 
173 	return 0;
174 
175 clean_phy:
176 	phy_device_free(phy);
177 clean_mii_ts:
178 	unregister_mii_timestamper(mii_ts);
179 clean_pse:
180 	pse_control_put(psec);
181 
182 	return rc;
183 }
184 EXPORT_SYMBOL(fwnode_mdiobus_register_phy);
185