1 // SPDX-License-Identifier: GPL-2.0+ 2 /* Framework for finding and configuring PHYs. 3 * Also contains generic PHY driver 4 * 5 * Author: Andy Fleming 6 * 7 * Copyright (c) 2004 Freescale Semiconductor, Inc. 8 */ 9 10 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 11 12 #include <linux/kernel.h> 13 #include <linux/string.h> 14 #include <linux/errno.h> 15 #include <linux/unistd.h> 16 #include <linux/slab.h> 17 #include <linux/interrupt.h> 18 #include <linux/init.h> 19 #include <linux/delay.h> 20 #include <linux/netdevice.h> 21 #include <linux/etherdevice.h> 22 #include <linux/skbuff.h> 23 #include <linux/mm.h> 24 #include <linux/module.h> 25 #include <linux/mii.h> 26 #include <linux/ethtool.h> 27 #include <linux/bitmap.h> 28 #include <linux/phy.h> 29 #include <linux/phy_led_triggers.h> 30 #include <linux/mdio.h> 31 #include <linux/io.h> 32 #include <linux/uaccess.h> 33 34 MODULE_DESCRIPTION("PHY library"); 35 MODULE_AUTHOR("Andy Fleming"); 36 MODULE_LICENSE("GPL"); 37 38 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_basic_features) __ro_after_init; 39 EXPORT_SYMBOL_GPL(phy_basic_features); 40 41 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_basic_t1_features) __ro_after_init; 42 EXPORT_SYMBOL_GPL(phy_basic_t1_features); 43 44 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_gbit_features) __ro_after_init; 45 EXPORT_SYMBOL_GPL(phy_gbit_features); 46 47 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_gbit_fibre_features) __ro_after_init; 48 EXPORT_SYMBOL_GPL(phy_gbit_fibre_features); 49 50 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_gbit_all_ports_features) __ro_after_init; 51 EXPORT_SYMBOL_GPL(phy_gbit_all_ports_features); 52 53 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_10gbit_features) __ro_after_init; 54 EXPORT_SYMBOL_GPL(phy_10gbit_features); 55 56 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_10gbit_fec_features) __ro_after_init; 57 EXPORT_SYMBOL_GPL(phy_10gbit_fec_features); 58 59 static const int phy_basic_ports_array[] = { 60 ETHTOOL_LINK_MODE_Autoneg_BIT, 61 ETHTOOL_LINK_MODE_TP_BIT, 62 ETHTOOL_LINK_MODE_MII_BIT, 63 }; 64 EXPORT_SYMBOL_GPL(phy_basic_ports_array); 65 66 static const int phy_fibre_port_array[] = { 67 ETHTOOL_LINK_MODE_FIBRE_BIT, 68 }; 69 EXPORT_SYMBOL_GPL(phy_fibre_port_array); 70 71 static const int phy_all_ports_features_array[] = { 72 ETHTOOL_LINK_MODE_Autoneg_BIT, 73 ETHTOOL_LINK_MODE_TP_BIT, 74 ETHTOOL_LINK_MODE_MII_BIT, 75 ETHTOOL_LINK_MODE_FIBRE_BIT, 76 ETHTOOL_LINK_MODE_AUI_BIT, 77 ETHTOOL_LINK_MODE_BNC_BIT, 78 ETHTOOL_LINK_MODE_Backplane_BIT, 79 }; 80 EXPORT_SYMBOL_GPL(phy_all_ports_features_array); 81 82 const int phy_10_100_features_array[4] = { 83 ETHTOOL_LINK_MODE_10baseT_Half_BIT, 84 ETHTOOL_LINK_MODE_10baseT_Full_BIT, 85 ETHTOOL_LINK_MODE_100baseT_Half_BIT, 86 ETHTOOL_LINK_MODE_100baseT_Full_BIT, 87 }; 88 EXPORT_SYMBOL_GPL(phy_10_100_features_array); 89 90 const int phy_basic_t1_features_array[2] = { 91 ETHTOOL_LINK_MODE_TP_BIT, 92 ETHTOOL_LINK_MODE_100baseT_Full_BIT, 93 }; 94 EXPORT_SYMBOL_GPL(phy_basic_t1_features_array); 95 96 const int phy_gbit_features_array[2] = { 97 ETHTOOL_LINK_MODE_1000baseT_Half_BIT, 98 ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 99 }; 100 EXPORT_SYMBOL_GPL(phy_gbit_features_array); 101 102 const int phy_10gbit_features_array[1] = { 103 ETHTOOL_LINK_MODE_10000baseT_Full_BIT, 104 }; 105 EXPORT_SYMBOL_GPL(phy_10gbit_features_array); 106 107 const int phy_10gbit_fec_features_array[1] = { 108 ETHTOOL_LINK_MODE_10000baseR_FEC_BIT, 109 }; 110 EXPORT_SYMBOL_GPL(phy_10gbit_fec_features_array); 111 112 __ETHTOOL_DECLARE_LINK_MODE_MASK(phy_10gbit_full_features) __ro_after_init; 113 EXPORT_SYMBOL_GPL(phy_10gbit_full_features); 114 115 static const int phy_10gbit_full_features_array[] = { 116 ETHTOOL_LINK_MODE_10baseT_Full_BIT, 117 ETHTOOL_LINK_MODE_100baseT_Full_BIT, 118 ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 119 ETHTOOL_LINK_MODE_10000baseT_Full_BIT, 120 }; 121 122 static void features_init(void) 123 { 124 /* 10/100 half/full*/ 125 linkmode_set_bit_array(phy_basic_ports_array, 126 ARRAY_SIZE(phy_basic_ports_array), 127 phy_basic_features); 128 linkmode_set_bit_array(phy_10_100_features_array, 129 ARRAY_SIZE(phy_10_100_features_array), 130 phy_basic_features); 131 132 /* 100 full, TP */ 133 linkmode_set_bit_array(phy_basic_t1_features_array, 134 ARRAY_SIZE(phy_basic_t1_features_array), 135 phy_basic_t1_features); 136 137 /* 10/100 half/full + 1000 half/full */ 138 linkmode_set_bit_array(phy_basic_ports_array, 139 ARRAY_SIZE(phy_basic_ports_array), 140 phy_gbit_features); 141 linkmode_set_bit_array(phy_10_100_features_array, 142 ARRAY_SIZE(phy_10_100_features_array), 143 phy_gbit_features); 144 linkmode_set_bit_array(phy_gbit_features_array, 145 ARRAY_SIZE(phy_gbit_features_array), 146 phy_gbit_features); 147 148 /* 10/100 half/full + 1000 half/full + fibre*/ 149 linkmode_set_bit_array(phy_basic_ports_array, 150 ARRAY_SIZE(phy_basic_ports_array), 151 phy_gbit_fibre_features); 152 linkmode_set_bit_array(phy_10_100_features_array, 153 ARRAY_SIZE(phy_10_100_features_array), 154 phy_gbit_fibre_features); 155 linkmode_set_bit_array(phy_gbit_features_array, 156 ARRAY_SIZE(phy_gbit_features_array), 157 phy_gbit_fibre_features); 158 linkmode_set_bit_array(phy_fibre_port_array, 159 ARRAY_SIZE(phy_fibre_port_array), 160 phy_gbit_fibre_features); 161 162 /* 10/100 half/full + 1000 half/full + TP/MII/FIBRE/AUI/BNC/Backplane*/ 163 linkmode_set_bit_array(phy_all_ports_features_array, 164 ARRAY_SIZE(phy_all_ports_features_array), 165 phy_gbit_all_ports_features); 166 linkmode_set_bit_array(phy_10_100_features_array, 167 ARRAY_SIZE(phy_10_100_features_array), 168 phy_gbit_all_ports_features); 169 linkmode_set_bit_array(phy_gbit_features_array, 170 ARRAY_SIZE(phy_gbit_features_array), 171 phy_gbit_all_ports_features); 172 173 /* 10/100 half/full + 1000 half/full + 10G full*/ 174 linkmode_set_bit_array(phy_all_ports_features_array, 175 ARRAY_SIZE(phy_all_ports_features_array), 176 phy_10gbit_features); 177 linkmode_set_bit_array(phy_10_100_features_array, 178 ARRAY_SIZE(phy_10_100_features_array), 179 phy_10gbit_features); 180 linkmode_set_bit_array(phy_gbit_features_array, 181 ARRAY_SIZE(phy_gbit_features_array), 182 phy_10gbit_features); 183 linkmode_set_bit_array(phy_10gbit_features_array, 184 ARRAY_SIZE(phy_10gbit_features_array), 185 phy_10gbit_features); 186 187 /* 10/100/1000/10G full */ 188 linkmode_set_bit_array(phy_all_ports_features_array, 189 ARRAY_SIZE(phy_all_ports_features_array), 190 phy_10gbit_full_features); 191 linkmode_set_bit_array(phy_10gbit_full_features_array, 192 ARRAY_SIZE(phy_10gbit_full_features_array), 193 phy_10gbit_full_features); 194 /* 10G FEC only */ 195 linkmode_set_bit_array(phy_10gbit_fec_features_array, 196 ARRAY_SIZE(phy_10gbit_fec_features_array), 197 phy_10gbit_fec_features); 198 } 199 200 void phy_device_free(struct phy_device *phydev) 201 { 202 put_device(&phydev->mdio.dev); 203 } 204 EXPORT_SYMBOL(phy_device_free); 205 206 static void phy_mdio_device_free(struct mdio_device *mdiodev) 207 { 208 struct phy_device *phydev; 209 210 phydev = container_of(mdiodev, struct phy_device, mdio); 211 phy_device_free(phydev); 212 } 213 214 static void phy_device_release(struct device *dev) 215 { 216 kfree(to_phy_device(dev)); 217 } 218 219 static void phy_mdio_device_remove(struct mdio_device *mdiodev) 220 { 221 struct phy_device *phydev; 222 223 phydev = container_of(mdiodev, struct phy_device, mdio); 224 phy_device_remove(phydev); 225 } 226 227 static struct phy_driver genphy_driver; 228 extern struct phy_driver genphy_c45_driver; 229 230 static LIST_HEAD(phy_fixup_list); 231 static DEFINE_MUTEX(phy_fixup_lock); 232 233 #ifdef CONFIG_PM 234 static bool mdio_bus_phy_may_suspend(struct phy_device *phydev) 235 { 236 struct device_driver *drv = phydev->mdio.dev.driver; 237 struct phy_driver *phydrv = to_phy_driver(drv); 238 struct net_device *netdev = phydev->attached_dev; 239 240 if (!drv || !phydrv->suspend) 241 return false; 242 243 /* PHY not attached? May suspend if the PHY has not already been 244 * suspended as part of a prior call to phy_disconnect() -> 245 * phy_detach() -> phy_suspend() because the parent netdev might be the 246 * MDIO bus driver and clock gated at this point. 247 */ 248 if (!netdev) 249 return !phydev->suspended; 250 251 if (netdev->wol_enabled) 252 return false; 253 254 /* As long as not all affected network drivers support the 255 * wol_enabled flag, let's check for hints that WoL is enabled. 256 * Don't suspend PHY if the attached netdev parent may wake up. 257 * The parent may point to a PCI device, as in tg3 driver. 258 */ 259 if (netdev->dev.parent && device_may_wakeup(netdev->dev.parent)) 260 return false; 261 262 /* Also don't suspend PHY if the netdev itself may wakeup. This 263 * is the case for devices w/o underlaying pwr. mgmt. aware bus, 264 * e.g. SoC devices. 265 */ 266 if (device_may_wakeup(&netdev->dev)) 267 return false; 268 269 return true; 270 } 271 272 static int mdio_bus_phy_suspend(struct device *dev) 273 { 274 struct phy_device *phydev = to_phy_device(dev); 275 276 /* We must stop the state machine manually, otherwise it stops out of 277 * control, possibly with the phydev->lock held. Upon resume, netdev 278 * may call phy routines that try to grab the same lock, and that may 279 * lead to a deadlock. 280 */ 281 if (phydev->attached_dev && phydev->adjust_link) 282 phy_stop_machine(phydev); 283 284 if (!mdio_bus_phy_may_suspend(phydev)) 285 return 0; 286 287 return phy_suspend(phydev); 288 } 289 290 static int mdio_bus_phy_resume(struct device *dev) 291 { 292 struct phy_device *phydev = to_phy_device(dev); 293 int ret; 294 295 if (!mdio_bus_phy_may_suspend(phydev)) 296 goto no_resume; 297 298 ret = phy_resume(phydev); 299 if (ret < 0) 300 return ret; 301 302 no_resume: 303 if (phydev->attached_dev && phydev->adjust_link) 304 phy_start_machine(phydev); 305 306 return 0; 307 } 308 309 static int mdio_bus_phy_restore(struct device *dev) 310 { 311 struct phy_device *phydev = to_phy_device(dev); 312 struct net_device *netdev = phydev->attached_dev; 313 int ret; 314 315 if (!netdev) 316 return 0; 317 318 ret = phy_init_hw(phydev); 319 if (ret < 0) 320 return ret; 321 322 if (phydev->attached_dev && phydev->adjust_link) 323 phy_start_machine(phydev); 324 325 return 0; 326 } 327 328 static const struct dev_pm_ops mdio_bus_phy_pm_ops = { 329 .suspend = mdio_bus_phy_suspend, 330 .resume = mdio_bus_phy_resume, 331 .freeze = mdio_bus_phy_suspend, 332 .thaw = mdio_bus_phy_resume, 333 .restore = mdio_bus_phy_restore, 334 }; 335 336 #define MDIO_BUS_PHY_PM_OPS (&mdio_bus_phy_pm_ops) 337 338 #else 339 340 #define MDIO_BUS_PHY_PM_OPS NULL 341 342 #endif /* CONFIG_PM */ 343 344 /** 345 * phy_register_fixup - creates a new phy_fixup and adds it to the list 346 * @bus_id: A string which matches phydev->mdio.dev.bus_id (or PHY_ANY_ID) 347 * @phy_uid: Used to match against phydev->phy_id (the UID of the PHY) 348 * It can also be PHY_ANY_UID 349 * @phy_uid_mask: Applied to phydev->phy_id and fixup->phy_uid before 350 * comparison 351 * @run: The actual code to be run when a matching PHY is found 352 */ 353 int phy_register_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask, 354 int (*run)(struct phy_device *)) 355 { 356 struct phy_fixup *fixup = kzalloc(sizeof(*fixup), GFP_KERNEL); 357 358 if (!fixup) 359 return -ENOMEM; 360 361 strlcpy(fixup->bus_id, bus_id, sizeof(fixup->bus_id)); 362 fixup->phy_uid = phy_uid; 363 fixup->phy_uid_mask = phy_uid_mask; 364 fixup->run = run; 365 366 mutex_lock(&phy_fixup_lock); 367 list_add_tail(&fixup->list, &phy_fixup_list); 368 mutex_unlock(&phy_fixup_lock); 369 370 return 0; 371 } 372 EXPORT_SYMBOL(phy_register_fixup); 373 374 /* Registers a fixup to be run on any PHY with the UID in phy_uid */ 375 int phy_register_fixup_for_uid(u32 phy_uid, u32 phy_uid_mask, 376 int (*run)(struct phy_device *)) 377 { 378 return phy_register_fixup(PHY_ANY_ID, phy_uid, phy_uid_mask, run); 379 } 380 EXPORT_SYMBOL(phy_register_fixup_for_uid); 381 382 /* Registers a fixup to be run on the PHY with id string bus_id */ 383 int phy_register_fixup_for_id(const char *bus_id, 384 int (*run)(struct phy_device *)) 385 { 386 return phy_register_fixup(bus_id, PHY_ANY_UID, 0xffffffff, run); 387 } 388 EXPORT_SYMBOL(phy_register_fixup_for_id); 389 390 /** 391 * phy_unregister_fixup - remove a phy_fixup from the list 392 * @bus_id: A string matches fixup->bus_id (or PHY_ANY_ID) in phy_fixup_list 393 * @phy_uid: A phy id matches fixup->phy_id (or PHY_ANY_UID) in phy_fixup_list 394 * @phy_uid_mask: Applied to phy_uid and fixup->phy_uid before comparison 395 */ 396 int phy_unregister_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask) 397 { 398 struct list_head *pos, *n; 399 struct phy_fixup *fixup; 400 int ret; 401 402 ret = -ENODEV; 403 404 mutex_lock(&phy_fixup_lock); 405 list_for_each_safe(pos, n, &phy_fixup_list) { 406 fixup = list_entry(pos, struct phy_fixup, list); 407 408 if ((!strcmp(fixup->bus_id, bus_id)) && 409 ((fixup->phy_uid & phy_uid_mask) == 410 (phy_uid & phy_uid_mask))) { 411 list_del(&fixup->list); 412 kfree(fixup); 413 ret = 0; 414 break; 415 } 416 } 417 mutex_unlock(&phy_fixup_lock); 418 419 return ret; 420 } 421 EXPORT_SYMBOL(phy_unregister_fixup); 422 423 /* Unregisters a fixup of any PHY with the UID in phy_uid */ 424 int phy_unregister_fixup_for_uid(u32 phy_uid, u32 phy_uid_mask) 425 { 426 return phy_unregister_fixup(PHY_ANY_ID, phy_uid, phy_uid_mask); 427 } 428 EXPORT_SYMBOL(phy_unregister_fixup_for_uid); 429 430 /* Unregisters a fixup of the PHY with id string bus_id */ 431 int phy_unregister_fixup_for_id(const char *bus_id) 432 { 433 return phy_unregister_fixup(bus_id, PHY_ANY_UID, 0xffffffff); 434 } 435 EXPORT_SYMBOL(phy_unregister_fixup_for_id); 436 437 /* Returns 1 if fixup matches phydev in bus_id and phy_uid. 438 * Fixups can be set to match any in one or more fields. 439 */ 440 static int phy_needs_fixup(struct phy_device *phydev, struct phy_fixup *fixup) 441 { 442 if (strcmp(fixup->bus_id, phydev_name(phydev)) != 0) 443 if (strcmp(fixup->bus_id, PHY_ANY_ID) != 0) 444 return 0; 445 446 if ((fixup->phy_uid & fixup->phy_uid_mask) != 447 (phydev->phy_id & fixup->phy_uid_mask)) 448 if (fixup->phy_uid != PHY_ANY_UID) 449 return 0; 450 451 return 1; 452 } 453 454 /* Runs any matching fixups for this phydev */ 455 static int phy_scan_fixups(struct phy_device *phydev) 456 { 457 struct phy_fixup *fixup; 458 459 mutex_lock(&phy_fixup_lock); 460 list_for_each_entry(fixup, &phy_fixup_list, list) { 461 if (phy_needs_fixup(phydev, fixup)) { 462 int err = fixup->run(phydev); 463 464 if (err < 0) { 465 mutex_unlock(&phy_fixup_lock); 466 return err; 467 } 468 phydev->has_fixups = true; 469 } 470 } 471 mutex_unlock(&phy_fixup_lock); 472 473 return 0; 474 } 475 476 static int phy_bus_match(struct device *dev, struct device_driver *drv) 477 { 478 struct phy_device *phydev = to_phy_device(dev); 479 struct phy_driver *phydrv = to_phy_driver(drv); 480 const int num_ids = ARRAY_SIZE(phydev->c45_ids.device_ids); 481 int i; 482 483 if (!(phydrv->mdiodrv.flags & MDIO_DEVICE_IS_PHY)) 484 return 0; 485 486 if (phydrv->match_phy_device) 487 return phydrv->match_phy_device(phydev); 488 489 if (phydev->is_c45) { 490 for (i = 1; i < num_ids; i++) { 491 if (!(phydev->c45_ids.devices_in_package & (1 << i))) 492 continue; 493 494 if ((phydrv->phy_id & phydrv->phy_id_mask) == 495 (phydev->c45_ids.device_ids[i] & 496 phydrv->phy_id_mask)) 497 return 1; 498 } 499 return 0; 500 } else { 501 return (phydrv->phy_id & phydrv->phy_id_mask) == 502 (phydev->phy_id & phydrv->phy_id_mask); 503 } 504 } 505 506 static ssize_t 507 phy_id_show(struct device *dev, struct device_attribute *attr, char *buf) 508 { 509 struct phy_device *phydev = to_phy_device(dev); 510 511 return sprintf(buf, "0x%.8lx\n", (unsigned long)phydev->phy_id); 512 } 513 static DEVICE_ATTR_RO(phy_id); 514 515 static ssize_t 516 phy_interface_show(struct device *dev, struct device_attribute *attr, char *buf) 517 { 518 struct phy_device *phydev = to_phy_device(dev); 519 const char *mode = NULL; 520 521 if (phy_is_internal(phydev)) 522 mode = "internal"; 523 else 524 mode = phy_modes(phydev->interface); 525 526 return sprintf(buf, "%s\n", mode); 527 } 528 static DEVICE_ATTR_RO(phy_interface); 529 530 static ssize_t 531 phy_has_fixups_show(struct device *dev, struct device_attribute *attr, 532 char *buf) 533 { 534 struct phy_device *phydev = to_phy_device(dev); 535 536 return sprintf(buf, "%d\n", phydev->has_fixups); 537 } 538 static DEVICE_ATTR_RO(phy_has_fixups); 539 540 static struct attribute *phy_dev_attrs[] = { 541 &dev_attr_phy_id.attr, 542 &dev_attr_phy_interface.attr, 543 &dev_attr_phy_has_fixups.attr, 544 NULL, 545 }; 546 ATTRIBUTE_GROUPS(phy_dev); 547 548 static const struct device_type mdio_bus_phy_type = { 549 .name = "PHY", 550 .groups = phy_dev_groups, 551 .release = phy_device_release, 552 .pm = MDIO_BUS_PHY_PM_OPS, 553 }; 554 555 static int phy_request_driver_module(struct phy_device *dev, int phy_id) 556 { 557 int ret; 558 559 ret = request_module(MDIO_MODULE_PREFIX MDIO_ID_FMT, 560 MDIO_ID_ARGS(phy_id)); 561 /* We only check for failures in executing the usermode binary, 562 * not whether a PHY driver module exists for the PHY ID. 563 * Accept -ENOENT because this may occur in case no initramfs exists, 564 * then modprobe isn't available. 565 */ 566 if (IS_ENABLED(CONFIG_MODULES) && ret < 0 && ret != -ENOENT) { 567 phydev_err(dev, "error %d loading PHY driver module for ID 0x%08x\n", 568 ret, phy_id); 569 return ret; 570 } 571 572 return 0; 573 } 574 575 struct phy_device *phy_device_create(struct mii_bus *bus, int addr, int phy_id, 576 bool is_c45, 577 struct phy_c45_device_ids *c45_ids) 578 { 579 struct phy_device *dev; 580 struct mdio_device *mdiodev; 581 int ret = 0; 582 583 /* We allocate the device, and initialize the default values */ 584 dev = kzalloc(sizeof(*dev), GFP_KERNEL); 585 if (!dev) 586 return ERR_PTR(-ENOMEM); 587 588 mdiodev = &dev->mdio; 589 mdiodev->dev.parent = &bus->dev; 590 mdiodev->dev.bus = &mdio_bus_type; 591 mdiodev->dev.type = &mdio_bus_phy_type; 592 mdiodev->bus = bus; 593 mdiodev->bus_match = phy_bus_match; 594 mdiodev->addr = addr; 595 mdiodev->flags = MDIO_DEVICE_FLAG_PHY; 596 mdiodev->device_free = phy_mdio_device_free; 597 mdiodev->device_remove = phy_mdio_device_remove; 598 599 dev->speed = 0; 600 dev->duplex = -1; 601 dev->pause = 0; 602 dev->asym_pause = 0; 603 dev->link = 0; 604 dev->interface = PHY_INTERFACE_MODE_GMII; 605 606 dev->autoneg = AUTONEG_ENABLE; 607 608 dev->is_c45 = is_c45; 609 dev->phy_id = phy_id; 610 if (c45_ids) 611 dev->c45_ids = *c45_ids; 612 dev->irq = bus->irq[addr]; 613 dev_set_name(&mdiodev->dev, PHY_ID_FMT, bus->id, addr); 614 615 dev->state = PHY_DOWN; 616 617 mutex_init(&dev->lock); 618 INIT_DELAYED_WORK(&dev->state_queue, phy_state_machine); 619 620 /* Request the appropriate module unconditionally; don't 621 * bother trying to do so only if it isn't already loaded, 622 * because that gets complicated. A hotplug event would have 623 * done an unconditional modprobe anyway. 624 * We don't do normal hotplug because it won't work for MDIO 625 * -- because it relies on the device staying around for long 626 * enough for the driver to get loaded. With MDIO, the NIC 627 * driver will get bored and give up as soon as it finds that 628 * there's no driver _already_ loaded. 629 */ 630 if (is_c45 && c45_ids) { 631 const int num_ids = ARRAY_SIZE(c45_ids->device_ids); 632 int i; 633 634 for (i = 1; i < num_ids; i++) { 635 if (!(c45_ids->devices_in_package & (1 << i))) 636 continue; 637 638 ret = phy_request_driver_module(dev, 639 c45_ids->device_ids[i]); 640 if (ret) 641 break; 642 } 643 } else { 644 ret = phy_request_driver_module(dev, phy_id); 645 } 646 647 if (!ret) { 648 device_initialize(&mdiodev->dev); 649 } else { 650 kfree(dev); 651 dev = ERR_PTR(ret); 652 } 653 654 return dev; 655 } 656 EXPORT_SYMBOL(phy_device_create); 657 658 /* get_phy_c45_devs_in_pkg - reads a MMD's devices in package registers. 659 * @bus: the target MII bus 660 * @addr: PHY address on the MII bus 661 * @dev_addr: MMD address in the PHY. 662 * @devices_in_package: where to store the devices in package information. 663 * 664 * Description: reads devices in package registers of a MMD at @dev_addr 665 * from PHY at @addr on @bus. 666 * 667 * Returns: 0 on success, -EIO on failure. 668 */ 669 static int get_phy_c45_devs_in_pkg(struct mii_bus *bus, int addr, int dev_addr, 670 u32 *devices_in_package) 671 { 672 int phy_reg, reg_addr; 673 674 reg_addr = MII_ADDR_C45 | dev_addr << 16 | MDIO_DEVS2; 675 phy_reg = mdiobus_read(bus, addr, reg_addr); 676 if (phy_reg < 0) 677 return -EIO; 678 *devices_in_package = phy_reg << 16; 679 680 reg_addr = MII_ADDR_C45 | dev_addr << 16 | MDIO_DEVS1; 681 phy_reg = mdiobus_read(bus, addr, reg_addr); 682 if (phy_reg < 0) 683 return -EIO; 684 *devices_in_package |= phy_reg; 685 686 /* Bit 0 doesn't represent a device, it indicates c22 regs presence */ 687 *devices_in_package &= ~BIT(0); 688 689 return 0; 690 } 691 692 /** 693 * get_phy_c45_ids - reads the specified addr for its 802.3-c45 IDs. 694 * @bus: the target MII bus 695 * @addr: PHY address on the MII bus 696 * @phy_id: where to store the ID retrieved. 697 * @c45_ids: where to store the c45 ID information. 698 * 699 * If the PHY devices-in-package appears to be valid, it and the 700 * corresponding identifiers are stored in @c45_ids, zero is stored 701 * in @phy_id. Otherwise 0xffffffff is stored in @phy_id. Returns 702 * zero on success. 703 * 704 */ 705 static int get_phy_c45_ids(struct mii_bus *bus, int addr, u32 *phy_id, 706 struct phy_c45_device_ids *c45_ids) { 707 int phy_reg; 708 int i, reg_addr; 709 const int num_ids = ARRAY_SIZE(c45_ids->device_ids); 710 u32 *devs = &c45_ids->devices_in_package; 711 712 /* Find first non-zero Devices In package. Device zero is reserved 713 * for 802.3 c45 complied PHYs, so don't probe it at first. 714 */ 715 for (i = 1; i < num_ids && *devs == 0; i++) { 716 phy_reg = get_phy_c45_devs_in_pkg(bus, addr, i, devs); 717 if (phy_reg < 0) 718 return -EIO; 719 720 if ((*devs & 0x1fffffff) == 0x1fffffff) { 721 /* If mostly Fs, there is no device there, 722 * then let's continue to probe more, as some 723 * 10G PHYs have zero Devices In package, 724 * e.g. Cortina CS4315/CS4340 PHY. 725 */ 726 phy_reg = get_phy_c45_devs_in_pkg(bus, addr, 0, devs); 727 if (phy_reg < 0) 728 return -EIO; 729 /* no device there, let's get out of here */ 730 if ((*devs & 0x1fffffff) == 0x1fffffff) { 731 *phy_id = 0xffffffff; 732 return 0; 733 } else { 734 break; 735 } 736 } 737 } 738 739 /* Now probe Device Identifiers for each device present. */ 740 for (i = 1; i < num_ids; i++) { 741 if (!(c45_ids->devices_in_package & (1 << i))) 742 continue; 743 744 reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID1; 745 phy_reg = mdiobus_read(bus, addr, reg_addr); 746 if (phy_reg < 0) 747 return -EIO; 748 c45_ids->device_ids[i] = phy_reg << 16; 749 750 reg_addr = MII_ADDR_C45 | i << 16 | MII_PHYSID2; 751 phy_reg = mdiobus_read(bus, addr, reg_addr); 752 if (phy_reg < 0) 753 return -EIO; 754 c45_ids->device_ids[i] |= phy_reg; 755 } 756 *phy_id = 0; 757 return 0; 758 } 759 760 /** 761 * get_phy_id - reads the specified addr for its ID. 762 * @bus: the target MII bus 763 * @addr: PHY address on the MII bus 764 * @phy_id: where to store the ID retrieved. 765 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol 766 * @c45_ids: where to store the c45 ID information. 767 * 768 * Description: In the case of a 802.3-c22 PHY, reads the ID registers 769 * of the PHY at @addr on the @bus, stores it in @phy_id and returns 770 * zero on success. 771 * 772 * In the case of a 802.3-c45 PHY, get_phy_c45_ids() is invoked, and 773 * its return value is in turn returned. 774 * 775 */ 776 static int get_phy_id(struct mii_bus *bus, int addr, u32 *phy_id, 777 bool is_c45, struct phy_c45_device_ids *c45_ids) 778 { 779 int phy_reg; 780 781 if (is_c45) 782 return get_phy_c45_ids(bus, addr, phy_id, c45_ids); 783 784 /* Grab the bits from PHYIR1, and put them in the upper half */ 785 phy_reg = mdiobus_read(bus, addr, MII_PHYSID1); 786 if (phy_reg < 0) { 787 /* returning -ENODEV doesn't stop bus scanning */ 788 return (phy_reg == -EIO || phy_reg == -ENODEV) ? -ENODEV : -EIO; 789 } 790 791 *phy_id = phy_reg << 16; 792 793 /* Grab the bits from PHYIR2, and put them in the lower half */ 794 phy_reg = mdiobus_read(bus, addr, MII_PHYSID2); 795 if (phy_reg < 0) 796 return -EIO; 797 798 *phy_id |= phy_reg; 799 800 return 0; 801 } 802 803 /** 804 * get_phy_device - reads the specified PHY device and returns its @phy_device 805 * struct 806 * @bus: the target MII bus 807 * @addr: PHY address on the MII bus 808 * @is_c45: If true the PHY uses the 802.3 clause 45 protocol 809 * 810 * Description: Reads the ID registers of the PHY at @addr on the 811 * @bus, then allocates and returns the phy_device to represent it. 812 */ 813 struct phy_device *get_phy_device(struct mii_bus *bus, int addr, bool is_c45) 814 { 815 struct phy_c45_device_ids c45_ids = {0}; 816 u32 phy_id = 0; 817 int r; 818 819 r = get_phy_id(bus, addr, &phy_id, is_c45, &c45_ids); 820 if (r) 821 return ERR_PTR(r); 822 823 /* If the phy_id is mostly Fs, there is no device there */ 824 if ((phy_id & 0x1fffffff) == 0x1fffffff) 825 return ERR_PTR(-ENODEV); 826 827 return phy_device_create(bus, addr, phy_id, is_c45, &c45_ids); 828 } 829 EXPORT_SYMBOL(get_phy_device); 830 831 /** 832 * phy_device_register - Register the phy device on the MDIO bus 833 * @phydev: phy_device structure to be added to the MDIO bus 834 */ 835 int phy_device_register(struct phy_device *phydev) 836 { 837 int err; 838 839 err = mdiobus_register_device(&phydev->mdio); 840 if (err) 841 return err; 842 843 /* Deassert the reset signal */ 844 phy_device_reset(phydev, 0); 845 846 /* Run all of the fixups for this PHY */ 847 err = phy_scan_fixups(phydev); 848 if (err) { 849 phydev_err(phydev, "failed to initialize\n"); 850 goto out; 851 } 852 853 err = device_add(&phydev->mdio.dev); 854 if (err) { 855 phydev_err(phydev, "failed to add\n"); 856 goto out; 857 } 858 859 return 0; 860 861 out: 862 /* Assert the reset signal */ 863 phy_device_reset(phydev, 1); 864 865 mdiobus_unregister_device(&phydev->mdio); 866 return err; 867 } 868 EXPORT_SYMBOL(phy_device_register); 869 870 /** 871 * phy_device_remove - Remove a previously registered phy device from the MDIO bus 872 * @phydev: phy_device structure to remove 873 * 874 * This doesn't free the phy_device itself, it merely reverses the effects 875 * of phy_device_register(). Use phy_device_free() to free the device 876 * after calling this function. 877 */ 878 void phy_device_remove(struct phy_device *phydev) 879 { 880 device_del(&phydev->mdio.dev); 881 882 /* Assert the reset signal */ 883 phy_device_reset(phydev, 1); 884 885 mdiobus_unregister_device(&phydev->mdio); 886 } 887 EXPORT_SYMBOL(phy_device_remove); 888 889 /** 890 * phy_find_first - finds the first PHY device on the bus 891 * @bus: the target MII bus 892 */ 893 struct phy_device *phy_find_first(struct mii_bus *bus) 894 { 895 struct phy_device *phydev; 896 int addr; 897 898 for (addr = 0; addr < PHY_MAX_ADDR; addr++) { 899 phydev = mdiobus_get_phy(bus, addr); 900 if (phydev) 901 return phydev; 902 } 903 return NULL; 904 } 905 EXPORT_SYMBOL(phy_find_first); 906 907 static void phy_link_change(struct phy_device *phydev, bool up, bool do_carrier) 908 { 909 struct net_device *netdev = phydev->attached_dev; 910 911 if (do_carrier) { 912 if (up) 913 netif_carrier_on(netdev); 914 else 915 netif_carrier_off(netdev); 916 } 917 phydev->adjust_link(netdev); 918 } 919 920 /** 921 * phy_prepare_link - prepares the PHY layer to monitor link status 922 * @phydev: target phy_device struct 923 * @handler: callback function for link status change notifications 924 * 925 * Description: Tells the PHY infrastructure to handle the 926 * gory details on monitoring link status (whether through 927 * polling or an interrupt), and to call back to the 928 * connected device driver when the link status changes. 929 * If you want to monitor your own link state, don't call 930 * this function. 931 */ 932 static void phy_prepare_link(struct phy_device *phydev, 933 void (*handler)(struct net_device *)) 934 { 935 phydev->adjust_link = handler; 936 } 937 938 /** 939 * phy_connect_direct - connect an ethernet device to a specific phy_device 940 * @dev: the network device to connect 941 * @phydev: the pointer to the phy device 942 * @handler: callback function for state change notifications 943 * @interface: PHY device's interface 944 */ 945 int phy_connect_direct(struct net_device *dev, struct phy_device *phydev, 946 void (*handler)(struct net_device *), 947 phy_interface_t interface) 948 { 949 int rc; 950 951 rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface); 952 if (rc) 953 return rc; 954 955 phy_prepare_link(phydev, handler); 956 if (phy_interrupt_is_valid(phydev)) 957 phy_request_interrupt(phydev); 958 959 return 0; 960 } 961 EXPORT_SYMBOL(phy_connect_direct); 962 963 /** 964 * phy_connect - connect an ethernet device to a PHY device 965 * @dev: the network device to connect 966 * @bus_id: the id string of the PHY device to connect 967 * @handler: callback function for state change notifications 968 * @interface: PHY device's interface 969 * 970 * Description: Convenience function for connecting ethernet 971 * devices to PHY devices. The default behavior is for 972 * the PHY infrastructure to handle everything, and only notify 973 * the connected driver when the link status changes. If you 974 * don't want, or can't use the provided functionality, you may 975 * choose to call only the subset of functions which provide 976 * the desired functionality. 977 */ 978 struct phy_device *phy_connect(struct net_device *dev, const char *bus_id, 979 void (*handler)(struct net_device *), 980 phy_interface_t interface) 981 { 982 struct phy_device *phydev; 983 struct device *d; 984 int rc; 985 986 /* Search the list of PHY devices on the mdio bus for the 987 * PHY with the requested name 988 */ 989 d = bus_find_device_by_name(&mdio_bus_type, NULL, bus_id); 990 if (!d) { 991 pr_err("PHY %s not found\n", bus_id); 992 return ERR_PTR(-ENODEV); 993 } 994 phydev = to_phy_device(d); 995 996 rc = phy_connect_direct(dev, phydev, handler, interface); 997 put_device(d); 998 if (rc) 999 return ERR_PTR(rc); 1000 1001 return phydev; 1002 } 1003 EXPORT_SYMBOL(phy_connect); 1004 1005 /** 1006 * phy_disconnect - disable interrupts, stop state machine, and detach a PHY 1007 * device 1008 * @phydev: target phy_device struct 1009 */ 1010 void phy_disconnect(struct phy_device *phydev) 1011 { 1012 if (phy_is_started(phydev)) 1013 phy_stop(phydev); 1014 1015 if (phy_interrupt_is_valid(phydev)) 1016 free_irq(phydev->irq, phydev); 1017 1018 phydev->adjust_link = NULL; 1019 1020 phy_detach(phydev); 1021 } 1022 EXPORT_SYMBOL(phy_disconnect); 1023 1024 /** 1025 * phy_poll_reset - Safely wait until a PHY reset has properly completed 1026 * @phydev: The PHY device to poll 1027 * 1028 * Description: According to IEEE 802.3, Section 2, Subsection 22.2.4.1.1, as 1029 * published in 2008, a PHY reset may take up to 0.5 seconds. The MII BMCR 1030 * register must be polled until the BMCR_RESET bit clears. 1031 * 1032 * Furthermore, any attempts to write to PHY registers may have no effect 1033 * or even generate MDIO bus errors until this is complete. 1034 * 1035 * Some PHYs (such as the Marvell 88E1111) don't entirely conform to the 1036 * standard and do not fully reset after the BMCR_RESET bit is set, and may 1037 * even *REQUIRE* a soft-reset to properly restart autonegotiation. In an 1038 * effort to support such broken PHYs, this function is separate from the 1039 * standard phy_init_hw() which will zero all the other bits in the BMCR 1040 * and reapply all driver-specific and board-specific fixups. 1041 */ 1042 static int phy_poll_reset(struct phy_device *phydev) 1043 { 1044 /* Poll until the reset bit clears (50ms per retry == 0.6 sec) */ 1045 unsigned int retries = 12; 1046 int ret; 1047 1048 do { 1049 msleep(50); 1050 ret = phy_read(phydev, MII_BMCR); 1051 if (ret < 0) 1052 return ret; 1053 } while (ret & BMCR_RESET && --retries); 1054 if (ret & BMCR_RESET) 1055 return -ETIMEDOUT; 1056 1057 /* Some chips (smsc911x) may still need up to another 1ms after the 1058 * BMCR_RESET bit is cleared before they are usable. 1059 */ 1060 msleep(1); 1061 return 0; 1062 } 1063 1064 int phy_init_hw(struct phy_device *phydev) 1065 { 1066 int ret = 0; 1067 1068 /* Deassert the reset signal */ 1069 phy_device_reset(phydev, 0); 1070 1071 if (!phydev->drv) 1072 return 0; 1073 1074 if (phydev->drv->soft_reset) 1075 ret = phydev->drv->soft_reset(phydev); 1076 1077 if (ret < 0) 1078 return ret; 1079 1080 ret = phy_scan_fixups(phydev); 1081 if (ret < 0) 1082 return ret; 1083 1084 if (phydev->drv->config_init) 1085 ret = phydev->drv->config_init(phydev); 1086 1087 return ret; 1088 } 1089 EXPORT_SYMBOL(phy_init_hw); 1090 1091 void phy_attached_info(struct phy_device *phydev) 1092 { 1093 phy_attached_print(phydev, NULL); 1094 } 1095 EXPORT_SYMBOL(phy_attached_info); 1096 1097 #define ATTACHED_FMT "attached PHY driver [%s] (mii_bus:phy_addr=%s, irq=%s)" 1098 void phy_attached_print(struct phy_device *phydev, const char *fmt, ...) 1099 { 1100 const char *drv_name = phydev->drv ? phydev->drv->name : "unbound"; 1101 char *irq_str; 1102 char irq_num[8]; 1103 1104 switch(phydev->irq) { 1105 case PHY_POLL: 1106 irq_str = "POLL"; 1107 break; 1108 case PHY_IGNORE_INTERRUPT: 1109 irq_str = "IGNORE"; 1110 break; 1111 default: 1112 snprintf(irq_num, sizeof(irq_num), "%d", phydev->irq); 1113 irq_str = irq_num; 1114 break; 1115 } 1116 1117 1118 if (!fmt) { 1119 phydev_info(phydev, ATTACHED_FMT "\n", 1120 drv_name, phydev_name(phydev), 1121 irq_str); 1122 } else { 1123 va_list ap; 1124 1125 phydev_info(phydev, ATTACHED_FMT, 1126 drv_name, phydev_name(phydev), 1127 irq_str); 1128 1129 va_start(ap, fmt); 1130 vprintk(fmt, ap); 1131 va_end(ap); 1132 } 1133 } 1134 EXPORT_SYMBOL(phy_attached_print); 1135 1136 /** 1137 * phy_attach_direct - attach a network device to a given PHY device pointer 1138 * @dev: network device to attach 1139 * @phydev: Pointer to phy_device to attach 1140 * @flags: PHY device's dev_flags 1141 * @interface: PHY device's interface 1142 * 1143 * Description: Called by drivers to attach to a particular PHY 1144 * device. The phy_device is found, and properly hooked up 1145 * to the phy_driver. If no driver is attached, then a 1146 * generic driver is used. The phy_device is given a ptr to 1147 * the attaching device, and given a callback for link status 1148 * change. The phy_device is returned to the attaching driver. 1149 * This function takes a reference on the phy device. 1150 */ 1151 int phy_attach_direct(struct net_device *dev, struct phy_device *phydev, 1152 u32 flags, phy_interface_t interface) 1153 { 1154 struct module *ndev_owner = dev->dev.parent->driver->owner; 1155 struct mii_bus *bus = phydev->mdio.bus; 1156 struct device *d = &phydev->mdio.dev; 1157 bool using_genphy = false; 1158 int err; 1159 1160 /* For Ethernet device drivers that register their own MDIO bus, we 1161 * will have bus->owner match ndev_mod, so we do not want to increment 1162 * our own module->refcnt here, otherwise we would not be able to 1163 * unload later on. 1164 */ 1165 if (ndev_owner != bus->owner && !try_module_get(bus->owner)) { 1166 dev_err(&dev->dev, "failed to get the bus module\n"); 1167 return -EIO; 1168 } 1169 1170 get_device(d); 1171 1172 /* Assume that if there is no driver, that it doesn't 1173 * exist, and we should use the genphy driver. 1174 */ 1175 if (!d->driver) { 1176 if (phydev->is_c45) 1177 d->driver = &genphy_c45_driver.mdiodrv.driver; 1178 else 1179 d->driver = &genphy_driver.mdiodrv.driver; 1180 1181 using_genphy = true; 1182 } 1183 1184 if (!try_module_get(d->driver->owner)) { 1185 dev_err(&dev->dev, "failed to get the device driver module\n"); 1186 err = -EIO; 1187 goto error_put_device; 1188 } 1189 1190 if (using_genphy) { 1191 err = d->driver->probe(d); 1192 if (err >= 0) 1193 err = device_bind_driver(d); 1194 1195 if (err) 1196 goto error_module_put; 1197 } 1198 1199 if (phydev->attached_dev) { 1200 dev_err(&dev->dev, "PHY already attached\n"); 1201 err = -EBUSY; 1202 goto error; 1203 } 1204 1205 phydev->phy_link_change = phy_link_change; 1206 phydev->attached_dev = dev; 1207 dev->phydev = phydev; 1208 1209 /* Some Ethernet drivers try to connect to a PHY device before 1210 * calling register_netdevice() -> netdev_register_kobject() and 1211 * does the dev->dev.kobj initialization. Here we only check for 1212 * success which indicates that the network device kobject is 1213 * ready. Once we do that we still need to keep track of whether 1214 * links were successfully set up or not for phy_detach() to 1215 * remove them accordingly. 1216 */ 1217 phydev->sysfs_links = false; 1218 1219 err = sysfs_create_link(&phydev->mdio.dev.kobj, &dev->dev.kobj, 1220 "attached_dev"); 1221 if (!err) { 1222 err = sysfs_create_link_nowarn(&dev->dev.kobj, 1223 &phydev->mdio.dev.kobj, 1224 "phydev"); 1225 if (err) { 1226 dev_err(&dev->dev, "could not add device link to %s err %d\n", 1227 kobject_name(&phydev->mdio.dev.kobj), 1228 err); 1229 /* non-fatal - some net drivers can use one netdevice 1230 * with more then one phy 1231 */ 1232 } 1233 1234 phydev->sysfs_links = true; 1235 } 1236 1237 phydev->dev_flags = flags; 1238 1239 phydev->interface = interface; 1240 1241 phydev->state = PHY_READY; 1242 1243 /* Initial carrier state is off as the phy is about to be 1244 * (re)initialized. 1245 */ 1246 netif_carrier_off(phydev->attached_dev); 1247 1248 /* Do initial configuration here, now that 1249 * we have certain key parameters 1250 * (dev_flags and interface) 1251 */ 1252 err = phy_init_hw(phydev); 1253 if (err) 1254 goto error; 1255 1256 phy_resume(phydev); 1257 phy_led_triggers_register(phydev); 1258 1259 return err; 1260 1261 error: 1262 /* phy_detach() does all of the cleanup below */ 1263 phy_detach(phydev); 1264 return err; 1265 1266 error_module_put: 1267 module_put(d->driver->owner); 1268 error_put_device: 1269 put_device(d); 1270 if (ndev_owner != bus->owner) 1271 module_put(bus->owner); 1272 return err; 1273 } 1274 EXPORT_SYMBOL(phy_attach_direct); 1275 1276 /** 1277 * phy_attach - attach a network device to a particular PHY device 1278 * @dev: network device to attach 1279 * @bus_id: Bus ID of PHY device to attach 1280 * @interface: PHY device's interface 1281 * 1282 * Description: Same as phy_attach_direct() except that a PHY bus_id 1283 * string is passed instead of a pointer to a struct phy_device. 1284 */ 1285 struct phy_device *phy_attach(struct net_device *dev, const char *bus_id, 1286 phy_interface_t interface) 1287 { 1288 struct bus_type *bus = &mdio_bus_type; 1289 struct phy_device *phydev; 1290 struct device *d; 1291 int rc; 1292 1293 /* Search the list of PHY devices on the mdio bus for the 1294 * PHY with the requested name 1295 */ 1296 d = bus_find_device_by_name(bus, NULL, bus_id); 1297 if (!d) { 1298 pr_err("PHY %s not found\n", bus_id); 1299 return ERR_PTR(-ENODEV); 1300 } 1301 phydev = to_phy_device(d); 1302 1303 rc = phy_attach_direct(dev, phydev, phydev->dev_flags, interface); 1304 put_device(d); 1305 if (rc) 1306 return ERR_PTR(rc); 1307 1308 return phydev; 1309 } 1310 EXPORT_SYMBOL(phy_attach); 1311 1312 static bool phy_driver_is_genphy_kind(struct phy_device *phydev, 1313 struct device_driver *driver) 1314 { 1315 struct device *d = &phydev->mdio.dev; 1316 bool ret = false; 1317 1318 if (!phydev->drv) 1319 return ret; 1320 1321 get_device(d); 1322 ret = d->driver == driver; 1323 put_device(d); 1324 1325 return ret; 1326 } 1327 1328 bool phy_driver_is_genphy(struct phy_device *phydev) 1329 { 1330 return phy_driver_is_genphy_kind(phydev, 1331 &genphy_driver.mdiodrv.driver); 1332 } 1333 EXPORT_SYMBOL_GPL(phy_driver_is_genphy); 1334 1335 bool phy_driver_is_genphy_10g(struct phy_device *phydev) 1336 { 1337 return phy_driver_is_genphy_kind(phydev, 1338 &genphy_c45_driver.mdiodrv.driver); 1339 } 1340 EXPORT_SYMBOL_GPL(phy_driver_is_genphy_10g); 1341 1342 /** 1343 * phy_detach - detach a PHY device from its network device 1344 * @phydev: target phy_device struct 1345 * 1346 * This detaches the phy device from its network device and the phy 1347 * driver, and drops the reference count taken in phy_attach_direct(). 1348 */ 1349 void phy_detach(struct phy_device *phydev) 1350 { 1351 struct net_device *dev = phydev->attached_dev; 1352 struct module *ndev_owner = dev->dev.parent->driver->owner; 1353 struct mii_bus *bus; 1354 1355 if (phydev->sysfs_links) { 1356 sysfs_remove_link(&dev->dev.kobj, "phydev"); 1357 sysfs_remove_link(&phydev->mdio.dev.kobj, "attached_dev"); 1358 } 1359 phy_suspend(phydev); 1360 phydev->attached_dev->phydev = NULL; 1361 phydev->attached_dev = NULL; 1362 phydev->phylink = NULL; 1363 1364 phy_led_triggers_unregister(phydev); 1365 1366 module_put(phydev->mdio.dev.driver->owner); 1367 1368 /* If the device had no specific driver before (i.e. - it 1369 * was using the generic driver), we unbind the device 1370 * from the generic driver so that there's a chance a 1371 * real driver could be loaded 1372 */ 1373 if (phy_driver_is_genphy(phydev) || 1374 phy_driver_is_genphy_10g(phydev)) 1375 device_release_driver(&phydev->mdio.dev); 1376 1377 /* 1378 * The phydev might go away on the put_device() below, so avoid 1379 * a use-after-free bug by reading the underlying bus first. 1380 */ 1381 bus = phydev->mdio.bus; 1382 1383 put_device(&phydev->mdio.dev); 1384 if (ndev_owner != bus->owner) 1385 module_put(bus->owner); 1386 1387 /* Assert the reset signal */ 1388 phy_device_reset(phydev, 1); 1389 } 1390 EXPORT_SYMBOL(phy_detach); 1391 1392 int phy_suspend(struct phy_device *phydev) 1393 { 1394 struct phy_driver *phydrv = to_phy_driver(phydev->mdio.dev.driver); 1395 struct net_device *netdev = phydev->attached_dev; 1396 struct ethtool_wolinfo wol = { .cmd = ETHTOOL_GWOL }; 1397 int ret = 0; 1398 1399 /* If the device has WOL enabled, we cannot suspend the PHY */ 1400 phy_ethtool_get_wol(phydev, &wol); 1401 if (wol.wolopts || (netdev && netdev->wol_enabled)) 1402 return -EBUSY; 1403 1404 if (phydev->drv && phydrv->suspend) 1405 ret = phydrv->suspend(phydev); 1406 1407 if (ret) 1408 return ret; 1409 1410 phydev->suspended = true; 1411 1412 return ret; 1413 } 1414 EXPORT_SYMBOL(phy_suspend); 1415 1416 int __phy_resume(struct phy_device *phydev) 1417 { 1418 struct phy_driver *phydrv = to_phy_driver(phydev->mdio.dev.driver); 1419 int ret = 0; 1420 1421 WARN_ON(!mutex_is_locked(&phydev->lock)); 1422 1423 if (phydev->drv && phydrv->resume) 1424 ret = phydrv->resume(phydev); 1425 1426 if (ret) 1427 return ret; 1428 1429 phydev->suspended = false; 1430 1431 return ret; 1432 } 1433 EXPORT_SYMBOL(__phy_resume); 1434 1435 int phy_resume(struct phy_device *phydev) 1436 { 1437 int ret; 1438 1439 mutex_lock(&phydev->lock); 1440 ret = __phy_resume(phydev); 1441 mutex_unlock(&phydev->lock); 1442 1443 return ret; 1444 } 1445 EXPORT_SYMBOL(phy_resume); 1446 1447 int phy_loopback(struct phy_device *phydev, bool enable) 1448 { 1449 struct phy_driver *phydrv = to_phy_driver(phydev->mdio.dev.driver); 1450 int ret = 0; 1451 1452 mutex_lock(&phydev->lock); 1453 1454 if (enable && phydev->loopback_enabled) { 1455 ret = -EBUSY; 1456 goto out; 1457 } 1458 1459 if (!enable && !phydev->loopback_enabled) { 1460 ret = -EINVAL; 1461 goto out; 1462 } 1463 1464 if (phydev->drv && phydrv->set_loopback) 1465 ret = phydrv->set_loopback(phydev, enable); 1466 else 1467 ret = -EOPNOTSUPP; 1468 1469 if (ret) 1470 goto out; 1471 1472 phydev->loopback_enabled = enable; 1473 1474 out: 1475 mutex_unlock(&phydev->lock); 1476 return ret; 1477 } 1478 EXPORT_SYMBOL(phy_loopback); 1479 1480 /** 1481 * phy_reset_after_clk_enable - perform a PHY reset if needed 1482 * @phydev: target phy_device struct 1483 * 1484 * Description: Some PHYs are known to need a reset after their refclk was 1485 * enabled. This function evaluates the flags and perform the reset if it's 1486 * needed. Returns < 0 on error, 0 if the phy wasn't reset and 1 if the phy 1487 * was reset. 1488 */ 1489 int phy_reset_after_clk_enable(struct phy_device *phydev) 1490 { 1491 if (!phydev || !phydev->drv) 1492 return -ENODEV; 1493 1494 if (phydev->drv->flags & PHY_RST_AFTER_CLK_EN) { 1495 phy_device_reset(phydev, 1); 1496 phy_device_reset(phydev, 0); 1497 return 1; 1498 } 1499 1500 return 0; 1501 } 1502 EXPORT_SYMBOL(phy_reset_after_clk_enable); 1503 1504 /* Generic PHY support and helper functions */ 1505 1506 /** 1507 * genphy_config_advert - sanitize and advertise auto-negotiation parameters 1508 * @phydev: target phy_device struct 1509 * 1510 * Description: Writes MII_ADVERTISE with the appropriate values, 1511 * after sanitizing the values to make sure we only advertise 1512 * what is supported. Returns < 0 on error, 0 if the PHY's advertisement 1513 * hasn't changed, and > 0 if it has changed. 1514 */ 1515 static int genphy_config_advert(struct phy_device *phydev) 1516 { 1517 u32 advertise; 1518 int bmsr, adv; 1519 int err, changed = 0; 1520 1521 /* Only allow advertising what this PHY supports */ 1522 linkmode_and(phydev->advertising, phydev->advertising, 1523 phydev->supported); 1524 if (!ethtool_convert_link_mode_to_legacy_u32(&advertise, 1525 phydev->advertising)) 1526 phydev_warn(phydev, "PHY advertising (%*pb) more modes than genphy supports, some modes not advertised.\n", 1527 __ETHTOOL_LINK_MODE_MASK_NBITS, 1528 phydev->advertising); 1529 1530 /* Setup standard advertisement */ 1531 err = phy_modify_changed(phydev, MII_ADVERTISE, 1532 ADVERTISE_ALL | ADVERTISE_100BASE4 | 1533 ADVERTISE_PAUSE_CAP | ADVERTISE_PAUSE_ASYM, 1534 ethtool_adv_to_mii_adv_t(advertise)); 1535 if (err < 0) 1536 return err; 1537 if (err > 0) 1538 changed = 1; 1539 1540 bmsr = phy_read(phydev, MII_BMSR); 1541 if (bmsr < 0) 1542 return bmsr; 1543 1544 /* Per 802.3-2008, Section 22.2.4.2.16 Extended status all 1545 * 1000Mbits/sec capable PHYs shall have the BMSR_ESTATEN bit set to a 1546 * logical 1. 1547 */ 1548 if (!(bmsr & BMSR_ESTATEN)) 1549 return changed; 1550 1551 /* Configure gigabit if it's supported */ 1552 adv = 0; 1553 if (linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT, 1554 phydev->supported) || 1555 linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 1556 phydev->supported)) 1557 adv = ethtool_adv_to_mii_ctrl1000_t(advertise); 1558 1559 err = phy_modify_changed(phydev, MII_CTRL1000, 1560 ADVERTISE_1000FULL | ADVERTISE_1000HALF, 1561 adv); 1562 if (err < 0) 1563 return err; 1564 if (err > 0) 1565 changed = 1; 1566 1567 return changed; 1568 } 1569 1570 /** 1571 * genphy_config_eee_advert - disable unwanted eee mode advertisement 1572 * @phydev: target phy_device struct 1573 * 1574 * Description: Writes MDIO_AN_EEE_ADV after disabling unsupported energy 1575 * efficent ethernet modes. Returns 0 if the PHY's advertisement hasn't 1576 * changed, and 1 if it has changed. 1577 */ 1578 int genphy_config_eee_advert(struct phy_device *phydev) 1579 { 1580 int err; 1581 1582 /* Nothing to disable */ 1583 if (!phydev->eee_broken_modes) 1584 return 0; 1585 1586 err = phy_modify_mmd_changed(phydev, MDIO_MMD_AN, MDIO_AN_EEE_ADV, 1587 phydev->eee_broken_modes, 0); 1588 /* If the call failed, we assume that EEE is not supported */ 1589 return err < 0 ? 0 : err; 1590 } 1591 EXPORT_SYMBOL(genphy_config_eee_advert); 1592 1593 /** 1594 * genphy_setup_forced - configures/forces speed/duplex from @phydev 1595 * @phydev: target phy_device struct 1596 * 1597 * Description: Configures MII_BMCR to force speed/duplex 1598 * to the values in phydev. Assumes that the values are valid. 1599 * Please see phy_sanitize_settings(). 1600 */ 1601 int genphy_setup_forced(struct phy_device *phydev) 1602 { 1603 u16 ctl = 0; 1604 1605 phydev->pause = 0; 1606 phydev->asym_pause = 0; 1607 1608 if (SPEED_1000 == phydev->speed) 1609 ctl |= BMCR_SPEED1000; 1610 else if (SPEED_100 == phydev->speed) 1611 ctl |= BMCR_SPEED100; 1612 1613 if (DUPLEX_FULL == phydev->duplex) 1614 ctl |= BMCR_FULLDPLX; 1615 1616 return phy_modify(phydev, MII_BMCR, 1617 ~(BMCR_LOOPBACK | BMCR_ISOLATE | BMCR_PDOWN), ctl); 1618 } 1619 EXPORT_SYMBOL(genphy_setup_forced); 1620 1621 /** 1622 * genphy_restart_aneg - Enable and Restart Autonegotiation 1623 * @phydev: target phy_device struct 1624 */ 1625 int genphy_restart_aneg(struct phy_device *phydev) 1626 { 1627 /* Don't isolate the PHY if we're negotiating */ 1628 return phy_modify(phydev, MII_BMCR, BMCR_ISOLATE, 1629 BMCR_ANENABLE | BMCR_ANRESTART); 1630 } 1631 EXPORT_SYMBOL(genphy_restart_aneg); 1632 1633 /** 1634 * genphy_config_aneg - restart auto-negotiation or write BMCR 1635 * @phydev: target phy_device struct 1636 * 1637 * Description: If auto-negotiation is enabled, we configure the 1638 * advertising, and then restart auto-negotiation. If it is not 1639 * enabled, then we write the BMCR. 1640 */ 1641 int genphy_config_aneg(struct phy_device *phydev) 1642 { 1643 int err, changed; 1644 1645 changed = genphy_config_eee_advert(phydev); 1646 1647 if (AUTONEG_ENABLE != phydev->autoneg) 1648 return genphy_setup_forced(phydev); 1649 1650 err = genphy_config_advert(phydev); 1651 if (err < 0) /* error */ 1652 return err; 1653 1654 changed |= err; 1655 1656 if (changed == 0) { 1657 /* Advertisement hasn't changed, but maybe aneg was never on to 1658 * begin with? Or maybe phy was isolated? 1659 */ 1660 int ctl = phy_read(phydev, MII_BMCR); 1661 1662 if (ctl < 0) 1663 return ctl; 1664 1665 if (!(ctl & BMCR_ANENABLE) || (ctl & BMCR_ISOLATE)) 1666 changed = 1; /* do restart aneg */ 1667 } 1668 1669 /* Only restart aneg if we are advertising something different 1670 * than we were before. 1671 */ 1672 if (changed > 0) 1673 return genphy_restart_aneg(phydev); 1674 1675 return 0; 1676 } 1677 EXPORT_SYMBOL(genphy_config_aneg); 1678 1679 /** 1680 * genphy_aneg_done - return auto-negotiation status 1681 * @phydev: target phy_device struct 1682 * 1683 * Description: Reads the status register and returns 0 either if 1684 * auto-negotiation is incomplete, or if there was an error. 1685 * Returns BMSR_ANEGCOMPLETE if auto-negotiation is done. 1686 */ 1687 int genphy_aneg_done(struct phy_device *phydev) 1688 { 1689 int retval = phy_read(phydev, MII_BMSR); 1690 1691 return (retval < 0) ? retval : (retval & BMSR_ANEGCOMPLETE); 1692 } 1693 EXPORT_SYMBOL(genphy_aneg_done); 1694 1695 /** 1696 * genphy_update_link - update link status in @phydev 1697 * @phydev: target phy_device struct 1698 * 1699 * Description: Update the value in phydev->link to reflect the 1700 * current link value. In order to do this, we need to read 1701 * the status register twice, keeping the second value. 1702 */ 1703 int genphy_update_link(struct phy_device *phydev) 1704 { 1705 int status; 1706 1707 /* The link state is latched low so that momentary link 1708 * drops can be detected. Do not double-read the status 1709 * in polling mode to detect such short link drops. 1710 */ 1711 if (!phy_polling_mode(phydev)) { 1712 status = phy_read(phydev, MII_BMSR); 1713 if (status < 0) 1714 return status; 1715 else if (status & BMSR_LSTATUS) 1716 goto done; 1717 } 1718 1719 /* Read link and autonegotiation status */ 1720 status = phy_read(phydev, MII_BMSR); 1721 if (status < 0) 1722 return status; 1723 done: 1724 phydev->link = status & BMSR_LSTATUS ? 1 : 0; 1725 phydev->autoneg_complete = status & BMSR_ANEGCOMPLETE ? 1 : 0; 1726 1727 return 0; 1728 } 1729 EXPORT_SYMBOL(genphy_update_link); 1730 1731 /** 1732 * genphy_read_status - check the link status and update current link state 1733 * @phydev: target phy_device struct 1734 * 1735 * Description: Check the link, then figure out the current state 1736 * by comparing what we advertise with what the link partner 1737 * advertises. Start by checking the gigabit possibilities, 1738 * then move on to 10/100. 1739 */ 1740 int genphy_read_status(struct phy_device *phydev) 1741 { 1742 int adv, lpa, lpagb, err, old_link = phydev->link; 1743 1744 /* Update the link, but return if there was an error */ 1745 err = genphy_update_link(phydev); 1746 if (err) 1747 return err; 1748 1749 /* why bother the PHY if nothing can have changed */ 1750 if (phydev->autoneg == AUTONEG_ENABLE && old_link && phydev->link) 1751 return 0; 1752 1753 phydev->speed = SPEED_UNKNOWN; 1754 phydev->duplex = DUPLEX_UNKNOWN; 1755 phydev->pause = 0; 1756 phydev->asym_pause = 0; 1757 1758 linkmode_zero(phydev->lp_advertising); 1759 1760 if (phydev->autoneg == AUTONEG_ENABLE && phydev->autoneg_complete) { 1761 if (phydev->is_gigabit_capable) { 1762 lpagb = phy_read(phydev, MII_STAT1000); 1763 if (lpagb < 0) 1764 return lpagb; 1765 1766 adv = phy_read(phydev, MII_CTRL1000); 1767 if (adv < 0) 1768 return adv; 1769 1770 if (lpagb & LPA_1000MSFAIL) { 1771 if (adv & CTL1000_ENABLE_MASTER) 1772 phydev_err(phydev, "Master/Slave resolution failed, maybe conflicting manual settings?\n"); 1773 else 1774 phydev_err(phydev, "Master/Slave resolution failed\n"); 1775 return -ENOLINK; 1776 } 1777 1778 mii_stat1000_mod_linkmode_lpa_t(phydev->lp_advertising, 1779 lpagb); 1780 } 1781 1782 lpa = phy_read(phydev, MII_LPA); 1783 if (lpa < 0) 1784 return lpa; 1785 1786 mii_lpa_mod_linkmode_lpa_t(phydev->lp_advertising, lpa); 1787 phy_resolve_aneg_linkmode(phydev); 1788 } else if (phydev->autoneg == AUTONEG_DISABLE) { 1789 int bmcr = phy_read(phydev, MII_BMCR); 1790 1791 if (bmcr < 0) 1792 return bmcr; 1793 1794 if (bmcr & BMCR_FULLDPLX) 1795 phydev->duplex = DUPLEX_FULL; 1796 else 1797 phydev->duplex = DUPLEX_HALF; 1798 1799 if (bmcr & BMCR_SPEED1000) 1800 phydev->speed = SPEED_1000; 1801 else if (bmcr & BMCR_SPEED100) 1802 phydev->speed = SPEED_100; 1803 else 1804 phydev->speed = SPEED_10; 1805 } 1806 1807 return 0; 1808 } 1809 EXPORT_SYMBOL(genphy_read_status); 1810 1811 /** 1812 * genphy_soft_reset - software reset the PHY via BMCR_RESET bit 1813 * @phydev: target phy_device struct 1814 * 1815 * Description: Perform a software PHY reset using the standard 1816 * BMCR_RESET bit and poll for the reset bit to be cleared. 1817 * 1818 * Returns: 0 on success, < 0 on failure 1819 */ 1820 int genphy_soft_reset(struct phy_device *phydev) 1821 { 1822 u16 res = BMCR_RESET; 1823 int ret; 1824 1825 if (phydev->autoneg == AUTONEG_ENABLE) 1826 res |= BMCR_ANRESTART; 1827 1828 ret = phy_modify(phydev, MII_BMCR, BMCR_ISOLATE, res); 1829 if (ret < 0) 1830 return ret; 1831 1832 ret = phy_poll_reset(phydev); 1833 if (ret) 1834 return ret; 1835 1836 /* BMCR may be reset to defaults */ 1837 if (phydev->autoneg == AUTONEG_DISABLE) 1838 ret = genphy_setup_forced(phydev); 1839 1840 return ret; 1841 } 1842 EXPORT_SYMBOL(genphy_soft_reset); 1843 1844 int genphy_config_init(struct phy_device *phydev) 1845 { 1846 int val; 1847 __ETHTOOL_DECLARE_LINK_MODE_MASK(features) = { 0, }; 1848 1849 linkmode_set_bit_array(phy_basic_ports_array, 1850 ARRAY_SIZE(phy_basic_ports_array), 1851 features); 1852 linkmode_set_bit(ETHTOOL_LINK_MODE_Pause_BIT, features); 1853 linkmode_set_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, features); 1854 1855 /* Do we support autonegotiation? */ 1856 val = phy_read(phydev, MII_BMSR); 1857 if (val < 0) 1858 return val; 1859 1860 if (val & BMSR_ANEGCAPABLE) 1861 linkmode_set_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, features); 1862 1863 if (val & BMSR_100FULL) 1864 linkmode_set_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT, features); 1865 if (val & BMSR_100HALF) 1866 linkmode_set_bit(ETHTOOL_LINK_MODE_100baseT_Half_BIT, features); 1867 if (val & BMSR_10FULL) 1868 linkmode_set_bit(ETHTOOL_LINK_MODE_10baseT_Full_BIT, features); 1869 if (val & BMSR_10HALF) 1870 linkmode_set_bit(ETHTOOL_LINK_MODE_10baseT_Half_BIT, features); 1871 1872 if (val & BMSR_ESTATEN) { 1873 val = phy_read(phydev, MII_ESTATUS); 1874 if (val < 0) 1875 return val; 1876 1877 if (val & ESTATUS_1000_TFULL) 1878 linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 1879 features); 1880 if (val & ESTATUS_1000_THALF) 1881 linkmode_set_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT, 1882 features); 1883 } 1884 1885 linkmode_and(phydev->supported, phydev->supported, features); 1886 linkmode_and(phydev->advertising, phydev->advertising, features); 1887 1888 return 0; 1889 } 1890 EXPORT_SYMBOL(genphy_config_init); 1891 1892 /** 1893 * genphy_read_abilities - read PHY abilities from Clause 22 registers 1894 * @phydev: target phy_device struct 1895 * 1896 * Description: Reads the PHY's abilities and populates 1897 * phydev->supported accordingly. 1898 * 1899 * Returns: 0 on success, < 0 on failure 1900 */ 1901 int genphy_read_abilities(struct phy_device *phydev) 1902 { 1903 int val; 1904 1905 linkmode_set_bit_array(phy_basic_ports_array, 1906 ARRAY_SIZE(phy_basic_ports_array), 1907 phydev->supported); 1908 1909 val = phy_read(phydev, MII_BMSR); 1910 if (val < 0) 1911 return val; 1912 1913 linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, phydev->supported, 1914 val & BMSR_ANEGCAPABLE); 1915 1916 linkmode_mod_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT, phydev->supported, 1917 val & BMSR_100FULL); 1918 linkmode_mod_bit(ETHTOOL_LINK_MODE_100baseT_Half_BIT, phydev->supported, 1919 val & BMSR_100HALF); 1920 linkmode_mod_bit(ETHTOOL_LINK_MODE_10baseT_Full_BIT, phydev->supported, 1921 val & BMSR_10FULL); 1922 linkmode_mod_bit(ETHTOOL_LINK_MODE_10baseT_Half_BIT, phydev->supported, 1923 val & BMSR_10HALF); 1924 1925 if (val & BMSR_ESTATEN) { 1926 val = phy_read(phydev, MII_ESTATUS); 1927 if (val < 0) 1928 return val; 1929 1930 linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 1931 phydev->supported, val & ESTATUS_1000_TFULL); 1932 linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT, 1933 phydev->supported, val & ESTATUS_1000_THALF); 1934 } 1935 1936 return 0; 1937 } 1938 EXPORT_SYMBOL(genphy_read_abilities); 1939 1940 /* This is used for the phy device which doesn't support the MMD extended 1941 * register access, but it does have side effect when we are trying to access 1942 * the MMD register via indirect method. 1943 */ 1944 int genphy_read_mmd_unsupported(struct phy_device *phdev, int devad, u16 regnum) 1945 { 1946 return -EOPNOTSUPP; 1947 } 1948 EXPORT_SYMBOL(genphy_read_mmd_unsupported); 1949 1950 int genphy_write_mmd_unsupported(struct phy_device *phdev, int devnum, 1951 u16 regnum, u16 val) 1952 { 1953 return -EOPNOTSUPP; 1954 } 1955 EXPORT_SYMBOL(genphy_write_mmd_unsupported); 1956 1957 int genphy_suspend(struct phy_device *phydev) 1958 { 1959 return phy_set_bits(phydev, MII_BMCR, BMCR_PDOWN); 1960 } 1961 EXPORT_SYMBOL(genphy_suspend); 1962 1963 int genphy_resume(struct phy_device *phydev) 1964 { 1965 return phy_clear_bits(phydev, MII_BMCR, BMCR_PDOWN); 1966 } 1967 EXPORT_SYMBOL(genphy_resume); 1968 1969 int genphy_loopback(struct phy_device *phydev, bool enable) 1970 { 1971 return phy_modify(phydev, MII_BMCR, BMCR_LOOPBACK, 1972 enable ? BMCR_LOOPBACK : 0); 1973 } 1974 EXPORT_SYMBOL(genphy_loopback); 1975 1976 /** 1977 * phy_remove_link_mode - Remove a supported link mode 1978 * @phydev: phy_device structure to remove link mode from 1979 * @link_mode: Link mode to be removed 1980 * 1981 * Description: Some MACs don't support all link modes which the PHY 1982 * does. e.g. a 1G MAC often does not support 1000Half. Add a helper 1983 * to remove a link mode. 1984 */ 1985 void phy_remove_link_mode(struct phy_device *phydev, u32 link_mode) 1986 { 1987 linkmode_clear_bit(link_mode, phydev->supported); 1988 phy_advertise_supported(phydev); 1989 } 1990 EXPORT_SYMBOL(phy_remove_link_mode); 1991 1992 static void phy_copy_pause_bits(unsigned long *dst, unsigned long *src) 1993 { 1994 linkmode_mod_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, dst, 1995 linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, src)); 1996 linkmode_mod_bit(ETHTOOL_LINK_MODE_Pause_BIT, dst, 1997 linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT, src)); 1998 } 1999 2000 /** 2001 * phy_advertise_supported - Advertise all supported modes 2002 * @phydev: target phy_device struct 2003 * 2004 * Description: Called to advertise all supported modes, doesn't touch 2005 * pause mode advertising. 2006 */ 2007 void phy_advertise_supported(struct phy_device *phydev) 2008 { 2009 __ETHTOOL_DECLARE_LINK_MODE_MASK(new); 2010 2011 linkmode_copy(new, phydev->supported); 2012 phy_copy_pause_bits(new, phydev->advertising); 2013 linkmode_copy(phydev->advertising, new); 2014 } 2015 EXPORT_SYMBOL(phy_advertise_supported); 2016 2017 /** 2018 * phy_support_sym_pause - Enable support of symmetrical pause 2019 * @phydev: target phy_device struct 2020 * 2021 * Description: Called by the MAC to indicate is supports symmetrical 2022 * Pause, but not asym pause. 2023 */ 2024 void phy_support_sym_pause(struct phy_device *phydev) 2025 { 2026 linkmode_clear_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, phydev->supported); 2027 phy_copy_pause_bits(phydev->advertising, phydev->supported); 2028 } 2029 EXPORT_SYMBOL(phy_support_sym_pause); 2030 2031 /** 2032 * phy_support_asym_pause - Enable support of asym pause 2033 * @phydev: target phy_device struct 2034 * 2035 * Description: Called by the MAC to indicate is supports Asym Pause. 2036 */ 2037 void phy_support_asym_pause(struct phy_device *phydev) 2038 { 2039 phy_copy_pause_bits(phydev->advertising, phydev->supported); 2040 } 2041 EXPORT_SYMBOL(phy_support_asym_pause); 2042 2043 /** 2044 * phy_set_sym_pause - Configure symmetric Pause 2045 * @phydev: target phy_device struct 2046 * @rx: Receiver Pause is supported 2047 * @tx: Transmit Pause is supported 2048 * @autoneg: Auto neg should be used 2049 * 2050 * Description: Configure advertised Pause support depending on if 2051 * receiver pause and pause auto neg is supported. Generally called 2052 * from the set_pauseparam .ndo. 2053 */ 2054 void phy_set_sym_pause(struct phy_device *phydev, bool rx, bool tx, 2055 bool autoneg) 2056 { 2057 linkmode_clear_bit(ETHTOOL_LINK_MODE_Pause_BIT, phydev->supported); 2058 2059 if (rx && tx && autoneg) 2060 linkmode_set_bit(ETHTOOL_LINK_MODE_Pause_BIT, 2061 phydev->supported); 2062 2063 linkmode_copy(phydev->advertising, phydev->supported); 2064 } 2065 EXPORT_SYMBOL(phy_set_sym_pause); 2066 2067 /** 2068 * phy_set_asym_pause - Configure Pause and Asym Pause 2069 * @phydev: target phy_device struct 2070 * @rx: Receiver Pause is supported 2071 * @tx: Transmit Pause is supported 2072 * 2073 * Description: Configure advertised Pause support depending on if 2074 * transmit and receiver pause is supported. If there has been a 2075 * change in adverting, trigger a new autoneg. Generally called from 2076 * the set_pauseparam .ndo. 2077 */ 2078 void phy_set_asym_pause(struct phy_device *phydev, bool rx, bool tx) 2079 { 2080 __ETHTOOL_DECLARE_LINK_MODE_MASK(oldadv); 2081 2082 linkmode_copy(oldadv, phydev->advertising); 2083 2084 linkmode_clear_bit(ETHTOOL_LINK_MODE_Pause_BIT, 2085 phydev->advertising); 2086 linkmode_clear_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, 2087 phydev->advertising); 2088 2089 if (rx) { 2090 linkmode_set_bit(ETHTOOL_LINK_MODE_Pause_BIT, 2091 phydev->advertising); 2092 linkmode_set_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, 2093 phydev->advertising); 2094 } 2095 2096 if (tx) 2097 linkmode_change_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, 2098 phydev->advertising); 2099 2100 if (!linkmode_equal(oldadv, phydev->advertising) && 2101 phydev->autoneg) 2102 phy_start_aneg(phydev); 2103 } 2104 EXPORT_SYMBOL(phy_set_asym_pause); 2105 2106 /** 2107 * phy_validate_pause - Test if the PHY/MAC support the pause configuration 2108 * @phydev: phy_device struct 2109 * @pp: requested pause configuration 2110 * 2111 * Description: Test if the PHY/MAC combination supports the Pause 2112 * configuration the user is requesting. Returns True if it is 2113 * supported, false otherwise. 2114 */ 2115 bool phy_validate_pause(struct phy_device *phydev, 2116 struct ethtool_pauseparam *pp) 2117 { 2118 if (!linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT, 2119 phydev->supported) && pp->rx_pause) 2120 return false; 2121 2122 if (!linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, 2123 phydev->supported) && 2124 pp->rx_pause != pp->tx_pause) 2125 return false; 2126 2127 return true; 2128 } 2129 EXPORT_SYMBOL(phy_validate_pause); 2130 2131 static bool phy_drv_supports_irq(struct phy_driver *phydrv) 2132 { 2133 return phydrv->config_intr && phydrv->ack_interrupt; 2134 } 2135 2136 /** 2137 * phy_probe - probe and init a PHY device 2138 * @dev: device to probe and init 2139 * 2140 * Description: Take care of setting up the phy_device structure, 2141 * set the state to READY (the driver's init function should 2142 * set it to STARTING if needed). 2143 */ 2144 static int phy_probe(struct device *dev) 2145 { 2146 struct phy_device *phydev = to_phy_device(dev); 2147 struct device_driver *drv = phydev->mdio.dev.driver; 2148 struct phy_driver *phydrv = to_phy_driver(drv); 2149 int err = 0; 2150 2151 phydev->drv = phydrv; 2152 2153 /* Disable the interrupt if the PHY doesn't support it 2154 * but the interrupt is still a valid one 2155 */ 2156 if (!phy_drv_supports_irq(phydrv) && phy_interrupt_is_valid(phydev)) 2157 phydev->irq = PHY_POLL; 2158 2159 if (phydrv->flags & PHY_IS_INTERNAL) 2160 phydev->is_internal = true; 2161 2162 mutex_lock(&phydev->lock); 2163 2164 if (phydev->drv->probe) { 2165 /* Deassert the reset signal */ 2166 phy_device_reset(phydev, 0); 2167 2168 err = phydev->drv->probe(phydev); 2169 if (err) { 2170 /* Assert the reset signal */ 2171 phy_device_reset(phydev, 1); 2172 goto out; 2173 } 2174 } 2175 2176 /* Start out supporting everything. Eventually, 2177 * a controller will attach, and may modify one 2178 * or both of these values 2179 */ 2180 if (phydrv->features) { 2181 linkmode_copy(phydev->supported, phydrv->features); 2182 } else if (phydrv->get_features) { 2183 err = phydrv->get_features(phydev); 2184 } else if (phydev->is_c45) { 2185 err = genphy_c45_pma_read_abilities(phydev); 2186 } else { 2187 err = genphy_read_abilities(phydev); 2188 } 2189 2190 if (err) 2191 goto out; 2192 2193 if (!linkmode_test_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, 2194 phydev->supported)) 2195 phydev->autoneg = 0; 2196 2197 if (linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT, 2198 phydev->supported)) 2199 phydev->is_gigabit_capable = 1; 2200 if (linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, 2201 phydev->supported)) 2202 phydev->is_gigabit_capable = 1; 2203 2204 of_set_phy_supported(phydev); 2205 phy_advertise_supported(phydev); 2206 2207 /* Get the EEE modes we want to prohibit. We will ask 2208 * the PHY stop advertising these mode later on 2209 */ 2210 of_set_phy_eee_broken(phydev); 2211 2212 /* The Pause Frame bits indicate that the PHY can support passing 2213 * pause frames. During autonegotiation, the PHYs will determine if 2214 * they should allow pause frames to pass. The MAC driver should then 2215 * use that result to determine whether to enable flow control via 2216 * pause frames. 2217 * 2218 * Normally, PHY drivers should not set the Pause bits, and instead 2219 * allow phylib to do that. However, there may be some situations 2220 * (e.g. hardware erratum) where the driver wants to set only one 2221 * of these bits. 2222 */ 2223 if (!test_bit(ETHTOOL_LINK_MODE_Pause_BIT, phydev->supported) && 2224 !test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, phydev->supported)) { 2225 linkmode_set_bit(ETHTOOL_LINK_MODE_Pause_BIT, 2226 phydev->supported); 2227 linkmode_set_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, 2228 phydev->supported); 2229 } 2230 2231 /* Set the state to READY by default */ 2232 phydev->state = PHY_READY; 2233 2234 out: 2235 mutex_unlock(&phydev->lock); 2236 2237 return err; 2238 } 2239 2240 static int phy_remove(struct device *dev) 2241 { 2242 struct phy_device *phydev = to_phy_device(dev); 2243 2244 cancel_delayed_work_sync(&phydev->state_queue); 2245 2246 mutex_lock(&phydev->lock); 2247 phydev->state = PHY_DOWN; 2248 mutex_unlock(&phydev->lock); 2249 2250 if (phydev->drv && phydev->drv->remove) { 2251 phydev->drv->remove(phydev); 2252 2253 /* Assert the reset signal */ 2254 phy_device_reset(phydev, 1); 2255 } 2256 phydev->drv = NULL; 2257 2258 return 0; 2259 } 2260 2261 /** 2262 * phy_driver_register - register a phy_driver with the PHY layer 2263 * @new_driver: new phy_driver to register 2264 * @owner: module owning this PHY 2265 */ 2266 int phy_driver_register(struct phy_driver *new_driver, struct module *owner) 2267 { 2268 int retval; 2269 2270 /* Either the features are hard coded, or dynamically 2271 * determined. It cannot be both. 2272 */ 2273 if (WARN_ON(new_driver->features && new_driver->get_features)) { 2274 pr_err("%s: features and get_features must not both be set\n", 2275 new_driver->name); 2276 return -EINVAL; 2277 } 2278 2279 new_driver->mdiodrv.flags |= MDIO_DEVICE_IS_PHY; 2280 new_driver->mdiodrv.driver.name = new_driver->name; 2281 new_driver->mdiodrv.driver.bus = &mdio_bus_type; 2282 new_driver->mdiodrv.driver.probe = phy_probe; 2283 new_driver->mdiodrv.driver.remove = phy_remove; 2284 new_driver->mdiodrv.driver.owner = owner; 2285 2286 retval = driver_register(&new_driver->mdiodrv.driver); 2287 if (retval) { 2288 pr_err("%s: Error %d in registering driver\n", 2289 new_driver->name, retval); 2290 2291 return retval; 2292 } 2293 2294 pr_debug("%s: Registered new driver\n", new_driver->name); 2295 2296 return 0; 2297 } 2298 EXPORT_SYMBOL(phy_driver_register); 2299 2300 int phy_drivers_register(struct phy_driver *new_driver, int n, 2301 struct module *owner) 2302 { 2303 int i, ret = 0; 2304 2305 for (i = 0; i < n; i++) { 2306 ret = phy_driver_register(new_driver + i, owner); 2307 if (ret) { 2308 while (i-- > 0) 2309 phy_driver_unregister(new_driver + i); 2310 break; 2311 } 2312 } 2313 return ret; 2314 } 2315 EXPORT_SYMBOL(phy_drivers_register); 2316 2317 void phy_driver_unregister(struct phy_driver *drv) 2318 { 2319 driver_unregister(&drv->mdiodrv.driver); 2320 } 2321 EXPORT_SYMBOL(phy_driver_unregister); 2322 2323 void phy_drivers_unregister(struct phy_driver *drv, int n) 2324 { 2325 int i; 2326 2327 for (i = 0; i < n; i++) 2328 phy_driver_unregister(drv + i); 2329 } 2330 EXPORT_SYMBOL(phy_drivers_unregister); 2331 2332 static struct phy_driver genphy_driver = { 2333 .phy_id = 0xffffffff, 2334 .phy_id_mask = 0xffffffff, 2335 .name = "Generic PHY", 2336 .soft_reset = genphy_no_soft_reset, 2337 .get_features = genphy_read_abilities, 2338 .aneg_done = genphy_aneg_done, 2339 .suspend = genphy_suspend, 2340 .resume = genphy_resume, 2341 .set_loopback = genphy_loopback, 2342 }; 2343 2344 static int __init phy_init(void) 2345 { 2346 int rc; 2347 2348 rc = mdio_bus_init(); 2349 if (rc) 2350 return rc; 2351 2352 features_init(); 2353 2354 rc = phy_driver_register(&genphy_c45_driver, THIS_MODULE); 2355 if (rc) 2356 goto err_c45; 2357 2358 rc = phy_driver_register(&genphy_driver, THIS_MODULE); 2359 if (rc) { 2360 phy_driver_unregister(&genphy_c45_driver); 2361 err_c45: 2362 mdio_bus_exit(); 2363 } 2364 2365 return rc; 2366 } 2367 2368 static void __exit phy_exit(void) 2369 { 2370 phy_driver_unregister(&genphy_c45_driver); 2371 phy_driver_unregister(&genphy_driver); 2372 mdio_bus_exit(); 2373 } 2374 2375 subsys_initcall(phy_init); 2376 module_exit(phy_exit); 2377