[PATCH] libertas: remove deprecated pm_register and associated code
[linux-2.6] / drivers / net / mv643xx_eth.h
1 #ifndef __MV643XX_ETH_H__
2 #define __MV643XX_ETH_H__
3
4 #include <linux/module.h>
5 #include <linux/kernel.h>
6 #include <linux/spinlock.h>
7 #include <linux/workqueue.h>
8 #include <linux/mii.h>
9
10 #include <linux/mv643xx.h>
11
12 #include <asm/dma-mapping.h>
13
14 /* Checksum offload for Tx works for most packets, but
15  * fails if previous packet sent did not use hw csum
16  */
17 #define MV643XX_CHECKSUM_OFFLOAD_TX
18 #define MV643XX_NAPI
19 #define MV643XX_TX_FAST_REFILL
20 #undef  MV643XX_COAL
21
22 /*
23  * Number of RX / TX descriptors on RX / TX rings.
24  * Note that allocating RX descriptors is done by allocating the RX
25  * ring AND a preallocated RX buffers (skb's) for each descriptor.
26  * The TX descriptors only allocates the TX descriptors ring,
27  * with no pre allocated TX buffers (skb's are allocated by higher layers.
28  */
29
30 /* Default TX ring size is 1000 descriptors */
31 #define MV643XX_DEFAULT_TX_QUEUE_SIZE 1000
32
33 /* Default RX ring size is 400 descriptors */
34 #define MV643XX_DEFAULT_RX_QUEUE_SIZE 400
35
36 #define MV643XX_TX_COAL 100
37 #ifdef MV643XX_COAL
38 #define MV643XX_RX_COAL 100
39 #endif
40
41 #ifdef MV643XX_CHECKSUM_OFFLOAD_TX
42 #define MAX_DESCS_PER_SKB       (MAX_SKB_FRAGS + 1)
43 #else
44 #define MAX_DESCS_PER_SKB       1
45 #endif
46
47 #define ETH_VLAN_HLEN           4
48 #define ETH_FCS_LEN             4
49 #define ETH_HW_IP_ALIGN         2               /* hw aligns IP header */
50 #define ETH_WRAPPER_LEN         (ETH_HW_IP_ALIGN + ETH_HLEN + \
51                                         ETH_VLAN_HLEN + ETH_FCS_LEN)
52 #define ETH_RX_SKB_SIZE         (dev->mtu + ETH_WRAPPER_LEN + dma_get_cache_alignment())
53
54 #define ETH_RX_QUEUES_ENABLED   (1 << 0)        /* use only Q0 for receive */
55 #define ETH_TX_QUEUES_ENABLED   (1 << 0)        /* use only Q0 for transmit */
56
57 #define ETH_INT_CAUSE_RX_DONE   (ETH_RX_QUEUES_ENABLED << 2)
58 #define ETH_INT_CAUSE_RX_ERROR  (ETH_RX_QUEUES_ENABLED << 9)
59 #define ETH_INT_CAUSE_RX        (ETH_INT_CAUSE_RX_DONE | ETH_INT_CAUSE_RX_ERROR)
60 #define ETH_INT_CAUSE_EXT       0x00000002
61 #define ETH_INT_UNMASK_ALL      (ETH_INT_CAUSE_RX | ETH_INT_CAUSE_EXT)
62
63 #define ETH_INT_CAUSE_TX_DONE   (ETH_TX_QUEUES_ENABLED << 0)
64 #define ETH_INT_CAUSE_TX_ERROR  (ETH_TX_QUEUES_ENABLED << 8)
65 #define ETH_INT_CAUSE_TX        (ETH_INT_CAUSE_TX_DONE | ETH_INT_CAUSE_TX_ERROR)
66 #define ETH_INT_CAUSE_PHY       0x00010000
67 #define ETH_INT_UNMASK_ALL_EXT  (ETH_INT_CAUSE_TX | ETH_INT_CAUSE_PHY)
68
69 #define ETH_INT_MASK_ALL        0x00000000
70 #define ETH_INT_MASK_ALL_EXT    0x00000000
71
72 #define PHY_WAIT_ITERATIONS     1000    /* 1000 iterations * 10uS = 10mS max */
73 #define PHY_WAIT_MICRO_SECONDS  10
74
75 /* Buffer offset from buffer pointer */
76 #define RX_BUF_OFFSET                           0x2
77
78 /* Gigabit Ethernet Unit Global Registers */
79
80 /* MIB Counters register definitions */
81 #define ETH_MIB_GOOD_OCTETS_RECEIVED_LOW        0x0
82 #define ETH_MIB_GOOD_OCTETS_RECEIVED_HIGH       0x4
83 #define ETH_MIB_BAD_OCTETS_RECEIVED             0x8
84 #define ETH_MIB_INTERNAL_MAC_TRANSMIT_ERR       0xc
85 #define ETH_MIB_GOOD_FRAMES_RECEIVED            0x10
86 #define ETH_MIB_BAD_FRAMES_RECEIVED             0x14
87 #define ETH_MIB_BROADCAST_FRAMES_RECEIVED       0x18
88 #define ETH_MIB_MULTICAST_FRAMES_RECEIVED       0x1c
89 #define ETH_MIB_FRAMES_64_OCTETS                0x20
90 #define ETH_MIB_FRAMES_65_TO_127_OCTETS         0x24
91 #define ETH_MIB_FRAMES_128_TO_255_OCTETS        0x28
92 #define ETH_MIB_FRAMES_256_TO_511_OCTETS        0x2c
93 #define ETH_MIB_FRAMES_512_TO_1023_OCTETS       0x30
94 #define ETH_MIB_FRAMES_1024_TO_MAX_OCTETS       0x34
95 #define ETH_MIB_GOOD_OCTETS_SENT_LOW            0x38
96 #define ETH_MIB_GOOD_OCTETS_SENT_HIGH           0x3c
97 #define ETH_MIB_GOOD_FRAMES_SENT                0x40
98 #define ETH_MIB_EXCESSIVE_COLLISION             0x44
99 #define ETH_MIB_MULTICAST_FRAMES_SENT           0x48
100 #define ETH_MIB_BROADCAST_FRAMES_SENT           0x4c
101 #define ETH_MIB_UNREC_MAC_CONTROL_RECEIVED      0x50
102 #define ETH_MIB_FC_SENT                         0x54
103 #define ETH_MIB_GOOD_FC_RECEIVED                0x58
104 #define ETH_MIB_BAD_FC_RECEIVED                 0x5c
105 #define ETH_MIB_UNDERSIZE_RECEIVED              0x60
106 #define ETH_MIB_FRAGMENTS_RECEIVED              0x64
107 #define ETH_MIB_OVERSIZE_RECEIVED               0x68
108 #define ETH_MIB_JABBER_RECEIVED                 0x6c
109 #define ETH_MIB_MAC_RECEIVE_ERROR               0x70
110 #define ETH_MIB_BAD_CRC_EVENT                   0x74
111 #define ETH_MIB_COLLISION                       0x78
112 #define ETH_MIB_LATE_COLLISION                  0x7c
113
114 /* Port serial status reg (PSR) */
115 #define ETH_INTERFACE_PCM                       0x00000001
116 #define ETH_LINK_IS_UP                          0x00000002
117 #define ETH_PORT_AT_FULL_DUPLEX                 0x00000004
118 #define ETH_RX_FLOW_CTRL_ENABLED                0x00000008
119 #define ETH_GMII_SPEED_1000                     0x00000010
120 #define ETH_MII_SPEED_100                       0x00000020
121 #define ETH_TX_IN_PROGRESS                      0x00000080
122 #define ETH_BYPASS_ACTIVE                       0x00000100
123 #define ETH_PORT_AT_PARTITION_STATE             0x00000200
124 #define ETH_PORT_TX_FIFO_EMPTY                  0x00000400
125
126 /* SMI reg */
127 #define ETH_SMI_BUSY            0x10000000      /* 0 - Write, 1 - Read  */
128 #define ETH_SMI_READ_VALID      0x08000000      /* 0 - Write, 1 - Read  */
129 #define ETH_SMI_OPCODE_WRITE    0               /* Completion of Read   */
130 #define ETH_SMI_OPCODE_READ     0x04000000      /* Operation is in progress */
131
132 /* Interrupt Cause Register Bit Definitions */
133
134 /* SDMA command status fields macros */
135
136 /* Tx & Rx descriptors status */
137 #define ETH_ERROR_SUMMARY                       0x00000001
138
139 /* Tx & Rx descriptors command */
140 #define ETH_BUFFER_OWNED_BY_DMA                 0x80000000
141
142 /* Tx descriptors status */
143 #define ETH_LC_ERROR                            0
144 #define ETH_UR_ERROR                            0x00000002
145 #define ETH_RL_ERROR                            0x00000004
146 #define ETH_LLC_SNAP_FORMAT                     0x00000200
147
148 /* Rx descriptors status */
149 #define ETH_OVERRUN_ERROR                       0x00000002
150 #define ETH_MAX_FRAME_LENGTH_ERROR              0x00000004
151 #define ETH_RESOURCE_ERROR                      0x00000006
152 #define ETH_VLAN_TAGGED                         0x00080000
153 #define ETH_BPDU_FRAME                          0x00100000
154 #define ETH_UDP_FRAME_OVER_IP_V_4               0x00200000
155 #define ETH_OTHER_FRAME_TYPE                    0x00400000
156 #define ETH_LAYER_2_IS_ETH_V_2                  0x00800000
157 #define ETH_FRAME_TYPE_IP_V_4                   0x01000000
158 #define ETH_FRAME_HEADER_OK                     0x02000000
159 #define ETH_RX_LAST_DESC                        0x04000000
160 #define ETH_RX_FIRST_DESC                       0x08000000
161 #define ETH_UNKNOWN_DESTINATION_ADDR            0x10000000
162 #define ETH_RX_ENABLE_INTERRUPT                 0x20000000
163 #define ETH_LAYER_4_CHECKSUM_OK                 0x40000000
164
165 /* Rx descriptors byte count */
166 #define ETH_FRAME_FRAGMENTED                    0x00000004
167
168 /* Tx descriptors command */
169 #define ETH_LAYER_4_CHECKSUM_FIRST_DESC         0x00000400
170 #define ETH_FRAME_SET_TO_VLAN                   0x00008000
171 #define ETH_UDP_FRAME                           0x00010000
172 #define ETH_GEN_TCP_UDP_CHECKSUM                0x00020000
173 #define ETH_GEN_IP_V_4_CHECKSUM                 0x00040000
174 #define ETH_ZERO_PADDING                        0x00080000
175 #define ETH_TX_LAST_DESC                        0x00100000
176 #define ETH_TX_FIRST_DESC                       0x00200000
177 #define ETH_GEN_CRC                             0x00400000
178 #define ETH_TX_ENABLE_INTERRUPT                 0x00800000
179 #define ETH_AUTO_MODE                           0x40000000
180
181 #define ETH_TX_IHL_SHIFT                        11
182
183 /* typedefs */
184
185 typedef enum _eth_func_ret_status {
186         ETH_OK,                 /* Returned as expected.                */
187         ETH_ERROR,              /* Fundamental error.                   */
188         ETH_RETRY,              /* Could not process request. Try later.*/
189         ETH_END_OF_JOB,         /* Ring has nothing to process.         */
190         ETH_QUEUE_FULL,         /* Ring resource error.                 */
191         ETH_QUEUE_LAST_RESOURCE /* Ring resources about to exhaust.     */
192 } ETH_FUNC_RET_STATUS;
193
194 typedef enum _eth_target {
195         ETH_TARGET_DRAM,
196         ETH_TARGET_DEVICE,
197         ETH_TARGET_CBS,
198         ETH_TARGET_PCI0,
199         ETH_TARGET_PCI1
200 } ETH_TARGET;
201
202 /* These are for big-endian machines.  Little endian needs different
203  * definitions.
204  */
205 #if defined(__BIG_ENDIAN)
206 struct eth_rx_desc {
207         u16 byte_cnt;           /* Descriptor buffer byte count         */
208         u16 buf_size;           /* Buffer size                          */
209         u32 cmd_sts;            /* Descriptor command status            */
210         u32 next_desc_ptr;      /* Next descriptor pointer              */
211         u32 buf_ptr;            /* Descriptor buffer pointer            */
212 };
213
214 struct eth_tx_desc {
215         u16 byte_cnt;           /* buffer byte count                    */
216         u16 l4i_chk;            /* CPU provided TCP checksum            */
217         u32 cmd_sts;            /* Command/status field                 */
218         u32 next_desc_ptr;      /* Pointer to next descriptor           */
219         u32 buf_ptr;            /* pointer to buffer for this descriptor*/
220 };
221
222 #elif defined(__LITTLE_ENDIAN)
223 struct eth_rx_desc {
224         u32 cmd_sts;            /* Descriptor command status            */
225         u16 buf_size;           /* Buffer size                          */
226         u16 byte_cnt;           /* Descriptor buffer byte count         */
227         u32 buf_ptr;            /* Descriptor buffer pointer            */
228         u32 next_desc_ptr;      /* Next descriptor pointer              */
229 };
230
231 struct eth_tx_desc {
232         u32 cmd_sts;            /* Command/status field                 */
233         u16 l4i_chk;            /* CPU provided TCP checksum            */
234         u16 byte_cnt;           /* buffer byte count                    */
235         u32 buf_ptr;            /* pointer to buffer for this descriptor*/
236         u32 next_desc_ptr;      /* Pointer to next descriptor           */
237 };
238 #else
239 #error One of __BIG_ENDIAN or __LITTLE_ENDIAN must be defined
240 #endif
241
242 /* Unified struct for Rx and Tx operations. The user is not required to */
243 /* be familier with neither Tx nor Rx descriptors.                      */
244 struct pkt_info {
245         unsigned short byte_cnt;        /* Descriptor buffer byte count */
246         unsigned short l4i_chk;         /* Tx CPU provided TCP Checksum */
247         unsigned int cmd_sts;           /* Descriptor command status    */
248         dma_addr_t buf_ptr;             /* Descriptor buffer pointer    */
249         struct sk_buff *return_info;    /* User resource return information */
250 };
251
252 /* Ethernet port specific information */
253
254 struct mv643xx_mib_counters {
255         u64 good_octets_received;
256         u32 bad_octets_received;
257         u32 internal_mac_transmit_err;
258         u32 good_frames_received;
259         u32 bad_frames_received;
260         u32 broadcast_frames_received;
261         u32 multicast_frames_received;
262         u32 frames_64_octets;
263         u32 frames_65_to_127_octets;
264         u32 frames_128_to_255_octets;
265         u32 frames_256_to_511_octets;
266         u32 frames_512_to_1023_octets;
267         u32 frames_1024_to_max_octets;
268         u64 good_octets_sent;
269         u32 good_frames_sent;
270         u32 excessive_collision;
271         u32 multicast_frames_sent;
272         u32 broadcast_frames_sent;
273         u32 unrec_mac_control_received;
274         u32 fc_sent;
275         u32 good_fc_received;
276         u32 bad_fc_received;
277         u32 undersize_received;
278         u32 fragments_received;
279         u32 oversize_received;
280         u32 jabber_received;
281         u32 mac_receive_error;
282         u32 bad_crc_event;
283         u32 collision;
284         u32 late_collision;
285 };
286
287 struct mv643xx_private {
288         int port_num;                   /* User Ethernet port number    */
289
290         u32 rx_sram_addr;               /* Base address of rx sram area */
291         u32 rx_sram_size;               /* Size of rx sram area         */
292         u32 tx_sram_addr;               /* Base address of tx sram area */
293         u32 tx_sram_size;               /* Size of tx sram area         */
294
295         int rx_resource_err;            /* Rx ring resource error flag */
296
297         /* Tx/Rx rings managment indexes fields. For driver use */
298
299         /* Next available and first returning Rx resource */
300         int rx_curr_desc_q, rx_used_desc_q;
301
302         /* Next available and first returning Tx resource */
303         int tx_curr_desc_q, tx_used_desc_q;
304
305 #ifdef MV643XX_TX_FAST_REFILL
306         u32 tx_clean_threshold;
307 #endif
308
309         struct eth_rx_desc *p_rx_desc_area;
310         dma_addr_t rx_desc_dma;
311         int rx_desc_area_size;
312         struct sk_buff **rx_skb;
313
314         struct eth_tx_desc *p_tx_desc_area;
315         dma_addr_t tx_desc_dma;
316         int tx_desc_area_size;
317         struct sk_buff **tx_skb;
318
319         struct work_struct tx_timeout_task;
320
321         struct net_device_stats stats;
322         struct mv643xx_mib_counters mib_counters;
323         spinlock_t lock;
324         /* Size of Tx Ring per queue */
325         int tx_ring_size;
326         /* Number of tx descriptors in use */
327         int tx_desc_count;
328         /* Size of Rx Ring per queue */
329         int rx_ring_size;
330         /* Number of rx descriptors in use */
331         int rx_desc_count;
332
333         /*
334          * Used in case RX Ring is empty, which can be caused when
335          * system does not have resources (skb's)
336          */
337         struct timer_list timeout;
338
339         u32 rx_int_coal;
340         u32 tx_int_coal;
341         struct mii_if_info mii;
342 };
343
344 /* Port operation control routines */
345 static void eth_port_init(struct mv643xx_private *mp);
346 static void eth_port_reset(unsigned int eth_port_num);
347 static void eth_port_start(struct net_device *dev);
348
349 /* PHY and MIB routines */
350 static void ethernet_phy_reset(unsigned int eth_port_num);
351
352 static void eth_port_write_smi_reg(unsigned int eth_port_num,
353                                    unsigned int phy_reg, unsigned int value);
354
355 static void eth_port_read_smi_reg(unsigned int eth_port_num,
356                                   unsigned int phy_reg, unsigned int *value);
357
358 static void eth_clear_mib_counters(unsigned int eth_port_num);
359
360 /* Port data flow control routines */
361 static ETH_FUNC_RET_STATUS eth_port_receive(struct mv643xx_private *mp,
362                                             struct pkt_info *p_pkt_info);
363 static ETH_FUNC_RET_STATUS eth_rx_return_buff(struct mv643xx_private *mp,
364                                               struct pkt_info *p_pkt_info);
365
366 #endif                          /* __MV643XX_ETH_H__ */