1 /*        $NetBSD: mii.h,v 1.28 2025/02/28 09:07:12 andvar Exp $      */
2 
3 /*
4  * Copyright (c) 1997 Manuel Bouyer.  All rights reserved.
5  *
6  * Modification to match BSD/OS 3.0 MII interface by Jason R. Thorpe,
7  * Numerical Aerospace Simulation Facility, NASA Ames Research Center.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 #ifndef _DEV_MII_MII_H_
31 #define   _DEV_MII_MII_H_
32 
33 /*
34  * Registers common to all PHYs.
35  */
36 
37 #define   MII_NPHY  32        /* max # of PHYs per MII */
38 #define   MII_ADDRBITS        5         /* Register address bits (0x00..0x1f) */
39 #define   MII_ADDRMASK        0x1f      /* Address mask */
40 
41 /*
42  * MII commands, used if a device must drive the MII lines
43  * manually.
44  */
45 #define   MII_COMMAND_START   0x01
46 #define   MII_COMMAND_READ    0x02
47 #define   MII_COMMAND_WRITE   0x01
48 #define   MII_COMMAND_ACK               0x02
49 
50 #define   MII_BMCR  0x00      /* Basic mode control register (rw) */
51 #define   BMCR_RESET          0x8000    /* reset */
52 #define   BMCR_LOOP 0x4000    /* loopback */
53 #define   BMCR_SPEED0         0x2000    /* speed selection (LSB) */
54 #define   BMCR_AUTOEN         0x1000    /* autonegotiation enable */
55 #define   BMCR_PDOWN          0x0800    /* power down */
56 #define   BMCR_ISO  0x0400    /* isolate */
57 #define   BMCR_STARTNEG       0x0200    /* restart autonegotiation */
58 #define   BMCR_FDX  0x0100    /* Set duplex mode */
59 #define   BMCR_CTEST          0x0080    /* collision test */
60 #define   BMCR_SPEED1         0x0040    /* speed selection (MSB) */
61 #define   BMCR_UNIDIR         0x0020    /* Unidirectional enable */
62 
63 #define   BMCR_S10  0x0000              /* 10 Mb/s */
64 #define   BMCR_S100 BMCR_SPEED0         /* 100 Mb/s */
65 #define   BMCR_S1000          BMCR_SPEED1         /* 1000 Mb/s */
66 
67 #define   BMCR_SPEED(x)       ((x) & (BMCR_SPEED0 | BMCR_SPEED1))
68 
69 #define   MII_BMSR  0x01      /* Basic mode status register (ro) */
70 #define   BMSR_100T4          0x8000    /* 100 base T4 capable */
71 #define   BMSR_100TXFDX       0x4000    /* 100 base Tx full duplex capable */
72 #define   BMSR_100TXHDX       0x2000    /* 100 base Tx half duplex capable */
73 #define   BMSR_10TFDX         0x1000    /* 10 base T full duplex capable */
74 #define   BMSR_10THDX         0x0800    /* 10 base T half duplex capable */
75 #define   BMSR_100T2FDX       0x0400    /* 100 base T2 full duplex capable */
76 #define   BMSR_100T2HDX       0x0200    /* 100 base T2 half duplex capable */
77 #define   BMSR_EXTSTAT        0x0100    /* Extended status in register 15 */
78 #define   BMSR_UNIDIR         0x0080    /* Unidirectional ability */
79 #define   BMSR_MFPS 0x0040    /* MII Frame Preamble Suppression */
80 #define   BMSR_ACOMP          0x0020    /* Autonegotiation complete */
81 #define   BMSR_RFAULT         0x0010    /* Link partner fault */
82 #define   BMSR_ANEG 0x0008    /* Autonegotiation capable */
83 #define   BMSR_LINK 0x0004    /* Link status */
84 #define   BMSR_JABBER         0x0002    /* Jabber detected */
85 #define   BMSR_EXTCAP         0x0001    /* Extended capability */
86 
87 /*
88  * Note that the EXTSTAT bit indicates that there is extended status
89  * info available in register 15, but 802.3 section 22.2.4.3 also
90  * states that all 1000 Mb/s capable PHYs will set this bit to 1.
91  */
92 
93 #define   BMSR_MEDIAMASK      (BMSR_100T4 | BMSR_100TXFDX | BMSR_100TXHDX | \
94               BMSR_10TFDX | BMSR_10THDX | BMSR_100T2FDX | BMSR_100T2HDX)
95 
96 /*
97  * Convert BMSR media capabilities to ANAR bits for autonegotiation.
98  * Note the shift chopps off the BMSR_ANEG bit.
99  */
100 #define   BMSR_MEDIA_TO_ANAR(x)         (((x) & BMSR_MEDIAMASK) >> 6)
101 
102 #define   MII_PHYIDR1         0x02      /* ID register 1 (ro) */
103 
104 #define   MII_PHYIDR2         0x03      /* ID register 2 (ro) */
105 #define   IDR2_OUILSB         0xfc00    /* OUI LSB */
106 #define   IDR2_MODEL          0x03f0    /* vendor model */
107 #define   IDR2_REV  0x000f    /* vendor revision */
108 
109 #define   MII_ANAR  0x04      /* Autonegotiation advertisement (rw) */
110                     /* section 28.2.4.1 and 37.2.6.1 */
111 #define ANAR_NP               0x8000    /* Next page (ro) */
112 #define   ANAR_ACK  0x4000    /* link partner abilities acknowledged (ro) */
113 #define ANAR_RF               0x2000    /* remote fault (ro) */
114 #define ANAR_XNP    0x1000    /* Extended Next Page */
115                     /* Annex 28B.2 */
116 #define   ANAR_FC             0x0400    /* local device supports PAUSE */
117 #define ANAR_T4               0x0200    /* local device supports 100bT4 */
118 #define ANAR_TX_FD  0x0100    /* local device supports 100bTx FD */
119 #define ANAR_TX               0x0080    /* local device supports 100bTx */
120 #define ANAR_10_FD  0x0040    /* local device supports 10bT FD */
121 #define ANAR_10               0x0020    /* local device supports 10bT */
122 #define   ANAR_CSMA 0x0001    /* protocol selector CSMA/CD */
123 #define   ANAR_PAUSE_NONE               (0 << 10)
124 #define   ANAR_PAUSE_SYM                (1 << 10)
125 #define   ANAR_PAUSE_ASYM               (2 << 10)
126 #define   ANAR_PAUSE_TOWARDS  (3 << 10)
127 
128                     /* Annex 28D */
129 #define   ANAR_X_FD 0x0020    /* local device supports 1000BASE-X FD */
130 #define   ANAR_X_HD 0x0040    /* local device supports 1000BASE-X HD */
131 #define   ANAR_X_PAUSE_NONE   (0 << 7)
132 #define   ANAR_X_PAUSE_SYM    (1 << 7)
133 #define   ANAR_X_PAUSE_ASYM   (2 << 7)
134 #define   ANAR_X_PAUSE_TOWARDS          (3 << 7)
135           /* 37.2.1.5 Remote Fault */
136 #define   ANAR_X_RF1          0x1000
137 #define   ANAR_X_RF2          0x2000
138 #define ANAR_X_RF_MASK                  (ANAR_X_RF1 | ANAR_X_RF2)
139 #define ANAR_X_RF_NONE                  (0 << 12)
140 #define ANAR_X_RF_OFFLINE     (1 << 12)
141 #define ANAR_X_RF_LINKFAIL    (2 << 12)
142 #define ANAR_X_RF_ANEGERR     (3 << 12)
143 
144 #define   MII_ANLPAR          0x05      /* ANEG Link Partner Base Page abilities (rw)*/
145                     /* section 28.2.4.1 and 37.2.6.1 */
146 #define ANLPAR_NP   0x8000    /* Next page (ro) */
147 #define   ANLPAR_ACK          0x4000    /* link partner accepted ACK (ro) */
148 #define ANLPAR_RF   0x2000    /* remote fault (ro) */
149 #define ANLPAR_XNP  0x1000    /* Extended Next Page */
150 #define   ANLPAR_FC 0x0400    /* link partner supports PAUSE */
151 #define ANLPAR_T4   0x0200    /* link partner supports 100bT4 */
152 #define ANLPAR_TX_FD          0x0100    /* link partner supports 100bTx FD */
153 #define ANLPAR_TX   0x0080    /* link partner supports 100bTx */
154 #define ANLPAR_10_FD          0x0040    /* link partner supports 10bT FD */
155 #define ANLPAR_10   0x0020    /* link partner supports 10bT */
156 #define   ANLPAR_CSMA         0x0001    /* protocol selector CSMA/CD */
157 #define   ANLPAR_PAUSE_MASK   (3 << 10)
158 #define   ANLPAR_PAUSE_NONE   (0 << 10)
159 #define   ANLPAR_PAUSE_SYM    (1 << 10)
160 #define   ANLPAR_PAUSE_ASYM   (2 << 10)
161 #define   ANLPAR_PAUSE_TOWARDS          (3 << 10)
162 
163 #define   ANLPAR_X_FD         0x0020    /* local device supports 1000BASE-X FD */
164 #define   ANLPAR_X_HD         0x0040    /* local device supports 1000BASE-X HD */
165 #define   ANLPAR_X_PAUSE_MASK (3 << 7)
166 #define   ANLPAR_X_PAUSE_NONE (0 << 7)
167 #define   ANLPAR_X_PAUSE_SYM  (1 << 7)
168 #define   ANLPAR_X_PAUSE_ASYM (2 << 7)
169 #define   ANLPAR_X_PAUSE_TOWARDS        (3 << 7)
170           /* 37.2.1.5 Remote Fault */
171 #define   ANLPAR_X_RF1        0x1000
172 #define   ANLPAR_X_RF2        0x2000
173 #define   ANLPAR_X_RF_MASK    (ANLPAR_X_RF1 | ANLPAR_X_RF2)
174 #define ANLPAR_X_RF_NONE      (0 << 12)
175 #define ANLPAR_X_RF_OFFLINE   (1 << 12)
176 #define ANLPAR_X_RF_LINKFAIL  (2 << 12)
177 #define ANLPAR_X_RF_ANEGERR   (3 << 12)
178 
179 #define   MII_ANER  0x06      /* Autonegotiation expansion (ro) */
180                     /* section 28.2.4.1 and 37.2.6.1 */
181 #define ANER_RNPLA  0x0040    /* Receive Next Page Location Able */
182 #define ANER_RNPSL  0x0020    /* Received Next Page Storage Location */
183 #define ANER_MLF    0x0010    /* multiple link detection fault */
184 #define ANER_LPNP   0x0008    /* link partner next page-able */
185 #define ANER_NP               0x0004    /* next page-able */
186 #define ANER_PAGE_RX          0x0002    /* Page received */
187 #define ANER_LPAN   0x0001    /* link partner autoneg-able */
188 
189 #define   MII_ANNPT 0x07      /* Autonegotiation next page transmit (rw) */
190                     /* section 28.2.4.1 and 37.2.6.1 */
191 #define ANNPT_NP    0x8000    /* Next Page */
192 #define ANNPT_MP    0x2000    /* Message Page */
193 #define ANNPT_ACK2  0x1000    /* Acknowledge 2 */
194 #define ANNPT_TOGGLE          0x0800    /* Toggle */
195 #define ANNPT_MSGUNF_MASK 0x07ff /* Message(Annex28C)/Unformatted Code Field */
196 
197 /* Next Page Message Code used in ANNPT and ANLPRNP */
198 #define ANNP_MSG_NULL                   1    /* Null Message */
199 #define ANNP_MSG_1UP_TAF      2    /* 1Up w/ Tech. Ability Field follows */
200 #define ANNP_MSG_2UP_TAF      3    /* 2Up w/ Tech. Ability Field follows */
201 #define ANNP_MSG_1UP_BCRF     4    /* 1Up w/ Bin. coded Remote Flt follows */
202 #define ANNP_MSG_OUIDTMSG     5    /* OUI tagged Message */
203 #define ANNP_MSG_PHYIDTC      6    /* PHY Identifier Tag Code */
204 #define ANNP_MSG_TMC_100T2    7    /* 100BASE-T2 Tech. Message Code */
205 #define ANNP_MSG_TMC_1000T    8    /* 1000BASE-T Tech. Message Code */
206 #define ANNP_MSG_TMC_10G1G    9    /* 10GBASE-T/1000BASE-T TMC: (XNP) */
207 #define ANNP_MSG_TMC_EEE      10   /* EEE Technology Message Code */
208 #define ANNP_MSG_OUIDTM_XNP   11   /* OUI tagged Message (XNP) */
209 
210 
211 #define   MII_ANLPRNP         0x08      /* Autonegotiation link partner rx next page */
212                     /* section 32.5.1 and 37.2.6.1 */
213 #define ANLPRNP_NP  0x8000    /* Next Page */
214 #define ANLPRNP_ACK 0x4000    /* Acknowledge */
215 #define ANLPRNP_MP  0x2000    /* Message Page */
216 #define ANLPRNP_ACK2          0x1000    /* Acknowledge 2 */
217 #define ANLPRNP_TOGGLE        0x0800    /* Toggle */
218 #define ANLPRNP_MSGUNF_MASK 0x07ff /* Message(Anx28C)/Unformatted Code Field */
219 
220 #define   MII_GTCR  0x09      /*
221                                          * Master-Slave control register for
222                                          * 100BASE-T2 and 1000BASE-T.
223                                          */
224 #define   MII_100T2CR         MII_GTCR /* alias */
225 #define   GTCR_TEST_MASK      0xe000    /* see 802.3ab ss. 40.6.1.1.2 */
226 #define   GTCR_MAN_MS         0x1000    /* enable manual master/slave control */
227 #define   GTCR_ADV_MS         0x0800    /* 1 = adv. master, 0 = adv. slave */
228 #define   GTCR_PORT_TYPE      0x0400    /* 1 = DCE, 0 = DTE (NIC) */
229 #define   GTCR_ADV_1000TFDX 0x0200 /* adv. 1000baseT FDX */
230 #define   GTCR_ADV_1000THDX 0x0100 /* adv. 1000baseT HDX */
231 
232 #define T2CR_TEST_NORMAL      (0 << 13) /* Normal Operation */
233 #define T2CR_TEST_RX                    (1 << 13) /* RX test */
234 #define T2CR_TEST_TX_WAVEFORM (1 << 14) /* Mode 1. TX waveform test */
235 #define T2CR_TEST_TX_JITTER   (2 << 14) /* Mode 2. TX jitter test */
236 #define T2CR_TEST_TX_IDLE     (3 << 14) /* Mode 3. TX idle test */
237 
238 #define GTCR_TEST_NORMAL      (0 << 13) /* Normal Operation */
239 #define GTCR_TEST_TX_WAVEFORM (1 << 13) /* Mode 1. TX waveform test */
240 #define GTCR_TEST_TX_JITTER_M (2 << 13) /* Mode 2. TX jitter test (Master) */
241 #define GTCR_TEST_TX_JITTER_S (3 << 13) /* Mode 3. TX jitter test (Slave) */
242 #define GTCR_TEST_TX_DISTORTION         (4 << 13) /* Mode 4. TX distortion test */
243 
244 #define   MII_GTSR  0x0a      /*
245                                          * Master-Slave status register for
246                                          * 100BASE-T2 and 1000BASE-T.
247                                          */
248 #define   MII_100T2SR         MII_GTSR /* alias */
249 #define   GTSR_MAN_MS_FLT     0x8000    /* master/slave config fault */
250 #define   GTSR_MS_RES         0x4000    /* result: 1 = master, 0 = slave */
251 #define   GTSR_LRS  0x2000    /* local rx status, 1 = ok */
252 #define   GTSR_RRS  0x1000    /* remote rx status, 1 = ok */
253 #define   GTSR_LP_1000TFDX 0x0800       /* link partner 1000baseT FDX capable */
254 #define   GTSR_LP_1000THDX 0x0400       /* link partner 1000baseT HDX capable */
255 #define   GTSR_IDLE_ERR       0x00ff    /* IDLE error count */
256 
257 #define   MII_PSECR 0x0b      /* PSE control register */
258 #define   PSECR_DLLC          0x0020    /* Data Link Layer Classification capability */
259 #define   PSECR_EPLC          0x0010    /* Enable Physical Layer Classification */
260 #define   PSECR_PACTLMASK     0x000c    /* pair control mask */
261 #define   PSECR_PINOUTB       0x0008    /* PSE pinout Alternative B */
262 #define   PSECR_PINOUTA       0x0004    /* PSE pinout Alternative A */
263 #define   PSECR_PSEENMASK     0x0003    /* PSE enable mask */
264 #define   PSECR_FOPOWTST      0x0002    /* Force Power Test Mode */
265 #define   PSECR_PSEEN         0x0001    /* PSE Enabled */
266 #define   PSECR_PSEDIS        0x0000    /* PSE Disabled */
267 
268 #define   MII_PSESR 0x0c      /* PSE status register */
269 #define   PSESR_PWRDENIED     0x1000    /* Power Denied */
270 #define   PSESR_VALSIG        0x0800    /* Valid PD signature detected */
271 #define   PSESR_INVALSIG      0x0400    /* Invalid PD signature detected */
272 #define   PSESR_SHORTCIRC     0x0200    /* Short circuit condition detected */
273 #define   PSESR_OVERLOAD      0x0100    /* Overload condition detected */
274 #define   PSESR_MPSABSENT     0x0080    /* MPS absent condition detected */
275 #define   PSESR_PDCLMASK      0x0070    /* PD Class mask */
276 #define   PSESR_STATMASK      0x000e    /* PSE Status mask */
277 #define   PSESR_PAIRCTABL     0x0001    /* PAIR Control Ability */
278 #define   PSESR_PDCL_INVALID  (5 << 4)  /* Invalid Class */
279 #define   PSESR_PDCL_4                  (4 << 4)  /* Class 4 */
280 #define   PSESR_PDCL_3                  (3 << 4)  /* Class 3 */
281 #define   PSESR_PDCL_2                  (2 << 4)  /* Class 2 */
282 #define   PSESR_PDCL_1                  (1 << 4)  /* Class 1 */
283 #define   PSESR_PDCL_0                  (0 << 4)  /* Class 0 */
284 #define   PSESR_STAT_ISFLT    (5 << 1)  /* Implement specific fault */
285 #define   PSESR_STAT_TSTERR   (4 << 1)  /* Test Error */
286 #define   PSESR_STAT_TSTMODE  (3 << 1)  /* Test Mode */
287 #define   PSESR_STAT_DELVPWR  (2 << 1)  /* Delivering power */
288 #define   PSESR_STAT_SEARCH   (1 << 1)  /* Searching */
289 #define   PSESR_STAT_DIS                (0 << 1)  /* Disabled */
290 
291 #define   MII_MMDACR          0x0d      /* MMD access control register */
292 #define   MMDACR_FUNCMASK     0xc000    /* function */
293 #define   MMDACR_DADDRMASK 0x001f       /* device address */
294 #define   MMDACR_FN_ADDRESS   (0 << 14) /* address */
295 #define   MMDACR_FN_DATA                (1 << 14) /* data, no post increment */
296 #define   MMDACR_FN_DATA_INC_RW         (2 << 14) /* data, post increment on r/w */
297 #define   MMDACR_FN_DATA_INC_W          (3 << 14) /* data, post increment on wr only */
298 
299 #define   MII_MMDAADR         0x0e      /* MMD access address data register */
300 
301 #define   MII_EXTSR 0x0f      /* Extended status register */
302 #define   EXTSR_1000XFDX      0x8000    /* 1000X full-duplex capable */
303 #define   EXTSR_1000XHDX      0x4000    /* 1000X half-duplex capable */
304 #define   EXTSR_1000TFDX      0x2000    /* 1000T full-duplex capable */
305 #define   EXTSR_1000THDX      0x1000    /* 1000T half-duplex capable */
306 
307 #define   EXTSR_MEDIAMASK     (EXTSR_1000XFDX | EXTSR_1000XHDX | \
308               EXTSR_1000TFDX | EXTSR_1000THDX)
309 
310 #endif /* _DEV_MII_MII_H_ */
311