1/*******************************************************************************
2
3  Intel PRO/1000 Linux driver
4  Copyright(c) 1999 - 2006 Intel Corporation.
5
6  This program is free software; you can redistribute it and/or modify it
7  under the terms and conditions of the GNU General Public License,
8  version 2, as published by the Free Software Foundation.
9
10  This program is distributed in the hope it will be useful, but WITHOUT
11  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
13  more details.
14
15  You should have received a copy of the GNU General Public License along with
16  this program; if not, write to the Free Software Foundation, Inc.,
17  51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
18
19  The full GNU General Public License is included in this distribution in
20  the file called "COPYING".
21
22  Contact Information:
23  Linux NICS <linux.nics@intel.com>
24  e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
25  Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
26
27*******************************************************************************/
28
29
30/* Linux PRO/1000 Ethernet Driver main header file */
31
32#ifndef _E1000_H_
33#define _E1000_H_
34
35#include <linux/stddef.h>
36#include <linux/module.h>
37#include <linux/types.h>
38#include <asm/byteorder.h>
39#include <linux/mm.h>
40#include <linux/errno.h>
41#include <linux/ioport.h>
42#include <linux/pci.h>
43#include <linux/kernel.h>
44#include <linux/netdevice.h>
45#include <linux/etherdevice.h>
46#include <linux/skbuff.h>
47#include <linux/delay.h>
48#include <linux/timer.h>
49#include <linux/slab.h>
50#include <linux/vmalloc.h>
51#include <linux/interrupt.h>
52#include <linux/string.h>
53#include <linux/pagemap.h>
54#include <linux/dma-mapping.h>
55#include <linux/bitops.h>
56#include <asm/io.h>
57#include <asm/irq.h>
58#include <linux/capability.h>
59#include <linux/in.h>
60#include <linux/ip.h>
61#include <linux/ipv6.h>
62#include <linux/tcp.h>
63#include <linux/udp.h>
64#include <net/pkt_sched.h>
65#include <linux/list.h>
66#include <linux/reboot.h>
67#include <net/checksum.h>
68#include <linux/mii.h>
69#include <linux/ethtool.h>
70#include <linux/if_vlan.h>
71
72#define BAR_0		0
73#define BAR_1		1
74#define BAR_5		5
75
76#define INTEL_E1000_ETHERNET_DEVICE(device_id) {\
77	PCI_DEVICE(PCI_VENDOR_ID_INTEL, device_id)}
78
79struct e1000_adapter;
80
81#include "e1000_hw.h"
82
83#define E1000_MAX_INTR			10
84
85/*
86 * Count for polling __E1000_RESET condition every 10-20msec.
87 */
88#define E1000_CHECK_RESET_COUNT	50
89
90/* TX/RX descriptor defines */
91#define E1000_DEFAULT_TXD		256
92#define E1000_MAX_TXD			256
93#define E1000_MIN_TXD			48
94#define E1000_MAX_82544_TXD		4096
95
96#define E1000_DEFAULT_RXD		256
97#define E1000_MAX_RXD			256
98#define E1000_MIN_RXD			48
99#define E1000_MAX_82544_RXD		4096
100
101#define E1000_MIN_ITR_USECS		10 /* 100000 irq/sec */
102#define E1000_MAX_ITR_USECS		10000 /* 100    irq/sec */
103
104/* this is the size past which hardware will drop packets when setting LPE=0 */
105#define MAXIMUM_ETHERNET_VLAN_SIZE	1522
106
107/* Supported Rx Buffer Sizes */
108#define E1000_RXBUFFER_128		128    /* Used for packet split */
109#define E1000_RXBUFFER_256		256    /* Used for packet split */
110#define E1000_RXBUFFER_512		512
111#define E1000_RXBUFFER_1024		1024
112#define E1000_RXBUFFER_2048		2048
113#define E1000_RXBUFFER_4096		4096
114#define E1000_RXBUFFER_8192		8192
115#define E1000_RXBUFFER_16384		16384
116
117/* SmartSpeed delimiters */
118#define E1000_SMARTSPEED_DOWNSHIFT	3
119#define E1000_SMARTSPEED_MAX		15
120
121/* Packet Buffer allocations */
122#define E1000_PBA_BYTES_SHIFT		0xA
123#define E1000_TX_HEAD_ADDR_SHIFT	7
124#define E1000_PBA_TX_MASK		0xFFFF0000
125
126/* Flow Control Watermarks */
127#define E1000_FC_HIGH_DIFF	0x1638 /* High: 5688 bytes below Rx FIFO size */
128#define E1000_FC_LOW_DIFF	0x1640 /* Low:  5696 bytes below Rx FIFO size */
129
130#define E1000_FC_PAUSE_TIME	0xFFFF /* pause for the max or until send xon */
131
132/* How many Tx Descriptors do we need to call netif_wake_queue ? */
133#define E1000_TX_QUEUE_WAKE	16
134/* How many Rx Buffers do we bundle into one write to the hardware ? */
135#define E1000_RX_BUFFER_WRITE	16 /* Must be power of 2 */
136
137#define AUTO_ALL_MODES		0
138#define E1000_EEPROM_82544_APM	0x0004
139#define E1000_EEPROM_APME	0x0400
140
141#ifndef E1000_MASTER_SLAVE
142/* Switch to override PHY master/slave setting */
143#define E1000_MASTER_SLAVE	e1000_ms_hw_default
144#endif
145
146#define E1000_MNG_VLAN_NONE	(-1)
147
148/* wrapper around a pointer to a socket buffer,
149 * so a DMA handle can be stored along with the buffer
150 */
151struct e1000_tx_buffer {
152	struct sk_buff *skb;
153	dma_addr_t dma;
154	unsigned long time_stamp;
155	u16 length;
156	u16 next_to_watch;
157	bool mapped_as_page;
158	unsigned short segs;
159	unsigned int bytecount;
160};
161
162struct e1000_rx_buffer {
163	union {
164		struct page *page; /* jumbo: alloc_page */
165		u8 *data; /* else, netdev_alloc_frag */
166	} rxbuf;
167	dma_addr_t dma;
168};
169
170struct e1000_tx_ring {
171	/* pointer to the descriptor ring memory */
172	void *desc;
173	/* physical address of the descriptor ring */
174	dma_addr_t dma;
175	/* length of descriptor ring in bytes */
176	unsigned int size;
177	/* number of descriptors in the ring */
178	unsigned int count;
179	/* next descriptor to associate a buffer with */
180	unsigned int next_to_use;
181	/* next descriptor to check for DD status bit */
182	unsigned int next_to_clean;
183	/* array of buffer information structs */
184	struct e1000_tx_buffer *buffer_info;
185
186	u16 tdh;
187	u16 tdt;
188	bool last_tx_tso;
189};
190
191struct e1000_rx_ring {
192	/* pointer to the descriptor ring memory */
193	void *desc;
194	/* physical address of the descriptor ring */
195	dma_addr_t dma;
196	/* length of descriptor ring in bytes */
197	unsigned int size;
198	/* number of descriptors in the ring */
199	unsigned int count;
200	/* next descriptor to associate a buffer with */
201	unsigned int next_to_use;
202	/* next descriptor to check for DD status bit */
203	unsigned int next_to_clean;
204	/* array of buffer information structs */
205	struct e1000_rx_buffer *buffer_info;
206	struct sk_buff *rx_skb_top;
207
208	/* cpu for rx queue */
209	int cpu;
210
211	u16 rdh;
212	u16 rdt;
213};
214
215#define E1000_DESC_UNUSED(R)						\
216	((((R)->next_to_clean > (R)->next_to_use)			\
217	  ? 0 : (R)->count) + (R)->next_to_clean - (R)->next_to_use - 1)
218
219#define E1000_RX_DESC_EXT(R, i)						\
220	(&(((union e1000_rx_desc_extended *)((R).desc))[i]))
221#define E1000_GET_DESC(R, i, type)	(&(((struct type *)((R).desc))[i]))
222#define E1000_RX_DESC(R, i)		E1000_GET_DESC(R, i, e1000_rx_desc)
223#define E1000_TX_DESC(R, i)		E1000_GET_DESC(R, i, e1000_tx_desc)
224#define E1000_CONTEXT_DESC(R, i)	E1000_GET_DESC(R, i, e1000_context_desc)
225
226/* board specific private data structure */
227
228struct e1000_adapter {
229	unsigned long active_vlans[BITS_TO_LONGS(VLAN_N_VID)];
230	u16 mng_vlan_id;
231	u32 bd_number;
232	u32 rx_buffer_len;
233	u32 wol;
234	u32 smartspeed;
235	u32 en_mng_pt;
236	u16 link_speed;
237	u16 link_duplex;
238	spinlock_t stats_lock;
239	unsigned int total_tx_bytes;
240	unsigned int total_tx_packets;
241	unsigned int total_rx_bytes;
242	unsigned int total_rx_packets;
243	/* Interrupt Throttle Rate */
244	u32 itr;
245	u32 itr_setting;
246	u16 tx_itr;
247	u16 rx_itr;
248
249	u8 fc_autoneg;
250
251	/* TX */
252	struct e1000_tx_ring *tx_ring;      /* One per active queue */
253	unsigned int restart_queue;
254	u32 txd_cmd;
255	u32 tx_int_delay;
256	u32 tx_abs_int_delay;
257	u32 gotcl;
258	u64 gotcl_old;
259	u64 tpt_old;
260	u64 colc_old;
261	u32 tx_timeout_count;
262	u32 tx_fifo_head;
263	u32 tx_head_addr;
264	u32 tx_fifo_size;
265	u8  tx_timeout_factor;
266	atomic_t tx_fifo_stall;
267	bool pcix_82544;
268	bool detect_tx_hung;
269	bool dump_buffers;
270
271	/* RX */
272	bool (*clean_rx)(struct e1000_adapter *adapter,
273			 struct e1000_rx_ring *rx_ring,
274			 int *work_done, int work_to_do);
275	void (*alloc_rx_buf)(struct e1000_adapter *adapter,
276			     struct e1000_rx_ring *rx_ring,
277			     int cleaned_count);
278	struct e1000_rx_ring *rx_ring;      /* One per active queue */
279	struct napi_struct napi;
280
281	int num_tx_queues;
282	int num_rx_queues;
283
284	u64 hw_csum_err;
285	u64 hw_csum_good;
286	u32 alloc_rx_buff_failed;
287	u32 rx_int_delay;
288	u32 rx_abs_int_delay;
289	bool rx_csum;
290	u32 gorcl;
291	u64 gorcl_old;
292
293	/* OS defined structs */
294	struct net_device *netdev;
295	struct pci_dev *pdev;
296
297	/* structs defined in e1000_hw.h */
298	struct e1000_hw hw;
299	struct e1000_hw_stats stats;
300	struct e1000_phy_info phy_info;
301	struct e1000_phy_stats phy_stats;
302
303	u32 test_icr;
304	struct e1000_tx_ring test_tx_ring;
305	struct e1000_rx_ring test_rx_ring;
306
307	int msg_enable;
308
309	/* to not mess up cache alignment, always add to the bottom */
310	bool tso_force;
311	bool smart_power_down;	/* phy smart power down */
312	bool quad_port_a;
313	unsigned long flags;
314	u32 eeprom_wol;
315
316	/* for ioport free */
317	int bars;
318	int need_ioport;
319
320	bool discarding;
321
322	struct work_struct reset_task;
323	struct delayed_work watchdog_task;
324	struct delayed_work fifo_stall_task;
325	struct delayed_work phy_info_task;
326};
327
328enum e1000_state_t {
329	__E1000_TESTING,
330	__E1000_RESETTING,
331	__E1000_DOWN
332};
333
334#undef pr_fmt
335#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
336
337struct net_device *e1000_get_hw_dev(struct e1000_hw *hw);
338#define e_dbg(format, arg...) \
339	netdev_dbg(e1000_get_hw_dev(hw), format, ## arg)
340#define e_err(msglvl, format, arg...) \
341	netif_err(adapter, msglvl, adapter->netdev, format, ## arg)
342#define e_info(msglvl, format, arg...) \
343	netif_info(adapter, msglvl, adapter->netdev, format, ## arg)
344#define e_warn(msglvl, format, arg...) \
345	netif_warn(adapter, msglvl, adapter->netdev, format, ## arg)
346#define e_notice(msglvl, format, arg...) \
347	netif_notice(adapter, msglvl, adapter->netdev, format, ## arg)
348#define e_dev_info(format, arg...) \
349	dev_info(&adapter->pdev->dev, format, ## arg)
350#define e_dev_warn(format, arg...) \
351	dev_warn(&adapter->pdev->dev, format, ## arg)
352#define e_dev_err(format, arg...) \
353	dev_err(&adapter->pdev->dev, format, ## arg)
354
355extern char e1000_driver_name[];
356extern const char e1000_driver_version[];
357
358int e1000_up(struct e1000_adapter *adapter);
359void e1000_down(struct e1000_adapter *adapter);
360void e1000_reinit_locked(struct e1000_adapter *adapter);
361void e1000_reset(struct e1000_adapter *adapter);
362int e1000_set_spd_dplx(struct e1000_adapter *adapter, u32 spd, u8 dplx);
363int e1000_setup_all_rx_resources(struct e1000_adapter *adapter);
364int e1000_setup_all_tx_resources(struct e1000_adapter *adapter);
365void e1000_free_all_rx_resources(struct e1000_adapter *adapter);
366void e1000_free_all_tx_resources(struct e1000_adapter *adapter);
367void e1000_update_stats(struct e1000_adapter *adapter);
368bool e1000_has_link(struct e1000_adapter *adapter);
369void e1000_power_up_phy(struct e1000_adapter *);
370void e1000_set_ethtool_ops(struct net_device *netdev);
371void e1000_check_options(struct e1000_adapter *adapter);
372char *e1000_get_hw_dev_name(struct e1000_hw *hw);
373
374#endif /* _E1000_H_ */
375