OpenCores
URL https://opencores.org/ocsvn/test_project/test_project/trunk

Subversion Repositories test_project

[/] [test_project/] [trunk/] [linux_sd_driver/] [drivers/] [net/] [7990.h] - Blame information for rev 62

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 62 marcus.erl
/*
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.
6
 *
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
 
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
47
 
48
/* Each receive buffer is described by a receive message descriptor (RMD) */
49
struct lance_rx_desc {
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
                                     */
56
        volatile unsigned short mblength;    /* Actual number of bytes received */
57
};
58
 
59
/* Ditto for TMD: */
60
struct lance_tx_desc {
61
        volatile unsigned short tmd0;        /* low address of packet */
62
        volatile unsigned char  tmd1_bits;   /* descriptor bits */
63
        volatile unsigned char  tmd1_hadr;   /* high address of packet */
64
        volatile short    length;                   /* Length is 2s complement (negative)! */
65
        volatile unsigned short misc;
66
};
67
 
68
/* There are three memory structures accessed by the LANCE:
69
 * the initialization block, the receive and transmit descriptor rings,
70
 * and the data buffers themselves. In fact we might as well put the
71
 * init block,the Tx and Rx rings and the buffers together in memory:
72
 */
73
struct lance_init_block {
74
        volatile unsigned short mode;            /* Pre-set mode (reg. 15) */
75
        volatile unsigned char phys_addr[6];     /* Physical ethernet address */
76
        volatile unsigned filter[2];             /* Multicast filter (64 bits) */
77
 
78
        /* Receive and transmit ring base, along with extra bits. */
79
        volatile unsigned short rx_ptr;          /* receive descriptor addr */
80
        volatile unsigned short rx_len;          /* receive len and high addr */
81
        volatile unsigned short tx_ptr;          /* transmit descriptor addr */
82
        volatile unsigned short tx_len;          /* transmit len and high addr */
83
 
84
        /* The Tx and Rx ring entries must be aligned on 8-byte boundaries.
85
         * This will be true if this whole struct is 8-byte aligned.
86
         */
87
        volatile struct lance_tx_desc btx_ring[TX_RING_SIZE];
88
        volatile struct lance_rx_desc brx_ring[RX_RING_SIZE];
89
 
90
        volatile char   tx_buf [TX_RING_SIZE][TX_BUFF_SIZE];
91
        volatile char   rx_buf [RX_RING_SIZE][RX_BUFF_SIZE];
92
        /* we use this just to make the struct big enough that we can move its startaddr
93
         * in order to force alignment to an eight byte boundary.
94
         */
95
};
96
 
97
/* This is where we keep all the stuff the driver needs to know about.
98
 * I'm definitely unhappy about the mechanism for allowing specific
99
 * drivers to add things...
100
 */
101
struct lance_private
102
{
103
        char *name;
104
        unsigned long base;
105
        volatile struct lance_init_block *init_block; /* CPU address of RAM */
106
        volatile struct lance_init_block *lance_init_block; /* LANCE address of RAM */
107
 
108
        int rx_new, tx_new;
109
        int rx_old, tx_old;
110
 
111
        int lance_log_rx_bufs, lance_log_tx_bufs;
112
        int rx_ring_mod_mask, tx_ring_mod_mask;
113
 
114
        int tpe;                                  /* TPE is selected */
115
        int auto_select;                          /* cable-selection is by carrier */
116
        unsigned short busmaster_regval;
117
 
118
        unsigned int irq;                         /* IRQ to register */
119
 
120
        /* This is because the HP LANCE is disgusting and you have to check
121
         * a DIO-specific register every time you read/write the LANCE regs :-<
122
         * [could we get away with making these some sort of macro?]
123
         */
124
        void (*writerap)(void *, unsigned short);
125
        void (*writerdp)(void *, unsigned short);
126
        unsigned short (*readrdp)(void *);
127
        spinlock_t devlock;
128
        char tx_full;
129
};
130
 
131
/*
132
 *              Am7990 Control and Status Registers
133
 */
134
#define LE_CSR0         0x0000          /* LANCE Controller Status */
135
#define LE_CSR1         0x0001          /* IADR[15:0] (bit0==0 ie word aligned) */
136
#define LE_CSR2         0x0002          /* IADR[23:16] (high bits reserved) */
137
#define LE_CSR3         0x0003          /* Misc */
138
 
139
/*
140
 *              Bit definitions for CSR0 (LANCE Controller Status)
141
 */
142
#define LE_C0_ERR       0x8000          /* Error = BABL | CERR | MISS | MERR */
143
#define LE_C0_BABL      0x4000          /* Babble: Transmitted too many bits */
144
#define LE_C0_CERR      0x2000          /* No Heartbeat (10BASE-T) */
145
#define LE_C0_MISS      0x1000          /* Missed Frame (no rx buffer to put it in) */
146
#define LE_C0_MERR      0x0800          /* Memory Error */
147
#define LE_C0_RINT      0x0400          /* Receive Interrupt */
148
#define LE_C0_TINT      0x0200          /* Transmit Interrupt */
149
#define LE_C0_IDON      0x0100          /* Initialization Done */
150
#define LE_C0_INTR      0x0080          /* Interrupt Flag
151
                                         = BABL | MISS | MERR | RINT | TINT | IDON */
152
#define LE_C0_INEA      0x0040          /* Interrupt Enable */
153
#define LE_C0_RXON      0x0020          /* Receive On */
154
#define LE_C0_TXON      0x0010          /* Transmit On */
155
#define LE_C0_TDMD      0x0008          /* Transmit Demand */
156
#define LE_C0_STOP      0x0004          /* Stop */
157
#define LE_C0_STRT      0x0002          /* Start */
158
#define LE_C0_INIT      0x0001          /* Initialize */
159
 
160
 
161
/*
162
 *              Bit definitions for CSR3
163
 */
164
#define LE_C3_BSWP      0x0004          /* Byte Swap
165
                                           (on for big endian byte order) */
166
#define LE_C3_ACON      0x0002          /* ALE Control
167
                                           (on for active low ALE) */
168
#define LE_C3_BCON      0x0001          /* Byte Control */
169
 
170
 
171
/*
172
 *              Mode Flags
173
 */
174
#define LE_MO_PROM      0x8000          /* Promiscuous Mode */
175
/* these next ones 0x4000 -- 0x0080 are not available on the LANCE 7990,
176
 * but they are in NetBSD's am7990.h, presumably for backwards-compatible chips
177
 */
178
#define LE_MO_DRCVBC  0x4000          /* disable receive broadcast */
179
#define LE_MO_DRCVPA  0x2000          /* disable physical address detection */
180
#define LE_MO_DLNKTST 0x1000          /* disable link status */
181
#define LE_MO_DAPC    0x0800          /* disable automatic polarity correction */
182
#define LE_MO_MENDECL 0x0400          /* MENDEC loopback mode */
183
#define LE_MO_LRTTSEL 0x0200          /* lower RX threshold / TX mode selection */
184
#define LE_MO_PSEL1   0x0100          /* port selection bit1 */
185
#define LE_MO_PSEL0   0x0080          /* port selection bit0 */
186
/* and this one is from the C-LANCE data sheet... */
187
#define LE_MO_EMBA      0x0080          /* Enable Modified Backoff Algorithm
188
                                           (C-LANCE, not original LANCE) */
189
#define LE_MO_INTL      0x0040          /* Internal Loopback */
190
#define LE_MO_DRTY      0x0020          /* Disable Retry */
191
#define LE_MO_FCOLL     0x0010          /* Force Collision */
192
#define LE_MO_DXMTFCS   0x0008          /* Disable Transmit CRC */
193
#define LE_MO_LOOP      0x0004          /* Loopback Enable */
194
#define LE_MO_DTX       0x0002          /* Disable Transmitter */
195
#define LE_MO_DRX       0x0001          /* Disable Receiver */
196
 
197
 
198
/*
199
 *              Receive Flags
200
 */
201
#define LE_R1_OWN       0x80            /* LANCE owns the descriptor */
202
#define LE_R1_ERR       0x40            /* Error */
203
#define LE_R1_FRA       0x20            /* Framing Error */
204
#define LE_R1_OFL       0x10            /* Overflow Error */
205
#define LE_R1_CRC       0x08            /* CRC Error */
206
#define LE_R1_BUF       0x04            /* Buffer Error */
207
#define LE_R1_SOP       0x02            /* Start of Packet */
208
#define LE_R1_EOP       0x01            /* End of Packet */
209
#define LE_R1_POK       0x03            /* Packet is complete: SOP + EOP */
210
 
211
 
212
/*
213
 *              Transmit Flags
214
 */
215
#define LE_T1_OWN       0x80            /* LANCE owns the descriptor */
216
#define LE_T1_ERR       0x40            /* Error */
217
#define LE_T1_RES       0x20            /* Reserved, LANCE writes this with a zero */
218
#define LE_T1_EMORE     0x10            /* More than one retry needed */
219
#define LE_T1_EONE      0x08            /* One retry needed */
220
#define LE_T1_EDEF      0x04            /* Deferred */
221
#define LE_T1_SOP       0x02            /* Start of Packet */
222
#define LE_T1_EOP       0x01            /* End of Packet */
223
#define LE_T1_POK       0x03            /* Packet is complete: SOP + EOP */
224
 
225
/*
226
 *              Error Flags
227
 */
228
#define LE_T3_BUF       0x8000          /* Buffer Error */
229
#define LE_T3_UFL       0x4000          /* Underflow Error */
230
#define LE_T3_LCOL      0x1000          /* Late Collision */
231
#define LE_T3_CLOS      0x0800          /* Loss of Carrier */
232
#define LE_T3_RTY       0x0400          /* Retry Error */
233
#define LE_T3_TDR       0x03ff          /* Time Domain Reflectometry */
234
 
235
/* Miscellaneous useful macros */
236
 
237
#define TX_BUFFS_AVAIL ((lp->tx_old<=lp->tx_new)?\
238
                        lp->tx_old+lp->tx_ring_mod_mask-lp->tx_new:\
239
                        lp->tx_old - lp->tx_new-1)
240
 
241
/* The LANCE only uses 24 bit addresses. This does the obvious thing. */
242
#define LANCE_ADDR(x) ((int)(x) & ~0xff000000)
243
 
244
/* Now the prototypes we export */
245
extern int lance_open(struct net_device *dev);
246
extern int lance_close (struct net_device *dev);
247
extern int lance_start_xmit (struct sk_buff *skb, struct net_device *dev);
248
extern void lance_set_multicast (struct net_device *dev);
249
extern void lance_tx_timeout(struct net_device *dev);
250
#ifdef CONFIG_NET_POLL_CONTROLLER
251
extern void lance_poll(struct net_device *dev);
252
#endif
253
 
254
#endif /* ndef _7990_H */

powered by: WebSVN 2.1.0

© copyright 1999-2025 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.