2 * SPDX-License-Identifier: BSD-4-Clause
4 * Copyright (c) 1997, 1998, 1999
5 * Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
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.
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.
36 #include <sys/cdefs.h>
37 __FBSDID("$FreeBSD$");
40 * driver for Micro Linear 6692 PHYs
42 * The Micro Linear 6692 is a strange beast, and dealing with it using
43 * this code framework is tricky. The 6692 is actually a 100Mbps-only
44 * device, which means that a second PHY is required to support 10Mbps
45 * modes. However, even though the 6692 does not support 10Mbps modes,
46 * it can still advertise them when performing autonegotiation. If a
47 * 10Mbps mode is negotiated, we must program the registers of the
48 * companion PHY accordingly in addition to programming the registers
51 * This device also does not have vendor/device ID registers.
54 #include <sys/param.h>
55 #include <sys/systm.h>
56 #include <sys/kernel.h>
57 #include <sys/socket.h>
58 #include <sys/module.h>
60 #include <sys/malloc.h>
63 #include <net/if_media.h>
65 #include <dev/mii/mii.h>
66 #include <dev/mii/miivar.h>
68 #include "miibus_if.h"
70 #define ML_STATE_AUTO_SELF 1
71 #define ML_STATE_AUTO_OTHER 2
74 struct mii_softc ml_mii;
80 static int mlphy_probe(device_t);
81 static int mlphy_attach(device_t);
83 static device_method_t mlphy_methods[] = {
84 /* device interface */
85 DEVMETHOD(device_probe, mlphy_probe),
86 DEVMETHOD(device_attach, mlphy_attach),
87 DEVMETHOD(device_detach, mii_phy_detach),
88 DEVMETHOD(device_shutdown, bus_generic_shutdown),
92 static devclass_t mlphy_devclass;
94 static driver_t mlphy_driver = {
97 sizeof(struct mlphy_softc)
100 DRIVER_MODULE(mlphy, miibus, mlphy_driver, mlphy_devclass, 0, 0);
102 static struct mii_softc *mlphy_find_other(struct mlphy_softc *);
103 static int mlphy_service(struct mii_softc *, struct mii_data *, int);
104 static void mlphy_reset(struct mii_softc *);
105 static void mlphy_status(struct mii_softc *);
107 static const struct mii_phy_funcs mlphy_funcs = {
117 struct mii_attach_args *ma;
119 ma = device_get_ivars(dev);
122 * Micro Linear PHY reports oui == 0 model == 0
124 if (MII_OUI(ma->mii_id1, ma->mii_id2) != 0 ||
125 MII_MODEL(ma->mii_id2) != 0)
129 * Make sure the parent is a `tl'. So far, I have only
130 * encountered the 6692 on an Olicom card with a ThunderLAN
133 if (!mii_dev_mac_match(dev, "tl"))
136 device_set_desc(dev, "Micro Linear 6692 media interface");
138 return (BUS_PROBE_DEFAULT);
145 struct mlphy_softc *msc;
146 struct mii_softc *sc;
148 msc = device_get_softc(dev);
151 mii_phy_dev_attach(dev, MIIF_NOMANPAUSE, &mlphy_funcs, 0);
155 sc->mii_capabilities = PHY_READ(sc, MII_BMSR) & sc->mii_capmask;
156 /* Let the companion PHY (if any) only handle the media we don't. */
157 sc->mii_capmask = ~sc->mii_capabilities;
158 device_printf(dev, " ");
159 mii_phy_add_media(sc);
162 MIIBUS_MEDIAINIT(sc->mii_dev);
166 static struct mii_softc *
167 mlphy_find_other(struct mlphy_softc *msc)
170 struct mii_softc *retval;
174 if (device_get_children(msc->ml_mii.mii_dev, &devlist, &devs) != 0)
176 for (i = 0; i < devs; i++) {
177 if (devlist[i] != msc->ml_dev) {
178 retval = device_get_softc(devlist[i]);
182 free(devlist, M_TEMP);
187 mlphy_service(xsc, mii, cmd)
188 struct mii_softc *xsc;
189 struct mii_data *mii;
192 struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
193 struct mii_softc *other = NULL;
194 struct mlphy_softc *msc = (struct mlphy_softc *)xsc;
195 struct mii_softc *sc = (struct mii_softc *)&msc->ml_mii;
199 * See if there's another PHY on this bus with us.
200 * If so, we may need it for 10Mbps modes.
202 other = mlphy_find_other(msc);
209 switch (IFM_SUBTYPE(ife->ifm_media)) {
212 * For autonegotiation, reset and isolate the
213 * companion PHY (if any) and then do NWAY
214 * autonegotiation ourselves.
216 msc->ml_state = ML_STATE_AUTO_SELF;
219 PHY_WRITE(other, MII_BMCR, BMCR_ISO);
221 (void)mii_phy_auto(sc);
227 * For 10baseT and 100baseTX modes, reset and isolate
228 * the companion PHY (if any), then program ourselves
233 PHY_WRITE(other, MII_BMCR, BMCR_ISO);
235 mii_phy_setmedia(sc);
245 * Only used for autonegotiation.
247 if (IFM_SUBTYPE(ife->ifm_media) != IFM_AUTO)
251 * Check to see if we have link. If we do, we don't
252 * need to restart the autonegotiation process. Read
253 * the BMSR twice in case it's latched.
254 * If we're in a 10Mbps mode, check the link of the
255 * 10Mbps PHY. Sometimes the Micro Linear PHY's
256 * linkstat bit will clear while the linkstat bit of
257 * the companion PHY will remain set.
259 if (msc->ml_state == ML_STATE_AUTO_OTHER) {
260 reg = PHY_READ(other, MII_BMSR) |
261 PHY_READ(other, MII_BMSR);
263 reg = PHY_READ(sc, MII_BMSR) |
264 PHY_READ(sc, MII_BMSR);
267 if (reg & BMSR_LINK) {
268 if (!msc->ml_linked) {
276 * Only retry autonegotiation every 5 seconds.
278 if (++sc->mii_ticks <= MII_ANEGTICKS)
283 mii->mii_media_active = IFM_NONE;
285 msc->ml_state = ML_STATE_AUTO_SELF;
288 PHY_WRITE(other, MII_BMCR, BMCR_ISO);
294 /* Update the media status. */
296 if (msc->ml_state == ML_STATE_AUTO_OTHER) {
297 other_inst = other->mii_inst;
298 other->mii_inst = sc->mii_inst;
299 if (IFM_INST(ife->ifm_media) == other->mii_inst)
300 (void)PHY_SERVICE(other, mii, MII_POLLSTAT);
301 other->mii_inst = other_inst;
302 sc->mii_media_active = other->mii_media_active;
303 sc->mii_media_status = other->mii_media_status;
307 /* Callback if something changed. */
308 mii_phy_update(sc, cmd);
313 * The Micro Linear PHY comes out of reset with the 'autoneg
314 * enable' bit set, which we don't want.
318 struct mii_softc *sc;
323 reg = PHY_READ(sc, MII_BMCR);
325 PHY_WRITE(sc, MII_BMCR, reg);
329 * If we negotiate a 10Mbps mode, we need to check for an alternate
330 * PHY and make sure it's enabled and set correctly.
334 struct mii_softc *sc;
336 struct mlphy_softc *msc = (struct mlphy_softc *)sc;
337 struct mii_data *mii = msc->ml_mii.mii_pdata;
338 struct mii_softc *other = NULL;
340 /* See if there's another PHY on the bus with us. */
341 other = mlphy_find_other(msc);
347 if (IFM_SUBTYPE(mii->mii_media_active) != IFM_10_T) {
348 msc->ml_state = ML_STATE_AUTO_SELF;
350 PHY_WRITE(other, MII_BMCR, BMCR_ISO);
353 if (IFM_SUBTYPE(mii->mii_media_active) == IFM_10_T) {
354 msc->ml_state = ML_STATE_AUTO_OTHER;
355 PHY_RESET(&msc->ml_mii);
356 PHY_WRITE(&msc->ml_mii, MII_BMCR, BMCR_ISO);