SAFE public projects git trees. - safe/jmp/linux-2.6/blob - include/linux/mdio.h

   1 /*
   2  * linux/mdio.h: definitions for MDIO (clause 45) 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 #ifndef __LINUX_MDIO_H__
  11 #define __LINUX_MDIO_H__
  12
  13 #include <linux/mii.h>
  14
  15 /* MDIO Manageable Devices (MMDs). */
  16 #define MDIO_MMD_PMAPMD         1       /* Physical Medium Attachment/
  17                                          * Physical Medium Dependent */
  18 #define MDIO_MMD_WIS            2       /* WAN Interface Sublayer */
  19 #define MDIO_MMD_PCS            3       /* Physical Coding Sublayer */
  20 #define MDIO_MMD_PHYXS          4       /* PHY Extender Sublayer */
  21 #define MDIO_MMD_DTEXS          5       /* DTE Extender Sublayer */
  22 #define MDIO_MMD_TC             6       /* Transmission Convergence */
  23 #define MDIO_MMD_AN             7       /* Auto-Negotiation */
  24 #define MDIO_MMD_C22EXT         29      /* Clause 22 extension */
  25 #define MDIO_MMD_VEND1          30      /* Vendor specific 1 */
  26 #define MDIO_MMD_VEND2          31      /* Vendor specific 2 */
  27
  28 /* Generic MDIO registers. */
  29 #define MDIO_CTRL1              MII_BMCR
  30 #define MDIO_STAT1              MII_BMSR
  31 #define MDIO_DEVID1             MII_PHYSID1
  32 #define MDIO_DEVID2             MII_PHYSID2
  33 #define MDIO_SPEED              4       /* Speed ability */
  34 #define MDIO_DEVS1              5       /* Devices in package */
  35 #define MDIO_DEVS2              6
  36 #define MDIO_CTRL2              7       /* 10G control 2 */
  37 #define MDIO_STAT2              8       /* 10G status 2 */
  38 #define MDIO_PMA_TXDIS          9       /* 10G PMA/PMD transmit disable */
  39 #define MDIO_PMA_RXDET          10      /* 10G PMA/PMD receive signal detect */
  40 #define MDIO_PMA_EXTABLE        11      /* 10G PMA/PMD extended ability */
  41 #define MDIO_PKGID1             14      /* Package identifier */
  42 #define MDIO_PKGID2             15
  43 #define MDIO_AN_ADVERTISE       16      /* AN advertising (base page) */
  44 #define MDIO_AN_LPA             19      /* AN LP abilities (base page) */
  45 #define MDIO_PHYXS_LNSTAT       24      /* PHY XGXS lane state */
  46
  47 /* Media-dependent registers. */
  48 #define MDIO_PMA_10GBT_TXPWR    131     /* 10GBASE-T TX power control */
  49 #define MDIO_PMA_10GBT_SNR      133     /* 10GBASE-T SNR margin, lane A.
  50                                          * Lanes B-D are numbered 134-136. */
  51 #define MDIO_PMA_10GBR_FECABLE  170     /* 10GBASE-R FEC ability */
  52 #define MDIO_PCS_10GBX_STAT1    24      /* 10GBASE-X PCS status 1 */
  53 #define MDIO_PCS_10GBRT_STAT1   32      /* 10GBASE-R/-T PCS status 1 */
  54 #define MDIO_PCS_10GBRT_STAT2   33      /* 10GBASE-R/-T PCS status 2 */
  55 #define MDIO_AN_10GBT_CTRL      32      /* 10GBASE-T auto-negotiation control */
  56 #define MDIO_AN_10GBT_STAT      33      /* 10GBASE-T auto-negotiation status */
  57
  58 /* LASI (Link Alarm Status Interrupt) registers, defined by XENPAK MSA. */
  59 #define MDIO_PMA_LASI_RXCTRL    0x9000  /* RX_ALARM control */
  60 #define MDIO_PMA_LASI_TXCTRL    0x9001  /* TX_ALARM control */
  61 #define MDIO_PMA_LASI_CTRL      0x9002  /* LASI control */
  62 #define MDIO_PMA_LASI_RXSTAT    0x9003  /* RX_ALARM status */
  63 #define MDIO_PMA_LASI_TXSTAT    0x9004  /* TX_ALARM status */
  64 #define MDIO_PMA_LASI_STAT      0x9005  /* LASI status */
  65
  66 /* Control register 1. */
  67 /* Enable extended speed selection */
  68 #define MDIO_CTRL1_SPEEDSELEXT          (BMCR_SPEED1000 | BMCR_SPEED100)
  69 /* All speed selection bits */
  70 #define MDIO_CTRL1_SPEEDSEL             (MDIO_CTRL1_SPEEDSELEXT | 0x003c)
  71 #define MDIO_CTRL1_FULLDPLX             BMCR_FULLDPLX
  72 #define MDIO_CTRL1_LPOWER               BMCR_PDOWN
  73 #define MDIO_CTRL1_RESET                BMCR_RESET
  74 #define MDIO_PMA_CTRL1_LOOPBACK         0x0001
  75 #define MDIO_PMA_CTRL1_SPEED1000        BMCR_SPEED1000
  76 #define MDIO_PMA_CTRL1_SPEED100         BMCR_SPEED100
  77 #define MDIO_PCS_CTRL1_LOOPBACK         BMCR_LOOPBACK
  78 #define MDIO_PHYXS_CTRL1_LOOPBACK       BMCR_LOOPBACK
  79 #define MDIO_AN_CTRL1_RESTART           BMCR_ANRESTART
  80 #define MDIO_AN_CTRL1_ENABLE            BMCR_ANENABLE
  81 #define MDIO_AN_CTRL1_XNP               0x2000  /* Enable extended next page */
  82
  83 /* 10 Gb/s */
  84 #define MDIO_CTRL1_SPEED10G             (MDIO_CTRL1_SPEEDSELEXT | 0x00)
  85 /* 10PASS-TS/2BASE-TL */
  86 #define MDIO_CTRL1_SPEED10P2B           (MDIO_CTRL1_SPEEDSELEXT | 0x04)
  87
  88 /* Status register 1. */
  89 #define MDIO_STAT1_LPOWERABLE           0x0002  /* Low-power ability */
  90 #define MDIO_STAT1_LSTATUS              BMSR_LSTATUS
  91 #define MDIO_STAT1_FAULT                0x0080  /* Fault */
  92 #define MDIO_AN_STAT1_LPABLE            0x0001  /* Link partner AN ability */
  93 #define MDIO_AN_STAT1_ABLE              BMSR_ANEGCAPABLE
  94 #define MDIO_AN_STAT1_RFAULT            BMSR_RFAULT
  95 #define MDIO_AN_STAT1_COMPLETE          BMSR_ANEGCOMPLETE
  96 #define MDIO_AN_STAT1_PAGE              0x0040  /* Page received */
  97 #define MDIO_AN_STAT1_XNP               0x0080  /* Extended next page status */
  98
  99 /* Speed register. */
 100 #define MDIO_SPEED_10G                  0x0001  /* 10G capable */
 101 #define MDIO_PMA_SPEED_2B               0x0002  /* 2BASE-TL capable */
 102 #define MDIO_PMA_SPEED_10P              0x0004  /* 10PASS-TS capable */
 103 #define MDIO_PMA_SPEED_1000             0x0010  /* 1000M capable */
 104 #define MDIO_PMA_SPEED_100              0x0020  /* 100M capable */
 105 #define MDIO_PMA_SPEED_10               0x0040  /* 10M capable */
 106 #define MDIO_PCS_SPEED_10P2B            0x0002  /* 10PASS-TS/2BASE-TL capable */
 107
 108 /* Device present registers. */
 109 #define MDIO_DEVS_PRESENT(devad)        (1 << (devad))
 110 #define MDIO_DEVS_PMAPMD                MDIO_DEVS_PRESENT(MDIO_MMD_PMAPMD)
 111 #define MDIO_DEVS_WIS                   MDIO_DEVS_PRESENT(MDIO_MMD_WIS)
 112 #define MDIO_DEVS_PCS                   MDIO_DEVS_PRESENT(MDIO_MMD_PCS)
 113 #define MDIO_DEVS_PHYXS                 MDIO_DEVS_PRESENT(MDIO_MMD_PHYXS)
 114 #define MDIO_DEVS_DTEXS                 MDIO_DEVS_PRESENT(MDIO_MMD_DTEXS)
 115 #define MDIO_DEVS_TC                    MDIO_DEVS_PRESENT(MDIO_MMD_TC)
 116 #define MDIO_DEVS_AN                    MDIO_DEVS_PRESENT(MDIO_MMD_AN)
 117 #define MDIO_DEVS_C22EXT                MDIO_DEVS_PRESENT(MDIO_MMD_C22EXT)
 118
 119 /* Control register 2. */
 120 #define MDIO_PMA_CTRL2_TYPE             0x000f  /* PMA/PMD type selection */
 121 #define MDIO_PMA_CTRL2_10GBCX4          0x0000  /* 10GBASE-CX4 type */
 122 #define MDIO_PMA_CTRL2_10GBEW           0x0001  /* 10GBASE-EW type */
 123 #define MDIO_PMA_CTRL2_10GBLW           0x0002  /* 10GBASE-LW type */
 124 #define MDIO_PMA_CTRL2_10GBSW           0x0003  /* 10GBASE-SW type */
 125 #define MDIO_PMA_CTRL2_10GBLX4          0x0004  /* 10GBASE-LX4 type */
 126 #define MDIO_PMA_CTRL2_10GBER           0x0005  /* 10GBASE-ER type */
 127 #define MDIO_PMA_CTRL2_10GBLR           0x0006  /* 10GBASE-LR type */
 128 #define MDIO_PMA_CTRL2_10GBSR           0x0007  /* 10GBASE-SR type */
 129 #define MDIO_PMA_CTRL2_10GBLRM          0x0008  /* 10GBASE-LRM type */
 130 #define MDIO_PMA_CTRL2_10GBT            0x0009  /* 10GBASE-T type */
 131 #define MDIO_PMA_CTRL2_10GBKX4          0x000a  /* 10GBASE-KX4 type */
 132 #define MDIO_PMA_CTRL2_10GBKR           0x000b  /* 10GBASE-KR type */
 133 #define MDIO_PMA_CTRL2_1000BT           0x000c  /* 1000BASE-T type */
 134 #define MDIO_PMA_CTRL2_1000BKX          0x000d  /* 1000BASE-KX type */
 135 #define MDIO_PMA_CTRL2_100BTX           0x000e  /* 100BASE-TX type */
 136 #define MDIO_PMA_CTRL2_10BT             0x000f  /* 10BASE-T type */
 137 #define MDIO_PCS_CTRL2_TYPE             0x0003  /* PCS type selection */
 138 #define MDIO_PCS_CTRL2_10GBR            0x0000  /* 10GBASE-R type */
 139 #define MDIO_PCS_CTRL2_10GBX            0x0001  /* 10GBASE-X type */
 140 #define MDIO_PCS_CTRL2_10GBW            0x0002  /* 10GBASE-W type */
 141 #define MDIO_PCS_CTRL2_10GBT            0x0003  /* 10GBASE-T type */
 142
 143 /* Status register 2. */
 144 #define MDIO_STAT2_RXFAULT              0x0400  /* Receive fault */
 145 #define MDIO_STAT2_TXFAULT              0x0800  /* Transmit fault */
 146 #define MDIO_STAT2_DEVPRST              0xc000  /* Device present */
 147 #define MDIO_STAT2_DEVPRST_VAL          0x8000  /* Device present value */
 148 #define MDIO_PMA_STAT2_LBABLE           0x0001  /* PMA loopback ability */
 149 #define MDIO_PMA_STAT2_10GBEW           0x0002  /* 10GBASE-EW ability */
 150 #define MDIO_PMA_STAT2_10GBLW           0x0004  /* 10GBASE-LW ability */
 151 #define MDIO_PMA_STAT2_10GBSW           0x0008  /* 10GBASE-SW ability */
 152 #define MDIO_PMA_STAT2_10GBLX4          0x0010  /* 10GBASE-LX4 ability */
 153 #define MDIO_PMA_STAT2_10GBER           0x0020  /* 10GBASE-ER ability */
 154 #define MDIO_PMA_STAT2_10GBLR           0x0040  /* 10GBASE-LR ability */
 155 #define MDIO_PMA_STAT2_10GBSR           0x0080  /* 10GBASE-SR ability */
 156 #define MDIO_PMD_STAT2_TXDISAB          0x0100  /* PMD TX disable ability */
 157 #define MDIO_PMA_STAT2_EXTABLE          0x0200  /* Extended abilities */
 158 #define MDIO_PMA_STAT2_RXFLTABLE        0x1000  /* Receive fault ability */
 159 #define MDIO_PMA_STAT2_TXFLTABLE        0x2000  /* Transmit fault ability */
 160 #define MDIO_PCS_STAT2_10GBR            0x0001  /* 10GBASE-R capable */
 161 #define MDIO_PCS_STAT2_10GBX            0x0002  /* 10GBASE-X capable */
 162 #define MDIO_PCS_STAT2_10GBW            0x0004  /* 10GBASE-W capable */
 163 #define MDIO_PCS_STAT2_RXFLTABLE        0x1000  /* Receive fault ability */
 164 #define MDIO_PCS_STAT2_TXFLTABLE        0x2000  /* Transmit fault ability */
 165
 166 /* Transmit disable register. */
 167 #define MDIO_PMD_TXDIS_GLOBAL           0x0001  /* Global PMD TX disable */
 168 #define MDIO_PMD_TXDIS_0                0x0002  /* PMD TX disable 0 */
 169 #define MDIO_PMD_TXDIS_1                0x0004  /* PMD TX disable 1 */
 170 #define MDIO_PMD_TXDIS_2                0x0008  /* PMD TX disable 2 */
 171 #define MDIO_PMD_TXDIS_3                0x0010  /* PMD TX disable 3 */
 172
 173 /* Receive signal detect register. */
 174 #define MDIO_PMD_RXDET_GLOBAL           0x0001  /* Global PMD RX signal detect */
 175 #define MDIO_PMD_RXDET_0                0x0002  /* PMD RX signal detect 0 */
 176 #define MDIO_PMD_RXDET_1                0x0004  /* PMD RX signal detect 1 */
 177 #define MDIO_PMD_RXDET_2                0x0008  /* PMD RX signal detect 2 */
 178 #define MDIO_PMD_RXDET_3                0x0010  /* PMD RX signal detect 3 */
 179
 180 /* Extended abilities register. */
 181 #define MDIO_PMA_EXTABLE_10GCX4         0x0001  /* 10GBASE-CX4 ability */
 182 #define MDIO_PMA_EXTABLE_10GBLRM        0x0002  /* 10GBASE-LRM ability */
 183 #define MDIO_PMA_EXTABLE_10GBT          0x0004  /* 10GBASE-T ability */
 184 #define MDIO_PMA_EXTABLE_10GBKX4        0x0008  /* 10GBASE-KX4 ability */
 185 #define MDIO_PMA_EXTABLE_10GBKR         0x0010  /* 10GBASE-KR ability */
 186 #define MDIO_PMA_EXTABLE_1000BT         0x0020  /* 1000BASE-T ability */
 187 #define MDIO_PMA_EXTABLE_1000BKX        0x0040  /* 1000BASE-KX ability */
 188 #define MDIO_PMA_EXTABLE_100BTX         0x0080  /* 100BASE-TX ability */
 189 #define MDIO_PMA_EXTABLE_10BT           0x0100  /* 10BASE-T ability */
 190
 191 /* PHY XGXS lane state register. */
 192 #define MDIO_PHYXS_LNSTAT_SYNC0         0x0001
 193 #define MDIO_PHYXS_LNSTAT_SYNC1         0x0002
 194 #define MDIO_PHYXS_LNSTAT_SYNC2         0x0004
 195 #define MDIO_PHYXS_LNSTAT_SYNC3         0x0008
 196 #define MDIO_PHYXS_LNSTAT_ALIGN         0x1000
 197
 198 /* PMA 10GBASE-T TX power register. */
 199 #define MDIO_PMA_10GBT_TXPWR_SHORT      0x0001  /* Short-reach mode */
 200
 201 /* PMA 10GBASE-T SNR registers. */
 202 /* Value is SNR margin in dB, clamped to range [-127, 127], plus 0x8000. */
 203 #define MDIO_PMA_10GBT_SNR_BIAS         0x8000
 204 #define MDIO_PMA_10GBT_SNR_MAX          127
 205
 206 /* PMA 10GBASE-R FEC ability register. */
 207 #define MDIO_PMA_10GBR_FECABLE_ABLE     0x0001  /* FEC ability */
 208 #define MDIO_PMA_10GBR_FECABLE_ERRABLE  0x0002  /* FEC error indic. ability */
 209
 210 /* PCS 10GBASE-R/-T status register 1. */
 211 #define MDIO_PCS_10GBRT_STAT1_BLKLK     0x0001  /* Block lock attained */
 212
 213 /* PCS 10GBASE-R/-T status register 2. */
 214 #define MDIO_PCS_10GBRT_STAT2_ERR       0x00ff
 215 #define MDIO_PCS_10GBRT_STAT2_BER       0x3f00
 216
 217 /* AN 10GBASE-T control register. */
 218 #define MDIO_AN_10GBT_CTRL_ADV10G       0x1000  /* Advertise 10GBASE-T */
 219
 220 /* AN 10GBASE-T status register. */
 221 #define MDIO_AN_10GBT_STAT_LPTRR        0x0200  /* LP training reset req. */
 222 #define MDIO_AN_10GBT_STAT_LPLTABLE     0x0400  /* LP loop timing ability */
 223 #define MDIO_AN_10GBT_STAT_LP10G        0x0800  /* LP is 10GBT capable */
 224 #define MDIO_AN_10GBT_STAT_REMOK        0x1000  /* Remote OK */
 225 #define MDIO_AN_10GBT_STAT_LOCOK        0x2000  /* Local OK */
 226 #define MDIO_AN_10GBT_STAT_MS           0x4000  /* Master/slave config */
 227 #define MDIO_AN_10GBT_STAT_MSFLT        0x8000  /* Master/slave config fault */
 228
 229 /* LASI RX_ALARM control/status registers. */
 230 #define MDIO_PMA_LASI_RX_PHYXSLFLT      0x0001  /* PHY XS RX local fault */
 231 #define MDIO_PMA_LASI_RX_PCSLFLT        0x0008  /* PCS RX local fault */
 232 #define MDIO_PMA_LASI_RX_PMALFLT        0x0010  /* PMA/PMD RX local fault */
 233 #define MDIO_PMA_LASI_RX_OPTICPOWERFLT  0x0020  /* RX optical power fault */
 234 #define MDIO_PMA_LASI_RX_WISLFLT        0x0200  /* WIS local fault */
 235
 236 /* LASI TX_ALARM control/status registers. */
 237 #define MDIO_PMA_LASI_TX_PHYXSLFLT      0x0001  /* PHY XS TX local fault */
 238 #define MDIO_PMA_LASI_TX_PCSLFLT        0x0008  /* PCS TX local fault */
 239 #define MDIO_PMA_LASI_TX_PMALFLT        0x0010  /* PMA/PMD TX local fault */
 240 #define MDIO_PMA_LASI_TX_LASERPOWERFLT  0x0080  /* Laser output power fault */
 241 #define MDIO_PMA_LASI_TX_LASERTEMPFLT   0x0100  /* Laser temperature fault */
 242 #define MDIO_PMA_LASI_TX_LASERBICURRFLT 0x0200  /* Laser bias current fault */
 243
 244 /* LASI control/status registers. */
 245 #define MDIO_PMA_LASI_LSALARM           0x0001  /* LS_ALARM enable/status */
 246 #define MDIO_PMA_LASI_TXALARM           0x0002  /* TX_ALARM enable/status */
 247 #define MDIO_PMA_LASI_RXALARM           0x0004  /* RX_ALARM enable/status */
 248
 249 /* Mapping between MDIO PRTAD/DEVAD and mii_ioctl_data::phy_id */
 250
 251 #define MDIO_PHY_ID_C45                 0x8000
 252 #define MDIO_PHY_ID_PRTAD               0x03e0
 253 #define MDIO_PHY_ID_DEVAD               0x001f
 254 #define MDIO_PHY_ID_C45_MASK                                            \
 255         (MDIO_PHY_ID_C45 | MDIO_PHY_ID_PRTAD | MDIO_PHY_ID_DEVAD)
 256
 257 static inline __u16 mdio_phy_id_c45(int prtad, int devad)
 258 {
 259         return MDIO_PHY_ID_C45 | (prtad << 5) | devad;
 260 }
 261
 262 static inline bool mdio_phy_id_is_c45(int phy_id)
 263 {
 264         return (phy_id & MDIO_PHY_ID_C45) && !(phy_id & ~MDIO_PHY_ID_C45_MASK);
 265 }
 266
 267 static inline __u16 mdio_phy_id_prtad(int phy_id)
 268 {
 269         return (phy_id & MDIO_PHY_ID_PRTAD) >> 5;
 270 }
 271
 272 static inline __u16 mdio_phy_id_devad(int phy_id)
 273 {
 274         return phy_id & MDIO_PHY_ID_DEVAD;
 275 }
 276
 277 #define MDIO_SUPPORTS_C22               1
 278 #define MDIO_SUPPORTS_C45               2
 279
 280 #ifdef __KERNEL__
 281
 282 /**
 283  * struct mdio_if_info - Ethernet controller MDIO interface
 284  * @prtad: PRTAD of the PHY (%MDIO_PRTAD_NONE if not present/unknown)
 285  * @mmds: Mask of MMDs expected to be present in the PHY.  This must be
 286  *      non-zero unless @prtad = %MDIO_PRTAD_NONE.
 287  * @mode_support: MDIO modes supported.  If %MDIO_SUPPORTS_C22 is set then
 288  *      MII register access will be passed through with @devad =
 289  *      %MDIO_DEVAD_NONE.  If %MDIO_EMULATE_C22 is set then access to
 290  *      commonly used clause 22 registers will be translated into
 291  *      clause 45 registers.
 292  * @dev: Net device structure
 293  * @mdio_read: Register read function; returns value or negative error code
 294  * @mdio_write: Register write function; returns 0 or negative error code
 295  */
 296 struct mdio_if_info {
 297         int prtad;
 298         u32 __bitwise mmds;
 299         unsigned mode_support;
 300
 301         struct net_device *dev;
 302         int (*mdio_read)(struct net_device *dev, int prtad, int devad,
 303                          u16 addr);
 304         int (*mdio_write)(struct net_device *dev, int prtad, int devad,
 305                           u16 addr, u16 val);
 306 };
 307
 308 #define MDIO_PRTAD_NONE                 (-1)
 309 #define MDIO_DEVAD_NONE                 (-1)
 310 #define MDIO_EMULATE_C22                4
 311
 312 struct ethtool_cmd;
 313 struct ethtool_pauseparam;
 314 extern int mdio45_probe(struct mdio_if_info *mdio, int prtad);
 315 extern int mdio_set_flag(const struct mdio_if_info *mdio,
 316                          int prtad, int devad, u16 addr, int mask,
 317                          bool sense);
 318 extern int mdio45_links_ok(const struct mdio_if_info *mdio, u32 mmds);
 319 extern int mdio45_nway_restart(const struct mdio_if_info *mdio);
 320 extern void mdio45_ethtool_gset_npage(const struct mdio_if_info *mdio,
 321                                       struct ethtool_cmd *ecmd,
 322                                       u32 npage_adv, u32 npage_lpa);
 323 extern void
 324 mdio45_ethtool_spauseparam_an(const struct mdio_if_info *mdio,
 325                               const struct ethtool_pauseparam *ecmd);
 326
 327 /**
 328  * mdio45_ethtool_gset - get settings for ETHTOOL_GSET
 329  * @mdio: MDIO interface
 330  * @ecmd: Ethtool request structure
 331  *
 332  * Since the CSRs for auto-negotiation using next pages are not fully
 333  * standardised, this function does not attempt to decode them.  Use
 334  * mdio45_ethtool_gset_npage() to specify advertisement bits from next
 335  * pages.
 336  */
 337 static inline void mdio45_ethtool_gset(const struct mdio_if_info *mdio,
 338                                        struct ethtool_cmd *ecmd)
 339 {
 340         mdio45_ethtool_gset_npage(mdio, ecmd, 0, 0);
 341 }
 342
 343 extern int mdio_mii_ioctl(const struct mdio_if_info *mdio,
 344                           struct mii_ioctl_data *mii_data, int cmd);
 345
 346 #endif /* __KERNEL__ */
 347 #endif /* __LINUX_MDIO_H__ */