1 /* $NetBSD: micphy.c,v 1.14 2020/03/28 18:37:18 thorpej Exp $ */ 2 3 /*- 4 * Copyright (c) 1998, 1999, 2000 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 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, and by Frank van der Linden. 10 * 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. 19 * 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. 31 */ 32 33 /* 34 * Copyright (c) 1997 Manuel Bouyer. All rights reserved. 35 * 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. 44 * 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. 55 */ 56 57 /* 58 * Driver for Micrel KSZ8xxx 10/100 and KSZ9xxx 10/100/1000 PHY. 59 */ 60 61 #include <sys/cdefs.h> 62 __KERNEL_RCSID(0, "$NetBSD: micphy.c,v 1.14 2020/03/28 18:37:18 thorpej Exp $"); 63 64 #include "opt_mii.h" 65 66 #include <sys/param.h> 67 #include <sys/systm.h> 68 #include <sys/kernel.h> 69 #include <sys/device.h> 70 #include <sys/socket.h> 71 #include <sys/errno.h> 72 73 #include <net/if.h> 74 #include <net/if_media.h> 75 76 #include <dev/mii/mii.h> 77 #include <dev/mii/miivar.h> 78 #include <dev/mii/miidevs.h> 79 80 static int micphymatch(device_t, cfdata_t, void *); 81 static void micphyattach(device_t, device_t, void *); 82 static void micphy_reset(struct mii_softc *); 83 static int micphy_service(struct mii_softc *, struct mii_data *, int); 84 85 CFATTACH_DECL_NEW(micphy, sizeof(struct mii_softc), 86 micphymatch, micphyattach, mii_phy_detach, mii_phy_activate); 87 88 static int micphy_service(struct mii_softc *, struct mii_data *, int); 89 static void micphy_status(struct mii_softc *); 90 static void micphy_fixup(struct mii_softc *, int, int, device_t); 91 92 static const struct mii_phy_funcs micphy_funcs = { 93 micphy_service, micphy_status, micphy_reset, 94 }; 95 96 struct micphy_softc { 97 struct mii_softc sc_mii; 98 uint32_t sc_lstype; /* Type of link status register */ 99 }; 100 101 static const struct mii_phydesc micphys[] = { 102 MII_PHY_DESC(MICREL, KSZ8041), 103 MII_PHY_DESC(MICREL, KSZ8051), /* +8021,8031 */ 104 MII_PHY_DESC(MICREL, KSZ8061), 105 MII_PHY_DESC(MICREL, KSZ8081), /* +8051,8091 */ 106 MII_PHY_DESC(MICREL, KS8737), 107 MII_PHY_DESC(MICREL, KSZ9021_8001_8721), 108 MII_PHY_DESC(MICREL, KSZ9031), 109 MII_PHY_DESC(MICREL, KSZ9131), 110 MII_PHY_DESC(MICREL, KSZ9477), /* +LAN7430internal */ 111 MII_PHY_END, 112 }; 113 114 /* 115 * Model Rev. Media LSTYPE Devices 116 * 117 * 0x11 100 1F_42 KSZ8041 118 * 0x13 100 1F_42? KSZ8041RNLI 119 * 0x15 ? 100 1E_20 KSZ8051 120 * 0x5 100 1E_20 KSZ8021 121 * 0x6 100 1E_20 KSZ8031 122 * 0x16 ? 100 1E_20 KSZ8081 123 * ? 100 1E_20 KSZ8091 124 * 0x17 100 1E_20 KSZ8061 125 * 0x21 0x0 giga GIGA KSZ9021 126 * 0x1 giga GIGA KSZ9021RLRN 127 * 0x9 100 1F_42 KSZ8721BL/SL 128 * 0x9 100 none? KSZ8721CL 129 * 0xa 100 1F_42 KSZ8001 130 * 0x22 giga GIGA KSZ9031 131 * 0x23 1? gigasw GIGA KSZ9477 (No master/slave bit) 132 * 5? giga GIGA LAN7430internal 133 * 0x24 giga GIGA KSZ9131 134 * 0x32 100 1F_42 KS8737 135 */ 136 137 /* Type of link status register */ 138 #define MICPHYF_LSTYPE_DEFAULT 0 139 #define MICPHYF_LSTYPE_1F_42 1 140 #define MICPHYF_LSTYPE_1E_20 2 141 #define MICPHYF_LSTYPE_GIGA 3 142 143 /* Return if the device is Gigabit (KSZ9021) */ 144 #define KSZ_MODEL21H_GIGA(rev) \ 145 ((((rev) & 0x0e) == 0) ? true : false) 146 147 #define KSZ_XREG_CONTROL 0x0b 148 #define KSZ_XREG_WRITE 0x0c 149 #define KSZ_XREG_READ 0x0d 150 #define KSZ_XREG_CTL_SEL_READ 0x0000 151 #define KSZ_XREG_CTL_SEL_WRITE 0x8000 152 153 #define REG_RGMII_CLOCK_AND_CONTROL 0x104 154 #define REG_RGMII_RX_DATA 0x105 155 156 /* PHY control 1 register for 10/100 PHYs (KSZ80[235689]1) */ 157 #define KSZ8051_PHYCTL1 0x1e 158 #define KSZ8051_PHY_LINK 0x0100 159 #define KSZ8051_PHY_MDIX 0x0020 160 #define KSZ8051_PHY_FDX 0x0004 161 #define KSZ8051_PHY_SPD_MASK 0x0003 162 #define KSZ8051_PHY_SPD_10T 0x0001 163 #define KSZ8051_PHY_SPD_100TX 0x0002 164 165 /* PHY control 2 register for 10/100 PHYs (KSZ8041, KSZ8721 and KSZ8001) */ 166 #define KSZ8041_PHYCTL2 0x1f 167 #define KSZ8041_PHY_ACOMP 0x0080 168 #define KSZ8041_PHY_SPD_MASK 0x001c 169 #define KSZ8041_PHY_SPD_10T 0x0004 170 #define KSZ8041_PHY_SPD_100TX 0x0008 171 #define KSZ8041_PHY_FDX 0x0010 172 #define KSZ8051_PHYCTL2 0x1f 173 174 /* PHY control register for Gigabit PHYs */ 175 #define KSZ_GPHYCTL 0x1f 176 #define KSZ_GPHY_SPD_1000T 0x0040 177 #define KSZ_GPHY_SPD_100TX 0x0020 178 #define KSZ_GPHY_SPD_10T 0x0010 179 #define KSZ_GPHY_FDX 0x0008 180 #define KSZ_GPHY_1000T_MS 0x0004 181 182 static int 183 micphymatch(device_t parent, cfdata_t match, void *aux) 184 { 185 struct mii_attach_args *ma = aux; 186 187 if (mii_phy_match(ma, micphys) != NULL) 188 return 10; 189 190 return 1; 191 } 192 193 static void 194 micphyattach(device_t parent, device_t self, void *aux) 195 { 196 struct micphy_softc *msc = device_private(self); 197 struct mii_softc *sc = &msc->sc_mii; 198 struct mii_attach_args *ma = aux; 199 struct mii_data *mii = ma->mii_data; 200 int model = MII_MODEL(ma->mii_id2); 201 int rev = MII_REV(ma->mii_id2); 202 const struct mii_phydesc *mpd; 203 204 mpd = mii_phy_match(ma, micphys); 205 aprint_naive(": Media interface\n"); 206 aprint_normal(": %s, rev. %d\n", mpd->mpd_name, rev); 207 208 sc->mii_dev = self; 209 sc->mii_inst = mii->mii_instance; 210 sc->mii_phy = ma->mii_phyno; 211 sc->mii_funcs = &micphy_funcs; 212 sc->mii_pdata = mii; 213 sc->mii_flags = ma->mii_flags; 214 215 if ((sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8041) 216 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8041RNLI) 217 || (sc->mii_mpd_model == MII_MODEL_MICREL_KS8737) 218 || ((sc->mii_mpd_model == MII_MODEL_MICREL_KSZ9021_8001_8721) 219 && !KSZ_MODEL21H_GIGA(sc->mii_mpd_rev))) { 220 msc->sc_lstype = MICPHYF_LSTYPE_1F_42; 221 } else if ((sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8051) 222 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8081) 223 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8061)) { 224 msc->sc_lstype = MICPHYF_LSTYPE_1E_20; 225 } else if (((sc->mii_mpd_model == MII_MODEL_MICREL_KSZ9021_8001_8721) 226 && KSZ_MODEL21H_GIGA(sc->mii_mpd_rev)) 227 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ9031) 228 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ9477) 229 || (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ9131)) { 230 msc->sc_lstype = MICPHYF_LSTYPE_GIGA; 231 } else 232 msc->sc_lstype = MICPHYF_LSTYPE_DEFAULT; 233 234 mii_lock(mii); 235 236 PHY_RESET(sc); 237 238 micphy_fixup(sc, model, rev, parent); 239 240 PHY_READ(sc, MII_BMSR, &sc->mii_capabilities); 241 sc->mii_capabilities &= ma->mii_capmask; 242 if (sc->mii_capabilities & BMSR_EXTSTAT) 243 PHY_READ(sc, MII_EXTSR, &sc->mii_extcapabilities); 244 245 mii_unlock(mii); 246 247 aprint_normal_dev(self, ""); 248 mii_phy_add_media(sc); 249 aprint_normal("\n"); 250 } 251 252 static void 253 micphy_reset(struct mii_softc *sc) 254 { 255 uint16_t reg; 256 257 KASSERT(mii_locked(sc->mii_pdata)); 258 259 /* 260 * The 8081 has no "sticky bits" that survive a soft reset; several 261 * bits in the Phy Control Register 2 must be preserved across the 262 * reset. These bits are set up by the bootloader; they control how the 263 * phy interfaces to the board (such as clock frequency and LED 264 * behavior). 265 */ 266 if (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8081) 267 PHY_READ(sc, KSZ8051_PHYCTL2, ®); 268 mii_phy_reset(sc); 269 if (sc->mii_mpd_model == MII_MODEL_MICREL_KSZ8081) 270 PHY_WRITE(sc, KSZ8051_PHYCTL2, reg); 271 } 272 273 static int 274 micphy_service(struct mii_softc *sc, struct mii_data *mii, int cmd) 275 { 276 struct ifmedia_entry *ife = mii->mii_media.ifm_cur; 277 uint16_t reg; 278 279 KASSERT(mii_locked(mii)); 280 281 switch (cmd) { 282 case MII_POLLSTAT: 283 /* If we're not polling our PHY instance, just return. */ 284 if (IFM_INST(ife->ifm_media) != sc->mii_inst) 285 return 0; 286 break; 287 288 case MII_MEDIACHG: 289 /* 290 * If the media indicates a different PHY instance, 291 * isolate ourselves. 292 */ 293 if (IFM_INST(ife->ifm_media) != sc->mii_inst) { 294 PHY_READ(sc, MII_BMCR, ®); 295 PHY_WRITE(sc, MII_BMCR, reg | BMCR_ISO); 296 return 0; 297 } 298 299 /* If the interface is not up, don't do anything. */ 300 if ((mii->mii_ifp->if_flags & IFF_UP) == 0) 301 break; 302 303 mii_phy_setmedia(sc); 304 break; 305 306 case MII_TICK: 307 /* If we're not currently selected, just return. */ 308 if (IFM_INST(ife->ifm_media) != sc->mii_inst) 309 return 0; 310 311 if (mii_phy_tick(sc) == EJUSTRETURN) 312 return 0; 313 break; 314 315 case MII_DOWN: 316 mii_phy_down(sc); 317 return 0; 318 } 319 320 /* Update the media status. */ 321 mii_phy_status(sc); 322 323 /* Callback if something changed. */ 324 mii_phy_update(sc, cmd); 325 return 0; 326 } 327 328 static void 329 micphy_writexreg(struct mii_softc *sc, uint32_t reg, uint32_t wval) 330 { 331 uint16_t rval __debugused; 332 333 PHY_WRITE(sc, KSZ_XREG_CONTROL, KSZ_XREG_CTL_SEL_WRITE | reg); 334 PHY_WRITE(sc, KSZ_XREG_WRITE, wval); 335 PHY_WRITE(sc, KSZ_XREG_CONTROL, KSZ_XREG_CTL_SEL_READ | reg); 336 PHY_READ(sc, KSZ_XREG_READ, &rval); 337 KDASSERT(wval == rval); 338 } 339 340 static void 341 micphy_fixup(struct mii_softc *sc, int model, int rev, device_t parent) 342 { 343 344 KASSERT(mii_locked(sc->mii_pdata)); 345 346 switch (model) { 347 case MII_MODEL_MICREL_KSZ9021_8001_8721: 348 if (!device_is_a(parent, "cpsw")) 349 break; 350 351 aprint_normal_dev(sc->mii_dev, 352 "adjusting RGMII signal timing for cpsw\n"); 353 354 // RGMII RX Data Pad Skew 355 micphy_writexreg(sc, REG_RGMII_RX_DATA, 0x0000); 356 357 // RGMII Clock and Control Pad Skew 358 micphy_writexreg(sc, REG_RGMII_CLOCK_AND_CONTROL, 0x9090); 359 360 break; 361 default: 362 break; 363 } 364 365 return; 366 } 367 368 static void 369 micphy_status(struct mii_softc *sc) 370 { 371 struct micphy_softc *msc = device_private(sc->mii_dev); 372 struct mii_data *mii = sc->mii_pdata; 373 uint16_t bmsr, bmcr, sr; 374 375 KASSERT(mii_locked(mii)); 376 377 /* For unknown devices */ 378 if (msc->sc_lstype == MICPHYF_LSTYPE_DEFAULT) { 379 ukphy_status(sc); 380 return; 381 } 382 383 mii->mii_media_status = IFM_AVALID; 384 mii->mii_media_active = IFM_ETHER; 385 386 PHY_READ(sc, MII_BMCR, &bmcr); 387 388 PHY_READ(sc, MII_BMSR, &bmsr); 389 PHY_READ(sc, MII_BMSR, &bmsr); 390 if (bmsr & BMSR_LINK) 391 mii->mii_media_status |= IFM_ACTIVE; 392 393 if (bmcr & BMCR_AUTOEN) { 394 if ((bmsr & BMSR_ACOMP) == 0) { 395 mii->mii_media_active |= IFM_NONE; 396 return; 397 } 398 } 399 400 if (msc->sc_lstype == MICPHYF_LSTYPE_1F_42) { 401 PHY_READ(sc, KSZ8041_PHYCTL2, &sr); 402 if ((sr & KSZ8041_PHY_SPD_MASK) == 0) 403 mii->mii_media_active |= IFM_NONE; 404 else if (sr & KSZ8041_PHY_SPD_100TX) 405 mii->mii_media_active |= IFM_100_TX; 406 else if (sr & KSZ8041_PHY_SPD_10T) 407 mii->mii_media_active |= IFM_10_T; 408 if (sr & KSZ8041_PHY_FDX) 409 mii->mii_media_active |= IFM_FDX 410 | mii_phy_flowstatus(sc); 411 } else if (msc->sc_lstype == MICPHYF_LSTYPE_1E_20) { 412 PHY_READ(sc, KSZ8051_PHYCTL1, &sr); 413 if ((sr & KSZ8051_PHY_SPD_MASK) == 0) 414 mii->mii_media_active |= IFM_NONE; 415 else if (sr & KSZ8051_PHY_SPD_100TX) 416 mii->mii_media_active |= IFM_100_TX; 417 else if (sr & KSZ8051_PHY_SPD_10T) 418 mii->mii_media_active |= IFM_10_T; 419 if (sr & KSZ8051_PHY_FDX) 420 mii->mii_media_active |= IFM_FDX 421 | mii_phy_flowstatus(sc); 422 } else if (msc->sc_lstype == MICPHYF_LSTYPE_GIGA) { 423 /* 9021/9031/7430/9131 gphy */ 424 PHY_READ(sc, KSZ_GPHYCTL, &sr); 425 if (sr & KSZ_GPHY_SPD_1000T) 426 mii->mii_media_active |= IFM_1000_T; 427 else if (sr & KSZ_GPHY_SPD_100TX) 428 mii->mii_media_active |= IFM_100_TX; 429 else if (sr & KSZ_GPHY_SPD_10T) 430 mii->mii_media_active |= IFM_10_T; 431 else 432 mii->mii_media_active |= IFM_NONE; 433 if ((mii->mii_media_active & IFM_1000_T) 434 && (sr & KSZ_GPHY_1000T_MS)) 435 mii->mii_media_active |= IFM_ETH_MASTER; 436 if (sr & KSZ_GPHY_FDX) 437 mii->mii_media_active |= IFM_FDX 438 | mii_phy_flowstatus(sc); 439 else 440 mii->mii_media_active |= IFM_HDX; 441 } 442 } 443