1 /*        $NetBSD: pnaphy.c,v 1.26 2020/03/15 23:04:50 thorpej Exp $  */
2 
3 /*
4  * Copyright 2001 Wasabi Systems, Inc.
5  * All rights reserved.
6  *
7  * Written by Jason R. Thorpe for Wasabi Systems, Inc.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  * 3. All advertising materials mentioning features or use of this software
18  *    must display the following acknowledgement:
19  *        This product includes software developed for the NetBSD Project by
20  *        Wasabi Systems, Inc.
21  * 4. The name of Wasabi Systems, Inc. may not be used to endorse
22  *    or promote products derived from this software without specific prior
23  *    written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
29  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35  * POSSIBILITY OF SUCH DAMAGE.
36  */
37 
38 /*
39  * Driver for generic HomePNA 1.0 PHYs.
40  *
41  * HomePNA 1.0 PHYs are pretty simple -- they support exactly one
42  * media type, and don't do autonegotiation.
43  *
44  * HomePNA PHYs often have vendor-specific registers for tuning
45  * the network connection, but we don't deal with any of that
46  * at all.
47  */
48 
49 #include <sys/cdefs.h>
50 __KERNEL_RCSID(0, "$NetBSD: pnaphy.c,v 1.26 2020/03/15 23:04:50 thorpej Exp $");
51 
52 #include <sys/param.h>
53 #include <sys/systm.h>
54 #include <sys/kernel.h>
55 #include <sys/device.h>
56 #include <sys/socket.h>
57 #include <sys/errno.h>
58 
59 #include <net/if.h>
60 #include <net/if_media.h>
61 
62 #include <dev/mii/mii.h>
63 #include <dev/mii/miivar.h>
64 #include <dev/mii/miidevs.h>
65 
66 static int          pnaphymatch(device_t, cfdata_t, void *);
67 static void         pnaphyattach(device_t, device_t, void *);
68 
69 CFATTACH_DECL_NEW(pnaphy, sizeof(struct mii_softc),
70     pnaphymatch, pnaphyattach, mii_phy_detach, mii_phy_activate);
71 
72 static int          pnaphy_service(struct mii_softc *, struct mii_data *, int);
73 static void         pnaphy_status(struct mii_softc *);
74 
75 static const struct mii_phy_funcs pnaphy_funcs = {
76           pnaphy_service, pnaphy_status, mii_phy_reset,
77 };
78 
79 static const struct mii_phydesc pnaphys[] = {
80           MII_PHY_DESC(yyAMD, 79c901home),
81           MII_PHY_END,
82 };
83 
84 static int
pnaphymatch(device_t parent,cfdata_t match,void * aux)85 pnaphymatch(device_t parent, cfdata_t match, void *aux)
86 {
87           struct mii_attach_args *ma = aux;
88 
89           if (mii_phy_match(ma, pnaphys) != NULL) {
90                     /*
91                      * Match higher than ukphy, but lower than a specific
92                      * driver would match.
93                      */
94                     return 2;
95           }
96 
97           return 0;
98 }
99 
100 static void
pnaphyattach(device_t parent,device_t self,void * aux)101 pnaphyattach(device_t parent, device_t self, void *aux)
102 {
103           struct mii_softc *sc = device_private(self);
104           struct mii_attach_args *ma = aux;
105           struct mii_data *mii = ma->mii_data;
106           const struct mii_phydesc *mpd;
107 
108           mpd = mii_phy_match(ma, pnaphys);
109           aprint_naive(": Media interface\n");
110           aprint_normal(": %s, rev. %d\n", mpd->mpd_name, MII_REV(ma->mii_id2));
111 
112           sc->mii_dev = self;
113           sc->mii_inst = mii->mii_instance;
114           sc->mii_phy = ma->mii_phyno;
115           sc->mii_funcs = &pnaphy_funcs;
116           sc->mii_pdata = mii;
117           sc->mii_flags = ma->mii_flags | MIIF_IS_HPNA; /* Force HomePNA */
118 
119           mii_lock(mii);
120 
121           PHY_RESET(sc);
122 
123           PHY_READ(sc, MII_BMSR, &sc->mii_capabilities);
124           sc->mii_capabilities &= ma->mii_capmask;
125 
126           mii_unlock(mii);
127 
128           mii_phy_add_media(sc);
129 }
130 
131 static int
pnaphy_service(struct mii_softc * sc,struct mii_data * mii,int cmd)132 pnaphy_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
133 {
134           struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
135           uint16_t reg;
136 
137           KASSERT(mii_locked(mii));
138 
139           switch (cmd) {
140           case MII_POLLSTAT:
141                     /* If we're not polling our PHY instance, just return. */
142                     if (IFM_INST(ife->ifm_media) != sc->mii_inst)
143                               return 0;
144                     break;
145 
146           case MII_MEDIACHG:
147                     /*
148                      * If the media indicates a different PHY instance,
149                      * isolate ourselves.
150                      */
151                     if (IFM_INST(ife->ifm_media) != sc->mii_inst) {
152                               PHY_READ(sc, MII_BMCR, &reg);
153                               PHY_WRITE(sc, MII_BMCR, reg | BMCR_ISO);
154                               return 0;
155                     }
156 
157                     /* If the interface is not up, don't do anything. */
158                     if ((mii->mii_ifp->if_flags & IFF_UP) == 0)
159                               break;
160 
161                     mii_phy_setmedia(sc);
162                     break;
163 
164           case MII_TICK:
165                     /* If we're not currently selected, just return. */
166                     if (IFM_INST(ife->ifm_media) != sc->mii_inst)
167                               return 0;
168 
169                     if (mii_phy_tick(sc) == EJUSTRETURN)
170                               return 0;
171                     break;
172 
173           case MII_DOWN:
174                     mii_phy_down(sc);
175                     return 0;
176           }
177 
178           /* Update the media status. */
179           mii_phy_status(sc);
180 
181           /* Callback if something changed. */
182           mii_phy_update(sc, cmd);
183           return 0;
184 }
185 
186 static void
pnaphy_status(struct mii_softc * sc)187 pnaphy_status(struct mii_softc *sc)
188 {
189           struct mii_data *mii = sc->mii_pdata;
190           struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
191           uint16_t bmsr, bmcr;
192 
193           KASSERT(mii_locked(mii));
194 
195           mii->mii_media_status = IFM_AVALID;
196           mii->mii_media_active = IFM_ETHER;
197 
198           PHY_READ(sc, MII_BMSR, &bmsr);
199           PHY_READ(sc, MII_BMSR, &bmsr);
200 
201           if (bmsr & BMSR_LINK)
202                     mii->mii_media_status |= IFM_ACTIVE;
203 
204           PHY_READ(sc, MII_BMCR, &bmcr);
205           if (bmcr & BMCR_ISO) {
206                     mii->mii_media_active |= IFM_NONE;
207                     mii->mii_media_status = 0;
208                     return;
209           }
210 
211           if (bmcr & BMCR_LOOP)
212                     mii->mii_media_active |= IFM_LOOP;
213 
214           /*
215            * On HomePNA PHYs, the current media is always the selected
216            * media.
217            *
218            * XXX May not be the case w/ HomePNA 2.
219            */
220           mii->mii_media_active = ife->ifm_media;
221 }
222