3 mii.c: MII interface library
5 Maintained by Jeff Garzik <jgarzik@pobox.com>
6 Copyright 2001,2002 Jeff Garzik
8 Various code came from myson803.c and other files by
9 Donald Becker. Copyright:
11 Written 1998-2002 by Donald Becker.
13 This software may be used and distributed according
14 to the terms of the GNU General Public License (GPL),
15 incorporated herein by reference. Drivers based on
16 or derived from this code fall under the GPL and must
17 retain the authorship, copyright and license notice.
18 This file is not a complete program and may only be
19 used when the entire operating system is licensed
22 The author may be reached as becker@scyld.com, or C/O
23 Scyld Computing Corporation
24 410 Severn Ave., Suite 210
30 #include <linux/kernel.h>
31 #include <linux/module.h>
32 #include <linux/netdevice.h>
33 #include <linux/ethtool.h>
34 #include <linux/mii.h>
37 * mii_ethtool_gset - get settings that are specified in @ecmd
39 * @ecmd: requested ethtool_cmd
41 * Returns 0 for success, negative on error.
43 int mii_ethtool_gset(struct mii_if_info *mii, struct ethtool_cmd *ecmd)
45 struct net_device *dev = mii->dev;
46 u32 advert, bmcr, lpa, nego;
47 u32 advert2 = 0, bmcr2 = 0, lpa2 = 0;
50 (SUPPORTED_10baseT_Half | SUPPORTED_10baseT_Full |
51 SUPPORTED_100baseT_Half | SUPPORTED_100baseT_Full |
52 SUPPORTED_Autoneg | SUPPORTED_TP | SUPPORTED_MII);
53 if (mii->supports_gmii)
54 ecmd->supported |= SUPPORTED_1000baseT_Half |
55 SUPPORTED_1000baseT_Full;
57 /* only supports twisted-pair */
58 ecmd->port = PORT_MII;
60 /* only supports internal transceiver */
61 ecmd->transceiver = XCVR_INTERNAL;
63 /* this isn't fully supported at higher layers */
64 ecmd->phy_address = mii->phy_id;
66 ecmd->advertising = ADVERTISED_TP | ADVERTISED_MII;
67 advert = mii->mdio_read(dev, mii->phy_id, MII_ADVERTISE);
68 if (mii->supports_gmii)
69 advert2 = mii->mdio_read(dev, mii->phy_id, MII_CTRL1000);
71 if (advert & ADVERTISE_10HALF)
72 ecmd->advertising |= ADVERTISED_10baseT_Half;
73 if (advert & ADVERTISE_10FULL)
74 ecmd->advertising |= ADVERTISED_10baseT_Full;
75 if (advert & ADVERTISE_100HALF)
76 ecmd->advertising |= ADVERTISED_100baseT_Half;
77 if (advert & ADVERTISE_100FULL)
78 ecmd->advertising |= ADVERTISED_100baseT_Full;
79 if (advert2 & ADVERTISE_1000HALF)
80 ecmd->advertising |= ADVERTISED_1000baseT_Half;
81 if (advert2 & ADVERTISE_1000FULL)
82 ecmd->advertising |= ADVERTISED_1000baseT_Full;
84 bmcr = mii->mdio_read(dev, mii->phy_id, MII_BMCR);
85 lpa = mii->mdio_read(dev, mii->phy_id, MII_LPA);
86 if (mii->supports_gmii) {
87 bmcr2 = mii->mdio_read(dev, mii->phy_id, MII_CTRL1000);
88 lpa2 = mii->mdio_read(dev, mii->phy_id, MII_STAT1000);
90 if (bmcr & BMCR_ANENABLE) {
91 ecmd->advertising |= ADVERTISED_Autoneg;
92 ecmd->autoneg = AUTONEG_ENABLE;
94 nego = mii_nway_result(advert & lpa);
95 if ((bmcr2 & (ADVERTISE_1000HALF | ADVERTISE_1000FULL)) &
97 ecmd->speed = SPEED_1000;
98 else if (nego == LPA_100FULL || nego == LPA_100HALF)
99 ecmd->speed = SPEED_100;
101 ecmd->speed = SPEED_10;
102 if ((lpa2 & LPA_1000FULL) || nego == LPA_100FULL ||
103 nego == LPA_10FULL) {
104 ecmd->duplex = DUPLEX_FULL;
105 mii->full_duplex = 1;
107 ecmd->duplex = DUPLEX_HALF;
108 mii->full_duplex = 0;
111 ecmd->autoneg = AUTONEG_DISABLE;
113 ecmd->speed = ((bmcr & BMCR_SPEED1000 &&
114 (bmcr & BMCR_SPEED100) == 0) ? SPEED_1000 :
115 (bmcr & BMCR_SPEED100) ? SPEED_100 : SPEED_10);
116 ecmd->duplex = (bmcr & BMCR_FULLDPLX) ? DUPLEX_FULL : DUPLEX_HALF;
119 /* ignore maxtxpkt, maxrxpkt for now */
125 * mii_ethtool_sset - set settings that are specified in @ecmd
126 * @mii: MII interface
127 * @ecmd: requested ethtool_cmd
129 * Returns 0 for success, negative on error.
131 int mii_ethtool_sset(struct mii_if_info *mii, struct ethtool_cmd *ecmd)
133 struct net_device *dev = mii->dev;
135 if (ecmd->speed != SPEED_10 &&
136 ecmd->speed != SPEED_100 &&
137 ecmd->speed != SPEED_1000)
139 if (ecmd->duplex != DUPLEX_HALF && ecmd->duplex != DUPLEX_FULL)
141 if (ecmd->port != PORT_MII)
143 if (ecmd->transceiver != XCVR_INTERNAL)
145 if (ecmd->phy_address != mii->phy_id)
147 if (ecmd->autoneg != AUTONEG_DISABLE && ecmd->autoneg != AUTONEG_ENABLE)
149 if ((ecmd->speed == SPEED_1000) && (!mii->supports_gmii))
152 /* ignore supported, maxtxpkt, maxrxpkt */
154 if (ecmd->autoneg == AUTONEG_ENABLE) {
155 u32 bmcr, advert, tmp;
156 u32 advert2 = 0, tmp2 = 0;
158 if ((ecmd->advertising & (ADVERTISED_10baseT_Half |
159 ADVERTISED_10baseT_Full |
160 ADVERTISED_100baseT_Half |
161 ADVERTISED_100baseT_Full |
162 ADVERTISED_1000baseT_Half |
163 ADVERTISED_1000baseT_Full)) == 0)
166 /* advertise only what has been requested */
167 advert = mii->mdio_read(dev, mii->phy_id, MII_ADVERTISE);
168 tmp = advert & ~(ADVERTISE_ALL | ADVERTISE_100BASE4);
169 if (mii->supports_gmii) {
170 advert2 = mii->mdio_read(dev, mii->phy_id, MII_CTRL1000);
171 tmp2 = advert2 & ~(ADVERTISE_1000HALF | ADVERTISE_1000FULL);
173 if (ecmd->advertising & ADVERTISED_10baseT_Half)
174 tmp |= ADVERTISE_10HALF;
175 if (ecmd->advertising & ADVERTISED_10baseT_Full)
176 tmp |= ADVERTISE_10FULL;
177 if (ecmd->advertising & ADVERTISED_100baseT_Half)
178 tmp |= ADVERTISE_100HALF;
179 if (ecmd->advertising & ADVERTISED_100baseT_Full)
180 tmp |= ADVERTISE_100FULL;
181 if (mii->supports_gmii) {
182 if (ecmd->advertising & ADVERTISED_1000baseT_Half)
183 tmp2 |= ADVERTISE_1000HALF;
184 if (ecmd->advertising & ADVERTISED_1000baseT_Full)
185 tmp2 |= ADVERTISE_1000FULL;
188 mii->mdio_write(dev, mii->phy_id, MII_ADVERTISE, tmp);
189 mii->advertising = tmp;
191 if ((mii->supports_gmii) && (advert2 != tmp2))
192 mii->mdio_write(dev, mii->phy_id, MII_CTRL1000, tmp2);
194 /* turn on autonegotiation, and force a renegotiate */
195 bmcr = mii->mdio_read(dev, mii->phy_id, MII_BMCR);
196 bmcr |= (BMCR_ANENABLE | BMCR_ANRESTART);
197 mii->mdio_write(dev, mii->phy_id, MII_BMCR, bmcr);
199 mii->force_media = 0;
203 /* turn off auto negotiation, set speed and duplexity */
204 bmcr = mii->mdio_read(dev, mii->phy_id, MII_BMCR);
205 tmp = bmcr & ~(BMCR_ANENABLE | BMCR_SPEED100 |
206 BMCR_SPEED1000 | BMCR_FULLDPLX);
207 if (ecmd->speed == SPEED_1000)
208 tmp |= BMCR_SPEED1000;
209 else if (ecmd->speed == SPEED_100)
210 tmp |= BMCR_SPEED100;
211 if (ecmd->duplex == DUPLEX_FULL) {
212 tmp |= BMCR_FULLDPLX;
213 mii->full_duplex = 1;
215 mii->full_duplex = 0;
217 mii->mdio_write(dev, mii->phy_id, MII_BMCR, tmp);
219 mii->force_media = 1;
225 * mii_check_gmii_support - check if the MII supports Gb interfaces
226 * @mii: the MII interface
228 int mii_check_gmii_support(struct mii_if_info *mii)
232 reg = mii->mdio_read(mii->dev, mii->phy_id, MII_BMSR);
233 if (reg & BMSR_ESTATEN) {
234 reg = mii->mdio_read(mii->dev, mii->phy_id, MII_ESTATUS);
235 if (reg & (ESTATUS_1000_TFULL | ESTATUS_1000_THALF))
243 * mii_link_ok - is link status up/ok
244 * @mii: the MII interface
246 * Returns 1 if the MII reports link status up/ok, 0 otherwise.
248 int mii_link_ok (struct mii_if_info *mii)
250 /* first, a dummy read, needed to latch some MII phys */
251 mii->mdio_read(mii->dev, mii->phy_id, MII_BMSR);
252 if (mii->mdio_read(mii->dev, mii->phy_id, MII_BMSR) & BMSR_LSTATUS)
258 * mii_nway_restart - restart NWay (autonegotiation) for this interface
259 * @mii: the MII interface
261 * Returns 0 on success, negative on error.
263 int mii_nway_restart (struct mii_if_info *mii)
268 /* if autoneg is off, it's an error */
269 bmcr = mii->mdio_read(mii->dev, mii->phy_id, MII_BMCR);
271 if (bmcr & BMCR_ANENABLE) {
272 bmcr |= BMCR_ANRESTART;
273 mii->mdio_write(mii->dev, mii->phy_id, MII_BMCR, bmcr);
281 * mii_check_link - check MII link status
282 * @mii: MII interface
284 * If the link status changed (previous != current), call
285 * netif_carrier_on() if current link status is Up or call
286 * netif_carrier_off() if current link status is Down.
288 void mii_check_link (struct mii_if_info *mii)
290 int cur_link = mii_link_ok(mii);
291 int prev_link = netif_carrier_ok(mii->dev);
293 if (cur_link && !prev_link)
294 netif_carrier_on(mii->dev);
295 else if (prev_link && !cur_link)
296 netif_carrier_off(mii->dev);
300 * mii_check_media - check the MII interface for a duplex change
301 * @mii: the MII interface
302 * @ok_to_print: OK to print link up/down messages
303 * @init_media: OK to save duplex mode in @mii
305 * Returns 1 if the duplex mode changed, 0 if not.
306 * If the media type is forced, always returns 0.
308 unsigned int mii_check_media (struct mii_if_info *mii,
309 unsigned int ok_to_print,
310 unsigned int init_media)
312 unsigned int old_carrier, new_carrier;
313 int advertise, lpa, media, duplex;
316 /* if forced media, go no further */
317 if (mii->force_media)
318 return 0; /* duplex did not change */
320 /* check current and old link status */
321 old_carrier = netif_carrier_ok(mii->dev) ? 1 : 0;
322 new_carrier = (unsigned int) mii_link_ok(mii);
324 /* if carrier state did not change, this is a "bounce",
325 * just exit as everything is already set correctly
327 if ((!init_media) && (old_carrier == new_carrier))
328 return 0; /* duplex did not change */
330 /* no carrier, nothing much to do */
332 netif_carrier_off(mii->dev);
334 printk(KERN_INFO "%s: link down\n", mii->dev->name);
335 return 0; /* duplex did not change */
339 * we have carrier, see who's on the other end
341 netif_carrier_on(mii->dev);
343 /* get MII advertise and LPA values */
344 if ((!init_media) && (mii->advertising))
345 advertise = mii->advertising;
347 advertise = mii->mdio_read(mii->dev, mii->phy_id, MII_ADVERTISE);
348 mii->advertising = advertise;
350 lpa = mii->mdio_read(mii->dev, mii->phy_id, MII_LPA);
351 if (mii->supports_gmii)
352 lpa2 = mii->mdio_read(mii->dev, mii->phy_id, MII_STAT1000);
354 /* figure out media and duplex from advertise and LPA values */
355 media = mii_nway_result(lpa & advertise);
356 duplex = (media & ADVERTISE_FULL) ? 1 : 0;
357 if (lpa2 & LPA_1000FULL)
361 printk(KERN_INFO "%s: link up, %sMbps, %s-duplex, lpa 0x%04X\n",
363 lpa2 & (LPA_1000FULL | LPA_1000HALF) ? "1000" :
364 media & (ADVERTISE_100FULL | ADVERTISE_100HALF) ? "100" : "10",
365 duplex ? "full" : "half",
368 if ((init_media) || (mii->full_duplex != duplex)) {
369 mii->full_duplex = duplex;
370 return 1; /* duplex changed */
373 return 0; /* duplex did not change */
377 * generic_mii_ioctl - main MII ioctl interface
378 * @mii_if: the MII interface
379 * @mii_data: MII ioctl data structure
380 * @cmd: MII ioctl command
381 * @duplex_chg_out: pointer to @duplex_changed status if there was no
384 * Returns 0 on success, negative on error.
386 int generic_mii_ioctl(struct mii_if_info *mii_if,
387 struct mii_ioctl_data *mii_data, int cmd,
388 unsigned int *duplex_chg_out)
391 unsigned int duplex_changed = 0;
396 mii_data->phy_id &= mii_if->phy_id_mask;
397 mii_data->reg_num &= mii_if->reg_num_mask;
401 mii_data->phy_id = mii_if->phy_id;
406 mii_if->mdio_read(mii_if->dev, mii_data->phy_id,
411 u16 val = mii_data->val_in;
413 if (!capable(CAP_NET_ADMIN))
416 if (mii_data->phy_id == mii_if->phy_id) {
417 switch(mii_data->reg_num) {
419 unsigned int new_duplex = 0;
420 if (val & (BMCR_RESET|BMCR_ANENABLE))
421 mii_if->force_media = 0;
423 mii_if->force_media = 1;
424 if (mii_if->force_media &&
425 (val & BMCR_FULLDPLX))
427 if (mii_if->full_duplex != new_duplex) {
429 mii_if->full_duplex = new_duplex;
434 mii_if->advertising = val;
442 mii_if->mdio_write(mii_if->dev, mii_data->phy_id,
443 mii_data->reg_num, val);
452 if ((rc == 0) && (duplex_chg_out) && (duplex_changed))
458 MODULE_AUTHOR ("Jeff Garzik <jgarzik@pobox.com>");
459 MODULE_DESCRIPTION ("MII hardware support library");
460 MODULE_LICENSE("GPL");
462 EXPORT_SYMBOL(mii_link_ok);
463 EXPORT_SYMBOL(mii_nway_restart);
464 EXPORT_SYMBOL(mii_ethtool_gset);
465 EXPORT_SYMBOL(mii_ethtool_sset);
466 EXPORT_SYMBOL(mii_check_link);
467 EXPORT_SYMBOL(mii_check_media);
468 EXPORT_SYMBOL(mii_check_gmii_support);
469 EXPORT_SYMBOL(generic_mii_ioctl);