xref: /freebsd/sys/dev/mii/rlphy.c (revision 4d846d26)
1 /*-
2  * SPDX-License-Identifier: BSD-4-Clause
3  *
4  * Copyright (c) 1997, 1998, 1999
5  *	Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by Bill Paul.
18  * 4. Neither the name of the author nor the names of any co-contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
26  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32  * THE POSSIBILITY OF SUCH DAMAGE.
33  */
34 
35 #include <sys/cdefs.h>
36 __FBSDID("$FreeBSD$");
37 
38 /*
39  * driver for RealTek 8139 internal PHYs
40  */
41 
42 #include <sys/param.h>
43 #include <sys/systm.h>
44 #include <sys/kernel.h>
45 #include <sys/module.h>
46 #include <sys/socket.h>
47 #include <sys/bus.h>
48 #include <sys/taskqueue.h>	/* XXXGL: if_rlreg.h contamination */
49 
50 #include <net/if.h>
51 #include <net/if_arp.h>
52 #include <net/if_media.h>
53 
54 #include <dev/mii/mii.h>
55 #include <dev/mii/miivar.h>
56 #include "miidevs.h"
57 
58 #include <machine/bus.h>
59 #include <dev/rl/if_rlreg.h>
60 
61 #include "miibus_if.h"
62 
63 static int rlphy_probe(device_t);
64 static int rlphy_attach(device_t);
65 
66 static device_method_t rlphy_methods[] = {
67 	/* device interface */
68 	DEVMETHOD(device_probe,		rlphy_probe),
69 	DEVMETHOD(device_attach,	rlphy_attach),
70 	DEVMETHOD(device_detach,	mii_phy_detach),
71 	DEVMETHOD(device_shutdown,	bus_generic_shutdown),
72 	DEVMETHOD_END
73 };
74 
75 static driver_t rlphy_driver = {
76 	"rlphy",
77 	rlphy_methods,
78 	sizeof(struct mii_softc)
79 };
80 
81 DRIVER_MODULE(rlphy, miibus, rlphy_driver, 0, 0);
82 
83 static int	rlphy_service(struct mii_softc *, struct mii_data *, int);
84 static void	rlphy_status(struct mii_softc *);
85 
86 /*
87  * RealTek internal PHYs don't have vendor/device ID registers;
88  * re(4) and rl(4) fake up a return value of all zeros.
89  */
90 static const struct mii_phydesc rlintphys[] = {
91 	{ 0, 0, "RealTek internal media interface" },
92 	MII_PHY_END
93 };
94 
95 static const struct mii_phydesc rlphys[] = {
96 	MII_PHY_DESC(yyREALTEK, RTL8201L),
97 	MII_PHY_DESC(REALTEK, RTL8201E),
98 	MII_PHY_DESC(xxICPLUS, IP101),
99 	MII_PHY_END
100 };
101 
102 static const struct mii_phy_funcs rlphy_funcs = {
103 	rlphy_service,
104 	rlphy_status,
105 	mii_phy_reset
106 };
107 
108 static int
109 rlphy_probe(device_t dev)
110 {
111 	int rv;
112 
113 	rv = mii_phy_dev_probe(dev, rlphys, BUS_PROBE_DEFAULT);
114 	if (rv <= 0)
115 		return (rv);
116 
117 	if (mii_dev_mac_match(dev, "rl") || mii_dev_mac_match(dev, "re"))
118 		return (mii_phy_dev_probe(dev, rlintphys, BUS_PROBE_DEFAULT));
119 	return (ENXIO);
120 }
121 
122 static int
123 rlphy_attach(device_t dev)
124 {
125 
126 	/*
127 	 * The RealTek PHY can never be isolated.
128 	 */
129 	mii_phy_dev_attach(dev, MIIF_NOISOLATE | MIIF_NOMANPAUSE,
130 	    &rlphy_funcs, 1);
131 	return (0);
132 }
133 
134 static int
135 rlphy_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
136 {
137 
138 	switch (cmd) {
139 	case MII_POLLSTAT:
140 		break;
141 
142 	case MII_MEDIACHG:
143 		mii_phy_setmedia(sc);
144 		break;
145 
146 	case MII_TICK:
147 		/*
148 		 * The RealTek PHY's autonegotiation doesn't need to be
149 		 * kicked; it continues in the background.
150 		 */
151 		break;
152 	}
153 
154 	/* Update the media status. */
155 	PHY_STATUS(sc);
156 
157 	/* Callback if something changed. */
158 	mii_phy_update(sc, cmd);
159 	return (0);
160 }
161 
162 static void
163 rlphy_status(struct mii_softc *phy)
164 {
165 	struct mii_data *mii = phy->mii_pdata;
166 	struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
167 	int bmsr, bmcr, anlpar;
168 
169 	mii->mii_media_status = IFM_AVALID;
170 	mii->mii_media_active = IFM_ETHER;
171 
172 	bmsr = PHY_READ(phy, MII_BMSR) | PHY_READ(phy, MII_BMSR);
173 	if (bmsr & BMSR_LINK)
174 		mii->mii_media_status |= IFM_ACTIVE;
175 
176 	bmcr = PHY_READ(phy, MII_BMCR);
177 	if (bmcr & BMCR_ISO) {
178 		mii->mii_media_active |= IFM_NONE;
179 		mii->mii_media_status = 0;
180 		return;
181 	}
182 
183 	if (bmcr & BMCR_LOOP)
184 		mii->mii_media_active |= IFM_LOOP;
185 
186 	if (bmcr & BMCR_AUTOEN) {
187 		/*
188 		 * NWay autonegotiation takes the highest-order common
189 		 * bit of the ANAR and ANLPAR (i.e. best media advertised
190 		 * both by us and our link partner).
191 		 */
192 		if ((bmsr & BMSR_ACOMP) == 0) {
193 			/* Erg, still trying, I guess... */
194 			mii->mii_media_active |= IFM_NONE;
195 			return;
196 		}
197 
198 		if ((anlpar = PHY_READ(phy, MII_ANAR) &
199 		    PHY_READ(phy, MII_ANLPAR))) {
200 			if (anlpar & ANLPAR_TX_FD)
201 				mii->mii_media_active |= IFM_100_TX|IFM_FDX;
202 			else if (anlpar & ANLPAR_T4)
203 				mii->mii_media_active |= IFM_100_T4|IFM_HDX;
204 			else if (anlpar & ANLPAR_TX)
205 				mii->mii_media_active |= IFM_100_TX|IFM_HDX;
206 			else if (anlpar & ANLPAR_10_FD)
207 				mii->mii_media_active |= IFM_10_T|IFM_FDX;
208 			else if (anlpar & ANLPAR_10)
209 				mii->mii_media_active |= IFM_10_T|IFM_HDX;
210 			else
211 				mii->mii_media_active |= IFM_NONE;
212 			if ((mii->mii_media_active & IFM_FDX) != 0)
213 				mii->mii_media_active |=
214 				    mii_phy_flowstatus(phy);
215 			return;
216 		}
217 		/*
218 		 * If the other side doesn't support NWAY, then the
219 		 * best we can do is determine if we have a 10Mbps or
220 		 * 100Mbps link. There's no way to know if the link
221 		 * is full or half duplex, so we default to half duplex
222 		 * and hope that the user is clever enough to manually
223 		 * change the media settings if we're wrong.
224 		 */
225 
226 		/*
227 		 * The RealTek PHY supports non-NWAY link speed
228 		 * detection, however it does not report the link
229 		 * detection results via the ANLPAR or BMSR registers.
230 		 * (What? RealTek doesn't do things the way everyone
231 		 * else does? I'm just shocked, shocked I tell you.)
232 		 * To determine the link speed, we have to do one
233 		 * of two things:
234 		 *
235 		 * - If this is a standalone RealTek RTL8201(L) or
236 		 *   workalike PHY, we can determine the link speed by
237 		 *   testing bit 0 in the magic, vendor-specific register
238 		 *   at offset 0x19.
239 		 *
240 		 * - If this is a RealTek MAC with integrated PHY, we
241 		 *   can test the 'SPEED10' bit of the MAC's media status
242 		 *   register.
243 		 */
244 		if (!(phy->mii_mpd_model == 0 && phy->mii_mpd_rev == 0)) {
245 			if (PHY_READ(phy, 0x0019) & 0x01)
246 				mii->mii_media_active |= IFM_100_TX;
247 			else
248 				mii->mii_media_active |= IFM_10_T;
249 		} else {
250 			if (PHY_READ(phy, RL_MEDIASTAT) &
251 			    RL_MEDIASTAT_SPEED10)
252 				mii->mii_media_active |= IFM_10_T;
253 			else
254 				mii->mii_media_active |= IFM_100_TX;
255 		}
256 		mii->mii_media_active |= IFM_HDX;
257 	} else
258 		mii->mii_media_active = ife->ifm_media;
259 }
260