1 /*- 2 * SPDX-License-Identifier: BSD-4-Clause 3 * 4 * Copyright (c) 1997, 1998, 1999, 2000 5 * Bill Paul <wpaul@ee.columbia.edu>. All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 3. All advertising materials mentioning features or use of this software 16 * must display the following acknowledgement: 17 * This product includes software developed by Bill Paul. 18 * 4. Neither the name of the author nor the names of any co-contributors 19 * may be used to endorse or promote products derived from this software 20 * without specific prior written permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25 * ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 32 * THE POSSIBILITY OF SUCH DAMAGE. 33 */ 34 35 /* 36 * Definitions for the KLSI KL5KUSB101B USB to ethernet controller. 37 * The KLSI part is controlled via vendor control requests, the structure 38 * of which depend a bit on the firmware running on the internal 39 * microcontroller. The one exception is the 'send scan data' command, 40 * which is used to load the firmware. 41 */ 42 43 #define KUE_CMD_GET_ETHER_DESCRIPTOR 0x00 44 #define KUE_CMD_SET_MCAST_FILTERS 0x01 45 #define KUE_CMD_SET_PKT_FILTER 0x02 46 #define KUE_CMD_GET_ETHERSTATS 0x03 47 #define KUE_CMD_GET_GPIO 0x04 48 #define KUE_CMD_SET_GPIO 0x05 49 #define KUE_CMD_SET_MAC 0x06 50 #define KUE_CMD_GET_MAC 0x07 51 #define KUE_CMD_SET_URB_SIZE 0x08 52 #define KUE_CMD_SET_SOFS 0x09 53 #define KUE_CMD_SET_EVEN_PKTS 0x0A 54 #define KUE_CMD_SEND_SCAN 0xFF 55 56 struct kue_ether_desc { 57 uint8_t kue_len; 58 uint8_t kue_rsvd0; 59 uint8_t kue_rsvd1; 60 uint8_t kue_macaddr[ETHER_ADDR_LEN]; 61 uint8_t kue_etherstats[4]; 62 uint8_t kue_maxseg[2]; 63 uint8_t kue_mcastfilt[2]; 64 uint8_t kue_rsvd2; 65 } __packed; 66 67 #define KUE_ETHERSTATS(x) UGETDW((x)->sc_desc.kue_etherstats) 68 #define KUE_MAXSEG(x) UGETW((x)->sc_desc.kue_maxseg) 69 #define KUE_MCFILTCNT(x) (UGETW((x)->sc_desc.kue_mcastfilt) & 0x7FFF) 70 #define KUE_MCFILT(x, y) \ 71 (char *)&(sc->sc_mcfilters[y * ETHER_ADDR_LEN]) 72 73 #define KUE_STAT_TX_OK 0x00000001 74 #define KUE_STAT_RX_OK 0x00000002 75 #define KUE_STAT_TX_ERR 0x00000004 76 #define KUE_STAT_RX_ERR 0x00000008 77 #define KUE_STAT_RX_NOBUF 0x00000010 78 #define KUE_STAT_TX_UCAST_BYTES 0x00000020 79 #define KUE_STAT_TX_UCAST_FRAMES 0x00000040 80 #define KUE_STAT_TX_MCAST_BYTES 0x00000080 81 #define KUE_STAT_TX_MCAST_FRAMES 0x00000100 82 #define KUE_STAT_TX_BCAST_BYTES 0x00000200 83 #define KUE_STAT_TX_BCAST_FRAMES 0x00000400 84 #define KUE_STAT_RX_UCAST_BYTES 0x00000800 85 #define KUE_STAT_RX_UCAST_FRAMES 0x00001000 86 #define KUE_STAT_RX_MCAST_BYTES 0x00002000 87 #define KUE_STAT_RX_MCAST_FRAMES 0x00004000 88 #define KUE_STAT_RX_BCAST_BYTES 0x00008000 89 #define KUE_STAT_RX_BCAST_FRAMES 0x00010000 90 #define KUE_STAT_RX_CRCERR 0x00020000 91 #define KUE_STAT_TX_QUEUE_LENGTH 0x00040000 92 #define KUE_STAT_RX_ALIGNERR 0x00080000 93 #define KUE_STAT_TX_SINGLECOLL 0x00100000 94 #define KUE_STAT_TX_MULTICOLL 0x00200000 95 #define KUE_STAT_TX_DEFERRED 0x00400000 96 #define KUE_STAT_TX_MAXCOLLS 0x00800000 97 #define KUE_STAT_RX_OVERRUN 0x01000000 98 #define KUE_STAT_TX_UNDERRUN 0x02000000 99 #define KUE_STAT_TX_SQE_ERR 0x04000000 100 #define KUE_STAT_TX_CARRLOSS 0x08000000 101 #define KUE_STAT_RX_LATECOLL 0x10000000 102 103 #define KUE_RXFILT_PROMISC 0x0001 104 #define KUE_RXFILT_ALLMULTI 0x0002 105 #define KUE_RXFILT_UNICAST 0x0004 106 #define KUE_RXFILT_BROADCAST 0x0008 107 #define KUE_RXFILT_MULTICAST 0x0010 108 109 #define KUE_TIMEOUT 1000 110 #define KUE_MIN_FRAMELEN 60 111 112 #define KUE_CTL_READ 0x01 113 #define KUE_CTL_WRITE 0x02 114 115 #define KUE_CONFIG_IDX 0 /* config number 1 */ 116 #define KUE_IFACE_IDX 0 117 118 /* The interrupt endpoint is currently unused by the KLSI part. */ 119 #define KUE_ENDPT_MAX 4 120 enum { 121 KUE_BULK_DT_WR, 122 KUE_BULK_DT_RD, 123 KUE_N_TRANSFER, 124 }; 125 126 struct kue_softc { 127 struct usb_ether sc_ue; 128 struct mtx sc_mtx; 129 struct kue_ether_desc sc_desc; 130 struct usb_xfer *sc_xfer[KUE_N_TRANSFER]; 131 uint8_t *sc_mcfilters; 132 133 int sc_flags; 134 #define KUE_FLAG_LINK 0x0001 135 136 uint16_t sc_rxfilt; 137 }; 138 139 #define KUE_LOCK(_sc) mtx_lock(&(_sc)->sc_mtx) 140 #define KUE_UNLOCK(_sc) mtx_unlock(&(_sc)->sc_mtx) 141 #define KUE_LOCK_ASSERT(_sc, t) mtx_assert(&(_sc)->sc_mtx, t) 142