1 // SPDX-License-Identifier: GPL-2.0+
3 * Generic PHY Management code
5 * Copyright 2011 Freescale Semiconductor, Inc.
8 * Based loosely off of Linux's PHY Lib
20 #include <asm/global_data.h>
21 #include <dm/of_extra.h>
22 #include <linux/bitops.h>
23 #include <linux/delay.h>
24 #include <linux/err.h>
25 #include <linux/compiler.h>
27 DECLARE_GLOBAL_DATA_PTR;
29 /* Generic PHY support and helper functions */
32 * genphy_config_advert - sanitize and advertise auto-negotiation parameters
33 * @phydev: target phy_device struct
35 * Description: Writes MII_ADVERTISE with the appropriate values,
36 * after sanitizing the values to make sure we only advertise
37 * what is supported. Returns < 0 on error, 0 if the PHY's advertisement
38 * hasn't changed, and > 0 if it has changed.
40 static int genphy_config_advert(struct phy_device *phydev)
43 int oldadv, adv, bmsr;
46 /* Only allow advertising what this PHY supports */
47 phydev->advertising &= phydev->supported;
48 advertise = phydev->advertising;
50 /* Setup standard advertisement */
51 adv = phy_read(phydev, MDIO_DEVAD_NONE, MII_ADVERTISE);
57 adv &= ~(ADVERTISE_ALL | ADVERTISE_100BASE4 | ADVERTISE_PAUSE_CAP |
58 ADVERTISE_PAUSE_ASYM);
59 if (advertise & ADVERTISED_10baseT_Half)
60 adv |= ADVERTISE_10HALF;
61 if (advertise & ADVERTISED_10baseT_Full)
62 adv |= ADVERTISE_10FULL;
63 if (advertise & ADVERTISED_100baseT_Half)
64 adv |= ADVERTISE_100HALF;
65 if (advertise & ADVERTISED_100baseT_Full)
66 adv |= ADVERTISE_100FULL;
67 if (advertise & ADVERTISED_Pause)
68 adv |= ADVERTISE_PAUSE_CAP;
69 if (advertise & ADVERTISED_Asym_Pause)
70 adv |= ADVERTISE_PAUSE_ASYM;
71 if (advertise & ADVERTISED_1000baseX_Half)
72 adv |= ADVERTISE_1000XHALF;
73 if (advertise & ADVERTISED_1000baseX_Full)
74 adv |= ADVERTISE_1000XFULL;
77 err = phy_write(phydev, MDIO_DEVAD_NONE, MII_ADVERTISE, adv);
84 bmsr = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
88 /* Per 802.3-2008, Section 22.2.4.2.16 Extended status all
89 * 1000Mbits/sec capable PHYs shall have the BMSR_ESTATEN bit set to a
92 if (!(bmsr & BMSR_ESTATEN))
95 /* Configure gigabit if it's supported */
96 adv = phy_read(phydev, MDIO_DEVAD_NONE, MII_CTRL1000);
102 adv &= ~(ADVERTISE_1000FULL | ADVERTISE_1000HALF);
104 if (phydev->supported & (SUPPORTED_1000baseT_Half |
105 SUPPORTED_1000baseT_Full)) {
106 if (advertise & SUPPORTED_1000baseT_Half)
107 adv |= ADVERTISE_1000HALF;
108 if (advertise & SUPPORTED_1000baseT_Full)
109 adv |= ADVERTISE_1000FULL;
115 err = phy_write(phydev, MDIO_DEVAD_NONE, MII_CTRL1000, adv);
123 * genphy_setup_forced - configures/forces speed/duplex from @phydev
124 * @phydev: target phy_device struct
126 * Description: Configures MII_BMCR to force speed/duplex
127 * to the values in phydev. Assumes that the values are valid.
129 static int genphy_setup_forced(struct phy_device *phydev)
132 int ctl = BMCR_ANRESTART;
135 phydev->asym_pause = 0;
137 if (phydev->speed == SPEED_1000)
138 ctl |= BMCR_SPEED1000;
139 else if (phydev->speed == SPEED_100)
140 ctl |= BMCR_SPEED100;
142 if (phydev->duplex == DUPLEX_FULL)
143 ctl |= BMCR_FULLDPLX;
145 err = phy_write(phydev, MDIO_DEVAD_NONE, MII_BMCR, ctl);
151 * genphy_restart_aneg - Enable and Restart Autonegotiation
152 * @phydev: target phy_device struct
154 int genphy_restart_aneg(struct phy_device *phydev)
158 ctl = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMCR);
163 ctl |= (BMCR_ANENABLE | BMCR_ANRESTART);
165 /* Don't isolate the PHY if we're negotiating */
166 ctl &= ~(BMCR_ISOLATE);
168 ctl = phy_write(phydev, MDIO_DEVAD_NONE, MII_BMCR, ctl);
174 * genphy_config_aneg - restart auto-negotiation or write BMCR
175 * @phydev: target phy_device struct
177 * Description: If auto-negotiation is enabled, we configure the
178 * advertising, and then restart auto-negotiation. If it is not
179 * enabled, then we write the BMCR.
181 int genphy_config_aneg(struct phy_device *phydev)
185 if (phydev->autoneg != AUTONEG_ENABLE)
186 return genphy_setup_forced(phydev);
188 result = genphy_config_advert(phydev);
190 if (result < 0) /* error */
195 * Advertisment hasn't changed, but maybe aneg was never on to
196 * begin with? Or maybe phy was isolated?
198 int ctl = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMCR);
203 if (!(ctl & BMCR_ANENABLE) || (ctl & BMCR_ISOLATE))
204 result = 1; /* do restart aneg */
208 * Only restart aneg if we are advertising something different
209 * than we were before.
212 result = genphy_restart_aneg(phydev);
218 * genphy_update_link - update link status in @phydev
219 * @phydev: target phy_device struct
221 * Description: Update the value in phydev->link to reflect the
222 * current link value. In order to do this, we need to read
223 * the status register twice, keeping the second value.
225 int genphy_update_link(struct phy_device *phydev)
227 unsigned int mii_reg;
230 * Wait if the link is up, and autonegotiation is in progress
231 * (ie - we're capable and it's not done)
233 mii_reg = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
236 * If we already saw the link up, and it hasn't gone down, then
237 * we don't need to wait for autoneg again
239 if (phydev->link && mii_reg & BMSR_LSTATUS)
242 if ((phydev->autoneg == AUTONEG_ENABLE) &&
243 !(mii_reg & BMSR_ANEGCOMPLETE)) {
246 printf("%s Waiting for PHY auto negotiation to complete",
248 while (!(mii_reg & BMSR_ANEGCOMPLETE)) {
252 if (i > (PHY_ANEG_TIMEOUT / 50)) {
253 printf(" TIMEOUT !\n");
259 puts("user interrupt!\n");
267 mii_reg = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
268 mdelay(50); /* 50 ms */
273 /* Read the link a second time to clear the latched state */
274 mii_reg = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
276 if (mii_reg & BMSR_LSTATUS)
286 * Generic function which updates the speed and duplex. If
287 * autonegotiation is enabled, it uses the AND of the link
288 * partner's advertised capabilities and our advertised
289 * capabilities. If autonegotiation is disabled, we use the
290 * appropriate bits in the control register.
292 * Stolen from Linux's mii.c and phy_device.c
294 int genphy_parse_link(struct phy_device *phydev)
296 int mii_reg = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
298 /* We're using autonegotiation */
299 if (phydev->autoneg == AUTONEG_ENABLE) {
304 /* Check for gigabit capability */
305 if (phydev->supported & (SUPPORTED_1000baseT_Full |
306 SUPPORTED_1000baseT_Half)) {
307 /* We want a list of states supported by
308 * both PHYs in the link
310 gblpa = phy_read(phydev, MDIO_DEVAD_NONE, MII_STAT1000);
312 debug("Could not read MII_STAT1000. ");
313 debug("Ignoring gigabit capability\n");
316 gblpa &= phy_read(phydev,
317 MDIO_DEVAD_NONE, MII_CTRL1000) << 2;
320 /* Set the baseline so we only have to set them
321 * if they're different
323 phydev->speed = SPEED_10;
324 phydev->duplex = DUPLEX_HALF;
326 /* Check the gigabit fields */
327 if (gblpa & (PHY_1000BTSR_1000FD | PHY_1000BTSR_1000HD)) {
328 phydev->speed = SPEED_1000;
330 if (gblpa & PHY_1000BTSR_1000FD)
331 phydev->duplex = DUPLEX_FULL;
337 lpa = phy_read(phydev, MDIO_DEVAD_NONE, MII_ADVERTISE);
338 lpa &= phy_read(phydev, MDIO_DEVAD_NONE, MII_LPA);
340 if (lpa & (LPA_100FULL | LPA_100HALF)) {
341 phydev->speed = SPEED_100;
343 if (lpa & LPA_100FULL)
344 phydev->duplex = DUPLEX_FULL;
346 } else if (lpa & LPA_10FULL) {
347 phydev->duplex = DUPLEX_FULL;
351 * Extended status may indicate that the PHY supports
352 * 1000BASE-T/X even though the 1000BASE-T registers
353 * are missing. In this case we can't tell whether the
354 * peer also supports it, so we only check extended
355 * status if the 1000BASE-T registers are actually
358 if ((mii_reg & BMSR_ESTATEN) && !(mii_reg & BMSR_ERCAP))
359 estatus = phy_read(phydev, MDIO_DEVAD_NONE,
362 if (estatus & (ESTATUS_1000_XFULL | ESTATUS_1000_XHALF |
363 ESTATUS_1000_TFULL | ESTATUS_1000_THALF)) {
364 phydev->speed = SPEED_1000;
365 if (estatus & (ESTATUS_1000_XFULL | ESTATUS_1000_TFULL))
366 phydev->duplex = DUPLEX_FULL;
370 u32 bmcr = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMCR);
372 phydev->speed = SPEED_10;
373 phydev->duplex = DUPLEX_HALF;
375 if (bmcr & BMCR_FULLDPLX)
376 phydev->duplex = DUPLEX_FULL;
378 if (bmcr & BMCR_SPEED1000)
379 phydev->speed = SPEED_1000;
380 else if (bmcr & BMCR_SPEED100)
381 phydev->speed = SPEED_100;
387 int genphy_config(struct phy_device *phydev)
392 features = (SUPPORTED_TP | SUPPORTED_MII
393 | SUPPORTED_AUI | SUPPORTED_FIBRE |
396 /* Do we support autonegotiation? */
397 val = phy_read(phydev, MDIO_DEVAD_NONE, MII_BMSR);
402 if (val & BMSR_ANEGCAPABLE)
403 features |= SUPPORTED_Autoneg;
405 if (val & BMSR_100FULL)
406 features |= SUPPORTED_100baseT_Full;
407 if (val & BMSR_100HALF)
408 features |= SUPPORTED_100baseT_Half;
409 if (val & BMSR_10FULL)
410 features |= SUPPORTED_10baseT_Full;
411 if (val & BMSR_10HALF)
412 features |= SUPPORTED_10baseT_Half;
414 if (val & BMSR_ESTATEN) {
415 val = phy_read(phydev, MDIO_DEVAD_NONE, MII_ESTATUS);
420 if (val & ESTATUS_1000_TFULL)
421 features |= SUPPORTED_1000baseT_Full;
422 if (val & ESTATUS_1000_THALF)
423 features |= SUPPORTED_1000baseT_Half;
424 if (val & ESTATUS_1000_XFULL)
425 features |= SUPPORTED_1000baseX_Full;
426 if (val & ESTATUS_1000_XHALF)
427 features |= SUPPORTED_1000baseX_Half;
430 phydev->supported &= features;
431 phydev->advertising &= features;
433 genphy_config_aneg(phydev);
438 int genphy_startup(struct phy_device *phydev)
442 ret = genphy_update_link(phydev);
446 return genphy_parse_link(phydev);
449 int genphy_shutdown(struct phy_device *phydev)
454 U_BOOT_PHY_DRIVER(genphy) = {
457 .name = "Generic PHY",
458 .features = PHY_GBIT_FEATURES | SUPPORTED_MII |
459 SUPPORTED_AUI | SUPPORTED_FIBRE |
461 .config = genphy_config,
462 .startup = genphy_startup,
463 .shutdown = genphy_shutdown,
466 #ifdef CONFIG_NEEDS_MANUAL_RELOC
469 const int ll_n_ents = ll_entry_count(struct phy_driver, phy_driver);
470 struct phy_driver *drv, *ll_entry;
472 /* Perform manual relocation on linker list based PHY drivers */
473 ll_entry = ll_entry_start(struct phy_driver, phy_driver);
474 for (drv = ll_entry; drv != ll_entry + ll_n_ents; drv++) {
476 drv->probe += gd->reloc_off;
478 drv->config += gd->reloc_off;
480 drv->startup += gd->reloc_off;
482 drv->shutdown += gd->reloc_off;
484 drv->readext += gd->reloc_off;
486 drv->writeext += gd->reloc_off;
488 drv->read_mmd += gd->reloc_off;
490 drv->write_mmd += gd->reloc_off;
497 int phy_set_supported(struct phy_device *phydev, u32 max_speed)
499 /* The default values for phydev->supported are provided by the PHY
500 * driver "features" member, we want to reset to sane defaults first
501 * before supporting higher speeds.
503 phydev->supported &= PHY_DEFAULT_FEATURES;
509 phydev->supported |= PHY_1000BT_FEATURES;
512 phydev->supported |= PHY_100BT_FEATURES;
515 phydev->supported |= PHY_10BT_FEATURES;
521 static int phy_probe(struct phy_device *phydev)
525 phydev->advertising = phydev->drv->features;
526 phydev->supported = phydev->drv->features;
528 phydev->mmds = phydev->drv->mmds;
530 if (phydev->drv->probe)
531 err = phydev->drv->probe(phydev);
536 static struct phy_driver *generic_for_phy(struct phy_device *phydev)
538 #ifdef CONFIG_PHYLIB_10G
540 return ll_entry_get(struct phy_driver, gen10g, phy_driver);
543 return ll_entry_get(struct phy_driver, genphy, phy_driver);
546 static struct phy_driver *get_phy_driver(struct phy_device *phydev)
548 const int ll_n_ents = ll_entry_count(struct phy_driver, phy_driver);
549 int phy_id = phydev->phy_id;
550 struct phy_driver *ll_entry;
551 struct phy_driver *drv;
553 ll_entry = ll_entry_start(struct phy_driver, phy_driver);
554 for (drv = ll_entry; drv != ll_entry + ll_n_ents; drv++)
555 if ((drv->uid & drv->mask) == (phy_id & drv->mask))
558 /* If we made it here, there's no driver for this PHY */
559 return generic_for_phy(phydev);
562 struct phy_device *phy_device_create(struct mii_dev *bus, int addr,
563 u32 phy_id, bool is_c45)
565 struct phy_device *dev;
568 * We allocate the device, and initialize the
571 dev = malloc(sizeof(*dev));
573 printf("Failed to allocate PHY device for %s:%d\n",
574 bus ? bus->name : "(null bus)", addr);
578 memset(dev, 0, sizeof(*dev));
582 dev->interface = PHY_INTERFACE_MODE_NA;
584 dev->node = ofnode_null();
586 dev->autoneg = AUTONEG_ENABLE;
589 dev->phy_id = phy_id;
590 dev->is_c45 = is_c45;
593 dev->drv = get_phy_driver(dev);
595 if (phy_probe(dev)) {
596 printf("%s, PHY probe failed\n", __func__);
600 if (addr >= 0 && addr < PHY_MAX_ADDR && phy_id != PHY_FIXED_ID)
601 bus->phymap[addr] = dev;
607 * get_phy_id - reads the specified addr for its ID.
608 * @bus: the target MII bus
609 * @addr: PHY address on the MII bus
610 * @phy_id: where to store the ID retrieved.
612 * Description: Reads the ID registers of the PHY at @addr on the
613 * @bus, stores it in @phy_id and returns zero on success.
615 int __weak get_phy_id(struct mii_dev *bus, int addr, int devad, u32 *phy_id)
620 * Grab the bits from PHYIR1, and put them
623 phy_reg = bus->read(bus, addr, devad, MII_PHYSID1);
628 *phy_id = (phy_reg & 0xffff) << 16;
630 /* Grab the bits from PHYIR2, and put them in the lower half */
631 phy_reg = bus->read(bus, addr, devad, MII_PHYSID2);
636 *phy_id |= (phy_reg & 0xffff);
641 static struct phy_device *create_phy_by_mask(struct mii_dev *bus,
642 uint phy_mask, int devad)
644 u32 phy_id = 0xffffffff;
648 int addr = ffs(phy_mask) - 1;
649 int r = get_phy_id(bus, addr, devad, &phy_id);
652 * If the PHY ID is flat 0 we ignore it. There are C45 PHYs
653 * that return all 0s for C22 reads (like Aquantia AQR112) and
654 * there are C22 PHYs that return all 0s for C45 reads (like
657 if (r == 0 && phy_id == 0)
660 /* If the PHY ID is mostly f's, we didn't find anything */
661 if (r == 0 && (phy_id & 0x1fffffff) != 0x1fffffff) {
662 is_c45 = (devad == MDIO_DEVAD_NONE) ? false : true;
663 return phy_device_create(bus, addr, phy_id, is_c45);
666 phy_mask &= ~(1 << addr);
671 static struct phy_device *search_for_existing_phy(struct mii_dev *bus,
674 /* If we have one, return the existing device, with new interface */
676 int addr = ffs(phy_mask) - 1;
678 if (bus->phymap[addr])
679 return bus->phymap[addr];
681 phy_mask &= ~(1 << addr);
686 static struct phy_device *get_phy_device_by_mask(struct mii_dev *bus,
689 struct phy_device *phydev;
702 devad_cnt = sizeof(devad)/sizeof(int);
703 phydev = search_for_existing_phy(bus, phy_mask);
706 /* try different access clauses */
707 for (i = 0; i < devad_cnt; i++) {
708 phydev = create_phy_by_mask(bus, phy_mask, devad[i]);
715 debug("\n%s PHY: ", bus->name);
717 int addr = ffs(phy_mask) - 1;
720 phy_mask &= ~(1 << addr);
722 debug("not found\n");
728 * get_phy_device - reads the specified PHY device and returns its
730 * @bus: the target MII bus
731 * @addr: PHY address on the MII bus
733 * Description: Reads the ID registers of the PHY at @addr on the
734 * @bus, then allocates and returns the phy_device to represent it.
736 static struct phy_device *get_phy_device(struct mii_dev *bus, int addr)
738 return get_phy_device_by_mask(bus, 1 << addr);
741 int phy_reset(struct phy_device *phydev)
745 int devad = MDIO_DEVAD_NONE;
747 if (phydev->flags & PHY_FLAG_BROKEN_RESET)
750 #ifdef CONFIG_PHYLIB_10G
751 /* If it's 10G, we need to issue reset through one of the MMDs */
752 if (phydev->is_c45) {
754 gen10g_discover_mmds(phydev);
756 devad = ffs(phydev->mmds) - 1;
760 if (phy_write(phydev, devad, MII_BMCR, BMCR_RESET) < 0) {
761 debug("PHY reset failed\n");
765 #if CONFIG_PHY_RESET_DELAY > 0
766 udelay(CONFIG_PHY_RESET_DELAY); /* Intel LXT971A needs this */
769 * Poll the control register for the reset bit to go to 0 (it is
770 * auto-clearing). This should happen within 0.5 seconds per the
773 reg = phy_read(phydev, devad, MII_BMCR);
774 while ((reg & BMCR_RESET) && timeout--) {
775 reg = phy_read(phydev, devad, MII_BMCR);
778 debug("PHY status read failed\n");
784 if (reg & BMCR_RESET) {
785 puts("PHY reset timed out\n");
792 int miiphy_reset(const char *devname, unsigned char addr)
794 struct mii_dev *bus = miiphy_get_dev_by_name(devname);
795 struct phy_device *phydev;
797 phydev = get_phy_device(bus, addr);
799 return phy_reset(phydev);
802 struct phy_device *phy_find_by_mask(struct mii_dev *bus, uint phy_mask)
808 /* Wait 15ms to make sure the PHY has come out of hard reset */
812 return get_phy_device_by_mask(bus, phy_mask);
815 void phy_connect_dev(struct phy_device *phydev, struct udevice *dev,
816 phy_interface_t interface)
818 /* Soft Reset the PHY */
820 if (phydev->dev && phydev->dev != dev) {
821 printf("%s:%d is connected to %s. Reconnecting to %s\n",
822 phydev->bus->name, phydev->addr,
823 phydev->dev->name, dev->name);
826 phydev->interface = interface;
827 debug("%s connected to %s mode %s\n", dev->name, phydev->drv->name,
828 phy_string_for_interface(interface));
831 #ifdef CONFIG_PHY_XILINX_GMII2RGMII
832 static struct phy_device *phy_connect_gmii2rgmii(struct mii_dev *bus,
835 struct phy_device *phydev = NULL;
838 ofnode_for_each_subnode(node, dev_ofnode(dev)) {
839 node = ofnode_by_compatible(node, "xlnx,gmii-to-rgmii-1.0");
840 if (ofnode_valid(node)) {
841 phydev = phy_device_create(bus, 0,
842 PHY_GMII2RGMII_ID, false);
848 node = ofnode_first_subnode(node);
855 #ifdef CONFIG_PHY_FIXED
857 * fixed_phy_create() - create an unconnected fixed-link pseudo-PHY device
858 * @node: OF node for the container of the fixed-link node
860 * Description: Creates a struct phy_device based on a fixed-link of_node
861 * description. Can be used without phy_connect by drivers which do not expose
862 * a UCLASS_ETH udevice.
864 struct phy_device *fixed_phy_create(ofnode node)
866 struct phy_device *phydev;
869 subnode = ofnode_find_subnode(node, "fixed-link");
870 if (!ofnode_valid(subnode)) {
874 phydev = phy_device_create(NULL, 0, PHY_FIXED_ID, false);
876 phydev->node = subnode;
877 phydev->interface = ofnode_read_phy_mode(node);
883 static struct phy_device *phy_connect_fixed(struct mii_dev *bus,
886 ofnode node = dev_ofnode(dev), subnode;
887 struct phy_device *phydev = NULL;
889 if (ofnode_phy_is_fixed_link(node, &subnode)) {
890 phydev = phy_device_create(bus, 0, PHY_FIXED_ID, false);
892 phydev->node = subnode;
899 struct phy_device *phy_connect(struct mii_dev *bus, int addr,
901 phy_interface_t interface)
903 struct phy_device *phydev = NULL;
904 uint mask = (addr >= 0) ? (1 << addr) : 0xffffffff;
906 #ifdef CONFIG_PHY_FIXED
907 phydev = phy_connect_fixed(bus, dev);
910 #ifdef CONFIG_PHY_NCSI
911 if (!phydev && interface == PHY_INTERFACE_MODE_NCSI)
912 phydev = phy_device_create(bus, 0, PHY_NCSI_ID, false);
915 #ifdef CONFIG_PHY_ETHERNET_ID
917 phydev = phy_connect_phy_id(bus, dev, addr);
920 #ifdef CONFIG_PHY_XILINX_GMII2RGMII
922 phydev = phy_connect_gmii2rgmii(bus, dev);
926 phydev = phy_find_by_mask(bus, mask);
929 phy_connect_dev(phydev, dev, interface);
931 printf("Could not get PHY for %s: addr %d\n", bus->name, addr);
936 * Start the PHY. Returns 0 on success, or a negative error code.
938 int phy_startup(struct phy_device *phydev)
940 if (phydev->drv->startup)
941 return phydev->drv->startup(phydev);
946 __weak int board_phy_config(struct phy_device *phydev)
948 if (phydev->drv->config)
949 return phydev->drv->config(phydev);
953 int phy_config(struct phy_device *phydev)
955 /* Invoke an optional board-specific helper */
956 return board_phy_config(phydev);
959 int phy_shutdown(struct phy_device *phydev)
961 if (phydev->drv->shutdown)
962 phydev->drv->shutdown(phydev);
968 * phy_modify - Convenience function for modifying a given PHY register
969 * @phydev: the phy_device struct
970 * @devad: The MMD to read from
971 * @regnum: register number to write
972 * @mask: bit mask of bits to clear
973 * @set: new value of bits set in mask to write to @regnum
975 int phy_modify(struct phy_device *phydev, int devad, int regnum, u16 mask,
980 ret = phy_read(phydev, devad, regnum);
984 return phy_write(phydev, devad, regnum, (ret & ~mask) | set);
988 * phy_read - Convenience function for reading a given PHY register
989 * @phydev: the phy_device struct
990 * @devad: The MMD to read from
991 * @regnum: register number to read
992 * @return: value for success or negative errno for failure
994 int phy_read(struct phy_device *phydev, int devad, int regnum)
996 struct mii_dev *bus = phydev->bus;
998 if (!bus || !bus->read) {
999 debug("%s: No bus configured\n", __func__);
1003 return bus->read(bus, phydev->addr, devad, regnum);
1007 * phy_write - Convenience function for writing a given PHY register
1008 * @phydev: the phy_device struct
1009 * @devad: The MMD to read from
1010 * @regnum: register number to write
1011 * @val: value to write to @regnum
1012 * @return: 0 for success or negative errno for failure
1014 int phy_write(struct phy_device *phydev, int devad, int regnum, u16 val)
1016 struct mii_dev *bus = phydev->bus;
1018 if (!bus || !bus->write) {
1019 debug("%s: No bus configured\n", __func__);
1023 return bus->write(bus, phydev->addr, devad, regnum, val);
1027 * phy_mmd_start_indirect - Convenience function for writing MMD registers
1028 * @phydev: the phy_device struct
1029 * @devad: The MMD to read from
1030 * @regnum: register number to write
1033 void phy_mmd_start_indirect(struct phy_device *phydev, int devad, int regnum)
1035 /* Write the desired MMD Devad */
1036 phy_write(phydev, MDIO_DEVAD_NONE, MII_MMD_CTRL, devad);
1038 /* Write the desired MMD register address */
1039 phy_write(phydev, MDIO_DEVAD_NONE, MII_MMD_DATA, regnum);
1041 /* Select the Function : DATA with no post increment */
1042 phy_write(phydev, MDIO_DEVAD_NONE, MII_MMD_CTRL,
1043 (devad | MII_MMD_CTRL_NOINCR));
1047 * phy_read_mmd - Convenience function for reading a register
1048 * from an MMD on a given PHY.
1049 * @phydev: The phy_device struct
1050 * @devad: The MMD to read from
1051 * @regnum: The register on the MMD to read
1052 * @return: Value for success or negative errno for failure
1054 int phy_read_mmd(struct phy_device *phydev, int devad, int regnum)
1056 struct phy_driver *drv = phydev->drv;
1058 if (regnum > (u16)~0 || devad > 32)
1061 /* driver-specific access */
1063 return drv->read_mmd(phydev, devad, regnum);
1065 /* direct C45 / C22 access */
1066 if ((drv->features & PHY_10G_FEATURES) == PHY_10G_FEATURES ||
1067 devad == MDIO_DEVAD_NONE || !devad)
1068 return phy_read(phydev, devad, regnum);
1070 /* indirect C22 access */
1071 phy_mmd_start_indirect(phydev, devad, regnum);
1073 /* Read the content of the MMD's selected register */
1074 return phy_read(phydev, MDIO_DEVAD_NONE, MII_MMD_DATA);
1078 * phy_write_mmd - Convenience function for writing a register
1079 * on an MMD on a given PHY.
1080 * @phydev: The phy_device struct
1081 * @devad: The MMD to read from
1082 * @regnum: The register on the MMD to read
1083 * @val: value to write to @regnum
1084 * @return: 0 for success or negative errno for failure
1086 int phy_write_mmd(struct phy_device *phydev, int devad, int regnum, u16 val)
1088 struct phy_driver *drv = phydev->drv;
1090 if (regnum > (u16)~0 || devad > 32)
1093 /* driver-specific access */
1095 return drv->write_mmd(phydev, devad, regnum, val);
1097 /* direct C45 / C22 access */
1098 if ((drv->features & PHY_10G_FEATURES) == PHY_10G_FEATURES ||
1099 devad == MDIO_DEVAD_NONE || !devad)
1100 return phy_write(phydev, devad, regnum, val);
1102 /* indirect C22 access */
1103 phy_mmd_start_indirect(phydev, devad, regnum);
1105 /* Write the data into MMD's selected register */
1106 return phy_write(phydev, MDIO_DEVAD_NONE, MII_MMD_DATA, val);
1110 * phy_set_bits_mmd - Convenience function for setting bits in a register
1112 * @phydev: the phy_device struct
1113 * @devad: the MMD containing register to modify
1114 * @regnum: register number to modify
1116 * @return: 0 for success or negative errno for failure
1118 int phy_set_bits_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
1122 value = phy_read_mmd(phydev, devad, regnum);
1128 ret = phy_write_mmd(phydev, devad, regnum, value);
1136 * phy_clear_bits_mmd - Convenience function for clearing bits in a register
1138 * @phydev: the phy_device struct
1139 * @devad: the MMD containing register to modify
1140 * @regnum: register number to modify
1141 * @val: bits to clear
1142 * @return: 0 for success or negative errno for failure
1144 int phy_clear_bits_mmd(struct phy_device *phydev, int devad, u32 regnum, u16 val)
1148 value = phy_read_mmd(phydev, devad, regnum);
1154 ret = phy_write_mmd(phydev, devad, regnum, value);
1162 * phy_modify_mmd_changed - Function for modifying a register on MMD
1163 * @phydev: the phy_device struct
1164 * @devad: the MMD containing register to modify
1165 * @regnum: register number to modify
1166 * @mask: bit mask of bits to clear
1167 * @set: new value of bits set in mask to write to @regnum
1169 * NOTE: MUST NOT be called from interrupt context,
1170 * because the bus read/write functions may wait for an interrupt
1171 * to conclude the operation.
1173 * Returns negative errno, 0 if there was no change, and 1 in case of change
1175 int phy_modify_mmd_changed(struct phy_device *phydev, int devad, u32 regnum,
1180 ret = phy_read_mmd(phydev, devad, regnum);
1184 new = (ret & ~mask) | set;
1188 ret = phy_write_mmd(phydev, devad, regnum, new);
1190 return ret < 0 ? ret : 1;
1194 * phy_modify_mmd - Convenience function for modifying a register on MMD
1195 * @phydev: the phy_device struct
1196 * @devad: the MMD containing register to modify
1197 * @regnum: register number to modify
1198 * @mask: bit mask of bits to clear
1199 * @set: new value of bits set in mask to write to @regnum
1201 * NOTE: MUST NOT be called from interrupt context,
1202 * because the bus read/write functions may wait for an interrupt
1203 * to conclude the operation.
1205 int phy_modify_mmd(struct phy_device *phydev, int devad, u32 regnum,
1210 ret = phy_modify_mmd_changed(phydev, devad, regnum, mask, set);
1212 return ret < 0 ? ret : 0;
1215 bool phy_interface_is_ncsi(void)
1217 #ifdef CONFIG_PHY_NCSI
1218 struct eth_pdata *pdata = dev_get_plat(eth_get_dev());
1220 return pdata->phy_interface == PHY_INTERFACE_MODE_NCSI;