git: 0c9156faeccb - main - Introduce DP83822 PHY driver

From: Wojciech Macek <wma_at_FreeBSD.org>
Date: Wed, 24 Nov 2021 06:41:52 UTC
The branch main has been updated by wma:

URL: https://cgit.FreeBSD.org/src/commit/?id=0c9156faeccba0b8cbedfe976a1274b56caa1dbc

commit 0c9156faeccba0b8cbedfe976a1274b56caa1dbc
Author:     Kornel Duleba <mindal@semihalf.com>
AuthorDate: 2021-11-15 08:58:59 +0000
Commit:     Wojciech Macek <wma@FreeBSD.org>
CommitDate: 2021-11-24 06:40:36 +0000

    Introduce DP83822 PHY driver
    
    DP83822 is a 10/100 Texas Instruments PHY.
    Link status change interrupts are supported by the driver,
    however not all boards have the PHY interrupt wired.
    Because of that if failure to allocate an IRQ is not treated as an error.
    
    Obtained from: Semihalf
    Sponsored by: Alstom Group
    Differential revision: https://reviews.freebsd.org/D32815
---
 sys/conf/files           |   1 +
 sys/dev/mii/dp83822phy.c | 220 +++++++++++++++++++++++++++++++++++++++++++++++
 sys/dev/mii/miidevs      |   1 +
 3 files changed, 222 insertions(+)

diff --git a/sys/conf/files b/sys/conf/files
index 33a5bf2e264b..6f0e321efe79 100644
--- a/sys/conf/files
+++ b/sys/conf/files
@@ -2417,6 +2417,7 @@ dev/mii/axphy.c			optional miibus | axphy
 dev/mii/bmtphy.c		optional miibus | bmtphy
 dev/mii/brgphy.c		optional miibus | brgphy
 dev/mii/ciphy.c			optional miibus | ciphy
+dev/mii/dp83822phy.c		optional miibus | dp83822phy
 dev/mii/dp83867phy.c		optional miibus | dp83867phy
 dev/mii/e1000phy.c		optional miibus | e1000phy
 dev/mii/gentbi.c		optional miibus | gentbi
diff --git a/sys/dev/mii/dp83822phy.c b/sys/dev/mii/dp83822phy.c
new file mode 100644
index 000000000000..181fc610be76
--- /dev/null
+++ b/sys/dev/mii/dp83822phy.c
@@ -0,0 +1,220 @@
+/*-
+ * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
+ *
+ * Copyright (c) 2021 Alstom Group.
+ * Copyright (c) 2021 Semihalf.
+ * 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.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 THE AUTHOR OR CONTRIBUTORS 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.
+ */
+
+/*
+ * Driver for TI DP83822 Ethernet PHY
+ */
+
+#include <sys/cdefs.h>
+__FBSDID("$FreeBSD$");
+
+#include <sys/param.h>
+#include <sys/bus.h>
+#include <sys/kernel.h>
+#include <sys/module.h>
+#include <sys/resource.h>
+#include <sys/rman.h>
+#include <sys/socket.h>
+
+#include <machine/resource.h>
+
+#include <net/if.h>
+#include <net/if_media.h>
+
+#include <dev/mii/mii.h>
+#include <dev/mii/miivar.h>
+
+#include "miidevs.h"
+#include "miibus_if.h"
+
+#define	BIT(x)			(1 << (x))
+
+#define	DP83822_PHYSTS			0x10
+#define	DP83822_PHYSTS_LINK_UP		BIT(0)
+#define	DP83822_PHYSTS_SPEED_100	BIT(1)
+#define	DP83822_PHYSTS_FD		BIT(2)
+
+#define	DP83822_PHYSCR		0x11
+#define	DP83822_PHYSCR_INT_OE	BIT(0)	/* Behaviour of INT pin. */
+#define	DP83822_PHYSCR_INT_EN	BIT(1)
+
+#define	DP83822_MISR1			0x12
+#define	DP83822_MISR1_AN_CMPL_EN	BIT(2)
+#define	DP83822_MISR1_DP_CHG_EN		BIT(3)
+#define	DP83822_MISR1_SPD_CHG_EN	BIT(4)
+#define	DP83822_MISR1_LINK_CHG_EN	BIT(5)
+#define	DP83822_MISR1_INT_MASK		0xFF
+#define	DP83822_MISR1_INT_STS_SHIFT	8
+
+#define	DP83822_MISR2			0x13
+#define	DP83822_MISR2_AN_ERR_EN		BIT(6)
+#define	DP83822_MISR2_INT_MASK		0xFF
+#define	DP83822_MISR2_INT_STS_SHIFT	8
+
+static int dp_service(struct mii_softc*, struct mii_data*, int);
+static void dp_status(struct mii_softc*);
+
+struct dp83822_softc {
+	struct mii_softc mii_sc;
+	struct resource *irq_res;
+	void 		*irq_cookie;
+};
+
+static const struct mii_phydesc dpphys[] = {
+	MII_PHY_DESC(xxTI, DP83822)
+};
+
+static const struct mii_phy_funcs dpphy_funcs = {
+	dp_service,
+	ukphy_status,
+	mii_phy_reset
+};
+
+static void
+dp_intr(void *arg)
+{
+	struct mii_softc *sc = (struct mii_softc *)arg;
+	uint32_t status;
+
+	status = PHY_READ(sc, DP83822_MISR1);
+
+	if (!((status >> DP83822_MISR1_INT_STS_SHIFT) &
+	    (status & DP83822_MISR1_INT_MASK)))
+		return;
+
+	PHY_STATUS(sc);
+	mii_phy_update(sc, MII_MEDIACHG);
+}
+
+static int
+dp_probe(device_t dev)
+{
+
+	return (mii_phy_dev_probe(dev, dpphys, BUS_PROBE_DEFAULT));
+}
+
+static int
+dp_attach(device_t dev)
+{
+	struct dp83822_softc *sc;
+	struct mii_softc *mii_sc;
+	uint32_t value;
+	int error, rid;
+
+	sc = device_get_softc(dev);
+	mii_sc = &sc->mii_sc;
+	mii_phy_dev_attach(dev, MIIF_NOMANPAUSE, &dpphy_funcs, 1);
+
+	PHY_RESET(mii_sc);
+
+	rid = 0;
+	sc->irq_res = bus_alloc_resource_any(dev, SYS_RES_IRQ, &rid, RF_ACTIVE);
+	if (sc->irq_res == NULL)
+		goto no_irq;
+
+	error = bus_setup_intr(dev, sc->irq_res, INTR_TYPE_NET | INTR_MPSAFE,
+	    NULL, dp_intr, sc, &sc->irq_cookie);
+	if (error != 0) {
+		bus_release_resource(dev, SYS_RES_IRQ, 0, sc->irq_res);
+		sc->irq_res = NULL;
+		goto no_irq;
+	}
+
+	/*
+	 * ACK and unmask all relevant interrupts.
+	 * We have a single register that serves the purpose
+	 * of both interrupt status and mask.
+	 * Interrupts are cleared on read.
+	 */
+	(void)PHY_READ(mii_sc, DP83822_MISR1);
+	value = DP83822_MISR1_AN_CMPL_EN |
+		DP83822_MISR1_DP_CHG_EN  |
+		DP83822_MISR1_SPD_CHG_EN |
+		DP83822_MISR1_LINK_CHG_EN;
+	PHY_WRITE(mii_sc, DP83822_MISR1, value);
+	value = PHY_READ(mii_sc, DP83822_PHYSCR);
+	value |= DP83822_PHYSCR_INT_OE |
+		 DP83822_PHYSCR_INT_EN;
+	PHY_WRITE(mii_sc, DP83822_PHYSCR, value);
+
+no_irq:
+	return (0);
+}
+
+static int
+dp_detach(device_t dev)
+{
+	struct dp83822_softc *sc;
+
+	sc = device_get_softc(dev);
+
+	bus_teardown_intr(dev, sc->irq_res, sc->irq_cookie);
+	bus_release_resource(dev, SYS_RES_IRQ, 0, sc->irq_res);
+
+	return (mii_phy_detach(dev));
+}
+
+static int
+dp_service(struct mii_softc *sc, struct mii_data *mii, int cmd)
+{
+
+	switch (cmd) {
+	case MII_POLLSTAT:
+		break;
+	case MII_MEDIACHG:
+		mii_phy_setmedia(sc);
+		break;
+	case MII_TICK:
+		if (mii_phy_tick(sc) == EJUSTRETURN)
+			return (0);
+
+		break;
+	}
+
+	PHY_STATUS(sc);
+	mii_phy_update(sc, cmd);
+	return (0);
+}
+
+static device_method_t dp_methods[] = {
+	DEVMETHOD(device_probe,         dp_probe),
+	DEVMETHOD(device_attach,        dp_attach),
+	DEVMETHOD(device_detach,        dp_detach),
+	DEVMETHOD_END
+};
+
+static devclass_t dp_devclass;
+
+static driver_t dp_driver = {
+	"dp83822phy",
+	dp_methods,
+	sizeof(struct dp83822_softc)
+};
+
+DRIVER_MODULE(dp83822phy, miibus, dp_driver, dp_devclass, 0, 0);
diff --git a/sys/dev/mii/miidevs b/sys/dev/mii/miidevs
index 446b0827997c..b2b446637b2e 100644
--- a/sys/dev/mii/miidevs
+++ b/sys/dev/mii/miidevs
@@ -337,6 +337,7 @@ model TI TLAN10T		0x0001 ThunderLAN 10BASE-T media interface
 model TI 100VGPMI		0x0002 ThunderLAN 100VG-AnyLan media interface
 model TI TNETE2101		0x0003 TNETE2101 media interface
 model xxTI DP83867		0x0023 High Immunity 10/100/1000 PHY
+model xxTI DP83822		0x0024 High Immunity 10/100 PHY
 
 /* TDK Semiconductor PHYs */
 model xxTSC 78Q2120		0x0014 78Q2120 10/100 media interface