1 /* 2 * phylink models the MAC to optional PHY connection, supporting 3 * technologies such as SFP cages where the PHY is hot-pluggable. 4 * 5 * Copyright (C) 2015 Russell King 6 * 7 * This program is free software; you can redistribute it and/or modify 8 * it under the terms of the GNU General Public License version 2 as 9 * published by the Free Software Foundation. 10 */ 11 #include <linux/ethtool.h> 12 #include <linux/export.h> 13 #include <linux/gpio/consumer.h> 14 #include <linux/netdevice.h> 15 #include <linux/of.h> 16 #include <linux/of_mdio.h> 17 #include <linux/phy.h> 18 #include <linux/phy_fixed.h> 19 #include <linux/phylink.h> 20 #include <linux/rtnetlink.h> 21 #include <linux/spinlock.h> 22 #include <linux/timer.h> 23 #include <linux/workqueue.h> 24 25 #include "sfp.h" 26 #include "swphy.h" 27 28 #define SUPPORTED_INTERFACES \ 29 (SUPPORTED_TP | SUPPORTED_MII | SUPPORTED_FIBRE | \ 30 SUPPORTED_BNC | SUPPORTED_AUI | SUPPORTED_Backplane) 31 #define ADVERTISED_INTERFACES \ 32 (ADVERTISED_TP | ADVERTISED_MII | ADVERTISED_FIBRE | \ 33 ADVERTISED_BNC | ADVERTISED_AUI | ADVERTISED_Backplane) 34 35 enum { 36 PHYLINK_DISABLE_STOPPED, 37 PHYLINK_DISABLE_LINK, 38 }; 39 40 /** 41 * struct phylink - internal data type for phylink 42 */ 43 struct phylink { 44 /* private: */ 45 struct net_device *netdev; 46 const struct phylink_mac_ops *ops; 47 48 unsigned long phylink_disable_state; /* bitmask of disables */ 49 struct phy_device *phydev; 50 phy_interface_t link_interface; /* PHY_INTERFACE_xxx */ 51 u8 link_an_mode; /* MLO_AN_xxx */ 52 u8 link_port; /* The current non-phy ethtool port */ 53 __ETHTOOL_DECLARE_LINK_MODE_MASK(supported); 54 55 /* The link configuration settings */ 56 struct phylink_link_state link_config; 57 struct gpio_desc *link_gpio; 58 struct timer_list link_poll; 59 void (*get_fixed_state)(struct net_device *dev, 60 struct phylink_link_state *s); 61 62 struct mutex state_mutex; 63 struct phylink_link_state phy_state; 64 struct work_struct resolve; 65 66 bool mac_link_dropped; 67 68 struct sfp_bus *sfp_bus; 69 }; 70 71 static inline void linkmode_zero(unsigned long *dst) 72 { 73 bitmap_zero(dst, __ETHTOOL_LINK_MODE_MASK_NBITS); 74 } 75 76 static inline void linkmode_copy(unsigned long *dst, const unsigned long *src) 77 { 78 bitmap_copy(dst, src, __ETHTOOL_LINK_MODE_MASK_NBITS); 79 } 80 81 static inline void linkmode_and(unsigned long *dst, const unsigned long *a, 82 const unsigned long *b) 83 { 84 bitmap_and(dst, a, b, __ETHTOOL_LINK_MODE_MASK_NBITS); 85 } 86 87 static inline void linkmode_or(unsigned long *dst, const unsigned long *a, 88 const unsigned long *b) 89 { 90 bitmap_or(dst, a, b, __ETHTOOL_LINK_MODE_MASK_NBITS); 91 } 92 93 static inline bool linkmode_empty(const unsigned long *src) 94 { 95 return bitmap_empty(src, __ETHTOOL_LINK_MODE_MASK_NBITS); 96 } 97 98 /** 99 * phylink_set_port_modes() - set the port type modes in the ethtool mask 100 * @mask: ethtool link mode mask 101 * 102 * Sets all the port type modes in the ethtool mask. MAC drivers should 103 * use this in their 'validate' callback. 104 */ 105 void phylink_set_port_modes(unsigned long *mask) 106 { 107 phylink_set(mask, TP); 108 phylink_set(mask, AUI); 109 phylink_set(mask, MII); 110 phylink_set(mask, FIBRE); 111 phylink_set(mask, BNC); 112 phylink_set(mask, Backplane); 113 } 114 EXPORT_SYMBOL_GPL(phylink_set_port_modes); 115 116 static int phylink_is_empty_linkmode(const unsigned long *linkmode) 117 { 118 __ETHTOOL_DECLARE_LINK_MODE_MASK(tmp) = { 0, }; 119 120 phylink_set_port_modes(tmp); 121 phylink_set(tmp, Autoneg); 122 phylink_set(tmp, Pause); 123 phylink_set(tmp, Asym_Pause); 124 125 bitmap_andnot(tmp, linkmode, tmp, __ETHTOOL_LINK_MODE_MASK_NBITS); 126 127 return linkmode_empty(tmp); 128 } 129 130 static const char *phylink_an_mode_str(unsigned int mode) 131 { 132 static const char *modestr[] = { 133 [MLO_AN_PHY] = "phy", 134 [MLO_AN_FIXED] = "fixed", 135 [MLO_AN_INBAND] = "inband", 136 }; 137 138 return mode < ARRAY_SIZE(modestr) ? modestr[mode] : "unknown"; 139 } 140 141 static int phylink_validate(struct phylink *pl, unsigned long *supported, 142 struct phylink_link_state *state) 143 { 144 pl->ops->validate(pl->netdev, supported, state); 145 146 return phylink_is_empty_linkmode(supported) ? -EINVAL : 0; 147 } 148 149 static int phylink_parse_fixedlink(struct phylink *pl, 150 struct fwnode_handle *fwnode) 151 { 152 struct fwnode_handle *fixed_node; 153 const struct phy_setting *s; 154 struct gpio_desc *desc; 155 u32 speed; 156 int ret; 157 158 fixed_node = fwnode_get_named_child_node(fwnode, "fixed-link"); 159 if (fixed_node) { 160 ret = fwnode_property_read_u32(fixed_node, "speed", &speed); 161 162 pl->link_config.speed = speed; 163 pl->link_config.duplex = DUPLEX_HALF; 164 165 if (fwnode_property_read_bool(fixed_node, "full-duplex")) 166 pl->link_config.duplex = DUPLEX_FULL; 167 168 /* We treat the "pause" and "asym-pause" terminology as 169 * defining the link partner's ability. */ 170 if (fwnode_property_read_bool(fixed_node, "pause")) 171 pl->link_config.pause |= MLO_PAUSE_SYM; 172 if (fwnode_property_read_bool(fixed_node, "asym-pause")) 173 pl->link_config.pause |= MLO_PAUSE_ASYM; 174 175 if (ret == 0) { 176 desc = fwnode_get_named_gpiod(fixed_node, "link-gpios", 177 0, GPIOD_IN, "?"); 178 179 if (!IS_ERR(desc)) 180 pl->link_gpio = desc; 181 else if (desc == ERR_PTR(-EPROBE_DEFER)) 182 ret = -EPROBE_DEFER; 183 } 184 fwnode_handle_put(fixed_node); 185 186 if (ret) 187 return ret; 188 } else { 189 u32 prop[5]; 190 191 ret = fwnode_property_read_u32_array(fwnode, "fixed-link", 192 NULL, 0); 193 if (ret != ARRAY_SIZE(prop)) { 194 netdev_err(pl->netdev, "broken fixed-link?\n"); 195 return -EINVAL; 196 } 197 198 ret = fwnode_property_read_u32_array(fwnode, "fixed-link", 199 prop, ARRAY_SIZE(prop)); 200 if (!ret) { 201 pl->link_config.duplex = prop[1] ? 202 DUPLEX_FULL : DUPLEX_HALF; 203 pl->link_config.speed = prop[2]; 204 if (prop[3]) 205 pl->link_config.pause |= MLO_PAUSE_SYM; 206 if (prop[4]) 207 pl->link_config.pause |= MLO_PAUSE_ASYM; 208 } 209 } 210 211 if (pl->link_config.speed > SPEED_1000 && 212 pl->link_config.duplex != DUPLEX_FULL) 213 netdev_warn(pl->netdev, "fixed link specifies half duplex for %dMbps link?\n", 214 pl->link_config.speed); 215 216 bitmap_fill(pl->supported, __ETHTOOL_LINK_MODE_MASK_NBITS); 217 linkmode_copy(pl->link_config.advertising, pl->supported); 218 phylink_validate(pl, pl->supported, &pl->link_config); 219 220 s = phy_lookup_setting(pl->link_config.speed, pl->link_config.duplex, 221 pl->supported, 222 __ETHTOOL_LINK_MODE_MASK_NBITS, true); 223 linkmode_zero(pl->supported); 224 phylink_set(pl->supported, MII); 225 if (s) { 226 __set_bit(s->bit, pl->supported); 227 } else { 228 netdev_warn(pl->netdev, "fixed link %s duplex %dMbps not recognised\n", 229 pl->link_config.duplex == DUPLEX_FULL ? "full" : "half", 230 pl->link_config.speed); 231 } 232 233 linkmode_and(pl->link_config.advertising, pl->link_config.advertising, 234 pl->supported); 235 236 pl->link_config.link = 1; 237 pl->link_config.an_complete = 1; 238 239 return 0; 240 } 241 242 static int phylink_parse_mode(struct phylink *pl, struct fwnode_handle *fwnode) 243 { 244 struct fwnode_handle *dn; 245 const char *managed; 246 247 dn = fwnode_get_named_child_node(fwnode, "fixed-link"); 248 if (dn || fwnode_property_present(fwnode, "fixed-link")) 249 pl->link_an_mode = MLO_AN_FIXED; 250 fwnode_handle_put(dn); 251 252 if (fwnode_property_read_string(fwnode, "managed", &managed) == 0 && 253 strcmp(managed, "in-band-status") == 0) { 254 if (pl->link_an_mode == MLO_AN_FIXED) { 255 netdev_err(pl->netdev, 256 "can't use both fixed-link and in-band-status\n"); 257 return -EINVAL; 258 } 259 260 linkmode_zero(pl->supported); 261 phylink_set(pl->supported, MII); 262 phylink_set(pl->supported, Autoneg); 263 phylink_set(pl->supported, Asym_Pause); 264 phylink_set(pl->supported, Pause); 265 pl->link_config.an_enabled = true; 266 pl->link_an_mode = MLO_AN_INBAND; 267 268 switch (pl->link_config.interface) { 269 case PHY_INTERFACE_MODE_SGMII: 270 phylink_set(pl->supported, 10baseT_Half); 271 phylink_set(pl->supported, 10baseT_Full); 272 phylink_set(pl->supported, 100baseT_Half); 273 phylink_set(pl->supported, 100baseT_Full); 274 phylink_set(pl->supported, 1000baseT_Half); 275 phylink_set(pl->supported, 1000baseT_Full); 276 break; 277 278 case PHY_INTERFACE_MODE_1000BASEX: 279 phylink_set(pl->supported, 1000baseX_Full); 280 break; 281 282 case PHY_INTERFACE_MODE_2500BASEX: 283 phylink_set(pl->supported, 2500baseX_Full); 284 break; 285 286 case PHY_INTERFACE_MODE_10GKR: 287 phylink_set(pl->supported, 10baseT_Half); 288 phylink_set(pl->supported, 10baseT_Full); 289 phylink_set(pl->supported, 100baseT_Half); 290 phylink_set(pl->supported, 100baseT_Full); 291 phylink_set(pl->supported, 1000baseT_Half); 292 phylink_set(pl->supported, 1000baseT_Full); 293 phylink_set(pl->supported, 1000baseX_Full); 294 phylink_set(pl->supported, 10000baseKR_Full); 295 phylink_set(pl->supported, 10000baseCR_Full); 296 phylink_set(pl->supported, 10000baseSR_Full); 297 phylink_set(pl->supported, 10000baseLR_Full); 298 phylink_set(pl->supported, 10000baseLRM_Full); 299 phylink_set(pl->supported, 10000baseER_Full); 300 break; 301 302 default: 303 netdev_err(pl->netdev, 304 "incorrect link mode %s for in-band status\n", 305 phy_modes(pl->link_config.interface)); 306 return -EINVAL; 307 } 308 309 linkmode_copy(pl->link_config.advertising, pl->supported); 310 311 if (phylink_validate(pl, pl->supported, &pl->link_config)) { 312 netdev_err(pl->netdev, 313 "failed to validate link configuration for in-band status\n"); 314 return -EINVAL; 315 } 316 } 317 318 return 0; 319 } 320 321 static void phylink_mac_config(struct phylink *pl, 322 const struct phylink_link_state *state) 323 { 324 netdev_dbg(pl->netdev, 325 "%s: mode=%s/%s/%s/%s adv=%*pb pause=%02x link=%u an=%u\n", 326 __func__, phylink_an_mode_str(pl->link_an_mode), 327 phy_modes(state->interface), 328 phy_speed_to_str(state->speed), 329 phy_duplex_to_str(state->duplex), 330 __ETHTOOL_LINK_MODE_MASK_NBITS, state->advertising, 331 state->pause, state->link, state->an_enabled); 332 333 pl->ops->mac_config(pl->netdev, pl->link_an_mode, state); 334 } 335 336 static void phylink_mac_an_restart(struct phylink *pl) 337 { 338 if (pl->link_config.an_enabled && 339 phy_interface_mode_is_8023z(pl->link_config.interface)) 340 pl->ops->mac_an_restart(pl->netdev); 341 } 342 343 static int phylink_get_mac_state(struct phylink *pl, struct phylink_link_state *state) 344 { 345 struct net_device *ndev = pl->netdev; 346 347 linkmode_copy(state->advertising, pl->link_config.advertising); 348 linkmode_zero(state->lp_advertising); 349 state->interface = pl->link_config.interface; 350 state->an_enabled = pl->link_config.an_enabled; 351 state->link = 1; 352 353 return pl->ops->mac_link_state(ndev, state); 354 } 355 356 /* The fixed state is... fixed except for the link state, 357 * which may be determined by a GPIO or a callback. 358 */ 359 static void phylink_get_fixed_state(struct phylink *pl, struct phylink_link_state *state) 360 { 361 *state = pl->link_config; 362 if (pl->get_fixed_state) 363 pl->get_fixed_state(pl->netdev, state); 364 else if (pl->link_gpio) 365 state->link = !!gpiod_get_value_cansleep(pl->link_gpio); 366 } 367 368 /* Flow control is resolved according to our and the link partners 369 * advertisements using the following drawn from the 802.3 specs: 370 * Local device Link partner 371 * Pause AsymDir Pause AsymDir Result 372 * 1 X 1 X TX+RX 373 * 0 1 1 1 RX 374 * 1 1 0 1 TX 375 */ 376 static void phylink_resolve_flow(struct phylink *pl, 377 struct phylink_link_state *state) 378 { 379 int new_pause = 0; 380 381 if (pl->link_config.pause & MLO_PAUSE_AN) { 382 int pause = 0; 383 384 if (phylink_test(pl->link_config.advertising, Pause)) 385 pause |= MLO_PAUSE_SYM; 386 if (phylink_test(pl->link_config.advertising, Asym_Pause)) 387 pause |= MLO_PAUSE_ASYM; 388 389 pause &= state->pause; 390 391 if (pause & MLO_PAUSE_SYM) 392 new_pause = MLO_PAUSE_TX | MLO_PAUSE_RX; 393 else if (pause & MLO_PAUSE_ASYM) 394 new_pause = state->pause & MLO_PAUSE_SYM ? 395 MLO_PAUSE_RX : MLO_PAUSE_TX; 396 } else { 397 new_pause = pl->link_config.pause & MLO_PAUSE_TXRX_MASK; 398 } 399 400 state->pause &= ~MLO_PAUSE_TXRX_MASK; 401 state->pause |= new_pause; 402 } 403 404 static const char *phylink_pause_to_str(int pause) 405 { 406 switch (pause & MLO_PAUSE_TXRX_MASK) { 407 case MLO_PAUSE_TX | MLO_PAUSE_RX: 408 return "rx/tx"; 409 case MLO_PAUSE_TX: 410 return "tx"; 411 case MLO_PAUSE_RX: 412 return "rx"; 413 default: 414 return "off"; 415 } 416 } 417 418 static void phylink_resolve(struct work_struct *w) 419 { 420 struct phylink *pl = container_of(w, struct phylink, resolve); 421 struct phylink_link_state link_state; 422 struct net_device *ndev = pl->netdev; 423 424 mutex_lock(&pl->state_mutex); 425 if (pl->phylink_disable_state) { 426 pl->mac_link_dropped = false; 427 link_state.link = false; 428 } else if (pl->mac_link_dropped) { 429 link_state.link = false; 430 } else { 431 switch (pl->link_an_mode) { 432 case MLO_AN_PHY: 433 link_state = pl->phy_state; 434 phylink_resolve_flow(pl, &link_state); 435 phylink_mac_config(pl, &link_state); 436 break; 437 438 case MLO_AN_FIXED: 439 phylink_get_fixed_state(pl, &link_state); 440 phylink_mac_config(pl, &link_state); 441 break; 442 443 case MLO_AN_INBAND: 444 phylink_get_mac_state(pl, &link_state); 445 if (pl->phydev) { 446 bool changed = false; 447 448 link_state.link = link_state.link && 449 pl->phy_state.link; 450 451 if (pl->phy_state.interface != 452 link_state.interface) { 453 link_state.interface = pl->phy_state.interface; 454 changed = true; 455 } 456 457 /* Propagate the flow control from the PHY 458 * to the MAC. Also propagate the interface 459 * if changed. 460 */ 461 if (pl->phy_state.link || changed) { 462 link_state.pause |= pl->phy_state.pause; 463 phylink_resolve_flow(pl, &link_state); 464 465 phylink_mac_config(pl, &link_state); 466 } 467 } 468 break; 469 } 470 } 471 472 if (link_state.link != netif_carrier_ok(ndev)) { 473 if (!link_state.link) { 474 netif_carrier_off(ndev); 475 pl->ops->mac_link_down(ndev, pl->link_an_mode, 476 pl->phy_state.interface); 477 netdev_info(ndev, "Link is Down\n"); 478 } else { 479 pl->ops->mac_link_up(ndev, pl->link_an_mode, 480 pl->phy_state.interface, 481 pl->phydev); 482 483 netif_carrier_on(ndev); 484 485 netdev_info(ndev, 486 "Link is Up - %s/%s - flow control %s\n", 487 phy_speed_to_str(link_state.speed), 488 phy_duplex_to_str(link_state.duplex), 489 phylink_pause_to_str(link_state.pause)); 490 } 491 } 492 if (!link_state.link && pl->mac_link_dropped) { 493 pl->mac_link_dropped = false; 494 queue_work(system_power_efficient_wq, &pl->resolve); 495 } 496 mutex_unlock(&pl->state_mutex); 497 } 498 499 static void phylink_run_resolve(struct phylink *pl) 500 { 501 if (!pl->phylink_disable_state) 502 queue_work(system_power_efficient_wq, &pl->resolve); 503 } 504 505 static void phylink_fixed_poll(struct timer_list *t) 506 { 507 struct phylink *pl = container_of(t, struct phylink, link_poll); 508 509 mod_timer(t, jiffies + HZ); 510 511 phylink_run_resolve(pl); 512 } 513 514 static const struct sfp_upstream_ops sfp_phylink_ops; 515 516 static int phylink_register_sfp(struct phylink *pl, 517 struct fwnode_handle *fwnode) 518 { 519 struct fwnode_reference_args ref; 520 int ret; 521 522 if (!fwnode) 523 return 0; 524 525 ret = fwnode_property_get_reference_args(fwnode, "sfp", NULL, 526 0, 0, &ref); 527 if (ret < 0) { 528 if (ret == -ENOENT) 529 return 0; 530 531 netdev_err(pl->netdev, "unable to parse \"sfp\" node: %d\n", 532 ret); 533 return ret; 534 } 535 536 pl->sfp_bus = sfp_register_upstream(ref.fwnode, pl->netdev, pl, 537 &sfp_phylink_ops); 538 if (!pl->sfp_bus) 539 return -ENOMEM; 540 541 return 0; 542 } 543 544 /** 545 * phylink_create() - create a phylink instance 546 * @ndev: a pointer to the &struct net_device 547 * @fwnode: a pointer to a &struct fwnode_handle describing the network 548 * interface 549 * @iface: the desired link mode defined by &typedef phy_interface_t 550 * @ops: a pointer to a &struct phylink_mac_ops for the MAC. 551 * 552 * Create a new phylink instance, and parse the link parameters found in @np. 553 * This will parse in-band modes, fixed-link or SFP configuration. 554 * 555 * Returns a pointer to a &struct phylink, or an error-pointer value. Users 556 * must use IS_ERR() to check for errors from this function. 557 */ 558 struct phylink *phylink_create(struct net_device *ndev, 559 struct fwnode_handle *fwnode, 560 phy_interface_t iface, 561 const struct phylink_mac_ops *ops) 562 { 563 struct phylink *pl; 564 int ret; 565 566 pl = kzalloc(sizeof(*pl), GFP_KERNEL); 567 if (!pl) 568 return ERR_PTR(-ENOMEM); 569 570 mutex_init(&pl->state_mutex); 571 INIT_WORK(&pl->resolve, phylink_resolve); 572 pl->netdev = ndev; 573 pl->phy_state.interface = iface; 574 pl->link_interface = iface; 575 if (iface == PHY_INTERFACE_MODE_MOCA) 576 pl->link_port = PORT_BNC; 577 else 578 pl->link_port = PORT_MII; 579 pl->link_config.interface = iface; 580 pl->link_config.pause = MLO_PAUSE_AN; 581 pl->link_config.speed = SPEED_UNKNOWN; 582 pl->link_config.duplex = DUPLEX_UNKNOWN; 583 pl->link_config.an_enabled = true; 584 pl->ops = ops; 585 __set_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state); 586 timer_setup(&pl->link_poll, phylink_fixed_poll, 0); 587 588 bitmap_fill(pl->supported, __ETHTOOL_LINK_MODE_MASK_NBITS); 589 linkmode_copy(pl->link_config.advertising, pl->supported); 590 phylink_validate(pl, pl->supported, &pl->link_config); 591 592 ret = phylink_parse_mode(pl, fwnode); 593 if (ret < 0) { 594 kfree(pl); 595 return ERR_PTR(ret); 596 } 597 598 if (pl->link_an_mode == MLO_AN_FIXED) { 599 ret = phylink_parse_fixedlink(pl, fwnode); 600 if (ret < 0) { 601 kfree(pl); 602 return ERR_PTR(ret); 603 } 604 } 605 606 ret = phylink_register_sfp(pl, fwnode); 607 if (ret < 0) { 608 kfree(pl); 609 return ERR_PTR(ret); 610 } 611 612 return pl; 613 } 614 EXPORT_SYMBOL_GPL(phylink_create); 615 616 /** 617 * phylink_destroy() - cleanup and destroy the phylink instance 618 * @pl: a pointer to a &struct phylink returned from phylink_create() 619 * 620 * Destroy a phylink instance. Any PHY that has been attached must have been 621 * cleaned up via phylink_disconnect_phy() prior to calling this function. 622 */ 623 void phylink_destroy(struct phylink *pl) 624 { 625 if (pl->sfp_bus) 626 sfp_unregister_upstream(pl->sfp_bus); 627 if (!IS_ERR_OR_NULL(pl->link_gpio)) 628 gpiod_put(pl->link_gpio); 629 630 cancel_work_sync(&pl->resolve); 631 kfree(pl); 632 } 633 EXPORT_SYMBOL_GPL(phylink_destroy); 634 635 static void phylink_phy_change(struct phy_device *phydev, bool up, 636 bool do_carrier) 637 { 638 struct phylink *pl = phydev->phylink; 639 640 mutex_lock(&pl->state_mutex); 641 pl->phy_state.speed = phydev->speed; 642 pl->phy_state.duplex = phydev->duplex; 643 pl->phy_state.pause = MLO_PAUSE_NONE; 644 if (phydev->pause) 645 pl->phy_state.pause |= MLO_PAUSE_SYM; 646 if (phydev->asym_pause) 647 pl->phy_state.pause |= MLO_PAUSE_ASYM; 648 pl->phy_state.interface = phydev->interface; 649 pl->phy_state.link = up; 650 mutex_unlock(&pl->state_mutex); 651 652 phylink_run_resolve(pl); 653 654 netdev_dbg(pl->netdev, "phy link %s %s/%s/%s\n", up ? "up" : "down", 655 phy_modes(phydev->interface), 656 phy_speed_to_str(phydev->speed), 657 phy_duplex_to_str(phydev->duplex)); 658 } 659 660 static int phylink_bringup_phy(struct phylink *pl, struct phy_device *phy) 661 { 662 struct phylink_link_state config; 663 __ETHTOOL_DECLARE_LINK_MODE_MASK(supported); 664 u32 advertising; 665 int ret; 666 667 memset(&config, 0, sizeof(config)); 668 ethtool_convert_legacy_u32_to_link_mode(supported, phy->supported); 669 ethtool_convert_legacy_u32_to_link_mode(config.advertising, 670 phy->advertising); 671 config.interface = pl->link_config.interface; 672 673 /* 674 * This is the new way of dealing with flow control for PHYs, 675 * as described by Timur Tabi in commit 529ed1275263 ("net: phy: 676 * phy drivers should not set SUPPORTED_[Asym_]Pause") except 677 * using our validate call to the MAC, we rely upon the MAC 678 * clearing the bits from both supported and advertising fields. 679 */ 680 if (phylink_test(supported, Pause)) 681 phylink_set(config.advertising, Pause); 682 if (phylink_test(supported, Asym_Pause)) 683 phylink_set(config.advertising, Asym_Pause); 684 685 ret = phylink_validate(pl, supported, &config); 686 if (ret) 687 return ret; 688 689 phy->phylink = pl; 690 phy->phy_link_change = phylink_phy_change; 691 692 netdev_info(pl->netdev, 693 "PHY [%s] driver [%s]\n", dev_name(&phy->mdio.dev), 694 phy->drv->name); 695 696 mutex_lock(&phy->lock); 697 mutex_lock(&pl->state_mutex); 698 pl->phydev = phy; 699 linkmode_copy(pl->supported, supported); 700 linkmode_copy(pl->link_config.advertising, config.advertising); 701 702 /* Restrict the phy advertisement according to the MAC support. */ 703 ethtool_convert_link_mode_to_legacy_u32(&advertising, config.advertising); 704 phy->advertising = advertising; 705 mutex_unlock(&pl->state_mutex); 706 mutex_unlock(&phy->lock); 707 708 netdev_dbg(pl->netdev, 709 "phy: setting supported %*pb advertising 0x%08x\n", 710 __ETHTOOL_LINK_MODE_MASK_NBITS, pl->supported, 711 phy->advertising); 712 713 phy_start_machine(phy); 714 if (phy->irq > 0) 715 phy_start_interrupts(phy); 716 717 return 0; 718 } 719 720 /** 721 * phylink_connect_phy() - connect a PHY to the phylink instance 722 * @pl: a pointer to a &struct phylink returned from phylink_create() 723 * @phy: a pointer to a &struct phy_device. 724 * 725 * Connect @phy to the phylink instance specified by @pl by calling 726 * phy_attach_direct(). Configure the @phy according to the MAC driver's 727 * capabilities, start the PHYLIB state machine and enable any interrupts 728 * that the PHY supports. 729 * 730 * This updates the phylink's ethtool supported and advertising link mode 731 * masks. 732 * 733 * Returns 0 on success or a negative errno. 734 */ 735 int phylink_connect_phy(struct phylink *pl, struct phy_device *phy) 736 { 737 int ret; 738 739 if (WARN_ON(pl->link_an_mode == MLO_AN_FIXED || 740 (pl->link_an_mode == MLO_AN_INBAND && 741 phy_interface_mode_is_8023z(pl->link_interface)))) 742 return -EINVAL; 743 744 if (pl->phydev) 745 return -EBUSY; 746 747 /* Use PHY device/driver interface */ 748 if (pl->link_interface == PHY_INTERFACE_MODE_NA) { 749 pl->link_interface = phy->interface; 750 pl->link_config.interface = pl->link_interface; 751 } 752 753 ret = phy_attach_direct(pl->netdev, phy, 0, pl->link_interface); 754 if (ret) 755 return ret; 756 757 ret = phylink_bringup_phy(pl, phy); 758 if (ret) 759 phy_detach(phy); 760 761 return ret; 762 } 763 EXPORT_SYMBOL_GPL(phylink_connect_phy); 764 765 /** 766 * phylink_of_phy_connect() - connect the PHY specified in the DT mode. 767 * @pl: a pointer to a &struct phylink returned from phylink_create() 768 * @dn: a pointer to a &struct device_node. 769 * @flags: PHY-specific flags to communicate to the PHY device driver 770 * 771 * Connect the phy specified in the device node @dn to the phylink instance 772 * specified by @pl. Actions specified in phylink_connect_phy() will be 773 * performed. 774 * 775 * Returns 0 on success or a negative errno. 776 */ 777 int phylink_of_phy_connect(struct phylink *pl, struct device_node *dn, 778 u32 flags) 779 { 780 struct device_node *phy_node; 781 struct phy_device *phy_dev; 782 int ret; 783 784 /* Fixed links and 802.3z are handled without needing a PHY */ 785 if (pl->link_an_mode == MLO_AN_FIXED || 786 (pl->link_an_mode == MLO_AN_INBAND && 787 phy_interface_mode_is_8023z(pl->link_interface))) 788 return 0; 789 790 phy_node = of_parse_phandle(dn, "phy-handle", 0); 791 if (!phy_node) 792 phy_node = of_parse_phandle(dn, "phy", 0); 793 if (!phy_node) 794 phy_node = of_parse_phandle(dn, "phy-device", 0); 795 796 if (!phy_node) { 797 if (pl->link_an_mode == MLO_AN_PHY) 798 return -ENODEV; 799 return 0; 800 } 801 802 phy_dev = of_phy_attach(pl->netdev, phy_node, flags, 803 pl->link_interface); 804 /* We're done with the phy_node handle */ 805 of_node_put(phy_node); 806 807 if (!phy_dev) 808 return -ENODEV; 809 810 ret = phylink_bringup_phy(pl, phy_dev); 811 if (ret) 812 phy_detach(phy_dev); 813 814 return ret; 815 } 816 EXPORT_SYMBOL_GPL(phylink_of_phy_connect); 817 818 /** 819 * phylink_disconnect_phy() - disconnect any PHY attached to the phylink 820 * instance. 821 * @pl: a pointer to a &struct phylink returned from phylink_create() 822 * 823 * Disconnect any current PHY from the phylink instance described by @pl. 824 */ 825 void phylink_disconnect_phy(struct phylink *pl) 826 { 827 struct phy_device *phy; 828 829 ASSERT_RTNL(); 830 831 phy = pl->phydev; 832 if (phy) { 833 mutex_lock(&phy->lock); 834 mutex_lock(&pl->state_mutex); 835 pl->phydev = NULL; 836 mutex_unlock(&pl->state_mutex); 837 mutex_unlock(&phy->lock); 838 flush_work(&pl->resolve); 839 840 phy_disconnect(phy); 841 } 842 } 843 EXPORT_SYMBOL_GPL(phylink_disconnect_phy); 844 845 /** 846 * phylink_fixed_state_cb() - allow setting a fixed link callback 847 * @pl: a pointer to a &struct phylink returned from phylink_create() 848 * @cb: callback to execute to determine the fixed link state. 849 * 850 * The MAC driver should call this driver when the state of its link 851 * can be determined through e.g: an out of band MMIO register. 852 */ 853 int phylink_fixed_state_cb(struct phylink *pl, 854 void (*cb)(struct net_device *dev, 855 struct phylink_link_state *state)) 856 { 857 /* It does not make sense to let the link be overriden unless we use 858 * MLO_AN_FIXED 859 */ 860 if (pl->link_an_mode != MLO_AN_FIXED) 861 return -EINVAL; 862 863 mutex_lock(&pl->state_mutex); 864 pl->get_fixed_state = cb; 865 mutex_unlock(&pl->state_mutex); 866 867 return 0; 868 } 869 EXPORT_SYMBOL_GPL(phylink_fixed_state_cb); 870 871 /** 872 * phylink_mac_change() - notify phylink of a change in MAC state 873 * @pl: a pointer to a &struct phylink returned from phylink_create() 874 * @up: indicates whether the link is currently up. 875 * 876 * The MAC driver should call this driver when the state of its link 877 * changes (eg, link failure, new negotiation results, etc.) 878 */ 879 void phylink_mac_change(struct phylink *pl, bool up) 880 { 881 if (!up) 882 pl->mac_link_dropped = true; 883 phylink_run_resolve(pl); 884 netdev_dbg(pl->netdev, "mac link %s\n", up ? "up" : "down"); 885 } 886 EXPORT_SYMBOL_GPL(phylink_mac_change); 887 888 /** 889 * phylink_start() - start a phylink instance 890 * @pl: a pointer to a &struct phylink returned from phylink_create() 891 * 892 * Start the phylink instance specified by @pl, configuring the MAC for the 893 * desired link mode(s) and negotiation style. This should be called from the 894 * network device driver's &struct net_device_ops ndo_open() method. 895 */ 896 void phylink_start(struct phylink *pl) 897 { 898 ASSERT_RTNL(); 899 900 netdev_info(pl->netdev, "configuring for %s/%s link mode\n", 901 phylink_an_mode_str(pl->link_an_mode), 902 phy_modes(pl->link_config.interface)); 903 904 /* Always set the carrier off */ 905 netif_carrier_off(pl->netdev); 906 907 /* Apply the link configuration to the MAC when starting. This allows 908 * a fixed-link to start with the correct parameters, and also 909 * ensures that we set the appropriate advertisement for Serdes links. 910 */ 911 phylink_resolve_flow(pl, &pl->link_config); 912 phylink_mac_config(pl, &pl->link_config); 913 914 /* Restart autonegotiation if using 802.3z to ensure that the link 915 * parameters are properly negotiated. This is necessary for DSA 916 * switches using 802.3z negotiation to ensure they see our modes. 917 */ 918 phylink_mac_an_restart(pl); 919 920 clear_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state); 921 phylink_run_resolve(pl); 922 923 if (pl->link_an_mode == MLO_AN_FIXED && !IS_ERR(pl->link_gpio)) 924 mod_timer(&pl->link_poll, jiffies + HZ); 925 if (pl->sfp_bus) 926 sfp_upstream_start(pl->sfp_bus); 927 if (pl->phydev) 928 phy_start(pl->phydev); 929 } 930 EXPORT_SYMBOL_GPL(phylink_start); 931 932 /** 933 * phylink_stop() - stop a phylink instance 934 * @pl: a pointer to a &struct phylink returned from phylink_create() 935 * 936 * Stop the phylink instance specified by @pl. This should be called from the 937 * network device driver's &struct net_device_ops ndo_stop() method. The 938 * network device's carrier state should not be changed prior to calling this 939 * function. 940 */ 941 void phylink_stop(struct phylink *pl) 942 { 943 ASSERT_RTNL(); 944 945 if (pl->phydev) 946 phy_stop(pl->phydev); 947 if (pl->sfp_bus) 948 sfp_upstream_stop(pl->sfp_bus); 949 if (pl->link_an_mode == MLO_AN_FIXED && !IS_ERR(pl->link_gpio)) 950 del_timer_sync(&pl->link_poll); 951 952 set_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state); 953 queue_work(system_power_efficient_wq, &pl->resolve); 954 flush_work(&pl->resolve); 955 } 956 EXPORT_SYMBOL_GPL(phylink_stop); 957 958 /** 959 * phylink_ethtool_get_wol() - get the wake on lan parameters for the PHY 960 * @pl: a pointer to a &struct phylink returned from phylink_create() 961 * @wol: a pointer to &struct ethtool_wolinfo to hold the read parameters 962 * 963 * Read the wake on lan parameters from the PHY attached to the phylink 964 * instance specified by @pl. If no PHY is currently attached, report no 965 * support for wake on lan. 966 */ 967 void phylink_ethtool_get_wol(struct phylink *pl, struct ethtool_wolinfo *wol) 968 { 969 ASSERT_RTNL(); 970 971 wol->supported = 0; 972 wol->wolopts = 0; 973 974 if (pl->phydev) 975 phy_ethtool_get_wol(pl->phydev, wol); 976 } 977 EXPORT_SYMBOL_GPL(phylink_ethtool_get_wol); 978 979 /** 980 * phylink_ethtool_set_wol() - set wake on lan parameters 981 * @pl: a pointer to a &struct phylink returned from phylink_create() 982 * @wol: a pointer to &struct ethtool_wolinfo for the desired parameters 983 * 984 * Set the wake on lan parameters for the PHY attached to the phylink 985 * instance specified by @pl. If no PHY is attached, returns %EOPNOTSUPP 986 * error. 987 * 988 * Returns zero on success or negative errno code. 989 */ 990 int phylink_ethtool_set_wol(struct phylink *pl, struct ethtool_wolinfo *wol) 991 { 992 int ret = -EOPNOTSUPP; 993 994 ASSERT_RTNL(); 995 996 if (pl->phydev) 997 ret = phy_ethtool_set_wol(pl->phydev, wol); 998 999 return ret; 1000 } 1001 EXPORT_SYMBOL_GPL(phylink_ethtool_set_wol); 1002 1003 static void phylink_merge_link_mode(unsigned long *dst, const unsigned long *b) 1004 { 1005 __ETHTOOL_DECLARE_LINK_MODE_MASK(mask); 1006 1007 linkmode_zero(mask); 1008 phylink_set_port_modes(mask); 1009 1010 linkmode_and(dst, dst, mask); 1011 linkmode_or(dst, dst, b); 1012 } 1013 1014 static void phylink_get_ksettings(const struct phylink_link_state *state, 1015 struct ethtool_link_ksettings *kset) 1016 { 1017 phylink_merge_link_mode(kset->link_modes.advertising, state->advertising); 1018 linkmode_copy(kset->link_modes.lp_advertising, state->lp_advertising); 1019 kset->base.speed = state->speed; 1020 kset->base.duplex = state->duplex; 1021 kset->base.autoneg = state->an_enabled ? AUTONEG_ENABLE : 1022 AUTONEG_DISABLE; 1023 } 1024 1025 /** 1026 * phylink_ethtool_ksettings_get() - get the current link settings 1027 * @pl: a pointer to a &struct phylink returned from phylink_create() 1028 * @kset: a pointer to a &struct ethtool_link_ksettings to hold link settings 1029 * 1030 * Read the current link settings for the phylink instance specified by @pl. 1031 * This will be the link settings read from the MAC, PHY or fixed link 1032 * settings depending on the current negotiation mode. 1033 */ 1034 int phylink_ethtool_ksettings_get(struct phylink *pl, 1035 struct ethtool_link_ksettings *kset) 1036 { 1037 struct phylink_link_state link_state; 1038 1039 ASSERT_RTNL(); 1040 1041 if (pl->phydev) { 1042 phy_ethtool_ksettings_get(pl->phydev, kset); 1043 } else { 1044 kset->base.port = pl->link_port; 1045 } 1046 1047 linkmode_copy(kset->link_modes.supported, pl->supported); 1048 1049 switch (pl->link_an_mode) { 1050 case MLO_AN_FIXED: 1051 /* We are using fixed settings. Report these as the 1052 * current link settings - and note that these also 1053 * represent the supported speeds/duplex/pause modes. 1054 */ 1055 phylink_get_fixed_state(pl, &link_state); 1056 phylink_get_ksettings(&link_state, kset); 1057 break; 1058 1059 case MLO_AN_INBAND: 1060 /* If there is a phy attached, then use the reported 1061 * settings from the phy with no modification. 1062 */ 1063 if (pl->phydev) 1064 break; 1065 1066 phylink_get_mac_state(pl, &link_state); 1067 1068 /* The MAC is reporting the link results from its own PCS 1069 * layer via in-band status. Report these as the current 1070 * link settings. 1071 */ 1072 phylink_get_ksettings(&link_state, kset); 1073 break; 1074 } 1075 1076 return 0; 1077 } 1078 EXPORT_SYMBOL_GPL(phylink_ethtool_ksettings_get); 1079 1080 /** 1081 * phylink_ethtool_ksettings_set() - set the link settings 1082 * @pl: a pointer to a &struct phylink returned from phylink_create() 1083 * @kset: a pointer to a &struct ethtool_link_ksettings for the desired modes 1084 */ 1085 int phylink_ethtool_ksettings_set(struct phylink *pl, 1086 const struct ethtool_link_ksettings *kset) 1087 { 1088 struct ethtool_link_ksettings our_kset; 1089 struct phylink_link_state config; 1090 int ret; 1091 1092 ASSERT_RTNL(); 1093 1094 if (kset->base.autoneg != AUTONEG_DISABLE && 1095 kset->base.autoneg != AUTONEG_ENABLE) 1096 return -EINVAL; 1097 1098 config = pl->link_config; 1099 1100 /* Mask out unsupported advertisements */ 1101 linkmode_and(config.advertising, kset->link_modes.advertising, 1102 pl->supported); 1103 1104 /* FIXME: should we reject autoneg if phy/mac does not support it? */ 1105 if (kset->base.autoneg == AUTONEG_DISABLE) { 1106 const struct phy_setting *s; 1107 1108 /* Autonegotiation disabled, select a suitable speed and 1109 * duplex. 1110 */ 1111 s = phy_lookup_setting(kset->base.speed, kset->base.duplex, 1112 pl->supported, 1113 __ETHTOOL_LINK_MODE_MASK_NBITS, false); 1114 if (!s) 1115 return -EINVAL; 1116 1117 /* If we have a fixed link (as specified by firmware), refuse 1118 * to change link parameters. 1119 */ 1120 if (pl->link_an_mode == MLO_AN_FIXED && 1121 (s->speed != pl->link_config.speed || 1122 s->duplex != pl->link_config.duplex)) 1123 return -EINVAL; 1124 1125 config.speed = s->speed; 1126 config.duplex = s->duplex; 1127 config.an_enabled = false; 1128 1129 __clear_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, config.advertising); 1130 } else { 1131 /* If we have a fixed link, refuse to enable autonegotiation */ 1132 if (pl->link_an_mode == MLO_AN_FIXED) 1133 return -EINVAL; 1134 1135 config.speed = SPEED_UNKNOWN; 1136 config.duplex = DUPLEX_UNKNOWN; 1137 config.an_enabled = true; 1138 1139 __set_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, config.advertising); 1140 } 1141 1142 if (phylink_validate(pl, pl->supported, &config)) 1143 return -EINVAL; 1144 1145 /* If autonegotiation is enabled, we must have an advertisement */ 1146 if (config.an_enabled && phylink_is_empty_linkmode(config.advertising)) 1147 return -EINVAL; 1148 1149 our_kset = *kset; 1150 linkmode_copy(our_kset.link_modes.advertising, config.advertising); 1151 our_kset.base.speed = config.speed; 1152 our_kset.base.duplex = config.duplex; 1153 1154 /* If we have a PHY, configure the phy */ 1155 if (pl->phydev) { 1156 ret = phy_ethtool_ksettings_set(pl->phydev, &our_kset); 1157 if (ret) 1158 return ret; 1159 } 1160 1161 mutex_lock(&pl->state_mutex); 1162 /* Configure the MAC to match the new settings */ 1163 linkmode_copy(pl->link_config.advertising, our_kset.link_modes.advertising); 1164 pl->link_config.interface = config.interface; 1165 pl->link_config.speed = our_kset.base.speed; 1166 pl->link_config.duplex = our_kset.base.duplex; 1167 pl->link_config.an_enabled = our_kset.base.autoneg != AUTONEG_DISABLE; 1168 1169 if (!test_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state)) { 1170 phylink_mac_config(pl, &pl->link_config); 1171 phylink_mac_an_restart(pl); 1172 } 1173 mutex_unlock(&pl->state_mutex); 1174 1175 return 0; 1176 } 1177 EXPORT_SYMBOL_GPL(phylink_ethtool_ksettings_set); 1178 1179 /** 1180 * phylink_ethtool_nway_reset() - restart negotiation 1181 * @pl: a pointer to a &struct phylink returned from phylink_create() 1182 * 1183 * Restart negotiation for the phylink instance specified by @pl. This will 1184 * cause any attached phy to restart negotiation with the link partner, and 1185 * if the MAC is in a BaseX mode, the MAC will also be requested to restart 1186 * negotiation. 1187 * 1188 * Returns zero on success, or negative error code. 1189 */ 1190 int phylink_ethtool_nway_reset(struct phylink *pl) 1191 { 1192 int ret = 0; 1193 1194 ASSERT_RTNL(); 1195 1196 if (pl->phydev) 1197 ret = phy_restart_aneg(pl->phydev); 1198 phylink_mac_an_restart(pl); 1199 1200 return ret; 1201 } 1202 EXPORT_SYMBOL_GPL(phylink_ethtool_nway_reset); 1203 1204 /** 1205 * phylink_ethtool_get_pauseparam() - get the current pause parameters 1206 * @pl: a pointer to a &struct phylink returned from phylink_create() 1207 * @pause: a pointer to a &struct ethtool_pauseparam 1208 */ 1209 void phylink_ethtool_get_pauseparam(struct phylink *pl, 1210 struct ethtool_pauseparam *pause) 1211 { 1212 ASSERT_RTNL(); 1213 1214 pause->autoneg = !!(pl->link_config.pause & MLO_PAUSE_AN); 1215 pause->rx_pause = !!(pl->link_config.pause & MLO_PAUSE_RX); 1216 pause->tx_pause = !!(pl->link_config.pause & MLO_PAUSE_TX); 1217 } 1218 EXPORT_SYMBOL_GPL(phylink_ethtool_get_pauseparam); 1219 1220 /** 1221 * phylink_ethtool_set_pauseparam() - set the current pause parameters 1222 * @pl: a pointer to a &struct phylink returned from phylink_create() 1223 * @pause: a pointer to a &struct ethtool_pauseparam 1224 */ 1225 int phylink_ethtool_set_pauseparam(struct phylink *pl, 1226 struct ethtool_pauseparam *pause) 1227 { 1228 struct phylink_link_state *config = &pl->link_config; 1229 1230 ASSERT_RTNL(); 1231 1232 if (!phylink_test(pl->supported, Pause) && 1233 !phylink_test(pl->supported, Asym_Pause)) 1234 return -EOPNOTSUPP; 1235 1236 if (!phylink_test(pl->supported, Asym_Pause) && 1237 !pause->autoneg && pause->rx_pause != pause->tx_pause) 1238 return -EINVAL; 1239 1240 config->pause &= ~(MLO_PAUSE_AN | MLO_PAUSE_TXRX_MASK); 1241 1242 if (pause->autoneg) 1243 config->pause |= MLO_PAUSE_AN; 1244 if (pause->rx_pause) 1245 config->pause |= MLO_PAUSE_RX; 1246 if (pause->tx_pause) 1247 config->pause |= MLO_PAUSE_TX; 1248 1249 if (!test_bit(PHYLINK_DISABLE_STOPPED, &pl->phylink_disable_state)) { 1250 switch (pl->link_an_mode) { 1251 case MLO_AN_PHY: 1252 /* Silently mark the carrier down, and then trigger a resolve */ 1253 netif_carrier_off(pl->netdev); 1254 phylink_run_resolve(pl); 1255 break; 1256 1257 case MLO_AN_FIXED: 1258 /* Should we allow fixed links to change against the config? */ 1259 phylink_resolve_flow(pl, config); 1260 phylink_mac_config(pl, config); 1261 break; 1262 1263 case MLO_AN_INBAND: 1264 phylink_mac_config(pl, config); 1265 phylink_mac_an_restart(pl); 1266 break; 1267 } 1268 } 1269 1270 return 0; 1271 } 1272 EXPORT_SYMBOL_GPL(phylink_ethtool_set_pauseparam); 1273 1274 /** 1275 * phylink_ethtool_get_eee_err() - read the energy efficient ethernet error 1276 * counter 1277 * @pl: a pointer to a &struct phylink returned from phylink_create(). 1278 * 1279 * Read the Energy Efficient Ethernet error counter from the PHY associated 1280 * with the phylink instance specified by @pl. 1281 * 1282 * Returns positive error counter value, or negative error code. 1283 */ 1284 int phylink_get_eee_err(struct phylink *pl) 1285 { 1286 int ret = 0; 1287 1288 ASSERT_RTNL(); 1289 1290 if (pl->phydev) 1291 ret = phy_get_eee_err(pl->phydev); 1292 1293 return ret; 1294 } 1295 EXPORT_SYMBOL_GPL(phylink_get_eee_err); 1296 1297 /** 1298 * phylink_ethtool_get_eee() - read the energy efficient ethernet parameters 1299 * @pl: a pointer to a &struct phylink returned from phylink_create() 1300 * @eee: a pointer to a &struct ethtool_eee for the read parameters 1301 */ 1302 int phylink_ethtool_get_eee(struct phylink *pl, struct ethtool_eee *eee) 1303 { 1304 int ret = -EOPNOTSUPP; 1305 1306 ASSERT_RTNL(); 1307 1308 if (pl->phydev) 1309 ret = phy_ethtool_get_eee(pl->phydev, eee); 1310 1311 return ret; 1312 } 1313 EXPORT_SYMBOL_GPL(phylink_ethtool_get_eee); 1314 1315 /** 1316 * phylink_ethtool_set_eee() - set the energy efficient ethernet parameters 1317 * @pl: a pointer to a &struct phylink returned from phylink_create() 1318 * @eee: a pointer to a &struct ethtool_eee for the desired parameters 1319 */ 1320 int phylink_ethtool_set_eee(struct phylink *pl, struct ethtool_eee *eee) 1321 { 1322 int ret = -EOPNOTSUPP; 1323 1324 ASSERT_RTNL(); 1325 1326 if (pl->phydev) 1327 ret = phy_ethtool_set_eee(pl->phydev, eee); 1328 1329 return ret; 1330 } 1331 EXPORT_SYMBOL_GPL(phylink_ethtool_set_eee); 1332 1333 /* This emulates MII registers for a fixed-mode phy operating as per the 1334 * passed in state. "aneg" defines if we report negotiation is possible. 1335 * 1336 * FIXME: should deal with negotiation state too. 1337 */ 1338 static int phylink_mii_emul_read(struct net_device *ndev, unsigned int reg, 1339 struct phylink_link_state *state, bool aneg) 1340 { 1341 struct fixed_phy_status fs; 1342 int val; 1343 1344 fs.link = state->link; 1345 fs.speed = state->speed; 1346 fs.duplex = state->duplex; 1347 fs.pause = state->pause & MLO_PAUSE_SYM; 1348 fs.asym_pause = state->pause & MLO_PAUSE_ASYM; 1349 1350 val = swphy_read_reg(reg, &fs); 1351 if (reg == MII_BMSR) { 1352 if (!state->an_complete) 1353 val &= ~BMSR_ANEGCOMPLETE; 1354 if (!aneg) 1355 val &= ~BMSR_ANEGCAPABLE; 1356 } 1357 return val; 1358 } 1359 1360 static int phylink_phy_read(struct phylink *pl, unsigned int phy_id, 1361 unsigned int reg) 1362 { 1363 struct phy_device *phydev = pl->phydev; 1364 int prtad, devad; 1365 1366 if (mdio_phy_id_is_c45(phy_id)) { 1367 prtad = mdio_phy_id_prtad(phy_id); 1368 devad = mdio_phy_id_devad(phy_id); 1369 devad = MII_ADDR_C45 | devad << 16 | reg; 1370 } else if (phydev->is_c45) { 1371 switch (reg) { 1372 case MII_BMCR: 1373 case MII_BMSR: 1374 case MII_PHYSID1: 1375 case MII_PHYSID2: 1376 devad = __ffs(phydev->c45_ids.devices_in_package); 1377 break; 1378 case MII_ADVERTISE: 1379 case MII_LPA: 1380 if (!(phydev->c45_ids.devices_in_package & MDIO_DEVS_AN)) 1381 return -EINVAL; 1382 devad = MDIO_MMD_AN; 1383 if (reg == MII_ADVERTISE) 1384 reg = MDIO_AN_ADVERTISE; 1385 else 1386 reg = MDIO_AN_LPA; 1387 break; 1388 default: 1389 return -EINVAL; 1390 } 1391 prtad = phy_id; 1392 devad = MII_ADDR_C45 | devad << 16 | reg; 1393 } else { 1394 prtad = phy_id; 1395 devad = reg; 1396 } 1397 return mdiobus_read(pl->phydev->mdio.bus, prtad, devad); 1398 } 1399 1400 static int phylink_phy_write(struct phylink *pl, unsigned int phy_id, 1401 unsigned int reg, unsigned int val) 1402 { 1403 struct phy_device *phydev = pl->phydev; 1404 int prtad, devad; 1405 1406 if (mdio_phy_id_is_c45(phy_id)) { 1407 prtad = mdio_phy_id_prtad(phy_id); 1408 devad = mdio_phy_id_devad(phy_id); 1409 devad = MII_ADDR_C45 | devad << 16 | reg; 1410 } else if (phydev->is_c45) { 1411 switch (reg) { 1412 case MII_BMCR: 1413 case MII_BMSR: 1414 case MII_PHYSID1: 1415 case MII_PHYSID2: 1416 devad = __ffs(phydev->c45_ids.devices_in_package); 1417 break; 1418 case MII_ADVERTISE: 1419 case MII_LPA: 1420 if (!(phydev->c45_ids.devices_in_package & MDIO_DEVS_AN)) 1421 return -EINVAL; 1422 devad = MDIO_MMD_AN; 1423 if (reg == MII_ADVERTISE) 1424 reg = MDIO_AN_ADVERTISE; 1425 else 1426 reg = MDIO_AN_LPA; 1427 break; 1428 default: 1429 return -EINVAL; 1430 } 1431 prtad = phy_id; 1432 devad = MII_ADDR_C45 | devad << 16 | reg; 1433 } else { 1434 prtad = phy_id; 1435 devad = reg; 1436 } 1437 1438 return mdiobus_write(phydev->mdio.bus, prtad, devad, val); 1439 } 1440 1441 static int phylink_mii_read(struct phylink *pl, unsigned int phy_id, 1442 unsigned int reg) 1443 { 1444 struct phylink_link_state state; 1445 int val = 0xffff; 1446 1447 switch (pl->link_an_mode) { 1448 case MLO_AN_FIXED: 1449 if (phy_id == 0) { 1450 phylink_get_fixed_state(pl, &state); 1451 val = phylink_mii_emul_read(pl->netdev, reg, &state, 1452 true); 1453 } 1454 break; 1455 1456 case MLO_AN_PHY: 1457 return -EOPNOTSUPP; 1458 1459 case MLO_AN_INBAND: 1460 if (phy_id == 0) { 1461 val = phylink_get_mac_state(pl, &state); 1462 if (val < 0) 1463 return val; 1464 1465 val = phylink_mii_emul_read(pl->netdev, reg, &state, 1466 true); 1467 } 1468 break; 1469 } 1470 1471 return val & 0xffff; 1472 } 1473 1474 static int phylink_mii_write(struct phylink *pl, unsigned int phy_id, 1475 unsigned int reg, unsigned int val) 1476 { 1477 switch (pl->link_an_mode) { 1478 case MLO_AN_FIXED: 1479 break; 1480 1481 case MLO_AN_PHY: 1482 return -EOPNOTSUPP; 1483 1484 case MLO_AN_INBAND: 1485 break; 1486 } 1487 1488 return 0; 1489 } 1490 1491 /** 1492 * phylink_mii_ioctl() - generic mii ioctl interface 1493 * @pl: a pointer to a &struct phylink returned from phylink_create() 1494 * @ifr: a pointer to a &struct ifreq for socket ioctls 1495 * @cmd: ioctl cmd to execute 1496 * 1497 * Perform the specified MII ioctl on the PHY attached to the phylink instance 1498 * specified by @pl. If no PHY is attached, emulate the presence of the PHY. 1499 * 1500 * Returns: zero on success or negative error code. 1501 * 1502 * %SIOCGMIIPHY: 1503 * read register from the current PHY. 1504 * %SIOCGMIIREG: 1505 * read register from the specified PHY. 1506 * %SIOCSMIIREG: 1507 * set a register on the specified PHY. 1508 */ 1509 int phylink_mii_ioctl(struct phylink *pl, struct ifreq *ifr, int cmd) 1510 { 1511 struct mii_ioctl_data *mii = if_mii(ifr); 1512 int ret; 1513 1514 ASSERT_RTNL(); 1515 1516 if (pl->phydev) { 1517 /* PHYs only exist for MLO_AN_PHY and SGMII */ 1518 switch (cmd) { 1519 case SIOCGMIIPHY: 1520 mii->phy_id = pl->phydev->mdio.addr; 1521 /* fall through */ 1522 1523 case SIOCGMIIREG: 1524 ret = phylink_phy_read(pl, mii->phy_id, mii->reg_num); 1525 if (ret >= 0) { 1526 mii->val_out = ret; 1527 ret = 0; 1528 } 1529 break; 1530 1531 case SIOCSMIIREG: 1532 ret = phylink_phy_write(pl, mii->phy_id, mii->reg_num, 1533 mii->val_in); 1534 break; 1535 1536 default: 1537 ret = phy_mii_ioctl(pl->phydev, ifr, cmd); 1538 break; 1539 } 1540 } else { 1541 switch (cmd) { 1542 case SIOCGMIIPHY: 1543 mii->phy_id = 0; 1544 /* fall through */ 1545 1546 case SIOCGMIIREG: 1547 ret = phylink_mii_read(pl, mii->phy_id, mii->reg_num); 1548 if (ret >= 0) { 1549 mii->val_out = ret; 1550 ret = 0; 1551 } 1552 break; 1553 1554 case SIOCSMIIREG: 1555 ret = phylink_mii_write(pl, mii->phy_id, mii->reg_num, 1556 mii->val_in); 1557 break; 1558 1559 default: 1560 ret = -EOPNOTSUPP; 1561 break; 1562 } 1563 } 1564 1565 return ret; 1566 } 1567 EXPORT_SYMBOL_GPL(phylink_mii_ioctl); 1568 1569 static int phylink_sfp_module_insert(void *upstream, 1570 const struct sfp_eeprom_id *id) 1571 { 1572 struct phylink *pl = upstream; 1573 __ETHTOOL_DECLARE_LINK_MODE_MASK(support) = { 0, }; 1574 struct phylink_link_state config; 1575 phy_interface_t iface; 1576 int ret = 0; 1577 bool changed; 1578 u8 port; 1579 1580 ASSERT_RTNL(); 1581 1582 sfp_parse_support(pl->sfp_bus, id, support); 1583 port = sfp_parse_port(pl->sfp_bus, id, support); 1584 1585 memset(&config, 0, sizeof(config)); 1586 linkmode_copy(config.advertising, support); 1587 config.interface = PHY_INTERFACE_MODE_NA; 1588 config.speed = SPEED_UNKNOWN; 1589 config.duplex = DUPLEX_UNKNOWN; 1590 config.pause = MLO_PAUSE_AN; 1591 config.an_enabled = pl->link_config.an_enabled; 1592 1593 /* Ignore errors if we're expecting a PHY to attach later */ 1594 ret = phylink_validate(pl, support, &config); 1595 if (ret) { 1596 netdev_err(pl->netdev, "validation with support %*pb failed: %d\n", 1597 __ETHTOOL_LINK_MODE_MASK_NBITS, support, ret); 1598 return ret; 1599 } 1600 1601 iface = sfp_select_interface(pl->sfp_bus, id, config.advertising); 1602 if (iface == PHY_INTERFACE_MODE_NA) { 1603 netdev_err(pl->netdev, 1604 "selection of interface failed, advertisement %*pb\n", 1605 __ETHTOOL_LINK_MODE_MASK_NBITS, config.advertising); 1606 return -EINVAL; 1607 } 1608 1609 config.interface = iface; 1610 ret = phylink_validate(pl, support, &config); 1611 if (ret) { 1612 netdev_err(pl->netdev, "validation of %s/%s with support %*pb failed: %d\n", 1613 phylink_an_mode_str(MLO_AN_INBAND), 1614 phy_modes(config.interface), 1615 __ETHTOOL_LINK_MODE_MASK_NBITS, support, ret); 1616 return ret; 1617 } 1618 1619 netdev_dbg(pl->netdev, "requesting link mode %s/%s with support %*pb\n", 1620 phylink_an_mode_str(MLO_AN_INBAND), 1621 phy_modes(config.interface), 1622 __ETHTOOL_LINK_MODE_MASK_NBITS, support); 1623 1624 if (phy_interface_mode_is_8023z(iface) && pl->phydev) 1625 return -EINVAL; 1626 1627 changed = !bitmap_equal(pl->supported, support, 1628 __ETHTOOL_LINK_MODE_MASK_NBITS); 1629 if (changed) { 1630 linkmode_copy(pl->supported, support); 1631 linkmode_copy(pl->link_config.advertising, config.advertising); 1632 } 1633 1634 if (pl->link_an_mode != MLO_AN_INBAND || 1635 pl->link_config.interface != config.interface) { 1636 pl->link_config.interface = config.interface; 1637 pl->link_an_mode = MLO_AN_INBAND; 1638 1639 changed = true; 1640 1641 netdev_info(pl->netdev, "switched to %s/%s link mode\n", 1642 phylink_an_mode_str(MLO_AN_INBAND), 1643 phy_modes(config.interface)); 1644 } 1645 1646 pl->link_port = port; 1647 1648 if (changed && !test_bit(PHYLINK_DISABLE_STOPPED, 1649 &pl->phylink_disable_state)) 1650 phylink_mac_config(pl, &pl->link_config); 1651 1652 return ret; 1653 } 1654 1655 static void phylink_sfp_link_down(void *upstream) 1656 { 1657 struct phylink *pl = upstream; 1658 1659 ASSERT_RTNL(); 1660 1661 set_bit(PHYLINK_DISABLE_LINK, &pl->phylink_disable_state); 1662 queue_work(system_power_efficient_wq, &pl->resolve); 1663 flush_work(&pl->resolve); 1664 } 1665 1666 static void phylink_sfp_link_up(void *upstream) 1667 { 1668 struct phylink *pl = upstream; 1669 1670 ASSERT_RTNL(); 1671 1672 clear_bit(PHYLINK_DISABLE_LINK, &pl->phylink_disable_state); 1673 phylink_run_resolve(pl); 1674 } 1675 1676 static int phylink_sfp_connect_phy(void *upstream, struct phy_device *phy) 1677 { 1678 return phylink_connect_phy(upstream, phy); 1679 } 1680 1681 static void phylink_sfp_disconnect_phy(void *upstream) 1682 { 1683 phylink_disconnect_phy(upstream); 1684 } 1685 1686 static const struct sfp_upstream_ops sfp_phylink_ops = { 1687 .module_insert = phylink_sfp_module_insert, 1688 .link_up = phylink_sfp_link_up, 1689 .link_down = phylink_sfp_link_down, 1690 .connect_phy = phylink_sfp_connect_phy, 1691 .disconnect_phy = phylink_sfp_disconnect_phy, 1692 }; 1693 1694 /* Helpers for MAC drivers */ 1695 1696 /** 1697 * phylink_helper_basex_speed() - 1000BaseX/2500BaseX helper 1698 * @state: a pointer to a &struct phylink_link_state 1699 * 1700 * Inspect the interface mode, advertising mask or forced speed and 1701 * decide whether to run at 2.5Gbit or 1Gbit appropriately, switching 1702 * the interface mode to suit. @state->interface is appropriately 1703 * updated, and the advertising mask has the "other" baseX_Full flag 1704 * cleared. 1705 */ 1706 void phylink_helper_basex_speed(struct phylink_link_state *state) 1707 { 1708 if (phy_interface_mode_is_8023z(state->interface)) { 1709 bool want_2500 = state->an_enabled ? 1710 phylink_test(state->advertising, 2500baseX_Full) : 1711 state->speed == SPEED_2500; 1712 1713 if (want_2500) { 1714 phylink_clear(state->advertising, 1000baseX_Full); 1715 state->interface = PHY_INTERFACE_MODE_2500BASEX; 1716 } else { 1717 phylink_clear(state->advertising, 2500baseX_Full); 1718 state->interface = PHY_INTERFACE_MODE_1000BASEX; 1719 } 1720 } 1721 } 1722 EXPORT_SYMBOL_GPL(phylink_helper_basex_speed); 1723 1724 MODULE_LICENSE("GPL"); 1725