3 * Ben Gray <bgray@freebsd.org>.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
31 * SMSC LAN9xxx devices (http://www.smsc.com/)
33 * The LAN9500 & LAN9500A devices are stand-alone USB to Ethernet chips that
34 * support USB 2.0 and 10/100 Mbps Ethernet.
36 * The LAN951x devices are an integrated USB hub and USB to Ethernet adapter.
37 * The driver only covers the Ethernet part, the standard USB hub driver
38 * supports the hub part.
40 * This driver is closely modelled on the Linux driver written and copyrighted
46 * H/W TCP & UDP Checksum Offloading
47 * ---------------------------------
48 * The chip supports both tx and rx offloading of UDP & TCP checksums, this
49 * feature can be dynamically enabled/disabled.
51 * RX checksuming is performed across bytes after the IPv4 header to the end of
52 * the Ethernet frame, this means if the frame is padded with non-zero values
53 * the H/W checksum will be incorrect, however the rx code compensates for this.
55 * TX checksuming is more complicated, the device requires a special header to
56 * be prefixed onto the start of the frame which indicates the start and end
57 * positions of the UDP or TCP frame. This requires the driver to manually
58 * go through the packet data and decode the headers prior to sending.
59 * On Linux they generally provide cues to the location of the csum and the
60 * area to calculate it over, on FreeBSD we seem to have to do it all ourselves,
61 * hence this is not as optimal and therefore h/w tX checksum is currently not
65 #include <sys/stdint.h>
66 #include <sys/stddef.h>
67 #include <sys/param.h>
68 #include <sys/queue.h>
69 #include <sys/types.h>
70 #include <sys/systm.h>
71 #include <sys/kernel.h>
73 #include <sys/module.h>
75 #include <sys/mutex.h>
76 #include <sys/condvar.h>
77 #include <sys/socket.h>
78 #include <sys/sysctl.h>
80 #include <sys/unistd.h>
81 #include <sys/callout.h>
82 #include <sys/malloc.h>
84 #include <sys/random.h>
87 #include <net/if_var.h>
89 #include <netinet/in.h>
90 #include <netinet/ip.h>
92 #include "opt_platform.h"
95 #include <dev/fdt/fdt_common.h>
96 #include <dev/ofw/ofw_bus.h>
97 #include <dev/ofw/ofw_bus_subr.h>
100 #include <dev/usb/usb.h>
101 #include <dev/usb/usbdi.h>
102 #include <dev/usb/usbdi_util.h>
105 #define USB_DEBUG_VAR smsc_debug
106 #include <dev/usb/usb_debug.h>
107 #include <dev/usb/usb_process.h>
109 #include <dev/usb/net/usb_ethernet.h>
111 #include <dev/usb/net/if_smscreg.h>
114 static int smsc_debug = 0;
116 SYSCTL_NODE(_hw_usb, OID_AUTO, smsc, CTLFLAG_RW, 0, "USB smsc");
117 SYSCTL_INT(_hw_usb_smsc, OID_AUTO, debug, CTLFLAG_RWTUN, &smsc_debug, 0,
122 * Various supported device vendors/products.
124 static const struct usb_device_id smsc_devs[] = {
125 #define SMSC_DEV(p,i) { USB_VPI(USB_VENDOR_SMC2, USB_PRODUCT_SMC2_##p, i) }
126 SMSC_DEV(LAN89530_ETH, 0),
127 SMSC_DEV(LAN9500_ETH, 0),
128 SMSC_DEV(LAN9500_ETH_2, 0),
129 SMSC_DEV(LAN9500A_ETH, 0),
130 SMSC_DEV(LAN9500A_ETH_2, 0),
131 SMSC_DEV(LAN9505_ETH, 0),
132 SMSC_DEV(LAN9505A_ETH, 0),
133 SMSC_DEV(LAN9514_ETH, 0),
134 SMSC_DEV(LAN9514_ETH_2, 0),
135 SMSC_DEV(LAN9530_ETH, 0),
136 SMSC_DEV(LAN9730_ETH, 0),
137 SMSC_DEV(LAN9500_SAL10, 0),
138 SMSC_DEV(LAN9505_SAL10, 0),
139 SMSC_DEV(LAN9500A_SAL10, 0),
140 SMSC_DEV(LAN9505A_SAL10, 0),
141 SMSC_DEV(LAN9514_SAL10, 0),
142 SMSC_DEV(LAN9500A_HAL, 0),
143 SMSC_DEV(LAN9505A_HAL, 0),
149 #define smsc_dbg_printf(sc, fmt, args...) \
151 if (smsc_debug > 0) \
152 device_printf((sc)->sc_ue.ue_dev, "debug: " fmt, ##args); \
155 #define smsc_dbg_printf(sc, fmt, args...) do { } while (0)
158 #define smsc_warn_printf(sc, fmt, args...) \
159 device_printf((sc)->sc_ue.ue_dev, "warning: " fmt, ##args)
161 #define smsc_err_printf(sc, fmt, args...) \
162 device_printf((sc)->sc_ue.ue_dev, "error: " fmt, ##args)
165 #define ETHER_IS_ZERO(addr) \
166 (!(addr[0] | addr[1] | addr[2] | addr[3] | addr[4] | addr[5]))
168 #define ETHER_IS_VALID(addr) \
169 (!ETHER_IS_MULTICAST(addr) && !ETHER_IS_ZERO(addr))
171 static device_probe_t smsc_probe;
172 static device_attach_t smsc_attach;
173 static device_detach_t smsc_detach;
175 static usb_callback_t smsc_bulk_read_callback;
176 static usb_callback_t smsc_bulk_write_callback;
178 static miibus_readreg_t smsc_miibus_readreg;
179 static miibus_writereg_t smsc_miibus_writereg;
180 static miibus_statchg_t smsc_miibus_statchg;
182 #if __FreeBSD_version > 1000000
183 static int smsc_attach_post_sub(struct usb_ether *ue);
185 static uether_fn_t smsc_attach_post;
186 static uether_fn_t smsc_init;
187 static uether_fn_t smsc_stop;
188 static uether_fn_t smsc_start;
189 static uether_fn_t smsc_tick;
190 static uether_fn_t smsc_setmulti;
191 static uether_fn_t smsc_setpromisc;
193 static int smsc_ifmedia_upd(struct ifnet *);
194 static void smsc_ifmedia_sts(struct ifnet *, struct ifmediareq *);
196 static int smsc_chip_init(struct smsc_softc *sc);
197 static int smsc_ioctl(struct ifnet *ifp, u_long cmd, caddr_t data);
199 static const struct usb_config smsc_config[SMSC_N_TRANSFER] = {
201 [SMSC_BULK_DT_WR] = {
203 .endpoint = UE_ADDR_ANY,
204 .direction = UE_DIR_OUT,
206 .bufsize = 16 * (MCLBYTES + 16),
207 .flags = {.pipe_bof = 1,.force_short_xfer = 1,},
208 .callback = smsc_bulk_write_callback,
209 .timeout = 10000, /* 10 seconds */
212 [SMSC_BULK_DT_RD] = {
214 .endpoint = UE_ADDR_ANY,
215 .direction = UE_DIR_IN,
216 .bufsize = 20480, /* bytes */
217 .flags = {.pipe_bof = 1,.short_xfer_ok = 1,},
218 .callback = smsc_bulk_read_callback,
219 .timeout = 0, /* no timeout */
222 /* The SMSC chip supports an interrupt endpoints, however they aren't
223 * needed as we poll on the MII status.
227 static const struct usb_ether_methods smsc_ue_methods = {
228 .ue_attach_post = smsc_attach_post,
229 #if __FreeBSD_version > 1000000
230 .ue_attach_post_sub = smsc_attach_post_sub,
232 .ue_start = smsc_start,
233 .ue_ioctl = smsc_ioctl,
234 .ue_init = smsc_init,
235 .ue_stop = smsc_stop,
236 .ue_tick = smsc_tick,
237 .ue_setmulti = smsc_setmulti,
238 .ue_setpromisc = smsc_setpromisc,
239 .ue_mii_upd = smsc_ifmedia_upd,
240 .ue_mii_sts = smsc_ifmedia_sts,
244 * smsc_read_reg - Reads a 32-bit register on the device
245 * @sc: driver soft context
246 * @off: offset of the register
247 * @data: pointer a value that will be populated with the register value
250 * The device lock must be held before calling this function.
253 * 0 on success, a USB_ERR_?? error code on failure.
256 smsc_read_reg(struct smsc_softc *sc, uint32_t off, uint32_t *data)
258 struct usb_device_request req;
262 SMSC_LOCK_ASSERT(sc, MA_OWNED);
264 req.bmRequestType = UT_READ_VENDOR_DEVICE;
265 req.bRequest = SMSC_UR_READ_REG;
266 USETW(req.wValue, 0);
267 USETW(req.wIndex, off);
268 USETW(req.wLength, 4);
270 err = uether_do_request(&sc->sc_ue, &req, &buf, 1000);
272 smsc_warn_printf(sc, "Failed to read register 0x%0x\n", off);
274 *data = le32toh(buf);
280 * smsc_write_reg - Writes a 32-bit register on the device
281 * @sc: driver soft context
282 * @off: offset of the register
283 * @data: the 32-bit value to write into the register
286 * The device lock must be held before calling this function.
289 * 0 on success, a USB_ERR_?? error code on failure.
292 smsc_write_reg(struct smsc_softc *sc, uint32_t off, uint32_t data)
294 struct usb_device_request req;
298 SMSC_LOCK_ASSERT(sc, MA_OWNED);
302 req.bmRequestType = UT_WRITE_VENDOR_DEVICE;
303 req.bRequest = SMSC_UR_WRITE_REG;
304 USETW(req.wValue, 0);
305 USETW(req.wIndex, off);
306 USETW(req.wLength, 4);
308 err = uether_do_request(&sc->sc_ue, &req, &buf, 1000);
310 smsc_warn_printf(sc, "Failed to write register 0x%0x\n", off);
316 * smsc_wait_for_bits - Polls on a register value until bits are cleared
318 * @reg: offset of the register
319 * @bits: if the bits are clear the function returns
322 * The device lock must be held before calling this function.
325 * 0 on success, or a USB_ERR_?? error code on failure.
328 smsc_wait_for_bits(struct smsc_softc *sc, uint32_t reg, uint32_t bits)
330 usb_ticks_t start_ticks;
331 const usb_ticks_t max_ticks = USB_MS_TO_TICKS(1000);
335 SMSC_LOCK_ASSERT(sc, MA_OWNED);
337 start_ticks = (usb_ticks_t)ticks;
339 if ((err = smsc_read_reg(sc, reg, &val)) != 0)
344 uether_pause(&sc->sc_ue, hz / 100);
345 } while (((usb_ticks_t)(ticks - start_ticks)) < max_ticks);
347 return (USB_ERR_TIMEOUT);
351 * smsc_eeprom_read - Reads the attached EEPROM
353 * @off: the eeprom address offset
354 * @buf: stores the bytes
355 * @buflen: the number of bytes to read
357 * Simply reads bytes from an attached eeprom.
360 * The function takes and releases the device lock if it is not already held.
363 * 0 on success, or a USB_ERR_?? error code on failure.
366 smsc_eeprom_read(struct smsc_softc *sc, uint16_t off, uint8_t *buf, uint16_t buflen)
368 usb_ticks_t start_ticks;
369 const usb_ticks_t max_ticks = USB_MS_TO_TICKS(1000);
375 locked = mtx_owned(&sc->sc_mtx);
379 err = smsc_wait_for_bits(sc, SMSC_EEPROM_CMD, SMSC_EEPROM_CMD_BUSY);
381 smsc_warn_printf(sc, "eeprom busy, failed to read data\n");
385 /* start reading the bytes, one at a time */
386 for (i = 0; i < buflen; i++) {
388 val = SMSC_EEPROM_CMD_BUSY | (SMSC_EEPROM_CMD_ADDR_MASK & (off + i));
389 if ((err = smsc_write_reg(sc, SMSC_EEPROM_CMD, val)) != 0)
392 start_ticks = (usb_ticks_t)ticks;
394 if ((err = smsc_read_reg(sc, SMSC_EEPROM_CMD, &val)) != 0)
396 if (!(val & SMSC_EEPROM_CMD_BUSY) || (val & SMSC_EEPROM_CMD_TIMEOUT))
399 uether_pause(&sc->sc_ue, hz / 100);
400 } while (((usb_ticks_t)(ticks - start_ticks)) < max_ticks);
402 if (val & (SMSC_EEPROM_CMD_BUSY | SMSC_EEPROM_CMD_TIMEOUT)) {
403 smsc_warn_printf(sc, "eeprom command failed\n");
404 err = USB_ERR_IOERROR;
408 if ((err = smsc_read_reg(sc, SMSC_EEPROM_DATA, &val)) != 0)
411 buf[i] = (val & 0xff);
422 * smsc_miibus_readreg - Reads a MII/MDIO register
423 * @dev: usb ether device
424 * @phy: the number of phy reading from
425 * @reg: the register address
427 * Attempts to read a phy register over the MII bus.
430 * Takes and releases the device mutex lock if not already held.
433 * Returns the 16-bits read from the MII register, if this function fails 0
437 smsc_miibus_readreg(device_t dev, int phy, int reg)
439 struct smsc_softc *sc = device_get_softc(dev);
444 locked = mtx_owned(&sc->sc_mtx);
448 if (smsc_wait_for_bits(sc, SMSC_MII_ADDR, SMSC_MII_BUSY) != 0) {
449 smsc_warn_printf(sc, "MII is busy\n");
453 addr = (phy << 11) | (reg << 6) | SMSC_MII_READ;
454 smsc_write_reg(sc, SMSC_MII_ADDR, addr);
456 if (smsc_wait_for_bits(sc, SMSC_MII_ADDR, SMSC_MII_BUSY) != 0)
457 smsc_warn_printf(sc, "MII read timeout\n");
459 smsc_read_reg(sc, SMSC_MII_DATA, &val);
466 return (val & 0xFFFF);
470 * smsc_miibus_writereg - Writes a MII/MDIO register
471 * @dev: usb ether device
472 * @phy: the number of phy writing to
473 * @reg: the register address
474 * @val: the value to write
476 * Attempts to write a phy register over the MII bus.
479 * Takes and releases the device mutex lock if not already held.
482 * Always returns 0 regardless of success or failure.
485 smsc_miibus_writereg(device_t dev, int phy, int reg, int val)
487 struct smsc_softc *sc = device_get_softc(dev);
491 if (sc->sc_phyno != phy)
494 locked = mtx_owned(&sc->sc_mtx);
498 if (smsc_wait_for_bits(sc, SMSC_MII_ADDR, SMSC_MII_BUSY) != 0) {
499 smsc_warn_printf(sc, "MII is busy\n");
504 smsc_write_reg(sc, SMSC_MII_DATA, val);
506 addr = (phy << 11) | (reg << 6) | SMSC_MII_WRITE;
507 smsc_write_reg(sc, SMSC_MII_ADDR, addr);
509 if (smsc_wait_for_bits(sc, SMSC_MII_ADDR, SMSC_MII_BUSY) != 0)
510 smsc_warn_printf(sc, "MII write timeout\n");
521 * smsc_miibus_statchg - Called to detect phy status change
522 * @dev: usb ether device
524 * This function is called periodically by the system to poll for status
525 * changes of the link.
528 * Takes and releases the device mutex lock if not already held.
531 smsc_miibus_statchg(device_t dev)
533 struct smsc_softc *sc = device_get_softc(dev);
534 struct mii_data *mii = uether_getmii(&sc->sc_ue);
541 locked = mtx_owned(&sc->sc_mtx);
545 ifp = uether_getifp(&sc->sc_ue);
546 if (mii == NULL || ifp == NULL ||
547 (ifp->if_drv_flags & IFF_DRV_RUNNING) == 0)
550 /* Use the MII status to determine link status */
551 sc->sc_flags &= ~SMSC_FLAG_LINK;
552 if ((mii->mii_media_status & (IFM_ACTIVE | IFM_AVALID)) ==
553 (IFM_ACTIVE | IFM_AVALID)) {
554 switch (IFM_SUBTYPE(mii->mii_media_active)) {
557 sc->sc_flags |= SMSC_FLAG_LINK;
560 /* Gigabit ethernet not supported by chipset */
567 /* Lost link, do nothing. */
568 if ((sc->sc_flags & SMSC_FLAG_LINK) == 0) {
569 smsc_dbg_printf(sc, "link flag not set\n");
573 err = smsc_read_reg(sc, SMSC_AFC_CFG, &afc_cfg);
575 smsc_warn_printf(sc, "failed to read initial AFC_CFG, error %d\n", err);
579 /* Enable/disable full duplex operation and TX/RX pause */
580 if ((IFM_OPTIONS(mii->mii_media_active) & IFM_FDX) != 0) {
581 smsc_dbg_printf(sc, "full duplex operation\n");
582 sc->sc_mac_csr &= ~SMSC_MAC_CSR_RCVOWN;
583 sc->sc_mac_csr |= SMSC_MAC_CSR_FDPX;
585 if ((IFM_OPTIONS(mii->mii_media_active) & IFM_ETH_RXPAUSE) != 0)
590 if ((IFM_OPTIONS(mii->mii_media_active) & IFM_ETH_TXPAUSE) != 0)
596 smsc_dbg_printf(sc, "half duplex operation\n");
597 sc->sc_mac_csr &= ~SMSC_MAC_CSR_FDPX;
598 sc->sc_mac_csr |= SMSC_MAC_CSR_RCVOWN;
604 err = smsc_write_reg(sc, SMSC_MAC_CSR, sc->sc_mac_csr);
605 err += smsc_write_reg(sc, SMSC_FLOW, flow);
606 err += smsc_write_reg(sc, SMSC_AFC_CFG, afc_cfg);
608 smsc_warn_printf(sc, "media change failed, error %d\n", err);
616 * smsc_ifmedia_upd - Set media options
617 * @ifp: interface pointer
619 * Basically boilerplate code that simply calls the mii functions to set the
623 * The device lock must be held before this function is called.
626 * Returns 0 on success or a negative error code.
629 smsc_ifmedia_upd(struct ifnet *ifp)
631 struct smsc_softc *sc = ifp->if_softc;
632 struct mii_data *mii = uether_getmii(&sc->sc_ue);
633 struct mii_softc *miisc;
636 SMSC_LOCK_ASSERT(sc, MA_OWNED);
638 LIST_FOREACH(miisc, &mii->mii_phys, mii_list)
640 err = mii_mediachg(mii);
645 * smsc_ifmedia_sts - Report current media status
646 * @ifp: inet interface pointer
647 * @ifmr: interface media request
649 * Basically boilerplate code that simply calls the mii functions to get the
653 * Internally takes and releases the device lock.
656 smsc_ifmedia_sts(struct ifnet *ifp, struct ifmediareq *ifmr)
658 struct smsc_softc *sc = ifp->if_softc;
659 struct mii_data *mii = uether_getmii(&sc->sc_ue);
663 ifmr->ifm_active = mii->mii_media_active;
664 ifmr->ifm_status = mii->mii_media_status;
669 * smsc_hash - Calculate the hash of a mac address
670 * @addr: The mac address to calculate the hash on
672 * This function is used when configuring a range of m'cast mac addresses to
673 * filter on. The hash of the mac address is put in the device's mac hash
677 * Returns a value from 0-63 value which is the hash of the mac address.
679 static inline uint32_t
680 smsc_hash(uint8_t addr[ETHER_ADDR_LEN])
682 return (ether_crc32_be(addr, ETHER_ADDR_LEN) >> 26) & 0x3f;
686 * smsc_setmulti - Setup multicast
687 * @ue: usb ethernet device context
689 * Tells the device to either accept frames with a multicast mac address, a
690 * select group of m'cast mac addresses or just the devices mac address.
693 * Should be called with the SMSC lock held.
696 smsc_setmulti(struct usb_ether *ue)
698 struct smsc_softc *sc = uether_getsc(ue);
699 struct ifnet *ifp = uether_getifp(ue);
700 struct ifmultiaddr *ifma;
701 uint32_t hashtbl[2] = { 0, 0 };
704 SMSC_LOCK_ASSERT(sc, MA_OWNED);
706 if (ifp->if_flags & (IFF_ALLMULTI | IFF_PROMISC)) {
707 smsc_dbg_printf(sc, "receive all multicast enabled\n");
708 sc->sc_mac_csr |= SMSC_MAC_CSR_MCPAS;
709 sc->sc_mac_csr &= ~SMSC_MAC_CSR_HPFILT;
712 /* Take the lock of the mac address list before hashing each of them */
715 if (!TAILQ_EMPTY(&ifp->if_multiaddrs)) {
716 /* We are filtering on a set of address so calculate hashes of each
717 * of the address and set the corresponding bits in the register.
719 sc->sc_mac_csr |= SMSC_MAC_CSR_HPFILT;
720 sc->sc_mac_csr &= ~(SMSC_MAC_CSR_PRMS | SMSC_MAC_CSR_MCPAS);
722 TAILQ_FOREACH(ifma, &ifp->if_multiaddrs, ifma_link) {
723 if (ifma->ifma_addr->sa_family != AF_LINK)
726 hash = smsc_hash(LLADDR((struct sockaddr_dl *)ifma->ifma_addr));
727 hashtbl[hash >> 5] |= 1 << (hash & 0x1F);
730 /* Only receive packets with destination set to our mac address */
731 sc->sc_mac_csr &= ~(SMSC_MAC_CSR_MCPAS | SMSC_MAC_CSR_HPFILT);
734 if_maddr_runlock(ifp);
737 if (sc->sc_mac_csr & SMSC_MAC_CSR_HPFILT)
738 smsc_dbg_printf(sc, "receive select group of macs\n");
740 smsc_dbg_printf(sc, "receive own packets only\n");
743 /* Write the hash table and mac control registers */
744 smsc_write_reg(sc, SMSC_HASHH, hashtbl[1]);
745 smsc_write_reg(sc, SMSC_HASHL, hashtbl[0]);
746 smsc_write_reg(sc, SMSC_MAC_CSR, sc->sc_mac_csr);
751 * smsc_setpromisc - Enables/disables promiscuous mode
752 * @ue: usb ethernet device context
755 * Should be called with the SMSC lock held.
758 smsc_setpromisc(struct usb_ether *ue)
760 struct smsc_softc *sc = uether_getsc(ue);
761 struct ifnet *ifp = uether_getifp(ue);
763 smsc_dbg_printf(sc, "promiscuous mode %sabled\n",
764 (ifp->if_flags & IFF_PROMISC) ? "en" : "dis");
766 SMSC_LOCK_ASSERT(sc, MA_OWNED);
768 if (ifp->if_flags & IFF_PROMISC)
769 sc->sc_mac_csr |= SMSC_MAC_CSR_PRMS;
771 sc->sc_mac_csr &= ~SMSC_MAC_CSR_PRMS;
773 smsc_write_reg(sc, SMSC_MAC_CSR, sc->sc_mac_csr);
778 * smsc_sethwcsum - Enable or disable H/W UDP and TCP checksumming
779 * @sc: driver soft context
782 * Should be called with the SMSC lock held.
785 * Returns 0 on success or a negative error code.
787 static int smsc_sethwcsum(struct smsc_softc *sc)
789 struct ifnet *ifp = uether_getifp(&sc->sc_ue);
796 SMSC_LOCK_ASSERT(sc, MA_OWNED);
798 err = smsc_read_reg(sc, SMSC_COE_CTRL, &val);
800 smsc_warn_printf(sc, "failed to read SMSC_COE_CTRL (err=%d)\n", err);
804 /* Enable/disable the Rx checksum */
805 if ((ifp->if_capabilities & ifp->if_capenable) & IFCAP_RXCSUM)
806 val |= SMSC_COE_CTRL_RX_EN;
808 val &= ~SMSC_COE_CTRL_RX_EN;
810 /* Enable/disable the Tx checksum (currently not supported) */
811 if ((ifp->if_capabilities & ifp->if_capenable) & IFCAP_TXCSUM)
812 val |= SMSC_COE_CTRL_TX_EN;
814 val &= ~SMSC_COE_CTRL_TX_EN;
816 err = smsc_write_reg(sc, SMSC_COE_CTRL, val);
818 smsc_warn_printf(sc, "failed to write SMSC_COE_CTRL (err=%d)\n", err);
826 * smsc_setmacaddress - Sets the mac address in the device
827 * @sc: driver soft context
828 * @addr: pointer to array contain at least 6 bytes of the mac
830 * Writes the MAC address into the device, usually the MAC is programmed with
831 * values from the EEPROM.
834 * Should be called with the SMSC lock held.
837 * Returns 0 on success or a negative error code.
840 smsc_setmacaddress(struct smsc_softc *sc, const uint8_t *addr)
845 smsc_dbg_printf(sc, "setting mac address to %02x:%02x:%02x:%02x:%02x:%02x\n",
846 addr[0], addr[1], addr[2], addr[3], addr[4], addr[5]);
848 SMSC_LOCK_ASSERT(sc, MA_OWNED);
850 val = (addr[3] << 24) | (addr[2] << 16) | (addr[1] << 8) | addr[0];
851 if ((err = smsc_write_reg(sc, SMSC_MAC_ADDRL, val)) != 0)
854 val = (addr[5] << 8) | addr[4];
855 err = smsc_write_reg(sc, SMSC_MAC_ADDRH, val);
862 * smsc_reset - Reset the SMSC chip
863 * @sc: device soft context
866 * Should be called with the SMSC lock held.
869 smsc_reset(struct smsc_softc *sc)
871 struct usb_config_descriptor *cd;
874 cd = usbd_get_config_descriptor(sc->sc_ue.ue_udev);
876 err = usbd_req_set_config(sc->sc_ue.ue_udev, &sc->sc_mtx,
877 cd->bConfigurationValue);
879 smsc_warn_printf(sc, "reset failed (ignored)\n");
881 /* Wait a little while for the chip to get its brains in order. */
882 uether_pause(&sc->sc_ue, hz / 100);
884 /* Reinitialize controller to achieve full reset. */
890 * smsc_init - Initialises the LAN95xx chip
891 * @ue: USB ether interface
893 * Called when the interface is brought up (i.e. ifconfig ue0 up), this
894 * initialise the interface and the rx/tx pipes.
897 * Should be called with the SMSC lock held.
900 smsc_init(struct usb_ether *ue)
902 struct smsc_softc *sc = uether_getsc(ue);
903 struct ifnet *ifp = uether_getifp(ue);
905 SMSC_LOCK_ASSERT(sc, MA_OWNED);
907 if (smsc_setmacaddress(sc, IF_LLADDR(ifp)))
908 smsc_dbg_printf(sc, "setting MAC address failed\n");
910 if ((ifp->if_drv_flags & IFF_DRV_RUNNING) != 0)
913 /* Cancel pending I/O */
916 #if __FreeBSD_version <= 1000000
917 /* On earlier versions this was the first place we could tell the system
918 * that we supported h/w csuming, however this is only called after the
919 * the interface has been brought up - not ideal.
921 if (!(ifp->if_capabilities & IFCAP_RXCSUM)) {
922 ifp->if_capabilities |= IFCAP_RXCSUM;
923 ifp->if_capenable |= IFCAP_RXCSUM;
924 ifp->if_hwassist = 0;
927 /* TX checksuming is disabled for now
928 ifp->if_capabilities |= IFCAP_TXCSUM;
929 ifp->if_capenable |= IFCAP_TXCSUM;
930 ifp->if_hwassist = CSUM_TCP | CSUM_UDP;
934 /* Reset the ethernet interface. */
937 /* Load the multicast filter. */
940 /* TCP/UDP checksum offload engines. */
943 usbd_xfer_set_stall(sc->sc_xfer[SMSC_BULK_DT_WR]);
945 /* Indicate we are up and running. */
946 ifp->if_drv_flags |= IFF_DRV_RUNNING;
948 /* Switch to selected media. */
949 smsc_ifmedia_upd(ifp);
954 * smsc_bulk_read_callback - Read callback used to process the USB URB
955 * @xfer: the USB transfer
958 * Reads the URB data which can contain one or more ethernet frames, the
959 * frames are copyed into a mbuf and given to the system.
962 * No locking required, doesn't access internal driver settings.
965 smsc_bulk_read_callback(struct usb_xfer *xfer, usb_error_t error)
967 struct smsc_softc *sc = usbd_xfer_softc(xfer);
968 struct usb_ether *ue = &sc->sc_ue;
969 struct ifnet *ifp = uether_getifp(ue);
971 struct usb_page_cache *pc;
977 usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL);
978 smsc_dbg_printf(sc, "rx : actlen %d\n", actlen);
980 switch (USB_GET_STATE(xfer)) {
981 case USB_ST_TRANSFERRED:
983 /* There is always a zero length frame after bringing the IF up */
984 if (actlen < (sizeof(rxhdr) + ETHER_CRC_LEN))
987 /* There maybe multiple packets in the USB frame, each will have a
988 * header and each needs to have it's own mbuf allocated and populated
991 pc = usbd_xfer_get_frame(xfer, 0);
994 while (off < actlen) {
996 /* The frame header is always aligned on a 4 byte boundary */
997 off = ((off + 0x3) & ~0x3);
999 if ((off + sizeof(rxhdr)) > actlen)
1002 usbd_copy_out(pc, off, &rxhdr, sizeof(rxhdr));
1003 off += (sizeof(rxhdr) + ETHER_ALIGN);
1004 rxhdr = le32toh(rxhdr);
1006 pktlen = (uint16_t)SMSC_RX_STAT_FRM_LENGTH(rxhdr);
1008 smsc_dbg_printf(sc, "rx : rxhdr 0x%08x : pktlen %d : actlen %d : "
1009 "off %d\n", rxhdr, pktlen, actlen, off);
1012 if (rxhdr & SMSC_RX_STAT_ERROR) {
1013 smsc_dbg_printf(sc, "rx error (hdr 0x%08x)\n", rxhdr);
1014 if_inc_counter(ifp, IFCOUNTER_IERRORS, 1);
1015 if (rxhdr & SMSC_RX_STAT_COLLISION)
1016 if_inc_counter(ifp, IFCOUNTER_COLLISIONS, 1);
1019 /* Check if the ethernet frame is too big or too small */
1020 if ((pktlen < ETHER_HDR_LEN) || (pktlen > (actlen - off)))
1023 /* Create a new mbuf to store the packet in */
1024 m = uether_newbuf();
1026 smsc_warn_printf(sc, "failed to create new mbuf\n");
1027 if_inc_counter(ifp, IFCOUNTER_IQDROPS, 1);
1030 if (pktlen > m->m_len) {
1031 smsc_dbg_printf(sc, "buffer too small %d vs %d bytes",
1033 if_inc_counter(ifp, IFCOUNTER_IQDROPS, 1);
1037 usbd_copy_out(pc, off, mtod(m, uint8_t *), pktlen);
1039 /* Check if RX TCP/UDP checksumming is being offloaded */
1040 if ((ifp->if_capenable & IFCAP_RXCSUM) != 0) {
1042 struct ether_header *eh;
1044 eh = mtod(m, struct ether_header *);
1046 /* Remove the extra 2 bytes of the csum */
1049 /* The checksum appears to be simplistically calculated
1050 * over the udp/tcp header and data up to the end of the
1051 * eth frame. Which means if the eth frame is padded
1052 * the csum calculation is incorrectly performed over
1053 * the padding bytes as well. Therefore to be safe we
1054 * ignore the H/W csum on frames less than or equal to
1057 * Ignore H/W csum for non-IPv4 packets.
1059 if ((be16toh(eh->ether_type) == ETHERTYPE_IP) &&
1060 (pktlen > ETHER_MIN_LEN)) {
1063 ip = (struct ip *)(eh + 1);
1064 if ((ip->ip_v == IPVERSION) &&
1065 ((ip->ip_p == IPPROTO_TCP) ||
1066 (ip->ip_p == IPPROTO_UDP))) {
1067 /* Indicate the UDP/TCP csum has been calculated */
1068 m->m_pkthdr.csum_flags |= CSUM_DATA_VALID;
1070 /* Copy the TCP/UDP checksum from the last 2 bytes
1071 * of the transfer and put in the csum_data field.
1073 usbd_copy_out(pc, (off + pktlen),
1074 &m->m_pkthdr.csum_data, 2);
1076 /* The data is copied in network order, but the
1077 * csum algorithm in the kernel expects it to be
1078 * in host network order.
1080 m->m_pkthdr.csum_data = ntohs(m->m_pkthdr.csum_data);
1082 smsc_dbg_printf(sc, "RX checksum offloaded (0x%04x)\n",
1083 m->m_pkthdr.csum_data);
1087 /* Need to adjust the offset as well or we'll be off
1088 * by 2 because the csum is removed from the packet
1094 /* Finally enqueue the mbuf on the receive queue */
1095 /* Remove 4 trailing bytes */
1096 if (pktlen < (4 + ETHER_HDR_LEN)) {
1100 uether_rxmbuf(ue, m, pktlen - 4);
1103 /* Update the offset to move to the next potential packet */
1111 usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
1112 usbd_transfer_submit(xfer);
1117 if (error != USB_ERR_CANCELLED) {
1118 smsc_warn_printf(sc, "bulk read error, %s\n", usbd_errstr(error));
1119 usbd_xfer_set_stall(xfer);
1127 * smsc_bulk_write_callback - Write callback used to send ethernet frame(s)
1128 * @xfer: the USB transfer
1129 * @error: error code if the transfers is in an errored state
1131 * The main write function that pulls ethernet frames off the queue and sends
1138 smsc_bulk_write_callback(struct usb_xfer *xfer, usb_error_t error)
1140 struct smsc_softc *sc = usbd_xfer_softc(xfer);
1141 struct ifnet *ifp = uether_getifp(&sc->sc_ue);
1142 struct usb_page_cache *pc;
1145 uint32_t frm_len = 0;
1148 switch (USB_GET_STATE(xfer)) {
1149 case USB_ST_TRANSFERRED:
1150 ifp->if_drv_flags &= ~IFF_DRV_OACTIVE;
1155 if ((sc->sc_flags & SMSC_FLAG_LINK) == 0 ||
1156 (ifp->if_drv_flags & IFF_DRV_OACTIVE) != 0) {
1157 /* Don't send anything if there is no link or controller is busy. */
1161 for (nframes = 0; nframes < 16 &&
1162 !IFQ_DRV_IS_EMPTY(&ifp->if_snd); nframes++) {
1163 IFQ_DRV_DEQUEUE(&ifp->if_snd, m);
1166 usbd_xfer_set_frame_offset(xfer, nframes * MCLBYTES,
1169 pc = usbd_xfer_get_frame(xfer, nframes);
1171 /* Each frame is prefixed with two 32-bit values describing the
1172 * length of the packet and buffer.
1174 txhdr = SMSC_TX_CTRL_0_BUF_SIZE(m->m_pkthdr.len) |
1175 SMSC_TX_CTRL_0_FIRST_SEG | SMSC_TX_CTRL_0_LAST_SEG;
1176 txhdr = htole32(txhdr);
1177 usbd_copy_in(pc, 0, &txhdr, sizeof(txhdr));
1179 txhdr = SMSC_TX_CTRL_1_PKT_LENGTH(m->m_pkthdr.len);
1180 txhdr = htole32(txhdr);
1181 usbd_copy_in(pc, 4, &txhdr, sizeof(txhdr));
1185 /* Next copy in the actual packet */
1186 usbd_m_copy_in(pc, frm_len, m, 0, m->m_pkthdr.len);
1187 frm_len += m->m_pkthdr.len;
1189 if_inc_counter(ifp, IFCOUNTER_OPACKETS, 1);
1191 /* If there's a BPF listener, bounce a copy of this frame to him */
1196 /* Set frame length. */
1197 usbd_xfer_set_frame_len(xfer, nframes, frm_len);
1200 usbd_xfer_set_frames(xfer, nframes);
1201 usbd_transfer_submit(xfer);
1202 ifp->if_drv_flags |= IFF_DRV_OACTIVE;
1207 if_inc_counter(ifp, IFCOUNTER_OERRORS, 1);
1208 ifp->if_drv_flags &= ~IFF_DRV_OACTIVE;
1210 if (error != USB_ERR_CANCELLED) {
1211 smsc_err_printf(sc, "usb error on tx: %s\n", usbd_errstr(error));
1212 usbd_xfer_set_stall(xfer);
1220 * smsc_tick - Called periodically to monitor the state of the LAN95xx chip
1221 * @ue: USB ether interface
1223 * Simply calls the mii status functions to check the state of the link.
1226 * Should be called with the SMSC lock held.
1229 smsc_tick(struct usb_ether *ue)
1231 struct smsc_softc *sc = uether_getsc(ue);
1232 struct mii_data *mii = uether_getmii(&sc->sc_ue);
1234 SMSC_LOCK_ASSERT(sc, MA_OWNED);
1237 if ((sc->sc_flags & SMSC_FLAG_LINK) == 0) {
1238 smsc_miibus_statchg(ue->ue_dev);
1239 if ((sc->sc_flags & SMSC_FLAG_LINK) != 0)
1245 * smsc_start - Starts communication with the LAN95xx chip
1246 * @ue: USB ether interface
1252 smsc_start(struct usb_ether *ue)
1254 struct smsc_softc *sc = uether_getsc(ue);
1257 * start the USB transfers, if not already started:
1259 usbd_transfer_start(sc->sc_xfer[SMSC_BULK_DT_RD]);
1260 usbd_transfer_start(sc->sc_xfer[SMSC_BULK_DT_WR]);
1264 * smsc_stop - Stops communication with the LAN95xx chip
1265 * @ue: USB ether interface
1271 smsc_stop(struct usb_ether *ue)
1273 struct smsc_softc *sc = uether_getsc(ue);
1274 struct ifnet *ifp = uether_getifp(ue);
1276 SMSC_LOCK_ASSERT(sc, MA_OWNED);
1278 ifp->if_drv_flags &= ~(IFF_DRV_RUNNING | IFF_DRV_OACTIVE);
1279 sc->sc_flags &= ~SMSC_FLAG_LINK;
1282 * stop all the transfers, if not already stopped:
1284 usbd_transfer_stop(sc->sc_xfer[SMSC_BULK_DT_WR]);
1285 usbd_transfer_stop(sc->sc_xfer[SMSC_BULK_DT_RD]);
1289 * smsc_phy_init - Initialises the in-built SMSC phy
1290 * @sc: driver soft context
1292 * Resets the PHY part of the chip and then initialises it to default
1293 * values. The 'link down' and 'auto-negotiation complete' interrupts
1294 * from the PHY are also enabled, however we don't monitor the interrupt
1295 * endpoints for the moment.
1298 * Returns 0 on success or EIO if failed to reset the PHY.
1301 smsc_phy_init(struct smsc_softc *sc)
1304 usb_ticks_t start_ticks;
1305 const usb_ticks_t max_ticks = USB_MS_TO_TICKS(1000);
1307 SMSC_LOCK_ASSERT(sc, MA_OWNED);
1309 /* Reset phy and wait for reset to complete */
1310 smsc_miibus_writereg(sc->sc_ue.ue_dev, sc->sc_phyno, MII_BMCR, BMCR_RESET);
1312 start_ticks = ticks;
1314 uether_pause(&sc->sc_ue, hz / 100);
1315 bmcr = smsc_miibus_readreg(sc->sc_ue.ue_dev, sc->sc_phyno, MII_BMCR);
1316 } while ((bmcr & MII_BMCR) && ((ticks - start_ticks) < max_ticks));
1318 if (((usb_ticks_t)(ticks - start_ticks)) >= max_ticks) {
1319 smsc_err_printf(sc, "PHY reset timed-out");
1323 smsc_miibus_writereg(sc->sc_ue.ue_dev, sc->sc_phyno, MII_ANAR,
1324 ANAR_10 | ANAR_10_FD | ANAR_TX | ANAR_TX_FD | /* all modes */
1329 /* Setup the phy to interrupt when the link goes down or autoneg completes */
1330 smsc_miibus_readreg(sc->sc_ue.ue_dev, sc->sc_phyno, SMSC_PHY_INTR_STAT);
1331 smsc_miibus_writereg(sc->sc_ue.ue_dev, sc->sc_phyno, SMSC_PHY_INTR_MASK,
1332 (SMSC_PHY_INTR_ANEG_COMP | SMSC_PHY_INTR_LINK_DOWN));
1334 /* Restart auto-negotation */
1335 bmcr = smsc_miibus_readreg(sc->sc_ue.ue_dev, sc->sc_phyno, MII_BMCR);
1336 bmcr |= BMCR_STARTNEG;
1337 smsc_miibus_writereg(sc->sc_ue.ue_dev, sc->sc_phyno, MII_BMCR, bmcr);
1344 * smsc_chip_init - Initialises the chip after power on
1345 * @sc: driver soft context
1347 * This initialisation sequence is modelled on the procedure in the Linux
1351 * Returns 0 on success or an error code on failure.
1354 smsc_chip_init(struct smsc_softc *sc)
1361 locked = mtx_owned(&sc->sc_mtx);
1365 /* Enter H/W config mode */
1366 smsc_write_reg(sc, SMSC_HW_CFG, SMSC_HW_CFG_LRST);
1368 if ((err = smsc_wait_for_bits(sc, SMSC_HW_CFG, SMSC_HW_CFG_LRST)) != 0) {
1369 smsc_warn_printf(sc, "timed-out waiting for reset to complete\n");
1374 smsc_write_reg(sc, SMSC_PM_CTRL, SMSC_PM_CTRL_PHY_RST);
1376 if ((err = smsc_wait_for_bits(sc, SMSC_PM_CTRL, SMSC_PM_CTRL_PHY_RST)) != 0) {
1377 smsc_warn_printf(sc, "timed-out waiting for phy reset to complete\n");
1381 /* Set the mac address */
1382 if ((err = smsc_setmacaddress(sc, sc->sc_ue.ue_eaddr)) != 0) {
1383 smsc_warn_printf(sc, "failed to set the MAC address\n");
1387 /* Don't know what the HW_CFG_BIR bit is, but following the reset sequence
1388 * as used in the Linux driver.
1390 if ((err = smsc_read_reg(sc, SMSC_HW_CFG, ®_val)) != 0) {
1391 smsc_warn_printf(sc, "failed to read HW_CFG: %d\n", err);
1394 reg_val |= SMSC_HW_CFG_BIR;
1395 smsc_write_reg(sc, SMSC_HW_CFG, reg_val);
1397 /* There is a so called 'turbo mode' that the linux driver supports, it
1398 * seems to allow you to jam multiple frames per Rx transaction. By default
1399 * this driver supports that and therefore allows multiple frames per URB.
1401 * The xfer buffer size needs to reflect this as well, therefore based on
1402 * the calculations in the Linux driver the RX bufsize is set to 18944,
1403 * bufsz = (16 * 1024 + 5 * 512)
1405 * Burst capability is the number of URBs that can be in a burst of data/
1408 if (usbd_get_speed(sc->sc_ue.ue_udev) == USB_SPEED_HIGH)
1413 smsc_write_reg(sc, SMSC_BURST_CAP, burst_cap);
1415 /* Set the default bulk in delay (magic value from Linux driver) */
1416 smsc_write_reg(sc, SMSC_BULK_IN_DLY, 0x00002000);
1421 * Initialise the RX interface
1423 if ((err = smsc_read_reg(sc, SMSC_HW_CFG, ®_val)) < 0) {
1424 smsc_warn_printf(sc, "failed to read HW_CFG: (err = %d)\n", err);
1428 /* Adjust the packet offset in the buffer (designed to try and align IP
1429 * header on 4 byte boundary)
1431 reg_val &= ~SMSC_HW_CFG_RXDOFF;
1432 reg_val |= (ETHER_ALIGN << 9) & SMSC_HW_CFG_RXDOFF;
1434 /* The following setings are used for 'turbo mode', a.k.a multiple frames
1435 * per Rx transaction (again info taken form Linux driver).
1437 reg_val |= (SMSC_HW_CFG_MEF | SMSC_HW_CFG_BCE);
1439 smsc_write_reg(sc, SMSC_HW_CFG, reg_val);
1441 /* Clear the status register ? */
1442 smsc_write_reg(sc, SMSC_INTR_STATUS, 0xffffffff);
1444 /* Read and display the revision register */
1445 if ((err = smsc_read_reg(sc, SMSC_ID_REV, &sc->sc_rev_id)) < 0) {
1446 smsc_warn_printf(sc, "failed to read ID_REV (err = %d)\n", err);
1450 device_printf(sc->sc_ue.ue_dev, "chip 0x%04lx, rev. %04lx\n",
1451 (sc->sc_rev_id & SMSC_ID_REV_CHIP_ID_MASK) >> 16,
1452 (sc->sc_rev_id & SMSC_ID_REV_CHIP_REV_MASK));
1454 /* GPIO/LED setup */
1455 reg_val = SMSC_LED_GPIO_CFG_SPD_LED | SMSC_LED_GPIO_CFG_LNK_LED |
1456 SMSC_LED_GPIO_CFG_FDX_LED;
1457 smsc_write_reg(sc, SMSC_LED_GPIO_CFG, reg_val);
1460 * Initialise the TX interface
1462 smsc_write_reg(sc, SMSC_FLOW, 0);
1464 smsc_write_reg(sc, SMSC_AFC_CFG, AFC_CFG_DEFAULT);
1466 /* Read the current MAC configuration */
1467 if ((err = smsc_read_reg(sc, SMSC_MAC_CSR, &sc->sc_mac_csr)) < 0) {
1468 smsc_warn_printf(sc, "failed to read MAC_CSR (err=%d)\n", err);
1473 smsc_write_reg(sc, SMSC_VLAN1, (uint32_t)ETHERTYPE_VLAN);
1476 * Initialise the PHY
1478 if ((err = smsc_phy_init(sc)) != 0)
1485 sc->sc_mac_csr |= SMSC_MAC_CSR_TXEN;
1486 smsc_write_reg(sc, SMSC_MAC_CSR, sc->sc_mac_csr);
1487 smsc_write_reg(sc, SMSC_TX_CFG, SMSC_TX_CFG_ON);
1492 sc->sc_mac_csr |= SMSC_MAC_CSR_RXEN;
1493 smsc_write_reg(sc, SMSC_MAC_CSR, sc->sc_mac_csr);
1504 smsc_err_printf(sc, "smsc_chip_init failed (err=%d)\n", err);
1510 * smsc_ioctl - ioctl function for the device
1511 * @ifp: interface pointer
1512 * @cmd: the ioctl command
1513 * @data: data passed in the ioctl call, typically a pointer to struct ifreq.
1515 * The ioctl routine is overridden to detect change requests for the H/W
1516 * checksum capabilities.
1519 * 0 on success and an error code on failure.
1522 smsc_ioctl(struct ifnet *ifp, u_long cmd, caddr_t data)
1524 struct usb_ether *ue = ifp->if_softc;
1525 struct smsc_softc *sc;
1531 if (cmd == SIOCSIFCAP) {
1533 sc = uether_getsc(ue);
1534 ifr = (struct ifreq *)data;
1541 mask = ifr->ifr_reqcap ^ ifp->if_capenable;
1543 /* Modify the RX CSUM enable bits */
1544 if ((mask & IFCAP_RXCSUM) != 0 &&
1545 (ifp->if_capabilities & IFCAP_RXCSUM) != 0) {
1546 ifp->if_capenable ^= IFCAP_RXCSUM;
1548 if (ifp->if_drv_flags & IFF_DRV_RUNNING) {
1549 ifp->if_drv_flags &= ~IFF_DRV_RUNNING;
1556 #if __FreeBSD_version > 1000000
1563 rc = uether_ioctl(ifp, cmd, data);
1571 * This is FreeBSD-specific compatibility strings for RPi/RPi2
1574 smsc_fdt_find_eth_node(phandle_t start)
1576 phandle_t child, node;
1578 /* Traverse through entire tree to find usb ethernet nodes. */
1579 for (node = OF_child(start); node != 0; node = OF_peer(node)) {
1580 if ((ofw_bus_node_is_compatible(node, "net,ethernet") &&
1581 ofw_bus_node_is_compatible(node, "usb,device")) ||
1582 ofw_bus_node_is_compatible(node, "usb424,ec00"))
1584 child = smsc_fdt_find_eth_node(node);
1593 * Check if node's path is <*>/usb/hub/ethernet
1596 smsc_fdt_is_usb_eth(phandle_t node)
1601 memset(name, 0, sizeof(name));
1602 len = OF_getprop(node, "name", name, sizeof(name));
1606 if (strcmp(name, "ethernet"))
1609 node = OF_parent(node);
1612 len = OF_getprop(node, "name", name, sizeof(name));
1616 if (strcmp(name, "hub"))
1619 node = OF_parent(node);
1622 len = OF_getprop(node, "name", name, sizeof(name));
1626 if (strcmp(name, "usb"))
1633 smsc_fdt_find_eth_node_by_path(phandle_t start)
1635 phandle_t child, node;
1637 /* Traverse through entire tree to find usb ethernet nodes. */
1638 for (node = OF_child(start); node != 0; node = OF_peer(node)) {
1639 if (smsc_fdt_is_usb_eth(node))
1641 child = smsc_fdt_find_eth_node_by_path(node);
1650 * Look through known names that can contain mac address
1651 * return 0 if valid MAC address has been found
1654 smsc_fdt_read_mac_property(phandle_t node, unsigned char *mac)
1658 /* Check if there is property */
1659 if ((len = OF_getproplen(node, "local-mac-address")) > 0) {
1660 if (len != ETHER_ADDR_LEN)
1663 OF_getprop(node, "local-mac-address", mac,
1668 if ((len = OF_getproplen(node, "mac-address")) > 0) {
1669 if (len != ETHER_ADDR_LEN)
1672 OF_getprop(node, "mac-address", mac,
1681 * Get MAC address from FDT blob. Firmware or loader should fill
1682 * mac-address or local-mac-address property. Returns 0 if MAC address
1683 * obtained, error code otherwise.
1686 smsc_fdt_find_mac(unsigned char *mac)
1688 phandle_t node, root;
1690 root = OF_finddevice("/");
1691 node = smsc_fdt_find_eth_node(root);
1693 if (smsc_fdt_read_mac_property(node, mac) == 0)
1698 * If it's not FreeBSD FDT blob for RPi, try more
1699 * generic .../usb/hub/ethernet
1701 node = smsc_fdt_find_eth_node_by_path(root);
1704 return smsc_fdt_read_mac_property(node, mac);
1711 * smsc_attach_post - Called after the driver attached to the USB interface
1712 * @ue: the USB ethernet device
1714 * This is where the chip is intialised for the first time. This is different
1715 * from the smsc_init() function in that that one is designed to setup the
1716 * H/W to match the UE settings and can be called after a reset.
1721 smsc_attach_post(struct usb_ether *ue)
1723 struct smsc_softc *sc = uether_getsc(ue);
1724 uint32_t mac_h, mac_l;
1727 smsc_dbg_printf(sc, "smsc_attach_post\n");
1729 /* Setup some of the basics */
1733 /* Attempt to get the mac address, if an EEPROM is not attached this
1734 * will just return FF:FF:FF:FF:FF:FF, so in such cases we invent a MAC
1735 * address based on urandom.
1737 memset(sc->sc_ue.ue_eaddr, 0xff, ETHER_ADDR_LEN);
1739 /* Check if there is already a MAC address in the register */
1740 if ((smsc_read_reg(sc, SMSC_MAC_ADDRL, &mac_l) == 0) &&
1741 (smsc_read_reg(sc, SMSC_MAC_ADDRH, &mac_h) == 0)) {
1742 sc->sc_ue.ue_eaddr[5] = (uint8_t)((mac_h >> 8) & 0xff);
1743 sc->sc_ue.ue_eaddr[4] = (uint8_t)((mac_h) & 0xff);
1744 sc->sc_ue.ue_eaddr[3] = (uint8_t)((mac_l >> 24) & 0xff);
1745 sc->sc_ue.ue_eaddr[2] = (uint8_t)((mac_l >> 16) & 0xff);
1746 sc->sc_ue.ue_eaddr[1] = (uint8_t)((mac_l >> 8) & 0xff);
1747 sc->sc_ue.ue_eaddr[0] = (uint8_t)((mac_l) & 0xff);
1750 /* MAC address is not set so try to read from EEPROM, if that fails generate
1751 * a random MAC address.
1753 if (!ETHER_IS_VALID(sc->sc_ue.ue_eaddr)) {
1755 err = smsc_eeprom_read(sc, 0x01, sc->sc_ue.ue_eaddr, ETHER_ADDR_LEN);
1757 if ((err != 0) || (!ETHER_IS_VALID(sc->sc_ue.ue_eaddr)))
1758 err = smsc_fdt_find_mac(sc->sc_ue.ue_eaddr);
1760 if ((err != 0) || (!ETHER_IS_VALID(sc->sc_ue.ue_eaddr))) {
1761 read_random(sc->sc_ue.ue_eaddr, ETHER_ADDR_LEN);
1762 sc->sc_ue.ue_eaddr[0] &= ~0x01; /* unicast */
1763 sc->sc_ue.ue_eaddr[0] |= 0x02; /* locally administered */
1767 /* Initialise the chip for the first time */
1773 * smsc_attach_post_sub - Called after the driver attached to the USB interface
1774 * @ue: the USB ethernet device
1776 * Most of this is boilerplate code and copied from the base USB ethernet
1777 * driver. It has been overriden so that we can indicate to the system that
1778 * the chip supports H/W checksumming.
1781 * Returns 0 on success or a negative error code.
1783 #if __FreeBSD_version > 1000000
1785 smsc_attach_post_sub(struct usb_ether *ue)
1787 struct smsc_softc *sc;
1791 sc = uether_getsc(ue);
1793 ifp->if_flags = IFF_BROADCAST | IFF_SIMPLEX | IFF_MULTICAST;
1794 ifp->if_start = uether_start;
1795 ifp->if_ioctl = smsc_ioctl;
1796 ifp->if_init = uether_init;
1797 IFQ_SET_MAXLEN(&ifp->if_snd, ifqmaxlen);
1798 ifp->if_snd.ifq_drv_maxlen = ifqmaxlen;
1799 IFQ_SET_READY(&ifp->if_snd);
1801 /* The chip supports TCP/UDP checksum offloading on TX and RX paths, however
1802 * currently only RX checksum is supported in the driver (see top of file).
1804 ifp->if_capabilities |= IFCAP_RXCSUM | IFCAP_VLAN_MTU;
1805 ifp->if_hwassist = 0;
1807 /* TX checksuming is disabled (for now?)
1808 ifp->if_capabilities |= IFCAP_TXCSUM;
1809 ifp->if_capenable |= IFCAP_TXCSUM;
1810 ifp->if_hwassist = CSUM_TCP | CSUM_UDP;
1813 ifp->if_capenable = ifp->if_capabilities;
1816 error = mii_attach(ue->ue_dev, &ue->ue_miibus, ifp,
1817 uether_ifmedia_upd, ue->ue_methods->ue_mii_sts,
1818 BMSR_DEFCAPMASK, sc->sc_phyno, MII_OFFSET_ANY, 0);
1823 #endif /* __FreeBSD_version > 1000000 */
1827 * smsc_probe - Probe the interface.
1828 * @dev: smsc device handle
1830 * Checks if the device is a match for this driver.
1833 * Returns 0 on success or an error code on failure.
1836 smsc_probe(device_t dev)
1838 struct usb_attach_arg *uaa = device_get_ivars(dev);
1840 if (uaa->usb_mode != USB_MODE_HOST)
1842 if (uaa->info.bConfigIndex != SMSC_CONFIG_INDEX)
1844 if (uaa->info.bIfaceIndex != SMSC_IFACE_IDX)
1847 return (usbd_lookup_id_by_uaa(smsc_devs, sizeof(smsc_devs), uaa));
1852 * smsc_attach - Attach the interface.
1853 * @dev: smsc device handle
1855 * Allocate softc structures, do ifmedia setup and ethernet/BPF attach.
1858 * Returns 0 on success or a negative error code.
1861 smsc_attach(device_t dev)
1863 struct usb_attach_arg *uaa = device_get_ivars(dev);
1864 struct smsc_softc *sc = device_get_softc(dev);
1865 struct usb_ether *ue = &sc->sc_ue;
1866 uint8_t iface_index;
1869 sc->sc_flags = USB_GET_DRIVER_INFO(uaa);
1871 device_set_usb_desc(dev);
1873 mtx_init(&sc->sc_mtx, device_get_nameunit(dev), NULL, MTX_DEF);
1875 /* Setup the endpoints for the SMSC LAN95xx device(s) */
1876 iface_index = SMSC_IFACE_IDX;
1877 err = usbd_transfer_setup(uaa->device, &iface_index, sc->sc_xfer,
1878 smsc_config, SMSC_N_TRANSFER, sc, &sc->sc_mtx);
1880 device_printf(dev, "error: allocating USB transfers failed\n");
1886 ue->ue_udev = uaa->device;
1887 ue->ue_mtx = &sc->sc_mtx;
1888 ue->ue_methods = &smsc_ue_methods;
1890 err = uether_ifattach(ue);
1892 device_printf(dev, "error: could not attach interface\n");
1895 return (0); /* success */
1899 return (ENXIO); /* failure */
1903 * smsc_detach - Detach the interface.
1904 * @dev: smsc device handle
1910 smsc_detach(device_t dev)
1912 struct smsc_softc *sc = device_get_softc(dev);
1913 struct usb_ether *ue = &sc->sc_ue;
1915 usbd_transfer_unsetup(sc->sc_xfer, SMSC_N_TRANSFER);
1916 uether_ifdetach(ue);
1917 mtx_destroy(&sc->sc_mtx);
1922 static device_method_t smsc_methods[] = {
1923 /* Device interface */
1924 DEVMETHOD(device_probe, smsc_probe),
1925 DEVMETHOD(device_attach, smsc_attach),
1926 DEVMETHOD(device_detach, smsc_detach),
1929 DEVMETHOD(bus_print_child, bus_generic_print_child),
1930 DEVMETHOD(bus_driver_added, bus_generic_driver_added),
1933 DEVMETHOD(miibus_readreg, smsc_miibus_readreg),
1934 DEVMETHOD(miibus_writereg, smsc_miibus_writereg),
1935 DEVMETHOD(miibus_statchg, smsc_miibus_statchg),
1940 static driver_t smsc_driver = {
1942 .methods = smsc_methods,
1943 .size = sizeof(struct smsc_softc),
1946 static devclass_t smsc_devclass;
1948 DRIVER_MODULE(smsc, uhub, smsc_driver, smsc_devclass, NULL, 0);
1949 DRIVER_MODULE(miibus, smsc, miibus_driver, miibus_devclass, 0, 0);
1950 MODULE_DEPEND(smsc, uether, 1, 1, 1);
1951 MODULE_DEPEND(smsc, usb, 1, 1, 1);
1952 MODULE_DEPEND(smsc, ether, 1, 1, 1);
1953 MODULE_DEPEND(smsc, miibus, 1, 1, 1);
1954 MODULE_VERSION(smsc, 1);
1955 USB_PNP_HOST_INFO(smsc_devs);