text: /*	$OpenBSD: amphy.c,v 1.13 2005/05/27 08:04:15 brad Exp $	*/
  
  /*
   * Copyright (c) 1997, 1998, 1999
   *	Bill Paul <wpaul@ee.columbia.edu>.  All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in the
   *    documentation and/or other materials provided with the distribution.
   * 3. All advertising materials mentioning features or use of this software
   *    must display the following acknowledgement:
   *	This product includes software developed by Bill Paul.
   * 4. Neither the name of the author nor the names of any co-contributors
   *    may be used to endorse or promote products derived from this software
   *    without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
   * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
   * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
   * THE POSSIBILITY OF SUCH DAMAGE.
   *
   * $FreeBSD: src/sys/dev/mii/amphy.c,v 1.2.2.2 2002/11/08 21:53:49 semenu Exp $
   */
  
  /*
   * driver for AMD AM79c873 PHYs
   * This driver also works for the Davicom DM9101 PHY, which appears to
   * be an AM79c873 workalike.
   */
  
  #include <sys/param.h>
  #include <sys/systm.h>
  #include <sys/kernel.h>
  #include <sys/socket.h>
  #include <sys/bus.h>
  
  #include <net/if.h>
  #include <net/if_media.h>
  
  #include "mii.h"
  #include "miivar.h"
  #include "miidevs.h"
  
  #include "amphyreg.h"
  
  #include "miibus_if.h"
  
  static int amphy_probe		(device_t);
  static int amphy_attach		(device_t);
  
  static device_method_t amphy_methods[] = {
  	/* device interface */
  	DEVMETHOD(device_probe,		amphy_probe),
  	DEVMETHOD(device_attach,	amphy_attach),
  	DEVMETHOD(device_detach,	ukphy_detach),
  	DEVMETHOD(device_shutdown,	bus_generic_shutdown),
  	DEVMETHOD_END
  };
  
  static const struct mii_phydesc amphys[] = {
  	MII_PHYDESC(xxAMD,	79C873),
  	MII_PHYDESC(xxDAVICOM,	DM9101),
  	MII_PHYDESC(DAVICOM,	DM9102),
  	MII_PHYDESC(DAVICOM,	DM9601),
  	MII_PHYDESC_NULL
  };
  
  static devclass_t amphy_devclass;
  
  static driver_t amphy_driver = {
  	"amphy",
  	amphy_methods,
  	sizeof(struct mii_softc)
  };
  
  DRIVER_MODULE(amphy, miibus, amphy_driver, amphy_devclass, NULL, NULL);
  
  static int	amphy_service(struct mii_softc *, struct mii_data *, int);
  static void	amphy_status(struct mii_softc *);
  
  static int
  amphy_probe(device_t dev)
  {
  	struct mii_attach_args *ma = device_get_ivars(dev);
  	const struct mii_phydesc *mpd;
  
  	mpd = mii_phy_match(ma, amphys);
  	if (mpd != NULL) {
  		device_set_desc(dev, mpd->mpd_name);
  		return (0);
  	}
  	return (ENXIO);
  }
  
  static int
  amphy_attach(device_t dev)
  {
  	struct mii_softc *sc;
  	struct mii_attach_args *ma;
  	struct mii_data *mii;
  
  	sc = device_get_softc(dev);
  	ma = device_get_ivars(dev);
  	mii_softc_init(sc, ma);
  	sc->mii_dev = device_get_parent(dev);
  	mii = device_get_softc(sc->mii_dev);
  	LIST_INSERT_HEAD(&mii->mii_phys, sc, mii_list);
  
  	sc->mii_inst = mii->mii_instance;
  	sc->mii_service = amphy_service;
  	sc->mii_pdata = mii;
  
  	sc->mii_flags |= MIIF_NOISOLATE;
  	mii->mii_instance++;
  
  #define	ADD(m, c)	ifmedia_add(&mii->mii_media, (m), (c), NULL)
  
  	ADD(IFM_MAKEWORD(IFM_ETHER, IFM_NONE, 0, sc->mii_inst),
  	    MII_MEDIA_NONE);
  #if 0
  	ADD(IFM_MAKEWORD(IFM_ETHER, IFM_100_TX, IFM_LOOP, sc->mii_inst),
  	    MII_MEDIA_100_TX);
  #endif
  
  	mii_phy_reset(sc);
  
  	sc->mii_capabilities = PHY_READ(sc, MII_BMSR) & ma->mii_capmask;
  	device_printf(dev, " ");
  	if ((sc->mii_capabilities & BMSR_MEDIAMASK) == 0)
  		kprintf("no media present");
  	else
  		mii_phy_add_media(sc);
  	kprintf("\n");
  #undef ADD
  	MIIBUS_MEDIAINIT(sc->mii_dev);
  	return(0);
  }
  
  static int
  amphy_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
  {
  	struct ifmedia_entry *ife = mii->mii_media.ifm_cur;
  	int reg;
  
  	switch (cmd) {
  	case MII_POLLSTAT:
  		/*
  		 * If we're not polling our PHY instance, just return.
  		 */
  		if (IFM_INST(ife->ifm_media) != sc->mii_inst)
  			return (0);
  		break;
  
  	case MII_MEDIACHG:
  		/*
  		 * If the media indicates a different PHY instance,
  		 * isolate ourselves.
  		 */
  		if (IFM_INST(ife->ifm_media) != sc->mii_inst) {
  			reg = PHY_READ(sc, MII_BMCR);
  			PHY_WRITE(sc, MII_BMCR, reg | BMCR_ISO);
  			return (0);
  		}
  
  		/*
  		 * If the interface is not up, don't do anything.
  		 */
  		if ((mii->mii_ifp->if_flags & IFF_UP) == 0)
  			break;
  
  		mii_phy_set_media(sc);
  		break;
  
  	case MII_TICK:
  		/*
  		 * If we're not currently selected, just return.
  		 */
  		if (IFM_INST(ife->ifm_media) != sc->mii_inst)
  			return (0);
  
  		if (mii_phy_tick(sc) == EJUSTRETURN)
  			return (0);
  		break;
  	}
  
  	/* Update the media status. */
  	amphy_status(sc);
  
  	/* Callback if something changed. */
  	mii_phy_update(sc, cmd);
  	return (0);
  }
  
  static void
  amphy_status(struct mii_softc *sc)
  {
  	struct mii_data *mii = sc->mii_pdata;
  	int bmsr, bmcr, par, anlpar;
  
  	mii->mii_media_status = IFM_AVALID;
  	mii->mii_media_active = IFM_ETHER;
  
  	bmsr = PHY_READ(sc, MII_BMSR) |
  	    PHY_READ(sc, MII_BMSR);
  	if (bmsr & BMSR_LINK)
  		mii->mii_media_status |= IFM_ACTIVE;
  
  	bmcr = PHY_READ(sc, MII_BMCR);
  	if (bmcr & BMCR_ISO) {
  		mii->mii_media_active |= IFM_NONE;
  		mii->mii_media_status = 0;
  		return;
  	}
  
  	if (bmcr & BMCR_LOOP)
  		mii->mii_media_active |= IFM_LOOP;
  
  	if (bmcr & BMCR_AUTOEN) {
  		/*
  		 * The PAR status bits are only valid of autonegotiation
  		 * has completed (or it's disabled).
  		 */
  		if ((bmsr & BMSR_ACOMP) == 0) {
  			/* Erg, still trying, I guess... */
  			mii->mii_media_active |= IFM_NONE;
  			return;
  		}
  
  		if (PHY_READ(sc, MII_ANER) & ANER_LPAN) {
  			anlpar = PHY_READ(sc, MII_ANAR) &
  			    PHY_READ(sc, MII_ANLPAR);
  			if (anlpar & ANLPAR_T4)
  				mii->mii_media_active |= IFM_100_T4;
  			else if (anlpar & ANLPAR_TX_FD)
  				mii->mii_media_active |= IFM_100_TX|IFM_FDX;
  			else if (anlpar & ANLPAR_TX)
  				mii->mii_media_active |= IFM_100_TX;
  			else if (anlpar & ANLPAR_10_FD)
  				mii->mii_media_active |= IFM_10_T|IFM_FDX;
  			else if (anlpar & ANLPAR_10)
  				mii->mii_media_active |= IFM_10_T;
  			else
  				mii->mii_media_active |= IFM_NONE;
  			return;
  		}
  
  		/*
  		 * Link partner is not capable of autonegotiation.
  		 */
  		par = PHY_READ(sc, MII_AMPHY_DSCSR);
  		if (par & DSCSR_100FDX)
  			mii->mii_media_active |= IFM_100_TX|IFM_FDX;
  		else if (par & DSCSR_100HDX)
  			mii->mii_media_active |= IFM_100_TX;
  		else if (par & DSCSR_10FDX)
  			mii->mii_media_active |= IFM_10_T|IFM_HDX;
  		else if (par & DSCSR_10HDX)
  			mii->mii_media_active |= IFM_10_T;
  	} else {
  		mii->mii_media_active = mii->mii_media.ifm_cur->ifm_media;
  	}
  }
  