src/sys/dev/ic/i82596var.h
2023-07-10 00:10:46 +00:00

298 lines
11 KiB
C

/* $OpenBSD: i82596var.h,v 1.14 2022/01/09 05:42:38 jsg Exp $ */
/* $NetBSD: i82586var.h,v 1.10 1998/08/15 04:42:42 mycroft Exp $ */
/*-
* Copyright (c) 1998 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Paul Kranenburg and Charles M. Hannum.
*
* 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.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
*/
/*-
* Copyright (c) 1992, 1993, University of Vermont and State
* Agricultural College.
* Copyright (c) 1992, 1993, Garrett A. Wollman.
*
* Portions:
* Copyright (c) 1994, 1995, Rafal K. Boni
* Copyright (c) 1990, 1991, William F. Jolitz
* Copyright (c) 1990, The Regents of the University of California
*
* 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. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by the University of Vermont
* and State Agricultural College and Garrett A. Wollman, by William F.
* Jolitz, and by the University of California, Berkeley, Lawrence
* Berkeley Laboratory, and its contributors.
* 4. Neither the names of the Universities nor the names of the authors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 UNIVERSITY OR AUTHORS 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.
*/
/*
* Intel 82586/82596 Ethernet chip
* Register, bit, and structure definitions.
*
* Original StarLAN driver written by Garrett Wollman with reference to the
* Clarkson Packet Driver code for this chip written by Russ Nelson and others.
*
* BPF support code taken from hpdev/if_le.c, supplied with tcpdump.
*
* 3C507 support is loosely based on code donated to NetBSD by Rafal Boni.
*
* Majorly cleaned up and 3C507 code merged by Charles Hannum.
*
* Converted to SUN ie driver by Charles D. Cranor,
* October 1994, January 1995.
* This sun version based on i386 version 1.30.
*/
/* #define I82596_DEBUG */
/* Debug elements */
#define IED_RINT 0x01
#define IED_TINT 0x02
#define IED_RNR 0x04
#define IED_CNA 0x08
#define IED_READFRAME 0x10
#define IED_ENQ 0x20
#define IED_XMIT 0x40
#define IED_CMDS 0x80
#define IED_ALL 0xff
#define B_PER_F 6 /* recv buffers per frame */
#define IE_RBUF_SIZE 256 /* size of each receive buffer;
MUST BE POWER OF TWO */
#define NTXBUF 4 /* number of transmit commands */
#define IE_TBUF_SIZE ETHER_MAX_LEN /* length of transmit buffer */
#define IE_MAXMCAST (IE_TBUF_SIZE/6)/* must fit in transmit buffer */
#define IE_INTR_ENRCV 1 /* receive pkt interrupt */
#define IE_INTR_ENSND 2 /* send pkt interrupt */
#define IE_INTR_LOOP 3 /* a loop for next one*/
#define IE_INTR_EXIT 4 /* done w/ interrupts */
#define IE_CHIP_PROBE 0 /* reset called from chip probe */
#define IE_CARD_RESET 1 /* reset called from card reset */
#define IE_PORT_RESET 0
#define IE_PORT_TEST 1
#define IE_PORT_SCP 2
#define IE_PORT_DUMP 3
/*
* Ethernet status, per interface.
*
* The chip uses two types of pointers: 16 bit and 24 bit
* 24 bit pointers cover the board's memory.
* 16 bit pointers are offsets from the ISCP's `ie_base'
*
* The board's memory is represented by the bus handle `bh'. The MI
* i82586/596 driver deals exclusively with offsets relative to the
* board memory bus handle. The `ie_softc' fields below that are marked
* `MD' are in the domain of the front-end driver; they opaque to the
* MI driver part.
*
* The front-end is required to manage the SCP and ISCP structures. i.e.
* allocate room for them on the board's memory, and arrange to point the
* chip at the SCB structure, the offset of which is passed to the MI
* driver in `sc_scb'.
*
* The following functions provide the glue necessary to deal with
* host and bus idiosyncrasies:
*
* hwreset - board reset
* hwinit - board initialization
* chan_attn - get chip to look at prepared commands
* intrhook - board dependent interrupt processing
*
* All of the following shared-memory access function use an offset
* relative to the bus handle to indicate the shared memory location.
* The bus_{read/write}N function take or return offset into the
* shared memory in the host's byte-order.
*
* memcopyin - copy device memory: board to KVA
* memcopyout - copy device memory: KVA to board
* bus_read16 - read a 16-bit i82586 pointer
`offset' argument will be 16-bit aligned
* bus_write16 - write a 16-bit i82586 pointer
`offset' argument will be 16-bit aligned
* bus_write24 - write a 24-bit i82586 pointer
`offset' argument will be 32-bit aligned
*
*/
struct ie_softc {
struct device sc_dev; /* device structure */
void *sc_ih;
bus_space_tag_t iot; /* bus-space tag of card registers */
bus_space_handle_t ioh; /* bus-space handle of card registers */
bus_space_tag_t bt; /* bus-space tag of card memory */
bus_space_handle_t bh; /* bus-space handle of card memory */
const char *sc_type; /* (MD) hardware type */
int sc_vers; /* (MD) hardware version */
int sc_irq; /* (MD) irq in md format */
void *sc_iobase; /* (MD) KVA of base of 24 bit addr space */
u_long sc_maddr; /* (MD) base of chip's RAM (16bit addr space) */
u_int sc_msize; /* (MD) how much RAM we have/use */
u_int sc_flags; /* (MI/MD) flags */
#define IEMD_FLAG0 0x00010000
#define IEMD_FLAG1 0x00020000
#define IEMD_FLAG2 0x00040000
#define IEMD_FLAG3 0x00080000
#define IEMD_FLAG4 0x00100000
#define IEMD_FLAG5 0x00200000
#define IEMD_FLAG6 0x00400000
#define IEMD_FLAG7 0x00800000
struct arpcom sc_arpcom; /* system ethercom structure */
struct ifmedia sc_media; /* supported media information */
/* Bus glue */
void (*hwreset)(struct ie_softc *, int);
void (*hwinit)(struct ie_softc *);
void (*chan_attn)(struct ie_softc *);
void (*port)(struct ie_softc *, u_int);
int (*intrhook)(struct ie_softc *, int where);
void (*memcopyin)(struct ie_softc *, void *, int, size_t);
void (*memcopyout)(struct ie_softc *, const void *,
int, size_t);
u_int16_t (*ie_bus_read16)(struct ie_softc *, int offset);
void (*ie_bus_write16)(struct ie_softc *, int offset,
u_int16_t value);
void (*ie_bus_write24)(struct ie_softc *, int offset,
int addr);
/* Media management */
int (*sc_mediachange)(struct ie_softc *);
/* card dependent media change */
void (*sc_mediastatus)(struct ie_softc *, struct ifmediareq *);
/* card dependent media status */
/*
* Offsets (relative to bus handle) of the i82586 SYSTEM structures.
*/
int scp; /* Offset to the SCP (set by front-end) */
int iscp; /* Offset to the ISCP (set by front-end) */
int scb; /* Offset to SCB (set by front-end) */
/*
* Offset and size of a block of board memory where the buffers
* are to be allocated from (initialized by front-end).
*/
int buf_area; /* Start of descriptors and buffers */
int buf_area_sz; /* Size of above */
/* SYSBUS byte */
int sysbus;
/*
* The buffers & descriptors (recv and xmit)
*/
int rframes; /* Offset to `nrxbuf' frame descriptors */
int rbds; /* Offset to `nrxbuf' buffer descriptors */
int rbufs; /* Offset to `nrxbuf' receive buffers */
#define IE_RBUF_ADDR(sc, i) (sc->rbufs + ((i) * IE_RBUF_SIZE))
int rfhead, rftail;
int rbhead, rbtail;
int nframes; /* number of frames in use */
int nrxbuf; /* number of recv buffs in use */
int rnr_expect; /* XXX - expect a RCVR not ready interrupt */
int nop_cmds; /* Offset to NTXBUF no-op commands */
int xmit_cmds; /* Offset to NTXBUF transmit commands */
int xbds; /* Offset to NTXBUF buffer descriptors */
int xbufs; /* Offset to NTXBUF transmit buffers */
#define IE_XBUF_ADDR(sc, i) (sc->xbufs + ((i) * IE_TBUF_SIZE))
int xchead, xctail;
int xmit_busy;
int do_xmitnopchain; /* Controls use of xmit NOP chains */
/* Multicast addresses */
char *mcast_addrs; /* Current MC filter addresses */
int mcast_addrs_size; /* Current size of MC buffer */
int mcast_count; /* Current # of addrs in buffer */
int want_mcsetup; /* run mcsetup at next opportunity */
int promisc; /* are we in promisc mode? */
int async_cmd_inprogress; /* we didn't wait for 586 to accept
a command */
#ifdef I82596_DEBUG
int sc_debug;
#endif
};
/* Exported functions */
int i82596_intr(void *);
int i82596_probe(struct ie_softc *);
int i82596_proberam(struct ie_softc *);
void i82596_attach(struct ie_softc *, const char *, u_int8_t *,
uint64_t *, int, uint64_t);
int i82596_start_cmd(struct ie_softc *, int, int, int, int);
/*
* Interrupt Acknowledge.
*/
static __inline__ void
ie_ack(struct ie_softc *sc, u_int mask) /* in native byte-order */
{
u_int status;
int off = IE_SCB_STATUS(sc->scb);
bus_space_barrier(sc->bt, sc->bh, off, 2, BUS_SPACE_BARRIER_READ);
status = (sc->ie_bus_read16)(sc, off);
i82596_start_cmd(sc, status & mask, 0, 0, 0);
}