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

Subversion Repositories test_project

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

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 62 marcus.erl
 
2
/*
3
 * snull.h -- definitions for the network module
4
 *
5
 * Copyright (C) 2001 Alessandro Rubini and Jonathan Corbet
6
 * Copyright (C) 2001 O'Reilly & Associates
7
 *
8
 * The source code in this file can be freely used, adapted,
9
 * and redistributed in source or binary form, so long as an
10
 * acknowledgment appears in derived source files.  The citation
11
 * should list that the code comes from the book "Linux Device
12
 * Drivers" by Alessandro Rubini and Jonathan Corbet, published
13
 * by O'Reilly & Associates.   No warranty is attached;
14
 * we cannot take responsibility for errors or fitness for use.
15
 */
16
 
17
/* version dependencies have been confined to a separate file */
18
 
19
/* Tunable parameters */
20
#define TX_RING_ENTRIES 64      /* 64-512?*/
21
 
22
#define RX_RING_ENTRIES 16 /* Do not change */
23
/* Internal constants */
24
#define TX_RING_BUFFER_SIZE     (TX_RING_ENTRIES*sizeof(tx_packet))
25
#define RX_BUFFER_SIZE 1546 /* ethenet packet size */
26
#define METH_RX_BUFF_SIZE 4096
27
#define METH_RX_HEAD 34 /* status + 3 quad garbage-fill + 2 byte zero-pad */
28
#define RX_BUFFER_OFFSET (sizeof(rx_status_vector)+2) /* staus vector + 2 bytes of padding */
29
#define RX_BUCKET_SIZE 256
30
 
31
/* For more detailed explanations of what each field menas,
32
   see Nick's great comments to #defines below (or docs, if
33
   you are lucky enough toget hold of them :)*/
34
 
35
/* tx status vector is written over tx command header upon
36
   dma completion. */
37
 
38
typedef struct tx_status_vector {
39
        u64             sent:1; /* always set to 1...*/
40
        u64             pad0:34;/* always set to 0 */
41
        u64             flags:9;                        /*I'm too lazy to specify each one separately at the moment*/
42
        u64             col_retry_cnt:4;        /*collision retry count*/
43
        u64             len:16;                         /*Transmit length in bytes*/
44
} tx_status_vector;
45
 
46
/*
47
 * Each packet is 128 bytes long.
48
 * It consists of header, 0-3 concatination
49
 * buffer pointers and up to 120 data bytes.
50
 */
51
typedef struct tx_packet_hdr {
52
        u64             pad1:36; /*should be filled with 0 */
53
        u64             cat_ptr3_valid:1,       /*Concatination pointer valid flags*/
54
                        cat_ptr2_valid:1,
55
                        cat_ptr1_valid:1;
56
        u64             tx_int_flag:1;          /*Generate TX intrrupt when packet has been sent*/
57
        u64             term_dma_flag:1;        /*Terminate transmit DMA on transmit abort conditions*/
58
        u64             data_offset:7;          /*Starting byte offset in ring data block*/
59
        u64             data_len:16;            /*Length of valid data in bytes-1*/
60
} tx_packet_hdr;
61
typedef union tx_cat_ptr {
62
        struct {
63
                u64             pad2:16; /* should be 0 */
64
                u64             len:16;                         /*length of buffer data - 1*/
65
                u64             start_addr:29;          /*Physical starting address*/
66
                u64             pad1:3; /* should be zero */
67
        } form;
68
        u64 raw;
69
} tx_cat_ptr;
70
 
71
typedef struct tx_packet {
72
        union {
73
                tx_packet_hdr header;
74
                tx_status_vector res;
75
                u64 raw;
76
        }header;
77
        union {
78
                tx_cat_ptr cat_buf[3];
79
                char dt[120];
80
        } data;
81
} tx_packet;
82
 
83
typedef union rx_status_vector {
84
        volatile struct {
85
                u64             pad1:1;/*fill it with ones*/
86
                u64             pad2:15;/*fill with 0*/
87
                u64             ip_chk_sum:16;
88
                u64             seq_num:5;
89
                u64             mac_addr_match:1;
90
                u64             mcast_addr_match:1;
91
                u64             carrier_event_seen:1;
92
                u64             bad_packet:1;
93
                u64             long_event_seen:1;
94
                u64             invalid_preamble:1;
95
                u64             broadcast:1;
96
                u64             multicast:1;
97
                u64             crc_error:1;
98
                u64             huh:1;/*???*/
99
                u64             rx_code_violation:1;
100
                u64             rx_len:16;
101
        } parsed;
102
        volatile u64 raw;
103
} rx_status_vector;
104
 
105
typedef struct rx_packet {
106
        rx_status_vector status;
107
        u64 pad[3]; /* For whatever reason, there needs to be 4 double-word offset */
108
        u16 pad2;
109
        char buf[METH_RX_BUFF_SIZE-sizeof(rx_status_vector)-3*sizeof(u64)-sizeof(u16)];/* data */
110
} rx_packet;
111
 
112
#define TX_INFO_RPTR    0x00FF0000
113
#define TX_INFO_WPTR    0x000000FF
114
 
115
        /* Bits in METH_MAC */
116
 
117
#define SGI_MAC_RESET           BIT(0)  /* 0: MAC110 active in run mode, 1: Global reset signal to MAC110 core is active */
118
#define METH_PHY_FDX            BIT(1) /* 0: Disable full duplex, 1: Enable full duplex */
119
#define METH_PHY_LOOP   BIT(2) /* 0: Normal operation, follows 10/100mbit and M10T/MII select, 1: loops internal MII bus */
120
                                       /*    selects ignored */
121
#define METH_100MBIT            BIT(3) /* 0: 10meg mode, 1: 100meg mode */
122
#define METH_PHY_MII            BIT(4) /* 0: MII selected, 1: SIA selected */
123
                                       /*   Note: when loopback is set this bit becomes collision control.  Setting this bit will */
124
                                       /*         cause a collision to be reported. */
125
 
126
                                       /* Bits 5 and 6 are used to determine the Destination address filter mode */
127
#define METH_ACCEPT_MY 0                        /* 00: Accept PHY address only */
128
#define METH_ACCEPT_MCAST 0x20  /* 01: Accept physical, broadcast, and multicast filter matches only */
129
#define METH_ACCEPT_AMCAST 0x40 /* 10: Accept physical, broadcast, and all multicast packets */
130
#define METH_PROMISC 0x60               /* 11: Promiscious mode */
131
 
132
#define METH_PHY_LINK_FAIL      BIT(7) /* 0: Link failure detection disabled, 1: Hardware scans for link failure in PHY */
133
 
134
#define METH_MAC_IPG    0x1ffff00
135
 
136
#define METH_DEFAULT_IPG ((17<<15) | (11<<22) | (21<<8))
137
                                                /* 0x172e5c00 */ /* 23, 23, 23 */ /*0x54A9500 *//*21,21,21*/
138
                                       /* Bits 8 through 14 are used to determine Inter-Packet Gap between "Back to Back" packets */
139
                                       /* The gap depends on the clock speed of the link, 80ns per increment for 100baseT, 800ns  */
140
                                       /* per increment for 10BaseT */
141
 
142
                                       /* Bits 15 through 21 are used to determine IPGR1 */
143
 
144
                                       /* Bits 22 through 28 are used to determine IPGR2 */
145
 
146
#define METH_REV_SHIFT 29       /* Bits 29 through 31 are used to determine the revision */
147
                                       /* 000: Inital revision */
148
                                       /* 001: First revision, Improved TX concatenation */
149
 
150
 
151
/* DMA control bits */
152
#define METH_RX_OFFSET_SHIFT 12 /* Bits 12:14 of DMA control register indicate starting offset of packet data for RX operation */
153
#define METH_RX_DEPTH_SHIFT 4 /* Bits 8:4 define RX fifo depth -- when # of RX fifo entries != depth, interrupt is generted */
154
 
155
#define METH_DMA_TX_EN BIT(1) /* enable TX DMA */
156
#define METH_DMA_TX_INT_EN BIT(0) /* enable TX Buffer Empty interrupt */
157
#define METH_DMA_RX_EN BIT(15) /* Enable RX */
158
#define METH_DMA_RX_INT_EN BIT(9) /* Enable interrupt on RX packet */
159
 
160
/* RX FIFO MCL Info bits */
161
#define METH_RX_FIFO_WPTR(x)   (((x)>>16)&0xf)
162
#define METH_RX_FIFO_RPTR(x)   (((x)>>8)&0xf)
163
#define METH_RX_FIFO_DEPTH(x)  ((x)&0x1f)
164
 
165
/* RX status bits */
166
 
167
#define METH_RX_ST_VALID BIT(63)
168
#define METH_RX_ST_RCV_CODE_VIOLATION BIT(16)
169
#define METH_RX_ST_DRBL_NBL BIT(17)
170
#define METH_RX_ST_CRC_ERR BIT(18)
171
#define METH_RX_ST_MCAST_PKT BIT(19)
172
#define METH_RX_ST_BCAST_PKT BIT(20)
173
#define METH_RX_ST_INV_PREAMBLE_CTX BIT(21)
174
#define METH_RX_ST_LONG_EVT_SEEN BIT(22)
175
#define METH_RX_ST_BAD_PACKET BIT(23)
176
#define METH_RX_ST_CARRIER_EVT_SEEN BIT(24)
177
#define METH_RX_ST_MCAST_FILTER_MATCH BIT(25)
178
#define METH_RX_ST_PHYS_ADDR_MATCH BIT(26)
179
 
180
#define METH_RX_STATUS_ERRORS \
181
        ( \
182
        METH_RX_ST_RCV_CODE_VIOLATION| \
183
        METH_RX_ST_CRC_ERR| \
184
        METH_RX_ST_INV_PREAMBLE_CTX| \
185
        METH_RX_ST_LONG_EVT_SEEN| \
186
        METH_RX_ST_BAD_PACKET| \
187
        METH_RX_ST_CARRIER_EVT_SEEN \
188
        )
189
        /* Bits in METH_INT */
190
        /* Write _1_ to corresponding bit to clear */
191
#define METH_INT_TX_EMPTY       BIT(0)  /* 0: No interrupt pending, 1: The TX ring buffer is empty */
192
#define METH_INT_TX_PKT         BIT(1)  /* 0: No interrupt pending */
193
                                                /* 1: A TX message had the INT request bit set, the packet has been sent. */
194
#define METH_INT_TX_LINK_FAIL   BIT(2)  /* 0: No interrupt pending, 1: PHY has reported a link failure */
195
#define METH_INT_MEM_ERROR      BIT(3)  /* 0: No interrupt pending */
196
                                                /* 1: A memory error occurred durring DMA, DMA stopped, Fatal */
197
#define METH_INT_TX_ABORT               BIT(4)  /* 0: No interrupt pending, 1: The TX aborted operation, DMA stopped, FATAL */
198
#define METH_INT_RX_THRESHOLD   BIT(5)  /* 0: No interrupt pending, 1: Selected receive threshold condition Valid */
199
#define METH_INT_RX_UNDERFLOW   BIT(6)  /* 0: No interrupt pending, 1: FIFO was empty, packet could not be queued */
200
#define METH_INT_RX_OVERFLOW            BIT(7)  /* 0: No interrupt pending, 1: DMA FIFO Overflow, DMA stopped, FATAL */
201
 
202
/*#define METH_INT_RX_RPTR_MASK 0x0001F00*/             /* Bits 8 through 12 alias of RX read-pointer */
203
#define METH_INT_RX_RPTR_MASK 0x0000F00         /* Bits 8 through 11 alias of RX read-pointer - so, is Rx FIFO 16 or 32 entry?*/
204
 
205
                                                /* Bits 13 through 15 are always 0. */
206
 
207
#define METH_INT_TX_RPTR_MASK   0x1FF0000        /* Bits 16 through 24 alias of TX read-pointer */
208
 
209
#define METH_INT_RX_SEQ_MASK    0x2E000000      /* Bits 25 through 29 are the starting seq number for the message at the */
210
 
211
                                                /* top of the queue */
212
 
213
#define METH_INT_ERROR  (METH_INT_TX_LINK_FAIL| \
214
                        METH_INT_MEM_ERROR| \
215
                        METH_INT_TX_ABORT| \
216
                        METH_INT_RX_OVERFLOW| \
217
                        METH_INT_RX_UNDERFLOW)
218
 
219
#define METH_INT_MCAST_HASH             BIT(30) /* If RX DMA is enabled the hash select logic output is latched here */
220
 
221
/* TX status bits */
222
#define METH_TX_ST_DONE      BIT(63) /* TX complete */
223
#define METH_TX_ST_SUCCESS   BIT(23) /* Packet was transmitted successfully */
224
#define METH_TX_ST_TOOLONG   BIT(24) /* TX abort due to excessive length */
225
#define METH_TX_ST_UNDERRUN  BIT(25) /* TX abort due to underrun (?) */
226
#define METH_TX_ST_EXCCOLL   BIT(26) /* TX abort due to excess collisions */
227
#define METH_TX_ST_DEFER     BIT(27) /* TX abort due to excess deferals */
228
#define METH_TX_ST_LATECOLL  BIT(28) /* TX abort due to late collision */
229
 
230
 
231
/* Tx command header bits */
232
#define METH_TX_CMD_INT_EN BIT(24) /* Generate TX interrupt when packet is sent */
233
 
234
/* Phy MDIO interface busy flag */
235
#define MDIO_BUSY    BIT(16)
236
#define MDIO_DATA_MASK 0xFFFF
237
/* PHY defines */
238
#define PHY_QS6612X    0x0181441    /* Quality TX */
239
#define PHY_ICS1889    0x0015F41    /* ICS FX */
240
#define PHY_ICS1890    0x0015F42    /* ICS TX */
241
#define PHY_DP83840    0x20005C0    /* National TX */
242
 
243
#define ADVANCE_RX_PTR(x)  x=(x+1)&(RX_RING_ENTRIES-1)

powered by: WebSVN 2.1.0

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