Sync usage with man page.
[netbsd-mini2440.git] / sys / dev / mii / icsphy.c
blob8abe5c9c4b1cf2a3c23fe63bb8ffddb3bda629fd
1 /* $NetBSD: icsphy.c,v 1.47 2008/11/17 03:04:27 dyoung Exp $ */
3 /*-
4 * Copyright (c) 1998, 1999, 2000 The NetBSD Foundation, Inc.
5 * All rights reserved.
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9 * NASA Ames Research Center.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
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 THE
30 * POSSIBILITY OF SUCH DAMAGE.
34 * Copyright (c) 1997 Manuel Bouyer. All rights reserved.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
45 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
46 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
47 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
48 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
49 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
50 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
51 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
52 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
53 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
54 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
58 * driver for Integrated Circuit Systems' ICS1889-1893 ethernet 10/100 PHY
59 * datasheet from www.icst.com
62 #include <sys/cdefs.h>
63 __KERNEL_RCSID(0, "$NetBSD: icsphy.c,v 1.47 2008/11/17 03:04:27 dyoung Exp $");
65 #include <sys/param.h>
66 #include <sys/systm.h>
67 #include <sys/kernel.h>
68 #include <sys/device.h>
69 #include <sys/socket.h>
71 #include <net/if.h>
72 #include <net/if_media.h>
74 #include <dev/mii/mii.h>
75 #include <dev/mii/miivar.h>
76 #include <dev/mii/miidevs.h>
78 #include <dev/mii/icsphyreg.h>
80 static int icsphymatch(device_t, cfdata_t, void *);
81 static void icsphyattach(device_t, device_t, void *);
83 CFATTACH_DECL_NEW(icsphy, sizeof(struct mii_softc),
84 icsphymatch, icsphyattach, mii_phy_detach, mii_phy_activate);
86 static int icsphy_service(struct mii_softc *, struct mii_data *, int);
87 static void icsphy_status(struct mii_softc *);
88 static void icsphy_reset(struct mii_softc *);
90 static const struct mii_phy_funcs icsphy_funcs = {
91 icsphy_service, icsphy_status, icsphy_reset,
94 static const struct mii_phydesc icsphys[] = {
95 { MII_OUI_ICS, MII_MODEL_ICS_1889,
96 MII_STR_ICS_1889 },
98 { MII_OUI_ICS, MII_MODEL_ICS_1890,
99 MII_STR_ICS_1890 },
101 { MII_OUI_ICS, MII_MODEL_ICS_1892,
102 MII_STR_ICS_1892 },
104 { MII_OUI_ICS, MII_MODEL_ICS_1893,
105 MII_STR_ICS_1893 },
107 { 0, 0,
108 NULL },
111 static int
112 icsphymatch(device_t parent, cfdata_t match, void *aux)
114 struct mii_attach_args *ma = aux;
116 if (mii_phy_match(ma, icsphys) != NULL)
117 return (10);
119 return (0);
122 static void
123 icsphyattach(device_t parent, device_t self, void *aux)
125 struct mii_softc *sc = device_private(self);
126 struct mii_attach_args *ma = aux;
127 struct mii_data *mii = ma->mii_data;
128 const struct mii_phydesc *mpd;
130 mpd = mii_phy_match(ma, icsphys);
131 aprint_naive(": Media interface\n");
132 aprint_normal(": %s, rev. %d\n", mpd->mpd_name, MII_REV(ma->mii_id2));
134 sc->mii_dev = self;
135 sc->mii_mpd_model = MII_MODEL(ma->mii_id2);
136 sc->mii_inst = mii->mii_instance;
137 sc->mii_phy = ma->mii_phyno;
138 sc->mii_funcs = &icsphy_funcs;
139 sc->mii_pdata = mii;
140 sc->mii_flags = ma->mii_flags;
141 sc->mii_anegticks = MII_ANEGTICKS;
143 PHY_RESET(sc);
145 sc->mii_capabilities =
146 PHY_READ(sc, MII_BMSR) & ma->mii_capmask;
147 aprint_normal_dev(self, "");
148 if ((sc->mii_capabilities & BMSR_MEDIAMASK) == 0)
149 aprint_error("no media present");
150 else
151 mii_phy_add_media(sc);
152 aprint_normal("\n");
155 static int
156 icsphy_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
158 struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
159 int reg;
161 switch (cmd) {
162 case MII_POLLSTAT:
164 * If we're not polling our PHY instance, just return.
166 if (IFM_INST(ife->ifm_media) != sc->mii_inst)
167 return (0);
168 break;
170 case MII_MEDIACHG:
172 * If the media indicates a different PHY instance,
173 * isolate ourselves.
175 if (IFM_INST(ife->ifm_media) != sc->mii_inst) {
176 reg = PHY_READ(sc, MII_BMCR);
177 PHY_WRITE(sc, MII_BMCR, reg | BMCR_ISO);
178 return (0);
182 * If the interface is not up, don't do anything.
184 if ((mii->mii_ifp->if_flags & IFF_UP) == 0)
185 break;
187 mii_phy_setmedia(sc);
188 break;
190 case MII_TICK:
192 * If we're not currently selected, just return.
194 if (IFM_INST(ife->ifm_media) != sc->mii_inst)
195 return (0);
197 if (mii_phy_tick(sc) == EJUSTRETURN)
198 return (0);
199 break;
201 case MII_DOWN:
202 mii_phy_down(sc);
203 return (0);
206 /* Update the media status. */
207 mii_phy_status(sc);
209 /* Callback if something changed. */
210 mii_phy_update(sc, cmd);
211 return (0);
214 static void
215 icsphy_status(struct mii_softc *sc)
217 struct mii_data *mii = sc->mii_pdata;
218 struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
219 int bmcr, qpr;
221 mii->mii_media_status = IFM_AVALID;
222 mii->mii_media_active = IFM_ETHER;
225 * Don't get link from the BMSR. It's available in the QPR,
226 * and we have to read it twice to unlatch it anyhow. This
227 * gives us fewer register reads.
229 qpr = PHY_READ(sc, MII_ICSPHY_QPR); /* unlatch */
230 qpr = PHY_READ(sc, MII_ICSPHY_QPR); /* real value */
232 if (qpr & QPR_LINK)
233 mii->mii_media_status |= IFM_ACTIVE;
235 bmcr = PHY_READ(sc, MII_BMCR);
236 if (bmcr & BMCR_ISO) {
237 mii->mii_media_active |= IFM_NONE;
238 mii->mii_media_status = 0;
239 return;
242 if (bmcr & BMCR_LOOP)
243 mii->mii_media_active |= IFM_LOOP;
245 if (bmcr & BMCR_AUTOEN) {
246 if ((qpr & QPR_ACOMP) == 0) {
247 /* Erg, still trying, I guess... */
248 mii->mii_media_active |= IFM_NONE;
249 return;
251 if (qpr & QPR_SPEED)
252 mii->mii_media_active |= IFM_100_TX;
253 else
254 mii->mii_media_active |= IFM_10_T;
255 if (qpr & QPR_FDX)
256 mii->mii_media_active |= IFM_FDX;
257 } else
258 mii->mii_media_active = ife->ifm_media;
261 static void
262 icsphy_reset(struct mii_softc *sc)
265 mii_phy_reset(sc);
266 /* set powerdown feature */
267 switch (sc->mii_mpd_model) {
268 case MII_MODEL_ICS_1890:
269 case MII_MODEL_ICS_1893:
270 PHY_WRITE(sc, MII_ICSPHY_ECR2, ECR2_100AUTOPWRDN);
271 break;
272 case MII_MODEL_ICS_1892:
273 PHY_WRITE(sc, MII_ICSPHY_ECR2,
274 ECR2_10AUTOPWRDN|ECR2_100AUTOPWRDN);
275 break;
276 default:
277 /* 1889 have no ECR2 */
278 break;
281 * There is no description that the reset do auto-negotiation in the
282 * data sheet.
284 PHY_WRITE(sc, MII_BMCR, BMCR_S100|BMCR_STARTNEG|BMCR_FDX);