FreeBSD/Linux Kernel Cross Reference
sys/dev/ic/i82586var.h

     /*      $NetBSD: i82586var.h,v 1.23 2011/06/03 16:28:40 tsutsui 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 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.
     */
    
    #ifndef I82586_DEBUG
    #define I82586_DEBUG 0
    #endif
    
    /* 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_ALL         0x7f
   
   #define B_PER_F         3               /* recv buffers per frame */
   #define IE_RBUF_SIZE    256             /* size of each receive buffer;
                                                   MUST BE POWER OF TWO */
   #define NTXBUF          2               /* 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 INTR_ENTER      0               /* intr hook called on ISR entry */
   #define INTR_EXIT       1               /* intr hook called on ISR exit */
   #define INTR_LOOP       2               /* intr hook called on ISR loop */
   #define INTR_ACK        3               /* intr hook called on ie_ack */
   
   #define CHIP_PROBE      0               /* reset called from chip probe */
   #define CARD_RESET      1               /* reset called from card reset */
   
   /*
    * 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 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 idiosyncracies:
    *
    *      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
    *      bus_barrier     - perform a bus barrier operation, forcing
                             all outstanding reads/writes to complete
    *
    */
   
   struct ie_softc {
           device_t sc_dev;        /* device structure */
   
           bus_space_tag_t bt;     /* bus-space tag of card memory */
           bus_space_handle_t bh;  /* bus-space handle of card memory */
   
           bus_dmamap_t    sc_dmamap;      /* bus dma handle */
   
           void    *sc_iobase;     /* (MD) KVA of base of 24 bit addr space */
           void    *sc_maddr;      /* (MD) KVA of base of chip's RAM
                                      (16bit addr space) */
           u_int   sc_msize;       /* (MD) how much RAM we have/use */
           void    *sc_reg;        /* (MD) KVA of car's register */
   
           struct  ethercom sc_ethercom;   /* 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 *, int);
           int     (*intrhook)(struct ie_softc *, int);
   
           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);
           void    (*ie_bus_write16)(struct ie_softc *, int, u_int16_t);
           void    (*ie_bus_write24)(struct ie_softc *, int, int);
           void    (*ie_bus_barrier)(struct ie_softc *, int, int, int);
   
           /* 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 */
   
           /*
            * 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 */
   
   #if I82586_DEBUG
           int     sc_debug;
   #endif
   };
   
   /* Exported functions */
   int     i82586_intr(void *);
   int     i82586_proberam(struct ie_softc *);
   void    i82586_attach(struct ie_softc *, const char *, u_int8_t *, int*, int,
       int);
   
   /* Shortcut macros to optional (driver uses default if unspecified) callbacks */
   #define IE_BUS_BARRIER(sc, offset, length, flags)                         \
   do {                                                                      \
           if ((sc)->ie_bus_barrier)                                         \
                   ((sc)->ie_bus_barrier)((sc), (offset), (length), (flags));\
           else                                                              \
                   bus_space_barrier((sc)->bt, (sc)->bh, (offset), (length), \
                                                                   (flags)); \
   } while (0)
   

Cache object: f8de6dc38824fd5950526d3b78b97bf2