NetBSD-5.0.2/sys/dev/ic/cs89x0var.h
/* $NetBSD: cs89x0var.h,v 1.11 2006/02/16 20:17:16 perry Exp $ */
/*
* Copyright 1997
* Digital Equipment Corporation. All rights reserved.
*
* This software is furnished under license and may be used and
* copied only in accordance with the following terms and conditions.
* Subject to these conditions, you may download, copy, install,
* use, modify and distribute this software in source and/or binary
* form. No title or ownership is transferred hereby.
*
* 1) Any source code used, modified or distributed must reproduce
* and retain this copyright notice and list of conditions as
* they appear in the source file.
*
* 2) No right is granted to use any trade name, trademark, or logo of
* Digital Equipment Corporation. Neither the "Digital Equipment
* Corporation" name nor any trademark or logo of Digital Equipment
* Corporation may be used to endorse or promote products derived
* from this software without the prior written permission of
* Digital Equipment Corporation.
*
* 3) This software is provided "AS-IS" and any express or implied
* warranties, including but not limited to, any implied warranties
* of merchantability, fitness for a particular purpose, or
* non-infringement are disclaimed. In no event shall DIGITAL be
* liable for any damages whatsoever, and in particular, DIGITAL
* shall not be liable for special, indirect, consequential, or
* incidental damages or damages for lost profits, loss of
* revenue or loss of use, whether such damages arise in contract,
* negligence, tort, under statute, in equity, at law or otherwise,
* even if advised of the possibility of such damage.
*/
/*
**++
** FACILITY Crystal CS8900 Ethernet driver header file
**
** ABSTRACT
**
** This module provides CS8900 driver softc and related definitions
**
** AUTHORS
**
** Peter Dettori SEA - Software Engineering.
**
** CREATION DATE:
**
** 13-Feb-1997.
**
** MODIFICATION HISTORY:
**
**--
*/
#ifndef _DEV_IC_CS89X0VAR_H_
#define _DEV_IC_CS89X0VAR_H_
/*
* Ethernet software status per interface.
*
* Each interface is referenced by a network interface structure,
* arpcom.ac_if, which the routing code uses to locate the interface.
* This structure contains the output queue for the interface,
* its address, ...
*/
struct cs_softc {
struct device sc_dev; /* base device glue */
struct ethercom sc_ethercom; /* Ethernet common */
struct ifmedia sc_media; /* media control structures */
void *sc_ih; /* interrupt handler */
void *sc_sh; /* shutdown hook */
bus_space_tag_t sc_iot; /* bus space tag for IO */
bus_space_tag_t sc_memt; /* bus space tag for memory mode */
bus_space_handle_t sc_ioh; /* bus space handles */
bus_space_handle_t sc_memh;
#if 0
isa_chipset_tag_t sc_ic; /* ISA chipset */
#endif
int sc_irq; /* IRQ line */
int sc_prodid; /* saved product ID */
int sc_prodrev; /* saved product rev */
bus_addr_t sc_pktpgaddr; /* PacketPage bus memory address */
int sc_cfgflags; /* software configuration flags */
int sc_memorymode; /* are we in memory mode? */
int sc_txbusy; /* transmit in progress */
int sc_resetting; /* reset in progress */
int sc_xe_ent; /* current early-xmit table entry */
int sc_xe_togo; /* # of packets to go at this ent */
int sc_carrier; /* has carrier */
u_int8_t sc_enaddr[ETHER_ADDR_LEN]; /* MAC address */
int eeprom_size; /* how large is the eeprom (in bytes) */
u_int16_t *eeprom_data; /* copy of the eeprom data */
#if NRND > 0
rndsource_element_t rnd_source; /* random source */
#endif
/* power management */
int (*sc_enable)(struct cs_softc *);
void (*sc_disable)(struct cs_softc *);
void *sc_powerhook;
/* DMA hooks */
void (*sc_dma_process_rx)(struct cs_softc *);
void (*sc_dma_chipinit)(struct cs_softc *);
void (*sc_dma_attach)(struct cs_softc *);
/* register access hooks */
u_int8_t (*sc_io_read_1)(struct cs_softc *, bus_size_t);
u_int16_t (*sc_io_read_2)(struct cs_softc *, bus_size_t);
void (*sc_io_read_multi_2)(struct cs_softc *, bus_size_t, u_int16_t *,
bus_size_t);
void (*sc_io_write_2)(struct cs_softc *, bus_size_t, u_int16_t);
void (*sc_io_write_multi_2)(struct cs_softc *, bus_size_t,
const u_int16_t *, bus_size_t);
u_int16_t (*sc_mem_read_2)(struct cs_softc *, bus_size_t);
void (*sc_mem_write_2)(struct cs_softc *, bus_size_t, u_int16_t);
void (*sc_mem_write_region_2)(struct cs_softc *, bus_size_t,
const u_int16_t *, bus_size_t);
};
#define IO_READ_1(sc, a) \
(sc)->sc_io_read_1 ? \
(sc)->sc_io_read_1((sc), (a)) : \
bus_space_read_1((sc)->sc_iot, (sc)->sc_ioh, (a))
#define IO_READ_2(sc, a) \
(sc)->sc_io_read_2 ? \
(sc)->sc_io_read_2((sc), (a)) : \
bus_space_read_2((sc)->sc_iot, (sc)->sc_ioh, (a))
#define IO_READ_MULTI_2(sc, a, b, c) \
if ((sc)->sc_io_read_multi_2) \
(sc)->sc_io_read_multi_2((sc), (a), (b), (c)); else \
bus_space_read_multi_2((sc)->sc_iot, (sc)->sc_ioh, (a), (b), (c))
#define IO_WRITE_2(sc, a, d) \
if ((sc)->sc_io_write_2) \
(sc)->sc_io_write_2((sc), (a), (d)); else \
bus_space_write_2((sc)->sc_iot, (sc)->sc_ioh, (a), (d))
#define IO_WRITE_MULTI_2(sc, a, d, c) \
if ((sc)->sc_io_write_multi_2) \
(sc)->sc_io_write_multi_2((sc), (a), (d), (c)); else \
bus_space_write_multi_2((sc)->sc_iot, (sc)->sc_ioh, (a), (d), (c))
#define MEM_READ_2(sc, a) \
(sc)->sc_mem_read_2 ? \
(sc)->sc_mem_read_2((sc), (a)) : \
bus_space_read_2((sc)->sc_memt, (sc)->sc_memh, (a))
#define MEM_WRITE_2(sc, a, d) \
if ((sc)->sc_mem_write_2) \
(sc)->sc_mem_write_2((sc), (a), (d)); else \
bus_space_write_2((sc)->sc_memt, (sc)->sc_memh, (a), (d))
#define MEM_WRITE_REGION_2(sc, a, d, c) \
if ((sc)->sc_mem_write_region_2) \
(sc)->sc_mem_write_region_2((sc), (a), (d), (c)); else \
bus_space_write_region_2((sc)->sc_memt, (sc)->sc_memh, (a), (d), (c))
/* Config Flags in cs_softc */
#define CFGFLG_MEM_MODE 0x0001
#define CFGFLG_USE_SA 0x0002
#define CFGFLG_IOCHRDY 0x0004
#define CFGFLG_DCDC_POL 0x0008
#define CFGFLG_DMA_MODE 0x0020
#define CFGFLG_ATTACHED 0x0040 /* XXX should not be here? */
#define CFGFLG_CARDBUS_HACK 0x0080
#define CFGFLG_ENABLED 0x0100 /* XXX should not be here? */
#define CFGFLG_PARSE_EEPROM 0x0200
#define CFGFLG_NOT_EEPROM 0x8000
/*
* Inlines for reading/writing the packet page area.
*/
static __inline u_int16_t _cs_read_port(struct cs_softc *, int);
static __inline u_int16_t
_cs_read_port(struct cs_softc *sc, int off)
{
u_int16_t result;
if (sc->sc_cfgflags & CFGFLG_CARDBUS_HACK) {
/*
* hack for EtherJet PCMCIA and cardbus (obtained from freebsd)
*
* EtherJet PCMCIA don't work with cardbus bridges
* (at least TI1250) without this hack.
*/
result = (IO_READ_1(sc, off) & 0xff);
result |= ((IO_READ_1(sc, off+1) & 0xff) << 8);
}
else {
result = IO_READ_2(sc, off);
}
return result;
}
static __inline u_int16_t _CS_READ_PACKET_PAGE_IO(struct cs_softc *, int);
static __inline u_int16_t
_CS_READ_PACKET_PAGE_IO(struct cs_softc *sc, int offset)
{
IO_WRITE_2(sc, PORT_PKTPG_PTR, offset);
return (_cs_read_port(sc, PORT_PKTPG_DATA));
}
static __inline u_int16_t CS_READ_PACKET_PAGE_IO(struct cs_softc *, int);
static __inline u_int16_t
CS_READ_PACKET_PAGE_IO(struct cs_softc *sc, int offset)
{
IO_WRITE_2(sc, PORT_PKTPG_PTR, offset);
return (IO_READ_2(sc, PORT_PKTPG_DATA));
}
#define CS_READ_PACKET_PAGE_MEM(sc, offset) \
MEM_READ_2((sc), (offset))
#define CS_READ_PACKET_PAGE(sc, offset) \
((sc)->sc_memorymode ? CS_READ_PACKET_PAGE_MEM((sc), (offset)) :\
_CS_READ_PACKET_PAGE_IO((sc), (offset)))
#define CS_WRITE_PACKET_PAGE_IO(sc, offset, val) \
do { \
IO_WRITE_2((sc), PORT_PKTPG_PTR, (offset)); \
IO_WRITE_2((sc), PORT_PKTPG_DATA, (val)); \
} while (0)
#define CS_WRITE_PACKET_PAGE_MEM(sc, offset, val) \
MEM_WRITE_2((sc), (offset), (val))
#define CS_WRITE_PACKET_PAGE(sc, offset, val) \
do { \
if ((sc)->sc_memorymode) \
CS_WRITE_PACKET_PAGE_MEM((sc), (offset), (val)); \
else \
CS_WRITE_PACKET_PAGE_IO((sc), (offset), (val)); \
} while (0)
#define CS_READ_PORT(sc, off)\
IO_READ_2((sc), (off))
#define CS_WRITE_PORT(sc, off, val)\
IO_WRITE_2((sc), (off), (val))
/* Return Status */
#define CS_ERROR -1
#define CS_OK 1
/* Media Type in cs_softc */
#define MEDIA_AUI 0x0001
#define MEDIA_10BASE2 0x0002
#define MEDIA_10BASET 0x0003
/* Miscellaneous definitions */
#define MAXLOOP 0x8888
int cs_attach(struct cs_softc *, u_int8_t *, int *, int, int);
int cs_detach(struct cs_softc *);
int cs_verify_eeprom(struct cs_softc *);
int cs_read_eeprom(struct cs_softc *, int, u_int16_t *);
int cs_intr(void *);
int cs_activate(struct device *, enum devact);
void cs_ether_input(struct cs_softc *, struct mbuf *);
void cs_print_rx_errors(struct cs_softc *, u_int16_t);
int cs_init(struct ifnet *);
#define CS_IS_ENABLED(sc) ((sc)->sc_cfgflags & CFGFLG_ENABLED)
#endif /* _DEV_IC_CS89X0VAR_H_ */