1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * Core PHY library, taken from phy.c 4 */ 5 #include <linux/export.h> 6 #include <linux/phy.h> 7 #include <linux/of.h> 8 9 /** 10 * phy_speed_to_str - Return a string representing the PHY link speed 11 * 12 * @speed: Speed of the link 13 */ 14 const char *phy_speed_to_str(int speed) 15 { 16 BUILD_BUG_ON_MSG(__ETHTOOL_LINK_MODE_MASK_NBITS != 92, 17 "Enum ethtool_link_mode_bit_indices and phylib are out of sync. " 18 "If a speed or mode has been added please update phy_speed_to_str " 19 "and the PHY settings array.\n"); 20 21 switch (speed) { 22 case SPEED_10: 23 return "10Mbps"; 24 case SPEED_100: 25 return "100Mbps"; 26 case SPEED_1000: 27 return "1Gbps"; 28 case SPEED_2500: 29 return "2.5Gbps"; 30 case SPEED_5000: 31 return "5Gbps"; 32 case SPEED_10000: 33 return "10Gbps"; 34 case SPEED_14000: 35 return "14Gbps"; 36 case SPEED_20000: 37 return "20Gbps"; 38 case SPEED_25000: 39 return "25Gbps"; 40 case SPEED_40000: 41 return "40Gbps"; 42 case SPEED_50000: 43 return "50Gbps"; 44 case SPEED_56000: 45 return "56Gbps"; 46 case SPEED_100000: 47 return "100Gbps"; 48 case SPEED_200000: 49 return "200Gbps"; 50 case SPEED_400000: 51 return "400Gbps"; 52 case SPEED_UNKNOWN: 53 return "Unknown"; 54 default: 55 return "Unsupported (update phy-core.c)"; 56 } 57 } 58 EXPORT_SYMBOL_GPL(phy_speed_to_str); 59 60 /** 61 * phy_duplex_to_str - Return string describing the duplex 62 * 63 * @duplex: Duplex setting to describe 64 */ 65 const char *phy_duplex_to_str(unsigned int duplex) 66 { 67 if (duplex == DUPLEX_HALF) 68 return "Half"; 69 if (duplex == DUPLEX_FULL) 70 return "Full"; 71 if (duplex == DUPLEX_UNKNOWN) 72 return "Unknown"; 73 return "Unsupported (update phy-core.c)"; 74 } 75 EXPORT_SYMBOL_GPL(phy_duplex_to_str); 76 77 /* A mapping of all SUPPORTED settings to speed/duplex. This table 78 * must be grouped by speed and sorted in descending match priority 79 * - iow, descending speed. 80 */ 81 82 #define PHY_SETTING(s, d, b) { .speed = SPEED_ ## s, .duplex = DUPLEX_ ## d, \ 83 .bit = ETHTOOL_LINK_MODE_ ## b ## _BIT} 84 85 static const struct phy_setting settings[] = { 86 /* 400G */ 87 PHY_SETTING( 400000, FULL, 400000baseCR8_Full ), 88 PHY_SETTING( 400000, FULL, 400000baseKR8_Full ), 89 PHY_SETTING( 400000, FULL, 400000baseLR8_ER8_FR8_Full ), 90 PHY_SETTING( 400000, FULL, 400000baseDR8_Full ), 91 PHY_SETTING( 400000, FULL, 400000baseSR8_Full ), 92 PHY_SETTING( 400000, FULL, 400000baseCR4_Full ), 93 PHY_SETTING( 400000, FULL, 400000baseKR4_Full ), 94 PHY_SETTING( 400000, FULL, 400000baseLR4_ER4_FR4_Full ), 95 PHY_SETTING( 400000, FULL, 400000baseDR4_Full ), 96 PHY_SETTING( 400000, FULL, 400000baseSR4_Full ), 97 /* 200G */ 98 PHY_SETTING( 200000, FULL, 200000baseCR4_Full ), 99 PHY_SETTING( 200000, FULL, 200000baseKR4_Full ), 100 PHY_SETTING( 200000, FULL, 200000baseLR4_ER4_FR4_Full ), 101 PHY_SETTING( 200000, FULL, 200000baseDR4_Full ), 102 PHY_SETTING( 200000, FULL, 200000baseSR4_Full ), 103 PHY_SETTING( 200000, FULL, 200000baseCR2_Full ), 104 PHY_SETTING( 200000, FULL, 200000baseKR2_Full ), 105 PHY_SETTING( 200000, FULL, 200000baseLR2_ER2_FR2_Full ), 106 PHY_SETTING( 200000, FULL, 200000baseDR2_Full ), 107 PHY_SETTING( 200000, FULL, 200000baseSR2_Full ), 108 /* 100G */ 109 PHY_SETTING( 100000, FULL, 100000baseCR4_Full ), 110 PHY_SETTING( 100000, FULL, 100000baseKR4_Full ), 111 PHY_SETTING( 100000, FULL, 100000baseLR4_ER4_Full ), 112 PHY_SETTING( 100000, FULL, 100000baseSR4_Full ), 113 PHY_SETTING( 100000, FULL, 100000baseCR2_Full ), 114 PHY_SETTING( 100000, FULL, 100000baseKR2_Full ), 115 PHY_SETTING( 100000, FULL, 100000baseLR2_ER2_FR2_Full ), 116 PHY_SETTING( 100000, FULL, 100000baseDR2_Full ), 117 PHY_SETTING( 100000, FULL, 100000baseSR2_Full ), 118 PHY_SETTING( 100000, FULL, 100000baseCR_Full ), 119 PHY_SETTING( 100000, FULL, 100000baseKR_Full ), 120 PHY_SETTING( 100000, FULL, 100000baseLR_ER_FR_Full ), 121 PHY_SETTING( 100000, FULL, 100000baseDR_Full ), 122 PHY_SETTING( 100000, FULL, 100000baseSR_Full ), 123 /* 56G */ 124 PHY_SETTING( 56000, FULL, 56000baseCR4_Full ), 125 PHY_SETTING( 56000, FULL, 56000baseKR4_Full ), 126 PHY_SETTING( 56000, FULL, 56000baseLR4_Full ), 127 PHY_SETTING( 56000, FULL, 56000baseSR4_Full ), 128 /* 50G */ 129 PHY_SETTING( 50000, FULL, 50000baseCR2_Full ), 130 PHY_SETTING( 50000, FULL, 50000baseKR2_Full ), 131 PHY_SETTING( 50000, FULL, 50000baseSR2_Full ), 132 PHY_SETTING( 50000, FULL, 50000baseCR_Full ), 133 PHY_SETTING( 50000, FULL, 50000baseKR_Full ), 134 PHY_SETTING( 50000, FULL, 50000baseLR_ER_FR_Full ), 135 PHY_SETTING( 50000, FULL, 50000baseDR_Full ), 136 PHY_SETTING( 50000, FULL, 50000baseSR_Full ), 137 /* 40G */ 138 PHY_SETTING( 40000, FULL, 40000baseCR4_Full ), 139 PHY_SETTING( 40000, FULL, 40000baseKR4_Full ), 140 PHY_SETTING( 40000, FULL, 40000baseLR4_Full ), 141 PHY_SETTING( 40000, FULL, 40000baseSR4_Full ), 142 /* 25G */ 143 PHY_SETTING( 25000, FULL, 25000baseCR_Full ), 144 PHY_SETTING( 25000, FULL, 25000baseKR_Full ), 145 PHY_SETTING( 25000, FULL, 25000baseSR_Full ), 146 /* 20G */ 147 PHY_SETTING( 20000, FULL, 20000baseKR2_Full ), 148 PHY_SETTING( 20000, FULL, 20000baseMLD2_Full ), 149 /* 10G */ 150 PHY_SETTING( 10000, FULL, 10000baseCR_Full ), 151 PHY_SETTING( 10000, FULL, 10000baseER_Full ), 152 PHY_SETTING( 10000, FULL, 10000baseKR_Full ), 153 PHY_SETTING( 10000, FULL, 10000baseKX4_Full ), 154 PHY_SETTING( 10000, FULL, 10000baseLR_Full ), 155 PHY_SETTING( 10000, FULL, 10000baseLRM_Full ), 156 PHY_SETTING( 10000, FULL, 10000baseR_FEC ), 157 PHY_SETTING( 10000, FULL, 10000baseSR_Full ), 158 PHY_SETTING( 10000, FULL, 10000baseT_Full ), 159 /* 5G */ 160 PHY_SETTING( 5000, FULL, 5000baseT_Full ), 161 /* 2.5G */ 162 PHY_SETTING( 2500, FULL, 2500baseT_Full ), 163 PHY_SETTING( 2500, FULL, 2500baseX_Full ), 164 /* 1G */ 165 PHY_SETTING( 1000, FULL, 1000baseT_Full ), 166 PHY_SETTING( 1000, HALF, 1000baseT_Half ), 167 PHY_SETTING( 1000, FULL, 1000baseT1_Full ), 168 PHY_SETTING( 1000, FULL, 1000baseX_Full ), 169 PHY_SETTING( 1000, FULL, 1000baseKX_Full ), 170 /* 100M */ 171 PHY_SETTING( 100, FULL, 100baseT_Full ), 172 PHY_SETTING( 100, FULL, 100baseT1_Full ), 173 PHY_SETTING( 100, HALF, 100baseT_Half ), 174 PHY_SETTING( 100, HALF, 100baseFX_Half ), 175 PHY_SETTING( 100, FULL, 100baseFX_Full ), 176 /* 10M */ 177 PHY_SETTING( 10, FULL, 10baseT_Full ), 178 PHY_SETTING( 10, HALF, 10baseT_Half ), 179 }; 180 #undef PHY_SETTING 181 182 /** 183 * phy_lookup_setting - lookup a PHY setting 184 * @speed: speed to match 185 * @duplex: duplex to match 186 * @mask: allowed link modes 187 * @exact: an exact match is required 188 * 189 * Search the settings array for a setting that matches the speed and 190 * duplex, and which is supported. 191 * 192 * If @exact is unset, either an exact match or %NULL for no match will 193 * be returned. 194 * 195 * If @exact is set, an exact match, the fastest supported setting at 196 * or below the specified speed, the slowest supported setting, or if 197 * they all fail, %NULL will be returned. 198 */ 199 const struct phy_setting * 200 phy_lookup_setting(int speed, int duplex, const unsigned long *mask, bool exact) 201 { 202 const struct phy_setting *p, *match = NULL, *last = NULL; 203 int i; 204 205 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) { 206 if (p->bit < __ETHTOOL_LINK_MODE_MASK_NBITS && 207 test_bit(p->bit, mask)) { 208 last = p; 209 if (p->speed == speed && p->duplex == duplex) { 210 /* Exact match for speed and duplex */ 211 match = p; 212 break; 213 } else if (!exact) { 214 if (!match && p->speed <= speed) 215 /* Candidate */ 216 match = p; 217 218 if (p->speed < speed) 219 break; 220 } 221 } 222 } 223 224 if (!match && !exact) 225 match = last; 226 227 return match; 228 } 229 EXPORT_SYMBOL_GPL(phy_lookup_setting); 230 231 size_t phy_speeds(unsigned int *speeds, size_t size, 232 unsigned long *mask) 233 { 234 size_t count; 235 int i; 236 237 for (i = 0, count = 0; i < ARRAY_SIZE(settings) && count < size; i++) 238 if (settings[i].bit < __ETHTOOL_LINK_MODE_MASK_NBITS && 239 test_bit(settings[i].bit, mask) && 240 (count == 0 || speeds[count - 1] != settings[i].speed)) 241 speeds[count++] = settings[i].speed; 242 243 return count; 244 } 245 246 static int __set_linkmode_max_speed(u32 max_speed, unsigned long *addr) 247 { 248 const struct phy_setting *p; 249 int i; 250 251 for (i = 0, p = settings; i < ARRAY_SIZE(settings); i++, p++) { 252 if (p->speed > max_speed) 253 linkmode_clear_bit(p->bit, addr); 254 else 255 break; 256 } 257 258 return 0; 259 } 260 261 static int __set_phy_supported(struct phy_device *phydev, u32 max_speed) 262 { 263 return __set_linkmode_max_speed(max_speed, phydev->supported); 264 } 265 266 /** 267 * phy_set_max_speed - Set the maximum speed the PHY should support 268 * 269 * @phydev: The phy_device struct 270 * @max_speed: Maximum speed 271 * 272 * The PHY might be more capable than the MAC. For example a Fast Ethernet 273 * is connected to a 1G PHY. This function allows the MAC to indicate its 274 * maximum speed, and so limit what the PHY will advertise. 275 */ 276 int phy_set_max_speed(struct phy_device *phydev, u32 max_speed) 277 { 278 int err; 279 280 err = __set_phy_supported(phydev, max_speed); 281 if (err) 282 return err; 283 284 phy_advertise_supported(phydev); 285 286 return 0; 287 } 288 EXPORT_SYMBOL(phy_set_max_speed); 289 290 void of_set_phy_supported(struct phy_device *phydev) 291 { 292 struct device_node *node = phydev->mdio.dev.of_node; 293 u32 max_speed; 294 295 if (!IS_ENABLED(CONFIG_OF_MDIO)) 296 return; 297 298 if (!node) 299 return; 300 301 if (!of_property_read_u32(node, "max-speed", &max_speed)) 302 __set_phy_supported(phydev, max_speed); 303 } 304 305 void of_set_phy_eee_broken(struct phy_device *phydev) 306 { 307 struct device_node *node = phydev->mdio.dev.of_node; 308 u32 broken = 0; 309 310 if (!IS_ENABLED(CONFIG_OF_MDIO)) 311 return; 312 313 if (!node) 314 return; 315 316 if (of_property_read_bool(node, "eee-broken-100tx")) 317 broken |= MDIO_EEE_100TX; 318 if (of_property_read_bool(node, "eee-broken-1000t")) 319 broken |= MDIO_EEE_1000T; 320 if (of_property_read_bool(node, "eee-broken-10gt")) 321 broken |= MDIO_EEE_10GT; 322 if (of_property_read_bool(node, "eee-broken-1000kx")) 323 broken |= MDIO_EEE_1000KX; 324 if (of_property_read_bool(node, "eee-broken-10gkx4")) 325 broken |= MDIO_EEE_10GKX4; 326 if (of_property_read_bool(node, "eee-broken-10gkr")) 327 broken |= MDIO_EEE_10GKR; 328 329 phydev->eee_broken_modes = broken; 330 } 331 332 /** 333 * phy_resolve_aneg_pause - Determine pause autoneg results 334 * 335 * @phydev: The phy_device struct 336 * 337 * Once autoneg has completed the local pause settings can be 338 * resolved. Determine if pause and asymmetric pause should be used 339 * by the MAC. 340 */ 341 342 void phy_resolve_aneg_pause(struct phy_device *phydev) 343 { 344 if (phydev->duplex == DUPLEX_FULL) { 345 phydev->pause = linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT, 346 phydev->lp_advertising); 347 phydev->asym_pause = linkmode_test_bit( 348 ETHTOOL_LINK_MODE_Asym_Pause_BIT, 349 phydev->lp_advertising); 350 } 351 } 352 EXPORT_SYMBOL_GPL(phy_resolve_aneg_pause); 353 354 /** 355 * phy_resolve_aneg_linkmode - resolve the advertisements into PHY settings 356 * @phydev: The phy_device struct 357 * 358 * Resolve our and the link partner advertisements into their corresponding 359 * speed and duplex. If full duplex was negotiated, extract the pause mode 360 * from the link partner mask. 361 */ 362 void phy_resolve_aneg_linkmode(struct phy_device *phydev) 363 { 364 __ETHTOOL_DECLARE_LINK_MODE_MASK(common); 365 int i; 366 367 linkmode_and(common, phydev->lp_advertising, phydev->advertising); 368 369 for (i = 0; i < ARRAY_SIZE(settings); i++) 370 if (test_bit(settings[i].bit, common)) { 371 phydev->speed = settings[i].speed; 372 phydev->duplex = settings[i].duplex; 373 break; 374 } 375 376 phy_resolve_aneg_pause(phydev); 377 } 378 EXPORT_SYMBOL_GPL(phy_resolve_aneg_linkmode); 379 380 /** 381 * phy_check_downshift - check whether downshift occurred 382 * @phydev: The phy_device struct 383 * 384 * Check whether a downshift to a lower speed occurred. If this should be the 385 * case warn the user. 386 * Prerequisite for detecting downshift is that PHY driver implements the 387 * read_status callback and sets phydev->speed to the actual link speed. 388 */ 389 void phy_check_downshift(struct phy_device *phydev) 390 { 391 __ETHTOOL_DECLARE_LINK_MODE_MASK(common); 392 int i, speed = SPEED_UNKNOWN; 393 394 phydev->downshifted_rate = 0; 395 396 if (phydev->autoneg == AUTONEG_DISABLE || 397 phydev->speed == SPEED_UNKNOWN) 398 return; 399 400 linkmode_and(common, phydev->lp_advertising, phydev->advertising); 401 402 for (i = 0; i < ARRAY_SIZE(settings); i++) 403 if (test_bit(settings[i].bit, common)) { 404 speed = settings[i].speed; 405 break; 406 } 407 408 if (speed == SPEED_UNKNOWN || phydev->speed >= speed) 409 return; 410 411 phydev_warn(phydev, "Downshift occurred from negotiated speed %s to actual speed %s, check cabling!\n", 412 phy_speed_to_str(speed), phy_speed_to_str(phydev->speed)); 413 414 phydev->downshifted_rate = 1; 415 } 416 EXPORT_SYMBOL_GPL(phy_check_downshift); 417 418 static int phy_resolve_min_speed(struct phy_device *phydev, bool fdx_only) 419 { 420 __ETHTOOL_DECLARE_LINK_MODE_MASK(common); 421 int i = ARRAY_SIZE(settings); 422 423 linkmode_and(common, phydev->lp_advertising, phydev->advertising); 424 425 while (--i >= 0) { 426 if (test_bit(settings[i].bit, common)) { 427 if (fdx_only && settings[i].duplex != DUPLEX_FULL) 428 continue; 429 return settings[i].speed; 430 } 431 } 432 433 return SPEED_UNKNOWN; 434 } 435 436 int phy_speed_down_core(struct phy_device *phydev) 437 { 438 int min_common_speed = phy_resolve_min_speed(phydev, true); 439 440 if (min_common_speed == SPEED_UNKNOWN) 441 return -EINVAL; 442 443 return __set_linkmode_max_speed(min_common_speed, phydev->advertising); 444 } 445 446 static void mmd_phy_indirect(struct mii_bus *bus, int phy_addr, int devad, 447 u16 regnum) 448 { 449 /* Write the desired MMD Devad */ 450 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL, devad); 451 452 /* Write the desired MMD register address */ 453 __mdiobus_write(bus, phy_addr, MII_MMD_DATA, regnum); 454 455 /* Select the Function : DATA with no post increment */ 456 __mdiobus_write(bus, phy_addr, MII_MMD_CTRL, 457 devad | MII_MMD_CTRL_NOINCR); 458 } 459 460 /** 461 * __phy_read_mmd - Convenience function for reading a register 462 * from an MMD on a given PHY. 463 * @phydev: The phy_device struct 464 * @devad: The MMD to read from (0..31) 465 * @regnum: The register on the MMD to read (0..65535) 466 * 467 * Same rules as for __phy_read(); 468 */ 469 int __phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum) 470 { 471 int val; 472 473 if (regnum > (u16)~0 || devad > 32) 474 return -EINVAL; 475 476 if (phydev->drv && phydev->drv->read_mmd) { 477 val = phydev->drv->read_mmd(phydev, devad, regnum); 478 } else if (phydev->is_c45) { 479 val = __mdiobus_c45_read(phydev->mdio.bus, phydev->mdio.addr, 480 devad, regnum); 481 } else { 482 struct mii_bus *bus = phydev->mdio.bus; 483 int phy_addr = phydev->mdio.addr; 484 485 mmd_phy_indirect(bus, phy_addr, devad, regnum); 486 487 /* Read the content of the MMD's selected register */ 488 val = __mdiobus_read(bus, phy_addr, MII_MMD_DATA); 489 } 490 return val; 491 } 492 EXPORT_SYMBOL(__phy_read_mmd); 493 494 /** 495 * phy_read_mmd - Convenience function for reading a register 496 * from an MMD on a given PHY. 497 * @phydev: The phy_device struct 498 * @devad: The MMD to read from 499 * @regnum: The register on the MMD to read 500 * 501 * Same rules as for phy_read(); 502 */ 503 int phy_read_mmd(struct phy_device *phydev, int devad, u32 regnum) 504 { 505 int ret; 506 507 phy_lock_mdio_bus(phydev); 508 ret = __phy_read_mmd(phydev, devad, regnum); 509 phy_unlock_mdio_bus(phydev); 510 511 return ret; 512 } 513 EXPORT_SYMBOL(phy_read_mmd); 514 515 /** 516 * __phy_write_mmd - Convenience function for writing a register 517 * on an MMD on a given PHY. 518 * @phydev: The phy_device struct 519 * @devad: The MMD to read from 520 * @regnum: The register on the MMD to read 521 * @val: value to write to @regnum 522 * 523 * Same rules as for __phy_write(); 524 */ 525 int __phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val) 526 { 527 int ret; 528 529 if (regnum > (u16)~0 || devad > 32) 530 return -EINVAL; 531 532 if (phydev->drv && phydev->drv->write_mmd) { 533 ret = phydev->drv->write_mmd(phydev, devad, regnum, val); 534 } else if (phydev->is_c45) { 535 ret = __mdiobus_c45_write(phydev->mdio.bus, phydev->mdio.addr, 536 devad, regnum, val); 537 } else { 538 struct mii_bus *bus = phydev->mdio.bus; 539 int phy_addr = phydev->mdio.addr; 540 541 mmd_phy_indirect(bus, phy_addr, devad, regnum); 542 543 /* Write the data into MMD's selected register */ 544 __mdiobus_write(bus, phy_addr, MII_MMD_DATA, val); 545 546 ret = 0; 547 } 548 return ret; 549 } 550 EXPORT_SYMBOL(__phy_write_mmd); 551 552 /** 553 * phy_write_mmd - Convenience function for writing a register 554 * on an MMD on a given PHY. 555 * @phydev: The phy_device struct 556 * @devad: The MMD to read from 557 * @regnum: The register on the MMD to read 558 * @val: value to write to @regnum 559 * 560 * Same rules as for phy_write(); 561 */ 562 int phy_write_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val) 563 { 564 int ret; 565 566 phy_lock_mdio_bus(phydev); 567 ret = __phy_write_mmd(phydev, devad, regnum, val); 568 phy_unlock_mdio_bus(phydev); 569 570 return ret; 571 } 572 EXPORT_SYMBOL(phy_write_mmd); 573 574 /** 575 * phy_modify_changed - Function for modifying a PHY register 576 * @phydev: the phy_device struct 577 * @regnum: register number to modify 578 * @mask: bit mask of bits to clear 579 * @set: new value of bits set in mask to write to @regnum 580 * 581 * NOTE: MUST NOT be called from interrupt context, 582 * because the bus read/write functions may wait for an interrupt 583 * to conclude the operation. 584 * 585 * Returns negative errno, 0 if there was no change, and 1 in case of change 586 */ 587 int phy_modify_changed(struct phy_device *phydev, u32 regnum, u16 mask, u16 set) 588 { 589 int ret; 590 591 phy_lock_mdio_bus(phydev); 592 ret = __phy_modify_changed(phydev, regnum, mask, set); 593 phy_unlock_mdio_bus(phydev); 594 595 return ret; 596 } 597 EXPORT_SYMBOL_GPL(phy_modify_changed); 598 599 /** 600 * __phy_modify - Convenience function for modifying a PHY register 601 * @phydev: the phy_device struct 602 * @regnum: register number to modify 603 * @mask: bit mask of bits to clear 604 * @set: new value of bits set in mask to write to @regnum 605 * 606 * NOTE: MUST NOT be called from interrupt context, 607 * because the bus read/write functions may wait for an interrupt 608 * to conclude the operation. 609 */ 610 int __phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set) 611 { 612 int ret; 613 614 ret = __phy_modify_changed(phydev, regnum, mask, set); 615 616 return ret < 0 ? ret : 0; 617 } 618 EXPORT_SYMBOL_GPL(__phy_modify); 619 620 /** 621 * phy_modify - Convenience function for modifying a given PHY register 622 * @phydev: the phy_device struct 623 * @regnum: register number to write 624 * @mask: bit mask of bits to clear 625 * @set: new value of bits set in mask to write to @regnum 626 * 627 * NOTE: MUST NOT be called from interrupt context, 628 * because the bus read/write functions may wait for an interrupt 629 * to conclude the operation. 630 */ 631 int phy_modify(struct phy_device *phydev, u32 regnum, u16 mask, u16 set) 632 { 633 int ret; 634 635 phy_lock_mdio_bus(phydev); 636 ret = __phy_modify(phydev, regnum, mask, set); 637 phy_unlock_mdio_bus(phydev); 638 639 return ret; 640 } 641 EXPORT_SYMBOL_GPL(phy_modify); 642 643 /** 644 * __phy_modify_mmd_changed - Function for modifying a register on MMD 645 * @phydev: the phy_device struct 646 * @devad: the MMD containing register to modify 647 * @regnum: register number to modify 648 * @mask: bit mask of bits to clear 649 * @set: new value of bits set in mask to write to @regnum 650 * 651 * Unlocked helper function which allows a MMD register to be modified as 652 * new register value = (old register value & ~mask) | set 653 * 654 * Returns negative errno, 0 if there was no change, and 1 in case of change 655 */ 656 int __phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum, 657 u16 mask, u16 set) 658 { 659 int new, ret; 660 661 ret = __phy_read_mmd(phydev, devad, regnum); 662 if (ret < 0) 663 return ret; 664 665 new = (ret & ~mask) | set; 666 if (new == ret) 667 return 0; 668 669 ret = __phy_write_mmd(phydev, devad, regnum, new); 670 671 return ret < 0 ? ret : 1; 672 } 673 EXPORT_SYMBOL_GPL(__phy_modify_mmd_changed); 674 675 /** 676 * phy_modify_mmd_changed - Function for modifying a register on MMD 677 * @phydev: the phy_device struct 678 * @devad: the MMD containing register to modify 679 * @regnum: register number to modify 680 * @mask: bit mask of bits to clear 681 * @set: new value of bits set in mask to write to @regnum 682 * 683 * NOTE: MUST NOT be called from interrupt context, 684 * because the bus read/write functions may wait for an interrupt 685 * to conclude the operation. 686 * 687 * Returns negative errno, 0 if there was no change, and 1 in case of change 688 */ 689 int phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum, 690 u16 mask, u16 set) 691 { 692 int ret; 693 694 phy_lock_mdio_bus(phydev); 695 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set); 696 phy_unlock_mdio_bus(phydev); 697 698 return ret; 699 } 700 EXPORT_SYMBOL_GPL(phy_modify_mmd_changed); 701 702 /** 703 * __phy_modify_mmd - Convenience function for modifying a register on MMD 704 * @phydev: the phy_device struct 705 * @devad: the MMD containing register to modify 706 * @regnum: register number to modify 707 * @mask: bit mask of bits to clear 708 * @set: new value of bits set in mask to write to @regnum 709 * 710 * NOTE: MUST NOT be called from interrupt context, 711 * because the bus read/write functions may wait for an interrupt 712 * to conclude the operation. 713 */ 714 int __phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum, 715 u16 mask, u16 set) 716 { 717 int ret; 718 719 ret = __phy_modify_mmd_changed(phydev, devad, regnum, mask, set); 720 721 return ret < 0 ? ret : 0; 722 } 723 EXPORT_SYMBOL_GPL(__phy_modify_mmd); 724 725 /** 726 * phy_modify_mmd - Convenience function for modifying a register on MMD 727 * @phydev: the phy_device struct 728 * @devad: the MMD containing register to modify 729 * @regnum: register number to modify 730 * @mask: bit mask of bits to clear 731 * @set: new value of bits set in mask to write to @regnum 732 * 733 * NOTE: MUST NOT be called from interrupt context, 734 * because the bus read/write functions may wait for an interrupt 735 * to conclude the operation. 736 */ 737 int phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum, 738 u16 mask, u16 set) 739 { 740 int ret; 741 742 phy_lock_mdio_bus(phydev); 743 ret = __phy_modify_mmd(phydev, devad, regnum, mask, set); 744 phy_unlock_mdio_bus(phydev); 745 746 return ret; 747 } 748 EXPORT_SYMBOL_GPL(phy_modify_mmd); 749 750 static int __phy_read_page(struct phy_device *phydev) 751 { 752 if (WARN_ONCE(!phydev->drv->read_page, "read_page callback not available, PHY driver not loaded?\n")) 753 return -EOPNOTSUPP; 754 755 return phydev->drv->read_page(phydev); 756 } 757 758 static int __phy_write_page(struct phy_device *phydev, int page) 759 { 760 if (WARN_ONCE(!phydev->drv->write_page, "write_page callback not available, PHY driver not loaded?\n")) 761 return -EOPNOTSUPP; 762 763 return phydev->drv->write_page(phydev, page); 764 } 765 766 /** 767 * phy_save_page() - take the bus lock and save the current page 768 * @phydev: a pointer to a &struct phy_device 769 * 770 * Take the MDIO bus lock, and return the current page number. On error, 771 * returns a negative errno. phy_restore_page() must always be called 772 * after this, irrespective of success or failure of this call. 773 */ 774 int phy_save_page(struct phy_device *phydev) 775 { 776 phy_lock_mdio_bus(phydev); 777 return __phy_read_page(phydev); 778 } 779 EXPORT_SYMBOL_GPL(phy_save_page); 780 781 /** 782 * phy_select_page() - take the bus lock, save the current page, and set a page 783 * @phydev: a pointer to a &struct phy_device 784 * @page: desired page 785 * 786 * Take the MDIO bus lock to protect against concurrent access, save the 787 * current PHY page, and set the current page. On error, returns a 788 * negative errno, otherwise returns the previous page number. 789 * phy_restore_page() must always be called after this, irrespective 790 * of success or failure of this call. 791 */ 792 int phy_select_page(struct phy_device *phydev, int page) 793 { 794 int ret, oldpage; 795 796 oldpage = ret = phy_save_page(phydev); 797 if (ret < 0) 798 return ret; 799 800 if (oldpage != page) { 801 ret = __phy_write_page(phydev, page); 802 if (ret < 0) 803 return ret; 804 } 805 806 return oldpage; 807 } 808 EXPORT_SYMBOL_GPL(phy_select_page); 809 810 /** 811 * phy_restore_page() - restore the page register and release the bus lock 812 * @phydev: a pointer to a &struct phy_device 813 * @oldpage: the old page, return value from phy_save_page() or phy_select_page() 814 * @ret: operation's return code 815 * 816 * Release the MDIO bus lock, restoring @oldpage if it is a valid page. 817 * This function propagates the earliest error code from the group of 818 * operations. 819 * 820 * Returns: 821 * @oldpage if it was a negative value, otherwise 822 * @ret if it was a negative errno value, otherwise 823 * phy_write_page()'s negative value if it were in error, otherwise 824 * @ret. 825 */ 826 int phy_restore_page(struct phy_device *phydev, int oldpage, int ret) 827 { 828 int r; 829 830 if (oldpage >= 0) { 831 r = __phy_write_page(phydev, oldpage); 832 833 /* Propagate the operation return code if the page write 834 * was successful. 835 */ 836 if (ret >= 0 && r < 0) 837 ret = r; 838 } else { 839 /* Propagate the phy page selection error code */ 840 ret = oldpage; 841 } 842 843 phy_unlock_mdio_bus(phydev); 844 845 return ret; 846 } 847 EXPORT_SYMBOL_GPL(phy_restore_page); 848 849 /** 850 * phy_read_paged() - Convenience function for reading a paged register 851 * @phydev: a pointer to a &struct phy_device 852 * @page: the page for the phy 853 * @regnum: register number 854 * 855 * Same rules as for phy_read(). 856 */ 857 int phy_read_paged(struct phy_device *phydev, int page, u32 regnum) 858 { 859 int ret = 0, oldpage; 860 861 oldpage = phy_select_page(phydev, page); 862 if (oldpage >= 0) 863 ret = __phy_read(phydev, regnum); 864 865 return phy_restore_page(phydev, oldpage, ret); 866 } 867 EXPORT_SYMBOL(phy_read_paged); 868 869 /** 870 * phy_write_paged() - Convenience function for writing a paged register 871 * @phydev: a pointer to a &struct phy_device 872 * @page: the page for the phy 873 * @regnum: register number 874 * @val: value to write 875 * 876 * Same rules as for phy_write(). 877 */ 878 int phy_write_paged(struct phy_device *phydev, int page, u32 regnum, u16 val) 879 { 880 int ret = 0, oldpage; 881 882 oldpage = phy_select_page(phydev, page); 883 if (oldpage >= 0) 884 ret = __phy_write(phydev, regnum, val); 885 886 return phy_restore_page(phydev, oldpage, ret); 887 } 888 EXPORT_SYMBOL(phy_write_paged); 889 890 /** 891 * phy_modify_paged_changed() - Function for modifying a paged register 892 * @phydev: a pointer to a &struct phy_device 893 * @page: the page for the phy 894 * @regnum: register number 895 * @mask: bit mask of bits to clear 896 * @set: bit mask of bits to set 897 * 898 * Returns negative errno, 0 if there was no change, and 1 in case of change 899 */ 900 int phy_modify_paged_changed(struct phy_device *phydev, int page, u32 regnum, 901 u16 mask, u16 set) 902 { 903 int ret = 0, oldpage; 904 905 oldpage = phy_select_page(phydev, page); 906 if (oldpage >= 0) 907 ret = __phy_modify_changed(phydev, regnum, mask, set); 908 909 return phy_restore_page(phydev, oldpage, ret); 910 } 911 EXPORT_SYMBOL(phy_modify_paged_changed); 912 913 /** 914 * phy_modify_paged() - Convenience function for modifying a paged register 915 * @phydev: a pointer to a &struct phy_device 916 * @page: the page for the phy 917 * @regnum: register number 918 * @mask: bit mask of bits to clear 919 * @set: bit mask of bits to set 920 * 921 * Same rules as for phy_read() and phy_write(). 922 */ 923 int phy_modify_paged(struct phy_device *phydev, int page, u32 regnum, 924 u16 mask, u16 set) 925 { 926 int ret = phy_modify_paged_changed(phydev, page, regnum, mask, set); 927 928 return ret < 0 ? ret : 0; 929 } 930 EXPORT_SYMBOL(phy_modify_paged); 931