Linux Audio

Check our new training course

Loading...
v6.13.7
  1// SPDX-License-Identifier: GPL-2.0
  2/* Copyright(c) 1999 - 2006 Intel Corporation. */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  3
  4#include "e1000.h"
  5
  6/* This is the only thing that needs to be changed to adjust the
  7 * maximum number of ports that the driver can manage.
  8 */
  9
 10#define E1000_MAX_NIC 32
 11
 12#define OPTION_UNSET   -1
 13#define OPTION_DISABLED 0
 14#define OPTION_ENABLED  1
 15
 16/* All parameters are treated the same, as an integer array of values.
 17 * This macro just reduces the need to repeat the same declaration code
 18 * over and over (plus this helps to avoid typo bugs).
 19 */
 20
 21#define E1000_PARAM_INIT { [0 ... E1000_MAX_NIC] = OPTION_UNSET }
 22#define E1000_PARAM(X, desc) \
 23	static int X[E1000_MAX_NIC+1] = E1000_PARAM_INIT; \
 24	static unsigned int num_##X; \
 25	module_param_array_named(X, X, int, &num_##X, 0); \
 26	MODULE_PARM_DESC(X, desc);
 27
 28/* Transmit Descriptor Count
 29 *
 30 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers
 31 * Valid Range: 80-4096 for 82544 and newer
 32 *
 33 * Default Value: 256
 34 */
 35E1000_PARAM(TxDescriptors, "Number of transmit descriptors");
 36
 37/* Receive Descriptor Count
 38 *
 39 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers
 40 * Valid Range: 80-4096 for 82544 and newer
 41 *
 42 * Default Value: 256
 43 */
 44E1000_PARAM(RxDescriptors, "Number of receive descriptors");
 45
 46/* User Specified Speed Override
 47 *
 48 * Valid Range: 0, 10, 100, 1000
 49 *  - 0    - auto-negotiate at all supported speeds
 50 *  - 10   - only link at 10 Mbps
 51 *  - 100  - only link at 100 Mbps
 52 *  - 1000 - only link at 1000 Mbps
 53 *
 54 * Default Value: 0
 55 */
 56E1000_PARAM(Speed, "Speed setting");
 57
 58/* User Specified Duplex Override
 59 *
 60 * Valid Range: 0-2
 61 *  - 0 - auto-negotiate for duplex
 62 *  - 1 - only link at half duplex
 63 *  - 2 - only link at full duplex
 64 *
 65 * Default Value: 0
 66 */
 67E1000_PARAM(Duplex, "Duplex setting");
 68
 69/* Auto-negotiation Advertisement Override
 70 *
 71 * Valid Range: 0x01-0x0F, 0x20-0x2F (copper); 0x20 (fiber)
 72 *
 73 * The AutoNeg value is a bit mask describing which speed and duplex
 74 * combinations should be advertised during auto-negotiation.
 75 * The supported speed and duplex modes are listed below
 76 *
 77 * Bit           7     6     5      4      3     2     1      0
 78 * Speed (Mbps)  N/A   N/A   1000   N/A    100   100   10     10
 79 * Duplex                    Full          Full  Half  Full   Half
 80 *
 81 * Default Value: 0x2F (copper); 0x20 (fiber)
 82 */
 83E1000_PARAM(AutoNeg, "Advertised auto-negotiation setting");
 84#define AUTONEG_ADV_DEFAULT  0x2F
 
 85
 86/* User Specified Flow Control Override
 87 *
 88 * Valid Range: 0-3
 89 *  - 0 - No Flow Control
 90 *  - 1 - Rx only, respond to PAUSE frames but do not generate them
 91 *  - 2 - Tx only, generate PAUSE frames but ignore them on receive
 92 *  - 3 - Full Flow Control Support
 93 *
 94 * Default Value: Read flow control settings from the EEPROM
 95 */
 96E1000_PARAM(FlowControl, "Flow Control setting");
 
 97
 98/* XsumRX - Receive Checksum Offload Enable/Disable
 99 *
100 * Valid Range: 0, 1
101 *  - 0 - disables all checksum offload
102 *  - 1 - enables receive IP/TCP/UDP checksum offload
103 *        on 82543 and newer -based NICs
104 *
105 * Default Value: 1
106 */
107E1000_PARAM(XsumRX, "Disable or enable Receive Checksum offload");
108
109/* Transmit Interrupt Delay in units of 1.024 microseconds
110 *  Tx interrupt delay needs to typically be set to something non zero
111 *
112 * Valid Range: 0-65535
113 */
114E1000_PARAM(TxIntDelay, "Transmit Interrupt Delay");
115#define DEFAULT_TIDV                   8
116#define MAX_TXDELAY               0xFFFF
117#define MIN_TXDELAY                    0
118
119/* Transmit Absolute Interrupt Delay in units of 1.024 microseconds
120 *
121 * Valid Range: 0-65535
122 */
123E1000_PARAM(TxAbsIntDelay, "Transmit Absolute Interrupt Delay");
124#define DEFAULT_TADV                  32
125#define MAX_TXABSDELAY            0xFFFF
126#define MIN_TXABSDELAY                 0
127
128/* Receive Interrupt Delay in units of 1.024 microseconds
129 *   hardware will likely hang if you set this to anything but zero.
130 *
131 * Valid Range: 0-65535
132 */
133E1000_PARAM(RxIntDelay, "Receive Interrupt Delay");
134#define DEFAULT_RDTR                   0
135#define MAX_RXDELAY               0xFFFF
136#define MIN_RXDELAY                    0
137
138/* Receive Absolute Interrupt Delay in units of 1.024 microseconds
139 *
140 * Valid Range: 0-65535
141 */
142E1000_PARAM(RxAbsIntDelay, "Receive Absolute Interrupt Delay");
143#define DEFAULT_RADV                   8
144#define MAX_RXABSDELAY            0xFFFF
145#define MIN_RXABSDELAY                 0
146
147/* Interrupt Throttle Rate (interrupts/sec)
148 *
149 * Valid Range: 100-100000 (0=off, 1=dynamic, 3=dynamic conservative)
150 */
151E1000_PARAM(InterruptThrottleRate, "Interrupt Throttling Rate");
152#define DEFAULT_ITR                    3
153#define MAX_ITR                   100000
154#define MIN_ITR                      100
155
156/* Enable Smart Power Down of the PHY
157 *
158 * Valid Range: 0, 1
159 *
160 * Default Value: 0 (disabled)
161 */
162E1000_PARAM(SmartPowerDownEnable, "Enable PHY smart power down");
163
164struct e1000_option {
165	enum { enable_option, range_option, list_option } type;
166	const char *name;
167	const char *err;
168	int def;
169	union {
170		struct { /* range_option info */
171			int min;
172			int max;
173		} r;
174		struct { /* list_option info */
175			int nr;
176			const struct e1000_opt_list { int i; char *str; } *p;
177		} l;
178	} arg;
179};
180
181static int e1000_validate_option(unsigned int *value,
182				 const struct e1000_option *opt,
183				 struct e1000_adapter *adapter)
184{
185	if (*value == OPTION_UNSET) {
186		*value = opt->def;
187		return 0;
188	}
189
190	switch (opt->type) {
191	case enable_option:
192		switch (*value) {
193		case OPTION_ENABLED:
194			e_dev_info("%s Enabled\n", opt->name);
195			return 0;
196		case OPTION_DISABLED:
197			e_dev_info("%s Disabled\n", opt->name);
198			return 0;
199		}
200		break;
201	case range_option:
202		if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) {
203			e_dev_info("%s set to %i\n", opt->name, *value);
204			return 0;
205		}
206		break;
207	case list_option: {
208		int i;
209		const struct e1000_opt_list *ent;
210
211		for (i = 0; i < opt->arg.l.nr; i++) {
212			ent = &opt->arg.l.p[i];
213			if (*value == ent->i) {
214				if (ent->str[0] != '\0')
215					e_dev_info("%s\n", ent->str);
216				return 0;
217			}
218		}
219	}
220		break;
221	default:
222		BUG();
223	}
224
225	e_dev_info("Invalid %s value specified (%i) %s\n",
226	       opt->name, *value, opt->err);
227	*value = opt->def;
228	return -1;
229}
230
231static void e1000_check_fiber_options(struct e1000_adapter *adapter);
232static void e1000_check_copper_options(struct e1000_adapter *adapter);
233
234/**
235 * e1000_check_options - Range Checking for Command Line Parameters
236 * @adapter: board private structure
237 *
238 * This routine checks all command line parameters for valid user
239 * input.  If an invalid value is given, or if no user specified
240 * value exists, a default value is used.  The final value is stored
241 * in a variable in the adapter structure.
242 **/
243void e1000_check_options(struct e1000_adapter *adapter)
244{
245	struct e1000_option opt;
246	int bd = adapter->bd_number;
247
248	if (bd >= E1000_MAX_NIC) {
249		e_dev_warn("Warning: no configuration for board #%i "
250			   "using defaults for all values\n", bd);
251	}
252
253	{ /* Transmit Descriptor Count */
254		struct e1000_tx_ring *tx_ring = adapter->tx_ring;
255		int i;
256		e1000_mac_type mac_type = adapter->hw.mac_type;
257
258		opt = (struct e1000_option) {
259			.type = range_option,
260			.name = "Transmit Descriptors",
261			.err  = "using default of "
262				__MODULE_STRING(E1000_DEFAULT_TXD),
263			.def  = E1000_DEFAULT_TXD,
264			.arg  = { .r = {
265				.min = E1000_MIN_TXD,
266				.max = mac_type < e1000_82544 ? E1000_MAX_TXD : E1000_MAX_82544_TXD
267				}}
268		};
269
270		if (num_TxDescriptors > bd) {
271			tx_ring->count = TxDescriptors[bd];
272			e1000_validate_option(&tx_ring->count, &opt, adapter);
273			tx_ring->count = ALIGN(tx_ring->count,
274						REQ_TX_DESCRIPTOR_MULTIPLE);
275		} else {
276			tx_ring->count = opt.def;
277		}
278		for (i = 0; i < adapter->num_tx_queues; i++)
279			tx_ring[i].count = tx_ring->count;
280	}
281	{ /* Receive Descriptor Count */
282		struct e1000_rx_ring *rx_ring = adapter->rx_ring;
283		int i;
284		e1000_mac_type mac_type = adapter->hw.mac_type;
285
286		opt = (struct e1000_option) {
287			.type = range_option,
288			.name = "Receive Descriptors",
289			.err  = "using default of "
290				__MODULE_STRING(E1000_DEFAULT_RXD),
291			.def  = E1000_DEFAULT_RXD,
292			.arg  = { .r = {
293				.min = E1000_MIN_RXD,
294				.max = mac_type < e1000_82544 ? E1000_MAX_RXD :
295				       E1000_MAX_82544_RXD
296			}}
297		};
298
299		if (num_RxDescriptors > bd) {
300			rx_ring->count = RxDescriptors[bd];
301			e1000_validate_option(&rx_ring->count, &opt, adapter);
302			rx_ring->count = ALIGN(rx_ring->count,
303						REQ_RX_DESCRIPTOR_MULTIPLE);
304		} else {
305			rx_ring->count = opt.def;
306		}
307		for (i = 0; i < adapter->num_rx_queues; i++)
308			rx_ring[i].count = rx_ring->count;
309	}
310	{ /* Checksum Offload Enable/Disable */
311		opt = (struct e1000_option) {
312			.type = enable_option,
313			.name = "Checksum Offload",
314			.err  = "defaulting to Enabled",
315			.def  = OPTION_ENABLED
316		};
317
318		if (num_XsumRX > bd) {
319			unsigned int rx_csum = XsumRX[bd];
320			e1000_validate_option(&rx_csum, &opt, adapter);
321			adapter->rx_csum = rx_csum;
322		} else {
323			adapter->rx_csum = opt.def;
324		}
325	}
326	{ /* Flow Control */
327
328		static const struct e1000_opt_list fc_list[] = {
329		       { E1000_FC_NONE, "Flow Control Disabled" },
330		       { E1000_FC_RX_PAUSE, "Flow Control Receive Only" },
331		       { E1000_FC_TX_PAUSE, "Flow Control Transmit Only" },
332		       { E1000_FC_FULL, "Flow Control Enabled" },
333		       { E1000_FC_DEFAULT, "Flow Control Hardware Default" }
334		};
335
336		opt = (struct e1000_option) {
337			.type = list_option,
338			.name = "Flow Control",
339			.err  = "reading default settings from EEPROM",
340			.def  = E1000_FC_DEFAULT,
341			.arg  = { .l = { .nr = ARRAY_SIZE(fc_list),
342					 .p = fc_list }}
343		};
344
345		if (num_FlowControl > bd) {
346			unsigned int fc = FlowControl[bd];
347			e1000_validate_option(&fc, &opt, adapter);
348			adapter->hw.fc = adapter->hw.original_fc = fc;
349		} else {
350			adapter->hw.fc = adapter->hw.original_fc = opt.def;
351		}
352	}
353	{ /* Transmit Interrupt Delay */
354		opt = (struct e1000_option) {
355			.type = range_option,
356			.name = "Transmit Interrupt Delay",
357			.err  = "using default of " __MODULE_STRING(DEFAULT_TIDV),
358			.def  = DEFAULT_TIDV,
359			.arg  = { .r = { .min = MIN_TXDELAY,
360					 .max = MAX_TXDELAY }}
361		};
362
363		if (num_TxIntDelay > bd) {
364			adapter->tx_int_delay = TxIntDelay[bd];
365			e1000_validate_option(&adapter->tx_int_delay, &opt,
366			                      adapter);
367		} else {
368			adapter->tx_int_delay = opt.def;
369		}
370	}
371	{ /* Transmit Absolute Interrupt Delay */
372		opt = (struct e1000_option) {
373			.type = range_option,
374			.name = "Transmit Absolute Interrupt Delay",
375			.err  = "using default of " __MODULE_STRING(DEFAULT_TADV),
376			.def  = DEFAULT_TADV,
377			.arg  = { .r = { .min = MIN_TXABSDELAY,
378					 .max = MAX_TXABSDELAY }}
379		};
380
381		if (num_TxAbsIntDelay > bd) {
382			adapter->tx_abs_int_delay = TxAbsIntDelay[bd];
383			e1000_validate_option(&adapter->tx_abs_int_delay, &opt,
384					      adapter);
385		} else {
386			adapter->tx_abs_int_delay = opt.def;
387		}
388	}
389	{ /* Receive Interrupt Delay */
390		opt = (struct e1000_option) {
391			.type = range_option,
392			.name = "Receive Interrupt Delay",
393			.err  = "using default of " __MODULE_STRING(DEFAULT_RDTR),
394			.def  = DEFAULT_RDTR,
395			.arg  = { .r = { .min = MIN_RXDELAY,
396					 .max = MAX_RXDELAY }}
397		};
398
399		if (num_RxIntDelay > bd) {
400			adapter->rx_int_delay = RxIntDelay[bd];
401			e1000_validate_option(&adapter->rx_int_delay, &opt,
402					      adapter);
403		} else {
404			adapter->rx_int_delay = opt.def;
405		}
406	}
407	{ /* Receive Absolute Interrupt Delay */
408		opt = (struct e1000_option) {
409			.type = range_option,
410			.name = "Receive Absolute Interrupt Delay",
411			.err  = "using default of " __MODULE_STRING(DEFAULT_RADV),
412			.def  = DEFAULT_RADV,
413			.arg  = { .r = { .min = MIN_RXABSDELAY,
414					 .max = MAX_RXABSDELAY }}
415		};
416
417		if (num_RxAbsIntDelay > bd) {
418			adapter->rx_abs_int_delay = RxAbsIntDelay[bd];
419			e1000_validate_option(&adapter->rx_abs_int_delay, &opt,
420					      adapter);
421		} else {
422			adapter->rx_abs_int_delay = opt.def;
423		}
424	}
425	{ /* Interrupt Throttling Rate */
426		opt = (struct e1000_option) {
427			.type = range_option,
428			.name = "Interrupt Throttling Rate (ints/sec)",
429			.err  = "using default of " __MODULE_STRING(DEFAULT_ITR),
430			.def  = DEFAULT_ITR,
431			.arg  = { .r = { .min = MIN_ITR,
432					 .max = MAX_ITR }}
433		};
434
435		if (num_InterruptThrottleRate > bd) {
436			adapter->itr = InterruptThrottleRate[bd];
437			switch (adapter->itr) {
438			case 0:
439				e_dev_info("%s turned off\n", opt.name);
440				break;
441			case 1:
442				e_dev_info("%s set to dynamic mode\n",
443					   opt.name);
444				adapter->itr_setting = adapter->itr;
445				adapter->itr = 20000;
446				break;
447			case 3:
448				e_dev_info("%s set to dynamic conservative "
449					   "mode\n", opt.name);
450				adapter->itr_setting = adapter->itr;
451				adapter->itr = 20000;
452				break;
453			case 4:
454				e_dev_info("%s set to simplified "
455					   "(2000-8000) ints mode\n", opt.name);
456				adapter->itr_setting = adapter->itr;
457				break;
458			default:
459				e1000_validate_option(&adapter->itr, &opt,
460						      adapter);
461				/* save the setting, because the dynamic bits
462				 * change itr.
463				 * clear the lower two bits because they are
464				 * used as control
465				 */
466				adapter->itr_setting = adapter->itr & ~3;
467				break;
468			}
469		} else {
470			adapter->itr_setting = opt.def;
471			adapter->itr = 20000;
472		}
473	}
474	{ /* Smart Power Down */
475		opt = (struct e1000_option) {
476			.type = enable_option,
477			.name = "PHY Smart Power Down",
478			.err  = "defaulting to Disabled",
479			.def  = OPTION_DISABLED
480		};
481
482		if (num_SmartPowerDownEnable > bd) {
483			unsigned int spd = SmartPowerDownEnable[bd];
484			e1000_validate_option(&spd, &opt, adapter);
485			adapter->smart_power_down = spd;
486		} else {
487			adapter->smart_power_down = opt.def;
488		}
489	}
490
491	switch (adapter->hw.media_type) {
492	case e1000_media_type_fiber:
493	case e1000_media_type_internal_serdes:
494		e1000_check_fiber_options(adapter);
495		break;
496	case e1000_media_type_copper:
497		e1000_check_copper_options(adapter);
498		break;
499	default:
500		BUG();
501	}
502}
503
504/**
505 * e1000_check_fiber_options - Range Checking for Link Options, Fiber Version
506 * @adapter: board private structure
507 *
508 * Handles speed and duplex options on fiber adapters
509 **/
510static void e1000_check_fiber_options(struct e1000_adapter *adapter)
511{
512	int bd = adapter->bd_number;
513	if (num_Speed > bd) {
514		e_dev_info("Speed not valid for fiber adapters, parameter "
515			   "ignored\n");
516	}
517
518	if (num_Duplex > bd) {
519		e_dev_info("Duplex not valid for fiber adapters, parameter "
520			   "ignored\n");
521	}
522
523	if ((num_AutoNeg > bd) && (AutoNeg[bd] != 0x20)) {
524		e_dev_info("AutoNeg other than 1000/Full is not valid for fiber"
525			   "adapters, parameter ignored\n");
526	}
527}
528
529/**
530 * e1000_check_copper_options - Range Checking for Link Options, Copper Version
531 * @adapter: board private structure
532 *
533 * Handles speed and duplex options on copper adapters
534 **/
535static void e1000_check_copper_options(struct e1000_adapter *adapter)
536{
537	struct e1000_option opt;
538	unsigned int speed, dplx, an;
539	int bd = adapter->bd_number;
540
541	{ /* Speed */
542		static const struct e1000_opt_list speed_list[] = {
543			{          0, "" },
544			{   SPEED_10, "" },
545			{  SPEED_100, "" },
546			{ SPEED_1000, "" }};
547
548		opt = (struct e1000_option) {
549			.type = list_option,
550			.name = "Speed",
551			.err  = "parameter ignored",
552			.def  = 0,
553			.arg  = { .l = { .nr = ARRAY_SIZE(speed_list),
554					 .p = speed_list }}
555		};
556
557		if (num_Speed > bd) {
558			speed = Speed[bd];
559			e1000_validate_option(&speed, &opt, adapter);
560		} else {
561			speed = opt.def;
562		}
563	}
564	{ /* Duplex */
565		static const struct e1000_opt_list dplx_list[] = {
566			{           0, "" },
567			{ HALF_DUPLEX, "" },
568			{ FULL_DUPLEX, "" }};
569
570		opt = (struct e1000_option) {
571			.type = list_option,
572			.name = "Duplex",
573			.err  = "parameter ignored",
574			.def  = 0,
575			.arg  = { .l = { .nr = ARRAY_SIZE(dplx_list),
576					 .p = dplx_list }}
577		};
578
579		if (num_Duplex > bd) {
580			dplx = Duplex[bd];
581			e1000_validate_option(&dplx, &opt, adapter);
582		} else {
583			dplx = opt.def;
584		}
585	}
586
587	if ((num_AutoNeg > bd) && (speed != 0 || dplx != 0)) {
588		e_dev_info("AutoNeg specified along with Speed or Duplex, "
589			   "parameter ignored\n");
590		adapter->hw.autoneg_advertised = AUTONEG_ADV_DEFAULT;
591	} else { /* Autoneg */
592		static const struct e1000_opt_list an_list[] =
593			#define AA "AutoNeg advertising "
594			{{ 0x01, AA "10/HD" },
595			 { 0x02, AA "10/FD" },
596			 { 0x03, AA "10/FD, 10/HD" },
597			 { 0x04, AA "100/HD" },
598			 { 0x05, AA "100/HD, 10/HD" },
599			 { 0x06, AA "100/HD, 10/FD" },
600			 { 0x07, AA "100/HD, 10/FD, 10/HD" },
601			 { 0x08, AA "100/FD" },
602			 { 0x09, AA "100/FD, 10/HD" },
603			 { 0x0a, AA "100/FD, 10/FD" },
604			 { 0x0b, AA "100/FD, 10/FD, 10/HD" },
605			 { 0x0c, AA "100/FD, 100/HD" },
606			 { 0x0d, AA "100/FD, 100/HD, 10/HD" },
607			 { 0x0e, AA "100/FD, 100/HD, 10/FD" },
608			 { 0x0f, AA "100/FD, 100/HD, 10/FD, 10/HD" },
609			 { 0x20, AA "1000/FD" },
610			 { 0x21, AA "1000/FD, 10/HD" },
611			 { 0x22, AA "1000/FD, 10/FD" },
612			 { 0x23, AA "1000/FD, 10/FD, 10/HD" },
613			 { 0x24, AA "1000/FD, 100/HD" },
614			 { 0x25, AA "1000/FD, 100/HD, 10/HD" },
615			 { 0x26, AA "1000/FD, 100/HD, 10/FD" },
616			 { 0x27, AA "1000/FD, 100/HD, 10/FD, 10/HD" },
617			 { 0x28, AA "1000/FD, 100/FD" },
618			 { 0x29, AA "1000/FD, 100/FD, 10/HD" },
619			 { 0x2a, AA "1000/FD, 100/FD, 10/FD" },
620			 { 0x2b, AA "1000/FD, 100/FD, 10/FD, 10/HD" },
621			 { 0x2c, AA "1000/FD, 100/FD, 100/HD" },
622			 { 0x2d, AA "1000/FD, 100/FD, 100/HD, 10/HD" },
623			 { 0x2e, AA "1000/FD, 100/FD, 100/HD, 10/FD" },
624			 { 0x2f, AA "1000/FD, 100/FD, 100/HD, 10/FD, 10/HD" }};
625
626		opt = (struct e1000_option) {
627			.type = list_option,
628			.name = "AutoNeg",
629			.err  = "parameter ignored",
630			.def  = AUTONEG_ADV_DEFAULT,
631			.arg  = { .l = { .nr = ARRAY_SIZE(an_list),
632					 .p = an_list }}
633		};
634
635		if (num_AutoNeg > bd) {
636			an = AutoNeg[bd];
637			e1000_validate_option(&an, &opt, adapter);
638		} else {
639			an = opt.def;
640		}
641		adapter->hw.autoneg_advertised = an;
642	}
643
644	switch (speed + dplx) {
645	case 0:
646		adapter->hw.autoneg = adapter->fc_autoneg = 1;
647		if ((num_Speed > bd) && (speed != 0 || dplx != 0))
648			e_dev_info("Speed and duplex autonegotiation "
649				   "enabled\n");
650		break;
651	case HALF_DUPLEX:
652		e_dev_info("Half Duplex specified without Speed\n");
653		e_dev_info("Using Autonegotiation at Half Duplex only\n");
654		adapter->hw.autoneg = adapter->fc_autoneg = 1;
655		adapter->hw.autoneg_advertised = ADVERTISE_10_HALF |
656						 ADVERTISE_100_HALF;
657		break;
658	case FULL_DUPLEX:
659		e_dev_info("Full Duplex specified without Speed\n");
660		e_dev_info("Using Autonegotiation at Full Duplex only\n");
661		adapter->hw.autoneg = adapter->fc_autoneg = 1;
662		adapter->hw.autoneg_advertised = ADVERTISE_10_FULL |
663						 ADVERTISE_100_FULL |
664						 ADVERTISE_1000_FULL;
665		break;
666	case SPEED_10:
667		e_dev_info("10 Mbps Speed specified without Duplex\n");
668		e_dev_info("Using Autonegotiation at 10 Mbps only\n");
669		adapter->hw.autoneg = adapter->fc_autoneg = 1;
670		adapter->hw.autoneg_advertised = ADVERTISE_10_HALF |
671						 ADVERTISE_10_FULL;
672		break;
673	case SPEED_10 + HALF_DUPLEX:
674		e_dev_info("Forcing to 10 Mbps Half Duplex\n");
675		adapter->hw.autoneg = adapter->fc_autoneg = 0;
676		adapter->hw.forced_speed_duplex = e1000_10_half;
677		adapter->hw.autoneg_advertised = 0;
678		break;
679	case SPEED_10 + FULL_DUPLEX:
680		e_dev_info("Forcing to 10 Mbps Full Duplex\n");
681		adapter->hw.autoneg = adapter->fc_autoneg = 0;
682		adapter->hw.forced_speed_duplex = e1000_10_full;
683		adapter->hw.autoneg_advertised = 0;
684		break;
685	case SPEED_100:
686		e_dev_info("100 Mbps Speed specified without Duplex\n");
687		e_dev_info("Using Autonegotiation at 100 Mbps only\n");
688		adapter->hw.autoneg = adapter->fc_autoneg = 1;
689		adapter->hw.autoneg_advertised = ADVERTISE_100_HALF |
690						 ADVERTISE_100_FULL;
691		break;
692	case SPEED_100 + HALF_DUPLEX:
693		e_dev_info("Forcing to 100 Mbps Half Duplex\n");
694		adapter->hw.autoneg = adapter->fc_autoneg = 0;
695		adapter->hw.forced_speed_duplex = e1000_100_half;
696		adapter->hw.autoneg_advertised = 0;
697		break;
698	case SPEED_100 + FULL_DUPLEX:
699		e_dev_info("Forcing to 100 Mbps Full Duplex\n");
700		adapter->hw.autoneg = adapter->fc_autoneg = 0;
701		adapter->hw.forced_speed_duplex = e1000_100_full;
702		adapter->hw.autoneg_advertised = 0;
703		break;
704	case SPEED_1000:
705		e_dev_info("1000 Mbps Speed specified without Duplex\n");
706		goto full_duplex_only;
707	case SPEED_1000 + HALF_DUPLEX:
708		e_dev_info("Half Duplex is not supported at 1000 Mbps\n");
709		fallthrough;
710	case SPEED_1000 + FULL_DUPLEX:
711full_duplex_only:
712		e_dev_info("Using Autonegotiation at 1000 Mbps Full Duplex "
713			   "only\n");
714		adapter->hw.autoneg = adapter->fc_autoneg = 1;
715		adapter->hw.autoneg_advertised = ADVERTISE_1000_FULL;
716		break;
717	default:
718		BUG();
719	}
720
721	/* Speed, AutoNeg and MDI/MDI-X must all play nice */
722	if (e1000_validate_mdi_setting(&(adapter->hw)) < 0) {
723		e_dev_info("Speed, AutoNeg and MDI-X specs are incompatible. "
724			   "Setting MDI-X to a compatible value.\n");
725	}
726}
727
v4.17
  1// SPDX-License-Identifier: GPL-2.0
  2/*******************************************************************************
  3
  4  Intel PRO/1000 Linux driver
  5  Copyright(c) 1999 - 2006 Intel Corporation.
  6
  7  This program is free software; you can redistribute it and/or modify it
  8  under the terms and conditions of the GNU General Public License,
  9  version 2, as published by the Free Software Foundation.
 10
 11  This program is distributed in the hope it will be useful, but WITHOUT
 12  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 13  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 14  more details.
 15
 16  You should have received a copy of the GNU General Public License along with
 17  this program; if not, write to the Free Software Foundation, Inc.,
 18  51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
 19
 20  The full GNU General Public License is included in this distribution in
 21  the file called "COPYING".
 22
 23  Contact Information:
 24  Linux NICS <linux.nics@intel.com>
 25  e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
 26  Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 27
 28*******************************************************************************/
 29
 30#include "e1000.h"
 31
 32/* This is the only thing that needs to be changed to adjust the
 33 * maximum number of ports that the driver can manage.
 34 */
 35
 36#define E1000_MAX_NIC 32
 37
 38#define OPTION_UNSET   -1
 39#define OPTION_DISABLED 0
 40#define OPTION_ENABLED  1
 41
 42/* All parameters are treated the same, as an integer array of values.
 43 * This macro just reduces the need to repeat the same declaration code
 44 * over and over (plus this helps to avoid typo bugs).
 45 */
 46
 47#define E1000_PARAM_INIT { [0 ... E1000_MAX_NIC] = OPTION_UNSET }
 48#define E1000_PARAM(X, desc) \
 49	static int X[E1000_MAX_NIC+1] = E1000_PARAM_INIT; \
 50	static unsigned int num_##X; \
 51	module_param_array_named(X, X, int, &num_##X, 0); \
 52	MODULE_PARM_DESC(X, desc);
 53
 54/* Transmit Descriptor Count
 55 *
 56 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers
 57 * Valid Range: 80-4096 for 82544 and newer
 58 *
 59 * Default Value: 256
 60 */
 61E1000_PARAM(TxDescriptors, "Number of transmit descriptors");
 62
 63/* Receive Descriptor Count
 64 *
 65 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers
 66 * Valid Range: 80-4096 for 82544 and newer
 67 *
 68 * Default Value: 256
 69 */
 70E1000_PARAM(RxDescriptors, "Number of receive descriptors");
 71
 72/* User Specified Speed Override
 73 *
 74 * Valid Range: 0, 10, 100, 1000
 75 *  - 0    - auto-negotiate at all supported speeds
 76 *  - 10   - only link at 10 Mbps
 77 *  - 100  - only link at 100 Mbps
 78 *  - 1000 - only link at 1000 Mbps
 79 *
 80 * Default Value: 0
 81 */
 82E1000_PARAM(Speed, "Speed setting");
 83
 84/* User Specified Duplex Override
 85 *
 86 * Valid Range: 0-2
 87 *  - 0 - auto-negotiate for duplex
 88 *  - 1 - only link at half duplex
 89 *  - 2 - only link at full duplex
 90 *
 91 * Default Value: 0
 92 */
 93E1000_PARAM(Duplex, "Duplex setting");
 94
 95/* Auto-negotiation Advertisement Override
 96 *
 97 * Valid Range: 0x01-0x0F, 0x20-0x2F (copper); 0x20 (fiber)
 98 *
 99 * The AutoNeg value is a bit mask describing which speed and duplex
100 * combinations should be advertised during auto-negotiation.
101 * The supported speed and duplex modes are listed below
102 *
103 * Bit           7     6     5      4      3     2     1      0
104 * Speed (Mbps)  N/A   N/A   1000   N/A    100   100   10     10
105 * Duplex                    Full          Full  Half  Full   Half
106 *
107 * Default Value: 0x2F (copper); 0x20 (fiber)
108 */
109E1000_PARAM(AutoNeg, "Advertised auto-negotiation setting");
110#define AUTONEG_ADV_DEFAULT  0x2F
111#define AUTONEG_ADV_MASK     0x2F
112
113/* User Specified Flow Control Override
114 *
115 * Valid Range: 0-3
116 *  - 0 - No Flow Control
117 *  - 1 - Rx only, respond to PAUSE frames but do not generate them
118 *  - 2 - Tx only, generate PAUSE frames but ignore them on receive
119 *  - 3 - Full Flow Control Support
120 *
121 * Default Value: Read flow control settings from the EEPROM
122 */
123E1000_PARAM(FlowControl, "Flow Control setting");
124#define FLOW_CONTROL_DEFAULT FLOW_CONTROL_FULL
125
126/* XsumRX - Receive Checksum Offload Enable/Disable
127 *
128 * Valid Range: 0, 1
129 *  - 0 - disables all checksum offload
130 *  - 1 - enables receive IP/TCP/UDP checksum offload
131 *        on 82543 and newer -based NICs
132 *
133 * Default Value: 1
134 */
135E1000_PARAM(XsumRX, "Disable or enable Receive Checksum offload");
136
137/* Transmit Interrupt Delay in units of 1.024 microseconds
138 *  Tx interrupt delay needs to typically be set to something non zero
139 *
140 * Valid Range: 0-65535
141 */
142E1000_PARAM(TxIntDelay, "Transmit Interrupt Delay");
143#define DEFAULT_TIDV                   8
144#define MAX_TXDELAY               0xFFFF
145#define MIN_TXDELAY                    0
146
147/* Transmit Absolute Interrupt Delay in units of 1.024 microseconds
148 *
149 * Valid Range: 0-65535
150 */
151E1000_PARAM(TxAbsIntDelay, "Transmit Absolute Interrupt Delay");
152#define DEFAULT_TADV                  32
153#define MAX_TXABSDELAY            0xFFFF
154#define MIN_TXABSDELAY                 0
155
156/* Receive Interrupt Delay in units of 1.024 microseconds
157 *   hardware will likely hang if you set this to anything but zero.
158 *
159 * Valid Range: 0-65535
160 */
161E1000_PARAM(RxIntDelay, "Receive Interrupt Delay");
162#define DEFAULT_RDTR                   0
163#define MAX_RXDELAY               0xFFFF
164#define MIN_RXDELAY                    0
165
166/* Receive Absolute Interrupt Delay in units of 1.024 microseconds
167 *
168 * Valid Range: 0-65535
169 */
170E1000_PARAM(RxAbsIntDelay, "Receive Absolute Interrupt Delay");
171#define DEFAULT_RADV                   8
172#define MAX_RXABSDELAY            0xFFFF
173#define MIN_RXABSDELAY                 0
174
175/* Interrupt Throttle Rate (interrupts/sec)
176 *
177 * Valid Range: 100-100000 (0=off, 1=dynamic, 3=dynamic conservative)
178 */
179E1000_PARAM(InterruptThrottleRate, "Interrupt Throttling Rate");
180#define DEFAULT_ITR                    3
181#define MAX_ITR                   100000
182#define MIN_ITR                      100
183
184/* Enable Smart Power Down of the PHY
185 *
186 * Valid Range: 0, 1
187 *
188 * Default Value: 0 (disabled)
189 */
190E1000_PARAM(SmartPowerDownEnable, "Enable PHY smart power down");
191
192struct e1000_option {
193	enum { enable_option, range_option, list_option } type;
194	const char *name;
195	const char *err;
196	int def;
197	union {
198		struct { /* range_option info */
199			int min;
200			int max;
201		} r;
202		struct { /* list_option info */
203			int nr;
204			const struct e1000_opt_list { int i; char *str; } *p;
205		} l;
206	} arg;
207};
208
209static int e1000_validate_option(unsigned int *value,
210				 const struct e1000_option *opt,
211				 struct e1000_adapter *adapter)
212{
213	if (*value == OPTION_UNSET) {
214		*value = opt->def;
215		return 0;
216	}
217
218	switch (opt->type) {
219	case enable_option:
220		switch (*value) {
221		case OPTION_ENABLED:
222			e_dev_info("%s Enabled\n", opt->name);
223			return 0;
224		case OPTION_DISABLED:
225			e_dev_info("%s Disabled\n", opt->name);
226			return 0;
227		}
228		break;
229	case range_option:
230		if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) {
231			e_dev_info("%s set to %i\n", opt->name, *value);
232			return 0;
233		}
234		break;
235	case list_option: {
236		int i;
237		const struct e1000_opt_list *ent;
238
239		for (i = 0; i < opt->arg.l.nr; i++) {
240			ent = &opt->arg.l.p[i];
241			if (*value == ent->i) {
242				if (ent->str[0] != '\0')
243					e_dev_info("%s\n", ent->str);
244				return 0;
245			}
246		}
247	}
248		break;
249	default:
250		BUG();
251	}
252
253	e_dev_info("Invalid %s value specified (%i) %s\n",
254	       opt->name, *value, opt->err);
255	*value = opt->def;
256	return -1;
257}
258
259static void e1000_check_fiber_options(struct e1000_adapter *adapter);
260static void e1000_check_copper_options(struct e1000_adapter *adapter);
261
262/**
263 * e1000_check_options - Range Checking for Command Line Parameters
264 * @adapter: board private structure
265 *
266 * This routine checks all command line parameters for valid user
267 * input.  If an invalid value is given, or if no user specified
268 * value exists, a default value is used.  The final value is stored
269 * in a variable in the adapter structure.
270 **/
271void e1000_check_options(struct e1000_adapter *adapter)
272{
273	struct e1000_option opt;
274	int bd = adapter->bd_number;
275
276	if (bd >= E1000_MAX_NIC) {
277		e_dev_warn("Warning: no configuration for board #%i "
278			   "using defaults for all values\n", bd);
279	}
280
281	{ /* Transmit Descriptor Count */
282		struct e1000_tx_ring *tx_ring = adapter->tx_ring;
283		int i;
284		e1000_mac_type mac_type = adapter->hw.mac_type;
285
286		opt = (struct e1000_option) {
287			.type = range_option,
288			.name = "Transmit Descriptors",
289			.err  = "using default of "
290				__MODULE_STRING(E1000_DEFAULT_TXD),
291			.def  = E1000_DEFAULT_TXD,
292			.arg  = { .r = {
293				.min = E1000_MIN_TXD,
294				.max = mac_type < e1000_82544 ? E1000_MAX_TXD : E1000_MAX_82544_TXD
295				}}
296		};
297
298		if (num_TxDescriptors > bd) {
299			tx_ring->count = TxDescriptors[bd];
300			e1000_validate_option(&tx_ring->count, &opt, adapter);
301			tx_ring->count = ALIGN(tx_ring->count,
302						REQ_TX_DESCRIPTOR_MULTIPLE);
303		} else {
304			tx_ring->count = opt.def;
305		}
306		for (i = 0; i < adapter->num_tx_queues; i++)
307			tx_ring[i].count = tx_ring->count;
308	}
309	{ /* Receive Descriptor Count */
310		struct e1000_rx_ring *rx_ring = adapter->rx_ring;
311		int i;
312		e1000_mac_type mac_type = adapter->hw.mac_type;
313
314		opt = (struct e1000_option) {
315			.type = range_option,
316			.name = "Receive Descriptors",
317			.err  = "using default of "
318				__MODULE_STRING(E1000_DEFAULT_RXD),
319			.def  = E1000_DEFAULT_RXD,
320			.arg  = { .r = {
321				.min = E1000_MIN_RXD,
322				.max = mac_type < e1000_82544 ? E1000_MAX_RXD :
323				       E1000_MAX_82544_RXD
324			}}
325		};
326
327		if (num_RxDescriptors > bd) {
328			rx_ring->count = RxDescriptors[bd];
329			e1000_validate_option(&rx_ring->count, &opt, adapter);
330			rx_ring->count = ALIGN(rx_ring->count,
331						REQ_RX_DESCRIPTOR_MULTIPLE);
332		} else {
333			rx_ring->count = opt.def;
334		}
335		for (i = 0; i < adapter->num_rx_queues; i++)
336			rx_ring[i].count = rx_ring->count;
337	}
338	{ /* Checksum Offload Enable/Disable */
339		opt = (struct e1000_option) {
340			.type = enable_option,
341			.name = "Checksum Offload",
342			.err  = "defaulting to Enabled",
343			.def  = OPTION_ENABLED
344		};
345
346		if (num_XsumRX > bd) {
347			unsigned int rx_csum = XsumRX[bd];
348			e1000_validate_option(&rx_csum, &opt, adapter);
349			adapter->rx_csum = rx_csum;
350		} else {
351			adapter->rx_csum = opt.def;
352		}
353	}
354	{ /* Flow Control */
355
356		static const struct e1000_opt_list fc_list[] = {
357		       { E1000_FC_NONE, "Flow Control Disabled" },
358		       { E1000_FC_RX_PAUSE, "Flow Control Receive Only" },
359		       { E1000_FC_TX_PAUSE, "Flow Control Transmit Only" },
360		       { E1000_FC_FULL, "Flow Control Enabled" },
361		       { E1000_FC_DEFAULT, "Flow Control Hardware Default" }
362		};
363
364		opt = (struct e1000_option) {
365			.type = list_option,
366			.name = "Flow Control",
367			.err  = "reading default settings from EEPROM",
368			.def  = E1000_FC_DEFAULT,
369			.arg  = { .l = { .nr = ARRAY_SIZE(fc_list),
370					 .p = fc_list }}
371		};
372
373		if (num_FlowControl > bd) {
374			unsigned int fc = FlowControl[bd];
375			e1000_validate_option(&fc, &opt, adapter);
376			adapter->hw.fc = adapter->hw.original_fc = fc;
377		} else {
378			adapter->hw.fc = adapter->hw.original_fc = opt.def;
379		}
380	}
381	{ /* Transmit Interrupt Delay */
382		opt = (struct e1000_option) {
383			.type = range_option,
384			.name = "Transmit Interrupt Delay",
385			.err  = "using default of " __MODULE_STRING(DEFAULT_TIDV),
386			.def  = DEFAULT_TIDV,
387			.arg  = { .r = { .min = MIN_TXDELAY,
388					 .max = MAX_TXDELAY }}
389		};
390
391		if (num_TxIntDelay > bd) {
392			adapter->tx_int_delay = TxIntDelay[bd];
393			e1000_validate_option(&adapter->tx_int_delay, &opt,
394			                      adapter);
395		} else {
396			adapter->tx_int_delay = opt.def;
397		}
398	}
399	{ /* Transmit Absolute Interrupt Delay */
400		opt = (struct e1000_option) {
401			.type = range_option,
402			.name = "Transmit Absolute Interrupt Delay",
403			.err  = "using default of " __MODULE_STRING(DEFAULT_TADV),
404			.def  = DEFAULT_TADV,
405			.arg  = { .r = { .min = MIN_TXABSDELAY,
406					 .max = MAX_TXABSDELAY }}
407		};
408
409		if (num_TxAbsIntDelay > bd) {
410			adapter->tx_abs_int_delay = TxAbsIntDelay[bd];
411			e1000_validate_option(&adapter->tx_abs_int_delay, &opt,
412					      adapter);
413		} else {
414			adapter->tx_abs_int_delay = opt.def;
415		}
416	}
417	{ /* Receive Interrupt Delay */
418		opt = (struct e1000_option) {
419			.type = range_option,
420			.name = "Receive Interrupt Delay",
421			.err  = "using default of " __MODULE_STRING(DEFAULT_RDTR),
422			.def  = DEFAULT_RDTR,
423			.arg  = { .r = { .min = MIN_RXDELAY,
424					 .max = MAX_RXDELAY }}
425		};
426
427		if (num_RxIntDelay > bd) {
428			adapter->rx_int_delay = RxIntDelay[bd];
429			e1000_validate_option(&adapter->rx_int_delay, &opt,
430					      adapter);
431		} else {
432			adapter->rx_int_delay = opt.def;
433		}
434	}
435	{ /* Receive Absolute Interrupt Delay */
436		opt = (struct e1000_option) {
437			.type = range_option,
438			.name = "Receive Absolute Interrupt Delay",
439			.err  = "using default of " __MODULE_STRING(DEFAULT_RADV),
440			.def  = DEFAULT_RADV,
441			.arg  = { .r = { .min = MIN_RXABSDELAY,
442					 .max = MAX_RXABSDELAY }}
443		};
444
445		if (num_RxAbsIntDelay > bd) {
446			adapter->rx_abs_int_delay = RxAbsIntDelay[bd];
447			e1000_validate_option(&adapter->rx_abs_int_delay, &opt,
448					      adapter);
449		} else {
450			adapter->rx_abs_int_delay = opt.def;
451		}
452	}
453	{ /* Interrupt Throttling Rate */
454		opt = (struct e1000_option) {
455			.type = range_option,
456			.name = "Interrupt Throttling Rate (ints/sec)",
457			.err  = "using default of " __MODULE_STRING(DEFAULT_ITR),
458			.def  = DEFAULT_ITR,
459			.arg  = { .r = { .min = MIN_ITR,
460					 .max = MAX_ITR }}
461		};
462
463		if (num_InterruptThrottleRate > bd) {
464			adapter->itr = InterruptThrottleRate[bd];
465			switch (adapter->itr) {
466			case 0:
467				e_dev_info("%s turned off\n", opt.name);
468				break;
469			case 1:
470				e_dev_info("%s set to dynamic mode\n",
471					   opt.name);
472				adapter->itr_setting = adapter->itr;
473				adapter->itr = 20000;
474				break;
475			case 3:
476				e_dev_info("%s set to dynamic conservative "
477					   "mode\n", opt.name);
478				adapter->itr_setting = adapter->itr;
479				adapter->itr = 20000;
480				break;
481			case 4:
482				e_dev_info("%s set to simplified "
483					   "(2000-8000) ints mode\n", opt.name);
484				adapter->itr_setting = adapter->itr;
485				break;
486			default:
487				e1000_validate_option(&adapter->itr, &opt,
488						      adapter);
489				/* save the setting, because the dynamic bits
490				 * change itr.
491				 * clear the lower two bits because they are
492				 * used as control
493				 */
494				adapter->itr_setting = adapter->itr & ~3;
495				break;
496			}
497		} else {
498			adapter->itr_setting = opt.def;
499			adapter->itr = 20000;
500		}
501	}
502	{ /* Smart Power Down */
503		opt = (struct e1000_option) {
504			.type = enable_option,
505			.name = "PHY Smart Power Down",
506			.err  = "defaulting to Disabled",
507			.def  = OPTION_DISABLED
508		};
509
510		if (num_SmartPowerDownEnable > bd) {
511			unsigned int spd = SmartPowerDownEnable[bd];
512			e1000_validate_option(&spd, &opt, adapter);
513			adapter->smart_power_down = spd;
514		} else {
515			adapter->smart_power_down = opt.def;
516		}
517	}
518
519	switch (adapter->hw.media_type) {
520	case e1000_media_type_fiber:
521	case e1000_media_type_internal_serdes:
522		e1000_check_fiber_options(adapter);
523		break;
524	case e1000_media_type_copper:
525		e1000_check_copper_options(adapter);
526		break;
527	default:
528		BUG();
529	}
530}
531
532/**
533 * e1000_check_fiber_options - Range Checking for Link Options, Fiber Version
534 * @adapter: board private structure
535 *
536 * Handles speed and duplex options on fiber adapters
537 **/
538static void e1000_check_fiber_options(struct e1000_adapter *adapter)
539{
540	int bd = adapter->bd_number;
541	if (num_Speed > bd) {
542		e_dev_info("Speed not valid for fiber adapters, parameter "
543			   "ignored\n");
544	}
545
546	if (num_Duplex > bd) {
547		e_dev_info("Duplex not valid for fiber adapters, parameter "
548			   "ignored\n");
549	}
550
551	if ((num_AutoNeg > bd) && (AutoNeg[bd] != 0x20)) {
552		e_dev_info("AutoNeg other than 1000/Full is not valid for fiber"
553			   "adapters, parameter ignored\n");
554	}
555}
556
557/**
558 * e1000_check_copper_options - Range Checking for Link Options, Copper Version
559 * @adapter: board private structure
560 *
561 * Handles speed and duplex options on copper adapters
562 **/
563static void e1000_check_copper_options(struct e1000_adapter *adapter)
564{
565	struct e1000_option opt;
566	unsigned int speed, dplx, an;
567	int bd = adapter->bd_number;
568
569	{ /* Speed */
570		static const struct e1000_opt_list speed_list[] = {
571			{          0, "" },
572			{   SPEED_10, "" },
573			{  SPEED_100, "" },
574			{ SPEED_1000, "" }};
575
576		opt = (struct e1000_option) {
577			.type = list_option,
578			.name = "Speed",
579			.err  = "parameter ignored",
580			.def  = 0,
581			.arg  = { .l = { .nr = ARRAY_SIZE(speed_list),
582					 .p = speed_list }}
583		};
584
585		if (num_Speed > bd) {
586			speed = Speed[bd];
587			e1000_validate_option(&speed, &opt, adapter);
588		} else {
589			speed = opt.def;
590		}
591	}
592	{ /* Duplex */
593		static const struct e1000_opt_list dplx_list[] = {
594			{           0, "" },
595			{ HALF_DUPLEX, "" },
596			{ FULL_DUPLEX, "" }};
597
598		opt = (struct e1000_option) {
599			.type = list_option,
600			.name = "Duplex",
601			.err  = "parameter ignored",
602			.def  = 0,
603			.arg  = { .l = { .nr = ARRAY_SIZE(dplx_list),
604					 .p = dplx_list }}
605		};
606
607		if (num_Duplex > bd) {
608			dplx = Duplex[bd];
609			e1000_validate_option(&dplx, &opt, adapter);
610		} else {
611			dplx = opt.def;
612		}
613	}
614
615	if ((num_AutoNeg > bd) && (speed != 0 || dplx != 0)) {
616		e_dev_info("AutoNeg specified along with Speed or Duplex, "
617			   "parameter ignored\n");
618		adapter->hw.autoneg_advertised = AUTONEG_ADV_DEFAULT;
619	} else { /* Autoneg */
620		static const struct e1000_opt_list an_list[] =
621			#define AA "AutoNeg advertising "
622			{{ 0x01, AA "10/HD" },
623			 { 0x02, AA "10/FD" },
624			 { 0x03, AA "10/FD, 10/HD" },
625			 { 0x04, AA "100/HD" },
626			 { 0x05, AA "100/HD, 10/HD" },
627			 { 0x06, AA "100/HD, 10/FD" },
628			 { 0x07, AA "100/HD, 10/FD, 10/HD" },
629			 { 0x08, AA "100/FD" },
630			 { 0x09, AA "100/FD, 10/HD" },
631			 { 0x0a, AA "100/FD, 10/FD" },
632			 { 0x0b, AA "100/FD, 10/FD, 10/HD" },
633			 { 0x0c, AA "100/FD, 100/HD" },
634			 { 0x0d, AA "100/FD, 100/HD, 10/HD" },
635			 { 0x0e, AA "100/FD, 100/HD, 10/FD" },
636			 { 0x0f, AA "100/FD, 100/HD, 10/FD, 10/HD" },
637			 { 0x20, AA "1000/FD" },
638			 { 0x21, AA "1000/FD, 10/HD" },
639			 { 0x22, AA "1000/FD, 10/FD" },
640			 { 0x23, AA "1000/FD, 10/FD, 10/HD" },
641			 { 0x24, AA "1000/FD, 100/HD" },
642			 { 0x25, AA "1000/FD, 100/HD, 10/HD" },
643			 { 0x26, AA "1000/FD, 100/HD, 10/FD" },
644			 { 0x27, AA "1000/FD, 100/HD, 10/FD, 10/HD" },
645			 { 0x28, AA "1000/FD, 100/FD" },
646			 { 0x29, AA "1000/FD, 100/FD, 10/HD" },
647			 { 0x2a, AA "1000/FD, 100/FD, 10/FD" },
648			 { 0x2b, AA "1000/FD, 100/FD, 10/FD, 10/HD" },
649			 { 0x2c, AA "1000/FD, 100/FD, 100/HD" },
650			 { 0x2d, AA "1000/FD, 100/FD, 100/HD, 10/HD" },
651			 { 0x2e, AA "1000/FD, 100/FD, 100/HD, 10/FD" },
652			 { 0x2f, AA "1000/FD, 100/FD, 100/HD, 10/FD, 10/HD" }};
653
654		opt = (struct e1000_option) {
655			.type = list_option,
656			.name = "AutoNeg",
657			.err  = "parameter ignored",
658			.def  = AUTONEG_ADV_DEFAULT,
659			.arg  = { .l = { .nr = ARRAY_SIZE(an_list),
660					 .p = an_list }}
661		};
662
663		if (num_AutoNeg > bd) {
664			an = AutoNeg[bd];
665			e1000_validate_option(&an, &opt, adapter);
666		} else {
667			an = opt.def;
668		}
669		adapter->hw.autoneg_advertised = an;
670	}
671
672	switch (speed + dplx) {
673	case 0:
674		adapter->hw.autoneg = adapter->fc_autoneg = 1;
675		if ((num_Speed > bd) && (speed != 0 || dplx != 0))
676			e_dev_info("Speed and duplex autonegotiation "
677				   "enabled\n");
678		break;
679	case HALF_DUPLEX:
680		e_dev_info("Half Duplex specified without Speed\n");
681		e_dev_info("Using Autonegotiation at Half Duplex only\n");
682		adapter->hw.autoneg = adapter->fc_autoneg = 1;
683		adapter->hw.autoneg_advertised = ADVERTISE_10_HALF |
684						 ADVERTISE_100_HALF;
685		break;
686	case FULL_DUPLEX:
687		e_dev_info("Full Duplex specified without Speed\n");
688		e_dev_info("Using Autonegotiation at Full Duplex only\n");
689		adapter->hw.autoneg = adapter->fc_autoneg = 1;
690		adapter->hw.autoneg_advertised = ADVERTISE_10_FULL |
691						 ADVERTISE_100_FULL |
692						 ADVERTISE_1000_FULL;
693		break;
694	case SPEED_10:
695		e_dev_info("10 Mbps Speed specified without Duplex\n");
696		e_dev_info("Using Autonegotiation at 10 Mbps only\n");
697		adapter->hw.autoneg = adapter->fc_autoneg = 1;
698		adapter->hw.autoneg_advertised = ADVERTISE_10_HALF |
699						 ADVERTISE_10_FULL;
700		break;
701	case SPEED_10 + HALF_DUPLEX:
702		e_dev_info("Forcing to 10 Mbps Half Duplex\n");
703		adapter->hw.autoneg = adapter->fc_autoneg = 0;
704		adapter->hw.forced_speed_duplex = e1000_10_half;
705		adapter->hw.autoneg_advertised = 0;
706		break;
707	case SPEED_10 + FULL_DUPLEX:
708		e_dev_info("Forcing to 10 Mbps Full Duplex\n");
709		adapter->hw.autoneg = adapter->fc_autoneg = 0;
710		adapter->hw.forced_speed_duplex = e1000_10_full;
711		adapter->hw.autoneg_advertised = 0;
712		break;
713	case SPEED_100:
714		e_dev_info("100 Mbps Speed specified without Duplex\n");
715		e_dev_info("Using Autonegotiation at 100 Mbps only\n");
716		adapter->hw.autoneg = adapter->fc_autoneg = 1;
717		adapter->hw.autoneg_advertised = ADVERTISE_100_HALF |
718						 ADVERTISE_100_FULL;
719		break;
720	case SPEED_100 + HALF_DUPLEX:
721		e_dev_info("Forcing to 100 Mbps Half Duplex\n");
722		adapter->hw.autoneg = adapter->fc_autoneg = 0;
723		adapter->hw.forced_speed_duplex = e1000_100_half;
724		adapter->hw.autoneg_advertised = 0;
725		break;
726	case SPEED_100 + FULL_DUPLEX:
727		e_dev_info("Forcing to 100 Mbps Full Duplex\n");
728		adapter->hw.autoneg = adapter->fc_autoneg = 0;
729		adapter->hw.forced_speed_duplex = e1000_100_full;
730		adapter->hw.autoneg_advertised = 0;
731		break;
732	case SPEED_1000:
733		e_dev_info("1000 Mbps Speed specified without Duplex\n");
734		goto full_duplex_only;
735	case SPEED_1000 + HALF_DUPLEX:
736		e_dev_info("Half Duplex is not supported at 1000 Mbps\n");
737		/* fall through */
738	case SPEED_1000 + FULL_DUPLEX:
739full_duplex_only:
740		e_dev_info("Using Autonegotiation at 1000 Mbps Full Duplex "
741			   "only\n");
742		adapter->hw.autoneg = adapter->fc_autoneg = 1;
743		adapter->hw.autoneg_advertised = ADVERTISE_1000_FULL;
744		break;
745	default:
746		BUG();
747	}
748
749	/* Speed, AutoNeg and MDI/MDI-X must all play nice */
750	if (e1000_validate_mdi_setting(&(adapter->hw)) < 0) {
751		e_dev_info("Speed, AutoNeg and MDI-X specs are incompatible. "
752			   "Setting MDI-X to a compatible value.\n");
753	}
754}
755