Merge tag 'for-v4.6-rc/omap-fixes-a' of git://git.kernel.org/pub/scm/linux/kernel...
[linux-2.6-block.git] / drivers / net / ethernet / amd / 7990.h
CommitLineData
6aa20a22 1/*
1da177e4
LT
2 * 7990.h -- LANCE ethernet IC generic routines.
3 * This is an attempt to separate out the bits of various ethernet
4 * drivers that are common because they all use the AMD 7990 LANCE
5 * (Local Area Network Controller for Ethernet) chip.
6aa20a22 6 *
1da177e4
LT
7 * Copyright (C) 05/1998 Peter Maydell <pmaydell@chiark.greenend.org.uk>
8 *
9 * Most of this stuff was obtained by looking at other LANCE drivers,
10 * in particular a2065.[ch]. The AMD C-LANCE datasheet was also helpful.
11 */
12
13#ifndef _7990_H
14#define _7990_H
15
16/* The lance only has two register locations. We communicate mostly via memory. */
17#define LANCE_RDP 0 /* Register Data Port */
18#define LANCE_RAP 2 /* Register Address Port */
19
20/* Transmit/receive ring definitions.
21 * We allow the specific drivers to override these defaults if they want to.
22 * NB: according to lance.c, increasing the number of buffers is a waste
23 * of space and reduces the chance that an upper layer will be able to
24 * reorder queued Tx packets based on priority. [Clearly there is a minimum
25 * limit too: too small and we drop rx packets and can't tx at full speed.]
26 * 4+4 seems to be the usual setting; the atarilance driver uses 3 and 5.
27 */
28
29/* Blast! This won't work. The problem is that we can't specify a default
30 * setting because that would cause the lance_init_block struct to be
31 * too long (and overflow the RAM on shared-memory cards like the HP LANCE.
32 */
33#ifndef LANCE_LOG_TX_BUFFERS
34#define LANCE_LOG_TX_BUFFERS 1
35#define LANCE_LOG_RX_BUFFERS 3
36#endif
37
a8ab77a8
GU
38#define TX_RING_SIZE (1 << LANCE_LOG_TX_BUFFERS)
39#define RX_RING_SIZE (1 << LANCE_LOG_RX_BUFFERS)
40#define TX_RING_MOD_MASK (TX_RING_SIZE - 1)
41#define RX_RING_MOD_MASK (RX_RING_SIZE - 1)
42#define TX_RING_LEN_BITS ((LANCE_LOG_TX_BUFFERS) << 29)
43#define RX_RING_LEN_BITS ((LANCE_LOG_RX_BUFFERS) << 29)
44#define PKT_BUFF_SIZE (1544)
45#define RX_BUFF_SIZE PKT_BUFF_SIZE
46#define TX_BUFF_SIZE PKT_BUFF_SIZE
1da177e4
LT
47
48/* Each receive buffer is described by a receive message descriptor (RMD) */
49struct lance_rx_desc {
a8ab77a8
GU
50 volatile unsigned short rmd0; /* low address of packet */
51 volatile unsigned char rmd1_bits; /* descriptor bits */
52 volatile unsigned char rmd1_hadr; /* high address of packet */
53 volatile short length; /* This length is 2s complement (negative)!
54 * Buffer length */
55 volatile unsigned short mblength; /* Actual number of bytes received */
1da177e4 56};
6aa20a22 57
1da177e4
LT
58/* Ditto for TMD: */
59struct lance_tx_desc {
a8ab77a8
GU
60 volatile unsigned short tmd0; /* low address of packet */
61 volatile unsigned char tmd1_bits; /* descriptor bits */
62 volatile unsigned char tmd1_hadr; /* high address of packet */
63 volatile short length; /* Length is 2s complement (negative)! */
1da177e4
LT
64 volatile unsigned short misc;
65};
66
67/* There are three memory structures accessed by the LANCE:
68 * the initialization block, the receive and transmit descriptor rings,
69 * and the data buffers themselves. In fact we might as well put the
70 * init block,the Tx and Rx rings and the buffers together in memory:
71 */
72struct lance_init_block {
a8ab77a8
GU
73 volatile unsigned short mode; /* Pre-set mode (reg. 15) */
74 volatile unsigned char phys_addr[6]; /* Physical ethernet address */
75 volatile unsigned filter[2]; /* Multicast filter (64 bits) */
76
77 /* Receive and transmit ring base, along with extra bits. */
78 volatile unsigned short rx_ptr; /* receive descriptor addr */
79 volatile unsigned short rx_len; /* receive len and high addr */
80 volatile unsigned short tx_ptr; /* transmit descriptor addr */
81 volatile unsigned short tx_len; /* transmit len and high addr */
82
83 /* The Tx and Rx ring entries must be aligned on 8-byte boundaries.
84 * This will be true if this whole struct is 8-byte aligned.
85 */
86 volatile struct lance_tx_desc btx_ring[TX_RING_SIZE];
87 volatile struct lance_rx_desc brx_ring[RX_RING_SIZE];
88
89 volatile char tx_buf[TX_RING_SIZE][TX_BUFF_SIZE];
90 volatile char rx_buf[RX_RING_SIZE][RX_BUFF_SIZE];
91 /* we use this just to make the struct big enough that we can move its startaddr
92 * in order to force alignment to an eight byte boundary.
93 */
1da177e4
LT
94};
95
96/* This is where we keep all the stuff the driver needs to know about.
97 * I'm definitely unhappy about the mechanism for allowing specific
98 * drivers to add things...
99 */
a8ab77a8 100struct lance_private {
4ffa8fcd 101 const char *name;
1da177e4 102 unsigned long base;
a8ab77a8
GU
103 volatile struct lance_init_block *init_block; /* CPU address of RAM */
104 volatile struct lance_init_block *lance_init_block; /* LANCE address of RAM */
6aa20a22 105
a8ab77a8
GU
106 int rx_new, tx_new;
107 int rx_old, tx_old;
6aa20a22 108
a8ab77a8
GU
109 int lance_log_rx_bufs, lance_log_tx_bufs;
110 int rx_ring_mod_mask, tx_ring_mod_mask;
6aa20a22 111
a8ab77a8
GU
112 int tpe; /* TPE is selected */
113 int auto_select; /* cable-selection is by carrier */
114 unsigned short busmaster_regval;
1da177e4 115
a8ab77a8 116 unsigned int irq; /* IRQ to register */
6aa20a22 117
a8ab77a8
GU
118 /* This is because the HP LANCE is disgusting and you have to check
119 * a DIO-specific register every time you read/write the LANCE regs :-<
120 * [could we get away with making these some sort of macro?]
121 */
122 void (*writerap)(void *, unsigned short);
123 void (*writerdp)(void *, unsigned short);
124 unsigned short (*readrdp)(void *);
1da177e4
LT
125 spinlock_t devlock;
126 char tx_full;
127};
128
129/*
a8ab77a8 130 * Am7990 Control and Status Registers
1da177e4 131 */
a8ab77a8
GU
132#define LE_CSR0 0x0000 /* LANCE Controller Status */
133#define LE_CSR1 0x0001 /* IADR[15:0] (bit0==0 ie word aligned) */
134#define LE_CSR2 0x0002 /* IADR[23:16] (high bits reserved) */
135#define LE_CSR3 0x0003 /* Misc */
1da177e4
LT
136
137/*
138 * Bit definitions for CSR0 (LANCE Controller Status)
139 */
a8ab77a8
GU
140#define LE_C0_ERR 0x8000 /* Error = BABL | CERR | MISS | MERR */
141#define LE_C0_BABL 0x4000 /* Babble: Transmitted too many bits */
142#define LE_C0_CERR 0x2000 /* No Heartbeat (10BASE-T) */
143#define LE_C0_MISS 0x1000 /* Missed Frame (no rx buffer to put it in) */
144#define LE_C0_MERR 0x0800 /* Memory Error */
145#define LE_C0_RINT 0x0400 /* Receive Interrupt */
146#define LE_C0_TINT 0x0200 /* Transmit Interrupt */
147#define LE_C0_IDON 0x0100 /* Initialization Done */
148#define LE_C0_INTR 0x0080 /* Interrupt Flag
149 = BABL | MISS | MERR | RINT | TINT | IDON */
150#define LE_C0_INEA 0x0040 /* Interrupt Enable */
151#define LE_C0_RXON 0x0020 /* Receive On */
152#define LE_C0_TXON 0x0010 /* Transmit On */
153#define LE_C0_TDMD 0x0008 /* Transmit Demand */
154#define LE_C0_STOP 0x0004 /* Stop */
155#define LE_C0_STRT 0x0002 /* Start */
156#define LE_C0_INIT 0x0001 /* Initialize */
1da177e4
LT
157
158
159/*
160 * Bit definitions for CSR3
161 */
a8ab77a8
GU
162#define LE_C3_BSWP 0x0004 /* Byte Swap (on for big endian byte order) */
163#define LE_C3_ACON 0x0002 /* ALE Control (on for active low ALE) */
164#define LE_C3_BCON 0x0001 /* Byte Control */
1da177e4
LT
165
166
167/*
168 * Mode Flags
169 */
a8ab77a8 170#define LE_MO_PROM 0x8000 /* Promiscuous Mode */
1da177e4
LT
171/* these next ones 0x4000 -- 0x0080 are not available on the LANCE 7990,
172 * but they are in NetBSD's am7990.h, presumably for backwards-compatible chips
173 */
a8ab77a8
GU
174#define LE_MO_DRCVBC 0x4000 /* disable receive broadcast */
175#define LE_MO_DRCVPA 0x2000 /* disable physical address detection */
176#define LE_MO_DLNKTST 0x1000 /* disable link status */
177#define LE_MO_DAPC 0x0800 /* disable automatic polarity correction */
178#define LE_MO_MENDECL 0x0400 /* MENDEC loopback mode */
179#define LE_MO_LRTTSEL 0x0200 /* lower RX threshold / TX mode selection */
180#define LE_MO_PSEL1 0x0100 /* port selection bit1 */
181#define LE_MO_PSEL0 0x0080 /* port selection bit0 */
1da177e4 182/* and this one is from the C-LANCE data sheet... */
a8ab77a8
GU
183#define LE_MO_EMBA 0x0080 /* Enable Modified Backoff Algorithm
184 (C-LANCE, not original LANCE) */
185#define LE_MO_INTL 0x0040 /* Internal Loopback */
186#define LE_MO_DRTY 0x0020 /* Disable Retry */
187#define LE_MO_FCOLL 0x0010 /* Force Collision */
188#define LE_MO_DXMTFCS 0x0008 /* Disable Transmit CRC */
189#define LE_MO_LOOP 0x0004 /* Loopback Enable */
190#define LE_MO_DTX 0x0002 /* Disable Transmitter */
191#define LE_MO_DRX 0x0001 /* Disable Receiver */
1da177e4
LT
192
193
194/*
195 * Receive Flags
196 */
a8ab77a8
GU
197#define LE_R1_OWN 0x80 /* LANCE owns the descriptor */
198#define LE_R1_ERR 0x40 /* Error */
199#define LE_R1_FRA 0x20 /* Framing Error */
200#define LE_R1_OFL 0x10 /* Overflow Error */
201#define LE_R1_CRC 0x08 /* CRC Error */
202#define LE_R1_BUF 0x04 /* Buffer Error */
203#define LE_R1_SOP 0x02 /* Start of Packet */
204#define LE_R1_EOP 0x01 /* End of Packet */
205#define LE_R1_POK 0x03 /* Packet is complete: SOP + EOP */
1da177e4
LT
206
207
208/*
209 * Transmit Flags
210 */
a8ab77a8
GU
211#define LE_T1_OWN 0x80 /* LANCE owns the descriptor */
212#define LE_T1_ERR 0x40 /* Error */
213#define LE_T1_RES 0x20 /* Reserved, LANCE writes this with a zero */
214#define LE_T1_EMORE 0x10 /* More than one retry needed */
215#define LE_T1_EONE 0x08 /* One retry needed */
216#define LE_T1_EDEF 0x04 /* Deferred */
217#define LE_T1_SOP 0x02 /* Start of Packet */
218#define LE_T1_EOP 0x01 /* End of Packet */
219#define LE_T1_POK 0x03 /* Packet is complete: SOP + EOP */
1da177e4
LT
220
221/*
222 * Error Flags
223 */
a8ab77a8
GU
224#define LE_T3_BUF 0x8000 /* Buffer Error */
225#define LE_T3_UFL 0x4000 /* Underflow Error */
226#define LE_T3_LCOL 0x1000 /* Late Collision */
227#define LE_T3_CLOS 0x0800 /* Loss of Carrier */
228#define LE_T3_RTY 0x0400 /* Retry Error */
229#define LE_T3_TDR 0x03ff /* Time Domain Reflectometry */
1da177e4
LT
230
231/* Miscellaneous useful macros */
232
a8ab77a8
GU
233#define TX_BUFFS_AVAIL ((lp->tx_old <= lp->tx_new) ? \
234 lp->tx_old + lp->tx_ring_mod_mask - lp->tx_new : \
235 lp->tx_old - lp->tx_new - 1)
1da177e4
LT
236
237/* The LANCE only uses 24 bit addresses. This does the obvious thing. */
238#define LANCE_ADDR(x) ((int)(x) & ~0xff000000)
239
240/* Now the prototypes we export */
44da5c2f 241int lance_open(struct net_device *dev);
a8ab77a8
GU
242int lance_close(struct net_device *dev);
243int lance_start_xmit(struct sk_buff *skb, struct net_device *dev);
244void lance_set_multicast(struct net_device *dev);
44da5c2f 245void lance_tx_timeout(struct net_device *dev);
1da177e4 246#ifdef CONFIG_NET_POLL_CONTROLLER
44da5c2f 247void lance_poll(struct net_device *dev);
1da177e4
LT
248#endif
249
250#endif /* ndef _7990_H */