xref: /illumos-gate/usr/src/uts/common/io/e1000api/e1000_hw.h (revision 5bb0bdfe588c5df0f63ff8ac292cd608a5f4492a)
1 /******************************************************************************
2 
3   Copyright (c) 2001-2015, Intel Corporation
4   All rights reserved.
5 
6   Redistribution and use in source and binary forms, with or without
7   modification, are permitted provided that the following conditions are met:
8 
9    1. Redistributions of source code must retain the above copyright notice,
10       this list of conditions and the following disclaimer.
11 
12    2. Redistributions in binary form must reproduce the above copyright
13       notice, this list of conditions and the following disclaimer in the
14       documentation and/or other materials provided with the distribution.
15 
16    3. Neither the name of the Intel Corporation nor the names of its
17       contributors may be used to endorse or promote products derived from
18       this software without specific prior written permission.
19 
20   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23   ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
24   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30   POSSIBILITY OF SUCH DAMAGE.
31 
32 ******************************************************************************/
33 /*$FreeBSD$*/
34 
35 #ifndef _E1000_HW_H_
36 #define _E1000_HW_H_
37 
38 #include "e1000_osdep.h"
39 #include "e1000_regs.h"
40 #include "e1000_defines.h"
41 
42 struct e1000_hw;
43 
44 #define E1000_DEV_ID_82542			0x1000
45 #define E1000_DEV_ID_82543GC_FIBER		0x1001
46 #define E1000_DEV_ID_82543GC_COPPER		0x1004
47 #define E1000_DEV_ID_82544EI_COPPER		0x1008
48 #define E1000_DEV_ID_82544EI_FIBER		0x1009
49 #define E1000_DEV_ID_82544GC_COPPER		0x100C
50 #define E1000_DEV_ID_82544GC_LOM		0x100D
51 #define E1000_DEV_ID_82540EM			0x100E
52 #define E1000_DEV_ID_82540EM_LOM		0x1015
53 #define E1000_DEV_ID_82540EP_LOM		0x1016
54 #define E1000_DEV_ID_82540EP			0x1017
55 #define E1000_DEV_ID_82540EP_LP			0x101E
56 #define E1000_DEV_ID_82545EM_COPPER		0x100F
57 #define E1000_DEV_ID_82545EM_FIBER		0x1011
58 #define E1000_DEV_ID_82545GM_COPPER		0x1026
59 #define E1000_DEV_ID_82545GM_FIBER		0x1027
60 #define E1000_DEV_ID_82545GM_SERDES		0x1028
61 #define E1000_DEV_ID_82546EB_COPPER		0x1010
62 #define E1000_DEV_ID_82546EB_FIBER		0x1012
63 #define E1000_DEV_ID_82546EB_QUAD_COPPER	0x101D
64 #define E1000_DEV_ID_82546GB_COPPER		0x1079
65 #define E1000_DEV_ID_82546GB_FIBER		0x107A
66 #define E1000_DEV_ID_82546GB_SERDES		0x107B
67 #define E1000_DEV_ID_82546GB_PCIE		0x108A
68 #define E1000_DEV_ID_82546GB_QUAD_COPPER	0x1099
69 #define E1000_DEV_ID_82546GB_QUAD_COPPER_KSP3	0x10B5
70 #define E1000_DEV_ID_82541EI			0x1013
71 #define E1000_DEV_ID_82541EI_MOBILE		0x1018
72 #define E1000_DEV_ID_82541ER_LOM		0x1014
73 #define E1000_DEV_ID_82541ER			0x1078
74 #define E1000_DEV_ID_82541GI			0x1076
75 #define E1000_DEV_ID_82541GI_LF			0x107C
76 #define E1000_DEV_ID_82541GI_MOBILE		0x1077
77 #define E1000_DEV_ID_82547EI			0x1019
78 #define E1000_DEV_ID_82547EI_MOBILE		0x101A
79 #define E1000_DEV_ID_82547GI			0x1075
80 #define E1000_DEV_ID_82571EB_COPPER		0x105E
81 #define E1000_DEV_ID_82571EB_FIBER		0x105F
82 #define E1000_DEV_ID_82571EB_SERDES		0x1060
83 #define E1000_DEV_ID_82571EB_SERDES_DUAL	0x10D9
84 #define E1000_DEV_ID_82571EB_SERDES_QUAD	0x10DA
85 #define E1000_DEV_ID_82571EB_QUAD_COPPER	0x10A4
86 #define E1000_DEV_ID_82571PT_QUAD_COPPER	0x10D5
87 #define E1000_DEV_ID_82571EB_QUAD_FIBER		0x10A5
88 #define E1000_DEV_ID_82571EB_QUAD_COPPER_LP	0x10BC
89 #define E1000_DEV_ID_82572EI_COPPER		0x107D
90 #define E1000_DEV_ID_82572EI_FIBER		0x107E
91 #define E1000_DEV_ID_82572EI_SERDES		0x107F
92 #define E1000_DEV_ID_82572EI			0x10B9
93 #define E1000_DEV_ID_82573E			0x108B
94 #define E1000_DEV_ID_82573E_IAMT		0x108C
95 #define E1000_DEV_ID_82573L			0x109A
96 #define E1000_DEV_ID_82574L			0x10D3
97 #define E1000_DEV_ID_82574LA			0x10F6
98 #define E1000_DEV_ID_82583V			0x150C
99 #define E1000_DEV_ID_80003ES2LAN_COPPER_DPT	0x1096
100 #define E1000_DEV_ID_80003ES2LAN_SERDES_DPT	0x1098
101 #define E1000_DEV_ID_80003ES2LAN_COPPER_SPT	0x10BA
102 #define E1000_DEV_ID_80003ES2LAN_SERDES_SPT	0x10BB
103 #define E1000_DEV_ID_ICH8_82567V_3		0x1501
104 #define E1000_DEV_ID_ICH8_IGP_M_AMT		0x1049
105 #define E1000_DEV_ID_ICH8_IGP_AMT		0x104A
106 #define E1000_DEV_ID_ICH8_IGP_C			0x104B
107 #define E1000_DEV_ID_ICH8_IFE			0x104C
108 #define E1000_DEV_ID_ICH8_IFE_GT		0x10C4
109 #define E1000_DEV_ID_ICH8_IFE_G			0x10C5
110 #define E1000_DEV_ID_ICH8_IGP_M			0x104D
111 #define E1000_DEV_ID_ICH9_IGP_M			0x10BF
112 #define E1000_DEV_ID_ICH9_IGP_M_AMT		0x10F5
113 #define E1000_DEV_ID_ICH9_IGP_M_V		0x10CB
114 #define E1000_DEV_ID_ICH9_IGP_AMT		0x10BD
115 #define E1000_DEV_ID_ICH9_BM			0x10E5
116 #define E1000_DEV_ID_ICH9_IGP_C			0x294C
117 #define E1000_DEV_ID_ICH9_IFE			0x10C0
118 #define E1000_DEV_ID_ICH9_IFE_GT		0x10C3
119 #define E1000_DEV_ID_ICH9_IFE_G			0x10C2
120 #define E1000_DEV_ID_ICH10_R_BM_LM		0x10CC
121 #define E1000_DEV_ID_ICH10_R_BM_LF		0x10CD
122 #define E1000_DEV_ID_ICH10_R_BM_V		0x10CE
123 #define E1000_DEV_ID_ICH10_D_BM_LM		0x10DE
124 #define E1000_DEV_ID_ICH10_D_BM_LF		0x10DF
125 #define E1000_DEV_ID_ICH10_D_BM_V		0x1525
126 #define E1000_DEV_ID_PCH_M_HV_LM		0x10EA
127 #define E1000_DEV_ID_PCH_M_HV_LC		0x10EB
128 #define E1000_DEV_ID_PCH_D_HV_DM		0x10EF
129 #define E1000_DEV_ID_PCH_D_HV_DC		0x10F0
130 #define E1000_DEV_ID_PCH2_LV_LM			0x1502
131 #define E1000_DEV_ID_PCH2_LV_V			0x1503
132 #define E1000_DEV_ID_PCH_LPT_I217_LM		0x153A
133 #define E1000_DEV_ID_PCH_LPT_I217_V		0x153B
134 #define E1000_DEV_ID_PCH_LPTLP_I218_LM		0x155A
135 #define E1000_DEV_ID_PCH_LPTLP_I218_V		0x1559
136 #define E1000_DEV_ID_PCH_I218_LM2		0x15A0
137 #define E1000_DEV_ID_PCH_I218_V2		0x15A1
138 #define E1000_DEV_ID_PCH_I218_LM3		0x15A2 /* Wildcat Point PCH */
139 #define E1000_DEV_ID_PCH_I218_V3		0x15A3 /* Wildcat Point PCH */
140 #define E1000_DEV_ID_PCH_SPT_I219_LM		0x156F /* Sunrise Point PCH */
141 #define E1000_DEV_ID_PCH_SPT_I219_V		0x1570 /* Sunrise Point PCH */
142 #define E1000_DEV_ID_PCH_SPT_I219_LM2		0x15B7 /* Sunrise Point-H PCH */
143 #define E1000_DEV_ID_PCH_SPT_I219_V2		0x15B8 /* Sunrise Point-H PCH */
144 #define E1000_DEV_ID_PCH_LBG_I219_LM3		0x15B9 /* LEWISBURG PCH */
145 #define E1000_DEV_ID_PCH_SPT_I219_LM4		0x15D7
146 #define E1000_DEV_ID_PCH_SPT_I219_V4		0x15D8
147 #define E1000_DEV_ID_PCH_SPT_I219_LM5		0x15E3
148 #define E1000_DEV_ID_PCH_SPT_I219_V5		0x15D6
149 #define E1000_DEV_ID_PCH_CNP_I219_LM6		0x15BD
150 #define E1000_DEV_ID_PCH_CNP_I219_V6		0x15BE
151 #define E1000_DEV_ID_PCH_CNP_I219_LM7		0x15BB
152 #define E1000_DEV_ID_PCH_CNP_I219_V7		0x15BC
153 #define E1000_DEV_ID_PCH_ICP_I219_LM8		0x15DF
154 #define E1000_DEV_ID_PCH_ICP_I219_V8		0x15E0
155 #define E1000_DEV_ID_PCH_ICP_I219_LM9		0x15E1
156 #define E1000_DEV_ID_PCH_ICP_I219_V9		0x15E2
157 #define E1000_DEV_ID_82576			0x10C9
158 #define E1000_DEV_ID_82576_FIBER		0x10E6
159 #define E1000_DEV_ID_82576_SERDES		0x10E7
160 #define E1000_DEV_ID_82576_QUAD_COPPER		0x10E8
161 #define E1000_DEV_ID_82576_QUAD_COPPER_ET2	0x1526
162 #define E1000_DEV_ID_82576_NS			0x150A
163 #define E1000_DEV_ID_82576_NS_SERDES		0x1518
164 #define E1000_DEV_ID_82576_SERDES_QUAD		0x150D
165 #define E1000_DEV_ID_82576_VF			0x10CA
166 #define E1000_DEV_ID_82576_VF_HV		0x152D
167 #define E1000_DEV_ID_I350_VF			0x1520
168 #define E1000_DEV_ID_I350_VF_HV			0x152F
169 #define E1000_DEV_ID_82575EB_COPPER		0x10A7
170 #define E1000_DEV_ID_82575EB_FIBER_SERDES	0x10A9
171 #define E1000_DEV_ID_82575GB_QUAD_COPPER	0x10D6
172 #define E1000_DEV_ID_82580_COPPER		0x150E
173 #define E1000_DEV_ID_82580_FIBER		0x150F
174 #define E1000_DEV_ID_82580_SERDES		0x1510
175 #define E1000_DEV_ID_82580_SGMII		0x1511
176 #define E1000_DEV_ID_82580_COPPER_DUAL		0x1516
177 #define E1000_DEV_ID_82580_QUAD_FIBER		0x1527
178 #define E1000_DEV_ID_I350_COPPER		0x1521
179 #define E1000_DEV_ID_I350_FIBER			0x1522
180 #define E1000_DEV_ID_I350_SERDES		0x1523
181 #define E1000_DEV_ID_I350_SGMII			0x1524
182 #define E1000_DEV_ID_I350_DA4			0x1546
183 #define E1000_DEV_ID_I210_COPPER		0x1533
184 #define E1000_DEV_ID_I210_COPPER_OEM1		0x1534
185 #define E1000_DEV_ID_I210_COPPER_IT		0x1535
186 #define E1000_DEV_ID_I210_FIBER			0x1536
187 #define E1000_DEV_ID_I210_SERDES		0x1537
188 #define E1000_DEV_ID_I210_SGMII			0x1538
189 #define E1000_DEV_ID_I210_COPPER_FLASHLESS	0x157B
190 #define E1000_DEV_ID_I210_SERDES_FLASHLESS	0x157C
191 #define E1000_DEV_ID_I211_COPPER		0x1539
192 #define E1000_DEV_ID_I354_BACKPLANE_1GBPS	0x1F40
193 #define E1000_DEV_ID_I354_SGMII			0x1F41
194 #define E1000_DEV_ID_I354_BACKPLANE_2_5GBPS	0x1F45
195 #define E1000_DEV_ID_DH89XXCC_SGMII		0x0438
196 #define E1000_DEV_ID_DH89XXCC_SERDES		0x043A
197 #define E1000_DEV_ID_DH89XXCC_BACKPLANE		0x043C
198 #define E1000_DEV_ID_DH89XXCC_SFP		0x0440
199 
200 #define E1000_REVISION_0	0
201 #define E1000_REVISION_1	1
202 #define E1000_REVISION_2	2
203 #define E1000_REVISION_3	3
204 #define E1000_REVISION_4	4
205 
206 #define E1000_FUNC_0		0
207 #define E1000_FUNC_1		1
208 #define E1000_FUNC_2		2
209 #define E1000_FUNC_3		3
210 
211 #define E1000_ALT_MAC_ADDRESS_OFFSET_LAN0	0
212 #define E1000_ALT_MAC_ADDRESS_OFFSET_LAN1	3
213 #define E1000_ALT_MAC_ADDRESS_OFFSET_LAN2	6
214 #define E1000_ALT_MAC_ADDRESS_OFFSET_LAN3	9
215 
216 /*
217  * This enumeration represents all of the different kinds of MAC chips that are
218  * used by both the e1000g and igb drivers. The ordering here is important as
219  * certain classes of MACs are very similar, but have minor differences and so
220  * are compared based on the ordering here. Changing the order here should not
221  * be done arbitrarily.
222  */
223 enum e1000_mac_type {
224 	e1000_undefined = 0,
225 	e1000_82542,
226 	e1000_82543,
227 	e1000_82544,
228 	e1000_82540,
229 	e1000_82545,
230 	e1000_82545_rev_3,
231 	e1000_82546,
232 	e1000_82546_rev_3,
233 	e1000_82541,
234 	e1000_82541_rev_2,
235 	e1000_82547,
236 	e1000_82547_rev_2,
237 	e1000_82571,
238 	e1000_82572,
239 	e1000_82573,
240 	e1000_82574,
241 	e1000_82583,
242 	e1000_80003es2lan,
243 	/*
244 	 * The following MACs all share the ich8 style of hardware and are
245 	 * implemented in ich8, though some are a little more different than
246 	 * others. The pch_lpt, pch_spt, and pch_cnp family are a bit more
247 	 * different than the others and just have slight variants in behavior
248 	 * between them. They are ordered based on release.
249 	 */
250 	e1000_ich8lan,
251 	e1000_ich9lan,
252 	e1000_ich10lan,
253 	e1000_pchlan,
254 	e1000_pch2lan,
255 	e1000_pch_lpt,
256 	e1000_pch_spt,
257 	e1000_pch_cnp,
258 	/*
259 	 * After this point all MACs are used by the igb(7D) driver as opposed
260 	 * to e1000g(7D). If a new MAC is specific to e1000g series of devices,
261 	 * then it should be added above this.
262 	 */
263 	e1000_82575,
264 	e1000_82576,
265 	e1000_82580,
266 	e1000_i350,
267 	e1000_i354,
268 	e1000_i210,
269 	e1000_i211,
270 	e1000_vfadapt,
271 	e1000_vfadapt_i350,
272 	e1000_num_macs  /* List is 1-based, so subtract 1 for TRUE count. */
273 };
274 
275 enum e1000_media_type {
276 	e1000_media_type_unknown = 0,
277 	e1000_media_type_copper = 1,
278 	e1000_media_type_fiber = 2,
279 	e1000_media_type_internal_serdes = 3,
280 	e1000_num_media_types
281 };
282 
283 enum e1000_nvm_type {
284 	e1000_nvm_unknown = 0,
285 	e1000_nvm_none,
286 	e1000_nvm_eeprom_spi,
287 	e1000_nvm_eeprom_microwire,
288 	e1000_nvm_flash_hw,
289 	e1000_nvm_invm,
290 	e1000_nvm_flash_sw
291 };
292 
293 enum e1000_nvm_override {
294 	e1000_nvm_override_none = 0,
295 	e1000_nvm_override_spi_small,
296 	e1000_nvm_override_spi_large,
297 	e1000_nvm_override_microwire_small,
298 	e1000_nvm_override_microwire_large
299 };
300 
301 enum e1000_phy_type {
302 	e1000_phy_unknown = 0,
303 	e1000_phy_none,
304 	e1000_phy_m88,
305 	e1000_phy_igp,
306 	e1000_phy_igp_2,
307 	e1000_phy_gg82563,
308 	e1000_phy_igp_3,
309 	e1000_phy_ife,
310 	e1000_phy_bm,
311 	e1000_phy_82578,
312 	e1000_phy_82577,
313 	e1000_phy_82579,
314 	e1000_phy_i217,
315 	e1000_phy_82580,
316 	e1000_phy_vf,
317 	e1000_phy_i210,
318 };
319 
320 enum e1000_bus_type {
321 	e1000_bus_type_unknown = 0,
322 	e1000_bus_type_pci,
323 	e1000_bus_type_pcix,
324 	e1000_bus_type_pci_express,
325 	e1000_bus_type_reserved
326 };
327 
328 enum e1000_bus_speed {
329 	e1000_bus_speed_unknown = 0,
330 	e1000_bus_speed_33,
331 	e1000_bus_speed_66,
332 	e1000_bus_speed_100,
333 	e1000_bus_speed_120,
334 	e1000_bus_speed_133,
335 	e1000_bus_speed_2500,
336 	e1000_bus_speed_5000,
337 	e1000_bus_speed_reserved
338 };
339 
340 enum e1000_bus_width {
341 	e1000_bus_width_unknown = 0,
342 	e1000_bus_width_pcie_x1,
343 	e1000_bus_width_pcie_x2,
344 	e1000_bus_width_pcie_x4 = 4,
345 	e1000_bus_width_pcie_x8 = 8,
346 	e1000_bus_width_32,
347 	e1000_bus_width_64,
348 	e1000_bus_width_reserved
349 };
350 
351 enum e1000_1000t_rx_status {
352 	e1000_1000t_rx_status_not_ok = 0,
353 	e1000_1000t_rx_status_ok,
354 	e1000_1000t_rx_status_undefined = 0xFF
355 };
356 
357 enum e1000_rev_polarity {
358 	e1000_rev_polarity_normal = 0,
359 	e1000_rev_polarity_reversed,
360 	e1000_rev_polarity_undefined = 0xFF
361 };
362 
363 enum e1000_fc_mode {
364 	e1000_fc_none = 0,
365 	e1000_fc_rx_pause,
366 	e1000_fc_tx_pause,
367 	e1000_fc_full,
368 	e1000_fc_default = 0xFF
369 };
370 
371 enum e1000_ffe_config {
372 	e1000_ffe_config_enabled = 0,
373 	e1000_ffe_config_active,
374 	e1000_ffe_config_blocked
375 };
376 
377 enum e1000_dsp_config {
378 	e1000_dsp_config_disabled = 0,
379 	e1000_dsp_config_enabled,
380 	e1000_dsp_config_activated,
381 	e1000_dsp_config_undefined = 0xFF
382 };
383 
384 enum e1000_ms_type {
385 	e1000_ms_hw_default = 0,
386 	e1000_ms_force_master,
387 	e1000_ms_force_slave,
388 	e1000_ms_auto
389 };
390 
391 enum e1000_smart_speed {
392 	e1000_smart_speed_default = 0,
393 	e1000_smart_speed_on,
394 	e1000_smart_speed_off
395 };
396 
397 enum e1000_serdes_link_state {
398 	e1000_serdes_link_down = 0,
399 	e1000_serdes_link_autoneg_progress,
400 	e1000_serdes_link_autoneg_complete,
401 	e1000_serdes_link_forced_up
402 };
403 
404 #define __le16 u16
405 #define __le32 u32
406 #define __le64 u64
407 /* Receive Descriptor */
408 struct e1000_rx_desc {
409 	__le64 buffer_addr; /* Address of the descriptor's data buffer */
410 	__le16 length;      /* Length of data DMAed into data buffer */
411 	__le16 csum; /* Packet checksum */
412 	u8  status;  /* Descriptor status */
413 	u8  errors;  /* Descriptor Errors */
414 	__le16 special;
415 };
416 
417 /* Receive Descriptor - Extended */
418 union e1000_rx_desc_extended {
419 	struct {
420 		__le64 buffer_addr;
421 		__le64 reserved;
422 	} read;
423 	struct {
424 		struct {
425 			__le32 mrq; /* Multiple Rx Queues */
426 			union {
427 				__le32 rss; /* RSS Hash */
428 				struct {
429 					__le16 ip_id;  /* IP id */
430 					__le16 csum;   /* Packet Checksum */
431 				} csum_ip;
432 			} hi_dword;
433 		} lower;
434 		struct {
435 			__le32 status_error;  /* ext status/error */
436 			__le16 length;
437 			__le16 vlan; /* VLAN tag */
438 		} upper;
439 	} wb;  /* writeback */
440 };
441 
442 #define MAX_PS_BUFFERS 4
443 
444 /* Number of packet split data buffers (not including the header buffer) */
445 #define PS_PAGE_BUFFERS	(MAX_PS_BUFFERS - 1)
446 
447 /* Receive Descriptor - Packet Split */
448 union e1000_rx_desc_packet_split {
449 	struct {
450 		/* one buffer for protocol header(s), three data buffers */
451 		__le64 buffer_addr[MAX_PS_BUFFERS];
452 	} read;
453 	struct {
454 		struct {
455 			__le32 mrq;  /* Multiple Rx Queues */
456 			union {
457 				__le32 rss; /* RSS Hash */
458 				struct {
459 					__le16 ip_id;    /* IP id */
460 					__le16 csum;     /* Packet Checksum */
461 				} csum_ip;
462 			} hi_dword;
463 		} lower;
464 		struct {
465 			__le32 status_error;  /* ext status/error */
466 			__le16 length0;  /* length of buffer 0 */
467 			__le16 vlan;  /* VLAN tag */
468 		} middle;
469 		struct {
470 			__le16 header_status;
471 			/* length of buffers 1-3 */
472 			__le16 length[PS_PAGE_BUFFERS];
473 		} upper;
474 		__le64 reserved;
475 	} wb; /* writeback */
476 };
477 
478 /* Transmit Descriptor */
479 struct e1000_tx_desc {
480 	__le64 buffer_addr;   /* Address of the descriptor's data buffer */
481 	union {
482 		__le32 data;
483 		struct {
484 			__le16 length;  /* Data buffer length */
485 			u8 cso;  /* Checksum offset */
486 			u8 cmd;  /* Descriptor control */
487 		} flags;
488 	} lower;
489 	union {
490 		__le32 data;
491 		struct {
492 			u8 status; /* Descriptor status */
493 			u8 css;  /* Checksum start */
494 			__le16 special;
495 		} fields;
496 	} upper;
497 };
498 
499 /* Offload Context Descriptor */
500 struct e1000_context_desc {
501 	union {
502 		__le32 ip_config;
503 		struct {
504 			u8 ipcss;  /* IP checksum start */
505 			u8 ipcso;  /* IP checksum offset */
506 			__le16 ipcse;  /* IP checksum end */
507 		} ip_fields;
508 	} lower_setup;
509 	union {
510 		__le32 tcp_config;
511 		struct {
512 			u8 tucss;  /* TCP checksum start */
513 			u8 tucso;  /* TCP checksum offset */
514 			__le16 tucse;  /* TCP checksum end */
515 		} tcp_fields;
516 	} upper_setup;
517 	__le32 cmd_and_length;
518 	union {
519 		__le32 data;
520 		struct {
521 			u8 status;  /* Descriptor status */
522 			u8 hdr_len;  /* Header length */
523 			__le16 mss;  /* Maximum segment size */
524 		} fields;
525 	} tcp_seg_setup;
526 };
527 
528 /* Offload data descriptor */
529 struct e1000_data_desc {
530 	__le64 buffer_addr;  /* Address of the descriptor's buffer address */
531 	union {
532 		__le32 data;
533 		struct {
534 			__le16 length;  /* Data buffer length */
535 			u8 typ_len_ext;
536 			u8 cmd;
537 		} flags;
538 	} lower;
539 	union {
540 		__le32 data;
541 		struct {
542 			u8 status;  /* Descriptor status */
543 			u8 popts;  /* Packet Options */
544 			__le16 special;
545 		} fields;
546 	} upper;
547 };
548 
549 /* Statistics counters collected by the MAC */
550 struct e1000_hw_stats {
551 	u64 crcerrs;
552 	u64 algnerrc;
553 	u64 symerrs;
554 	u64 rxerrc;
555 	u64 mpc;
556 	u64 scc;
557 	u64 ecol;
558 	u64 mcc;
559 	u64 latecol;
560 	u64 colc;
561 	u64 dc;
562 	u64 tncrs;
563 	u64 sec;
564 	u64 cexterr;
565 	u64 rlec;
566 	u64 xonrxc;
567 	u64 xontxc;
568 	u64 xoffrxc;
569 	u64 xofftxc;
570 	u64 fcruc;
571 	u64 prc64;
572 	u64 prc127;
573 	u64 prc255;
574 	u64 prc511;
575 	u64 prc1023;
576 	u64 prc1522;
577 	u64 gprc;
578 	u64 bprc;
579 	u64 mprc;
580 	u64 gptc;
581 	u64 gorc;
582 	u64 gotc;
583 	u64 rnbc;
584 	u64 ruc;
585 	u64 rfc;
586 	u64 roc;
587 	u64 rjc;
588 	u64 mgprc;
589 	u64 mgpdc;
590 	u64 mgptc;
591 	u64 tor;
592 	u64 tot;
593 	u64 tpr;
594 	u64 tpt;
595 	u64 ptc64;
596 	u64 ptc127;
597 	u64 ptc255;
598 	u64 ptc511;
599 	u64 ptc1023;
600 	u64 ptc1522;
601 	u64 mptc;
602 	u64 bptc;
603 	u64 tsctc;
604 	u64 tsctfc;
605 	u64 iac;
606 	u64 icrxptc;
607 	u64 icrxatc;
608 	u64 ictxptc;
609 	u64 ictxatc;
610 	u64 ictxqec;
611 	u64 ictxqmtc;
612 	u64 icrxdmtc;
613 	u64 icrxoc;
614 	u64 cbtmpc;
615 	u64 htdpmc;
616 	u64 cbrdpc;
617 	u64 cbrmpc;
618 	u64 rpthc;
619 	u64 hgptc;
620 	u64 htcbdpc;
621 	u64 hgorc;
622 	u64 hgotc;
623 	u64 lenerrs;
624 	u64 scvpc;
625 	u64 hrmpc;
626 	u64 doosync;
627 	u64 o2bgptc;
628 	u64 o2bspc;
629 	u64 b2ospc;
630 	u64 b2ogprc;
631 };
632 
633 struct e1000_vf_stats {
634 	u64 base_gprc;
635 	u64 base_gptc;
636 	u64 base_gorc;
637 	u64 base_gotc;
638 	u64 base_mprc;
639 	u64 base_gotlbc;
640 	u64 base_gptlbc;
641 	u64 base_gorlbc;
642 	u64 base_gprlbc;
643 
644 	u32 last_gprc;
645 	u32 last_gptc;
646 	u32 last_gorc;
647 	u32 last_gotc;
648 	u32 last_mprc;
649 	u32 last_gotlbc;
650 	u32 last_gptlbc;
651 	u32 last_gorlbc;
652 	u32 last_gprlbc;
653 
654 	u64 gprc;
655 	u64 gptc;
656 	u64 gorc;
657 	u64 gotc;
658 	u64 mprc;
659 	u64 gotlbc;
660 	u64 gptlbc;
661 	u64 gorlbc;
662 	u64 gprlbc;
663 };
664 
665 struct e1000_phy_stats {
666 	u32 idle_errors;
667 	u32 receive_errors;
668 };
669 
670 struct e1000_host_mng_dhcp_cookie {
671 	u32 signature;
672 	u8  status;
673 	u8  reserved0;
674 	u16 vlan_id;
675 	u32 reserved1;
676 	u16 reserved2;
677 	u8  reserved3;
678 	u8  checksum;
679 };
680 
681 /* Host Interface "Rev 1" */
682 struct e1000_host_command_header {
683 	u8 command_id;
684 	u8 command_length;
685 	u8 command_options;
686 	u8 checksum;
687 };
688 
689 #define E1000_HI_MAX_DATA_LENGTH	252
690 struct e1000_host_command_info {
691 	struct e1000_host_command_header command_header;
692 	u8 command_data[E1000_HI_MAX_DATA_LENGTH];
693 };
694 
695 /* Host Interface "Rev 2" */
696 struct e1000_host_mng_command_header {
697 	u8  command_id;
698 	u8  checksum;
699 	u16 reserved1;
700 	u16 reserved2;
701 	u16 command_length;
702 };
703 
704 #define E1000_HI_MAX_MNG_DATA_LENGTH	0x6F8
705 struct e1000_host_mng_command_info {
706 	struct e1000_host_mng_command_header command_header;
707 	u8 command_data[E1000_HI_MAX_MNG_DATA_LENGTH];
708 };
709 
710 #include "e1000_mac.h"
711 #include "e1000_phy.h"
712 #include "e1000_nvm.h"
713 #include "e1000_manage.h"
714 #include "e1000_mbx.h"
715 
716 /* Function pointers for the MAC. */
717 struct e1000_mac_operations {
718 	s32  (*init_params)(struct e1000_hw *);
719 	s32  (*id_led_init)(struct e1000_hw *);
720 	s32  (*blink_led)(struct e1000_hw *);
721 	bool (*check_mng_mode)(struct e1000_hw *);
722 	s32  (*check_for_link)(struct e1000_hw *);
723 	s32  (*cleanup_led)(struct e1000_hw *);
724 	void (*clear_hw_cntrs)(struct e1000_hw *);
725 	void (*clear_vfta)(struct e1000_hw *);
726 	s32  (*get_bus_info)(struct e1000_hw *);
727 	void (*set_lan_id)(struct e1000_hw *);
728 	s32  (*get_link_up_info)(struct e1000_hw *, u16 *, u16 *);
729 	s32  (*led_on)(struct e1000_hw *);
730 	s32  (*led_off)(struct e1000_hw *);
731 	void (*update_mc_addr_list)(struct e1000_hw *, u8 *, u32);
732 	s32  (*reset_hw)(struct e1000_hw *);
733 	s32  (*init_hw)(struct e1000_hw *);
734 	void (*shutdown_serdes)(struct e1000_hw *);
735 	void (*power_up_serdes)(struct e1000_hw *);
736 	s32  (*setup_link)(struct e1000_hw *);
737 	s32  (*setup_physical_interface)(struct e1000_hw *);
738 	s32  (*setup_led)(struct e1000_hw *);
739 	void (*write_vfta)(struct e1000_hw *, u32, u32);
740 	void (*config_collision_dist)(struct e1000_hw *);
741 	int  (*rar_set)(struct e1000_hw *, u8*, u32);
742 	s32  (*read_mac_addr)(struct e1000_hw *);
743 	s32  (*validate_mdi_setting)(struct e1000_hw *);
744 	s32  (*set_obff_timer)(struct e1000_hw *, u32);
745 	s32  (*acquire_swfw_sync)(struct e1000_hw *, u16);
746 	void (*release_swfw_sync)(struct e1000_hw *, u16);
747 };
748 
749 /* When to use various PHY register access functions:
750  *
751  *                 Func   Caller
752  *   Function      Does   Does    When to use
753  *   ~~~~~~~~~~~~  ~~~~~  ~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
754  *   X_reg         L,P,A  n/a     for simple PHY reg accesses
755  *   X_reg_locked  P,A    L       for multiple accesses of different regs
756  *                                on different pages
757  *   X_reg_page    A      L,P     for multiple accesses of different regs
758  *                                on the same page
759  *
760  * Where X=[read|write], L=locking, P=sets page, A=register access
761  *
762  */
763 struct e1000_phy_operations {
764 	s32  (*init_params)(struct e1000_hw *);
765 	s32  (*acquire)(struct e1000_hw *);
766 	s32  (*cfg_on_link_up)(struct e1000_hw *);
767 	s32  (*check_polarity)(struct e1000_hw *);
768 	s32  (*check_reset_block)(struct e1000_hw *);
769 	s32  (*commit)(struct e1000_hw *);
770 	s32  (*force_speed_duplex)(struct e1000_hw *);
771 	s32  (*get_cfg_done)(struct e1000_hw *hw);
772 	s32  (*get_cable_length)(struct e1000_hw *);
773 	s32  (*get_info)(struct e1000_hw *);
774 	s32  (*set_page)(struct e1000_hw *, u16);
775 	s32  (*read_reg)(struct e1000_hw *, u32, u16 *);
776 	s32  (*read_reg_locked)(struct e1000_hw *, u32, u16 *);
777 	s32  (*read_reg_page)(struct e1000_hw *, u32, u16 *);
778 	void (*release)(struct e1000_hw *);
779 	s32  (*reset)(struct e1000_hw *);
780 	s32  (*set_d0_lplu_state)(struct e1000_hw *, bool);
781 	s32  (*set_d3_lplu_state)(struct e1000_hw *, bool);
782 	s32  (*write_reg)(struct e1000_hw *, u32, u16);
783 	s32  (*write_reg_locked)(struct e1000_hw *, u32, u16);
784 	s32  (*write_reg_page)(struct e1000_hw *, u32, u16);
785 	void (*power_up)(struct e1000_hw *);
786 	void (*power_down)(struct e1000_hw *);
787 	s32 (*read_i2c_byte)(struct e1000_hw *, u8, u8, u8 *);
788 	s32 (*write_i2c_byte)(struct e1000_hw *, u8, u8, u8);
789 };
790 
791 /* Function pointers for the NVM. */
792 struct e1000_nvm_operations {
793 	s32  (*init_params)(struct e1000_hw *);
794 	s32  (*acquire)(struct e1000_hw *);
795 	s32  (*read)(struct e1000_hw *, u16, u16, u16 *);
796 	void (*release)(struct e1000_hw *);
797 	void (*reload)(struct e1000_hw *);
798 	s32  (*update)(struct e1000_hw *);
799 	s32  (*valid_led_default)(struct e1000_hw *, u16 *);
800 	s32  (*validate)(struct e1000_hw *);
801 	s32  (*write)(struct e1000_hw *, u16, u16, u16 *);
802 };
803 
804 struct e1000_mac_info {
805 	struct e1000_mac_operations ops;
806 	u8 addr[ETH_ADDR_LEN];
807 	u8 perm_addr[ETH_ADDR_LEN];
808 
809 	enum e1000_mac_type type;
810 
811 	u32 collision_delta;
812 	u32 ledctl_default;
813 	u32 ledctl_mode1;
814 	u32 ledctl_mode2;
815 	u32 mc_filter_type;
816 	u32 tx_packet_delta;
817 	u32 txcw;
818 
819 	u16 current_ifs_val;
820 	u16 ifs_max_val;
821 	u16 ifs_min_val;
822 	u16 ifs_ratio;
823 	u16 ifs_step_size;
824 	u16 mta_reg_count;
825 	u16 uta_reg_count;
826 
827 	/* Maximum size of the MTA register table in all supported adapters */
828 #define MAX_MTA_REG 128
829 	u32 mta_shadow[MAX_MTA_REG];
830 	u16 rar_entry_count;
831 
832 	u8  forced_speed_duplex;
833 
834 	bool adaptive_ifs;
835 	bool has_fwsm;
836 	bool arc_subsystem_valid;
837 	bool asf_firmware_present;
838 	bool autoneg;
839 	bool autoneg_failed;
840 	bool get_link_status;
841 	bool in_ifs_mode;
842 	bool report_tx_early;
843 	enum e1000_serdes_link_state serdes_link_state;
844 	bool serdes_has_link;
845 	bool tx_pkt_filtering;
846 	u32  max_frame_size;
847 };
848 
849 struct e1000_phy_info {
850 	struct e1000_phy_operations ops;
851 	enum e1000_phy_type type;
852 
853 	enum e1000_1000t_rx_status local_rx;
854 	enum e1000_1000t_rx_status remote_rx;
855 	enum e1000_ms_type ms_type;
856 	enum e1000_ms_type original_ms_type;
857 	enum e1000_rev_polarity cable_polarity;
858 	enum e1000_smart_speed smart_speed;
859 
860 	u32 addr;
861 	u32 id;
862 	u32 reset_delay_us; /* in usec */
863 	u32 revision;
864 
865 	enum e1000_media_type media_type;
866 
867 	u16 autoneg_advertised;
868 	u16 autoneg_mask;
869 	u16 cable_length;
870 	u16 max_cable_length;
871 	u16 min_cable_length;
872 
873 	u8 mdix;
874 
875 	bool disable_polarity_correction;
876 	bool is_mdix;
877 	bool polarity_correction;
878 	bool speed_downgraded;
879 	bool autoneg_wait_to_complete;
880 };
881 
882 struct e1000_nvm_info {
883 	struct e1000_nvm_operations ops;
884 	enum e1000_nvm_type type;
885 	enum e1000_nvm_override override;
886 
887 	u32 flash_bank_size;
888 	u32 flash_base_addr;
889 
890 	u16 word_size;
891 	u16 delay_usec;
892 	u16 address_bits;
893 	u16 opcode_bits;
894 	u16 page_size;
895 };
896 
897 struct e1000_bus_info {
898 	enum e1000_bus_type type;
899 	enum e1000_bus_speed speed;
900 	enum e1000_bus_width width;
901 
902 	u16 func;
903 	u16 pci_cmd_word;
904 };
905 
906 struct e1000_fc_info {
907 	u32 high_water;  /* Flow control high-water mark */
908 	u32 low_water;  /* Flow control low-water mark */
909 	u16 pause_time;  /* Flow control pause timer */
910 	u16 refresh_time;  /* Flow control refresh timer */
911 	bool send_xon;  /* Flow control send XON */
912 	bool strict_ieee;  /* Strict IEEE mode */
913 	enum e1000_fc_mode current_mode;  /* FC mode in effect */
914 	enum e1000_fc_mode requested_mode;  /* FC mode requested by caller */
915 };
916 
917 struct e1000_mbx_operations {
918 	s32 (*init_params)(struct e1000_hw *hw);
919 	s32 (*read)(struct e1000_hw *, u32 *, u16,  u16);
920 	s32 (*write)(struct e1000_hw *, u32 *, u16, u16);
921 	s32 (*read_posted)(struct e1000_hw *, u32 *, u16,  u16);
922 	s32 (*write_posted)(struct e1000_hw *, u32 *, u16, u16);
923 	s32 (*check_for_msg)(struct e1000_hw *, u16);
924 	s32 (*check_for_ack)(struct e1000_hw *, u16);
925 	s32 (*check_for_rst)(struct e1000_hw *, u16);
926 };
927 
928 struct e1000_mbx_stats {
929 	u32 msgs_tx;
930 	u32 msgs_rx;
931 
932 	u32 acks;
933 	u32 reqs;
934 	u32 rsts;
935 };
936 
937 struct e1000_mbx_info {
938 	struct e1000_mbx_operations ops;
939 	struct e1000_mbx_stats stats;
940 	u32 timeout;
941 	u32 usec_delay;
942 	u16 size;
943 };
944 
945 struct e1000_dev_spec_82541 {
946 	enum e1000_dsp_config dsp_config;
947 	enum e1000_ffe_config ffe_config;
948 	u32 tx_fifo_head;
949 	u32 tx_fifo_start;
950 	u32 tx_fifo_size;
951 	u16 dsp_reset_counter;
952 	u16 spd_default;
953 	bool phy_init_script;
954 	bool ttl_workaround;
955 };
956 
957 struct e1000_dev_spec_82542 {
958 	bool dma_fairness;
959 };
960 
961 struct e1000_dev_spec_82543 {
962 	u32  tbi_compatibility;
963 	bool dma_fairness;
964 	bool init_phy_disabled;
965 };
966 
967 struct e1000_dev_spec_82571 {
968 	bool laa_is_present;
969 	u32 smb_counter;
970 	E1000_MUTEX swflag_mutex;
971 };
972 
973 struct e1000_dev_spec_80003es2lan {
974 	bool  mdic_wa_enable;
975 };
976 
977 struct e1000_shadow_ram {
978 	u16  value;
979 	bool modified;
980 };
981 
982 #define E1000_SHADOW_RAM_WORDS		2048
983 
984 /* I218 PHY Ultra Low Power (ULP) states */
985 enum e1000_ulp_state {
986 	e1000_ulp_state_unknown,
987 	e1000_ulp_state_off,
988 	e1000_ulp_state_on,
989 };
990 
991 struct e1000_dev_spec_ich8lan {
992 	bool kmrn_lock_loss_workaround_enabled;
993 	struct e1000_shadow_ram shadow_ram[E1000_SHADOW_RAM_WORDS];
994 	E1000_MUTEX nvm_mutex;
995 	E1000_MUTEX swflag_mutex;
996 	bool nvm_k1_enabled;
997 	bool disable_k1_off;
998 	bool eee_disable;
999 	u16 eee_lp_ability;
1000 	enum e1000_ulp_state ulp_state;
1001 	bool ulp_capability_disabled;
1002 	bool during_suspend_flow;
1003 	bool during_dpg_exit;
1004 };
1005 
1006 struct e1000_dev_spec_82575 {
1007 	bool sgmii_active;
1008 	bool global_device_reset;
1009 	bool eee_disable;
1010 	bool module_plugged;
1011 	bool clear_semaphore_once;
1012 	u32 mtu;
1013 	struct sfp_e1000_flags eth_flags;
1014 	u8 media_port;
1015 	bool media_changed;
1016 };
1017 
1018 struct e1000_dev_spec_vf {
1019 	u32 vf_number;
1020 	u32 v2p_mailbox;
1021 };
1022 
1023 struct e1000_hw {
1024 	void *back;
1025 
1026 	u8 *hw_addr;
1027 	u8 *flash_address;
1028 	unsigned long io_base;
1029 
1030 	struct e1000_mac_info  mac;
1031 	struct e1000_fc_info   fc;
1032 	struct e1000_phy_info  phy;
1033 	struct e1000_nvm_info  nvm;
1034 	struct e1000_bus_info  bus;
1035 	struct e1000_mbx_info mbx;
1036 	struct e1000_host_mng_dhcp_cookie mng_cookie;
1037 
1038 	union {
1039 		struct e1000_dev_spec_82541 _82541;
1040 		struct e1000_dev_spec_82542 _82542;
1041 		struct e1000_dev_spec_82543 _82543;
1042 		struct e1000_dev_spec_82571 _82571;
1043 		struct e1000_dev_spec_80003es2lan _80003es2lan;
1044 		struct e1000_dev_spec_ich8lan ich8lan;
1045 		struct e1000_dev_spec_82575 _82575;
1046 		struct e1000_dev_spec_vf vf;
1047 	} dev_spec;
1048 
1049 	u16 device_id;
1050 	u16 subsystem_vendor_id;
1051 	u16 subsystem_device_id;
1052 	u16 vendor_id;
1053 
1054 	u8  revision_id;
1055 };
1056 
1057 #include "e1000_82541.h"
1058 #include "e1000_82543.h"
1059 #include "e1000_82571.h"
1060 #include "e1000_80003es2lan.h"
1061 #include "e1000_ich8lan.h"
1062 #include "e1000_82575.h"
1063 #include "e1000_i210.h"
1064 
1065 /* These functions must be implemented by drivers */
1066 void e1000_pci_clear_mwi(struct e1000_hw *hw);
1067 void e1000_pci_set_mwi(struct e1000_hw *hw);
1068 s32  e1000_read_pcie_cap_reg(struct e1000_hw *hw, u32 reg, u16 *value);
1069 s32  e1000_write_pcie_cap_reg(struct e1000_hw *hw, u32 reg, u16 *value);
1070 void e1000_read_pci_cfg(struct e1000_hw *hw, u32 reg, u16 *value);
1071 void e1000_write_pci_cfg(struct e1000_hw *hw, u32 reg, u16 *value);
1072 
1073 #endif
1074