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

#include "e1000.h"

    30

    31

/* This is the only thing that needs to be changed to adjust the

    32

 * maximum number of ports that the driver can manage.

    33

 */

    34

    35

#define E1000_MAX_NIC 32

    36

    37

#define OPTION_UNSET   -1

    38

#define OPTION_DISABLED 0

    39

#define OPTION_ENABLED  1

    40

    41

/* All parameters are treated the same, as an integer array of values.

    42

 * This macro just reduces the need to repeat the same declaration code

    43

 * over and over (plus this helps to avoid typo bugs).

    44

 */

    45

    46

#define E1000_PARAM_INIT { [0 ... E1000_MAX_NIC] = OPTION_UNSET }

    47

#define E1000_PARAM(X, desc) \

    48

	static int __devinitdata X[E1000_MAX_NIC+1] = E1000_PARAM_INIT; \

    49

	static int num_##X = 0; \

    50

	module_param_array_named(X, X, int, &num_##X, 0); \

    51

	MODULE_PARM_DESC(X, desc);

    52

    53

/* Transmit Descriptor Count

    54

 *

    55

 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers

    56

 * Valid Range: 80-4096 for 82544 and newer

    57

 *

    58

 * Default Value: 256

    59

 */

    60

E1000_PARAM(TxDescriptors, "Number of transmit descriptors");

    61

    62

/* Receive Descriptor Count

    63

 *

    64

 * Valid Range: 80-256 for 82542 and 82543 gigabit ethernet controllers

    65

 * Valid Range: 80-4096 for 82544 and newer

    66

 *

    67

 * Default Value: 256

    68

 */

    69

E1000_PARAM(RxDescriptors, "Number of receive descriptors");

    70

    71

/* User Specified Speed Override

    72

 *

    73

 * Valid Range: 0, 10, 100, 1000

    74

 *  - 0    - auto-negotiate at all supported speeds

    75

 *  - 10   - only link at 10 Mbps

    76

 *  - 100  - only link at 100 Mbps

    77

 *  - 1000 - only link at 1000 Mbps

    78

 *

    79

 * Default Value: 0

    80

 */

    81

E1000_PARAM(Speed, "Speed setting");

    82

    83

/* User Specified Duplex Override

    84

 *

    85

 * Valid Range: 0-2

    86

 *  - 0 - auto-negotiate for duplex

    87

 *  - 1 - only link at half duplex

    88

 *  - 2 - only link at full duplex

    89

 *

    90

 * Default Value: 0

    91

 */

    92

E1000_PARAM(Duplex, "Duplex setting");

    93

    94

/* Auto-negotiation Advertisement Override

    95

 *

    96

 * Valid Range: 0x01-0x0F, 0x20-0x2F (copper); 0x20 (fiber)

    97

 *

    98

 * The AutoNeg value is a bit mask describing which speed and duplex

    99

 * combinations should be advertised during auto-negotiation.

   100

 * The supported speed and duplex modes are listed below

   101

 *

   102

 * Bit           7     6     5      4      3     2     1      0

   103

 * Speed (Mbps)  N/A   N/A   1000   N/A    100   100   10     10

   104

 * Duplex                    Full          Full  Half  Full   Half

   105

 *

   106

 * Default Value: 0x2F (copper); 0x20 (fiber)

   107

 */

   108

E1000_PARAM(AutoNeg, "Advertised auto-negotiation setting");

   109

#define AUTONEG_ADV_DEFAULT  0x2F

   110

#define AUTONEG_ADV_MASK     0x2F

   111

   112

/* User Specified Flow Control Override

   113

 *

   114

 * Valid Range: 0-3

   115

 *  - 0 - No Flow Control

   116

 *  - 1 - Rx only, respond to PAUSE frames but do not generate them

   117

 *  - 2 - Tx only, generate PAUSE frames but ignore them on receive

   118

 *  - 3 - Full Flow Control Support

   119

 *

   120

 * Default Value: Read flow control settings from the EEPROM

   121

 */

   122

E1000_PARAM(FlowControl, "Flow Control setting");

   123

#define FLOW_CONTROL_DEFAULT FLOW_CONTROL_FULL

   124

   125

/* XsumRX - Receive Checksum Offload Enable/Disable

   126

 *

   127

 * Valid Range: 0, 1

   128

 *  - 0 - disables all checksum offload

   129

 *  - 1 - enables receive IP/TCP/UDP checksum offload

   130

 *        on 82543 and newer -based NICs

   131

 *

   132

 * Default Value: 1

   133

 */

   134

E1000_PARAM(XsumRX, "Disable or enable Receive Checksum offload");

   135

   136

/* Transmit Interrupt Delay in units of 1.024 microseconds

   137

 *  Tx interrupt delay needs to typically be set to something non zero

   138

 *

   139

 * Valid Range: 0-65535

   140

 */

   141

E1000_PARAM(TxIntDelay, "Transmit Interrupt Delay");

   142

#define DEFAULT_TIDV                   8

   143

#define MAX_TXDELAY               0xFFFF

   144

#define MIN_TXDELAY                    0

   145

   146

/* Transmit Absolute Interrupt Delay in units of 1.024 microseconds

   147

 *

   148

 * Valid Range: 0-65535

   149

 */

   150

E1000_PARAM(TxAbsIntDelay, "Transmit Absolute Interrupt Delay");

   151

#define DEFAULT_TADV                  32

   152

#define MAX_TXABSDELAY            0xFFFF

   153

#define MIN_TXABSDELAY                 0

   154

   155

/* Receive Interrupt Delay in units of 1.024 microseconds

   156

 *   hardware will likely hang if you set this to anything but zero.

   157

 *

   158

 * Valid Range: 0-65535

   159

 */

   160

E1000_PARAM(RxIntDelay, "Receive Interrupt Delay");

   161

#define DEFAULT_RDTR                   0

   162

#define MAX_RXDELAY               0xFFFF

   163

#define MIN_RXDELAY                    0

   164

   165

/* Receive Absolute Interrupt Delay in units of 1.024 microseconds

   166

 *

   167

 * Valid Range: 0-65535

   168

 */

   169

E1000_PARAM(RxAbsIntDelay, "Receive Absolute Interrupt Delay");

   170

#define DEFAULT_RADV                   8

   171

#define MAX_RXABSDELAY            0xFFFF

   172

#define MIN_RXABSDELAY                 0

   173

   174

/* Interrupt Throttle Rate (interrupts/sec)

   175

 *

   176

 * Valid Range: 100-100000 (0=off, 1=dynamic, 3=dynamic conservative)

   177

 */

   178

E1000_PARAM(InterruptThrottleRate, "Interrupt Throttling Rate");

   179

#define DEFAULT_ITR                    3

   180

#define MAX_ITR                   100000

   181

#define MIN_ITR                      100

   182

   183

/* Enable Smart Power Down of the PHY

   184

 *

   185

 * Valid Range: 0, 1

   186

 *

   187

 * Default Value: 0 (disabled)

   188

 */

   189

E1000_PARAM(SmartPowerDownEnable, "Enable PHY smart power down");

   190

   191

/* Enable Kumeran Lock Loss workaround

   192

 *

   193

 * Valid Range: 0, 1

   194

 *

   195

 * Default Value: 1 (enabled)

   196

 */

   197

E1000_PARAM(KumeranLockLoss, "Enable Kumeran lock loss workaround");

   198

   199

struct e1000_option {

   200

	enum { enable_option, range_option, list_option } type;

   201

	char *name;

   202

	char *err;

   203

	int  def;

   204

	union {

   205

		struct { /* range_option info */

   206

			int min;

   207

			int max;

   208

		} r;

   209

		struct { /* list_option info */

   210

			int nr;

   211

			struct e1000_opt_list { int i; char *str; } *p;

   212

		} l;

   213

	} arg;

   214

};

   215

   216

static int __devinit

   217

e1000_validate_option(int *value, struct e1000_option *opt,

   218

		struct e1000_adapter *adapter)

   219

{

   220

	if (*value == OPTION_UNSET) {

   221

		*value = opt->def;

   222

		return 0;

   223

	}

   224

   225

	switch (opt->type) {

   226

	case enable_option:

   227

		switch (*value) {

   228

		case OPTION_ENABLED:

   229

			DPRINTK(PROBE, INFO, "%s Enabled\n", opt->name);

   230

			return 0;

   231

		case OPTION_DISABLED:

   232

			DPRINTK(PROBE, INFO, "%s Disabled\n", opt->name);

   233

			return 0;

   234

		}

   235

		break;

   236

	case range_option:

   237

		if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) {

   238

			DPRINTK(PROBE, INFO,

   239

					"%s set to %i\n", opt->name, *value);

   240

			return 0;

   241

		}

   242

		break;

   243

	case list_option: {

   244

		int i;

   245

		struct e1000_opt_list *ent;

   246

   247

		for (i = 0; i < opt->arg.l.nr; i++) {

   248

			ent = &opt->arg.l.p[i];

   249

			if (*value == ent->i) {

   250

				if (ent->str[0] != '\0')

   251

					DPRINTK(PROBE, INFO, "%s\n", ent->str);

   252

				return 0;

   253

			}

   254

		}

   255

	}

   256

		break;

   257

	default:

   258

		BUG();

   259

	}

   260

   261

	DPRINTK(PROBE, INFO, "Invalid %s value specified (%i) %s\n",

   262

	       opt->name, *value, opt->err);

   263

	*value = opt->def;

   264

	return -1;

   265

}

   266

   267

static void e1000_check_fiber_options(struct e1000_adapter *adapter);

   268

static void e1000_check_copper_options(struct e1000_adapter *adapter);

   269

   270

/**

   271

 * e1000_check_options - Range Checking for Command Line Parameters

   272

 * @adapter: board private structure

   273

 *

   274

 * This routine checks all command line parameters for valid user

   275

 * input.  If an invalid value is given, or if no user specified

   276

 * value exists, a default value is used.  The final value is stored

   277

 * in a variable in the adapter structure.

   278

 **/

   279

   280

void __devinit

   281

e1000_check_options(struct e1000_adapter *adapter)

   282

{

   283

	int bd = adapter->bd_number;

   284

	if (bd >= E1000_MAX_NIC) {

   285

		DPRINTK(PROBE, NOTICE,

   286

		       "Warning: no configuration for board #%i\n", bd);

   287

		DPRINTK(PROBE, NOTICE, "Using defaults for all values\n");

   288

	}

   289

   290

	{ /* Transmit Descriptor Count */

   291

		struct e1000_option opt = {

   292

			.type = range_option,

   293

			.name = "Transmit Descriptors",

   294

			.err  = "using default of "

   295

				__MODULE_STRING(E1000_DEFAULT_TXD),

   296

			.def  = E1000_DEFAULT_TXD,

   297

			.arg  = { .r = { .min = E1000_MIN_TXD }}

   298

		};

   299

		struct e1000_tx_ring *tx_ring = adapter->tx_ring;

   300

		int i;

   301

		e1000_mac_type mac_type = adapter->hw.mac_type;

   302

		opt.arg.r.max = mac_type < e1000_82544 ?

   303

			E1000_MAX_TXD : E1000_MAX_82544_TXD;

   304

   305

		if (num_TxDescriptors > bd) {

   306

			tx_ring->count = TxDescriptors[bd];

   307

			e1000_validate_option(&tx_ring->count, &opt, adapter);

   308

			tx_ring->count = ALIGN(tx_ring->count,

   309

						REQ_TX_DESCRIPTOR_MULTIPLE);

   310

		} else {

   311

			tx_ring->count = opt.def;

   312

		}

   313

		for (i = 0; i < adapter->num_tx_queues; i++)

   314

			tx_ring[i].count = tx_ring->count;

   315

	}

   316

	{ /* Receive Descriptor Count */

   317

		struct e1000_option opt = {

   318

			.type = range_option,

   319

			.name = "Receive Descriptors",

   320

			.err  = "using default of "

   321

				__MODULE_STRING(E1000_DEFAULT_RXD),

   322

			.def  = E1000_DEFAULT_RXD,

   323

			.arg  = { .r = { .min = E1000_MIN_RXD }}

   324

		};

   325

		struct e1000_rx_ring *rx_ring = adapter->rx_ring;

   326

		int i;

   327

		e1000_mac_type mac_type = adapter->hw.mac_type;

   328

		opt.arg.r.max = mac_type < e1000_82544 ? E1000_MAX_RXD :

   329

			E1000_MAX_82544_RXD;

   330

   331

		if (num_RxDescriptors > bd) {

   332

			rx_ring->count = RxDescriptors[bd];

   333

			e1000_validate_option(&rx_ring->count, &opt, adapter);

   334

			rx_ring->count = ALIGN(rx_ring->count,

   335

						REQ_RX_DESCRIPTOR_MULTIPLE);

   336

		} else {

   337

			rx_ring->count = opt.def;

   338

		}

   339

		for (i = 0; i < adapter->num_rx_queues; i++)

   340

			rx_ring[i].count = rx_ring->count;

   341

	}

   342

	{ /* Checksum Offload Enable/Disable */

   343

		struct e1000_option opt = {

   344

			.type = enable_option,

   345

			.name = "Checksum Offload",

   346

			.err  = "defaulting to Enabled",

   347

			.def  = OPTION_ENABLED

   348

		};

   349

   350

		if (num_XsumRX > bd) {

   351

			int rx_csum = XsumRX[bd];

   352

			e1000_validate_option(&rx_csum, &opt, adapter);

   353

			adapter->rx_csum = rx_csum;

   354

		} else {

   355

			adapter->rx_csum = opt.def;

   356

		}

   357

	}

   358

	{ /* Flow Control */

   359

   360

		struct e1000_opt_list fc_list[] =

   361

			{{ E1000_FC_NONE,    "Flow Control Disabled" },

   362

			 { E1000_FC_RX_PAUSE,"Flow Control Receive Only" },

   363

			 { E1000_FC_TX_PAUSE,"Flow Control Transmit Only" },

   364

			 { E1000_FC_FULL,    "Flow Control Enabled" },

   365

			 { E1000_FC_DEFAULT, "Flow Control Hardware Default" }};

   366

   367

		struct e1000_option opt = {

   368

			.type = list_option,

   369

			.name = "Flow Control",

   370

			.err  = "reading default settings from EEPROM",

   371

			.def  = E1000_FC_DEFAULT,

   372

			.arg  = { .l = { .nr = ARRAY_SIZE(fc_list),

   373

					 .p = fc_list }}

   374

		};

   375

   376

		if (num_FlowControl > bd) {

   377

			int fc = FlowControl[bd];

   378

			e1000_validate_option(&fc, &opt, adapter);

   379

			adapter->hw.fc = adapter->hw.original_fc = fc;

   380

		} else {

   381

			adapter->hw.fc = adapter->hw.original_fc = opt.def;

   382

		}

   383

	}

   384

	{ /* Transmit Interrupt Delay */

   385

		struct e1000_option opt = {

   386

			.type = range_option,

   387

			.name = "Transmit Interrupt Delay",

   388

			.err  = "using default of " __MODULE_STRING(DEFAULT_TIDV),

   389

			.def  = DEFAULT_TIDV,

   390

			.arg  = { .r = { .min = MIN_TXDELAY,

   391

					 .max = MAX_TXDELAY }}

   392

		};

   393

   394

		if (num_TxIntDelay > bd) {

   395

			adapter->tx_int_delay = TxIntDelay[bd];

   396

			e1000_validate_option(&adapter->tx_int_delay, &opt,

   397

			                      adapter);

   398

		} else {

   399

			adapter->tx_int_delay = opt.def;

   400

		}

   401

	}

   402

	{ /* Transmit Absolute Interrupt Delay */

   403

		struct e1000_option opt = {

   404

			.type = range_option,

   405

			.name = "Transmit Absolute Interrupt Delay",

   406

			.err  = "using default of " __MODULE_STRING(DEFAULT_TADV),

   407

			.def  = DEFAULT_TADV,

   408

			.arg  = { .r = { .min = MIN_TXABSDELAY,

   409

					 .max = MAX_TXABSDELAY }}

   410

		};

   411

   412

		if (num_TxAbsIntDelay > bd) {

   413

			adapter->tx_abs_int_delay = TxAbsIntDelay[bd];

   414

			e1000_validate_option(&adapter->tx_abs_int_delay, &opt,

   415

			                      adapter);

   416

		} else {

   417

			adapter->tx_abs_int_delay = opt.def;

   418

		}

   419

	}

   420

	{ /* Receive Interrupt Delay */

   421

		struct e1000_option opt = {

   422

			.type = range_option,

   423

			.name = "Receive Interrupt Delay",

   424

			.err  = "using default of " __MODULE_STRING(DEFAULT_RDTR),

   425

			.def  = DEFAULT_RDTR,

   426

			.arg  = { .r = { .min = MIN_RXDELAY,

   427

					 .max = MAX_RXDELAY }}

   428

		};

   429

   430

		if (num_RxIntDelay > bd) {

   431

			adapter->rx_int_delay = RxIntDelay[bd];

   432

			e1000_validate_option(&adapter->rx_int_delay, &opt,

   433

			                      adapter);

   434

		} else {

   435

			adapter->rx_int_delay = opt.def;

   436

		}

   437

	}

   438

	{ /* Receive Absolute Interrupt Delay */

   439

		struct e1000_option opt = {

   440

			.type = range_option,

   441

			.name = "Receive Absolute Interrupt Delay",

   442

			.err  = "using default of " __MODULE_STRING(DEFAULT_RADV),

   443

			.def  = DEFAULT_RADV,

   444

			.arg  = { .r = { .min = MIN_RXABSDELAY,

   445

					 .max = MAX_RXABSDELAY }}

   446

		};

   447

   448

		if (num_RxAbsIntDelay > bd) {

   449

			adapter->rx_abs_int_delay = RxAbsIntDelay[bd];

   450

			e1000_validate_option(&adapter->rx_abs_int_delay, &opt,

   451

			                      adapter);

   452

		} else {

   453

			adapter->rx_abs_int_delay = opt.def;

   454

		}

   455

	}

   456

	{ /* Interrupt Throttling Rate */

   457

		struct e1000_option opt = {

   458

			.type = range_option,

   459

			.name = "Interrupt Throttling Rate (ints/sec)",

   460

			.err  = "using default of " __MODULE_STRING(DEFAULT_ITR),

   461

			.def  = DEFAULT_ITR,

   462

			.arg  = { .r = { .min = MIN_ITR,

   463

					 .max = MAX_ITR }}

   464

		};

   465

   466

		if (num_InterruptThrottleRate > bd) {

   467

			adapter->itr = InterruptThrottleRate[bd];

   468

			switch (adapter->itr) {

   469

			case 0:

   470

				DPRINTK(PROBE, INFO, "%s turned off\n",

   471

				        opt.name);

   472

				break;

   473

			case 1:

   474

				DPRINTK(PROBE, INFO, "%s set to dynamic mode\n",

   475

					opt.name);

   476

				adapter->itr_setting = adapter->itr;

   477

				adapter->itr = 20000;

   478

				break;

   479

			case 3:

   480

				DPRINTK(PROBE, INFO,

   481

				        "%s set to dynamic conservative mode\n",

   482

					opt.name);

   483

				adapter->itr_setting = adapter->itr;

   484

				adapter->itr = 20000;

   485

				break;

   486

			default:

   487

				e1000_validate_option(&adapter->itr, &opt,

   488

				        adapter);

   489

				/* save the setting, because the dynamic bits change itr */

   490

				/* clear the lower two bits because they are

   491

				 * used as control */

   492

				adapter->itr_setting = adapter->itr & ~3;

   493

				break;

   494

			}

   495

		} else {

   496

			adapter->itr_setting = opt.def;

   497

			adapter->itr = 20000;

   498

		}

   499

	}

   500

	{ /* Smart Power Down */

   501

		struct e1000_option opt = {

   502

			.type = enable_option,

   503

			.name = "PHY Smart Power Down",

   504

			.err  = "defaulting to Disabled",

   505

			.def  = OPTION_DISABLED

   506

		};

   507

   508

		if (num_SmartPowerDownEnable > bd) {

   509

			int spd = SmartPowerDownEnable[bd];

   510

			e1000_validate_option(&spd, &opt, adapter);

   511

			adapter->smart_power_down = spd;

   512

		} else {

   513

			adapter->smart_power_down = opt.def;

   514

		}

   515

	}

   516

	{ /* Kumeran Lock Loss Workaround */

   517

		struct e1000_option opt = {

   518

			.type = enable_option,

   519

			.name = "Kumeran Lock Loss Workaround",

   520

			.err  = "defaulting to Enabled",

   521

			.def  = OPTION_ENABLED

   522

		};

   523

   524

		if (num_KumeranLockLoss > bd) {

   525

			int kmrn_lock_loss = KumeranLockLoss[bd];

   526

			e1000_validate_option(&kmrn_lock_loss, &opt, adapter);

   527

			adapter->hw.kmrn_lock_loss_workaround_disabled = !kmrn_lock_loss;

   528

		} else {

   529

			adapter->hw.kmrn_lock_loss_workaround_disabled = !opt.def;

   530

		}