tulipvar.h revision 1.5
1 /* $NetBSD: tulipvar.h,v 1.5 1999/09/08 22:29:46 thorpej Exp $ */ 2 3 /*- 4 * Copyright (c) 1998, 1999 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility, 9 * NASA Ames Research Center. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 * 3. All advertising materials mentioning features or use of this software 20 * must display the following acknowledgement: 21 * This product includes software developed by the NetBSD 22 * Foundation, Inc. and its contributors. 23 * 4. Neither the name of The NetBSD Foundation nor the names of its 24 * contributors may be used to endorse or promote products derived 25 * from this software without specific prior written permission. 26 * 27 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 28 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 29 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 30 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 31 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 33 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 34 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 35 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 36 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 37 * POSSIBILITY OF SUCH DAMAGE. 38 */ 39 40 #ifndef _DEV_IC_TULIPVAR_H_ 41 #define _DEV_IC_TULIPVAR_H_ 42 43 #include <sys/queue.h> 44 45 /* 46 * Misc. definitions for the Digital Semiconductor ``Tulip'' (21x4x) 47 * Ethernet controller family driver. 48 */ 49 50 /* 51 * Transmit descriptor list size. This is arbitrary, but allocate 52 * enough descriptors for 64 pending transmissions and 16 segments 53 * per packet. Since a descriptor holds 2 buffer addresses, that's 54 * 8 descriptors per packet. This MUST work out to a power of 2. 55 */ 56 #define TULIP_NTXSEGS 16 57 58 #define TULIP_TXQUEUELEN 64 59 #define TULIP_NTXDESC (TULIP_TXQUEUELEN * TULIP_NTXSEGS) 60 #define TULIP_NTXDESC_MASK (TULIP_NTXDESC - 1) 61 #define TULIP_NEXTTX(x) ((x + 1) & TULIP_NTXDESC_MASK) 62 63 /* 64 * Receive descriptor list size. We have one Rx buffer per incoming 65 * packet, so this logic is a little simpler. 66 */ 67 #define TULIP_NRXDESC 64 68 #define TULIP_NRXDESC_MASK (TULIP_NRXDESC - 1) 69 #define TULIP_NEXTRX(x) ((x + 1) & TULIP_NRXDESC_MASK) 70 71 /* 72 * Control structures are DMA'd to the TULIP chip. We allocate them in 73 * a single clump that maps to a single DMA segment to make several things 74 * easier. 75 */ 76 struct tulip_control_data { 77 /* 78 * The transmit descriptors. 79 */ 80 struct tulip_desc tcd_txdescs[TULIP_NTXDESC]; 81 82 /* 83 * The receive descriptors. 84 */ 85 struct tulip_desc tcd_rxdescs[TULIP_NRXDESC]; 86 87 /* 88 * The setup descriptor. 89 */ 90 struct tulip_desc tcd_setup_desc; 91 92 /* 93 * The setup packet. 94 */ 95 u_int32_t tcd_setup_packet[TULIP_SETUP_PACKET_LEN / sizeof(u_int32_t)]; 96 }; 97 98 #define TULIP_CDOFF(x) offsetof(struct tulip_control_data, x) 99 #define TULIP_CDTXOFF(x) TULIP_CDOFF(tcd_txdescs[(x)]) 100 #define TULIP_CDRXOFF(x) TULIP_CDOFF(tcd_rxdescs[(x)]) 101 #define TULIP_CDSDOFF TULIP_CDOFF(tcd_setup_desc) 102 #define TULIP_CDSPOFF TULIP_CDOFF(tcd_setup_packet) 103 104 /* 105 * Software state for transmit jobs. 106 */ 107 struct tulip_txsoft { 108 struct mbuf *txs_mbuf; /* head of our mbuf chain */ 109 bus_dmamap_t txs_dmamap; /* our DMA map */ 110 int txs_firstdesc; /* first descriptor in packet */ 111 int txs_lastdesc; /* last descriptor in packet */ 112 SIMPLEQ_ENTRY(tulip_txsoft) txs_q; 113 }; 114 115 SIMPLEQ_HEAD(tulip_txsq, tulip_txsoft); 116 117 /* 118 * Software state for receive jobs. 119 */ 120 struct tulip_rxsoft { 121 struct mbuf *rxs_mbuf; /* head of our mbuf chain */ 122 bus_dmamap_t rxs_dmamap; /* our DMA map */ 123 }; 124 125 /* 126 * Type of Tulip chip we're dealing with. 127 */ 128 typedef enum { 129 TULIP_CHIP_INVALID = 0, /* invalid chip type */ 130 TULIP_CHIP_DE425 = 1, /* DE-425 EISA */ 131 TULIP_CHIP_21040 = 2, /* DECchip 21040 */ 132 TULIP_CHIP_21041 = 3, /* DECchip 21041 */ 133 TULIP_CHIP_21140 = 4, /* DECchip 21140 */ 134 TULIP_CHIP_21140A = 5, /* DECchip 21140A */ 135 TULIP_CHIP_21142 = 6, /* DECchip 21142 */ 136 TULIP_CHIP_21143 = 7, /* DECchip 21143 */ 137 TULIP_CHIP_82C168 = 8, /* Lite-On 82C168 PNIC */ 138 TULIP_CHIP_82C169 = 9, /* Lite-On 82C169 PNIC */ 139 TULIP_CHIP_82C115 = 10, /* Lite-On 82C115 PNIC II */ 140 TULIP_CHIP_MX98713 = 11, /* Macronix 98713 PMAC */ 141 TULIP_CHIP_MX98713A = 12, /* Macronix 98713A PMAC */ 142 TULIP_CHIP_MX98715 = 13, /* Macronix 98715, 98715A PMAC */ 143 TULIP_CHIP_MX98725 = 14, /* Macronix 98725 PMAC */ 144 TULIP_CHIP_WB89C840F = 15, /* Winbond 89C840F */ 145 TULIP_CHIP_DM9102 = 16, /* Davicom DM9102 */ 146 TULIP_CHIP_AL981 = 17, /* ADMtek AL981 */ 147 TULIP_CHIP_AX88140 = 18, /* ASIX AX88140 */ 148 TULIP_CHIP_AX88141 = 19, /* ASIX AX88141 */ 149 } tulip_chip_t; 150 151 #define TULIP_CHIP_NAMES \ 152 { \ 153 NULL, \ 154 "DE-425", \ 155 "DECchip 21040", \ 156 "DECchip 21041", \ 157 "DECchip 21140", \ 158 "DECchip 21140A", \ 159 "DECchip 21142", \ 160 "DECchip 21143", \ 161 "Lite-On 82C168", \ 162 "Lite-On 82C169", \ 163 "Lite-On 82C115", \ 164 "Macronix MX98713", \ 165 "Macronix MX98713A", \ 166 "Macronix MX98715", \ 167 "Macronix MX98725", \ 168 "Winbond 89C840F", \ 169 "Davicom DM9102", \ 170 "ADMtek AL981", \ 171 "ASIX AX88140", \ 172 "ASIX AX88141", \ 173 } 174 175 struct tulip_softc; 176 177 /* 178 * Media init, change, status function pointers. 179 */ 180 struct tulip_mediasw { 181 void (*tmsw_init) __P((struct tulip_softc *)); 182 void (*tmsw_get) __P((struct tulip_softc *, struct ifmediareq *)); 183 int (*tmsw_set) __P((struct tulip_softc *)); 184 }; 185 186 /* 187 * Table which describes the transmit threshold mode. 188 */ 189 struct tulip_txthresh_tab { 190 u_int32_t txth_opmode; /* OPMODE bits */ 191 const char *txth_name; /* name of mode */ 192 }; 193 194 /* 195 * Software state per device. 196 */ 197 struct tulip_softc { 198 struct device sc_dev; /* generic device information */ 199 bus_space_tag_t sc_st; /* bus space tag */ 200 bus_space_handle_t sc_sh; /* bus space handle */ 201 bus_dma_tag_t sc_dmat; /* bus DMA tag */ 202 struct ethercom sc_ethercom; /* ethernet common data */ 203 void *sc_sdhook; /* shutdown hook */ 204 205 /* 206 * Media access functions for this chip. 207 */ 208 const struct tulip_mediasw *sc_mediasw; 209 210 tulip_chip_t sc_chip; /* chip type */ 211 int sc_rev; /* chip revision */ 212 int sc_flags; /* misc flags. */ 213 u_int32_t sc_cacheline; /* cache line size */ 214 215 struct mii_data sc_mii; /* MII/media information */ 216 217 const struct tulip_txthresh_tab *sc_txth; 218 int sc_txthresh; /* current transmit threshold */ 219 220 /* Filter setup function. */ 221 void (*sc_filter_setup) __P((struct tulip_softc *)); 222 223 /* Media status update function */ 224 void (*sc_statchg) __P((struct device *)); 225 226 /* 227 * The Winbond 89C840F places registers 4 bytes apart, instead 228 * of 8. 229 */ 230 int sc_regshift; 231 232 u_int32_t sc_busmode; /* copy of CSR_BUSMODE */ 233 u_int32_t sc_opmode; /* copy of CSR_OPMODE */ 234 u_int32_t sc_inten; /* copy of CSR_INTEN */ 235 236 u_int32_t sc_rxint_mask; /* mask of Rx interrupts we want */ 237 u_int32_t sc_txint_mask; /* mask of Tx interrupts we want */ 238 239 u_int32_t sc_filtmode; /* filter mode we're using */ 240 241 bus_dmamap_t sc_cddmamap; /* control data DMA map */ 242 #define sc_cddma sc_cddmamap->dm_segs[0].ds_addr 243 244 /* 245 * Software state for transmit and receive descriptors. 246 */ 247 struct tulip_txsoft sc_txsoft[TULIP_TXQUEUELEN]; 248 struct tulip_rxsoft sc_rxsoft[TULIP_NRXDESC]; 249 250 /* 251 * Control data structures. 252 */ 253 struct tulip_control_data *sc_control_data; 254 #define sc_txdescs sc_control_data->tcd_txdescs 255 #define sc_rxdescs sc_control_data->tcd_rxdescs 256 #define sc_setup_desc sc_control_data->tcd_setup_desc 257 258 int sc_txfree; /* number of free Tx descriptors */ 259 int sc_txnext; /* next ready Tx descriptor */ 260 261 struct tulip_txsq sc_txfreeq; /* free Tx descsofts */ 262 struct tulip_txsq sc_txdirtyq; /* dirty Tx descsofts */ 263 264 int sc_rxptr; /* next ready RX descriptor/descsoft */ 265 }; 266 267 /* sc_flags */ 268 #define TULIPF_WANT_SETUP 0x00000001 /* want filter setup */ 269 #define TULIPF_DOING_SETUP 0x00000002 /* doing multicast setup */ 270 #define TULIPF_HAS_MII 0x00000004 /* has media on MII */ 271 #define TULIPF_IC_FS 0x00000008 /* IC bit on first tx seg */ 272 273 #define TULIP_CDTXADDR(sc, x) ((sc)->sc_cddma + TULIP_CDTXOFF((x))) 274 #define TULIP_CDRXADDR(sc, x) ((sc)->sc_cddma + TULIP_CDRXOFF((x))) 275 276 #define TULIP_CDSDADDR(sc) ((sc)->sc_cddma + TULIP_CDSDOFF) 277 #define TULIP_CDSPADDR(sc) ((sc)->sc_cddma + TULIP_CDSPOFF) 278 279 #define TULIP_CDSP(sc) ((sc)->sc_control_data->tcd_setup_packet) 280 281 #define TULIP_CDTXSYNC(sc, x, n, ops) \ 282 do { \ 283 int __x, __n; \ 284 \ 285 __x = (x); \ 286 __n = (n); \ 287 \ 288 /* If it will wrap around, sync to the end of the ring. */ \ 289 if ((__x + __n) > TULIP_NTXDESC) { \ 290 bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \ 291 TULIP_CDTXOFF(__x), sizeof(struct tulip_desc) * \ 292 (TULIP_NTXDESC - __x), (ops)); \ 293 __n -= (TULIP_NTXDESC - __x); \ 294 __x = 0; \ 295 } \ 296 \ 297 /* Now sync whatever is left. */ \ 298 bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \ 299 TULIP_CDTXOFF(__x), sizeof(struct tulip_desc) * __n, (ops)); \ 300 } while (0) 301 302 #define TULIP_CDRXSYNC(sc, x, ops) \ 303 bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \ 304 TULIP_CDRXOFF((x)), sizeof(struct tulip_desc), (ops)) 305 306 #define TULIP_CDSDSYNC(sc, ops) \ 307 bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \ 308 TULIP_CDSDOFF, sizeof(struct tulip_desc), (ops)) 309 310 #define TULIP_CDSPSYNC(sc, ops) \ 311 bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_cddmamap, \ 312 TULIP_CDSPOFF, TULIP_SETUP_PACKET_LEN, (ops)) 313 314 /* 315 * Note we rely on MCLBYTES being a power of two. Because the `length' 316 * field is only 11 bits, we must subtract 1 from the length to avoid 317 * having it truncated to 0! 318 */ 319 #define TULIP_INIT_RXDESC(sc, x) \ 320 do { \ 321 struct tulip_rxsoft *__rxs = &sc->sc_rxsoft[(x)]; \ 322 struct tulip_desc *__rxd = &sc->sc_rxdescs[(x)]; \ 323 struct mbuf *__m = __rxs->rxs_mbuf; \ 324 \ 325 __m->m_data = __m->m_ext.ext_buf; \ 326 __rxd->td_bufaddr1 = __rxs->rxs_dmamap->dm_segs[0].ds_addr; \ 327 __rxd->td_bufaddr2 = TULIP_CDRXADDR((sc), TULIP_NEXTRX((x))); \ 328 __rxd->td_ctl = \ 329 ((__m->m_ext.ext_size - 1) << TDCTL_SIZE1_SHIFT) | TDCTL_CH; \ 330 __rxd->td_status = TDSTAT_OWN|TDSTAT_Rx_FS|TDSTAT_Rx_LS; \ 331 TULIP_CDRXSYNC((sc), (x), BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE); \ 332 } while (0) 333 334 /* CSR access */ 335 #define TULIP_READ(sc, reg) \ 336 bus_space_read_4((sc)->sc_st, (sc)->sc_sh, \ 337 (reg) >> (sc)->sc_regshift) 338 339 #define TULIP_WRITE(sc, reg, val) \ 340 bus_space_write_4((sc)->sc_st, (sc)->sc_sh, \ 341 (reg) >> (sc)->sc_regshift, (val)) 342 343 #define TULIP_SET(sc, reg, mask) \ 344 TULIP_WRITE((sc), (reg), TULIP_READ((sc), (reg)) | (mask)) 345 346 #define TULIP_CLR(sc, reg, mask) \ 347 TULIP_WRITE((sc), (reg), TULIP_READ((sc), (reg)) & ~(mask)) 348 349 #define TULIP_ISSET(sc, reg, mask) \ 350 (TULIP_READ((sc), (reg)) & (mask)) 351 352 #ifdef _KERNEL 353 extern const struct tulip_mediasw tlp_sio_mii_mediasw; 354 extern const struct tulip_mediasw tlp_pnic_mediasw; 355 356 void tlp_attach __P((struct tulip_softc *, const char *, const u_int8_t *)); 357 int tlp_intr __P((void *)); 358 void tlp_read_srom __P((struct tulip_softc *, int, int, u_int16_t *)); 359 int tlp_srom_crcok __P((u_int8_t *)); 360 361 int tlp_mediachange __P((struct ifnet *)); 362 void tlp_mediastatus __P((struct ifnet *, struct ifmediareq *)); 363 #endif /* _KERNEL */ 364 365 #endif /* _DEV_IC_TULIPVAR_H_ */ 366
Indexes created Fri Sep 26 20:09:58 GMT 2025