i82586var.h revision 1.12
1/* $NetBSD: i82586var.h,v 1.12 1999/08/23 12:12:43 pk Exp $ */ 2 3/*- 4 * Copyright (c) 1998 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Paul Kranenburg and Charles M. Hannum. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 3. All advertising materials mentioning features or use of this software 19 * must display the following acknowledgement: 20 * This product includes software developed by the NetBSD 21 * Foundation, Inc. and its contributors. 22 * 4. Neither the name of The NetBSD Foundation nor the names of its 23 * contributors may be used to endorse or promote products derived 24 * from this software without specific prior written permission. 25 * 26 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 27 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 28 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 29 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 30 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 31 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 32 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 33 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 34 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 35 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 36 * POSSIBILITY OF SUCH DAMAGE. 37 */ 38 39/*- 40 * Copyright (c) 1992, 1993, University of Vermont and State 41 * Agricultural College. 42 * Copyright (c) 1992, 1993, Garrett A. Wollman. 43 * 44 * Portions: 45 * Copyright (c) 1994, 1995, Rafal K. Boni 46 * Copyright (c) 1990, 1991, William F. Jolitz 47 * Copyright (c) 1990, The Regents of the University of California 48 * 49 * All rights reserved. 50 * 51 * Redistribution and use in source and binary forms, with or without 52 * modification, are permitted provided that the following conditions 53 * are met: 54 * 1. Redistributions of source code must retain the above copyright 55 * notice, this list of conditions and the following disclaimer. 56 * 2. Redistributions in binary form must reproduce the above copyright 57 * notice, this list of conditions and the following disclaimer in the 58 * documentation and/or other materials provided with the distribution. 59 * 3. All advertising materials mentioning features or use of this software 60 * must display the following acknowledgement: 61 * This product includes software developed by the University of Vermont 62 * and State Agricultural College and Garrett A. Wollman, by William F. 63 * Jolitz, and by the University of California, Berkeley, Lawrence 64 * Berkeley Laboratory, and its contributors. 65 * 4. Neither the names of the Universities nor the names of the authors 66 * may be used to endorse or promote products derived from this software 67 * without specific prior written permission. 68 * 69 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 70 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 71 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 72 * ARE DISCLAIMED. IN NO EVENT SHALL THE UNIVERSITY OR AUTHORS BE LIABLE 73 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 74 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 75 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 76 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 77 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 78 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 79 * SUCH DAMAGE. 80 */ 81 82/* 83 * Intel 82586 Ethernet chip 84 * Register, bit, and structure definitions. 85 * 86 * Original StarLAN driver written by Garrett Wollman with reference to the 87 * Clarkson Packet Driver code for this chip written by Russ Nelson and others. 88 * 89 * BPF support code taken from hpdev/if_le.c, supplied with tcpdump. 90 * 91 * 3C507 support is loosely based on code donated to NetBSD by Rafal Boni. 92 * 93 * Majorly cleaned up and 3C507 code merged by Charles Hannum. 94 * 95 * Converted to SUN ie driver by Charles D. Cranor, 96 * October 1994, January 1995. 97 * This sun version based on i386 version 1.30. 98 */ 99 100#define I82586_DEBUG 0 101 102/* Debug elements */ 103#define IED_RINT 0x01 104#define IED_TINT 0x02 105#define IED_RNR 0x04 106#define IED_CNA 0x08 107#define IED_READFRAME 0x10 108#define IED_ENQ 0x20 109#define IED_XMIT 0x40 110#define IED_ALL 0x7f 111 112#define B_PER_F 3 /* recv buffers per frame */ 113#define IE_RBUF_SIZE 256 /* size of each receive buffer; 114 MUST BE POWER OF TWO */ 115#define NTXBUF 2 /* number of transmit commands */ 116#define IE_TBUF_SIZE ETHER_MAX_LEN /* length of transmit buffer */ 117 118#define IE_MAXMCAST (IE_TBUF_SIZE/6)/* must fit in transmit buffer */ 119 120 121#define INTR_ENTER 0 /* intr hook called on ISR entry */ 122#define INTR_EXIT 1 /* intr hook called on ISR exit */ 123#define INTR_LOOP 2 /* intr hook called on ISR loop */ 124 125#define CHIP_PROBE 0 /* reset called from chip probe */ 126#define CARD_RESET 1 /* reset called from card reset */ 127 128/* 129 * Ethernet status, per interface. 130 * 131 * The chip uses two types of pointers: 16 bit and 24 bit 132 * 24 bit pointers cover the board's memory. 133 * 16 bit pointers are offsets from the ISCP's `ie_base' 134 * 135 * The board's memory is represented by the bus handle `bh'. The MI 136 * i82586 driver deals exclusively with offsets relative to the 137 * board memory bus handle. The `ie_softc' fields below that are marked 138 * `MD' are in the domain of the front-end driver; they opaque to the 139 * MI driver part. 140 * 141 * The front-end is required to manage the SCP and ISCP structures. i.e. 142 * allocate room for them on the board's memory, and arrange to point the 143 * chip at the SCB stucture, the offset of which is passed to the MI 144 * driver in `sc_scb'. 145 * 146 * The following functions provide the glue necessary to deal with 147 * host and bus idiosyncracies: 148 * 149 * hwreset - board reset 150 * hwinit - board initialization 151 * chan_attn - get chip to look at prepared commands 152 * intrhook - board dependent interrupt processing 153 * 154 * All of the following shared-memory access function use an offset 155 * relative to the bus handle to indicate the shared memory location. 156 * The bus_{read/write}N function take or return offset into the 157 * shared memory in the host's byte-order. 158 * 159 * memcopyin - copy device memory: board to KVA 160 * memcopyout - copy device memory: KVA to board 161 * bus_read16 - read a 16-bit i82586 pointer 162 `offset' argument will be 16-bit aligned 163 * bus_write16 - write a 16-bit i82586 pointer 164 `offset' argument will be 16-bit aligned 165 * bus_write24 - write a 24-bit i82586 pointer 166 `offset' argument will be 32-bit aligned 167 * 168 */ 169 170struct ie_softc { 171 struct device sc_dev; /* device structure */ 172 173 bus_space_tag_t bt; /* bus-space tag of card memory */ 174 bus_space_handle_t bh; /* bus-space handle of card memory */ 175 176 void *sc_iobase; /* (MD) KVA of base of 24 bit addr space */ 177 void *sc_maddr; /* (MD) KVA of base of chip's RAM 178 (16bit addr space) */ 179 u_int sc_msize; /* (MD) how much RAM we have/use */ 180 void *sc_reg; /* (MD) KVA of car's register */ 181 182 struct ethercom sc_ethercom; /* system ethercom structure */ 183 struct ifmedia sc_media; /* supported media information */ 184 185 /* Bus glue */ 186 void (*hwreset) __P((struct ie_softc *, int)); 187 void (*hwinit) __P((struct ie_softc *)); 188 void (*chan_attn) __P((struct ie_softc *)); 189 int (*intrhook) __P((struct ie_softc *, int where)); 190 191 void (*memcopyin) __P((struct ie_softc *, void *, int, size_t)); 192 void (*memcopyout) __P((struct ie_softc *, const void *, 193 int, size_t)); 194 u_int16_t (*ie_bus_read16) __P((struct ie_softc *, int offset)); 195 void (*ie_bus_write16) __P((struct ie_softc *, int offset, 196 u_int16_t value)); 197 void (*ie_bus_write24) __P((struct ie_softc *, int offset, 198 int addr)); 199 200 /* Media management */ 201 int (*sc_mediachange) __P((struct ie_softc *)); 202 /* card dependent media change */ 203 void (*sc_mediastatus) __P((struct ie_softc *, struct ifmediareq *)); 204 /* card dependent media status */ 205 206 207 /* 208 * Offsets (relative to bus handle) of the i82586 SYSTEM structures. 209 */ 210 int scp; /* Offset to the SCP (set by front-end) */ 211 int iscp; /* Offset to the ISCP (set by front-end) */ 212 int scb; /* Offset to SCB (set by front-end) */ 213 214 /* 215 * Offset and size of a block of board memory where the buffers 216 * are to be allocated from (initialized by front-end). 217 */ 218 int buf_area; /* Start of descriptors and buffers */ 219 int buf_area_sz; /* Size of above */ 220 221 /* 222 * The buffers & descriptors (recv and xmit) 223 */ 224 int rframes; /* Offset to `nrxbuf' frame descriptors */ 225 int rbds; /* Offset to `nrxbuf' buffer descriptors */ 226 int rbufs; /* Offset to `nrxbuf' receive buffers */ 227#define IE_RBUF_ADDR(sc, i) (sc->rbufs + ((i) * IE_RBUF_SIZE)) 228 int rfhead, rftail; 229 int rbhead, rbtail; 230 int nframes; /* number of frames in use */ 231 int nrxbuf; /* number of recv buffs in use */ 232 int rnr_expect; /* XXX - expect a RCVR not ready interrupt */ 233 234 int nop_cmds; /* Offset to NTXBUF no-op commands */ 235 int xmit_cmds; /* Offset to NTXBUF transmit commands */ 236 int xbds; /* Offset to NTXBUF buffer descriptors */ 237 int xbufs; /* Offset to NTXBUF transmit buffers */ 238#define IE_XBUF_ADDR(sc, i) (sc->xbufs + ((i) * IE_TBUF_SIZE)) 239 240 int xchead, xctail; 241 int xmit_busy; 242 int do_xmitnopchain; /* Controls use of xmit NOP chains */ 243 244 /* Multicast addresses */ 245 char *mcast_addrs; /* Current MC filter addresses */ 246 int mcast_addrs_size; /* Current size of MC buffer */ 247 int mcast_count; /* Current # of addrs in buffer */ 248 int want_mcsetup; /* run mcsetup at next opportunity */ 249 250 int promisc; /* are we in promisc mode? */ 251 int async_cmd_inprogress; /* we didn't wait for 586 to accept 252 a command */ 253 254#if I82586_DEBUG 255 int sc_debug; 256#endif 257}; 258 259/* Exported functions */ 260int i82586_intr __P((void *)); 261int i82586_proberam __P((struct ie_softc *)); 262void i82586_attach __P((struct ie_softc *, char *, u_int8_t *, 263 int*, int, int)); 264