xref: /openbmc/linux/drivers/net/phy/phy.c (revision 9d5dbfe0)
1 // SPDX-License-Identifier: GPL-2.0+
2 /* Framework for configuring and reading PHY devices
3  * Based on code in sungem_phy.c and gianfar_phy.c
4  *
5  * Author: Andy Fleming
6  *
7  * Copyright (c) 2004 Freescale Semiconductor, Inc.
8  * Copyright (c) 2006, 2007  Maciej W. Rozycki
9  */
10 
11 #include <linux/kernel.h>
12 #include <linux/string.h>
13 #include <linux/errno.h>
14 #include <linux/unistd.h>
15 #include <linux/interrupt.h>
16 #include <linux/delay.h>
17 #include <linux/netdevice.h>
18 #include <linux/netlink.h>
19 #include <linux/etherdevice.h>
20 #include <linux/skbuff.h>
21 #include <linux/mm.h>
22 #include <linux/module.h>
23 #include <linux/mii.h>
24 #include <linux/ethtool.h>
25 #include <linux/ethtool_netlink.h>
26 #include <linux/phy.h>
27 #include <linux/phy_led_triggers.h>
28 #include <linux/sfp.h>
29 #include <linux/workqueue.h>
30 #include <linux/mdio.h>
31 #include <linux/io.h>
32 #include <linux/uaccess.h>
33 #include <linux/atomic.h>
34 #include <linux/suspend.h>
35 #include <net/netlink.h>
36 #include <net/genetlink.h>
37 #include <net/sock.h>
38 
39 #define PHY_STATE_TIME	HZ
40 
41 #define PHY_STATE_STR(_state)			\
42 	case PHY_##_state:			\
43 		return __stringify(_state);	\
44 
45 static const char *phy_state_to_str(enum phy_state st)
46 {
47 	switch (st) {
48 	PHY_STATE_STR(DOWN)
49 	PHY_STATE_STR(READY)
50 	PHY_STATE_STR(UP)
51 	PHY_STATE_STR(RUNNING)
52 	PHY_STATE_STR(NOLINK)
53 	PHY_STATE_STR(CABLETEST)
54 	PHY_STATE_STR(HALTED)
55 	}
56 
57 	return NULL;
58 }
59 
60 static void phy_link_up(struct phy_device *phydev)
61 {
62 	phydev->phy_link_change(phydev, true);
63 	phy_led_trigger_change_speed(phydev);
64 }
65 
66 static void phy_link_down(struct phy_device *phydev)
67 {
68 	phydev->phy_link_change(phydev, false);
69 	phy_led_trigger_change_speed(phydev);
70 	WRITE_ONCE(phydev->link_down_events, phydev->link_down_events + 1);
71 }
72 
73 static const char *phy_pause_str(struct phy_device *phydev)
74 {
75 	bool local_pause, local_asym_pause;
76 
77 	if (phydev->autoneg == AUTONEG_DISABLE)
78 		goto no_pause;
79 
80 	local_pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
81 					phydev->advertising);
82 	local_asym_pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
83 					     phydev->advertising);
84 
85 	if (local_pause && phydev->pause)
86 		return "rx/tx";
87 
88 	if (local_asym_pause && phydev->asym_pause) {
89 		if (local_pause)
90 			return "rx";
91 		if (phydev->pause)
92 			return "tx";
93 	}
94 
95 no_pause:
96 	return "off";
97 }
98 
99 /**
100  * phy_print_status - Convenience function to print out the current phy status
101  * @phydev: the phy_device struct
102  */
103 void phy_print_status(struct phy_device *phydev)
104 {
105 	if (phydev->link) {
106 		netdev_info(phydev->attached_dev,
107 			"Link is Up - %s/%s %s- flow control %s\n",
108 			phy_speed_to_str(phydev->speed),
109 			phy_duplex_to_str(phydev->duplex),
110 			phydev->downshifted_rate ? "(downshifted) " : "",
111 			phy_pause_str(phydev));
112 	} else	{
113 		netdev_info(phydev->attached_dev, "Link is Down\n");
114 	}
115 }
116 EXPORT_SYMBOL(phy_print_status);
117 
118 /**
119  * phy_get_rate_matching - determine if rate matching is supported
120  * @phydev: The phy device to return rate matching for
121  * @iface: The interface mode to use
122  *
123  * This determines the type of rate matching (if any) that @phy supports
124  * using @iface. @iface may be %PHY_INTERFACE_MODE_NA to determine if any
125  * interface supports rate matching.
126  *
127  * Return: The type of rate matching @phy supports for @iface, or
128  *         %RATE_MATCH_NONE.
129  */
130 int phy_get_rate_matching(struct phy_device *phydev,
131 			  phy_interface_t iface)
132 {
133 	int ret = RATE_MATCH_NONE;
134 
135 	if (phydev->drv->get_rate_matching) {
136 		mutex_lock(&phydev->lock);
137 		ret = phydev->drv->get_rate_matching(phydev, iface);
138 		mutex_unlock(&phydev->lock);
139 	}
140 
141 	return ret;
142 }
143 EXPORT_SYMBOL_GPL(phy_get_rate_matching);
144 
145 /**
146  * phy_config_interrupt - configure the PHY device for the requested interrupts
147  * @phydev: the phy_device struct
148  * @interrupts: interrupt flags to configure for this @phydev
149  *
150  * Returns 0 on success or < 0 on error.
151  */
152 static int phy_config_interrupt(struct phy_device *phydev, bool interrupts)
153 {
154 	phydev->interrupts = interrupts ? 1 : 0;
155 	if (phydev->drv->config_intr)
156 		return phydev->drv->config_intr(phydev);
157 
158 	return 0;
159 }
160 
161 /**
162  * phy_restart_aneg - restart auto-negotiation
163  * @phydev: target phy_device struct
164  *
165  * Restart the autonegotiation on @phydev.  Returns >= 0 on success or
166  * negative errno on error.
167  */
168 int phy_restart_aneg(struct phy_device *phydev)
169 {
170 	int ret;
171 
172 	if (phydev->is_c45 && !(phydev->c45_ids.devices_in_package & BIT(0)))
173 		ret = genphy_c45_restart_aneg(phydev);
174 	else
175 		ret = genphy_restart_aneg(phydev);
176 
177 	return ret;
178 }
179 EXPORT_SYMBOL_GPL(phy_restart_aneg);
180 
181 /**
182  * phy_aneg_done - return auto-negotiation status
183  * @phydev: target phy_device struct
184  *
185  * Description: Return the auto-negotiation status from this @phydev
186  * Returns > 0 on success or < 0 on error. 0 means that auto-negotiation
187  * is still pending.
188  */
189 int phy_aneg_done(struct phy_device *phydev)
190 {
191 	if (phydev->drv && phydev->drv->aneg_done)
192 		return phydev->drv->aneg_done(phydev);
193 	else if (phydev->is_c45)
194 		return genphy_c45_aneg_done(phydev);
195 	else
196 		return genphy_aneg_done(phydev);
197 }
198 EXPORT_SYMBOL(phy_aneg_done);
199 
200 /**
201  * phy_find_valid - find a PHY setting that matches the requested parameters
202  * @speed: desired speed
203  * @duplex: desired duplex
204  * @supported: mask of supported link modes
205  *
206  * Locate a supported phy setting that is, in priority order:
207  * - an exact match for the specified speed and duplex mode
208  * - a match for the specified speed, or slower speed
209  * - the slowest supported speed
210  * Returns the matched phy_setting entry, or %NULL if no supported phy
211  * settings were found.
212  */
213 static const struct phy_setting *
214 phy_find_valid(int speed, int duplex, unsigned long *supported)
215 {
216 	return phy_lookup_setting(speed, duplex, supported, false);
217 }
218 
219 /**
220  * phy_supported_speeds - return all speeds currently supported by a phy device
221  * @phy: The phy device to return supported speeds of.
222  * @speeds: buffer to store supported speeds in.
223  * @size:   size of speeds buffer.
224  *
225  * Description: Returns the number of supported speeds, and fills the speeds
226  * buffer with the supported speeds. If speeds buffer is too small to contain
227  * all currently supported speeds, will return as many speeds as can fit.
228  */
229 unsigned int phy_supported_speeds(struct phy_device *phy,
230 				  unsigned int *speeds,
231 				  unsigned int size)
232 {
233 	return phy_speeds(speeds, size, phy->supported);
234 }
235 
236 /**
237  * phy_check_valid - check if there is a valid PHY setting which matches
238  *		     speed, duplex, and feature mask
239  * @speed: speed to match
240  * @duplex: duplex to match
241  * @features: A mask of the valid settings
242  *
243  * Description: Returns true if there is a valid setting, false otherwise.
244  */
245 static inline bool phy_check_valid(int speed, int duplex,
246 				   unsigned long *features)
247 {
248 	return !!phy_lookup_setting(speed, duplex, features, true);
249 }
250 
251 /**
252  * phy_sanitize_settings - make sure the PHY is set to supported speed and duplex
253  * @phydev: the target phy_device struct
254  *
255  * Description: Make sure the PHY is set to supported speeds and
256  *   duplexes.  Drop down by one in this order:  1000/FULL,
257  *   1000/HALF, 100/FULL, 100/HALF, 10/FULL, 10/HALF.
258  */
259 static void phy_sanitize_settings(struct phy_device *phydev)
260 {
261 	const struct phy_setting *setting;
262 
263 	setting = phy_find_valid(phydev->speed, phydev->duplex,
264 				 phydev->supported);
265 	if (setting) {
266 		phydev->speed = setting->speed;
267 		phydev->duplex = setting->duplex;
268 	} else {
269 		/* We failed to find anything (no supported speeds?) */
270 		phydev->speed = SPEED_UNKNOWN;
271 		phydev->duplex = DUPLEX_UNKNOWN;
272 	}
273 }
274 
275 void phy_ethtool_ksettings_get(struct phy_device *phydev,
276 			       struct ethtool_link_ksettings *cmd)
277 {
278 	mutex_lock(&phydev->lock);
279 	linkmode_copy(cmd->link_modes.supported, phydev->supported);
280 	linkmode_copy(cmd->link_modes.advertising, phydev->advertising);
281 	linkmode_copy(cmd->link_modes.lp_advertising, phydev->lp_advertising);
282 
283 	cmd->base.speed = phydev->speed;
284 	cmd->base.duplex = phydev->duplex;
285 	cmd->base.master_slave_cfg = phydev->master_slave_get;
286 	cmd->base.master_slave_state = phydev->master_slave_state;
287 	cmd->base.rate_matching = phydev->rate_matching;
288 	if (phydev->interface == PHY_INTERFACE_MODE_MOCA)
289 		cmd->base.port = PORT_BNC;
290 	else
291 		cmd->base.port = phydev->port;
292 	cmd->base.transceiver = phy_is_internal(phydev) ?
293 				XCVR_INTERNAL : XCVR_EXTERNAL;
294 	cmd->base.phy_address = phydev->mdio.addr;
295 	cmd->base.autoneg = phydev->autoneg;
296 	cmd->base.eth_tp_mdix_ctrl = phydev->mdix_ctrl;
297 	cmd->base.eth_tp_mdix = phydev->mdix;
298 	mutex_unlock(&phydev->lock);
299 }
300 EXPORT_SYMBOL(phy_ethtool_ksettings_get);
301 
302 /**
303  * phy_mii_ioctl - generic PHY MII ioctl interface
304  * @phydev: the phy_device struct
305  * @ifr: &struct ifreq for socket ioctl's
306  * @cmd: ioctl cmd to execute
307  *
308  * Note that this function is currently incompatible with the
309  * PHYCONTROL layer.  It changes registers without regard to
310  * current state.  Use at own risk.
311  */
312 int phy_mii_ioctl(struct phy_device *phydev, struct ifreq *ifr, int cmd)
313 {
314 	struct mii_ioctl_data *mii_data = if_mii(ifr);
315 	u16 val = mii_data->val_in;
316 	bool change_autoneg = false;
317 	int prtad, devad;
318 
319 	switch (cmd) {
320 	case SIOCGMIIPHY:
321 		mii_data->phy_id = phydev->mdio.addr;
322 		fallthrough;
323 
324 	case SIOCGMIIREG:
325 		if (mdio_phy_id_is_c45(mii_data->phy_id)) {
326 			prtad = mdio_phy_id_prtad(mii_data->phy_id);
327 			devad = mdio_phy_id_devad(mii_data->phy_id);
328 			mii_data->val_out = mdiobus_c45_read(
329 				phydev->mdio.bus, prtad, devad,
330 				mii_data->reg_num);
331 		} else {
332 			mii_data->val_out = mdiobus_read(
333 				phydev->mdio.bus, mii_data->phy_id,
334 				mii_data->reg_num);
335 		}
336 		return 0;
337 
338 	case SIOCSMIIREG:
339 		if (mdio_phy_id_is_c45(mii_data->phy_id)) {
340 			prtad = mdio_phy_id_prtad(mii_data->phy_id);
341 			devad = mdio_phy_id_devad(mii_data->phy_id);
342 		} else {
343 			prtad = mii_data->phy_id;
344 			devad = mii_data->reg_num;
345 		}
346 		if (prtad == phydev->mdio.addr) {
347 			switch (devad) {
348 			case MII_BMCR:
349 				if ((val & (BMCR_RESET | BMCR_ANENABLE)) == 0) {
350 					if (phydev->autoneg == AUTONEG_ENABLE)
351 						change_autoneg = true;
352 					phydev->autoneg = AUTONEG_DISABLE;
353 					if (val & BMCR_FULLDPLX)
354 						phydev->duplex = DUPLEX_FULL;
355 					else
356 						phydev->duplex = DUPLEX_HALF;
357 					if (val & BMCR_SPEED1000)
358 						phydev->speed = SPEED_1000;
359 					else if (val & BMCR_SPEED100)
360 						phydev->speed = SPEED_100;
361 					else phydev->speed = SPEED_10;
362 				} else {
363 					if (phydev->autoneg == AUTONEG_DISABLE)
364 						change_autoneg = true;
365 					phydev->autoneg = AUTONEG_ENABLE;
366 				}
367 				break;
368 			case MII_ADVERTISE:
369 				mii_adv_mod_linkmode_adv_t(phydev->advertising,
370 							   val);
371 				change_autoneg = true;
372 				break;
373 			case MII_CTRL1000:
374 				mii_ctrl1000_mod_linkmode_adv_t(phydev->advertising,
375 							        val);
376 				change_autoneg = true;
377 				break;
378 			default:
379 				/* do nothing */
380 				break;
381 			}
382 		}
383 
384 		if (mdio_phy_id_is_c45(mii_data->phy_id))
385 			mdiobus_c45_write(phydev->mdio.bus, prtad, devad,
386 					  mii_data->reg_num, val);
387 		else
388 			mdiobus_write(phydev->mdio.bus, prtad, devad, val);
389 
390 		if (prtad == phydev->mdio.addr &&
391 		    devad == MII_BMCR &&
392 		    val & BMCR_RESET)
393 			return phy_init_hw(phydev);
394 
395 		if (change_autoneg)
396 			return phy_start_aneg(phydev);
397 
398 		return 0;
399 
400 	case SIOCSHWTSTAMP:
401 		if (phydev->mii_ts && phydev->mii_ts->hwtstamp)
402 			return phydev->mii_ts->hwtstamp(phydev->mii_ts, ifr);
403 		fallthrough;
404 
405 	default:
406 		return -EOPNOTSUPP;
407 	}
408 }
409 EXPORT_SYMBOL(phy_mii_ioctl);
410 
411 /**
412  * phy_do_ioctl - generic ndo_eth_ioctl implementation
413  * @dev: the net_device struct
414  * @ifr: &struct ifreq for socket ioctl's
415  * @cmd: ioctl cmd to execute
416  */
417 int phy_do_ioctl(struct net_device *dev, struct ifreq *ifr, int cmd)
418 {
419 	if (!dev->phydev)
420 		return -ENODEV;
421 
422 	return phy_mii_ioctl(dev->phydev, ifr, cmd);
423 }
424 EXPORT_SYMBOL(phy_do_ioctl);
425 
426 /**
427  * phy_do_ioctl_running - generic ndo_eth_ioctl implementation but test first
428  *
429  * @dev: the net_device struct
430  * @ifr: &struct ifreq for socket ioctl's
431  * @cmd: ioctl cmd to execute
432  *
433  * Same as phy_do_ioctl, but ensures that net_device is running before
434  * handling the ioctl.
435  */
436 int phy_do_ioctl_running(struct net_device *dev, struct ifreq *ifr, int cmd)
437 {
438 	if (!netif_running(dev))
439 		return -ENODEV;
440 
441 	return phy_do_ioctl(dev, ifr, cmd);
442 }
443 EXPORT_SYMBOL(phy_do_ioctl_running);
444 
445 /**
446  * phy_queue_state_machine - Trigger the state machine to run soon
447  *
448  * @phydev: the phy_device struct
449  * @jiffies: Run the state machine after these jiffies
450  */
451 void phy_queue_state_machine(struct phy_device *phydev, unsigned long jiffies)
452 {
453 	mod_delayed_work(system_power_efficient_wq, &phydev->state_queue,
454 			 jiffies);
455 }
456 EXPORT_SYMBOL(phy_queue_state_machine);
457 
458 /**
459  * phy_trigger_machine - Trigger the state machine to run now
460  *
461  * @phydev: the phy_device struct
462  */
463 void phy_trigger_machine(struct phy_device *phydev)
464 {
465 	phy_queue_state_machine(phydev, 0);
466 }
467 EXPORT_SYMBOL(phy_trigger_machine);
468 
469 static void phy_abort_cable_test(struct phy_device *phydev)
470 {
471 	int err;
472 
473 	ethnl_cable_test_finished(phydev);
474 
475 	err = phy_init_hw(phydev);
476 	if (err)
477 		phydev_err(phydev, "Error while aborting cable test");
478 }
479 
480 /**
481  * phy_ethtool_get_strings - Get the statistic counter names
482  *
483  * @phydev: the phy_device struct
484  * @data: Where to put the strings
485  */
486 int phy_ethtool_get_strings(struct phy_device *phydev, u8 *data)
487 {
488 	if (!phydev->drv)
489 		return -EIO;
490 
491 	mutex_lock(&phydev->lock);
492 	phydev->drv->get_strings(phydev, data);
493 	mutex_unlock(&phydev->lock);
494 
495 	return 0;
496 }
497 EXPORT_SYMBOL(phy_ethtool_get_strings);
498 
499 /**
500  * phy_ethtool_get_sset_count - Get the number of statistic counters
501  *
502  * @phydev: the phy_device struct
503  */
504 int phy_ethtool_get_sset_count(struct phy_device *phydev)
505 {
506 	int ret;
507 
508 	if (!phydev->drv)
509 		return -EIO;
510 
511 	if (phydev->drv->get_sset_count &&
512 	    phydev->drv->get_strings &&
513 	    phydev->drv->get_stats) {
514 		mutex_lock(&phydev->lock);
515 		ret = phydev->drv->get_sset_count(phydev);
516 		mutex_unlock(&phydev->lock);
517 
518 		return ret;
519 	}
520 
521 	return -EOPNOTSUPP;
522 }
523 EXPORT_SYMBOL(phy_ethtool_get_sset_count);
524 
525 /**
526  * phy_ethtool_get_stats - Get the statistic counters
527  *
528  * @phydev: the phy_device struct
529  * @stats: What counters to get
530  * @data: Where to store the counters
531  */
532 int phy_ethtool_get_stats(struct phy_device *phydev,
533 			  struct ethtool_stats *stats, u64 *data)
534 {
535 	if (!phydev->drv)
536 		return -EIO;
537 
538 	mutex_lock(&phydev->lock);
539 	phydev->drv->get_stats(phydev, stats, data);
540 	mutex_unlock(&phydev->lock);
541 
542 	return 0;
543 }
544 EXPORT_SYMBOL(phy_ethtool_get_stats);
545 
546 /**
547  * phy_ethtool_get_plca_cfg - Get PLCA RS configuration
548  * @phydev: the phy_device struct
549  * @plca_cfg: where to store the retrieved configuration
550  *
551  * Retrieve the PLCA configuration from the PHY. Return 0 on success or a
552  * negative value if an error occurred.
553  */
554 int phy_ethtool_get_plca_cfg(struct phy_device *phydev,
555 			     struct phy_plca_cfg *plca_cfg)
556 {
557 	int ret;
558 
559 	if (!phydev->drv) {
560 		ret = -EIO;
561 		goto out;
562 	}
563 
564 	if (!phydev->drv->get_plca_cfg) {
565 		ret = -EOPNOTSUPP;
566 		goto out;
567 	}
568 
569 	mutex_lock(&phydev->lock);
570 	ret = phydev->drv->get_plca_cfg(phydev, plca_cfg);
571 
572 	mutex_unlock(&phydev->lock);
573 out:
574 	return ret;
575 }
576 
577 /**
578  * plca_check_valid - Check PLCA configuration before enabling
579  * @phydev: the phy_device struct
580  * @plca_cfg: current PLCA configuration
581  * @extack: extack for reporting useful error messages
582  *
583  * Checks whether the PLCA and PHY configuration are consistent and it is safe
584  * to enable PLCA. Returns 0 on success or a negative value if the PLCA or PHY
585  * configuration is not consistent.
586  */
587 static int plca_check_valid(struct phy_device *phydev,
588 			    const struct phy_plca_cfg *plca_cfg,
589 			    struct netlink_ext_ack *extack)
590 {
591 	int ret = 0;
592 
593 	if (!linkmode_test_bit(ETHTOOL_LINK_MODE_10baseT1S_P2MP_Half_BIT,
594 			       phydev->advertising)) {
595 		ret = -EOPNOTSUPP;
596 		NL_SET_ERR_MSG(extack,
597 			       "Point to Multi-Point mode is not enabled");
598 	} else if (plca_cfg->node_id >= 255) {
599 		NL_SET_ERR_MSG(extack, "PLCA node ID is not set");
600 		ret = -EINVAL;
601 	}
602 
603 	return ret;
604 }
605 
606 /**
607  * phy_ethtool_set_plca_cfg - Set PLCA RS configuration
608  * @phydev: the phy_device struct
609  * @plca_cfg: new PLCA configuration to apply
610  * @extack: extack for reporting useful error messages
611  *
612  * Sets the PLCA configuration in the PHY. Return 0 on success or a
613  * negative value if an error occurred.
614  */
615 int phy_ethtool_set_plca_cfg(struct phy_device *phydev,
616 			     const struct phy_plca_cfg *plca_cfg,
617 			     struct netlink_ext_ack *extack)
618 {
619 	struct phy_plca_cfg *curr_plca_cfg;
620 	int ret;
621 
622 	if (!phydev->drv) {
623 		ret = -EIO;
624 		goto out;
625 	}
626 
627 	if (!phydev->drv->set_plca_cfg ||
628 	    !phydev->drv->get_plca_cfg) {
629 		ret = -EOPNOTSUPP;
630 		goto out;
631 	}
632 
633 	curr_plca_cfg = kmalloc(sizeof(*curr_plca_cfg), GFP_KERNEL);
634 	if (!curr_plca_cfg) {
635 		ret = -ENOMEM;
636 		goto out;
637 	}
638 
639 	mutex_lock(&phydev->lock);
640 
641 	ret = phydev->drv->get_plca_cfg(phydev, curr_plca_cfg);
642 	if (ret)
643 		goto out_drv;
644 
645 	if (curr_plca_cfg->enabled < 0 && plca_cfg->enabled >= 0) {
646 		NL_SET_ERR_MSG(extack,
647 			       "PHY does not support changing the PLCA 'enable' attribute");
648 		ret = -EINVAL;
649 		goto out_drv;
650 	}
651 
652 	if (curr_plca_cfg->node_id < 0 && plca_cfg->node_id >= 0) {
653 		NL_SET_ERR_MSG(extack,
654 			       "PHY does not support changing the PLCA 'local node ID' attribute");
655 		ret = -EINVAL;
656 		goto out_drv;
657 	}
658 
659 	if (curr_plca_cfg->node_cnt < 0 && plca_cfg->node_cnt >= 0) {
660 		NL_SET_ERR_MSG(extack,
661 			       "PHY does not support changing the PLCA 'node count' attribute");
662 		ret = -EINVAL;
663 		goto out_drv;
664 	}
665 
666 	if (curr_plca_cfg->to_tmr < 0 && plca_cfg->to_tmr >= 0) {
667 		NL_SET_ERR_MSG(extack,
668 			       "PHY does not support changing the PLCA 'TO timer' attribute");
669 		ret = -EINVAL;
670 		goto out_drv;
671 	}
672 
673 	if (curr_plca_cfg->burst_cnt < 0 && plca_cfg->burst_cnt >= 0) {
674 		NL_SET_ERR_MSG(extack,
675 			       "PHY does not support changing the PLCA 'burst count' attribute");
676 		ret = -EINVAL;
677 		goto out_drv;
678 	}
679 
680 	if (curr_plca_cfg->burst_tmr < 0 && plca_cfg->burst_tmr >= 0) {
681 		NL_SET_ERR_MSG(extack,
682 			       "PHY does not support changing the PLCA 'burst timer' attribute");
683 		ret = -EINVAL;
684 		goto out_drv;
685 	}
686 
687 	// if enabling PLCA, perform a few sanity checks
688 	if (plca_cfg->enabled > 0) {
689 		// allow setting node_id concurrently with enabled
690 		if (plca_cfg->node_id >= 0)
691 			curr_plca_cfg->node_id = plca_cfg->node_id;
692 
693 		ret = plca_check_valid(phydev, curr_plca_cfg, extack);
694 		if (ret)
695 			goto out_drv;
696 	}
697 
698 	ret = phydev->drv->set_plca_cfg(phydev, plca_cfg);
699 
700 out_drv:
701 	kfree(curr_plca_cfg);
702 	mutex_unlock(&phydev->lock);
703 out:
704 	return ret;
705 }
706 
707 /**
708  * phy_ethtool_get_plca_status - Get PLCA RS status information
709  * @phydev: the phy_device struct
710  * @plca_st: where to store the retrieved status information
711  *
712  * Retrieve the PLCA status information from the PHY. Return 0 on success or a
713  * negative value if an error occurred.
714  */
715 int phy_ethtool_get_plca_status(struct phy_device *phydev,
716 				struct phy_plca_status *plca_st)
717 {
718 	int ret;
719 
720 	if (!phydev->drv) {
721 		ret = -EIO;
722 		goto out;
723 	}
724 
725 	if (!phydev->drv->get_plca_status) {
726 		ret = -EOPNOTSUPP;
727 		goto out;
728 	}
729 
730 	mutex_lock(&phydev->lock);
731 	ret = phydev->drv->get_plca_status(phydev, plca_st);
732 
733 	mutex_unlock(&phydev->lock);
734 out:
735 	return ret;
736 }
737 
738 /**
739  * phy_start_cable_test - Start a cable test
740  *
741  * @phydev: the phy_device struct
742  * @extack: extack for reporting useful error messages
743  */
744 int phy_start_cable_test(struct phy_device *phydev,
745 			 struct netlink_ext_ack *extack)
746 {
747 	struct net_device *dev = phydev->attached_dev;
748 	int err = -ENOMEM;
749 
750 	if (!(phydev->drv &&
751 	      phydev->drv->cable_test_start &&
752 	      phydev->drv->cable_test_get_status)) {
753 		NL_SET_ERR_MSG(extack,
754 			       "PHY driver does not support cable testing");
755 		return -EOPNOTSUPP;
756 	}
757 
758 	mutex_lock(&phydev->lock);
759 	if (phydev->state == PHY_CABLETEST) {
760 		NL_SET_ERR_MSG(extack,
761 			       "PHY already performing a test");
762 		err = -EBUSY;
763 		goto out;
764 	}
765 
766 	if (phydev->state < PHY_UP ||
767 	    phydev->state > PHY_CABLETEST) {
768 		NL_SET_ERR_MSG(extack,
769 			       "PHY not configured. Try setting interface up");
770 		err = -EBUSY;
771 		goto out;
772 	}
773 
774 	err = ethnl_cable_test_alloc(phydev, ETHTOOL_MSG_CABLE_TEST_NTF);
775 	if (err)
776 		goto out;
777 
778 	/* Mark the carrier down until the test is complete */
779 	phy_link_down(phydev);
780 
781 	netif_testing_on(dev);
782 	err = phydev->drv->cable_test_start(phydev);
783 	if (err) {
784 		netif_testing_off(dev);
785 		phy_link_up(phydev);
786 		goto out_free;
787 	}
788 
789 	phydev->state = PHY_CABLETEST;
790 
791 	if (phy_polling_mode(phydev))
792 		phy_trigger_machine(phydev);
793 
794 	mutex_unlock(&phydev->lock);
795 
796 	return 0;
797 
798 out_free:
799 	ethnl_cable_test_free(phydev);
800 out:
801 	mutex_unlock(&phydev->lock);
802 
803 	return err;
804 }
805 EXPORT_SYMBOL(phy_start_cable_test);
806 
807 /**
808  * phy_start_cable_test_tdr - Start a raw TDR cable test
809  *
810  * @phydev: the phy_device struct
811  * @extack: extack for reporting useful error messages
812  * @config: Configuration of the test to run
813  */
814 int phy_start_cable_test_tdr(struct phy_device *phydev,
815 			     struct netlink_ext_ack *extack,
816 			     const struct phy_tdr_config *config)
817 {
818 	struct net_device *dev = phydev->attached_dev;
819 	int err = -ENOMEM;
820 
821 	if (!(phydev->drv &&
822 	      phydev->drv->cable_test_tdr_start &&
823 	      phydev->drv->cable_test_get_status)) {
824 		NL_SET_ERR_MSG(extack,
825 			       "PHY driver does not support cable test TDR");
826 		return -EOPNOTSUPP;
827 	}
828 
829 	mutex_lock(&phydev->lock);
830 	if (phydev->state == PHY_CABLETEST) {
831 		NL_SET_ERR_MSG(extack,
832 			       "PHY already performing a test");
833 		err = -EBUSY;
834 		goto out;
835 	}
836 
837 	if (phydev->state < PHY_UP ||
838 	    phydev->state > PHY_CABLETEST) {
839 		NL_SET_ERR_MSG(extack,
840 			       "PHY not configured. Try setting interface up");
841 		err = -EBUSY;
842 		goto out;
843 	}
844 
845 	err = ethnl_cable_test_alloc(phydev, ETHTOOL_MSG_CABLE_TEST_TDR_NTF);
846 	if (err)
847 		goto out;
848 
849 	/* Mark the carrier down until the test is complete */
850 	phy_link_down(phydev);
851 
852 	netif_testing_on(dev);
853 	err = phydev->drv->cable_test_tdr_start(phydev, config);
854 	if (err) {
855 		netif_testing_off(dev);
856 		phy_link_up(phydev);
857 		goto out_free;
858 	}
859 
860 	phydev->state = PHY_CABLETEST;
861 
862 	if (phy_polling_mode(phydev))
863 		phy_trigger_machine(phydev);
864 
865 	mutex_unlock(&phydev->lock);
866 
867 	return 0;
868 
869 out_free:
870 	ethnl_cable_test_free(phydev);
871 out:
872 	mutex_unlock(&phydev->lock);
873 
874 	return err;
875 }
876 EXPORT_SYMBOL(phy_start_cable_test_tdr);
877 
878 int phy_config_aneg(struct phy_device *phydev)
879 {
880 	if (phydev->drv->config_aneg)
881 		return phydev->drv->config_aneg(phydev);
882 
883 	/* Clause 45 PHYs that don't implement Clause 22 registers are not
884 	 * allowed to call genphy_config_aneg()
885 	 */
886 	if (phydev->is_c45 && !(phydev->c45_ids.devices_in_package & BIT(0)))
887 		return genphy_c45_config_aneg(phydev);
888 
889 	return genphy_config_aneg(phydev);
890 }
891 EXPORT_SYMBOL(phy_config_aneg);
892 
893 /**
894  * phy_check_link_status - check link status and set state accordingly
895  * @phydev: the phy_device struct
896  *
897  * Description: Check for link and whether autoneg was triggered / is running
898  * and set state accordingly
899  */
900 static int phy_check_link_status(struct phy_device *phydev)
901 {
902 	int err;
903 
904 	lockdep_assert_held(&phydev->lock);
905 
906 	/* Keep previous state if loopback is enabled because some PHYs
907 	 * report that Link is Down when loopback is enabled.
908 	 */
909 	if (phydev->loopback_enabled)
910 		return 0;
911 
912 	err = phy_read_status(phydev);
913 	if (err)
914 		return err;
915 
916 	if (phydev->link && phydev->state != PHY_RUNNING) {
917 		phy_check_downshift(phydev);
918 		phydev->state = PHY_RUNNING;
919 		phy_link_up(phydev);
920 	} else if (!phydev->link && phydev->state != PHY_NOLINK) {
921 		phydev->state = PHY_NOLINK;
922 		phy_link_down(phydev);
923 	}
924 
925 	return 0;
926 }
927 
928 /**
929  * _phy_start_aneg - start auto-negotiation for this PHY device
930  * @phydev: the phy_device struct
931  *
932  * Description: Sanitizes the settings (if we're not autonegotiating
933  *   them), and then calls the driver's config_aneg function.
934  *   If the PHYCONTROL Layer is operating, we change the state to
935  *   reflect the beginning of Auto-negotiation or forcing.
936  */
937 static int _phy_start_aneg(struct phy_device *phydev)
938 {
939 	int err;
940 
941 	lockdep_assert_held(&phydev->lock);
942 
943 	if (!phydev->drv)
944 		return -EIO;
945 
946 	if (AUTONEG_DISABLE == phydev->autoneg)
947 		phy_sanitize_settings(phydev);
948 
949 	err = phy_config_aneg(phydev);
950 	if (err < 0)
951 		return err;
952 
953 	if (phy_is_started(phydev))
954 		err = phy_check_link_status(phydev);
955 
956 	return err;
957 }
958 
959 /**
960  * phy_start_aneg - start auto-negotiation for this PHY device
961  * @phydev: the phy_device struct
962  *
963  * Description: Sanitizes the settings (if we're not autonegotiating
964  *   them), and then calls the driver's config_aneg function.
965  *   If the PHYCONTROL Layer is operating, we change the state to
966  *   reflect the beginning of Auto-negotiation or forcing.
967  */
968 int phy_start_aneg(struct phy_device *phydev)
969 {
970 	int err;
971 
972 	mutex_lock(&phydev->lock);
973 	err = _phy_start_aneg(phydev);
974 	mutex_unlock(&phydev->lock);
975 
976 	return err;
977 }
978 EXPORT_SYMBOL(phy_start_aneg);
979 
980 static int phy_poll_aneg_done(struct phy_device *phydev)
981 {
982 	unsigned int retries = 100;
983 	int ret;
984 
985 	do {
986 		msleep(100);
987 		ret = phy_aneg_done(phydev);
988 	} while (!ret && --retries);
989 
990 	if (!ret)
991 		return -ETIMEDOUT;
992 
993 	return ret < 0 ? ret : 0;
994 }
995 
996 int phy_ethtool_ksettings_set(struct phy_device *phydev,
997 			      const struct ethtool_link_ksettings *cmd)
998 {
999 	__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);
1000 	u8 autoneg = cmd->base.autoneg;
1001 	u8 duplex = cmd->base.duplex;
1002 	u32 speed = cmd->base.speed;
1003 
1004 	if (cmd->base.phy_address != phydev->mdio.addr)
1005 		return -EINVAL;
1006 
1007 	linkmode_copy(advertising, cmd->link_modes.advertising);
1008 
1009 	/* We make sure that we don't pass unsupported values in to the PHY */
1010 	linkmode_and(advertising, advertising, phydev->supported);
1011 
1012 	/* Verify the settings we care about. */
1013 	if (autoneg != AUTONEG_ENABLE && autoneg != AUTONEG_DISABLE)
1014 		return -EINVAL;
1015 
1016 	if (autoneg == AUTONEG_ENABLE && linkmode_empty(advertising))
1017 		return -EINVAL;
1018 
1019 	if (autoneg == AUTONEG_DISABLE &&
1020 	    ((speed != SPEED_1000 &&
1021 	      speed != SPEED_100 &&
1022 	      speed != SPEED_10) ||
1023 	     (duplex != DUPLEX_HALF &&
1024 	      duplex != DUPLEX_FULL)))
1025 		return -EINVAL;
1026 
1027 	mutex_lock(&phydev->lock);
1028 	phydev->autoneg = autoneg;
1029 
1030 	if (autoneg == AUTONEG_DISABLE) {
1031 		phydev->speed = speed;
1032 		phydev->duplex = duplex;
1033 	}
1034 
1035 	linkmode_copy(phydev->advertising, advertising);
1036 
1037 	linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
1038 			 phydev->advertising, autoneg == AUTONEG_ENABLE);
1039 
1040 	phydev->master_slave_set = cmd->base.master_slave_cfg;
1041 	phydev->mdix_ctrl = cmd->base.eth_tp_mdix_ctrl;
1042 
1043 	/* Restart the PHY */
1044 	if (phy_is_started(phydev)) {
1045 		phydev->state = PHY_UP;
1046 		phy_trigger_machine(phydev);
1047 	} else {
1048 		_phy_start_aneg(phydev);
1049 	}
1050 
1051 	mutex_unlock(&phydev->lock);
1052 	return 0;
1053 }
1054 EXPORT_SYMBOL(phy_ethtool_ksettings_set);
1055 
1056 /**
1057  * phy_speed_down - set speed to lowest speed supported by both link partners
1058  * @phydev: the phy_device struct
1059  * @sync: perform action synchronously
1060  *
1061  * Description: Typically used to save energy when waiting for a WoL packet
1062  *
1063  * WARNING: Setting sync to false may cause the system being unable to suspend
1064  * in case the PHY generates an interrupt when finishing the autonegotiation.
1065  * This interrupt may wake up the system immediately after suspend.
1066  * Therefore use sync = false only if you're sure it's safe with the respective
1067  * network chip.
1068  */
1069 int phy_speed_down(struct phy_device *phydev, bool sync)
1070 {
1071 	__ETHTOOL_DECLARE_LINK_MODE_MASK(adv_tmp);
1072 	int ret;
1073 
1074 	if (phydev->autoneg != AUTONEG_ENABLE)
1075 		return 0;
1076 
1077 	linkmode_copy(adv_tmp, phydev->advertising);
1078 
1079 	ret = phy_speed_down_core(phydev);
1080 	if (ret)
1081 		return ret;
1082 
1083 	linkmode_copy(phydev->adv_old, adv_tmp);
1084 
1085 	if (linkmode_equal(phydev->advertising, adv_tmp))
1086 		return 0;
1087 
1088 	ret = phy_config_aneg(phydev);
1089 	if (ret)
1090 		return ret;
1091 
1092 	return sync ? phy_poll_aneg_done(phydev) : 0;
1093 }
1094 EXPORT_SYMBOL_GPL(phy_speed_down);
1095 
1096 /**
1097  * phy_speed_up - (re)set advertised speeds to all supported speeds
1098  * @phydev: the phy_device struct
1099  *
1100  * Description: Used to revert the effect of phy_speed_down
1101  */
1102 int phy_speed_up(struct phy_device *phydev)
1103 {
1104 	__ETHTOOL_DECLARE_LINK_MODE_MASK(adv_tmp);
1105 
1106 	if (phydev->autoneg != AUTONEG_ENABLE)
1107 		return 0;
1108 
1109 	if (linkmode_empty(phydev->adv_old))
1110 		return 0;
1111 
1112 	linkmode_copy(adv_tmp, phydev->advertising);
1113 	linkmode_copy(phydev->advertising, phydev->adv_old);
1114 	linkmode_zero(phydev->adv_old);
1115 
1116 	if (linkmode_equal(phydev->advertising, adv_tmp))
1117 		return 0;
1118 
1119 	return phy_config_aneg(phydev);
1120 }
1121 EXPORT_SYMBOL_GPL(phy_speed_up);
1122 
1123 /**
1124  * phy_start_machine - start PHY state machine tracking
1125  * @phydev: the phy_device struct
1126  *
1127  * Description: The PHY infrastructure can run a state machine
1128  *   which tracks whether the PHY is starting up, negotiating,
1129  *   etc.  This function starts the delayed workqueue which tracks
1130  *   the state of the PHY. If you want to maintain your own state machine,
1131  *   do not call this function.
1132  */
1133 void phy_start_machine(struct phy_device *phydev)
1134 {
1135 	phy_trigger_machine(phydev);
1136 }
1137 EXPORT_SYMBOL_GPL(phy_start_machine);
1138 
1139 /**
1140  * phy_stop_machine - stop the PHY state machine tracking
1141  * @phydev: target phy_device struct
1142  *
1143  * Description: Stops the state machine delayed workqueue, sets the
1144  *   state to UP (unless it wasn't up yet). This function must be
1145  *   called BEFORE phy_detach.
1146  */
1147 void phy_stop_machine(struct phy_device *phydev)
1148 {
1149 	cancel_delayed_work_sync(&phydev->state_queue);
1150 
1151 	mutex_lock(&phydev->lock);
1152 	if (phy_is_started(phydev))
1153 		phydev->state = PHY_UP;
1154 	mutex_unlock(&phydev->lock);
1155 }
1156 
1157 /**
1158  * phy_error - enter HALTED state for this PHY device
1159  * @phydev: target phy_device struct
1160  *
1161  * Moves the PHY to the HALTED state in response to a read
1162  * or write error, and tells the controller the link is down.
1163  * Must not be called from interrupt context, or while the
1164  * phydev->lock is held.
1165  */
1166 void phy_error(struct phy_device *phydev)
1167 {
1168 	WARN_ON(1);
1169 
1170 	mutex_lock(&phydev->lock);
1171 	phydev->state = PHY_HALTED;
1172 	mutex_unlock(&phydev->lock);
1173 
1174 	phy_trigger_machine(phydev);
1175 }
1176 EXPORT_SYMBOL(phy_error);
1177 
1178 /**
1179  * phy_disable_interrupts - Disable the PHY interrupts from the PHY side
1180  * @phydev: target phy_device struct
1181  */
1182 int phy_disable_interrupts(struct phy_device *phydev)
1183 {
1184 	/* Disable PHY interrupts */
1185 	return phy_config_interrupt(phydev, PHY_INTERRUPT_DISABLED);
1186 }
1187 
1188 /**
1189  * phy_interrupt - PHY interrupt handler
1190  * @irq: interrupt line
1191  * @phy_dat: phy_device pointer
1192  *
1193  * Description: Handle PHY interrupt
1194  */
1195 static irqreturn_t phy_interrupt(int irq, void *phy_dat)
1196 {
1197 	struct phy_device *phydev = phy_dat;
1198 	struct phy_driver *drv = phydev->drv;
1199 	irqreturn_t ret;
1200 
1201 	/* Wakeup interrupts may occur during a system sleep transition.
1202 	 * Postpone handling until the PHY has resumed.
1203 	 */
1204 	if (IS_ENABLED(CONFIG_PM_SLEEP) && phydev->irq_suspended) {
1205 		struct net_device *netdev = phydev->attached_dev;
1206 
1207 		if (netdev) {
1208 			struct device *parent = netdev->dev.parent;
1209 
1210 			if (netdev->wol_enabled)
1211 				pm_system_wakeup();
1212 			else if (device_may_wakeup(&netdev->dev))
1213 				pm_wakeup_dev_event(&netdev->dev, 0, true);
1214 			else if (parent && device_may_wakeup(parent))
1215 				pm_wakeup_dev_event(parent, 0, true);
1216 		}
1217 
1218 		phydev->irq_rerun = 1;
1219 		disable_irq_nosync(irq);
1220 		return IRQ_HANDLED;
1221 	}
1222 
1223 	mutex_lock(&phydev->lock);
1224 	ret = drv->handle_interrupt(phydev);
1225 	mutex_unlock(&phydev->lock);
1226 
1227 	return ret;
1228 }
1229 
1230 /**
1231  * phy_enable_interrupts - Enable the interrupts from the PHY side
1232  * @phydev: target phy_device struct
1233  */
1234 static int phy_enable_interrupts(struct phy_device *phydev)
1235 {
1236 	return phy_config_interrupt(phydev, PHY_INTERRUPT_ENABLED);
1237 }
1238 
1239 /**
1240  * phy_request_interrupt - request and enable interrupt for a PHY device
1241  * @phydev: target phy_device struct
1242  *
1243  * Description: Request and enable the interrupt for the given PHY.
1244  *   If this fails, then we set irq to PHY_POLL.
1245  *   This should only be called with a valid IRQ number.
1246  */
1247 void phy_request_interrupt(struct phy_device *phydev)
1248 {
1249 	int err;
1250 
1251 	err = request_threaded_irq(phydev->irq, NULL, phy_interrupt,
1252 				   IRQF_ONESHOT | IRQF_SHARED,
1253 				   phydev_name(phydev), phydev);
1254 	if (err) {
1255 		phydev_warn(phydev, "Error %d requesting IRQ %d, falling back to polling\n",
1256 			    err, phydev->irq);
1257 		phydev->irq = PHY_POLL;
1258 	} else {
1259 		if (phy_enable_interrupts(phydev)) {
1260 			phydev_warn(phydev, "Can't enable interrupt, falling back to polling\n");
1261 			phy_free_interrupt(phydev);
1262 			phydev->irq = PHY_POLL;
1263 		}
1264 	}
1265 }
1266 EXPORT_SYMBOL(phy_request_interrupt);
1267 
1268 /**
1269  * phy_free_interrupt - disable and free interrupt for a PHY device
1270  * @phydev: target phy_device struct
1271  *
1272  * Description: Disable and free the interrupt for the given PHY.
1273  *   This should only be called with a valid IRQ number.
1274  */
1275 void phy_free_interrupt(struct phy_device *phydev)
1276 {
1277 	phy_disable_interrupts(phydev);
1278 	free_irq(phydev->irq, phydev);
1279 }
1280 EXPORT_SYMBOL(phy_free_interrupt);
1281 
1282 /**
1283  * phy_stop - Bring down the PHY link, and stop checking the status
1284  * @phydev: target phy_device struct
1285  */
1286 void phy_stop(struct phy_device *phydev)
1287 {
1288 	struct net_device *dev = phydev->attached_dev;
1289 
1290 	if (!phy_is_started(phydev) && phydev->state != PHY_DOWN) {
1291 		WARN(1, "called from state %s\n",
1292 		     phy_state_to_str(phydev->state));
1293 		return;
1294 	}
1295 
1296 	mutex_lock(&phydev->lock);
1297 
1298 	if (phydev->state == PHY_CABLETEST) {
1299 		phy_abort_cable_test(phydev);
1300 		netif_testing_off(dev);
1301 	}
1302 
1303 	if (phydev->sfp_bus)
1304 		sfp_upstream_stop(phydev->sfp_bus);
1305 
1306 	phydev->state = PHY_HALTED;
1307 
1308 	mutex_unlock(&phydev->lock);
1309 
1310 	phy_state_machine(&phydev->state_queue.work);
1311 	phy_stop_machine(phydev);
1312 
1313 	/* Cannot call flush_scheduled_work() here as desired because
1314 	 * of rtnl_lock(), but PHY_HALTED shall guarantee irq handler
1315 	 * will not reenable interrupts.
1316 	 */
1317 }
1318 EXPORT_SYMBOL(phy_stop);
1319 
1320 /**
1321  * phy_start - start or restart a PHY device
1322  * @phydev: target phy_device struct
1323  *
1324  * Description: Indicates the attached device's readiness to
1325  *   handle PHY-related work.  Used during startup to start the
1326  *   PHY, and after a call to phy_stop() to resume operation.
1327  *   Also used to indicate the MDIO bus has cleared an error
1328  *   condition.
1329  */
1330 void phy_start(struct phy_device *phydev)
1331 {
1332 	mutex_lock(&phydev->lock);
1333 
1334 	if (phydev->state != PHY_READY && phydev->state != PHY_HALTED) {
1335 		WARN(1, "called from state %s\n",
1336 		     phy_state_to_str(phydev->state));
1337 		goto out;
1338 	}
1339 
1340 	if (phydev->sfp_bus)
1341 		sfp_upstream_start(phydev->sfp_bus);
1342 
1343 	/* if phy was suspended, bring the physical link up again */
1344 	__phy_resume(phydev);
1345 
1346 	phydev->state = PHY_UP;
1347 
1348 	phy_start_machine(phydev);
1349 out:
1350 	mutex_unlock(&phydev->lock);
1351 }
1352 EXPORT_SYMBOL(phy_start);
1353 
1354 /**
1355  * phy_state_machine - Handle the state machine
1356  * @work: work_struct that describes the work to be done
1357  */
1358 void phy_state_machine(struct work_struct *work)
1359 {
1360 	struct delayed_work *dwork = to_delayed_work(work);
1361 	struct phy_device *phydev =
1362 			container_of(dwork, struct phy_device, state_queue);
1363 	struct net_device *dev = phydev->attached_dev;
1364 	bool needs_aneg = false, do_suspend = false;
1365 	enum phy_state old_state;
1366 	bool finished = false;
1367 	int err = 0;
1368 
1369 	mutex_lock(&phydev->lock);
1370 
1371 	old_state = phydev->state;
1372 
1373 	switch (phydev->state) {
1374 	case PHY_DOWN:
1375 	case PHY_READY:
1376 		break;
1377 	case PHY_UP:
1378 		needs_aneg = true;
1379 
1380 		break;
1381 	case PHY_NOLINK:
1382 	case PHY_RUNNING:
1383 		err = phy_check_link_status(phydev);
1384 		break;
1385 	case PHY_CABLETEST:
1386 		err = phydev->drv->cable_test_get_status(phydev, &finished);
1387 		if (err) {
1388 			phy_abort_cable_test(phydev);
1389 			netif_testing_off(dev);
1390 			needs_aneg = true;
1391 			phydev->state = PHY_UP;
1392 			break;
1393 		}
1394 
1395 		if (finished) {
1396 			ethnl_cable_test_finished(phydev);
1397 			netif_testing_off(dev);
1398 			needs_aneg = true;
1399 			phydev->state = PHY_UP;
1400 		}
1401 		break;
1402 	case PHY_HALTED:
1403 		if (phydev->link) {
1404 			phydev->link = 0;
1405 			phy_link_down(phydev);
1406 		}
1407 		do_suspend = true;
1408 		break;
1409 	}
1410 
1411 	mutex_unlock(&phydev->lock);
1412 
1413 	if (needs_aneg)
1414 		err = phy_start_aneg(phydev);
1415 	else if (do_suspend)
1416 		phy_suspend(phydev);
1417 
1418 	if (err == -ENODEV)
1419 		return;
1420 
1421 	if (err < 0)
1422 		phy_error(phydev);
1423 
1424 	if (old_state != phydev->state) {
1425 		phydev_dbg(phydev, "PHY state change %s -> %s\n",
1426 			   phy_state_to_str(old_state),
1427 			   phy_state_to_str(phydev->state));
1428 		if (phydev->drv && phydev->drv->link_change_notify)
1429 			phydev->drv->link_change_notify(phydev);
1430 	}
1431 
1432 	/* Only re-schedule a PHY state machine change if we are polling the
1433 	 * PHY, if PHY_MAC_INTERRUPT is set, then we will be moving
1434 	 * between states from phy_mac_interrupt().
1435 	 *
1436 	 * In state PHY_HALTED the PHY gets suspended, so rescheduling the
1437 	 * state machine would be pointless and possibly error prone when
1438 	 * called from phy_disconnect() synchronously.
1439 	 */
1440 	mutex_lock(&phydev->lock);
1441 	if (phy_polling_mode(phydev) && phy_is_started(phydev))
1442 		phy_queue_state_machine(phydev, PHY_STATE_TIME);
1443 	mutex_unlock(&phydev->lock);
1444 }
1445 
1446 /**
1447  * phy_mac_interrupt - MAC says the link has changed
1448  * @phydev: phy_device struct with changed link
1449  *
1450  * The MAC layer is able to indicate there has been a change in the PHY link
1451  * status. Trigger the state machine and work a work queue.
1452  */
1453 void phy_mac_interrupt(struct phy_device *phydev)
1454 {
1455 	/* Trigger a state machine change */
1456 	phy_trigger_machine(phydev);
1457 }
1458 EXPORT_SYMBOL(phy_mac_interrupt);
1459 
1460 static void mmd_eee_adv_to_linkmode(unsigned long *advertising, u16 eee_adv)
1461 {
1462 	linkmode_zero(advertising);
1463 
1464 	if (eee_adv & MDIO_EEE_100TX)
1465 		linkmode_set_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT,
1466 				 advertising);
1467 	if (eee_adv & MDIO_EEE_1000T)
1468 		linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT,
1469 				 advertising);
1470 	if (eee_adv & MDIO_EEE_10GT)
1471 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseT_Full_BIT,
1472 				 advertising);
1473 	if (eee_adv & MDIO_EEE_1000KX)
1474 		linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseKX_Full_BIT,
1475 				 advertising);
1476 	if (eee_adv & MDIO_EEE_10GKX4)
1477 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKX4_Full_BIT,
1478 				 advertising);
1479 	if (eee_adv & MDIO_EEE_10GKR)
1480 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKR_Full_BIT,
1481 				 advertising);
1482 }
1483 
1484 /**
1485  * phy_init_eee - init and check the EEE feature
1486  * @phydev: target phy_device struct
1487  * @clk_stop_enable: PHY may stop the clock during LPI
1488  *
1489  * Description: it checks if the Energy-Efficient Ethernet (EEE)
1490  * is supported by looking at the MMD registers 3.20 and 7.60/61
1491  * and it programs the MMD register 3.0 setting the "Clock stop enable"
1492  * bit if required.
1493  */
1494 int phy_init_eee(struct phy_device *phydev, bool clk_stop_enable)
1495 {
1496 	if (!phydev->drv)
1497 		return -EIO;
1498 
1499 	/* According to 802.3az,the EEE is supported only in full duplex-mode.
1500 	 */
1501 	if (phydev->duplex == DUPLEX_FULL) {
1502 		__ETHTOOL_DECLARE_LINK_MODE_MASK(common);
1503 		__ETHTOOL_DECLARE_LINK_MODE_MASK(lp);
1504 		__ETHTOOL_DECLARE_LINK_MODE_MASK(adv);
1505 		int eee_lp, eee_cap, eee_adv;
1506 		int status;
1507 		u32 cap;
1508 
1509 		/* Read phy status to properly get the right settings */
1510 		status = phy_read_status(phydev);
1511 		if (status)
1512 			return status;
1513 
1514 		/* First check if the EEE ability is supported */
1515 		eee_cap = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1516 		if (eee_cap <= 0)
1517 			goto eee_exit_err;
1518 
1519 		cap = mmd_eee_cap_to_ethtool_sup_t(eee_cap);
1520 		if (!cap)
1521 			goto eee_exit_err;
1522 
1523 		/* Check which link settings negotiated and verify it in
1524 		 * the EEE advertising registers.
1525 		 */
1526 		eee_lp = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_LPABLE);
1527 		if (eee_lp <= 0)
1528 			goto eee_exit_err;
1529 
1530 		eee_adv = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1531 		if (eee_adv <= 0)
1532 			goto eee_exit_err;
1533 
1534 		mmd_eee_adv_to_linkmode(adv, eee_adv);
1535 		mmd_eee_adv_to_linkmode(lp, eee_lp);
1536 		linkmode_and(common, adv, lp);
1537 
1538 		if (!phy_check_valid(phydev->speed, phydev->duplex, common))
1539 			goto eee_exit_err;
1540 
1541 		if (clk_stop_enable)
1542 			/* Configure the PHY to stop receiving xMII
1543 			 * clock while it is signaling LPI.
1544 			 */
1545 			phy_set_bits_mmd(phydev, MDIO_MMD_PCS, MDIO_CTRL1,
1546 					 MDIO_PCS_CTRL1_CLKSTOP_EN);
1547 
1548 		return 0; /* EEE supported */
1549 	}
1550 eee_exit_err:
1551 	return -EPROTONOSUPPORT;
1552 }
1553 EXPORT_SYMBOL(phy_init_eee);
1554 
1555 /**
1556  * phy_get_eee_err - report the EEE wake error count
1557  * @phydev: target phy_device struct
1558  *
1559  * Description: it is to report the number of time where the PHY
1560  * failed to complete its normal wake sequence.
1561  */
1562 int phy_get_eee_err(struct phy_device *phydev)
1563 {
1564 	if (!phydev->drv)
1565 		return -EIO;
1566 
1567 	return phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_WK_ERR);
1568 }
1569 EXPORT_SYMBOL(phy_get_eee_err);
1570 
1571 /**
1572  * phy_ethtool_get_eee - get EEE supported and status
1573  * @phydev: target phy_device struct
1574  * @data: ethtool_eee data
1575  *
1576  * Description: it reportes the Supported/Advertisement/LP Advertisement
1577  * capabilities.
1578  */
1579 int phy_ethtool_get_eee(struct phy_device *phydev, struct ethtool_eee *data)
1580 {
1581 	int val;
1582 
1583 	if (!phydev->drv)
1584 		return -EIO;
1585 
1586 	/* Get Supported EEE */
1587 	val = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1588 	if (val < 0)
1589 		return val;
1590 	data->supported = mmd_eee_cap_to_ethtool_sup_t(val);
1591 
1592 	/* Get advertisement EEE */
1593 	val = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1594 	if (val < 0)
1595 		return val;
1596 	data->advertised = mmd_eee_adv_to_ethtool_adv_t(val);
1597 	data->eee_enabled = !!data->advertised;
1598 
1599 	/* Get LP advertisement EEE */
1600 	val = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_LPABLE);
1601 	if (val < 0)
1602 		return val;
1603 	data->lp_advertised = mmd_eee_adv_to_ethtool_adv_t(val);
1604 
1605 	data->eee_active = !!(data->advertised & data->lp_advertised);
1606 
1607 	return 0;
1608 }
1609 EXPORT_SYMBOL(phy_ethtool_get_eee);
1610 
1611 /**
1612  * phy_ethtool_set_eee - set EEE supported and status
1613  * @phydev: target phy_device struct
1614  * @data: ethtool_eee data
1615  *
1616  * Description: it is to program the Advertisement EEE register.
1617  */
1618 int phy_ethtool_set_eee(struct phy_device *phydev, struct ethtool_eee *data)
1619 {
1620 	int cap, old_adv, adv = 0, ret;
1621 
1622 	if (!phydev->drv)
1623 		return -EIO;
1624 
1625 	/* Get Supported EEE */
1626 	cap = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1627 	if (cap < 0)
1628 		return cap;
1629 
1630 	old_adv = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1631 	if (old_adv < 0)
1632 		return old_adv;
1633 
1634 	if (data->eee_enabled) {
1635 		adv = !data->advertised ? cap :
1636 		      ethtool_adv_to_mmd_eee_adv_t(data->advertised) & cap;
1637 		/* Mask prohibited EEE modes */
1638 		adv &= ~phydev->eee_broken_modes;
1639 	}
1640 
1641 	if (old_adv != adv) {
1642 		ret = phy_write_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV, adv);
1643 		if (ret < 0)
1644 			return ret;
1645 
1646 		/* Restart autonegotiation so the new modes get sent to the
1647 		 * link partner.
1648 		 */
1649 		if (phydev->autoneg == AUTONEG_ENABLE) {
1650 			ret = phy_restart_aneg(phydev);
1651 			if (ret < 0)
1652 				return ret;
1653 		}
1654 	}
1655 
1656 	return 0;
1657 }
1658 EXPORT_SYMBOL(phy_ethtool_set_eee);
1659 
1660 /**
1661  * phy_ethtool_set_wol - Configure Wake On LAN
1662  *
1663  * @phydev: target phy_device struct
1664  * @wol: Configuration requested
1665  */
1666 int phy_ethtool_set_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
1667 {
1668 	if (phydev->drv && phydev->drv->set_wol)
1669 		return phydev->drv->set_wol(phydev, wol);
1670 
1671 	return -EOPNOTSUPP;
1672 }
1673 EXPORT_SYMBOL(phy_ethtool_set_wol);
1674 
1675 /**
1676  * phy_ethtool_get_wol - Get the current Wake On LAN configuration
1677  *
1678  * @phydev: target phy_device struct
1679  * @wol: Store the current configuration here
1680  */
1681 void phy_ethtool_get_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
1682 {
1683 	if (phydev->drv && phydev->drv->get_wol)
1684 		phydev->drv->get_wol(phydev, wol);
1685 }
1686 EXPORT_SYMBOL(phy_ethtool_get_wol);
1687 
1688 int phy_ethtool_get_link_ksettings(struct net_device *ndev,
1689 				   struct ethtool_link_ksettings *cmd)
1690 {
1691 	struct phy_device *phydev = ndev->phydev;
1692 
1693 	if (!phydev)
1694 		return -ENODEV;
1695 
1696 	phy_ethtool_ksettings_get(phydev, cmd);
1697 
1698 	return 0;
1699 }
1700 EXPORT_SYMBOL(phy_ethtool_get_link_ksettings);
1701 
1702 int phy_ethtool_set_link_ksettings(struct net_device *ndev,
1703 				   const struct ethtool_link_ksettings *cmd)
1704 {
1705 	struct phy_device *phydev = ndev->phydev;
1706 
1707 	if (!phydev)
1708 		return -ENODEV;
1709 
1710 	return phy_ethtool_ksettings_set(phydev, cmd);
1711 }
1712 EXPORT_SYMBOL(phy_ethtool_set_link_ksettings);
1713 
1714 /**
1715  * phy_ethtool_nway_reset - Restart auto negotiation
1716  * @ndev: Network device to restart autoneg for
1717  */
1718 int phy_ethtool_nway_reset(struct net_device *ndev)
1719 {
1720 	struct phy_device *phydev = ndev->phydev;
1721 
1722 	if (!phydev)
1723 		return -ENODEV;
1724 
1725 	if (!phydev->drv)
1726 		return -EIO;
1727 
1728 	return phy_restart_aneg(phydev);
1729 }
1730 EXPORT_SYMBOL(phy_ethtool_nway_reset);
1731