1 // SPDX-License-Identifier: GPL-2.0
3 * phylink models the MAC to optional PHY connection, supporting
4 * technologies such as SFP cages where the PHY is hot-pluggable.
6 * Copyright (C) 2015 Russell King
8 #include <linux/ethtool.h>
9 #include <linux/export.h>
10 #include <linux/gpio/consumer.h>
11 #include <linux/netdevice.h>
13 #include <linux/of_mdio.h>
14 #include <linux/phy.h>
15 #include <linux/phy_fixed.h>
16 #include <linux/phylink.h>
17 #include <linux/rtnetlink.h>
18 #include <linux/spinlock.h>
19 #include <linux/timer.h>
20 #include <linux/workqueue.h>
25 #define SUPPORTED_INTERFACES \
26 (SUPPORTED_TP | SUPPORTED_MII | SUPPORTED_FIBRE | \
27 SUPPORTED_BNC | SUPPORTED_AUI | SUPPORTED_Backplane)
28 #define ADVERTISED_INTERFACES \
29 (ADVERTISED_TP | ADVERTISED_MII | ADVERTISED_FIBRE | \
30 ADVERTISED_BNC | ADVERTISED_AUI | ADVERTISED_Backplane)
33 PHYLINK_DISABLE_STOPPED,
38 * struct phylink - internal data type for phylink
42 struct net_device *netdev;
43 const struct phylink_mac_ops *mac_ops;
44 const struct phylink_pcs_ops *pcs_ops;
45 struct phylink_config *config;
46 struct phylink_pcs *pcs;
48 unsigned int old_link_state:1;
50 unsigned long phylink_disable_state; /* bitmask of disables */
51 struct phy_device *phydev;
52 phy_interface_t link_interface; /* PHY_INTERFACE_xxx */
53 u8 cfg_link_an_mode; /* MLO_AN_xxx */
55 u8 link_port; /* The current non-phy ethtool port */
56 __ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
58 /* The link configuration settings */
59 struct phylink_link_state link_config;
61 /* The current settings */
62 phy_interface_t cur_interface;
64 struct gpio_desc *link_gpio;
65 unsigned int link_irq;
66 struct timer_list link_poll;
67 void (*get_fixed_state)(struct net_device *dev,
68 struct phylink_link_state *s);
70 struct mutex state_mutex;
71 struct phylink_link_state phy_state;
72 struct work_struct resolve;
74 bool mac_link_dropped;
76 struct sfp_bus *sfp_bus;
77 bool sfp_may_have_phy;
78 __ETHTOOL_DECLARE_LINK_MODE_MASK(sfp_support);
82 #define phylink_printk(level, pl, fmt, ...) \
84 if ((pl)->config->type == PHYLINK_NETDEV) \
85 netdev_printk(level, (pl)->netdev, fmt, ##__VA_ARGS__); \
86 else if ((pl)->config->type == PHYLINK_DEV) \
87 dev_printk(level, (pl)->dev, fmt, ##__VA_ARGS__); \
90 #define phylink_err(pl, fmt, ...) \
91 phylink_printk(KERN_ERR, pl, fmt, ##__VA_ARGS__)
92 #define phylink_warn(pl, fmt, ...) \
93 phylink_printk(KERN_WARNING, pl, fmt, ##__VA_ARGS__)
94 #define phylink_info(pl, fmt, ...) \
95 phylink_printk(KERN_INFO, pl, fmt, ##__VA_ARGS__)
96 #if defined(CONFIG_DYNAMIC_DEBUG)
97 #define phylink_dbg(pl, fmt, ...) \
99 if ((pl)->config->type == PHYLINK_NETDEV) \
100 netdev_dbg((pl)->netdev, fmt, ##__VA_ARGS__); \
101 else if ((pl)->config->type == PHYLINK_DEV) \
102 dev_dbg((pl)->dev, fmt, ##__VA_ARGS__); \
105 #define phylink_dbg(pl, fmt, ...) \
106 phylink_printk(KERN_DEBUG, pl, fmt, ##__VA_ARGS__)
108 #define phylink_dbg(pl, fmt, ...) \
111 phylink_printk(KERN_DEBUG, pl, fmt, ##__VA_ARGS__); \
116 * phylink_set_port_modes() - set the port type modes in the ethtool mask
117 * @mask: ethtool link mode mask
119 * Sets all the port type modes in the ethtool mask. MAC drivers should
120 * use this in their 'validate' callback.
122 void phylink_set_port_modes(unsigned long *mask)
124 phylink_set(mask, TP);
125 phylink_set(mask, AUI);
126 phylink_set(mask, MII);
127 phylink_set(mask, FIBRE);
128 phylink_set(mask, BNC);
129 phylink_set(mask, Backplane);
131 EXPORT_SYMBOL_GPL(phylink_set_port_modes);
133 static int phylink_is_empty_linkmode(const unsigned long *linkmode)
135 __ETHTOOL_DECLARE_LINK_MODE_MASK(tmp) = { 0, };
137 phylink_set_port_modes(tmp);
138 phylink_set(tmp, Autoneg);
139 phylink_set(tmp, Pause);
140 phylink_set(tmp, Asym_Pause);
142 return linkmode_subset(linkmode, tmp);
145 static const char *phylink_an_mode_str(unsigned int mode)
147 static const char *modestr[] = {
148 [MLO_AN_PHY] = "phy",
149 [MLO_AN_FIXED] = "fixed",
150 [MLO_AN_INBAND] = "inband",
153 return mode < ARRAY_SIZE(modestr) ? modestr[mode] : "unknown";
156 static int phylink_validate(struct phylink *pl, unsigned long *supported,
157 struct phylink_link_state *state)
159 pl->mac_ops->validate(pl->config, supported, state);
161 return phylink_is_empty_linkmode(supported) ? -EINVAL : 0;
164 static int phylink_parse_fixedlink(struct phylink *pl,
165 struct fwnode_handle *fwnode)
167 struct fwnode_handle *fixed_node;
168 const struct phy_setting *s;
169 struct gpio_desc *desc;
173 fixed_node = fwnode_get_named_child_node(fwnode, "fixed-link");
175 ret = fwnode_property_read_u32(fixed_node, "speed", &speed);
177 pl->link_config.speed = speed;
178 pl->link_config.duplex = DUPLEX_HALF;
180 if (fwnode_property_read_bool(fixed_node, "full-duplex"))
181 pl->link_config.duplex = DUPLEX_FULL;
183 /* We treat the "pause" and "asym-pause" terminology as
184 * defining the link partner's ability. */
185 if (fwnode_property_read_bool(fixed_node, "pause"))
186 __set_bit(ETHTOOL_LINK_MODE_Pause_BIT,
187 pl->link_config.lp_advertising);
188 if (fwnode_property_read_bool(fixed_node, "asym-pause"))
189 __set_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
190 pl->link_config.lp_advertising);
193 desc = fwnode_gpiod_get_index(fixed_node, "link", 0,
197 pl->link_gpio = desc;
198 else if (desc == ERR_PTR(-EPROBE_DEFER))
201 fwnode_handle_put(fixed_node);
208 ret = fwnode_property_read_u32_array(fwnode, "fixed-link",
210 if (ret != ARRAY_SIZE(prop)) {
211 phylink_err(pl, "broken fixed-link?\n");
215 ret = fwnode_property_read_u32_array(fwnode, "fixed-link",
216 prop, ARRAY_SIZE(prop));
218 pl->link_config.duplex = prop[1] ?
219 DUPLEX_FULL : DUPLEX_HALF;
220 pl->link_config.speed = prop[2];
222 __set_bit(ETHTOOL_LINK_MODE_Pause_BIT,
223 pl->link_config.lp_advertising);
225 __set_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
226 pl->link_config.lp_advertising);
230 if (pl->link_config.speed > SPEED_1000 &&
231 pl->link_config.duplex != DUPLEX_FULL)
232 phylink_warn(pl, "fixed link specifies half duplex for %dMbps link?\n",
233 pl->link_config.speed);
235 bitmap_fill(pl->supported, __ETHTOOL_LINK_MODE_MASK_NBITS);
236 linkmode_copy(pl->link_config.advertising, pl->supported);
237 phylink_validate(pl, pl->supported, &pl->link_config);
239 s = phy_lookup_setting(pl->link_config.speed, pl->link_config.duplex,
240 pl->supported, true);
241 linkmode_zero(pl->supported);
242 phylink_set(pl->supported, MII);
243 phylink_set(pl->supported, Pause);
244 phylink_set(pl->supported, Asym_Pause);
245 phylink_set(pl->supported, Autoneg);
247 __set_bit(s->bit, pl->supported);
248 __set_bit(s->bit, pl->link_config.lp_advertising);
250 phylink_warn(pl, "fixed link %s duplex %dMbps not recognised\n",
251 pl->link_config.duplex == DUPLEX_FULL ? "full" : "half",
252 pl->link_config.speed);
255 linkmode_and(pl->link_config.advertising, pl->link_config.advertising,
258 pl->link_config.link = 1;
259 pl->link_config.an_complete = 1;
264 static int phylink_parse_mode(struct phylink *pl, struct fwnode_handle *fwnode)
266 struct fwnode_handle *dn;
269 dn = fwnode_get_named_child_node(fwnode, "fixed-link");
270 if (dn || fwnode_property_present(fwnode, "fixed-link"))
271 pl->cfg_link_an_mode = MLO_AN_FIXED;
272 fwnode_handle_put(dn);
274 if ((fwnode_property_read_string(fwnode, "managed", &managed) == 0 &&
275 strcmp(managed, "in-band-status") == 0) ||
276 pl->config->ovr_an_inband) {
277 if (pl->cfg_link_an_mode == MLO_AN_FIXED) {
279 "can't use both fixed-link and in-band-status\n");
283 linkmode_zero(pl->supported);
284 phylink_set(pl->supported, MII);
285 phylink_set(pl->supported, Autoneg);
286 phylink_set(pl->supported, Asym_Pause);
287 phylink_set(pl->supported, Pause);
288 pl->link_config.an_enabled = true;
289 pl->cfg_link_an_mode = MLO_AN_INBAND;
291 switch (pl->link_config.interface) {
292 case PHY_INTERFACE_MODE_SGMII:
293 case PHY_INTERFACE_MODE_QSGMII:
294 phylink_set(pl->supported, 10baseT_Half);
295 phylink_set(pl->supported, 10baseT_Full);
296 phylink_set(pl->supported, 100baseT_Half);
297 phylink_set(pl->supported, 100baseT_Full);
298 phylink_set(pl->supported, 1000baseT_Half);
299 phylink_set(pl->supported, 1000baseT_Full);
302 case PHY_INTERFACE_MODE_1000BASEX:
303 phylink_set(pl->supported, 1000baseX_Full);
306 case PHY_INTERFACE_MODE_2500BASEX:
307 phylink_set(pl->supported, 2500baseX_Full);
310 case PHY_INTERFACE_MODE_5GBASER:
311 phylink_set(pl->supported, 5000baseT_Full);
314 case PHY_INTERFACE_MODE_USXGMII:
315 case PHY_INTERFACE_MODE_10GKR:
316 case PHY_INTERFACE_MODE_10GBASER:
317 phylink_set(pl->supported, 10baseT_Half);
318 phylink_set(pl->supported, 10baseT_Full);
319 phylink_set(pl->supported, 100baseT_Half);
320 phylink_set(pl->supported, 100baseT_Full);
321 phylink_set(pl->supported, 1000baseT_Half);
322 phylink_set(pl->supported, 1000baseT_Full);
323 phylink_set(pl->supported, 1000baseX_Full);
324 phylink_set(pl->supported, 1000baseKX_Full);
325 phylink_set(pl->supported, 2500baseT_Full);
326 phylink_set(pl->supported, 2500baseX_Full);
327 phylink_set(pl->supported, 5000baseT_Full);
328 phylink_set(pl->supported, 10000baseT_Full);
329 phylink_set(pl->supported, 10000baseKR_Full);
330 phylink_set(pl->supported, 10000baseKX4_Full);
331 phylink_set(pl->supported, 10000baseCR_Full);
332 phylink_set(pl->supported, 10000baseSR_Full);
333 phylink_set(pl->supported, 10000baseLR_Full);
334 phylink_set(pl->supported, 10000baseLRM_Full);
335 phylink_set(pl->supported, 10000baseER_Full);
338 case PHY_INTERFACE_MODE_XLGMII:
339 phylink_set(pl->supported, 25000baseCR_Full);
340 phylink_set(pl->supported, 25000baseKR_Full);
341 phylink_set(pl->supported, 25000baseSR_Full);
342 phylink_set(pl->supported, 40000baseKR4_Full);
343 phylink_set(pl->supported, 40000baseCR4_Full);
344 phylink_set(pl->supported, 40000baseSR4_Full);
345 phylink_set(pl->supported, 40000baseLR4_Full);
346 phylink_set(pl->supported, 50000baseCR2_Full);
347 phylink_set(pl->supported, 50000baseKR2_Full);
348 phylink_set(pl->supported, 50000baseSR2_Full);
349 phylink_set(pl->supported, 50000baseKR_Full);
350 phylink_set(pl->supported, 50000baseSR_Full);
351 phylink_set(pl->supported, 50000baseCR_Full);
352 phylink_set(pl->supported, 50000baseLR_ER_FR_Full);
353 phylink_set(pl->supported, 50000baseDR_Full);
354 phylink_set(pl->supported, 100000baseKR4_Full);
355 phylink_set(pl->supported, 100000baseSR4_Full);
356 phylink_set(pl->supported, 100000baseCR4_Full);
357 phylink_set(pl->supported, 100000baseLR4_ER4_Full);
358 phylink_set(pl->supported, 100000baseKR2_Full);
359 phylink_set(pl->supported, 100000baseSR2_Full);
360 phylink_set(pl->supported, 100000baseCR2_Full);
361 phylink_set(pl->supported, 100000baseLR2_ER2_FR2_Full);
362 phylink_set(pl->supported, 100000baseDR2_Full);
367 "incorrect link mode %s for in-band status\n",
368 phy_modes(pl->link_config.interface));
372 linkmode_copy(pl->link_config.advertising, pl->supported);
374 if (phylink_validate(pl, pl->supported, &pl->link_config)) {
376 "failed to validate link configuration for in-band status\n");
380 /* Check if MAC/PCS also supports Autoneg. */
381 pl->link_config.an_enabled = phylink_test(pl->supported, Autoneg);
387 static void phylink_apply_manual_flow(struct phylink *pl,
388 struct phylink_link_state *state)
390 /* If autoneg is disabled, pause AN is also disabled */
391 if (!state->an_enabled)
392 state->pause &= ~MLO_PAUSE_AN;
394 /* Manual configuration of pause modes */
395 if (!(pl->link_config.pause & MLO_PAUSE_AN))
396 state->pause = pl->link_config.pause;
399 static void phylink_resolve_flow(struct phylink_link_state *state)
401 bool tx_pause, rx_pause;
403 state->pause = MLO_PAUSE_NONE;
404 if (state->duplex == DUPLEX_FULL) {
405 linkmode_resolve_pause(state->advertising,
406 state->lp_advertising,
407 &tx_pause, &rx_pause);
409 state->pause |= MLO_PAUSE_TX;
411 state->pause |= MLO_PAUSE_RX;
415 static void phylink_mac_config(struct phylink *pl,
416 const struct phylink_link_state *state)
419 "%s: mode=%s/%s/%s/%s adv=%*pb pause=%02x link=%u an=%u\n",
420 __func__, phylink_an_mode_str(pl->cur_link_an_mode),
421 phy_modes(state->interface),
422 phy_speed_to_str(state->speed),
423 phy_duplex_to_str(state->duplex),
424 __ETHTOOL_LINK_MODE_MASK_NBITS, state->advertising,
425 state->pause, state->link, state->an_enabled);
427 pl->mac_ops->mac_config(pl->config, pl->cur_link_an_mode, state);
430 static void phylink_mac_pcs_an_restart(struct phylink *pl)
432 if (pl->link_config.an_enabled &&
433 phy_interface_mode_is_8023z(pl->link_config.interface) &&
434 phylink_autoneg_inband(pl->cur_link_an_mode)) {
436 pl->pcs_ops->pcs_an_restart(pl->pcs);
438 pl->mac_ops->mac_an_restart(pl->config);
442 static void phylink_major_config(struct phylink *pl, bool restart,
443 const struct phylink_link_state *state)
447 phylink_dbg(pl, "major config %s\n", phy_modes(state->interface));
449 if (pl->mac_ops->mac_prepare) {
450 err = pl->mac_ops->mac_prepare(pl->config, pl->cur_link_an_mode,
453 phylink_err(pl, "mac_prepare failed: %pe\n",
459 phylink_mac_config(pl, state);
462 err = pl->pcs_ops->pcs_config(pl->pcs, pl->cur_link_an_mode,
465 !!(pl->link_config.pause &
468 phylink_err(pl, "pcs_config failed: %pe\n",
474 phylink_mac_pcs_an_restart(pl);
476 if (pl->mac_ops->mac_finish) {
477 err = pl->mac_ops->mac_finish(pl->config, pl->cur_link_an_mode,
480 phylink_err(pl, "mac_finish failed: %pe\n",
486 * Reconfigure for a change of inband advertisement.
487 * If we have a separate PCS, we only need to call its pcs_config() method,
488 * and then restart AN if it indicates something changed. Otherwise, we do
489 * the full MAC reconfiguration.
491 static int phylink_change_inband_advert(struct phylink *pl)
495 if (test_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state))
500 phylink_mac_config(pl, &pl->link_config);
501 phylink_mac_pcs_an_restart(pl);
505 phylink_dbg(pl, "%s: mode=%s/%s adv=%*pb pause=%02x\n", __func__,
506 phylink_an_mode_str(pl->cur_link_an_mode),
507 phy_modes(pl->link_config.interface),
508 __ETHTOOL_LINK_MODE_MASK_NBITS, pl->link_config.advertising,
509 pl->link_config.pause);
511 /* Modern PCS-based method; update the advert at the PCS, and
512 * restart negotiation if the pcs_config() helper indicates that
513 * the programmed advertisement has changed.
515 ret = pl->pcs_ops->pcs_config(pl->pcs, pl->cur_link_an_mode,
516 pl->link_config.interface,
517 pl->link_config.advertising,
518 !!(pl->link_config.pause & MLO_PAUSE_AN));
523 phylink_mac_pcs_an_restart(pl);
528 static void phylink_mac_pcs_get_state(struct phylink *pl,
529 struct phylink_link_state *state)
531 linkmode_copy(state->advertising, pl->link_config.advertising);
532 linkmode_zero(state->lp_advertising);
533 state->interface = pl->link_config.interface;
534 state->an_enabled = pl->link_config.an_enabled;
535 state->speed = SPEED_UNKNOWN;
536 state->duplex = DUPLEX_UNKNOWN;
537 state->pause = MLO_PAUSE_NONE;
538 state->an_complete = 0;
542 pl->pcs_ops->pcs_get_state(pl->pcs, state);
543 else if (pl->mac_ops->mac_pcs_get_state)
544 pl->mac_ops->mac_pcs_get_state(pl->config, state);
549 /* The fixed state is... fixed except for the link state,
550 * which may be determined by a GPIO or a callback.
552 static void phylink_get_fixed_state(struct phylink *pl,
553 struct phylink_link_state *state)
555 *state = pl->link_config;
556 if (pl->config->get_fixed_state)
557 pl->config->get_fixed_state(pl->config, state);
558 else if (pl->link_gpio)
559 state->link = !!gpiod_get_value_cansleep(pl->link_gpio);
561 phylink_resolve_flow(state);
564 static void phylink_mac_initial_config(struct phylink *pl, bool force_restart)
566 struct phylink_link_state link_state;
568 switch (pl->cur_link_an_mode) {
570 link_state = pl->phy_state;
574 phylink_get_fixed_state(pl, &link_state);
578 link_state = pl->link_config;
579 if (link_state.interface == PHY_INTERFACE_MODE_SGMII)
580 link_state.pause = MLO_PAUSE_NONE;
583 default: /* can't happen */
587 link_state.link = false;
589 phylink_apply_manual_flow(pl, &link_state);
590 phylink_major_config(pl, force_restart, &link_state);
593 static const char *phylink_pause_to_str(int pause)
595 switch (pause & MLO_PAUSE_TXRX_MASK) {
596 case MLO_PAUSE_TX | MLO_PAUSE_RX:
607 static void phylink_link_up(struct phylink *pl,
608 struct phylink_link_state link_state)
610 struct net_device *ndev = pl->netdev;
612 pl->cur_interface = link_state.interface;
614 if (pl->pcs_ops && pl->pcs_ops->pcs_link_up)
615 pl->pcs_ops->pcs_link_up(pl->pcs, pl->cur_link_an_mode,
617 link_state.speed, link_state.duplex);
619 pl->mac_ops->mac_link_up(pl->config, pl->phydev,
620 pl->cur_link_an_mode, pl->cur_interface,
621 link_state.speed, link_state.duplex,
622 !!(link_state.pause & MLO_PAUSE_TX),
623 !!(link_state.pause & MLO_PAUSE_RX));
626 netif_carrier_on(ndev);
629 "Link is Up - %s/%s - flow control %s\n",
630 phy_speed_to_str(link_state.speed),
631 phy_duplex_to_str(link_state.duplex),
632 phylink_pause_to_str(link_state.pause));
635 static void phylink_link_down(struct phylink *pl)
637 struct net_device *ndev = pl->netdev;
640 netif_carrier_off(ndev);
641 pl->mac_ops->mac_link_down(pl->config, pl->cur_link_an_mode,
643 phylink_info(pl, "Link is Down\n");
646 static void phylink_resolve(struct work_struct *w)
648 struct phylink *pl = container_of(w, struct phylink, resolve);
649 struct phylink_link_state link_state;
650 struct net_device *ndev = pl->netdev;
651 bool mac_config = false;
654 mutex_lock(&pl->state_mutex);
656 cur_link_state = netif_carrier_ok(ndev);
658 cur_link_state = pl->old_link_state;
660 if (pl->phylink_disable_state) {
661 pl->mac_link_dropped = false;
662 link_state.link = false;
663 } else if (pl->mac_link_dropped) {
664 link_state.link = false;
666 switch (pl->cur_link_an_mode) {
668 link_state = pl->phy_state;
669 phylink_apply_manual_flow(pl, &link_state);
670 mac_config = link_state.link;
674 phylink_get_fixed_state(pl, &link_state);
675 mac_config = link_state.link;
679 phylink_mac_pcs_get_state(pl, &link_state);
681 /* If we have a phy, the "up" state is the union of
682 * both the PHY and the MAC */
684 link_state.link &= pl->phy_state.link;
686 /* Only update if the PHY link is up */
687 if (pl->phydev && pl->phy_state.link) {
688 link_state.interface = pl->phy_state.interface;
690 /* If we have a PHY, we need to update with
691 * the PHY flow control bits. */
692 link_state.pause = pl->phy_state.pause;
695 phylink_apply_manual_flow(pl, &link_state);
701 if (link_state.interface != pl->link_config.interface) {
702 /* The interface has changed, force the link down and
705 if (cur_link_state) {
706 phylink_link_down(pl);
707 cur_link_state = false;
709 phylink_major_config(pl, false, &link_state);
710 pl->link_config.interface = link_state.interface;
711 } else if (!pl->pcs_ops) {
712 /* The interface remains unchanged, only the speed,
713 * duplex or pause settings have changed. Call the
714 * old mac_config() method to configure the MAC/PCS
715 * only if we do not have a PCS installed (an
718 phylink_mac_config(pl, &link_state);
722 if (link_state.link != cur_link_state) {
723 pl->old_link_state = link_state.link;
724 if (!link_state.link)
725 phylink_link_down(pl);
727 phylink_link_up(pl, link_state);
729 if (!link_state.link && pl->mac_link_dropped) {
730 pl->mac_link_dropped = false;
731 queue_work(system_power_efficient_wq, &pl->resolve);
733 mutex_unlock(&pl->state_mutex);
736 static void phylink_run_resolve(struct phylink *pl)
738 if (!pl->phylink_disable_state)
739 queue_work(system_power_efficient_wq, &pl->resolve);
742 static void phylink_run_resolve_and_disable(struct phylink *pl, int bit)
744 unsigned long state = pl->phylink_disable_state;
746 set_bit(bit, &pl->phylink_disable_state);
748 queue_work(system_power_efficient_wq, &pl->resolve);
749 flush_work(&pl->resolve);
753 static void phylink_fixed_poll(struct timer_list *t)
755 struct phylink *pl = container_of(t, struct phylink, link_poll);
757 mod_timer(t, jiffies + HZ);
759 phylink_run_resolve(pl);
762 static const struct sfp_upstream_ops sfp_phylink_ops;
764 static int phylink_register_sfp(struct phylink *pl,
765 struct fwnode_handle *fwnode)
773 bus = sfp_bus_find_fwnode(fwnode);
776 phylink_err(pl, "unable to attach SFP bus: %d\n", ret);
782 ret = sfp_bus_add_upstream(bus, pl, &sfp_phylink_ops);
789 * phylink_create() - create a phylink instance
790 * @config: a pointer to the target &struct phylink_config
791 * @fwnode: a pointer to a &struct fwnode_handle describing the network
793 * @iface: the desired link mode defined by &typedef phy_interface_t
794 * @mac_ops: a pointer to a &struct phylink_mac_ops for the MAC.
796 * Create a new phylink instance, and parse the link parameters found in @np.
797 * This will parse in-band modes, fixed-link or SFP configuration.
799 * Note: the rtnl lock must not be held when calling this function.
801 * Returns a pointer to a &struct phylink, or an error-pointer value. Users
802 * must use IS_ERR() to check for errors from this function.
804 struct phylink *phylink_create(struct phylink_config *config,
805 struct fwnode_handle *fwnode,
806 phy_interface_t iface,
807 const struct phylink_mac_ops *mac_ops)
812 pl = kzalloc(sizeof(*pl), GFP_KERNEL);
814 return ERR_PTR(-ENOMEM);
816 mutex_init(&pl->state_mutex);
817 INIT_WORK(&pl->resolve, phylink_resolve);
820 if (config->type == PHYLINK_NETDEV) {
821 pl->netdev = to_net_dev(config->dev);
822 } else if (config->type == PHYLINK_DEV) {
823 pl->dev = config->dev;
826 return ERR_PTR(-EINVAL);
829 pl->phy_state.interface = iface;
830 pl->link_interface = iface;
831 if (iface == PHY_INTERFACE_MODE_MOCA)
832 pl->link_port = PORT_BNC;
834 pl->link_port = PORT_MII;
835 pl->link_config.interface = iface;
836 pl->link_config.pause = MLO_PAUSE_AN;
837 pl->link_config.speed = SPEED_UNKNOWN;
838 pl->link_config.duplex = DUPLEX_UNKNOWN;
839 pl->link_config.an_enabled = true;
840 pl->mac_ops = mac_ops;
841 __set_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state);
842 timer_setup(&pl->link_poll, phylink_fixed_poll, 0);
844 bitmap_fill(pl->supported, __ETHTOOL_LINK_MODE_MASK_NBITS);
845 linkmode_copy(pl->link_config.advertising, pl->supported);
846 phylink_validate(pl, pl->supported, &pl->link_config);
848 ret = phylink_parse_mode(pl, fwnode);
854 if (pl->cfg_link_an_mode == MLO_AN_FIXED) {
855 ret = phylink_parse_fixedlink(pl, fwnode);
862 pl->cur_link_an_mode = pl->cfg_link_an_mode;
864 ret = phylink_register_sfp(pl, fwnode);
872 EXPORT_SYMBOL_GPL(phylink_create);
875 * phylink_set_pcs() - set the current PCS for phylink to use
876 * @pl: a pointer to a &struct phylink returned from phylink_create()
877 * @pcs: a pointer to the &struct phylink_pcs
879 * Bind the MAC PCS to phylink. This may be called after phylink_create(),
880 * in mac_prepare() or mac_config() methods if it is desired to dynamically
883 * Please note that there are behavioural changes with the mac_config()
884 * callback if a PCS is present (denoting a newer setup) so removing a PCS
885 * is not supported, and if a PCS is going to be used, it must be registered
886 * by calling phylink_set_pcs() at the latest in the first mac_config() call.
888 void phylink_set_pcs(struct phylink *pl, struct phylink_pcs *pcs)
891 pl->pcs_ops = pcs->ops;
893 EXPORT_SYMBOL_GPL(phylink_set_pcs);
896 * phylink_destroy() - cleanup and destroy the phylink instance
897 * @pl: a pointer to a &struct phylink returned from phylink_create()
899 * Destroy a phylink instance. Any PHY that has been attached must have been
900 * cleaned up via phylink_disconnect_phy() prior to calling this function.
902 * Note: the rtnl lock must not be held when calling this function.
904 void phylink_destroy(struct phylink *pl)
906 sfp_bus_del_upstream(pl->sfp_bus);
908 gpiod_put(pl->link_gpio);
910 cancel_work_sync(&pl->resolve);
913 EXPORT_SYMBOL_GPL(phylink_destroy);
915 static void phylink_phy_change(struct phy_device *phydev, bool up)
917 struct phylink *pl = phydev->phylink;
918 bool tx_pause, rx_pause;
920 phy_get_pause(phydev, &tx_pause, &rx_pause);
922 mutex_lock(&pl->state_mutex);
923 pl->phy_state.speed = phydev->speed;
924 pl->phy_state.duplex = phydev->duplex;
925 pl->phy_state.pause = MLO_PAUSE_NONE;
927 pl->phy_state.pause |= MLO_PAUSE_TX;
929 pl->phy_state.pause |= MLO_PAUSE_RX;
930 pl->phy_state.interface = phydev->interface;
931 pl->phy_state.link = up;
932 mutex_unlock(&pl->state_mutex);
934 phylink_run_resolve(pl);
936 phylink_dbg(pl, "phy link %s %s/%s/%s\n", up ? "up" : "down",
937 phy_modes(phydev->interface),
938 phy_speed_to_str(phydev->speed),
939 phy_duplex_to_str(phydev->duplex));
942 static int phylink_bringup_phy(struct phylink *pl, struct phy_device *phy,
943 phy_interface_t interface)
945 struct phylink_link_state config;
946 __ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
951 * This is the new way of dealing with flow control for PHYs,
952 * as described by Timur Tabi in commit 529ed1275263 ("net: phy:
953 * phy drivers should not set SUPPORTED_[Asym_]Pause") except
954 * using our validate call to the MAC, we rely upon the MAC
955 * clearing the bits from both supported and advertising fields.
957 phy_support_asym_pause(phy);
959 memset(&config, 0, sizeof(config));
960 linkmode_copy(supported, phy->supported);
961 linkmode_copy(config.advertising, phy->advertising);
963 /* Clause 45 PHYs switch their Serdes lane between several different
964 * modes, normally 10GBASE-R, SGMII. Some use 2500BASE-X for 2.5G
965 * speeds. We really need to know which interface modes the PHY and
966 * MAC supports to properly work out which linkmodes can be supported.
969 interface != PHY_INTERFACE_MODE_RXAUI &&
970 interface != PHY_INTERFACE_MODE_XAUI &&
971 interface != PHY_INTERFACE_MODE_USXGMII)
972 config.interface = PHY_INTERFACE_MODE_NA;
974 config.interface = interface;
976 ret = phylink_validate(pl, supported, &config);
978 phylink_warn(pl, "validation of %s with support %*pb and advertisement %*pb failed: %d\n",
979 phy_modes(config.interface),
980 __ETHTOOL_LINK_MODE_MASK_NBITS, phy->supported,
981 __ETHTOOL_LINK_MODE_MASK_NBITS, config.advertising,
987 phy->phy_link_change = phylink_phy_change;
989 irq_str = phy_attached_info_irq(phy);
991 "PHY [%s] driver [%s] (irq=%s)\n",
992 dev_name(&phy->mdio.dev), phy->drv->name, irq_str);
995 mutex_lock(&phy->lock);
996 mutex_lock(&pl->state_mutex);
998 pl->phy_state.interface = interface;
999 pl->phy_state.pause = MLO_PAUSE_NONE;
1000 pl->phy_state.speed = SPEED_UNKNOWN;
1001 pl->phy_state.duplex = DUPLEX_UNKNOWN;
1002 linkmode_copy(pl->supported, supported);
1003 linkmode_copy(pl->link_config.advertising, config.advertising);
1005 /* Restrict the phy advertisement according to the MAC support. */
1006 linkmode_copy(phy->advertising, config.advertising);
1007 mutex_unlock(&pl->state_mutex);
1008 mutex_unlock(&phy->lock);
1011 "phy: setting supported %*pb advertising %*pb\n",
1012 __ETHTOOL_LINK_MODE_MASK_NBITS, pl->supported,
1013 __ETHTOOL_LINK_MODE_MASK_NBITS, phy->advertising);
1015 if (phy_interrupt_is_valid(phy))
1016 phy_request_interrupt(phy);
1021 static int phylink_attach_phy(struct phylink *pl, struct phy_device *phy,
1022 phy_interface_t interface)
1024 if (WARN_ON(pl->cfg_link_an_mode == MLO_AN_FIXED ||
1025 (pl->cfg_link_an_mode == MLO_AN_INBAND &&
1026 phy_interface_mode_is_8023z(interface))))
1032 return phy_attach_direct(pl->netdev, phy, 0, interface);
1036 * phylink_connect_phy() - connect a PHY to the phylink instance
1037 * @pl: a pointer to a &struct phylink returned from phylink_create()
1038 * @phy: a pointer to a &struct phy_device.
1040 * Connect @phy to the phylink instance specified by @pl by calling
1041 * phy_attach_direct(). Configure the @phy according to the MAC driver's
1042 * capabilities, start the PHYLIB state machine and enable any interrupts
1043 * that the PHY supports.
1045 * This updates the phylink's ethtool supported and advertising link mode
1048 * Returns 0 on success or a negative errno.
1050 int phylink_connect_phy(struct phylink *pl, struct phy_device *phy)
1054 /* Use PHY device/driver interface */
1055 if (pl->link_interface == PHY_INTERFACE_MODE_NA) {
1056 pl->link_interface = phy->interface;
1057 pl->link_config.interface = pl->link_interface;
1060 ret = phylink_attach_phy(pl, phy, pl->link_interface);
1064 ret = phylink_bringup_phy(pl, phy, pl->link_config.interface);
1070 EXPORT_SYMBOL_GPL(phylink_connect_phy);
1073 * phylink_of_phy_connect() - connect the PHY specified in the DT mode.
1074 * @pl: a pointer to a &struct phylink returned from phylink_create()
1075 * @dn: a pointer to a &struct device_node.
1076 * @flags: PHY-specific flags to communicate to the PHY device driver
1078 * Connect the phy specified in the device node @dn to the phylink instance
1079 * specified by @pl. Actions specified in phylink_connect_phy() will be
1082 * Returns 0 on success or a negative errno.
1084 int phylink_of_phy_connect(struct phylink *pl, struct device_node *dn,
1087 struct device_node *phy_node;
1088 struct phy_device *phy_dev;
1091 /* Fixed links and 802.3z are handled without needing a PHY */
1092 if (pl->cfg_link_an_mode == MLO_AN_FIXED ||
1093 (pl->cfg_link_an_mode == MLO_AN_INBAND &&
1094 phy_interface_mode_is_8023z(pl->link_interface)))
1097 phy_node = of_parse_phandle(dn, "phy-handle", 0);
1099 phy_node = of_parse_phandle(dn, "phy", 0);
1101 phy_node = of_parse_phandle(dn, "phy-device", 0);
1104 if (pl->cfg_link_an_mode == MLO_AN_PHY)
1109 phy_dev = of_phy_find_device(phy_node);
1110 /* We're done with the phy_node handle */
1111 of_node_put(phy_node);
1115 ret = phy_attach_direct(pl->netdev, phy_dev, flags,
1116 pl->link_interface);
1120 ret = phylink_bringup_phy(pl, phy_dev, pl->link_config.interface);
1122 phy_detach(phy_dev);
1126 EXPORT_SYMBOL_GPL(phylink_of_phy_connect);
1129 * phylink_disconnect_phy() - disconnect any PHY attached to the phylink
1131 * @pl: a pointer to a &struct phylink returned from phylink_create()
1133 * Disconnect any current PHY from the phylink instance described by @pl.
1135 void phylink_disconnect_phy(struct phylink *pl)
1137 struct phy_device *phy;
1143 mutex_lock(&phy->lock);
1144 mutex_lock(&pl->state_mutex);
1146 mutex_unlock(&pl->state_mutex);
1147 mutex_unlock(&phy->lock);
1148 flush_work(&pl->resolve);
1150 phy_disconnect(phy);
1153 EXPORT_SYMBOL_GPL(phylink_disconnect_phy);
1156 * phylink_mac_change() - notify phylink of a change in MAC state
1157 * @pl: a pointer to a &struct phylink returned from phylink_create()
1158 * @up: indicates whether the link is currently up.
1160 * The MAC driver should call this driver when the state of its link
1161 * changes (eg, link failure, new negotiation results, etc.)
1163 void phylink_mac_change(struct phylink *pl, bool up)
1166 pl->mac_link_dropped = true;
1167 phylink_run_resolve(pl);
1168 phylink_dbg(pl, "mac link %s\n", up ? "up" : "down");
1170 EXPORT_SYMBOL_GPL(phylink_mac_change);
1172 static irqreturn_t phylink_link_handler(int irq, void *data)
1174 struct phylink *pl = data;
1176 phylink_run_resolve(pl);
1182 * phylink_start() - start a phylink instance
1183 * @pl: a pointer to a &struct phylink returned from phylink_create()
1185 * Start the phylink instance specified by @pl, configuring the MAC for the
1186 * desired link mode(s) and negotiation style. This should be called from the
1187 * network device driver's &struct net_device_ops ndo_open() method.
1189 void phylink_start(struct phylink *pl)
1195 phylink_info(pl, "configuring for %s/%s link mode\n",
1196 phylink_an_mode_str(pl->cur_link_an_mode),
1197 phy_modes(pl->link_config.interface));
1199 /* Always set the carrier off */
1201 netif_carrier_off(pl->netdev);
1203 /* Apply the link configuration to the MAC when starting. This allows
1204 * a fixed-link to start with the correct parameters, and also
1205 * ensures that we set the appropriate advertisement for Serdes links.
1207 * Restart autonegotiation if using 802.3z to ensure that the link
1208 * parameters are properly negotiated. This is necessary for DSA
1209 * switches using 802.3z negotiation to ensure they see our modes.
1211 phylink_mac_initial_config(pl, true);
1213 clear_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state);
1214 phylink_run_resolve(pl);
1216 if (pl->cfg_link_an_mode == MLO_AN_FIXED && pl->link_gpio) {
1217 int irq = gpiod_to_irq(pl->link_gpio);
1220 if (!request_irq(irq, phylink_link_handler,
1221 IRQF_TRIGGER_RISING |
1222 IRQF_TRIGGER_FALLING,
1232 switch (pl->cfg_link_an_mode) {
1234 poll |= pl->config->poll_fixed_state;
1237 poll |= pl->config->pcs_poll;
1239 poll |= pl->pcs->poll;
1243 mod_timer(&pl->link_poll, jiffies + HZ);
1245 phy_start(pl->phydev);
1247 sfp_upstream_start(pl->sfp_bus);
1249 EXPORT_SYMBOL_GPL(phylink_start);
1252 * phylink_stop() - stop a phylink instance
1253 * @pl: a pointer to a &struct phylink returned from phylink_create()
1255 * Stop the phylink instance specified by @pl. This should be called from the
1256 * network device driver's &struct net_device_ops ndo_stop() method. The
1257 * network device's carrier state should not be changed prior to calling this
1260 void phylink_stop(struct phylink *pl)
1265 sfp_upstream_stop(pl->sfp_bus);
1267 phy_stop(pl->phydev);
1268 del_timer_sync(&pl->link_poll);
1270 free_irq(pl->link_irq, pl);
1274 phylink_run_resolve_and_disable(pl, PHYLINK_DISABLE_STOPPED);
1276 EXPORT_SYMBOL_GPL(phylink_stop);
1279 * phylink_ethtool_get_wol() - get the wake on lan parameters for the PHY
1280 * @pl: a pointer to a &struct phylink returned from phylink_create()
1281 * @wol: a pointer to &struct ethtool_wolinfo to hold the read parameters
1283 * Read the wake on lan parameters from the PHY attached to the phylink
1284 * instance specified by @pl. If no PHY is currently attached, report no
1285 * support for wake on lan.
1287 void phylink_ethtool_get_wol(struct phylink *pl, struct ethtool_wolinfo *wol)
1295 phy_ethtool_get_wol(pl->phydev, wol);
1297 EXPORT_SYMBOL_GPL(phylink_ethtool_get_wol);
1300 * phylink_ethtool_set_wol() - set wake on lan parameters
1301 * @pl: a pointer to a &struct phylink returned from phylink_create()
1302 * @wol: a pointer to &struct ethtool_wolinfo for the desired parameters
1304 * Set the wake on lan parameters for the PHY attached to the phylink
1305 * instance specified by @pl. If no PHY is attached, returns %EOPNOTSUPP
1308 * Returns zero on success or negative errno code.
1310 int phylink_ethtool_set_wol(struct phylink *pl, struct ethtool_wolinfo *wol)
1312 int ret = -EOPNOTSUPP;
1317 ret = phy_ethtool_set_wol(pl->phydev, wol);
1321 EXPORT_SYMBOL_GPL(phylink_ethtool_set_wol);
1323 static void phylink_merge_link_mode(unsigned long *dst, const unsigned long *b)
1325 __ETHTOOL_DECLARE_LINK_MODE_MASK(mask);
1327 linkmode_zero(mask);
1328 phylink_set_port_modes(mask);
1330 linkmode_and(dst, dst, mask);
1331 linkmode_or(dst, dst, b);
1334 static void phylink_get_ksettings(const struct phylink_link_state *state,
1335 struct ethtool_link_ksettings *kset)
1337 phylink_merge_link_mode(kset->link_modes.advertising, state->advertising);
1338 linkmode_copy(kset->link_modes.lp_advertising, state->lp_advertising);
1339 kset->base.speed = state->speed;
1340 kset->base.duplex = state->duplex;
1341 kset->base.autoneg = state->an_enabled ? AUTONEG_ENABLE :
1346 * phylink_ethtool_ksettings_get() - get the current link settings
1347 * @pl: a pointer to a &struct phylink returned from phylink_create()
1348 * @kset: a pointer to a &struct ethtool_link_ksettings to hold link settings
1350 * Read the current link settings for the phylink instance specified by @pl.
1351 * This will be the link settings read from the MAC, PHY or fixed link
1352 * settings depending on the current negotiation mode.
1354 int phylink_ethtool_ksettings_get(struct phylink *pl,
1355 struct ethtool_link_ksettings *kset)
1357 struct phylink_link_state link_state;
1362 phy_ethtool_ksettings_get(pl->phydev, kset);
1364 kset->base.port = pl->link_port;
1367 linkmode_copy(kset->link_modes.supported, pl->supported);
1369 switch (pl->cur_link_an_mode) {
1371 /* We are using fixed settings. Report these as the
1372 * current link settings - and note that these also
1373 * represent the supported speeds/duplex/pause modes.
1375 phylink_get_fixed_state(pl, &link_state);
1376 phylink_get_ksettings(&link_state, kset);
1380 /* If there is a phy attached, then use the reported
1381 * settings from the phy with no modification.
1386 phylink_mac_pcs_get_state(pl, &link_state);
1388 /* The MAC is reporting the link results from its own PCS
1389 * layer via in-band status. Report these as the current
1392 phylink_get_ksettings(&link_state, kset);
1398 EXPORT_SYMBOL_GPL(phylink_ethtool_ksettings_get);
1401 * phylink_ethtool_ksettings_set() - set the link settings
1402 * @pl: a pointer to a &struct phylink returned from phylink_create()
1403 * @kset: a pointer to a &struct ethtool_link_ksettings for the desired modes
1405 int phylink_ethtool_ksettings_set(struct phylink *pl,
1406 const struct ethtool_link_ksettings *kset)
1408 __ETHTOOL_DECLARE_LINK_MODE_MASK(support);
1409 struct phylink_link_state config;
1410 const struct phy_setting *s;
1415 /* We can rely on phylib for this update; we also do not need
1416 * to update the pl->link_config settings:
1417 * - the configuration returned via ksettings_get() will come
1418 * from phylib whenever a PHY is present.
1419 * - link_config.interface will be updated by the PHY calling
1420 * back via phylink_phy_change() and a subsequent resolve.
1421 * - initial link configuration for PHY mode comes from the
1422 * last phy state updated via phylink_phy_change().
1423 * - other configuration changes (e.g. pause modes) are
1424 * performed directly via phylib.
1425 * - if in in-band mode with a PHY, the link configuration
1426 * is passed on the link from the PHY, and all of
1427 * link_config.{speed,duplex,an_enabled,pause} are not used.
1428 * - the only possible use would be link_config.advertising
1429 * pause modes when in 1000base-X mode with a PHY, but in
1430 * the presence of a PHY, this should not be changed as that
1431 * should be determined from the media side advertisement.
1433 return phy_ethtool_ksettings_set(pl->phydev, kset);
1436 linkmode_copy(support, pl->supported);
1437 config = pl->link_config;
1438 config.an_enabled = kset->base.autoneg == AUTONEG_ENABLE;
1440 /* Mask out unsupported advertisements, and force the autoneg bit */
1441 linkmode_and(config.advertising, kset->link_modes.advertising,
1443 linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, config.advertising,
1446 /* FIXME: should we reject autoneg if phy/mac does not support it? */
1447 switch (kset->base.autoneg) {
1448 case AUTONEG_DISABLE:
1449 /* Autonegotiation disabled, select a suitable speed and
1452 s = phy_lookup_setting(kset->base.speed, kset->base.duplex,
1457 /* If we have a fixed link, refuse to change link parameters.
1458 * If the link parameters match, accept them but do nothing.
1460 if (pl->cur_link_an_mode == MLO_AN_FIXED) {
1461 if (s->speed != pl->link_config.speed ||
1462 s->duplex != pl->link_config.duplex)
1467 config.speed = s->speed;
1468 config.duplex = s->duplex;
1471 case AUTONEG_ENABLE:
1472 /* If we have a fixed link, allow autonegotiation (since that
1473 * is our default case) but do not allow the advertisement to
1474 * be changed. If the advertisement matches, simply return.
1476 if (pl->cur_link_an_mode == MLO_AN_FIXED) {
1477 if (!linkmode_equal(config.advertising,
1478 pl->link_config.advertising))
1483 config.speed = SPEED_UNKNOWN;
1484 config.duplex = DUPLEX_UNKNOWN;
1491 /* We have ruled out the case with a PHY attached, and the
1492 * fixed-link cases. All that is left are in-band links.
1494 if (phylink_validate(pl, support, &config))
1497 /* If autonegotiation is enabled, we must have an advertisement */
1498 if (config.an_enabled && phylink_is_empty_linkmode(config.advertising))
1501 mutex_lock(&pl->state_mutex);
1502 pl->link_config.speed = config.speed;
1503 pl->link_config.duplex = config.duplex;
1504 pl->link_config.an_enabled = config.an_enabled;
1506 if (pl->link_config.interface != config.interface) {
1507 /* The interface changed, e.g. 1000base-X <-> 2500base-X */
1508 /* We need to force the link down, then change the interface */
1509 if (pl->old_link_state) {
1510 phylink_link_down(pl);
1511 pl->old_link_state = false;
1513 if (!test_bit(PHYLINK_DISABLE_STOPPED,
1514 &pl->phylink_disable_state))
1515 phylink_major_config(pl, false, &config);
1516 pl->link_config.interface = config.interface;
1517 linkmode_copy(pl->link_config.advertising, config.advertising);
1518 } else if (!linkmode_equal(pl->link_config.advertising,
1519 config.advertising)) {
1520 linkmode_copy(pl->link_config.advertising, config.advertising);
1521 phylink_change_inband_advert(pl);
1523 mutex_unlock(&pl->state_mutex);
1527 EXPORT_SYMBOL_GPL(phylink_ethtool_ksettings_set);
1530 * phylink_ethtool_nway_reset() - restart negotiation
1531 * @pl: a pointer to a &struct phylink returned from phylink_create()
1533 * Restart negotiation for the phylink instance specified by @pl. This will
1534 * cause any attached phy to restart negotiation with the link partner, and
1535 * if the MAC is in a BaseX mode, the MAC will also be requested to restart
1538 * Returns zero on success, or negative error code.
1540 int phylink_ethtool_nway_reset(struct phylink *pl)
1547 ret = phy_restart_aneg(pl->phydev);
1548 phylink_mac_pcs_an_restart(pl);
1552 EXPORT_SYMBOL_GPL(phylink_ethtool_nway_reset);
1555 * phylink_ethtool_get_pauseparam() - get the current pause parameters
1556 * @pl: a pointer to a &struct phylink returned from phylink_create()
1557 * @pause: a pointer to a &struct ethtool_pauseparam
1559 void phylink_ethtool_get_pauseparam(struct phylink *pl,
1560 struct ethtool_pauseparam *pause)
1564 pause->autoneg = !!(pl->link_config.pause & MLO_PAUSE_AN);
1565 pause->rx_pause = !!(pl->link_config.pause & MLO_PAUSE_RX);
1566 pause->tx_pause = !!(pl->link_config.pause & MLO_PAUSE_TX);
1568 EXPORT_SYMBOL_GPL(phylink_ethtool_get_pauseparam);
1571 * phylink_ethtool_set_pauseparam() - set the current pause parameters
1572 * @pl: a pointer to a &struct phylink returned from phylink_create()
1573 * @pause: a pointer to a &struct ethtool_pauseparam
1575 int phylink_ethtool_set_pauseparam(struct phylink *pl,
1576 struct ethtool_pauseparam *pause)
1578 struct phylink_link_state *config = &pl->link_config;
1579 bool manual_changed;
1584 if (pl->cur_link_an_mode == MLO_AN_FIXED)
1587 if (!phylink_test(pl->supported, Pause) &&
1588 !phylink_test(pl->supported, Asym_Pause))
1591 if (!phylink_test(pl->supported, Asym_Pause) &&
1592 !pause->autoneg && pause->rx_pause != pause->tx_pause)
1597 pause_state |= MLO_PAUSE_AN;
1598 if (pause->rx_pause)
1599 pause_state |= MLO_PAUSE_RX;
1600 if (pause->tx_pause)
1601 pause_state |= MLO_PAUSE_TX;
1603 mutex_lock(&pl->state_mutex);
1605 * See the comments for linkmode_set_pause(), wrt the deficiencies
1606 * with the current implementation. A solution to this issue would
1608 * ethtool Local device
1609 * rx tx Pause AsymDir
1614 * and then use the ethtool rx/tx enablement status to mask the
1615 * rx/tx pause resolution.
1617 linkmode_set_pause(config->advertising, pause->tx_pause,
1620 manual_changed = (config->pause ^ pause_state) & MLO_PAUSE_AN ||
1621 (!(pause_state & MLO_PAUSE_AN) &&
1622 (config->pause ^ pause_state) & MLO_PAUSE_TXRX_MASK);
1624 config->pause = pause_state;
1626 /* Update our in-band advertisement, triggering a renegotiation if
1627 * the advertisement changed.
1630 phylink_change_inband_advert(pl);
1632 mutex_unlock(&pl->state_mutex);
1634 /* If we have a PHY, a change of the pause frame advertisement will
1635 * cause phylib to renegotiate (if AN is enabled) which will in turn
1636 * call our phylink_phy_change() and trigger a resolve. Note that
1637 * we can't hold our state mutex while calling phy_set_asym_pause().
1640 phy_set_asym_pause(pl->phydev, pause->rx_pause,
1643 /* If the manual pause settings changed, make sure we trigger a
1644 * resolve to update their state; we can not guarantee that the
1647 if (manual_changed) {
1648 pl->mac_link_dropped = true;
1649 phylink_run_resolve(pl);
1654 EXPORT_SYMBOL_GPL(phylink_ethtool_set_pauseparam);
1657 * phylink_get_eee_err() - read the energy efficient ethernet error
1659 * @pl: a pointer to a &struct phylink returned from phylink_create().
1661 * Read the Energy Efficient Ethernet error counter from the PHY associated
1662 * with the phylink instance specified by @pl.
1664 * Returns positive error counter value, or negative error code.
1666 int phylink_get_eee_err(struct phylink *pl)
1673 ret = phy_get_eee_err(pl->phydev);
1677 EXPORT_SYMBOL_GPL(phylink_get_eee_err);
1680 * phylink_init_eee() - init and check the EEE features
1681 * @pl: a pointer to a &struct phylink returned from phylink_create()
1682 * @clk_stop_enable: allow PHY to stop receive clock
1684 * Must be called either with RTNL held or within mac_link_up()
1686 int phylink_init_eee(struct phylink *pl, bool clk_stop_enable)
1688 int ret = -EOPNOTSUPP;
1691 ret = phy_init_eee(pl->phydev, clk_stop_enable);
1695 EXPORT_SYMBOL_GPL(phylink_init_eee);
1698 * phylink_ethtool_get_eee() - read the energy efficient ethernet parameters
1699 * @pl: a pointer to a &struct phylink returned from phylink_create()
1700 * @eee: a pointer to a &struct ethtool_eee for the read parameters
1702 int phylink_ethtool_get_eee(struct phylink *pl, struct ethtool_eee *eee)
1704 int ret = -EOPNOTSUPP;
1709 ret = phy_ethtool_get_eee(pl->phydev, eee);
1713 EXPORT_SYMBOL_GPL(phylink_ethtool_get_eee);
1716 * phylink_ethtool_set_eee() - set the energy efficient ethernet parameters
1717 * @pl: a pointer to a &struct phylink returned from phylink_create()
1718 * @eee: a pointer to a &struct ethtool_eee for the desired parameters
1720 int phylink_ethtool_set_eee(struct phylink *pl, struct ethtool_eee *eee)
1722 int ret = -EOPNOTSUPP;
1727 ret = phy_ethtool_set_eee(pl->phydev, eee);
1731 EXPORT_SYMBOL_GPL(phylink_ethtool_set_eee);
1733 /* This emulates MII registers for a fixed-mode phy operating as per the
1734 * passed in state. "aneg" defines if we report negotiation is possible.
1736 * FIXME: should deal with negotiation state too.
1738 static int phylink_mii_emul_read(unsigned int reg,
1739 struct phylink_link_state *state)
1741 struct fixed_phy_status fs;
1742 unsigned long *lpa = state->lp_advertising;
1745 fs.link = state->link;
1746 fs.speed = state->speed;
1747 fs.duplex = state->duplex;
1748 fs.pause = test_bit(ETHTOOL_LINK_MODE_Pause_BIT, lpa);
1749 fs.asym_pause = test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, lpa);
1751 val = swphy_read_reg(reg, &fs);
1752 if (reg == MII_BMSR) {
1753 if (!state->an_complete)
1754 val &= ~BMSR_ANEGCOMPLETE;
1759 static int phylink_phy_read(struct phylink *pl, unsigned int phy_id,
1762 struct phy_device *phydev = pl->phydev;
1765 if (mdio_phy_id_is_c45(phy_id)) {
1766 prtad = mdio_phy_id_prtad(phy_id);
1767 devad = mdio_phy_id_devad(phy_id);
1768 devad = mdiobus_c45_addr(devad, reg);
1769 } else if (phydev->is_c45) {
1775 devad = __ffs(phydev->c45_ids.mmds_present);
1779 if (!(phydev->c45_ids.mmds_present & MDIO_DEVS_AN))
1781 devad = MDIO_MMD_AN;
1782 if (reg == MII_ADVERTISE)
1783 reg = MDIO_AN_ADVERTISE;
1791 devad = mdiobus_c45_addr(devad, reg);
1796 return mdiobus_read(pl->phydev->mdio.bus, prtad, devad);
1799 static int phylink_phy_write(struct phylink *pl, unsigned int phy_id,
1800 unsigned int reg, unsigned int val)
1802 struct phy_device *phydev = pl->phydev;
1805 if (mdio_phy_id_is_c45(phy_id)) {
1806 prtad = mdio_phy_id_prtad(phy_id);
1807 devad = mdio_phy_id_devad(phy_id);
1808 devad = mdiobus_c45_addr(devad, reg);
1809 } else if (phydev->is_c45) {
1815 devad = __ffs(phydev->c45_ids.mmds_present);
1819 if (!(phydev->c45_ids.mmds_present & MDIO_DEVS_AN))
1821 devad = MDIO_MMD_AN;
1822 if (reg == MII_ADVERTISE)
1823 reg = MDIO_AN_ADVERTISE;
1831 devad = mdiobus_c45_addr(devad, reg);
1837 return mdiobus_write(phydev->mdio.bus, prtad, devad, val);
1840 static int phylink_mii_read(struct phylink *pl, unsigned int phy_id,
1843 struct phylink_link_state state;
1846 switch (pl->cur_link_an_mode) {
1849 phylink_get_fixed_state(pl, &state);
1850 val = phylink_mii_emul_read(reg, &state);
1859 phylink_mac_pcs_get_state(pl, &state);
1860 val = phylink_mii_emul_read(reg, &state);
1865 return val & 0xffff;
1868 static int phylink_mii_write(struct phylink *pl, unsigned int phy_id,
1869 unsigned int reg, unsigned int val)
1871 switch (pl->cur_link_an_mode) {
1886 * phylink_mii_ioctl() - generic mii ioctl interface
1887 * @pl: a pointer to a &struct phylink returned from phylink_create()
1888 * @ifr: a pointer to a &struct ifreq for socket ioctls
1889 * @cmd: ioctl cmd to execute
1891 * Perform the specified MII ioctl on the PHY attached to the phylink instance
1892 * specified by @pl. If no PHY is attached, emulate the presence of the PHY.
1894 * Returns: zero on success or negative error code.
1897 * read register from the current PHY.
1899 * read register from the specified PHY.
1901 * set a register on the specified PHY.
1903 int phylink_mii_ioctl(struct phylink *pl, struct ifreq *ifr, int cmd)
1905 struct mii_ioctl_data *mii = if_mii(ifr);
1911 /* PHYs only exist for MLO_AN_PHY and SGMII */
1914 mii->phy_id = pl->phydev->mdio.addr;
1918 ret = phylink_phy_read(pl, mii->phy_id, mii->reg_num);
1926 ret = phylink_phy_write(pl, mii->phy_id, mii->reg_num,
1931 ret = phy_mii_ioctl(pl->phydev, ifr, cmd);
1941 ret = phylink_mii_read(pl, mii->phy_id, mii->reg_num);
1949 ret = phylink_mii_write(pl, mii->phy_id, mii->reg_num,
1961 EXPORT_SYMBOL_GPL(phylink_mii_ioctl);
1964 * phylink_speed_down() - set the non-SFP PHY to lowest speed supported by both
1966 * @pl: a pointer to a &struct phylink returned from phylink_create()
1967 * @sync: perform action synchronously
1969 * If we have a PHY that is not part of a SFP module, then set the speed
1970 * as described in the phy_speed_down() function. Please see this function
1971 * for a description of the @sync parameter.
1973 * Returns zero if there is no PHY, otherwise as per phy_speed_down().
1975 int phylink_speed_down(struct phylink *pl, bool sync)
1981 if (!pl->sfp_bus && pl->phydev)
1982 ret = phy_speed_down(pl->phydev, sync);
1986 EXPORT_SYMBOL_GPL(phylink_speed_down);
1989 * phylink_speed_up() - restore the advertised speeds prior to the call to
1990 * phylink_speed_down()
1991 * @pl: a pointer to a &struct phylink returned from phylink_create()
1993 * If we have a PHY that is not part of a SFP module, then restore the
1994 * PHY speeds as per phy_speed_up().
1996 * Returns zero if there is no PHY, otherwise as per phy_speed_up().
1998 int phylink_speed_up(struct phylink *pl)
2004 if (!pl->sfp_bus && pl->phydev)
2005 ret = phy_speed_up(pl->phydev);
2009 EXPORT_SYMBOL_GPL(phylink_speed_up);
2011 static void phylink_sfp_attach(void *upstream, struct sfp_bus *bus)
2013 struct phylink *pl = upstream;
2015 pl->netdev->sfp_bus = bus;
2018 static void phylink_sfp_detach(void *upstream, struct sfp_bus *bus)
2020 struct phylink *pl = upstream;
2022 pl->netdev->sfp_bus = NULL;
2025 static int phylink_sfp_config(struct phylink *pl, u8 mode,
2026 const unsigned long *supported,
2027 const unsigned long *advertising)
2029 __ETHTOOL_DECLARE_LINK_MODE_MASK(support1);
2030 __ETHTOOL_DECLARE_LINK_MODE_MASK(support);
2031 struct phylink_link_state config;
2032 phy_interface_t iface;
2036 linkmode_copy(support, supported);
2038 memset(&config, 0, sizeof(config));
2039 linkmode_copy(config.advertising, advertising);
2040 config.interface = PHY_INTERFACE_MODE_NA;
2041 config.speed = SPEED_UNKNOWN;
2042 config.duplex = DUPLEX_UNKNOWN;
2043 config.pause = MLO_PAUSE_AN;
2044 config.an_enabled = pl->link_config.an_enabled;
2046 /* Ignore errors if we're expecting a PHY to attach later */
2047 ret = phylink_validate(pl, support, &config);
2049 phylink_err(pl, "validation with support %*pb failed: %d\n",
2050 __ETHTOOL_LINK_MODE_MASK_NBITS, support, ret);
2054 iface = sfp_select_interface(pl->sfp_bus, config.advertising);
2055 if (iface == PHY_INTERFACE_MODE_NA) {
2057 "selection of interface failed, advertisement %*pb\n",
2058 __ETHTOOL_LINK_MODE_MASK_NBITS, config.advertising);
2062 config.interface = iface;
2063 linkmode_copy(support1, support);
2064 ret = phylink_validate(pl, support1, &config);
2066 phylink_err(pl, "validation of %s/%s with support %*pb failed: %d\n",
2067 phylink_an_mode_str(mode),
2068 phy_modes(config.interface),
2069 __ETHTOOL_LINK_MODE_MASK_NBITS, support, ret);
2073 phylink_dbg(pl, "requesting link mode %s/%s with support %*pb\n",
2074 phylink_an_mode_str(mode), phy_modes(config.interface),
2075 __ETHTOOL_LINK_MODE_MASK_NBITS, support);
2077 if (phy_interface_mode_is_8023z(iface) && pl->phydev)
2080 changed = !linkmode_equal(pl->supported, support);
2082 linkmode_copy(pl->supported, support);
2083 linkmode_copy(pl->link_config.advertising, config.advertising);
2086 if (pl->cur_link_an_mode != mode ||
2087 pl->link_config.interface != config.interface) {
2088 pl->link_config.interface = config.interface;
2089 pl->cur_link_an_mode = mode;
2093 phylink_info(pl, "switched to %s/%s link mode\n",
2094 phylink_an_mode_str(mode),
2095 phy_modes(config.interface));
2098 pl->link_port = pl->sfp_port;
2100 if (changed && !test_bit(PHYLINK_DISABLE_STOPPED,
2101 &pl->phylink_disable_state))
2102 phylink_mac_initial_config(pl, false);
2107 static int phylink_sfp_module_insert(void *upstream,
2108 const struct sfp_eeprom_id *id)
2110 struct phylink *pl = upstream;
2111 unsigned long *support = pl->sfp_support;
2115 linkmode_zero(support);
2116 sfp_parse_support(pl->sfp_bus, id, support);
2117 pl->sfp_port = sfp_parse_port(pl->sfp_bus, id, support);
2119 /* If this module may have a PHY connecting later, defer until later */
2120 pl->sfp_may_have_phy = sfp_may_have_phy(pl->sfp_bus, id);
2121 if (pl->sfp_may_have_phy)
2124 return phylink_sfp_config(pl, MLO_AN_INBAND, support, support);
2127 static int phylink_sfp_module_start(void *upstream)
2129 struct phylink *pl = upstream;
2131 /* If this SFP module has a PHY, start the PHY now. */
2133 phy_start(pl->phydev);
2137 /* If the module may have a PHY but we didn't detect one we
2138 * need to configure the MAC here.
2140 if (!pl->sfp_may_have_phy)
2143 return phylink_sfp_config(pl, MLO_AN_INBAND,
2144 pl->sfp_support, pl->sfp_support);
2147 static void phylink_sfp_module_stop(void *upstream)
2149 struct phylink *pl = upstream;
2151 /* If this SFP module has a PHY, stop it. */
2153 phy_stop(pl->phydev);
2156 static void phylink_sfp_link_down(void *upstream)
2158 struct phylink *pl = upstream;
2162 phylink_run_resolve_and_disable(pl, PHYLINK_DISABLE_LINK);
2165 static void phylink_sfp_link_up(void *upstream)
2167 struct phylink *pl = upstream;
2171 clear_bit(PHYLINK_DISABLE_LINK, &pl->phylink_disable_state);
2172 phylink_run_resolve(pl);
2175 /* The Broadcom BCM84881 in the Methode DM7052 is unable to provide a SGMII
2176 * or 802.3z control word, so inband will not work.
2178 static bool phylink_phy_no_inband(struct phy_device *phy)
2180 return phy->is_c45 &&
2181 (phy->c45_ids.device_ids[1] & 0xfffffff0) == 0xae025150;
2184 static int phylink_sfp_connect_phy(void *upstream, struct phy_device *phy)
2186 struct phylink *pl = upstream;
2187 phy_interface_t interface;
2192 * This is the new way of dealing with flow control for PHYs,
2193 * as described by Timur Tabi in commit 529ed1275263 ("net: phy:
2194 * phy drivers should not set SUPPORTED_[Asym_]Pause") except
2195 * using our validate call to the MAC, we rely upon the MAC
2196 * clearing the bits from both supported and advertising fields.
2198 phy_support_asym_pause(phy);
2200 if (phylink_phy_no_inband(phy))
2203 mode = MLO_AN_INBAND;
2205 /* Do the initial configuration */
2206 ret = phylink_sfp_config(pl, mode, phy->supported, phy->advertising);
2210 interface = pl->link_config.interface;
2211 ret = phylink_attach_phy(pl, phy, interface);
2215 ret = phylink_bringup_phy(pl, phy, interface);
2222 static void phylink_sfp_disconnect_phy(void *upstream)
2224 phylink_disconnect_phy(upstream);
2227 static const struct sfp_upstream_ops sfp_phylink_ops = {
2228 .attach = phylink_sfp_attach,
2229 .detach = phylink_sfp_detach,
2230 .module_insert = phylink_sfp_module_insert,
2231 .module_start = phylink_sfp_module_start,
2232 .module_stop = phylink_sfp_module_stop,
2233 .link_up = phylink_sfp_link_up,
2234 .link_down = phylink_sfp_link_down,
2235 .connect_phy = phylink_sfp_connect_phy,
2236 .disconnect_phy = phylink_sfp_disconnect_phy,
2239 /* Helpers for MAC drivers */
2242 * phylink_helper_basex_speed() - 1000BaseX/2500BaseX helper
2243 * @state: a pointer to a &struct phylink_link_state
2245 * Inspect the interface mode, advertising mask or forced speed and
2246 * decide whether to run at 2.5Gbit or 1Gbit appropriately, switching
2247 * the interface mode to suit. @state->interface is appropriately
2248 * updated, and the advertising mask has the "other" baseX_Full flag
2251 void phylink_helper_basex_speed(struct phylink_link_state *state)
2253 if (phy_interface_mode_is_8023z(state->interface)) {
2254 bool want_2500 = state->an_enabled ?
2255 phylink_test(state->advertising, 2500baseX_Full) :
2256 state->speed == SPEED_2500;
2259 phylink_clear(state->advertising, 1000baseX_Full);
2260 state->interface = PHY_INTERFACE_MODE_2500BASEX;
2262 phylink_clear(state->advertising, 2500baseX_Full);
2263 state->interface = PHY_INTERFACE_MODE_1000BASEX;
2267 EXPORT_SYMBOL_GPL(phylink_helper_basex_speed);
2269 static void phylink_decode_c37_word(struct phylink_link_state *state,
2270 uint16_t config_reg, int speed)
2272 bool tx_pause, rx_pause;
2275 if (speed == SPEED_2500)
2276 fd_bit = ETHTOOL_LINK_MODE_2500baseX_Full_BIT;
2278 fd_bit = ETHTOOL_LINK_MODE_1000baseX_Full_BIT;
2280 mii_lpa_mod_linkmode_x(state->lp_advertising, config_reg, fd_bit);
2282 if (linkmode_test_bit(fd_bit, state->advertising) &&
2283 linkmode_test_bit(fd_bit, state->lp_advertising)) {
2284 state->speed = speed;
2285 state->duplex = DUPLEX_FULL;
2287 /* negotiation failure */
2288 state->link = false;
2291 linkmode_resolve_pause(state->advertising, state->lp_advertising,
2292 &tx_pause, &rx_pause);
2295 state->pause |= MLO_PAUSE_TX;
2297 state->pause |= MLO_PAUSE_RX;
2300 static void phylink_decode_sgmii_word(struct phylink_link_state *state,
2301 uint16_t config_reg)
2303 if (!(config_reg & LPA_SGMII_LINK)) {
2304 state->link = false;
2308 switch (config_reg & LPA_SGMII_SPD_MASK) {
2310 state->speed = SPEED_10;
2313 state->speed = SPEED_100;
2315 case LPA_SGMII_1000:
2316 state->speed = SPEED_1000;
2319 state->link = false;
2322 if (config_reg & LPA_SGMII_FULL_DUPLEX)
2323 state->duplex = DUPLEX_FULL;
2325 state->duplex = DUPLEX_HALF;
2329 * phylink_decode_usxgmii_word() - decode the USXGMII word from a MAC PCS
2330 * @state: a pointer to a struct phylink_link_state.
2331 * @lpa: a 16 bit value which stores the USXGMII auto-negotiation word
2333 * Helper for MAC PCS supporting the USXGMII protocol and the auto-negotiation
2334 * code word. Decode the USXGMII code word and populate the corresponding fields
2335 * (speed, duplex) into the phylink_link_state structure.
2337 void phylink_decode_usxgmii_word(struct phylink_link_state *state,
2340 switch (lpa & MDIO_USXGMII_SPD_MASK) {
2341 case MDIO_USXGMII_10:
2342 state->speed = SPEED_10;
2344 case MDIO_USXGMII_100:
2345 state->speed = SPEED_100;
2347 case MDIO_USXGMII_1000:
2348 state->speed = SPEED_1000;
2350 case MDIO_USXGMII_2500:
2351 state->speed = SPEED_2500;
2353 case MDIO_USXGMII_5000:
2354 state->speed = SPEED_5000;
2356 case MDIO_USXGMII_10G:
2357 state->speed = SPEED_10000;
2360 state->link = false;
2364 if (lpa & MDIO_USXGMII_FULL_DUPLEX)
2365 state->duplex = DUPLEX_FULL;
2367 state->duplex = DUPLEX_HALF;
2369 EXPORT_SYMBOL_GPL(phylink_decode_usxgmii_word);
2372 * phylink_mii_c22_pcs_get_state() - read the MAC PCS state
2373 * @pcs: a pointer to a &struct mdio_device.
2374 * @state: a pointer to a &struct phylink_link_state.
2376 * Helper for MAC PCS supporting the 802.3 clause 22 register set for
2377 * clause 37 negotiation and/or SGMII control.
2379 * Read the MAC PCS state from the MII device configured in @config and
2380 * parse the Clause 37 or Cisco SGMII link partner negotiation word into
2381 * the phylink @state structure. This is suitable to be directly plugged
2382 * into the mac_pcs_get_state() member of the struct phylink_mac_ops
2385 void phylink_mii_c22_pcs_get_state(struct mdio_device *pcs,
2386 struct phylink_link_state *state)
2388 struct mii_bus *bus = pcs->bus;
2389 int addr = pcs->addr;
2392 bmsr = mdiobus_read(bus, addr, MII_BMSR);
2393 lpa = mdiobus_read(bus, addr, MII_LPA);
2394 if (bmsr < 0 || lpa < 0) {
2395 state->link = false;
2399 state->link = !!(bmsr & BMSR_LSTATUS);
2400 state->an_complete = !!(bmsr & BMSR_ANEGCOMPLETE);
2404 switch (state->interface) {
2405 case PHY_INTERFACE_MODE_1000BASEX:
2406 phylink_decode_c37_word(state, lpa, SPEED_1000);
2409 case PHY_INTERFACE_MODE_2500BASEX:
2410 phylink_decode_c37_word(state, lpa, SPEED_2500);
2413 case PHY_INTERFACE_MODE_SGMII:
2414 case PHY_INTERFACE_MODE_QSGMII:
2415 phylink_decode_sgmii_word(state, lpa);
2419 state->link = false;
2423 EXPORT_SYMBOL_GPL(phylink_mii_c22_pcs_get_state);
2426 * phylink_mii_c22_pcs_set_advertisement() - configure the clause 37 PCS
2428 * @pcs: a pointer to a &struct mdio_device.
2429 * @interface: the PHY interface mode being configured
2430 * @advertising: the ethtool advertisement mask
2432 * Helper for MAC PCS supporting the 802.3 clause 22 register set for
2433 * clause 37 negotiation and/or SGMII control.
2435 * Configure the clause 37 PCS advertisement as specified by @state. This
2436 * does not trigger a renegotiation; phylink will do that via the
2437 * mac_an_restart() method of the struct phylink_mac_ops structure.
2439 * Returns negative error code on failure to configure the advertisement,
2440 * zero if no change has been made, or one if the advertisement has changed.
2442 int phylink_mii_c22_pcs_set_advertisement(struct mdio_device *pcs,
2443 phy_interface_t interface,
2444 const unsigned long *advertising)
2446 struct mii_bus *bus = pcs->bus;
2447 int addr = pcs->addr;
2451 switch (interface) {
2452 case PHY_INTERFACE_MODE_1000BASEX:
2453 case PHY_INTERFACE_MODE_2500BASEX:
2454 adv = ADVERTISE_1000XFULL;
2455 if (linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
2457 adv |= ADVERTISE_1000XPAUSE;
2458 if (linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
2460 adv |= ADVERTISE_1000XPSE_ASYM;
2462 val = mdiobus_read(bus, addr, MII_ADVERTISE);
2469 ret = mdiobus_write(bus, addr, MII_ADVERTISE, adv);
2475 case PHY_INTERFACE_MODE_SGMII:
2476 val = mdiobus_read(bus, addr, MII_ADVERTISE);
2483 ret = mdiobus_write(bus, addr, MII_ADVERTISE, 0x0001);
2490 /* Nothing to do for other modes */
2494 EXPORT_SYMBOL_GPL(phylink_mii_c22_pcs_set_advertisement);
2497 * phylink_mii_c22_pcs_config() - configure clause 22 PCS
2498 * @pcs: a pointer to a &struct mdio_device.
2499 * @mode: link autonegotiation mode
2500 * @interface: the PHY interface mode being configured
2501 * @advertising: the ethtool advertisement mask
2503 * Configure a Clause 22 PCS PHY with the appropriate negotiation
2504 * parameters for the @mode, @interface and @advertising parameters.
2505 * Returns negative error number on failure, zero if the advertisement
2506 * has not changed, or positive if there is a change.
2508 int phylink_mii_c22_pcs_config(struct mdio_device *pcs, unsigned int mode,
2509 phy_interface_t interface,
2510 const unsigned long *advertising)
2516 ret = phylink_mii_c22_pcs_set_advertisement(pcs, interface,
2523 /* Ensure ISOLATE bit is disabled */
2524 bmcr = mode == MLO_AN_INBAND ? BMCR_ANENABLE : 0;
2525 ret = mdiobus_modify(pcs->bus, pcs->addr, MII_BMCR,
2526 BMCR_ANENABLE | BMCR_ISOLATE, bmcr);
2530 return changed ? 1 : 0;
2532 EXPORT_SYMBOL_GPL(phylink_mii_c22_pcs_config);
2535 * phylink_mii_c22_pcs_an_restart() - restart 802.3z autonegotiation
2536 * @pcs: a pointer to a &struct mdio_device.
2538 * Helper for MAC PCS supporting the 802.3 clause 22 register set for
2539 * clause 37 negotiation.
2541 * Restart the clause 37 negotiation with the link partner. This is
2542 * suitable to be directly plugged into the mac_pcs_get_state() member
2543 * of the struct phylink_mac_ops structure.
2545 void phylink_mii_c22_pcs_an_restart(struct mdio_device *pcs)
2547 struct mii_bus *bus = pcs->bus;
2548 int val, addr = pcs->addr;
2550 val = mdiobus_read(bus, addr, MII_BMCR);
2552 val |= BMCR_ANRESTART;
2554 mdiobus_write(bus, addr, MII_BMCR, val);
2557 EXPORT_SYMBOL_GPL(phylink_mii_c22_pcs_an_restart);
2559 void phylink_mii_c45_pcs_get_state(struct mdio_device *pcs,
2560 struct phylink_link_state *state)
2562 struct mii_bus *bus = pcs->bus;
2563 int addr = pcs->addr;
2566 stat = mdiobus_c45_read(bus, addr, MDIO_MMD_PCS, MDIO_STAT1);
2568 state->link = false;
2572 state->link = !!(stat & MDIO_STAT1_LSTATUS);
2576 switch (state->interface) {
2577 case PHY_INTERFACE_MODE_10GBASER:
2578 state->speed = SPEED_10000;
2579 state->duplex = DUPLEX_FULL;
2586 EXPORT_SYMBOL_GPL(phylink_mii_c45_pcs_get_state);
2588 MODULE_LICENSE("GPL v2");