3 * 10/100/1000 Base-T Ethernet Driver for the ET1301 and ET131x series MACs
5 * Copyright © 2005 Agere Systems Inc.
9 *------------------------------------------------------------------------------
11 * et1310_rx.h - Defines, structs, enums, prototypes, etc. pertaining to data
14 *------------------------------------------------------------------------------
18 * This software is provided subject to the following terms and conditions,
19 * which you should read carefully before using the software. Using this
20 * software indicates your acceptance of these terms and conditions. If you do
21 * not agree with these terms and conditions, do not use the software.
23 * Copyright © 2005 Agere Systems Inc.
24 * All rights reserved.
26 * Redistribution and use in source or binary forms, with or without
27 * modifications, are permitted provided that the following conditions are met:
29 * . Redistributions of source code must retain the above copyright notice, this
30 * list of conditions and the following Disclaimer as comments in the code as
31 * well as in the documentation and/or other materials provided with the
34 * . Redistributions in binary form must reproduce the above copyright notice,
35 * this list of conditions and the following Disclaimer in the documentation
36 * and/or other materials provided with the distribution.
38 * . Neither the name of Agere Systems Inc. nor the names of the contributors
39 * may be used to endorse or promote products derived from this software
40 * without specific prior written permission.
44 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
45 * INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
46 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ANY
47 * USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
48 * RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
49 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
50 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
51 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
52 * ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
53 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
54 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
59 #ifndef __ET1310_RX_H__
60 #define __ET1310_RX_H__
62 #include "et1310_address_map.h"
67 /* #define FBR0_BUFFER_SIZE 256 */
70 /* #define FBR1_BUFFER_SIZE 2048 */
74 #define MAX_DESC_PER_RING_RX 1024
76 /* number of RFDs - default and min */
78 #define RFD_LOW_WATER_MARK 40
79 #define NIC_MIN_NUM_RFD 64
80 #define NIC_DEFAULT_NUM_RFD 1024
82 #define RFD_LOW_WATER_MARK 20
83 #define NIC_MIN_NUM_RFD 64
84 #define NIC_DEFAULT_NUM_RFD 256
87 #define NUM_PACKETS_HANDLED 256
89 #define ALCATEL_BAD_STATUS 0xe47f0000
90 #define ALCATEL_MULTICAST_PKT 0x01000000
91 #define ALCATEL_BROADCAST_PKT 0x02000000
93 /* typedefs for Free Buffer Descriptors */
97 u32 word2
; /* Bits 10-31 reserved, 0-9 descriptor */
100 /* Packet Status Ring Descriptors
104 * top 16 bits are from the Alcatel Status Word as enumerated in
105 * PE-MCXMAC Data Sheet IPD DS54 0210-1 (also IPD-DS80 0205-2)
108 * 1: ipa IP checksum assist
109 * 2: ipp IP checksum pass
110 * 3: tcpa TCP checksum assist
111 * 4: tcpp TCP checksum pass
113 * 6: rxmac_error RXMAC Error Indicator
114 * 7: drop Drop packet
115 * 8: ft Frame Truncated
119 * 16: asw_prev_pkt_dropped e.g. IFG too small on previous
120 * 17: asw_RX_DV_event short receive event detected
121 * 18: asw_false_carrier_event bad carrier since last good packet
122 * 19: asw_code_err one or more nibbles signalled as errors
123 * 20: asw_CRC_err CRC error
124 * 21: asw_len_chk_err frame length field incorrect
125 * 22: asw_too_long frame length > 1518 bytes
126 * 23: asw_OK valid CRC + no code error
127 * 24: asw_multicast has a multicast address
128 * 25: asw_broadcast has a broadcast address
129 * 26: asw_dribble_nibble spurious bits after EOP
130 * 27: asw_control_frame is a control frame
131 * 28: asw_pause_frame is a pause frame
132 * 29: asw_unsupported_op unsupported OP code
133 * 30: asw_VLAN_tag VLAN tag detected
134 * 31: asw_long_evt Rx long event
137 * 0-15: length length in bytes
138 * 16-25: bi Buffer Index
139 * 26-27: ri Ring Index
143 struct pkt_stat_desc
{
148 /* Typedefs for the RX DMA status word */
151 * rx status word 0 holds part of the status bits of the Rx DMA engine
152 * that get copied out to memory by the ET-1310. Word 0 is a 32 bit word
153 * which contains the Free Buffer ring 0 and 1 available offset.
155 * bit 0-9 FBR1 offset
156 * bit 10 Wrap flag for FBR1
157 * bit 16-25 FBR0 offset
158 * bit 26 Wrap flag for FBR0
162 * RXSTAT_WORD1_t structure holds part of the status bits of the Rx DMA engine
163 * that get copied out to memory by the ET-1310. Word 3 is a 32 bit word
164 * which contains the Packet Status Ring available offset.
167 * bit 16-27 PSRoffset
173 * struct rx_status_block is a structure representing the status of the Rx
174 * DMA engine it sits in free memory, and is pointed to by 0x101c / 0x1020
176 struct rx_status_block
{
182 * Structure for look-up table holding free buffer ring pointers
185 void *virt
[MAX_DESC_PER_RING_RX
];
186 void *buffer1
[MAX_DESC_PER_RING_RX
];
187 void *buffer2
[MAX_DESC_PER_RING_RX
];
188 u32 bus_high
[MAX_DESC_PER_RING_RX
];
189 u32 bus_low
[MAX_DESC_PER_RING_RX
];
193 * struct rx_ring is the ssructure representing the adaptor's local
194 * reference(s) to the rings
199 dma_addr_t pFbr0RingPa
;
200 void *Fbr0MemVa
[MAX_DESC_PER_RING_RX
/ FBR_CHUNKS
];
201 dma_addr_t Fbr0MemPa
[MAX_DESC_PER_RING_RX
/ FBR_CHUNKS
];
209 dma_addr_t pFbr1RingPa
;
210 void *Fbr1MemVa
[MAX_DESC_PER_RING_RX
/ FBR_CHUNKS
];
211 dma_addr_t Fbr1MemPa
[MAX_DESC_PER_RING_RX
/ FBR_CHUNKS
];
214 struct fbr_lookup
*fbr
[2]; /* One per ring */
220 dma_addr_t pPSRingPa
;
224 struct rx_status_block
*rx_status_block
;
225 dma_addr_t rx_status_bus
;
227 struct list_head RecvBufferPool
;
230 struct list_head RecvList
;
235 bool UnfinishedReceives
;
237 struct list_head RecvPacketPool
;
239 /* lookaside lists */
240 struct kmem_cache
*RecvLookaside
;
243 #endif /* __ET1310_RX_H__ */