NetBSD/sys/arch/pica/dev/if_sn.h

347 lines
15 KiB
C
Raw Normal View History

/*
* Copyright (c) 1991 Algorithmics Ltd (http://www.algor.co.uk)
* You may use, copy, and modify this program so long as you retain the
* copyright line.
*/
/*
* if_sonic.h -- National Semiconductor DP83932BVF (SONIC)
*/
/*
* Accessing SONIC data structures and registers as 32 bit values
* makes code endianess independent. The SONIC is however always in
* bigendian mode so it is necessary to ensure that data structures shared
* between the CPU and the SONIC are always in bigendian order.
*/
/*
* Receive Resource Descriptor
* This structure describes the buffers into which packets
* will be received. Note that more than one packet may be
* packed into a single buffer if constraints permit.
*/
#if SONICDW == 32
struct RXrsrc {
u_long buff_ptrlo; /* buffer address LO */
u_long buff_ptrhi; /* buffer address HI */
u_long buff_wclo; /* buffer size (16bit words) LO */
u_long buff_wchi; /* buffer size (16bit words) HI */
};
#endif
/*
* Receive Descriptor
* This structure holds information about packets received.
*/
#if SONICDW == 32
struct RXpkt {
u_long status; /* + receive status */
u_long byte_count; /* + packet byte count (including FCS) */
u_long pkt_ptrlo; /* + packet data LO (in RBA) */
u_long pkt_ptrhi; /* + packet data HI (in RBA) */
u_long seq_no; /* + RBA sequence numbers */
u_long rlink; /* link to next receive descriptor */
u_long in_use; /* + packet available to SONIC */
u_long pad; /* pad to multiple of 16 bytes */
};
#endif
#define RBASEQ(x) (((x)>>8)&0xff)
#define PSNSEQ(x) ((x) & 0xff)
/*
* Transmit Descriptor
* This structure holds information about packets to be transmitted.
*/
#define FRAGMAX 31 /* maximum number of fragments in a packet */
#if SONICDW == 32
struct TXpkt {
u_long status; /* + transmitted packet status */
u_long config; /* transmission configuration */
u_long pkt_size; /* entire packet size in bytes */
u_long frag_count; /* # fragments in packet */
union {
struct {
u_long _frag_ptrlo; /* pointer to packet fragment LO */
u_long _frag_ptrhi; /* pointer to packet fragment HI */
u_long _frag_size; /* fragment size */
} u_frag;
struct {
u_long _tlink; /* link to next transmit descriptor */
} u_link;
} u[FRAGMAX+1]; /* +1 makes tcp->u[FRAGMAX].u_link.link valid! */
};
#endif
#define frag_ptrlo u_frag._frag_ptrlo
#define frag_ptrhi u_frag._frag_ptrhi
#define frag_size u_frag._frag_size
#define tlink u_link._tlink
#define EOL 0x0001 /* end of list marker for link fields */
#define MAXCAM 16 /* number of user entries in CAM */
#if SONICDW == 32
struct CDA {
struct {
u_long cam_ep; /* CAM Entry Pointer */
u_long cam_ap0; /* CAM Address Port 0 xx-xx-xx-xx-YY-YY */
u_long cam_ap1; /* CAM Address Port 1 xx-xx-YY-YY-xxxx */
u_long cam_ap2; /* CAM Address Port 2 YY-YY-xx-xx-xx-xx */
} desc[MAXCAM];
u_long enable; /* mask enabling CAM entries */
};
#endif
/*
* SONIC registers as seen by the processor
*/
struct sonic_reg {
volatile u_long s_cr; /* 00: Command */
volatile u_long s_dcr; /* 01: Data Configuration */
volatile u_long s_rcr; /* 02: Receive Control */
volatile u_long s_tcr; /* 03: Transmit Control */
volatile u_long s_imr; /* 04: Interrupt Mask */
volatile u_long s_isr; /* 05: Interrupt Status */
volatile u_long s_utda; /* 06: Upper Transmit Descriptor Address */
volatile u_long s_ctda; /* 07: Current Transmit Descriptor Address */
volatile u_long _s_tps; /* 08* Transmit Packet Size */
volatile u_long _s_tfc; /* 09* Transmit Fragment Count */
volatile u_long _s_tsa0; /* 0a* Transmit Start Address 0 */
volatile u_long _s_tsa1; /* 0b* Transmit Start Address 1 */
volatile u_long _s_tfs; /* 0c* Transmit Fragment Size */
volatile u_long s_urda; /* 0d: Upper Receive Descriptor Address */
volatile u_long s_crda; /* 0e: Current Receive Descriptor Address */
volatile u_long _s_crba0; /* 0f* Current Receive Buffer Address 0 */
volatile u_long _s_crba1; /* 10* Current Receive Buffer Address 1 */
volatile u_long _s_rbwc0; /* 11* Remaining Buffer Word Count 0 */
volatile u_long _s_rbwc1; /* 12* Remaining Buffer Word Count 1 */
volatile u_long s_eobc; /* 13: End Of Buffer Word Count */
volatile u_long s_urra; /* 14: Upper Receive Resource Address */
volatile u_long s_rsa; /* 15: Resource Start Address */
volatile u_long s_rea; /* 16: Resource End Address */
volatile u_long s_rrp; /* 17: Resource Read Pointer */
volatile u_long s_rwp; /* 18: Resource Write Pointer */
volatile u_long _s_trba0; /* 19* Temporary Receive Buffer Address 0 */
volatile u_long _s_trba1; /* 1a* Temporary Receive Buffer Address 1 */
volatile u_long _s_tbwc0; /* 1b* Temporary Buffer Word Count 0 */
volatile u_long _s_tbwc1; /* 1c* Temporary Buffer Word Count 1 */
volatile u_long _s_addr0; /* 1d* Address Generator 0 */
volatile u_long _s_addr1; /* 1e* Address Generator 1 */
volatile u_long _s_llfa; /* 1f* Last Link Field Address */
volatile u_long _s_ttda; /* 20* Temp Transmit Descriptor Address */
volatile u_long s_cep; /* 21: CAM Entry Pointer */
volatile u_long s_cap2; /* 22: CAM Address Port 2 */
volatile u_long s_cap1; /* 23: CAM Address Port 1 */
volatile u_long s_cap0; /* 24: CAM Address Port 0 */
volatile u_long s_ce; /* 25: CAM Enable */
volatile u_long s_cdp; /* 26: CAM Descriptor Pointer */
volatile u_long s_cdc; /* 27: CAM Descriptor Count */
volatile u_long s_sr; /* 28: Silicon Revision */
volatile u_long s_wt0; /* 29: Watchdog Timer 0 */
volatile u_long s_wt1; /* 2a: Watchdog Timer 1 */
volatile u_long s_rsc; /* 2b: Receive Sequence Counter */
volatile u_long s_crct; /* 2c: CRC Error Tally */
volatile u_long s_faet; /* 2d: FAE Tally */
volatile u_long s_mpt; /* 2e: Missed Packet Tally */
volatile u_long _s_mdt; /* 2f* Maximum Deferral Timer */
volatile u_long _s_rtc; /* 30* Receive Test Control */
volatile u_long _s_ttc; /* 31* Transmit Test Control */
volatile u_long _s_dtc; /* 32* DMA Test Control */
volatile u_long _s_cc0; /* 33* CAM Comparison 0 */
volatile u_long _s_cc1; /* 34* CAM Comparison 1 */
volatile u_long _s_cc2; /* 35* CAM Comparison 2 */
volatile u_long _s_cm; /* 36* CAM Match */
volatile u_long :32; /* 37* reserved */
volatile u_long :32; /* 38* reserved */
volatile u_long _s_rbc; /* 39* Receiver Byte Count */
volatile u_long :32; /* 3a* reserved */
volatile u_long _s_tbo; /* 3b* Transmitter Backoff Counter */
volatile u_long _s_trc; /* 3c* Transmitter Random Counter */
volatile u_long _s_tbm; /* 3d* Transmitter Backoff Mask */
volatile u_long :32; /* 3e* Reserved */
volatile u_long s_dcr2; /* 3f Data Configuration 2 (AVF) */
};
/*
* Register Interpretations
*/
/*
* The command register is used for issuing commands to the SONIC.
* With the exception of CR_RST, the bit is reset when the operation
* completes.
*/
#define CR_LCAM 0x0200 /* load CAM with descriptor at s_cdp */
#define CR_RRRA 0x0100 /* read next RRA descriptor at s_rrp */
#define CR_RST 0x0080 /* software reset */
#define CR_ST 0x0020 /* start timer */
#define CR_STP 0x0010 /* stop timer */
#define CR_RXEN 0x0008 /* receiver enable */
#define CR_RXDIS 0x0004 /* receiver disable */
#define CR_TXP 0x0002 /* transmit packets */
#define CR_HTX 0x0001 /* halt transmission */
/*
* The data configuration register establishes the SONIC's bus cycle
* operation. This register can only be accessed when the SONIC is in
* reset mode (s_cr.CR_RST is set.)
*/
#define DCR_EXBUS 0x8000 /* extended bus mode (AVF) */
#define DCR_LBR 0x2000 /* latched bus retry */
#define DCR_PO1 0x1000 /* programmable output 1 */
#define DCR_PO0 0x0800 /* programmable output 0 */
#define DCR_STERM 0x0400 /* synchronous termination */
#define DCR_USR1 0x0200 /* reflects USR1 input pin */
#define DCR_USR0 0x0100 /* reflects USR0 input pin */
#define DCR_WC1 0x0080 /* wait state control 1 */
#define DCR_WC0 0x0040 /* wait state control 0 */
#define DCR_DW 0x0020 /* data width select */
#define DCR_BMS 0x0010 /* DMA block mode select */
#define DCR_RFT1 0x0008 /* receive FIFO threshold control 1 */
#define DCR_RFT0 0x0004 /* receive FIFO threshold control 0 */
#define DCR_TFT1 0x0002 /* transmit FIFO threshold control 1 */
#define DCR_TFT0 0x0001 /* transmit FIFO threshold control 0 */
/* data configuration register aliases */
#define DCR_SYNC DCR_STERM /* synchronous (memory cycle 2 clocks) */
#define DCR_ASYNC 0 /* asynchronous (memory cycle 3 clocks) */
#define DCR_WAIT0 0 /* 0 wait states added */
#define DCR_WAIT1 DCR_WC0 /* 1 wait state added */
#define DCR_WAIT2 DCR_WC1 /* 2 wait states added */
#define DCR_WAIT3 (DCR_WC1|DCR_WC0) /* 3 wait states added */
#define DCR_DW16 0 /* use 16-bit DMA accesses */
#define DCR_DW32 DCR_DW /* use 32-bit DMA accesses */
#define DCR_DMAEF 0 /* DMA until TX/RX FIFO has emptied/filled */
#define DCR_DMABLOCK DCR_BMS /* DMA until RX/TX threshold crossed */
#define DCR_RFT4 0 /* receive threshold 4 bytes */
#define DCR_RFT8 DCR_RFT0 /* receive threshold 8 bytes */
#define DCR_RFT16 DCR_RFT1 /* receive threshold 16 bytes */
#define DCR_RFT24 (DCR_RFT1|DCR_RFT0) /* receive threshold 24 bytes */
#define DCR_TFT8 0 /* transmit threshold 8 bytes */
#define DCR_TFT16 DCR_TFT0 /* transmit threshold 16 bytes */
#define DCR_TFT24 DCR_TFT1 /* transmit threshold 24 bytes */
#define DCR_TFT28 (DCR_TFT1|DCR_TFT0) /* transmit threshold 28 bytes */
/*
* The receive control register is used to filter incoming packets and
* provides status information on packets received.
* The contents of the register are copied into the RXpkt.status field
* when a packet is received. RCR_MC - RCR_PRX are then reset.
*/
#define RCR_ERR 0x8000 /* accept packets with CRC errors */
#define RCR_RNT 0x4000 /* accept runt (length < 64) packets */
#define RCR_BRD 0x2000 /* accept broadcast packets */
#define RCR_PRO 0x1000 /* accept all physical address packets */
#define RCR_AMC 0x0800 /* accept all multicast packets */
#define RCR_LB1 0x0400 /* loopback control 1 */
#define RCR_LB0 0x0200 /* loopback control 0 */
#define RCR_MC 0x0100 /* multicast packet received */
#define RCR_BC 0x0080 /* broadcast packet received */
#define RCR_LPKT 0x0040 /* last packet in RBA (RBWC < EOBC) */
#define RCR_CRS 0x0020 /* carrier sense activity */
#define RCR_COL 0x0010 /* collision activity */
#define RCR_CRC 0x0008 /* CRC error */
#define RCR_FAE 0x0004 /* frame alignment error */
#define RCR_LBK 0x0002 /* loopback packet received */
#define RCR_PRX 0x0001 /* packet received without errors */
/* receiver control register aliases */
/* the loopback control bits provide the following options */
#define RCR_LBNONE 0 /* no loopback - normal operation */
#define RCR_LBMAC RCR_LB0 /* MAC loopback */
#define RCR_LBENDEC RCR_LB1 /* ENDEC loopback */
#define RCR_LBTRANS (RCR_LB1|RCR_LB0) /* transceiver loopback */
/*
* The transmit control register controls the SONIC's transmit operations.
* TCR_PINT - TCR_EXDIS are loaded from the TXpkt.config field at the
* start of transmission. TCR_EXD-TCR_PTX are cleared at the beginning
* of transmission and updated when the transmission is completed.
*/
#define TCR_PINT 0x8000 /* interrupt when transmission starts */
#define TCR_POWC 0x4000 /* program out of window collision timer */
#define TCR_CRCI 0x2000 /* transmit packet without 4 byte FCS */
#define TCR_EXDIS 0x1000 /* disable excessive deferral timer */
#define TCR_EXD 0x0400 /* excessive deferrals occurred (>3.2ms) */
#define TCR_DEF 0x0200 /* deferred transmissions occurred */
#define TCR_NCRS 0x0100 /* carrier not present during transmission */
#define TCR_CRSL 0x0080 /* carrier lost during transmission */
#define TCR_EXC 0x0040 /* excessive collisions (>16) detected */
#define TCR_OWC 0x0020 /* out of window (bad) collision occurred */
#define TCR_PMB 0x0008 /* packet monitored bad - the tansmitted
* packet had a bad source address or CRC */
#define TCR_FU 0x0004 /* FIFO underrun (memory access failed) */
#define TCR_BCM 0x0002 /* byte count mismatch (TXpkt.pkt_size
* != sum(TXpkt.frag_size) */
#define TCR_PTX 0x0001 /* packet transmitted without errors */
/* transmit control register aliases */
#define TCR_OWCSFD 0 /* start after start of frame delimiter */
#define TCR_OWCPRE TCR_POWC /* start after first bit of preamble */
/*
* The interrupt mask register masks the interrupts that
* are generated from the interrupt status register.
* All reserved bits should be written with 0.
*/
#define IMR_BREN 0x4000 /* bus retry occurred enable */
#define IMR_HBLEN 0x2000 /* heartbeat lost enable */
#define IMR_LCDEN 0x1000 /* load CAM done interrupt enable */
#define IMR_PINTEN 0x0800 /* programmable interrupt enable */
#define IMR_PRXEN 0x0400 /* packet received enable */
#define IMR_PTXEN 0x0200 /* packet transmitted enable */
#define IMR_TXEREN 0x0100 /* transmit error enable */
#define IMR_TCEN 0x0080 /* timer complete enable */
#define IMR_RDEEN 0x0040 /* receive descriptors exhausted enable */
#define IMR_RBEEN 0x0020 /* receive buffers exhausted enable */
#define IMR_RBAEEN 0x0010 /* receive buffer area exceeded enable */
#define IMR_CRCEN 0x0008 /* CRC tally counter rollover enable */
#define IMR_FAEEN 0x0004 /* FAE tally counter rollover enable */
#define IMR_MPEN 0x0002 /* MP tally counter rollover enable */
#define IMR_RFOEN 0x0001 /* receive FIFO overrun enable */
/*
* The interrupt status register indicates the source of an interrupt when
* the INT pin goes active. The interrupt is acknowledged by writing
* the appropriate bit(s) in this register.
*/
#define ISR_ALL 0xffff /* all interrupts */
#define ISR_BR 0x4000 /* bus retry occurred */
#define ISR_HBL 0x2000 /* CD heartbeat lost */
#define ISR_LCD 0x1000 /* load CAM command has completed */
#define ISR_PINT 0x0800 /* programmed interrupt from TXpkt.config */
#define ISR_PKTRX 0x0400 /* packet received */
#define ISR_TXDN 0x0200 /* no remaining packets to be transmitted */
#define ISR_TXER 0x0100 /* packet transmission caused error */
#define ISR_TC 0x0080 /* timer complete */
#define ISR_RDE 0x0040 /* receive descriptors exhausted */
#define ISR_RBE 0x0020 /* receive buffers exhausted */
#define ISR_RBAE 0x0010 /* receive buffer area exceeded */
#define ISR_CRC 0x0008 /* CRC tally counter rollover */
#define ISR_FAE 0x0004 /* FAE tally counter rollover */
#define ISR_MP 0x0002 /* MP tally counter rollover */
#define ISR_RFO 0x0001 /* receive FIFO overrun */
/*
* The second data configuration register allows additional user defined
* pins to be controlled. These bits are only available if s_dcr.DCR_EXBUS
* is set.
*/
#define DCR2_EXPO3 0x8000 /* EXUSR3 output */
#define DCR2_EXPO2 0x4000 /* EXUSR2 output */
#define DCR2_EXPO1 0x2000 /* EXUSR1 output */
#define DCR2_EXPO0 0x1000 /* EXUSR0 output */
#define DCR2_PHL 0x0010 /* extend HOLD signal by 1/2 clock */
#define DCR2_LRDY 0x0008 /* set latched ready mode */
#define DCR2_PCM 0x0004 /* packet compress on match */
#define DCR2_PCNM 0x0002 /* packet compress on mismatch */
#define DCR2_RJM 0x0001 /* reject on match */