xref: /netbsd/sys/dev/mii/mii.h (revision c2ee4709)
1 /*	$NetBSD: mii.h,v 1.27 2019/04/11 09:14:07 msaitoh 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 Remore 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 Remore 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