/* $NetBSD: if_url.c,v 1.98 2024/06/30 16:35:19 riastradh Exp $ */ /* * Copyright (c) 2001, 2002 * Shingo WATANABE . 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. 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 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. * */ /* * The RTL8150L(Realtek USB to fast ethernet controller) spec can be found at * ftp://ftp.realtek.com.tw/lancard/data_sheet/8150/8150v14.pdf * ftp://152.104.125.40/lancard/data_sheet/8150/8150v14.pdf */ /* * TODO: * Interrupt Endpoint support * External PHYs * powerhook() support? */ #include __KERNEL_RCSID(0, "$NetBSD: if_url.c,v 1.98 2024/06/30 16:35:19 riastradh Exp $"); #ifdef _KERNEL_OPT #include "opt_inet.h" #include "opt_usb.h" #endif #include #include #ifdef INET #include #include #endif #include #include #include /* Function declarations */ static int url_match(device_t, cfdata_t, void *); static void url_attach(device_t, device_t, void *); CFATTACH_DECL_NEW(url, sizeof(struct usbnet), url_match, url_attach, usbnet_detach, usbnet_activate); static unsigned url_uno_tx_prepare(struct usbnet *, struct mbuf *, struct usbnet_chain *); static void url_uno_rx_loop(struct usbnet *, struct usbnet_chain *, uint32_t); static int url_uno_mii_read_reg(struct usbnet *, int, int, uint16_t *); static int url_uno_mii_write_reg(struct usbnet *, int, int, uint16_t); static void url_uno_stop(struct ifnet *, int); static void url_uno_mii_statchg(struct ifnet *); static int url_uno_init(struct ifnet *); static void url_uno_mcast(struct ifnet *); static void url_reset(struct usbnet *); static int url_csr_read_1(struct usbnet *, int); static int url_csr_read_2(struct usbnet *, int); static int url_csr_write_1(struct usbnet *, int, int); static int url_csr_write_2(struct usbnet *, int, int); static int url_csr_write_4(struct usbnet *, int, int); static int url_mem(struct usbnet *, int, int, void *, int); static const struct usbnet_ops url_ops = { .uno_stop = url_uno_stop, .uno_mcast = url_uno_mcast, .uno_read_reg = url_uno_mii_read_reg, .uno_write_reg = url_uno_mii_write_reg, .uno_statchg = url_uno_mii_statchg, .uno_tx_prepare = url_uno_tx_prepare, .uno_rx_loop = url_uno_rx_loop, .uno_init = url_uno_init, }; /* Macros */ #ifdef URL_DEBUG #define DPRINTF(x) if (urldebug) printf x #define DPRINTFN(n, x) if (urldebug >= (n)) printf x int urldebug = 0; #else #define DPRINTF(x) #define DPRINTFN(n, x) #endif #define URL_SETBIT(un, reg, x) \ url_csr_write_1(un, reg, url_csr_read_1(un, reg) | (x)) #define URL_SETBIT2(un, reg, x) \ url_csr_write_2(un, reg, url_csr_read_2(un, reg) | (x)) #define URL_CLRBIT(un, reg, x) \ url_csr_write_1(un, reg, url_csr_read_1(un, reg) & ~(x)) #define URL_CLRBIT2(un, reg, x) \ url_csr_write_2(un, reg, url_csr_read_2(un, reg) & ~(x)) static const struct url_type { struct usb_devno url_dev; uint16_t url_flags; #define URL_EXT_PHY 0x0001 } url_devs [] = { /* MELCO LUA-KTX */ {{ USB_VENDOR_MELCO, USB_PRODUCT_MELCO_LUAKTX }, 0}, /* Realtek RTL8150L Generic (GREEN HOUSE USBKR100) */ {{ USB_VENDOR_REALTEK, USB_PRODUCT_REALTEK_RTL8150L}, 0}, /* Longshine LCS-8138TX */ {{ USB_VENDOR_ABOCOM, USB_PRODUCT_ABOCOM_LCS8138TX}, 0}, /* Micronet SP128AR */ {{ USB_VENDOR_MICRONET, USB_PRODUCT_MICRONET_SP128AR}, 0}, /* OQO model 01 */ {{ USB_VENDOR_OQO, USB_PRODUCT_OQO_ETHER01}, 0}, }; #define url_lookup(v, p) ((const struct url_type *)usb_lookup(url_devs, v, p)) /* Probe */ static int url_match(device_t parent, cfdata_t match, void *aux) { struct usb_attach_arg *uaa = aux; return url_lookup(uaa->uaa_vendor, uaa->uaa_product) != NULL ? UMATCH_VENDOR_PRODUCT : UMATCH_NONE; } /* Attach */ static void url_attach(device_t parent, device_t self, void *aux) { USBNET_MII_DECL_DEFAULT(unm); struct usbnet * const un = device_private(self); struct usb_attach_arg *uaa = aux; struct usbd_device *dev = uaa->uaa_device; struct usbd_interface *iface; usbd_status err; usb_interface_descriptor_t *id; usb_endpoint_descriptor_t *ed; char *devinfop; int i; aprint_naive("\n"); aprint_normal("\n"); devinfop = usbd_devinfo_alloc(dev, 0); aprint_normal_dev(self, "%s\n", devinfop); usbd_devinfo_free(devinfop); un->un_dev = self; un->un_udev = dev; un->un_sc = un; un->un_ops = &url_ops; un->un_rx_xfer_flags = USBD_SHORT_XFER_OK; un->un_tx_xfer_flags = USBD_FORCE_SHORT_XFER; un->un_rx_list_cnt = URL_RX_LIST_CNT; un->un_tx_list_cnt = URL_TX_LIST_CNT; un->un_rx_bufsz = URL_BUFSZ; un->un_tx_bufsz = URL_BUFSZ; /* Move the device into the configured state. */ err = usbd_set_config_no(dev, URL_CONFIG_NO, 1); if (err) { aprint_error_dev(self, "failed to set configuration" ", err=%s\n", usbd_errstr(err)); return; } /* get control interface */ err = usbd_device2interface_handle(dev, URL_IFACE_INDEX, &iface); if (err) { aprint_error_dev(self, "failed to get interface, err=%s\n", usbd_errstr(err)); return; } un->un_iface = iface; un->un_flags = url_lookup(uaa->uaa_vendor, uaa->uaa_product)->url_flags; #if 0 if (un->un_flags & URL_EXT_PHY) { un->un_read_reg_cb = url_ext_mii_read_reg; un->un_write_reg_cb = url_ext_mii_write_reg; } #endif /* get interface descriptor */ id = usbd_get_interface_descriptor(un->un_iface); /* find endpoints */ un->un_ed[USBNET_ENDPT_RX] = un->un_ed[USBNET_ENDPT_TX] = un->un_ed[USBNET_ENDPT_INTR] = 0; for (i = 0; i < id->bNumEndpoints; i++) { ed = usbd_interface2endpoint_descriptor(un->un_iface, i); if (ed == NULL) { aprint_error_dev(self, "couldn't get endpoint %d\n", i); return; } if ((ed->bmAttributes & UE_XFERTYPE) == UE_BULK && UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_IN) un->un_ed[USBNET_ENDPT_RX] = ed->bEndpointAddress; else if ((ed->bmAttributes & UE_XFERTYPE) == UE_BULK && UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_OUT) un->un_ed[USBNET_ENDPT_TX] = ed->bEndpointAddress; else if ((ed->bmAttributes & UE_XFERTYPE) == UE_INTERRUPT && UE_GET_DIR(ed->bEndpointAddress) == UE_DIR_IN) un->un_ed[USBNET_ENDPT_INTR] = ed->bEndpointAddress; } if (un->un_ed[USBNET_ENDPT_RX] == 0 || un->un_ed[USBNET_ENDPT_TX] == 0 || un->un_ed[USBNET_ENDPT_INTR] == 0) { aprint_error_dev(self, "missing endpoint\n"); return; } /* Set these up now for url_mem(). */ usbnet_attach(un); /* reset the adapter */ url_reset(un); /* Get Ethernet Address */ err = url_mem(un, URL_CMD_READMEM, URL_IDR0, (void *)un->un_eaddr, ETHER_ADDR_LEN); if (err) { aprint_error_dev(self, "read MAC address failed\n"); return; } /* initialize interface information */ usbnet_attach_ifp(un, IFF_SIMPLEX | IFF_BROADCAST | IFF_MULTICAST, 0, &unm); } /* read/write memory */ static int url_mem(struct usbnet *un, int cmd, int offset, void *buf, int len) { usb_device_request_t req; usbd_status err; DPRINTFN(0x200, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); if (usbnet_isdying(un)) { if (cmd == URL_CMD_READMEM) memset(buf, 0, len); return 0; } if (cmd == URL_CMD_READMEM) req.bmRequestType = UT_READ_VENDOR_DEVICE; else req.bmRequestType = UT_WRITE_VENDOR_DEVICE; req.bRequest = URL_REQ_MEM; USETW(req.wValue, offset); USETW(req.wIndex, 0x0000); USETW(req.wLength, len); err = usbd_do_request(un->un_udev, &req, buf); if (err) { DPRINTF(("%s: url_mem(): %s failed. off=%04x, err=%d\n", device_xname(un->un_dev), cmd == URL_CMD_READMEM ? "read" : "write", offset, err)); if (cmd == URL_CMD_READMEM) memset(buf, 0, len); } return err; } /* read 1byte from register */ static int url_csr_read_1(struct usbnet *un, int reg) { uint8_t val = 0; DPRINTFN(0x100, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); return url_mem(un, URL_CMD_READMEM, reg, &val, 1) ? 0 : val; } /* read 2bytes from register */ static int url_csr_read_2(struct usbnet *un, int reg) { uWord val; DPRINTFN(0x100, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); USETW(val, 0); return url_mem(un, URL_CMD_READMEM, reg, &val, 2) ? 0 : UGETW(val); } /* write 1byte to register */ static int url_csr_write_1(struct usbnet *un, int reg, int aval) { uint8_t val = aval; DPRINTFN(0x100, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); return url_mem(un, URL_CMD_WRITEMEM, reg, &val, 1) ? -1 : 0; } /* write 2bytes to register */ static int url_csr_write_2(struct usbnet *un, int reg, int aval) { uWord val; DPRINTFN(0x100, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); USETW(val, aval); return url_mem(un, URL_CMD_WRITEMEM, reg, &val, 2) ? -1 : 0; } /* write 4bytes to register */ static int url_csr_write_4(struct usbnet *un, int reg, int aval) { uDWord val; DPRINTFN(0x100, ("%s: %s: enter\n", device_xname(un->un_dev), __func__)); USETDW(val, aval); return url_mem(un, URL_CMD_WRITEMEM, reg, &val, 4) ? -1 : 0; } static int url_uno_init(struct ifnet *ifp) { struct usbnet * const un = ifp->if_softc; const u_char *eaddr; int i; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev), __func__)); url_reset(un); eaddr = CLLADDR(ifp->if_sadl); for (i = 0; i < ETHER_ADDR_LEN; i++) url_csr_write_1(un, URL_IDR0 + i, eaddr[i]); /* Init transmission control register */ URL_CLRBIT(un, URL_TCR, URL_TCR_TXRR1 | URL_TCR_TXRR0 | URL_TCR_IFG1 | URL_TCR_IFG0 | URL_TCR_NOCRC); /* Init receive control register */ URL_SETBIT2(un, URL_RCR, URL_RCR_TAIL | URL_RCR_AD | URL_RCR_AB); /* Enable RX and TX */ URL_SETBIT(un, URL_CR, URL_CR_TE | URL_CR_RE); return 0; } static void url_reset(struct usbnet *un) { int i; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev), __func__)); if (usbnet_isdying(un)) return; URL_SETBIT(un, URL_CR, URL_CR_SOFT_RST); for (i = 0; i < URL_TX_TIMEOUT; i++) { if (usbnet_isdying(un)) return; if (!(url_csr_read_1(un, URL_CR) & URL_CR_SOFT_RST)) break; delay(10); /* XXX */ } delay(10000); /* XXX */ } static void url_uno_mcast(struct ifnet *ifp) { struct usbnet * const un = ifp->if_softc; struct ethercom *ec = usbnet_ec(un); struct ether_multi *enm; struct ether_multistep step; uint32_t mchash[2] = { 0, 0 }; uint32_t h = 0, rcr; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev), __func__)); if (usbnet_isdying(un)) return; rcr = url_csr_read_2(un, URL_RCR); rcr &= ~(URL_RCR_AAP | URL_RCR_AAM | URL_RCR_AM); ETHER_LOCK(ec); if (usbnet_ispromisc(un)) { ec->ec_flags |= ETHER_F_ALLMULTI; ETHER_UNLOCK(ec); /* run promisc. mode */ rcr |= URL_RCR_AAM; /* ??? */ rcr |= URL_RCR_AAP; goto update; } ec->ec_flags &= ~ETHER_F_ALLMULTI; ETHER_FIRST_MULTI(step, ec, enm); while (enm != NULL) { if (memcmp(enm->enm_addrlo, enm->enm_addrhi, ETHER_ADDR_LEN)) { ec->ec_flags |= ETHER_F_ALLMULTI; ETHER_UNLOCK(ec); /* accept all multicast frames */ rcr |= URL_RCR_AAM; goto update; } h = ether_crc32_be(enm->enm_addrlo, ETHER_ADDR_LEN); /* 1(31) and 5(30:26) bit sampling */ mchash[h >> 31] |= 1 << ((h >> 26) & 0x1f); ETHER_NEXT_MULTI(step, enm); } ETHER_UNLOCK(ec); if (h != 0) rcr |= URL_RCR_AM; /* activate mcast hash filter */ url_csr_write_4(un, URL_MAR0, mchash[0]); url_csr_write_4(un, URL_MAR4, mchash[1]); update: url_csr_write_2(un, URL_RCR, rcr); } static unsigned url_uno_tx_prepare(struct usbnet *un, struct mbuf *m, struct usbnet_chain *c) { int total_len; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev),__func__)); KASSERT(un->un_tx_bufsz >= URL_MIN_FRAME_LEN); if ((unsigned)m->m_pkthdr.len > un->un_tx_bufsz) return 0; /* Copy the mbuf data into a contiguous buffer */ m_copydata(m, 0, m->m_pkthdr.len, c->unc_buf); total_len = m->m_pkthdr.len; if (total_len < URL_MIN_FRAME_LEN) { memset(c->unc_buf + total_len, 0, URL_MIN_FRAME_LEN - total_len); total_len = URL_MIN_FRAME_LEN; } DPRINTF(("%s: %s: send %d bytes\n", device_xname(un->un_dev), __func__, total_len)); return total_len; } static void url_uno_rx_loop(struct usbnet *un, struct usbnet_chain *c, uint32_t total_len) { struct ifnet *ifp = usbnet_ifp(un); url_rxhdr_t rxhdr; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev),__func__)); if (total_len <= ETHER_CRC_LEN || total_len <= sizeof(rxhdr)) { if_statinc(ifp, if_ierrors); return; } memcpy(&rxhdr, c->unc_buf + total_len - ETHER_CRC_LEN, sizeof(rxhdr)); DPRINTF(("%s: RX Status: %dbytes%s%s%s%s packets\n", device_xname(un->un_dev), UGETW(rxhdr) & URL_RXHDR_BYTEC_MASK, UGETW(rxhdr) & URL_RXHDR_VALID_MASK ? ", Valid" : "", UGETW(rxhdr) & URL_RXHDR_RUNTPKT_MASK ? ", Runt" : "", UGETW(rxhdr) & URL_RXHDR_PHYPKT_MASK ? ", Physical match" : "", UGETW(rxhdr) & URL_RXHDR_MCASTPKT_MASK ? ", Multicast" : "")); if ((UGETW(rxhdr) & URL_RXHDR_VALID_MASK) == 0) { if_statinc(ifp, if_ierrors); return; } total_len -= ETHER_CRC_LEN; DPRINTF(("%s: %s: deliver %d\n", device_xname(un->un_dev), __func__, total_len)); usbnet_enqueue(un, c->unc_buf, total_len, 0, 0, 0); } #if 0 static void url_intr(void) { } #endif /* Stop the adapter and free any mbufs allocated to the RX and TX lists. */ static void url_uno_stop(struct ifnet *ifp, int disable) { struct usbnet * const un = ifp->if_softc; DPRINTF(("%s: %s: enter\n", device_xname(un->un_dev), __func__)); url_reset(un); } static int url_uno_mii_read_reg(struct usbnet *un, int phy, int reg, uint16_t *val) { uint16_t data; usbd_status err = USBD_NORMAL_COMPLETION; DPRINTFN(0xff, ("%s: %s: enter, phy=%d reg=0x%04x\n", device_xname(un->un_dev), __func__, phy, reg)); /* XXX: one PHY only for the RTL8150 internal PHY */ if (phy != 0) { DPRINTFN(0xff, ("%s: %s: phy=%d is not supported\n", device_xname(un->un_dev), __func__, phy)); *val = 0; return EINVAL; } switch (reg) { case MII_BMCR: /* Control Register */ reg = URL_BMCR; break; case MII_BMSR: /* Status Register */ reg = URL_BMSR; break; case MII_PHYIDR1: case MII_PHYIDR2: *val = 0; goto R_DONE; break; case MII_ANAR: /* Autonegotiation advertisement */ reg = URL_ANAR; break; case MII_ANLPAR: /* Autonegotiation link partner abilities */ reg = URL_ANLP; break; case URLPHY_MSR: /* Media Status Register */ reg = URL_MSR; break; default: printf("%s: %s: bad register %04x\n", device_xname(un->un_dev), __func__, reg); return EINVAL; } if (reg == URL_MSR) data = url_csr_read_1(un, reg); else data = url_csr_read_2(un, reg); *val = data; R_DONE: DPRINTFN(0xff, ("%s: %s: phy=%d reg=0x%04x => 0x%04hx\n", device_xname(un->un_dev), __func__, phy, reg, *val)); return err; } static int url_uno_mii_write_reg(struct usbnet *un, int phy, int reg, uint16_t val) { DPRINTFN(0xff, ("%s: %s: enter, phy=%d reg=0x%04x val=0x%04hx\n", device_xname(un->un_dev), __func__, phy, reg, val)); /* XXX: one PHY only for the RTL8150 internal PHY */ if (phy != 0) { DPRINTFN(0xff, ("%s: %s: phy=%d is not supported\n", device_xname(un->un_dev), __func__, phy)); return EINVAL; } switch (reg) { case MII_BMCR: /* Control Register */ reg = URL_BMCR; break; case MII_BMSR: /* Status Register */ reg = URL_BMSR; break; case MII_PHYIDR1: case MII_PHYIDR2: return 0; case MII_ANAR: /* Autonegotiation advertisement */ reg = URL_ANAR; break; case MII_ANLPAR: /* Autonegotiation link partner abilities */ reg = URL_ANLP; break; case URLPHY_MSR: /* Media Status Register */ reg = URL_MSR; break; default: printf("%s: %s: bad register %04x\n", device_xname(un->un_dev), __func__, reg); return EINVAL; } if (reg == URL_MSR) url_csr_write_1(un, reg, val); else url_csr_write_2(un, reg, val); return 0; } static void url_uno_mii_statchg(struct ifnet *ifp) { struct usbnet * const un = ifp->if_softc; DPRINTF(("%s: %s: enter\n", ifp->if_xname, __func__)); /* XXX */ usbnet_set_link(un, true); } #if 0 /* * external PHYs support, but not test. */ static usbd_status url_ext_mii_read_reg(struct usbnet *un, int phy, int reg) { uint16_t val; DPRINTF(("%s: %s: enter, phy=%d reg=0x%04x\n", device_xname(un->un_dev), __func__, phy, reg)); url_csr_write_1(un, URL_PHYADD, phy & URL_PHYADD_MASK); /* * RTL8150L will initiate a MII management data transaction * if PHYCNT_OWN bit is set 1 by software. After transaction, * this bit is auto cleared by TRL8150L. */ url_csr_write_1(un, URL_PHYCNT, (reg | URL_PHYCNT_PHYOWN) & ~URL_PHYCNT_RWCR); for (i = 0; i < URL_TIMEOUT; i++) { if ((url_csr_read_1(un, URL_PHYCNT) & URL_PHYCNT_PHYOWN) == 0) break; } if (i == URL_TIMEOUT) { printf("%s: MII read timed out\n", device_xname(un->un_dev)); } val = url_csr_read_2(un, URL_PHYDAT); DPRINTF(("%s: %s: phy=%d reg=0x%04x => 0x%04x\n", device_xname(un->un_dev), __func__, phy, reg, val)); return USBD_NORMAL_COMPLETION; } static usbd_status url_ext_mii_write_reg(struct usbnet *un, int phy, int reg, int data) { DPRINTF(("%s: %s: enter, phy=%d reg=0x%04x data=0x%04x\n", device_xname(un->un_dev), __func__, phy, reg, data)); url_csr_write_2(un, URL_PHYDAT, data); url_csr_write_1(un, URL_PHYADD, phy); url_csr_write_1(un, URL_PHYCNT, reg | URL_PHYCNT_RWCR); /* Write */ for (i=0; i < URL_TIMEOUT; i++) { if (url_csr_read_1(un, URL_PHYCNT) & URL_PHYCNT_PHYOWN) break; } if (i == URL_TIMEOUT) { printf("%s: MII write timed out\n", device_xname(un->un_dev)); return USBD_TIMEOUT; } return USBD_NORMAL_COMPLETION; } #endif #ifdef _MODULE #include "ioconf.c" #endif USBNET_MODULE(url)