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