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