drivers/net/mdio.c

   1 /*
   2  * mdio.c: Generic support for MDIO-compatible transceivers
   3  * Copyright 2006-2009 Solarflare Communications Inc.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 as published
   7  * by the Free Software Foundation, incorporated herein by reference.
   8  */
   9
  10 #include <linux/kernel.h>
  11 #include <linux/capability.h>
  12 #include <linux/errno.h>
  13 #include <linux/ethtool.h>
  14 #include <linux/mdio.h>
  15 #include <linux/module.h>
  16
  17 MODULE_DESCRIPTION("Generic support for MDIO-compatible transceivers");
  18 MODULE_AUTHOR("Copyright 2006-2009 Solarflare Communications Inc.");
  19 MODULE_LICENSE("GPL");
  20
  21 /**
  22  * mdio45_probe - probe for an MDIO (clause 45) device
  23  * @mdio: MDIO interface
  24  * @prtad: Expected PHY address
  25  *
  26  * This sets @prtad and @mmds in the MDIO interface if successful.
  27  * Returns 0 on success, negative on error.
  28  */
  29 int mdio45_probe(struct mdio_if_info *mdio, int prtad)
  30 {
  31         int mmd, stat2, devs1, devs2;
  32
  33         /* Assume PHY must have at least one of PMA/PMD, WIS, PCS, PHY
  34          * XS or DTE XS; give up if none is present. */
  35         for (mmd = 1; mmd <= 5; mmd++) {
  36                 /* Is this MMD present? */
  37                 stat2 = mdio->mdio_read(mdio->dev, prtad, mmd, MDIO_STAT2);
  38                 if (stat2 < 0 ||
  39                     (stat2 & MDIO_STAT2_DEVPRST) != MDIO_STAT2_DEVPRST_VAL)
  40                         continue;
  41
  42                 /* It should tell us about all the other MMDs */
  43                 devs1 = mdio->mdio_read(mdio->dev, prtad, mmd, MDIO_DEVS1);
  44                 devs2 = mdio->mdio_read(mdio->dev, prtad, mmd, MDIO_DEVS2);
  45                 if (devs1 < 0 || devs2 < 0)
  46                         continue;
  47
  48                 mdio->prtad = prtad;
  49                 mdio->mmds = devs1 | (devs2 << 16);
  50                 return 0;
  51         }
  52
  53         return -ENODEV;
  54 }
  55 EXPORT_SYMBOL(mdio45_probe);
  56
  57 /**
  58  * mdio_set_flag - set or clear flag in an MDIO register
  59  * @mdio: MDIO interface
  60  * @prtad: PHY address
  61  * @devad: MMD address
  62  * @addr: Register address
  63  * @mask: Mask for flag (single bit set)
  64  * @sense: New value of flag
  65  *
  66  * This debounces changes: it does not write the register if the flag
  67  * already has the proper value.  Returns 0 on success, negative on error.
  68  */
  69 int mdio_set_flag(const struct mdio_if_info *mdio,
  70                   int prtad, int devad, u16 addr, int mask,
  71                   bool sense)
  72 {
  73         int old_val = mdio->mdio_read(mdio->dev, prtad, devad, addr);
  74         int new_val;
  75
  76         if (old_val < 0)
  77                 return old_val;
  78         if (sense)
  79                 new_val = old_val | mask;
  80         else
  81                 new_val = old_val & ~mask;
  82         if (old_val == new_val)
  83                 return 0;
  84         return mdio->mdio_write(mdio->dev, prtad, devad, addr, new_val);
  85 }
  86 EXPORT_SYMBOL(mdio_set_flag);
  87
  88 /**
  89  * mdio_link_ok - is link status up/OK
  90  * @mdio: MDIO interface
  91  * @mmd_mask: Mask for MMDs to check
  92  *
  93  * Returns 1 if the PHY reports link status up/OK, 0 otherwise.
  94  * @mmd_mask is normally @mdio->mmds, but if loopback is enabled
  95  * the MMDs being bypassed should be excluded from the mask.
  96  */
  97 int mdio45_links_ok(const struct mdio_if_info *mdio, u32 mmd_mask)
  98 {
  99         int devad, reg;
 100
 101         if (!mmd_mask) {
 102                 /* Use absence of XGMII faults in lieu of link state */
 103                 reg = mdio->mdio_read(mdio->dev, mdio->prtad,
 104                                       MDIO_MMD_PHYXS, MDIO_STAT2);
 105                 return reg >= 0 && !(reg & MDIO_STAT2_RXFAULT);
 106         }
 107
 108         for (devad = 0; mmd_mask; devad++) {
 109                 if (mmd_mask & (1 << devad)) {
 110                         mmd_mask &= ~(1 << devad);
 111
 112                         /* Reset the latched status and fault flags */
 113                         mdio->mdio_read(mdio->dev, mdio->prtad,
 114                                         devad, MDIO_STAT1);
 115                         if (devad == MDIO_MMD_PMAPMD || devad == MDIO_MMD_PCS ||
 116                             devad == MDIO_MMD_PHYXS || devad == MDIO_MMD_DTEXS)
 117                                 mdio->mdio_read(mdio->dev, mdio->prtad,
 118                                                 devad, MDIO_STAT2);
 119
 120                         /* Check the current status and fault flags */
 121                         reg = mdio->mdio_read(mdio->dev, mdio->prtad,
 122                                               devad, MDIO_STAT1);
 123                         if (reg < 0 ||
 124                             (reg & (MDIO_STAT1_FAULT | MDIO_STAT1_LSTATUS)) !=
 125                             MDIO_STAT1_LSTATUS)
 126                                 return false;
 127                 }
 128         }
 129
 130         return true;
 131 }
 132 EXPORT_SYMBOL(mdio45_links_ok);
 133
 134 /**
 135  * mdio45_nway_restart - restart auto-negotiation for this interface
 136  * @mdio: MDIO interface
 137  *
 138  * Returns 0 on success, negative on error.
 139  */
 140 int mdio45_nway_restart(const struct mdio_if_info *mdio)
 141 {
 142         if (!(mdio->mmds & MDIO_DEVS_AN))
 143                 return -EOPNOTSUPP;
 144
 145         mdio_set_flag(mdio, mdio->prtad, MDIO_MMD_AN, MDIO_CTRL1,
 146                       MDIO_AN_CTRL1_RESTART, true);
 147         return 0;
 148 }
 149 EXPORT_SYMBOL(mdio45_nway_restart);
 150
 151 static u32 mdio45_get_an(const struct mdio_if_info *mdio, u16 addr)
 152 {
 153         u32 result = 0;
 154         int reg;
 155
 156         reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_AN, addr);
 157         if (reg & ADVERTISE_10HALF)
 158                 result |= ADVERTISED_10baseT_Half;
 159         if (reg & ADVERTISE_10FULL)
 160                 result |= ADVERTISED_10baseT_Full;
 161         if (reg & ADVERTISE_100HALF)
 162                 result |= ADVERTISED_100baseT_Half;
 163         if (reg & ADVERTISE_100FULL)
 164                 result |= ADVERTISED_100baseT_Full;
 165         if (reg & ADVERTISE_PAUSE_CAP)
 166                 result |= ADVERTISED_Pause;
 167         if (reg & ADVERTISE_PAUSE_ASYM)
 168                 result |= ADVERTISED_Asym_Pause;
 169         return result;
 170 }
 171
 172 /**
 173  * mdio45_ethtool_gset_npage - get settings for ETHTOOL_GSET
 174  * @mdio: MDIO interface
 175  * @ecmd: Ethtool request structure
 176  * @npage_adv: Modes currently advertised on next pages
 177  * @npage_lpa: Modes advertised by link partner on next pages
 178  *
 179  * The @ecmd parameter is expected to have been cleared before calling
 180  * mdio45_ethtool_gset_npage().
 181  *
 182  * Since the CSRs for auto-negotiation using next pages are not fully
 183  * standardised, this function does not attempt to decode them.  The
 184  * caller must pass them in.
 185  */
 186 void mdio45_ethtool_gset_npage(const struct mdio_if_info *mdio,
 187                                struct ethtool_cmd *ecmd,
 188                                u32 npage_adv, u32 npage_lpa)
 189 {
 190         int reg;
 191
 192         ecmd->transceiver = XCVR_INTERNAL;
 193         ecmd->phy_address = mdio->prtad;
 194         ecmd->mdio_support =
 195                 mdio->mode_support & (MDIO_SUPPORTS_C45 | MDIO_SUPPORTS_C22);
 196
 197         reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 198                               MDIO_CTRL2);
 199         switch (reg & MDIO_PMA_CTRL2_TYPE) {
 200         case MDIO_PMA_CTRL2_10GBT:
 201         case MDIO_PMA_CTRL2_1000BT:
 202         case MDIO_PMA_CTRL2_100BTX:
 203         case MDIO_PMA_CTRL2_10BT:
 204                 ecmd->port = PORT_TP;
 205                 ecmd->supported = SUPPORTED_TP;
 206                 reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 207                                       MDIO_SPEED);
 208                 if (reg & MDIO_SPEED_10G)
 209                         ecmd->supported |= SUPPORTED_10000baseT_Full;
 210                 if (reg & MDIO_PMA_SPEED_1000)
 211                         ecmd->supported |= (SUPPORTED_1000baseT_Full |
 212                                             SUPPORTED_1000baseT_Half);
 213                 if (reg & MDIO_PMA_SPEED_100)
 214                         ecmd->supported |= (SUPPORTED_100baseT_Full |
 215                                             SUPPORTED_100baseT_Half);
 216                 if (reg & MDIO_PMA_SPEED_10)
 217                         ecmd->supported |= (SUPPORTED_10baseT_Full |
 218                                             SUPPORTED_10baseT_Half);
 219                 ecmd->advertising = ADVERTISED_TP;
 220                 break;
 221
 222         case MDIO_PMA_CTRL2_10GBCX4:
 223                 ecmd->port = PORT_OTHER;
 224                 ecmd->supported = 0;
 225                 ecmd->advertising = 0;
 226                 break;
 227
 228         case MDIO_PMA_CTRL2_10GBKX4:
 229         case MDIO_PMA_CTRL2_10GBKR:
 230         case MDIO_PMA_CTRL2_1000BKX:
 231                 ecmd->port = PORT_OTHER;
 232                 ecmd->supported = SUPPORTED_Backplane;
 233                 reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 234                                       MDIO_PMA_EXTABLE);
 235                 if (reg & MDIO_PMA_EXTABLE_10GBKX4)
 236                         ecmd->supported |= SUPPORTED_10000baseKX4_Full;
 237                 if (reg & MDIO_PMA_EXTABLE_10GBKR)
 238                         ecmd->supported |= SUPPORTED_10000baseKR_Full;
 239                 if (reg & MDIO_PMA_EXTABLE_1000BKX)
 240                         ecmd->supported |= SUPPORTED_1000baseKX_Full;
 241                 reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 242                                       MDIO_PMA_10GBR_FECABLE);
 243                 if (reg & MDIO_PMA_10GBR_FECABLE_ABLE)
 244                         ecmd->supported |= SUPPORTED_10000baseR_FEC;
 245                 ecmd->advertising = ADVERTISED_Backplane;
 246                 break;
 247
 248         /* All the other defined modes are flavours of optical */
 249         default:
 250                 ecmd->port = PORT_FIBRE;
 251                 ecmd->supported = SUPPORTED_FIBRE;
 252                 ecmd->advertising = ADVERTISED_FIBRE;
 253                 break;
 254         }
 255
 256         if (mdio->mmds & MDIO_DEVS_AN) {
 257                 ecmd->supported |= SUPPORTED_Autoneg;
 258                 reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_AN,
 259                                       MDIO_CTRL1);
 260                 if (reg & MDIO_AN_CTRL1_ENABLE) {
 261                         ecmd->autoneg = AUTONEG_ENABLE;
 262                         ecmd->advertising |=
 263                                 ADVERTISED_Autoneg |
 264                                 mdio45_get_an(mdio, MDIO_AN_ADVERTISE) |
 265                                 npage_adv;
 266                 } else {
 267                         ecmd->autoneg = AUTONEG_DISABLE;
 268                 }
 269         } else {
 270                 ecmd->autoneg = AUTONEG_DISABLE;
 271         }
 272
 273         if (ecmd->autoneg) {
 274                 u32 modes = 0;
 275                 int an_stat = mdio->mdio_read(mdio->dev, mdio->prtad,
 276                                               MDIO_MMD_AN, MDIO_STAT1);
 277
 278                 /* If AN is complete and successful, report best common
 279                  * mode, otherwise report best advertised mode. */
 280                 if (an_stat & MDIO_AN_STAT1_COMPLETE) {
 281                         ecmd->lp_advertising =
 282                                 mdio45_get_an(mdio, MDIO_AN_LPA) | npage_lpa;
 283                         if (an_stat & MDIO_AN_STAT1_LPABLE)
 284                                 ecmd->lp_advertising |= ADVERTISED_Autoneg;
 285                         modes = ecmd->advertising & ecmd->lp_advertising;
 286                 }
 287                 if ((modes & ~ADVERTISED_Autoneg) == 0)
 288                         modes = ecmd->advertising;
 289
 290                 if (modes & (ADVERTISED_10000baseT_Full |
 291                              ADVERTISED_10000baseKX4_Full |
 292                              ADVERTISED_10000baseKR_Full)) {
 293                         ecmd->speed = SPEED_10000;
 294                         ecmd->duplex = DUPLEX_FULL;
 295                 } else if (modes & (ADVERTISED_1000baseT_Full |
 296                                     ADVERTISED_1000baseT_Half |
 297                                     ADVERTISED_1000baseKX_Full)) {
 298                         ecmd->speed = SPEED_1000;
 299                         ecmd->duplex = !(modes & ADVERTISED_1000baseT_Half);
 300                 } else if (modes & (ADVERTISED_100baseT_Full |
 301                                     ADVERTISED_100baseT_Half)) {
 302                         ecmd->speed = SPEED_100;
 303                         ecmd->duplex = !!(modes & ADVERTISED_100baseT_Full);
 304                 } else {
 305                         ecmd->speed = SPEED_10;
 306                         ecmd->duplex = !!(modes & ADVERTISED_10baseT_Full);
 307                 }
 308         } else {
 309                 /* Report forced settings */
 310                 reg = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 311                                       MDIO_CTRL1);
 312                 ecmd->speed = (((reg & MDIO_PMA_CTRL1_SPEED1000) ? 100 : 1) *
 313                                ((reg & MDIO_PMA_CTRL1_SPEED100) ? 100 : 10));
 314                 ecmd->duplex = (reg & MDIO_CTRL1_FULLDPLX ||
 315                                 ecmd->speed == SPEED_10000);
 316         }
 317
 318         /* 10GBASE-T MDI/MDI-X */
 319         if (ecmd->port == PORT_TP && ecmd->speed == SPEED_10000) {
 320                 switch (mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_PMAPMD,
 321                                         MDIO_PMA_10GBT_SWAPPOL)) {
 322                 case MDIO_PMA_10GBT_SWAPPOL_ABNX | MDIO_PMA_10GBT_SWAPPOL_CDNX:
 323                         ecmd->eth_tp_mdix = ETH_TP_MDI;
 324                         break;
 325                 case 0:
 326                         ecmd->eth_tp_mdix = ETH_TP_MDI_X;
 327                         break;
 328                 default:
 329                         /* It's complicated... */
 330                         ecmd->eth_tp_mdix = ETH_TP_MDI_INVALID;
 331                         break;
 332                 }
 333         }
 334 }
 335 EXPORT_SYMBOL(mdio45_ethtool_gset_npage);
 336
 337 /**
 338  * mdio45_ethtool_spauseparam_an - set auto-negotiated pause parameters
 339  * @mdio: MDIO interface
 340  * @ecmd: Ethtool request structure
 341  *
 342  * This function assumes that the PHY has an auto-negotiation MMD.  It
 343  * will enable and disable advertising of flow control as appropriate.
 344  */
 345 void mdio45_ethtool_spauseparam_an(const struct mdio_if_info *mdio,
 346                                    const struct ethtool_pauseparam *ecmd)
 347 {
 348         int adv, old_adv;
 349
 350         WARN_ON(!(mdio->mmds & MDIO_DEVS_AN));
 351
 352         old_adv = mdio->mdio_read(mdio->dev, mdio->prtad, MDIO_MMD_AN,
 353                                   MDIO_AN_ADVERTISE);
 354         adv = ((old_adv & ~(ADVERTISE_PAUSE_CAP | ADVERTISE_PAUSE_ASYM)) |
 355                mii_advertise_flowctrl((ecmd->rx_pause ? FLOW_CTRL_RX : 0) |
 356                                       (ecmd->tx_pause ? FLOW_CTRL_TX : 0)));
 357         if (adv != old_adv) {
 358                 mdio->mdio_write(mdio->dev, mdio->prtad, MDIO_MMD_AN,
 359                                  MDIO_AN_ADVERTISE, adv);
 360                 mdio45_nway_restart(mdio);
 361         }
 362 }
 363 EXPORT_SYMBOL(mdio45_ethtool_spauseparam_an);
 364
 365 /**
 366  * mdio_mii_ioctl - MII ioctl interface for MDIO (clause 22 or 45) PHYs
 367  * @mdio: MDIO interface
 368  * @mii_data: MII ioctl data structure
 369  * @cmd: MII ioctl command
 370  *
 371  * Returns 0 on success, negative on error.
 372  */
 373 int mdio_mii_ioctl(const struct mdio_if_info *mdio,
 374                    struct mii_ioctl_data *mii_data, int cmd)
 375 {
 376         int prtad, devad;
 377         u16 addr = mii_data->reg_num;
 378
 379         /* Validate/convert cmd to one of SIOC{G,S}MIIREG */
 380         switch (cmd) {
 381         case SIOCGMIIPHY:
 382                 if (mdio->prtad == MDIO_PRTAD_NONE)
 383                         return -EOPNOTSUPP;
 384                 mii_data->phy_id = mdio->prtad;
 385                 cmd = SIOCGMIIREG;
 386                 break;
 387         case SIOCGMIIREG:
 388         case SIOCSMIIREG:
 389                 break;
 390         default:
 391                 return -EOPNOTSUPP;
 392         }
 393
 394         /* Validate/convert phy_id */
 395         if ((mdio->mode_support & MDIO_SUPPORTS_C45) &&
 396             mdio_phy_id_is_c45(mii_data->phy_id)) {
 397                 prtad = mdio_phy_id_prtad(mii_data->phy_id);
 398                 devad = mdio_phy_id_devad(mii_data->phy_id);
 399         } else if ((mdio->mode_support & MDIO_SUPPORTS_C22) &&
 400                    mii_data->phy_id < 0x20) {
 401                 prtad = mii_data->phy_id;
 402                 devad = MDIO_DEVAD_NONE;
 403                 addr &= 0x1f;
 404         } else if ((mdio->mode_support & MDIO_EMULATE_C22) &&
 405                    mdio->prtad != MDIO_PRTAD_NONE &&
 406                    mii_data->phy_id == mdio->prtad) {
 407                 /* Remap commonly-used MII registers. */
 408                 prtad = mdio->prtad;
 409                 switch (addr) {
 410                 case MII_BMCR:
 411                 case MII_BMSR:
 412                 case MII_PHYSID1:
 413                 case MII_PHYSID2:
 414                         devad = __ffs(mdio->mmds);
 415                         break;
 416                 case MII_ADVERTISE:
 417                 case MII_LPA:
 418                         if (!(mdio->mmds & MDIO_DEVS_AN))
 419                                 return -EINVAL;
 420                         devad = MDIO_MMD_AN;
 421                         if (addr == MII_ADVERTISE)
 422                                 addr = MDIO_AN_ADVERTISE;
 423                         else
 424                                 addr = MDIO_AN_LPA;
 425                         break;
 426                 default:
 427                         return -EINVAL;
 428                 }
 429         } else {
 430                 return -EINVAL;
 431         }
 432
 433         if (cmd == SIOCGMIIREG) {
 434                 int rc = mdio->mdio_read(mdio->dev, prtad, devad, addr);
 435                 if (rc < 0)
 436                         return rc;
 437                 mii_data->val_out = rc;
 438                 return 0;
 439         } else {
 440                 return mdio->mdio_write(mdio->dev, prtad, devad, addr,
 441                                         mii_data->val_in);
 442         }
 443 }
 444 EXPORT_SYMBOL(mdio_mii_ioctl);