• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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/etherdevice.h>
19 #include <linux/skbuff.h>
20 #include <linux/mm.h>
21 #include <linux/module.h>
22 #include <linux/mii.h>
23 #include <linux/ethtool.h>
24 #include <linux/phy.h>
25 #include <linux/phy_led_triggers.h>
26 #include <linux/workqueue.h>
27 #include <linux/mdio.h>
28 #include <linux/io.h>
29 #include <linux/uaccess.h>
30 #include <linux/atomic.h>
31 
32 #define PHY_STATE_TIME	HZ
33 
34 #define PHY_STATE_STR(_state)			\
35 	case PHY_##_state:			\
36 		return __stringify(_state);	\
37 
phy_state_to_str(enum phy_state st)38 static const char *phy_state_to_str(enum phy_state st)
39 {
40 	switch (st) {
41 	PHY_STATE_STR(DOWN)
42 	PHY_STATE_STR(READY)
43 	PHY_STATE_STR(UP)
44 	PHY_STATE_STR(RUNNING)
45 	PHY_STATE_STR(NOLINK)
46 	PHY_STATE_STR(HALTED)
47 	}
48 
49 	return NULL;
50 }
51 
phy_link_up(struct phy_device * phydev)52 static void phy_link_up(struct phy_device *phydev)
53 {
54 	phydev->phy_link_change(phydev, true, true);
55 	phy_led_trigger_change_speed(phydev);
56 }
57 
phy_link_down(struct phy_device * phydev,bool do_carrier)58 static void phy_link_down(struct phy_device *phydev, bool do_carrier)
59 {
60 	phydev->phy_link_change(phydev, false, do_carrier);
61 	phy_led_trigger_change_speed(phydev);
62 }
63 
phy_pause_str(struct phy_device * phydev)64 static const char *phy_pause_str(struct phy_device *phydev)
65 {
66 	bool local_pause, local_asym_pause;
67 
68 	if (phydev->autoneg == AUTONEG_DISABLE)
69 		goto no_pause;
70 
71 	local_pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
72 					phydev->advertising);
73 	local_asym_pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
74 					     phydev->advertising);
75 
76 	if (local_pause && phydev->pause)
77 		return "rx/tx";
78 
79 	if (local_asym_pause && phydev->asym_pause) {
80 		if (local_pause)
81 			return "rx";
82 		if (phydev->pause)
83 			return "tx";
84 	}
85 
86 no_pause:
87 	return "off";
88 }
89 
90 /**
91  * phy_print_status - Convenience function to print out the current phy status
92  * @phydev: the phy_device struct
93  */
phy_print_status(struct phy_device * phydev)94 void phy_print_status(struct phy_device *phydev)
95 {
96 	if (phydev->link) {
97 		netdev_info(phydev->attached_dev,
98 			"Link is Up - %s/%s - flow control %s\n",
99 			phy_speed_to_str(phydev->speed),
100 			phy_duplex_to_str(phydev->duplex),
101 			phy_pause_str(phydev));
102 	} else	{
103 		netdev_info(phydev->attached_dev, "Link is Down\n");
104 	}
105 }
106 EXPORT_SYMBOL(phy_print_status);
107 
108 /**
109  * phy_clear_interrupt - Ack the phy device's interrupt
110  * @phydev: the phy_device struct
111  *
112  * If the @phydev driver has an ack_interrupt function, call it to
113  * ack and clear the phy device's interrupt.
114  *
115  * Returns 0 on success or < 0 on error.
116  */
phy_clear_interrupt(struct phy_device * phydev)117 static int phy_clear_interrupt(struct phy_device *phydev)
118 {
119 	if (phydev->drv->ack_interrupt)
120 		return phydev->drv->ack_interrupt(phydev);
121 
122 	return 0;
123 }
124 
125 /**
126  * phy_config_interrupt - configure the PHY device for the requested interrupts
127  * @phydev: the phy_device struct
128  * @interrupts: interrupt flags to configure for this @phydev
129  *
130  * Returns 0 on success or < 0 on error.
131  */
phy_config_interrupt(struct phy_device * phydev,bool interrupts)132 static int phy_config_interrupt(struct phy_device *phydev, bool interrupts)
133 {
134 	phydev->interrupts = interrupts ? 1 : 0;
135 	if (phydev->drv->config_intr)
136 		return phydev->drv->config_intr(phydev);
137 
138 	return 0;
139 }
140 
141 /**
142  * phy_restart_aneg - restart auto-negotiation
143  * @phydev: target phy_device struct
144  *
145  * Restart the autonegotiation on @phydev.  Returns >= 0 on success or
146  * negative errno on error.
147  */
phy_restart_aneg(struct phy_device * phydev)148 int phy_restart_aneg(struct phy_device *phydev)
149 {
150 	int ret;
151 
152 	if (phydev->is_c45 && !(phydev->c45_ids.devices_in_package & BIT(0)))
153 		ret = genphy_c45_restart_aneg(phydev);
154 	else
155 		ret = genphy_restart_aneg(phydev);
156 
157 	return ret;
158 }
159 EXPORT_SYMBOL_GPL(phy_restart_aneg);
160 
161 /**
162  * phy_aneg_done - return auto-negotiation status
163  * @phydev: target phy_device struct
164  *
165  * Description: Return the auto-negotiation status from this @phydev
166  * Returns > 0 on success or < 0 on error. 0 means that auto-negotiation
167  * is still pending.
168  */
phy_aneg_done(struct phy_device * phydev)169 int phy_aneg_done(struct phy_device *phydev)
170 {
171 	if (phydev->drv && phydev->drv->aneg_done)
172 		return phydev->drv->aneg_done(phydev);
173 	else if (phydev->is_c45)
174 		return genphy_c45_aneg_done(phydev);
175 	else
176 		return genphy_aneg_done(phydev);
177 }
178 EXPORT_SYMBOL(phy_aneg_done);
179 
180 /**
181  * phy_find_valid - find a PHY setting that matches the requested parameters
182  * @speed: desired speed
183  * @duplex: desired duplex
184  * @supported: mask of supported link modes
185  *
186  * Locate a supported phy setting that is, in priority order:
187  * - an exact match for the specified speed and duplex mode
188  * - a match for the specified speed, or slower speed
189  * - the slowest supported speed
190  * Returns the matched phy_setting entry, or %NULL if no supported phy
191  * settings were found.
192  */
193 static const struct phy_setting *
phy_find_valid(int speed,int duplex,unsigned long * supported)194 phy_find_valid(int speed, int duplex, unsigned long *supported)
195 {
196 	return phy_lookup_setting(speed, duplex, supported, false);
197 }
198 
199 /**
200  * phy_supported_speeds - return all speeds currently supported by a phy device
201  * @phy: The phy device to return supported speeds of.
202  * @speeds: buffer to store supported speeds in.
203  * @size:   size of speeds buffer.
204  *
205  * Description: Returns the number of supported speeds, and fills the speeds
206  * buffer with the supported speeds. If speeds buffer is too small to contain
207  * all currently supported speeds, will return as many speeds as can fit.
208  */
phy_supported_speeds(struct phy_device * phy,unsigned int * speeds,unsigned int size)209 unsigned int phy_supported_speeds(struct phy_device *phy,
210 				  unsigned int *speeds,
211 				  unsigned int size)
212 {
213 	return phy_speeds(speeds, size, phy->supported);
214 }
215 
216 /**
217  * phy_check_valid - check if there is a valid PHY setting which matches
218  *		     speed, duplex, and feature mask
219  * @speed: speed to match
220  * @duplex: duplex to match
221  * @features: A mask of the valid settings
222  *
223  * Description: Returns true if there is a valid setting, false otherwise.
224  */
phy_check_valid(int speed,int duplex,unsigned long * features)225 static inline bool phy_check_valid(int speed, int duplex,
226 				   unsigned long *features)
227 {
228 	return !!phy_lookup_setting(speed, duplex, features, true);
229 }
230 
231 /**
232  * phy_sanitize_settings - make sure the PHY is set to supported speed and duplex
233  * @phydev: the target phy_device struct
234  *
235  * Description: Make sure the PHY is set to supported speeds and
236  *   duplexes.  Drop down by one in this order:  1000/FULL,
237  *   1000/HALF, 100/FULL, 100/HALF, 10/FULL, 10/HALF.
238  */
phy_sanitize_settings(struct phy_device * phydev)239 static void phy_sanitize_settings(struct phy_device *phydev)
240 {
241 	const struct phy_setting *setting;
242 
243 	setting = phy_find_valid(phydev->speed, phydev->duplex,
244 				 phydev->supported);
245 	if (setting) {
246 		phydev->speed = setting->speed;
247 		phydev->duplex = setting->duplex;
248 	} else {
249 		/* We failed to find anything (no supported speeds?) */
250 		phydev->speed = SPEED_UNKNOWN;
251 		phydev->duplex = DUPLEX_UNKNOWN;
252 	}
253 }
254 
255 /**
256  * phy_ethtool_sset - generic ethtool sset function, handles all the details
257  * @phydev: target phy_device struct
258  * @cmd: ethtool_cmd
259  *
260  * A few notes about parameter checking:
261  *
262  * - We don't set port or transceiver, so we don't care what they
263  *   were set to.
264  * - phy_start_aneg() will make sure forced settings are sane, and
265  *   choose the next best ones from the ones selected, so we don't
266  *   care if ethtool tries to give us bad values.
267  */
phy_ethtool_sset(struct phy_device * phydev,struct ethtool_cmd * cmd)268 int phy_ethtool_sset(struct phy_device *phydev, struct ethtool_cmd *cmd)
269 {
270 	__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);
271 	u32 speed = ethtool_cmd_speed(cmd);
272 
273 	if (cmd->phy_address != phydev->mdio.addr)
274 		return -EINVAL;
275 
276 	/* We make sure that we don't pass unsupported values in to the PHY */
277 	ethtool_convert_legacy_u32_to_link_mode(advertising, cmd->advertising);
278 	linkmode_and(advertising, advertising, phydev->supported);
279 
280 	/* Verify the settings we care about. */
281 	if (cmd->autoneg != AUTONEG_ENABLE && cmd->autoneg != AUTONEG_DISABLE)
282 		return -EINVAL;
283 
284 	if (cmd->autoneg == AUTONEG_ENABLE && cmd->advertising == 0)
285 		return -EINVAL;
286 
287 	if (cmd->autoneg == AUTONEG_DISABLE &&
288 	    ((speed != SPEED_1000 &&
289 	      speed != SPEED_100 &&
290 	      speed != SPEED_10) ||
291 	     (cmd->duplex != DUPLEX_HALF &&
292 	      cmd->duplex != DUPLEX_FULL)))
293 		return -EINVAL;
294 
295 	phydev->autoneg = cmd->autoneg;
296 
297 	phydev->speed = speed;
298 
299 	linkmode_copy(phydev->advertising, advertising);
300 
301 	linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
302 			 phydev->advertising, AUTONEG_ENABLE == cmd->autoneg);
303 
304 	phydev->duplex = cmd->duplex;
305 
306 	phydev->mdix_ctrl = cmd->eth_tp_mdix_ctrl;
307 
308 	/* Restart the PHY */
309 	phy_start_aneg(phydev);
310 
311 	return 0;
312 }
313 EXPORT_SYMBOL(phy_ethtool_sset);
314 
phy_ethtool_ksettings_set(struct phy_device * phydev,const struct ethtool_link_ksettings * cmd)315 int phy_ethtool_ksettings_set(struct phy_device *phydev,
316 			      const struct ethtool_link_ksettings *cmd)
317 {
318 	__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);
319 	u8 autoneg = cmd->base.autoneg;
320 	u8 duplex = cmd->base.duplex;
321 	u32 speed = cmd->base.speed;
322 
323 	if (cmd->base.phy_address != phydev->mdio.addr)
324 		return -EINVAL;
325 
326 	linkmode_copy(advertising, cmd->link_modes.advertising);
327 
328 	/* We make sure that we don't pass unsupported values in to the PHY */
329 	linkmode_and(advertising, advertising, phydev->supported);
330 
331 	/* Verify the settings we care about. */
332 	if (autoneg != AUTONEG_ENABLE && autoneg != AUTONEG_DISABLE)
333 		return -EINVAL;
334 
335 	if (autoneg == AUTONEG_ENABLE && linkmode_empty(advertising))
336 		return -EINVAL;
337 
338 	if (autoneg == AUTONEG_DISABLE &&
339 	    ((speed != SPEED_1000 &&
340 	      speed != SPEED_100 &&
341 	      speed != SPEED_10) ||
342 	     (duplex != DUPLEX_HALF &&
343 	      duplex != DUPLEX_FULL)))
344 		return -EINVAL;
345 
346 	phydev->autoneg = autoneg;
347 
348 	phydev->speed = speed;
349 
350 	linkmode_copy(phydev->advertising, advertising);
351 
352 	linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
353 			 phydev->advertising, autoneg == AUTONEG_ENABLE);
354 
355 	phydev->duplex = duplex;
356 
357 	phydev->mdix_ctrl = cmd->base.eth_tp_mdix_ctrl;
358 
359 	/* Restart the PHY */
360 	phy_start_aneg(phydev);
361 
362 	return 0;
363 }
364 EXPORT_SYMBOL(phy_ethtool_ksettings_set);
365 
phy_ethtool_ksettings_get(struct phy_device * phydev,struct ethtool_link_ksettings * cmd)366 void phy_ethtool_ksettings_get(struct phy_device *phydev,
367 			       struct ethtool_link_ksettings *cmd)
368 {
369 	linkmode_copy(cmd->link_modes.supported, phydev->supported);
370 	linkmode_copy(cmd->link_modes.advertising, phydev->advertising);
371 	linkmode_copy(cmd->link_modes.lp_advertising, phydev->lp_advertising);
372 
373 	cmd->base.speed = phydev->speed;
374 	cmd->base.duplex = phydev->duplex;
375 	if (phydev->interface == PHY_INTERFACE_MODE_MOCA)
376 		cmd->base.port = PORT_BNC;
377 	else
378 		cmd->base.port = PORT_MII;
379 	cmd->base.transceiver = phy_is_internal(phydev) ?
380 				XCVR_INTERNAL : XCVR_EXTERNAL;
381 	cmd->base.phy_address = phydev->mdio.addr;
382 	cmd->base.autoneg = phydev->autoneg;
383 	cmd->base.eth_tp_mdix_ctrl = phydev->mdix_ctrl;
384 	cmd->base.eth_tp_mdix = phydev->mdix;
385 }
386 EXPORT_SYMBOL(phy_ethtool_ksettings_get);
387 
388 /**
389  * phy_mii_ioctl - generic PHY MII ioctl interface
390  * @phydev: the phy_device struct
391  * @ifr: &struct ifreq for socket ioctl's
392  * @cmd: ioctl cmd to execute
393  *
394  * Note that this function is currently incompatible with the
395  * PHYCONTROL layer.  It changes registers without regard to
396  * current state.  Use at own risk.
397  */
phy_mii_ioctl(struct phy_device * phydev,struct ifreq * ifr,int cmd)398 int phy_mii_ioctl(struct phy_device *phydev, struct ifreq *ifr, int cmd)
399 {
400 	struct mii_ioctl_data *mii_data = if_mii(ifr);
401 	u16 val = mii_data->val_in;
402 	bool change_autoneg = false;
403 	int prtad, devad;
404 
405 	switch (cmd) {
406 	case SIOCGMIIPHY:
407 		mii_data->phy_id = phydev->mdio.addr;
408 		/* fall through */
409 
410 	case SIOCGMIIREG:
411 		if (mdio_phy_id_is_c45(mii_data->phy_id)) {
412 			prtad = mdio_phy_id_prtad(mii_data->phy_id);
413 			devad = mdio_phy_id_devad(mii_data->phy_id);
414 			devad = MII_ADDR_C45 | devad << 16 | mii_data->reg_num;
415 		} else {
416 			prtad = mii_data->phy_id;
417 			devad = mii_data->reg_num;
418 		}
419 		mii_data->val_out = mdiobus_read(phydev->mdio.bus, prtad,
420 						 devad);
421 		return 0;
422 
423 	case SIOCSMIIREG:
424 		if (mdio_phy_id_is_c45(mii_data->phy_id)) {
425 			prtad = mdio_phy_id_prtad(mii_data->phy_id);
426 			devad = mdio_phy_id_devad(mii_data->phy_id);
427 			devad = MII_ADDR_C45 | devad << 16 | mii_data->reg_num;
428 		} else {
429 			prtad = mii_data->phy_id;
430 			devad = mii_data->reg_num;
431 		}
432 		if (prtad == phydev->mdio.addr) {
433 			switch (devad) {
434 			case MII_BMCR:
435 				if ((val & (BMCR_RESET | BMCR_ANENABLE)) == 0) {
436 					if (phydev->autoneg == AUTONEG_ENABLE)
437 						change_autoneg = true;
438 					phydev->autoneg = AUTONEG_DISABLE;
439 					if (val & BMCR_FULLDPLX)
440 						phydev->duplex = DUPLEX_FULL;
441 					else
442 						phydev->duplex = DUPLEX_HALF;
443 					if (val & BMCR_SPEED1000)
444 						phydev->speed = SPEED_1000;
445 					else if (val & BMCR_SPEED100)
446 						phydev->speed = SPEED_100;
447 					else phydev->speed = SPEED_10;
448 				}
449 				else {
450 					if (phydev->autoneg == AUTONEG_DISABLE)
451 						change_autoneg = true;
452 					phydev->autoneg = AUTONEG_ENABLE;
453 				}
454 				break;
455 			case MII_ADVERTISE:
456 				mii_adv_mod_linkmode_adv_t(phydev->advertising,
457 							   val);
458 				change_autoneg = true;
459 				break;
460 			case MII_CTRL1000:
461 				mii_ctrl1000_mod_linkmode_adv_t(phydev->advertising,
462 							        val);
463 				change_autoneg = true;
464 				break;
465 			default:
466 				/* do nothing */
467 				break;
468 			}
469 		}
470 
471 		mdiobus_write(phydev->mdio.bus, prtad, devad, val);
472 
473 		if (prtad == phydev->mdio.addr &&
474 		    devad == MII_BMCR &&
475 		    val & BMCR_RESET)
476 			return phy_init_hw(phydev);
477 
478 		if (change_autoneg)
479 			return phy_start_aneg(phydev);
480 
481 		return 0;
482 
483 	case SIOCSHWTSTAMP:
484 		if (phydev->drv && phydev->drv->hwtstamp)
485 			return phydev->drv->hwtstamp(phydev, ifr);
486 		/* fall through */
487 
488 	default:
489 		return -EOPNOTSUPP;
490 	}
491 }
492 EXPORT_SYMBOL(phy_mii_ioctl);
493 
phy_queue_state_machine(struct phy_device * phydev,unsigned long jiffies)494 void phy_queue_state_machine(struct phy_device *phydev, unsigned long jiffies)
495 {
496 	mod_delayed_work(system_power_efficient_wq, &phydev->state_queue,
497 			 jiffies);
498 }
499 EXPORT_SYMBOL(phy_queue_state_machine);
500 
phy_trigger_machine(struct phy_device * phydev)501 static void phy_trigger_machine(struct phy_device *phydev)
502 {
503 	phy_queue_state_machine(phydev, 0);
504 }
505 
phy_config_aneg(struct phy_device * phydev)506 static int phy_config_aneg(struct phy_device *phydev)
507 {
508 	if (phydev->drv->config_aneg)
509 		return phydev->drv->config_aneg(phydev);
510 
511 	/* Clause 45 PHYs that don't implement Clause 22 registers are not
512 	 * allowed to call genphy_config_aneg()
513 	 */
514 	if (phydev->is_c45 && !(phydev->c45_ids.devices_in_package & BIT(0)))
515 		return genphy_c45_config_aneg(phydev);
516 
517 	return genphy_config_aneg(phydev);
518 }
519 
520 /**
521  * phy_check_link_status - check link status and set state accordingly
522  * @phydev: the phy_device struct
523  *
524  * Description: Check for link and whether autoneg was triggered / is running
525  * and set state accordingly
526  */
phy_check_link_status(struct phy_device * phydev)527 static int phy_check_link_status(struct phy_device *phydev)
528 {
529 	int err;
530 
531 	WARN_ON(!mutex_is_locked(&phydev->lock));
532 
533 	/* Keep previous state if loopback is enabled because some PHYs
534 	 * report that Link is Down when loopback is enabled.
535 	 */
536 	if (phydev->loopback_enabled)
537 		return 0;
538 
539 	err = phy_read_status(phydev);
540 	if (err)
541 		return err;
542 
543 	if (phydev->link && phydev->state != PHY_RUNNING) {
544 		phydev->state = PHY_RUNNING;
545 		phy_link_up(phydev);
546 	} else if (!phydev->link && phydev->state != PHY_NOLINK) {
547 		phydev->state = PHY_NOLINK;
548 		phy_link_down(phydev, true);
549 	}
550 
551 	return 0;
552 }
553 
554 /**
555  * phy_start_aneg - start auto-negotiation for this PHY device
556  * @phydev: the phy_device struct
557  *
558  * Description: Sanitizes the settings (if we're not autonegotiating
559  *   them), and then calls the driver's config_aneg function.
560  *   If the PHYCONTROL Layer is operating, we change the state to
561  *   reflect the beginning of Auto-negotiation or forcing.
562  */
phy_start_aneg(struct phy_device * phydev)563 int phy_start_aneg(struct phy_device *phydev)
564 {
565 	int err;
566 
567 	if (!phydev->drv)
568 		return -EIO;
569 
570 	mutex_lock(&phydev->lock);
571 
572 	if (AUTONEG_DISABLE == phydev->autoneg)
573 		phy_sanitize_settings(phydev);
574 
575 	err = phy_config_aneg(phydev);
576 	if (err < 0)
577 		goto out_unlock;
578 
579 	if (phy_is_started(phydev))
580 		err = phy_check_link_status(phydev);
581 out_unlock:
582 	mutex_unlock(&phydev->lock);
583 
584 	return err;
585 }
586 EXPORT_SYMBOL(phy_start_aneg);
587 
phy_poll_aneg_done(struct phy_device * phydev)588 static int phy_poll_aneg_done(struct phy_device *phydev)
589 {
590 	unsigned int retries = 100;
591 	int ret;
592 
593 	do {
594 		msleep(100);
595 		ret = phy_aneg_done(phydev);
596 	} while (!ret && --retries);
597 
598 	if (!ret)
599 		return -ETIMEDOUT;
600 
601 	return ret < 0 ? ret : 0;
602 }
603 
604 /**
605  * phy_speed_down - set speed to lowest speed supported by both link partners
606  * @phydev: the phy_device struct
607  * @sync: perform action synchronously
608  *
609  * Description: Typically used to save energy when waiting for a WoL packet
610  *
611  * WARNING: Setting sync to false may cause the system being unable to suspend
612  * in case the PHY generates an interrupt when finishing the autonegotiation.
613  * This interrupt may wake up the system immediately after suspend.
614  * Therefore use sync = false only if you're sure it's safe with the respective
615  * network chip.
616  */
phy_speed_down(struct phy_device * phydev,bool sync)617 int phy_speed_down(struct phy_device *phydev, bool sync)
618 {
619 	__ETHTOOL_DECLARE_LINK_MODE_MASK(adv_tmp);
620 	int ret;
621 
622 	if (phydev->autoneg != AUTONEG_ENABLE)
623 		return 0;
624 
625 	linkmode_copy(adv_tmp, phydev->advertising);
626 
627 	ret = phy_speed_down_core(phydev);
628 	if (ret)
629 		return ret;
630 
631 	linkmode_copy(phydev->adv_old, adv_tmp);
632 
633 	if (linkmode_equal(phydev->advertising, adv_tmp))
634 		return 0;
635 
636 	ret = phy_config_aneg(phydev);
637 	if (ret)
638 		return ret;
639 
640 	return sync ? phy_poll_aneg_done(phydev) : 0;
641 }
642 EXPORT_SYMBOL_GPL(phy_speed_down);
643 
644 /**
645  * phy_speed_up - (re)set advertised speeds to all supported speeds
646  * @phydev: the phy_device struct
647  *
648  * Description: Used to revert the effect of phy_speed_down
649  */
phy_speed_up(struct phy_device * phydev)650 int phy_speed_up(struct phy_device *phydev)
651 {
652 	__ETHTOOL_DECLARE_LINK_MODE_MASK(adv_tmp);
653 
654 	if (phydev->autoneg != AUTONEG_ENABLE)
655 		return 0;
656 
657 	if (linkmode_empty(phydev->adv_old))
658 		return 0;
659 
660 	linkmode_copy(adv_tmp, phydev->advertising);
661 	linkmode_copy(phydev->advertising, phydev->adv_old);
662 	linkmode_zero(phydev->adv_old);
663 
664 	if (linkmode_equal(phydev->advertising, adv_tmp))
665 		return 0;
666 
667 	return phy_config_aneg(phydev);
668 }
669 EXPORT_SYMBOL_GPL(phy_speed_up);
670 
671 /**
672  * phy_start_machine - start PHY state machine tracking
673  * @phydev: the phy_device struct
674  *
675  * Description: The PHY infrastructure can run a state machine
676  *   which tracks whether the PHY is starting up, negotiating,
677  *   etc.  This function starts the delayed workqueue which tracks
678  *   the state of the PHY. If you want to maintain your own state machine,
679  *   do not call this function.
680  */
phy_start_machine(struct phy_device * phydev)681 void phy_start_machine(struct phy_device *phydev)
682 {
683 	phy_trigger_machine(phydev);
684 }
685 EXPORT_SYMBOL_GPL(phy_start_machine);
686 
687 /**
688  * phy_stop_machine - stop the PHY state machine tracking
689  * @phydev: target phy_device struct
690  *
691  * Description: Stops the state machine delayed workqueue, sets the
692  *   state to UP (unless it wasn't up yet). This function must be
693  *   called BEFORE phy_detach.
694  */
phy_stop_machine(struct phy_device * phydev)695 void phy_stop_machine(struct phy_device *phydev)
696 {
697 	cancel_delayed_work_sync(&phydev->state_queue);
698 
699 	mutex_lock(&phydev->lock);
700 	if (phy_is_started(phydev))
701 		phydev->state = PHY_UP;
702 	mutex_unlock(&phydev->lock);
703 }
704 
705 /**
706  * phy_error - enter HALTED state for this PHY device
707  * @phydev: target phy_device struct
708  *
709  * Moves the PHY to the HALTED state in response to a read
710  * or write error, and tells the controller the link is down.
711  * Must not be called from interrupt context, or while the
712  * phydev->lock is held.
713  */
phy_error(struct phy_device * phydev)714 static void phy_error(struct phy_device *phydev)
715 {
716 	WARN_ON(1);
717 
718 	mutex_lock(&phydev->lock);
719 	phydev->state = PHY_HALTED;
720 	mutex_unlock(&phydev->lock);
721 
722 	phy_trigger_machine(phydev);
723 }
724 
725 /**
726  * phy_disable_interrupts - Disable the PHY interrupts from the PHY side
727  * @phydev: target phy_device struct
728  */
phy_disable_interrupts(struct phy_device * phydev)729 static int phy_disable_interrupts(struct phy_device *phydev)
730 {
731 	int err;
732 
733 	/* Disable PHY interrupts */
734 	err = phy_config_interrupt(phydev, PHY_INTERRUPT_DISABLED);
735 	if (err)
736 		return err;
737 
738 	/* Clear the interrupt */
739 	return phy_clear_interrupt(phydev);
740 }
741 
742 /**
743  * phy_interrupt - PHY interrupt handler
744  * @irq: interrupt line
745  * @phy_dat: phy_device pointer
746  *
747  * Description: Handle PHY interrupt
748  */
phy_interrupt(int irq,void * phy_dat)749 static irqreturn_t phy_interrupt(int irq, void *phy_dat)
750 {
751 	struct phy_device *phydev = phy_dat;
752 
753 	if (phydev->drv->did_interrupt && !phydev->drv->did_interrupt(phydev))
754 		return IRQ_NONE;
755 
756 	if (phydev->drv->handle_interrupt) {
757 		if (phydev->drv->handle_interrupt(phydev))
758 			goto phy_err;
759 	} else {
760 		/* reschedule state queue work to run as soon as possible */
761 		phy_trigger_machine(phydev);
762 	}
763 
764 	if (phy_clear_interrupt(phydev))
765 		goto phy_err;
766 	return IRQ_HANDLED;
767 
768 phy_err:
769 	phy_error(phydev);
770 	return IRQ_NONE;
771 }
772 
773 /**
774  * phy_enable_interrupts - Enable the interrupts from the PHY side
775  * @phydev: target phy_device struct
776  */
phy_enable_interrupts(struct phy_device * phydev)777 static int phy_enable_interrupts(struct phy_device *phydev)
778 {
779 	int err = phy_clear_interrupt(phydev);
780 
781 	if (err < 0)
782 		return err;
783 
784 	return phy_config_interrupt(phydev, PHY_INTERRUPT_ENABLED);
785 }
786 
787 /**
788  * phy_request_interrupt - request and enable interrupt for a PHY device
789  * @phydev: target phy_device struct
790  *
791  * Description: Request and enable the interrupt for the given PHY.
792  *   If this fails, then we set irq to PHY_POLL.
793  *   This should only be called with a valid IRQ number.
794  */
phy_request_interrupt(struct phy_device * phydev)795 void phy_request_interrupt(struct phy_device *phydev)
796 {
797 	int err;
798 
799 	err = request_threaded_irq(phydev->irq, NULL, phy_interrupt,
800 				   IRQF_ONESHOT | IRQF_SHARED,
801 				   phydev_name(phydev), phydev);
802 	if (err) {
803 		phydev_warn(phydev, "Error %d requesting IRQ %d, falling back to polling\n",
804 			    err, phydev->irq);
805 		phydev->irq = PHY_POLL;
806 	} else {
807 		if (phy_enable_interrupts(phydev)) {
808 			phydev_warn(phydev, "Can't enable interrupt, falling back to polling\n");
809 			phy_free_interrupt(phydev);
810 			phydev->irq = PHY_POLL;
811 		}
812 	}
813 }
814 EXPORT_SYMBOL(phy_request_interrupt);
815 
816 /**
817  * phy_free_interrupt - disable and free interrupt for a PHY device
818  * @phydev: target phy_device struct
819  *
820  * Description: Disable and free the interrupt for the given PHY.
821  *   This should only be called with a valid IRQ number.
822  */
phy_free_interrupt(struct phy_device * phydev)823 void phy_free_interrupt(struct phy_device *phydev)
824 {
825 	phy_disable_interrupts(phydev);
826 	free_irq(phydev->irq, phydev);
827 }
828 EXPORT_SYMBOL(phy_free_interrupt);
829 
830 /**
831  * phy_stop - Bring down the PHY link, and stop checking the status
832  * @phydev: target phy_device struct
833  */
phy_stop(struct phy_device * phydev)834 void phy_stop(struct phy_device *phydev)
835 {
836 	if (!phy_is_started(phydev)) {
837 		WARN(1, "called from state %s\n",
838 		     phy_state_to_str(phydev->state));
839 		return;
840 	}
841 
842 	mutex_lock(&phydev->lock);
843 
844 	phydev->state = PHY_HALTED;
845 
846 	mutex_unlock(&phydev->lock);
847 
848 	phy_state_machine(&phydev->state_queue.work);
849 	phy_stop_machine(phydev);
850 
851 	/* Cannot call flush_scheduled_work() here as desired because
852 	 * of rtnl_lock(), but PHY_HALTED shall guarantee irq handler
853 	 * will not reenable interrupts.
854 	 */
855 }
856 EXPORT_SYMBOL(phy_stop);
857 
858 /**
859  * phy_start - start or restart a PHY device
860  * @phydev: target phy_device struct
861  *
862  * Description: Indicates the attached device's readiness to
863  *   handle PHY-related work.  Used during startup to start the
864  *   PHY, and after a call to phy_stop() to resume operation.
865  *   Also used to indicate the MDIO bus has cleared an error
866  *   condition.
867  */
phy_start(struct phy_device * phydev)868 void phy_start(struct phy_device *phydev)
869 {
870 	mutex_lock(&phydev->lock);
871 
872 	if (phydev->state != PHY_READY && phydev->state != PHY_HALTED) {
873 		WARN(1, "called from state %s\n",
874 		     phy_state_to_str(phydev->state));
875 		goto out;
876 	}
877 
878 	/* if phy was suspended, bring the physical link up again */
879 	__phy_resume(phydev);
880 
881 	phydev->state = PHY_UP;
882 
883 	phy_start_machine(phydev);
884 out:
885 	mutex_unlock(&phydev->lock);
886 }
887 EXPORT_SYMBOL(phy_start);
888 
889 /**
890  * phy_state_machine - Handle the state machine
891  * @work: work_struct that describes the work to be done
892  */
phy_state_machine(struct work_struct * work)893 void phy_state_machine(struct work_struct *work)
894 {
895 	struct delayed_work *dwork = to_delayed_work(work);
896 	struct phy_device *phydev =
897 			container_of(dwork, struct phy_device, state_queue);
898 	bool needs_aneg = false, do_suspend = false;
899 	enum phy_state old_state;
900 	int err = 0;
901 
902 	mutex_lock(&phydev->lock);
903 
904 	old_state = phydev->state;
905 
906 	switch (phydev->state) {
907 	case PHY_DOWN:
908 	case PHY_READY:
909 		break;
910 	case PHY_UP:
911 		needs_aneg = true;
912 
913 		break;
914 	case PHY_NOLINK:
915 	case PHY_RUNNING:
916 		err = phy_check_link_status(phydev);
917 		break;
918 	case PHY_HALTED:
919 		if (phydev->link) {
920 			phydev->link = 0;
921 			phy_link_down(phydev, true);
922 		}
923 		do_suspend = true;
924 		break;
925 	}
926 
927 	mutex_unlock(&phydev->lock);
928 
929 	if (needs_aneg)
930 		err = phy_start_aneg(phydev);
931 	else if (do_suspend)
932 		phy_suspend(phydev);
933 
934 	if (err < 0)
935 		phy_error(phydev);
936 
937 	if (old_state != phydev->state) {
938 		phydev_dbg(phydev, "PHY state change %s -> %s\n",
939 			   phy_state_to_str(old_state),
940 			   phy_state_to_str(phydev->state));
941 		if (phydev->drv && phydev->drv->link_change_notify)
942 			phydev->drv->link_change_notify(phydev);
943 	}
944 
945 	/* Only re-schedule a PHY state machine change if we are polling the
946 	 * PHY, if PHY_IGNORE_INTERRUPT is set, then we will be moving
947 	 * between states from phy_mac_interrupt().
948 	 *
949 	 * In state PHY_HALTED the PHY gets suspended, so rescheduling the
950 	 * state machine would be pointless and possibly error prone when
951 	 * called from phy_disconnect() synchronously.
952 	 */
953 	mutex_lock(&phydev->lock);
954 	if (phy_polling_mode(phydev) && phy_is_started(phydev))
955 		phy_queue_state_machine(phydev, PHY_STATE_TIME);
956 	mutex_unlock(&phydev->lock);
957 }
958 
959 /**
960  * phy_mac_interrupt - MAC says the link has changed
961  * @phydev: phy_device struct with changed link
962  *
963  * The MAC layer is able to indicate there has been a change in the PHY link
964  * status. Trigger the state machine and work a work queue.
965  */
phy_mac_interrupt(struct phy_device * phydev)966 void phy_mac_interrupt(struct phy_device *phydev)
967 {
968 	/* Trigger a state machine change */
969 	phy_trigger_machine(phydev);
970 }
971 EXPORT_SYMBOL(phy_mac_interrupt);
972 
mmd_eee_adv_to_linkmode(unsigned long * advertising,u16 eee_adv)973 static void mmd_eee_adv_to_linkmode(unsigned long *advertising, u16 eee_adv)
974 {
975 	linkmode_zero(advertising);
976 
977 	if (eee_adv & MDIO_EEE_100TX)
978 		linkmode_set_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT,
979 				 advertising);
980 	if (eee_adv & MDIO_EEE_1000T)
981 		linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT,
982 				 advertising);
983 	if (eee_adv & MDIO_EEE_10GT)
984 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseT_Full_BIT,
985 				 advertising);
986 	if (eee_adv & MDIO_EEE_1000KX)
987 		linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseKX_Full_BIT,
988 				 advertising);
989 	if (eee_adv & MDIO_EEE_10GKX4)
990 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKX4_Full_BIT,
991 				 advertising);
992 	if (eee_adv & MDIO_EEE_10GKR)
993 		linkmode_set_bit(ETHTOOL_LINK_MODE_10000baseKR_Full_BIT,
994 				 advertising);
995 }
996 
997 /**
998  * phy_init_eee - init and check the EEE feature
999  * @phydev: target phy_device struct
1000  * @clk_stop_enable: PHY may stop the clock during LPI
1001  *
1002  * Description: it checks if the Energy-Efficient Ethernet (EEE)
1003  * is supported by looking at the MMD registers 3.20 and 7.60/61
1004  * and it programs the MMD register 3.0 setting the "Clock stop enable"
1005  * bit if required.
1006  */
phy_init_eee(struct phy_device * phydev,bool clk_stop_enable)1007 int phy_init_eee(struct phy_device *phydev, bool clk_stop_enable)
1008 {
1009 	if (!phydev->drv)
1010 		return -EIO;
1011 
1012 	/* According to 802.3az,the EEE is supported only in full duplex-mode.
1013 	 */
1014 	if (phydev->duplex == DUPLEX_FULL) {
1015 		__ETHTOOL_DECLARE_LINK_MODE_MASK(common);
1016 		__ETHTOOL_DECLARE_LINK_MODE_MASK(lp);
1017 		__ETHTOOL_DECLARE_LINK_MODE_MASK(adv);
1018 		int eee_lp, eee_cap, eee_adv;
1019 		int status;
1020 		u32 cap;
1021 
1022 		/* Read phy status to properly get the right settings */
1023 		status = phy_read_status(phydev);
1024 		if (status)
1025 			return status;
1026 
1027 		/* First check if the EEE ability is supported */
1028 		eee_cap = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1029 		if (eee_cap <= 0)
1030 			goto eee_exit_err;
1031 
1032 		cap = mmd_eee_cap_to_ethtool_sup_t(eee_cap);
1033 		if (!cap)
1034 			goto eee_exit_err;
1035 
1036 		/* Check which link settings negotiated and verify it in
1037 		 * the EEE advertising registers.
1038 		 */
1039 		eee_lp = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_LPABLE);
1040 		if (eee_lp <= 0)
1041 			goto eee_exit_err;
1042 
1043 		eee_adv = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1044 		if (eee_adv <= 0)
1045 			goto eee_exit_err;
1046 
1047 		mmd_eee_adv_to_linkmode(adv, eee_adv);
1048 		mmd_eee_adv_to_linkmode(lp, eee_lp);
1049 		linkmode_and(common, adv, lp);
1050 
1051 		if (!phy_check_valid(phydev->speed, phydev->duplex, common))
1052 			goto eee_exit_err;
1053 
1054 		if (clk_stop_enable)
1055 			/* Configure the PHY to stop receiving xMII
1056 			 * clock while it is signaling LPI.
1057 			 */
1058 			phy_set_bits_mmd(phydev, MDIO_MMD_PCS, MDIO_CTRL1,
1059 					 MDIO_PCS_CTRL1_CLKSTOP_EN);
1060 
1061 		return 0; /* EEE supported */
1062 	}
1063 eee_exit_err:
1064 	return -EPROTONOSUPPORT;
1065 }
1066 EXPORT_SYMBOL(phy_init_eee);
1067 
1068 /**
1069  * phy_get_eee_err - report the EEE wake error count
1070  * @phydev: target phy_device struct
1071  *
1072  * Description: it is to report the number of time where the PHY
1073  * failed to complete its normal wake sequence.
1074  */
phy_get_eee_err(struct phy_device * phydev)1075 int phy_get_eee_err(struct phy_device *phydev)
1076 {
1077 	if (!phydev->drv)
1078 		return -EIO;
1079 
1080 	return phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_WK_ERR);
1081 }
1082 EXPORT_SYMBOL(phy_get_eee_err);
1083 
1084 /**
1085  * phy_ethtool_get_eee - get EEE supported and status
1086  * @phydev: target phy_device struct
1087  * @data: ethtool_eee data
1088  *
1089  * Description: it reportes the Supported/Advertisement/LP Advertisement
1090  * capabilities.
1091  */
phy_ethtool_get_eee(struct phy_device * phydev,struct ethtool_eee * data)1092 int phy_ethtool_get_eee(struct phy_device *phydev, struct ethtool_eee *data)
1093 {
1094 	int val;
1095 
1096 	if (!phydev->drv)
1097 		return -EIO;
1098 
1099 	/* Get Supported EEE */
1100 	val = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1101 	if (val < 0)
1102 		return val;
1103 	data->supported = mmd_eee_cap_to_ethtool_sup_t(val);
1104 
1105 	/* Get advertisement EEE */
1106 	val = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1107 	if (val < 0)
1108 		return val;
1109 	data->advertised = mmd_eee_adv_to_ethtool_adv_t(val);
1110 	data->eee_enabled = !!data->advertised;
1111 
1112 	/* Get LP advertisement EEE */
1113 	val = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_LPABLE);
1114 	if (val < 0)
1115 		return val;
1116 	data->lp_advertised = mmd_eee_adv_to_ethtool_adv_t(val);
1117 
1118 	data->eee_active = !!(data->advertised & data->lp_advertised);
1119 
1120 	return 0;
1121 }
1122 EXPORT_SYMBOL(phy_ethtool_get_eee);
1123 
1124 /**
1125  * phy_ethtool_set_eee - set EEE supported and status
1126  * @phydev: target phy_device struct
1127  * @data: ethtool_eee data
1128  *
1129  * Description: it is to program the Advertisement EEE register.
1130  */
phy_ethtool_set_eee(struct phy_device * phydev,struct ethtool_eee * data)1131 int phy_ethtool_set_eee(struct phy_device *phydev, struct ethtool_eee *data)
1132 {
1133 	int cap, old_adv, adv = 0, ret;
1134 
1135 	if (!phydev->drv)
1136 		return -EIO;
1137 
1138 	/* Get Supported EEE */
1139 	cap = phy_read_mmd(phydev, MDIO_MMD_PCS, MDIO_PCS_EEE_ABLE);
1140 	if (cap < 0)
1141 		return cap;
1142 
1143 	old_adv = phy_read_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV);
1144 	if (old_adv < 0)
1145 		return old_adv;
1146 
1147 	if (data->eee_enabled) {
1148 		adv = !data->advertised ? cap :
1149 		      ethtool_adv_to_mmd_eee_adv_t(data->advertised) & cap;
1150 		/* Mask prohibited EEE modes */
1151 		adv &= ~phydev->eee_broken_modes;
1152 	}
1153 
1154 	if (old_adv != adv) {
1155 		ret = phy_write_mmd(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV, adv);
1156 		if (ret < 0)
1157 			return ret;
1158 
1159 		/* Restart autonegotiation so the new modes get sent to the
1160 		 * link partner.
1161 		 */
1162 		ret = phy_restart_aneg(phydev);
1163 		if (ret < 0)
1164 			return ret;
1165 	}
1166 
1167 	return 0;
1168 }
1169 EXPORT_SYMBOL(phy_ethtool_set_eee);
1170 
phy_ethtool_set_wol(struct phy_device * phydev,struct ethtool_wolinfo * wol)1171 int phy_ethtool_set_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
1172 {
1173 	if (phydev->drv && phydev->drv->set_wol)
1174 		return phydev->drv->set_wol(phydev, wol);
1175 
1176 	return -EOPNOTSUPP;
1177 }
1178 EXPORT_SYMBOL(phy_ethtool_set_wol);
1179 
phy_ethtool_get_wol(struct phy_device * phydev,struct ethtool_wolinfo * wol)1180 void phy_ethtool_get_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
1181 {
1182 	if (phydev->drv && phydev->drv->get_wol)
1183 		phydev->drv->get_wol(phydev, wol);
1184 }
1185 EXPORT_SYMBOL(phy_ethtool_get_wol);
1186 
phy_ethtool_get_link_ksettings(struct net_device * ndev,struct ethtool_link_ksettings * cmd)1187 int phy_ethtool_get_link_ksettings(struct net_device *ndev,
1188 				   struct ethtool_link_ksettings *cmd)
1189 {
1190 	struct phy_device *phydev = ndev->phydev;
1191 
1192 	if (!phydev)
1193 		return -ENODEV;
1194 
1195 	phy_ethtool_ksettings_get(phydev, cmd);
1196 
1197 	return 0;
1198 }
1199 EXPORT_SYMBOL(phy_ethtool_get_link_ksettings);
1200 
phy_ethtool_set_link_ksettings(struct net_device * ndev,const struct ethtool_link_ksettings * cmd)1201 int phy_ethtool_set_link_ksettings(struct net_device *ndev,
1202 				   const struct ethtool_link_ksettings *cmd)
1203 {
1204 	struct phy_device *phydev = ndev->phydev;
1205 
1206 	if (!phydev)
1207 		return -ENODEV;
1208 
1209 	return phy_ethtool_ksettings_set(phydev, cmd);
1210 }
1211 EXPORT_SYMBOL(phy_ethtool_set_link_ksettings);
1212 
phy_ethtool_nway_reset(struct net_device * ndev)1213 int phy_ethtool_nway_reset(struct net_device *ndev)
1214 {
1215 	struct phy_device *phydev = ndev->phydev;
1216 
1217 	if (!phydev)
1218 		return -ENODEV;
1219 
1220 	if (!phydev->drv)
1221 		return -EIO;
1222 
1223 	return phy_restart_aneg(phydev);
1224 }
1225 EXPORT_SYMBOL(phy_ethtool_nway_reset);
1226