xref: /freebsd/sys/dev/mii/rgephy.c (revision eb320b0ee7503d0bf2b7c0ecdc59c2d82cf301d0)
1 /*-
2  * Copyright (c) 2003
3  *	Bill Paul <wpaul@windriver.com>.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *	This product includes software developed by Bill Paul.
16  * 4. Neither the name of the author nor the names of any co-contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
30  * THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #include <sys/cdefs.h>
34 __FBSDID("$FreeBSD$");
35 
36 /*
37  * Driver for the RealTek 8169S/8110S/8211B internal 10/100/1000 PHY.
38  */
39 
40 #include <sys/param.h>
41 #include <sys/systm.h>
42 #include <sys/kernel.h>
43 #include <sys/module.h>
44 #include <sys/socket.h>
45 #include <sys/bus.h>
46 
47 #include <net/if.h>
48 #include <net/if_arp.h>
49 #include <net/if_media.h>
50 
51 #include <dev/mii/mii.h>
52 #include <dev/mii/miivar.h>
53 #include "miidevs.h"
54 
55 #include <dev/mii/rgephyreg.h>
56 
57 #include "miibus_if.h"
58 
59 #include <machine/bus.h>
60 #include <pci/if_rlreg.h>
61 
62 static int rgephy_probe(device_t);
63 static int rgephy_attach(device_t);
64 
65 struct rgephy_softc {
66 	struct mii_softc mii_sc;
67 	int mii_model;
68 	int mii_revision;
69 };
70 
71 static device_method_t rgephy_methods[] = {
72 	/* device interface */
73 	DEVMETHOD(device_probe,		rgephy_probe),
74 	DEVMETHOD(device_attach,	rgephy_attach),
75 	DEVMETHOD(device_detach,	mii_phy_detach),
76 	DEVMETHOD(device_shutdown,	bus_generic_shutdown),
77 	{ 0, 0 }
78 };
79 
80 static devclass_t rgephy_devclass;
81 
82 static driver_t rgephy_driver = {
83 	"rgephy",
84 	rgephy_methods,
85 	sizeof(struct rgephy_softc)
86 };
87 
88 DRIVER_MODULE(rgephy, miibus, rgephy_driver, rgephy_devclass, 0, 0);
89 
90 static int	rgephy_service(struct mii_softc *, struct mii_data *, int);
91 static void	rgephy_status(struct mii_softc *);
92 static int	rgephy_mii_phy_auto(struct mii_softc *);
93 static void	rgephy_reset(struct mii_softc *);
94 static void	rgephy_loop(struct mii_softc *);
95 static void	rgephy_load_dspcode(struct mii_softc *);
96 
97 static const struct mii_phydesc rgephys[] = {
98 	MII_PHY_DESC(xxREALTEK, RTL8169S),
99 	MII_PHY_END
100 };
101 
102 static int
103 rgephy_probe(device_t dev)
104 {
105 
106 	return (mii_phy_dev_probe(dev, rgephys, BUS_PROBE_DEFAULT));
107 }
108 
109 static int
110 rgephy_attach(device_t dev)
111 {
112 	struct rgephy_softc *rsc;
113 	struct mii_softc *sc;
114 	struct mii_attach_args *ma;
115 	struct mii_data *mii;
116 	const char *sep = "";
117 
118 	rsc = device_get_softc(dev);
119 	sc = &rsc->mii_sc;
120 	ma = device_get_ivars(dev);
121 	sc->mii_dev = device_get_parent(dev);
122 	mii = device_get_softc(sc->mii_dev);
123 	LIST_INSERT_HEAD(&mii->mii_phys, sc, mii_list);
124 
125 	sc->mii_inst = mii->mii_instance;
126 	sc->mii_phy = ma->mii_phyno;
127 	sc->mii_service = rgephy_service;
128 	sc->mii_pdata = mii;
129 	sc->mii_anegticks = MII_ANEGTICKS_GIGE;
130 
131 	mii->mii_instance++;
132 
133 	rsc->mii_model = MII_MODEL(ma->mii_id2);
134 	rsc->mii_revision = MII_REV(ma->mii_id2);
135 
136 #define	ADD(m, c)	ifmedia_add(&mii->mii_media, (m), (c), NULL)
137 #define PRINT(s)	printf("%s%s", sep, s); sep = ", "
138 
139 #if 0
140 	ADD(IFM_MAKEWORD(IFM_ETHER, IFM_100_TX, IFM_LOOP, sc->mii_inst),
141 	    BMCR_LOOP|BMCR_S100);
142 #endif
143 
144 	sc->mii_capabilities = PHY_READ(sc, MII_BMSR) & ma->mii_capmask;
145 	sc->mii_capabilities &= ~BMSR_ANEG;
146 	if (sc->mii_capabilities & BMSR_EXTSTAT)
147 		sc->mii_extcapabilities = PHY_READ(sc, MII_EXTSR);
148 
149 	device_printf(dev, " ");
150 	mii_phy_add_media(sc);
151 	/* RTL8169S do not report auto-sense; add manually. */
152 	ADD(IFM_MAKEWORD(IFM_ETHER, IFM_AUTO, 0, sc->mii_inst), MII_NMEDIA);
153 	sep = ", ";
154 	PRINT("auto");
155 	printf("\n");
156 #undef ADD
157 #undef PRINT
158 
159 	rgephy_reset(sc);
160 	MIIBUS_MEDIAINIT(sc->mii_dev);
161 	return (0);
162 }
163 
164 static int
165 rgephy_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
166 {
167 	struct rgephy_softc *rsc;
168 	struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
169 	int reg, speed, gig, anar;
170 
171 	rsc = (struct rgephy_softc *)sc;
172 
173 	switch (cmd) {
174 	case MII_POLLSTAT:
175 		/*
176 		 * If we're not polling our PHY instance, just return.
177 		 */
178 		if (IFM_INST(ife->ifm_media) != sc->mii_inst)
179 			return (0);
180 		break;
181 
182 	case MII_MEDIACHG:
183 		/*
184 		 * If the media indicates a different PHY instance,
185 		 * isolate ourselves.
186 		 */
187 		if (IFM_INST(ife->ifm_media) != sc->mii_inst) {
188 			reg = PHY_READ(sc, MII_BMCR);
189 			PHY_WRITE(sc, MII_BMCR, reg | BMCR_ISO);
190 			return (0);
191 		}
192 
193 		/*
194 		 * If the interface is not up, don't do anything.
195 		 */
196 		if ((mii->mii_ifp->if_flags & IFF_UP) == 0)
197 			break;
198 
199 		rgephy_reset(sc);	/* XXX hardware bug work-around */
200 
201 		anar = PHY_READ(sc, RGEPHY_MII_ANAR);
202 		anar &= ~(RGEPHY_ANAR_TX_FD | RGEPHY_ANAR_TX |
203 		    RGEPHY_ANAR_10_FD | RGEPHY_ANAR_10);
204 
205 		switch (IFM_SUBTYPE(ife->ifm_media)) {
206 		case IFM_AUTO:
207 #ifdef foo
208 			/*
209 			 * If we're already in auto mode, just return.
210 			 */
211 			if (PHY_READ(sc, RGEPHY_MII_BMCR) & RGEPHY_BMCR_AUTOEN)
212 				return (0);
213 #endif
214 			(void) rgephy_mii_phy_auto(sc);
215 			break;
216 		case IFM_1000_T:
217 			speed = RGEPHY_S1000;
218 			goto setit;
219 		case IFM_100_TX:
220 			speed = RGEPHY_S100;
221 			anar |= RGEPHY_ANAR_TX_FD | RGEPHY_ANAR_TX;
222 			goto setit;
223 		case IFM_10_T:
224 			speed = RGEPHY_S10;
225 			anar |= RGEPHY_ANAR_10_FD | RGEPHY_ANAR_10;
226 setit:
227 			rgephy_loop(sc);
228 			if ((ife->ifm_media & IFM_GMASK) == IFM_FDX) {
229 				speed |= RGEPHY_BMCR_FDX;
230 				gig = RGEPHY_1000CTL_AFD;
231 				anar &= ~(RGEPHY_ANAR_TX | RGEPHY_ANAR_10);
232 			} else {
233 				gig = RGEPHY_1000CTL_AHD;
234 				anar &=
235 				    ~(RGEPHY_ANAR_TX_FD | RGEPHY_ANAR_10_FD);
236 			}
237 
238 			if (IFM_SUBTYPE(ife->ifm_media) != IFM_1000_T) {
239 				PHY_WRITE(sc, RGEPHY_MII_1000CTL, 0);
240 				PHY_WRITE(sc, RGEPHY_MII_ANAR, anar);
241 				PHY_WRITE(sc, RGEPHY_MII_BMCR, speed |
242 				    RGEPHY_BMCR_AUTOEN | RGEPHY_BMCR_STARTNEG);
243 				break;
244 			}
245 
246 			/*
247 			 * When setting the link manually, one side must
248 			 * be the master and the other the slave. However
249 			 * ifmedia doesn't give us a good way to specify
250 			 * this, so we fake it by using one of the LINK
251 			 * flags. If LINK0 is set, we program the PHY to
252 			 * be a master, otherwise it's a slave.
253 			 */
254 			if ((mii->mii_ifp->if_flags & IFF_LINK0)) {
255 				PHY_WRITE(sc, RGEPHY_MII_1000CTL,
256 				    gig|RGEPHY_1000CTL_MSE|RGEPHY_1000CTL_MSC);
257 			} else {
258 				PHY_WRITE(sc, RGEPHY_MII_1000CTL,
259 				    gig|RGEPHY_1000CTL_MSE);
260 			}
261 			PHY_WRITE(sc, RGEPHY_MII_BMCR, speed |
262 			    RGEPHY_BMCR_AUTOEN | RGEPHY_BMCR_STARTNEG);
263 			break;
264 		case IFM_NONE:
265 			PHY_WRITE(sc, MII_BMCR, BMCR_ISO|BMCR_PDOWN);
266 			break;
267 		case IFM_100_T4:
268 		default:
269 			return (EINVAL);
270 		}
271 		break;
272 
273 	case MII_TICK:
274 		/*
275 		 * If we're not currently selected, just return.
276 		 */
277 		if (IFM_INST(ife->ifm_media) != sc->mii_inst)
278 			return (0);
279 
280 		/*
281 		 * Is the interface even up?
282 		 */
283 		if ((mii->mii_ifp->if_flags & IFF_UP) == 0)
284 			return (0);
285 
286 		/*
287 		 * Only used for autonegotiation.
288 		 */
289 		if (IFM_SUBTYPE(ife->ifm_media) != IFM_AUTO) {
290 			sc->mii_ticks = 0;
291 			break;
292 		}
293 
294 		/*
295 		 * Check to see if we have link.  If we do, we don't
296 		 * need to restart the autonegotiation process.  Read
297 		 * the BMSR twice in case it's latched.
298 		 */
299 		if (rsc->mii_revision >= 2) {
300 			/* RTL8211B(L) */
301 			reg = PHY_READ(sc, RGEPHY_MII_SSR);
302 			if (reg & RGEPHY_SSR_LINK) {
303 				sc->mii_ticks = 0;
304 				break;
305 			}
306 		} else {
307 			reg = PHY_READ(sc, RL_GMEDIASTAT);
308 			if (reg & RL_GMEDIASTAT_LINK) {
309 				sc->mii_ticks = 0;
310 				break;
311 			}
312 		}
313 
314 		/* Announce link loss right after it happens. */
315 		if (sc->mii_ticks++ == 0)
316 			break;
317 
318 		/* Only retry autonegotiation every mii_anegticks seconds. */
319 		if (sc->mii_ticks <= sc->mii_anegticks)
320 			return (0);
321 
322 		sc->mii_ticks = 0;
323 		rgephy_mii_phy_auto(sc);
324 		break;
325 	}
326 
327 	/* Update the media status. */
328 	rgephy_status(sc);
329 
330 	/*
331 	 * Callback if something changed. Note that we need to poke
332 	 * the DSP on the RealTek PHYs if the media changes.
333 	 *
334 	 */
335 	if (sc->mii_media_active != mii->mii_media_active ||
336 	    sc->mii_media_status != mii->mii_media_status ||
337 	    cmd == MII_MEDIACHG) {
338 		rgephy_load_dspcode(sc);
339 	}
340 	mii_phy_update(sc, cmd);
341 	return (0);
342 }
343 
344 static void
345 rgephy_status(struct mii_softc *sc)
346 {
347 	struct rgephy_softc *rsc;
348 	struct mii_data *mii = sc->mii_pdata;
349 	int bmsr, bmcr;
350 	uint16_t ssr;
351 
352 	mii->mii_media_status = IFM_AVALID;
353 	mii->mii_media_active = IFM_ETHER;
354 
355 	rsc = (struct rgephy_softc *)sc;
356 	if (rsc->mii_revision >= 2) {
357 		ssr = PHY_READ(sc, RGEPHY_MII_SSR);
358 		if (ssr & RGEPHY_SSR_LINK)
359 			mii->mii_media_status |= IFM_ACTIVE;
360 	} else {
361 		bmsr = PHY_READ(sc, RL_GMEDIASTAT);
362 		if (bmsr & RL_GMEDIASTAT_LINK)
363 			mii->mii_media_status |= IFM_ACTIVE;
364 	}
365 
366 	PHY_READ(sc, RGEPHY_MII_BMSR);
367 	bmsr = PHY_READ(sc, RGEPHY_MII_BMSR);
368 
369 	bmcr = PHY_READ(sc, RGEPHY_MII_BMCR);
370 
371 	if (bmcr & RGEPHY_BMCR_LOOP)
372 		mii->mii_media_active |= IFM_LOOP;
373 
374 	if (bmcr & RGEPHY_BMCR_AUTOEN) {
375 		if ((bmsr & RGEPHY_BMSR_ACOMP) == 0) {
376 			/* Erg, still trying, I guess... */
377 			mii->mii_media_active |= IFM_NONE;
378 			return;
379 		}
380 	}
381 
382 	if (rsc->mii_revision >= 2) {
383 		ssr = PHY_READ(sc, RGEPHY_MII_SSR);
384 		switch (ssr & RGEPHY_SSR_SPD_MASK) {
385 		case RGEPHY_SSR_S1000:
386 			mii->mii_media_active |= IFM_1000_T;
387 			break;
388 		case RGEPHY_SSR_S100:
389 			mii->mii_media_active |= IFM_100_TX;
390 			break;
391 		case RGEPHY_SSR_S10:
392 			mii->mii_media_active |= IFM_10_T;
393 			break;
394 		default:
395 			mii->mii_media_active |= IFM_NONE;
396 			break;
397 		}
398 		if (ssr & RGEPHY_SSR_FDX)
399 			mii->mii_media_active |= IFM_FDX;
400 		else
401 			mii->mii_media_active |= IFM_HDX;
402 	} else {
403 		bmsr = PHY_READ(sc, RL_GMEDIASTAT);
404 		if (bmsr & RL_GMEDIASTAT_1000MBPS)
405 			mii->mii_media_active |= IFM_1000_T;
406 		else if (bmsr & RL_GMEDIASTAT_100MBPS)
407 			mii->mii_media_active |= IFM_100_TX;
408 		else if (bmsr & RL_GMEDIASTAT_10MBPS)
409 			mii->mii_media_active |= IFM_10_T;
410 		else
411 			mii->mii_media_active |= IFM_NONE;
412 		if (bmsr & RL_GMEDIASTAT_FDX)
413 			mii->mii_media_active |= IFM_FDX;
414 		else
415 			mii->mii_media_active |= IFM_HDX;
416 	}
417 }
418 
419 static int
420 rgephy_mii_phy_auto(struct mii_softc *mii)
421 {
422 
423 	rgephy_loop(mii);
424 	rgephy_reset(mii);
425 
426 	PHY_WRITE(mii, RGEPHY_MII_ANAR,
427 	    BMSR_MEDIA_TO_ANAR(mii->mii_capabilities) | ANAR_CSMA);
428 	DELAY(1000);
429 	PHY_WRITE(mii, RGEPHY_MII_1000CTL,
430             RGEPHY_1000CTL_AHD|RGEPHY_1000CTL_AFD);
431 	DELAY(1000);
432 	PHY_WRITE(mii, RGEPHY_MII_BMCR,
433 	    RGEPHY_BMCR_AUTOEN | RGEPHY_BMCR_STARTNEG);
434 	DELAY(100);
435 
436 	return (EJUSTRETURN);
437 }
438 
439 static void
440 rgephy_loop(struct mii_softc *sc)
441 {
442 	struct rgephy_softc *rsc;
443 	int i;
444 
445 	rsc = (struct rgephy_softc *)sc;
446 	if (rsc->mii_revision < 2) {
447 		PHY_WRITE(sc, RGEPHY_MII_BMCR, RGEPHY_BMCR_PDOWN);
448 		DELAY(1000);
449 	}
450 
451 	for (i = 0; i < 15000; i++) {
452 		if (!(PHY_READ(sc, RGEPHY_MII_BMSR) & RGEPHY_BMSR_LINK)) {
453 #if 0
454 			device_printf(sc->mii_dev, "looped %d\n", i);
455 #endif
456 			break;
457 		}
458 		DELAY(10);
459 	}
460 }
461 
462 #define PHY_SETBIT(x, y, z) \
463 	PHY_WRITE(x, y, (PHY_READ(x, y) | (z)))
464 #define PHY_CLRBIT(x, y, z) \
465 	PHY_WRITE(x, y, (PHY_READ(x, y) & ~(z)))
466 
467 /*
468  * Initialize RealTek PHY per the datasheet. The DSP in the PHYs of
469  * existing revisions of the 8169S/8110S chips need to be tuned in
470  * order to reliably negotiate a 1000Mbps link. This is only needed
471  * for rev 0 and rev 1 of the PHY. Later versions work without
472  * any fixups.
473  */
474 static void
475 rgephy_load_dspcode(struct mii_softc *sc)
476 {
477 	struct rgephy_softc *rsc;
478 	int val;
479 
480 	rsc = (struct rgephy_softc *)sc;
481 	if (rsc->mii_revision >= 2)
482 		return;
483 
484 	PHY_WRITE(sc, 31, 0x0001);
485 	PHY_WRITE(sc, 21, 0x1000);
486 	PHY_WRITE(sc, 24, 0x65C7);
487 	PHY_CLRBIT(sc, 4, 0x0800);
488 	val = PHY_READ(sc, 4) & 0xFFF;
489 	PHY_WRITE(sc, 4, val);
490 	PHY_WRITE(sc, 3, 0x00A1);
491 	PHY_WRITE(sc, 2, 0x0008);
492 	PHY_WRITE(sc, 1, 0x1020);
493 	PHY_WRITE(sc, 0, 0x1000);
494 	PHY_SETBIT(sc, 4, 0x0800);
495 	PHY_CLRBIT(sc, 4, 0x0800);
496 	val = (PHY_READ(sc, 4) & 0xFFF) | 0x7000;
497 	PHY_WRITE(sc, 4, val);
498 	PHY_WRITE(sc, 3, 0xFF41);
499 	PHY_WRITE(sc, 2, 0xDE60);
500 	PHY_WRITE(sc, 1, 0x0140);
501 	PHY_WRITE(sc, 0, 0x0077);
502 	val = (PHY_READ(sc, 4) & 0xFFF) | 0xA000;
503 	PHY_WRITE(sc, 4, val);
504 	PHY_WRITE(sc, 3, 0xDF01);
505 	PHY_WRITE(sc, 2, 0xDF20);
506 	PHY_WRITE(sc, 1, 0xFF95);
507 	PHY_WRITE(sc, 0, 0xFA00);
508 	val = (PHY_READ(sc, 4) & 0xFFF) | 0xB000;
509 	PHY_WRITE(sc, 4, val);
510 	PHY_WRITE(sc, 3, 0xFF41);
511 	PHY_WRITE(sc, 2, 0xDE20);
512 	PHY_WRITE(sc, 1, 0x0140);
513 	PHY_WRITE(sc, 0, 0x00BB);
514 	val = (PHY_READ(sc, 4) & 0xFFF) | 0xF000;
515 	PHY_WRITE(sc, 4, val);
516 	PHY_WRITE(sc, 3, 0xDF01);
517 	PHY_WRITE(sc, 2, 0xDF20);
518 	PHY_WRITE(sc, 1, 0xFF95);
519 	PHY_WRITE(sc, 0, 0xBF00);
520 	PHY_SETBIT(sc, 4, 0x0800);
521 	PHY_CLRBIT(sc, 4, 0x0800);
522 	PHY_WRITE(sc, 31, 0x0000);
523 
524 	DELAY(40);
525 }
526 
527 static void
528 rgephy_reset(struct mii_softc *sc)
529 {
530 
531 	mii_phy_reset(sc);
532 	DELAY(1000);
533 	rgephy_load_dspcode(sc);
534 }
535