fp@2584: /******************************************************************************* fp@2584: fp@2584: Intel PRO/1000 Linux driver fp@2584: Copyright(c) 1999 - 2012 Intel Corporation. fp@2584: fp@2584: This program is free software; you can redistribute it and/or modify it fp@2584: under the terms and conditions of the GNU General Public License, fp@2584: version 2, as published by the Free Software Foundation. fp@2584: fp@2584: This program is distributed in the hope it will be useful, but WITHOUT fp@2584: ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or fp@2584: FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for fp@2584: more details. fp@2584: fp@2584: You should have received a copy of the GNU General Public License along with fp@2584: this program; if not, write to the Free Software Foundation, Inc., fp@2584: 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA. fp@2584: fp@2584: The full GNU General Public License is included in this distribution in fp@2584: the file called "COPYING". fp@2584: fp@2584: Contact Information: fp@2584: Linux NICS fp@2584: e1000-devel Mailing List fp@2584: Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 fp@2584: fp@2584: *******************************************************************************/ fp@2584: fp@2584: #include fp@2584: #include fp@2584: #include fp@2584: fp@2584: #include "e1000.h" fp@2584: fp@2584: /* This is the only thing that needs to be changed to adjust the fp@2584: * maximum number of ports that the driver can manage. fp@2584: */ fp@2584: #define E1000_MAX_NIC 32 fp@2584: fp@2584: #define OPTION_UNSET -1 fp@2584: #define OPTION_DISABLED 0 fp@2584: #define OPTION_ENABLED 1 fp@2584: fp@2584: #define COPYBREAK_DEFAULT 256 fp@2584: unsigned int copybreak = COPYBREAK_DEFAULT; fp@2584: module_param(copybreak, uint, 0644); fp@2584: MODULE_PARM_DESC(copybreak, fp@2584: "Maximum size of packet that is copied to a new buffer on receive"); fp@2584: fp@2584: /* All parameters are treated the same, as an integer array of values. fp@2584: * This macro just reduces the need to repeat the same declaration code fp@2584: * over and over (plus this helps to avoid typo bugs). fp@2584: */ fp@2584: #define E1000_PARAM_INIT { [0 ... E1000_MAX_NIC] = OPTION_UNSET } fp@2584: #define E1000_PARAM(X, desc) \ fp@2584: static int X[E1000_MAX_NIC+1] \ fp@2584: = E1000_PARAM_INIT; \ fp@2584: static unsigned int num_##X; \ fp@2584: module_param_array_named(X, X, int, &num_##X, 0); \ fp@2584: MODULE_PARM_DESC(X, desc); fp@2584: fp@2584: /* Transmit Interrupt Delay in units of 1.024 microseconds fp@2584: * Tx interrupt delay needs to typically be set to something non-zero fp@2584: * fp@2584: * Valid Range: 0-65535 fp@2584: */ fp@2584: E1000_PARAM(TxIntDelay, "Transmit Interrupt Delay"); fp@2584: #define DEFAULT_TIDV 8 fp@2584: #define MAX_TXDELAY 0xFFFF fp@2584: #define MIN_TXDELAY 0 fp@2584: fp@2584: /* Transmit Absolute Interrupt Delay in units of 1.024 microseconds fp@2584: * fp@2584: * Valid Range: 0-65535 fp@2584: */ fp@2584: E1000_PARAM(TxAbsIntDelay, "Transmit Absolute Interrupt Delay"); fp@2584: #define DEFAULT_TADV 32 fp@2584: #define MAX_TXABSDELAY 0xFFFF fp@2584: #define MIN_TXABSDELAY 0 fp@2584: fp@2584: /* Receive Interrupt Delay in units of 1.024 microseconds fp@2584: * hardware will likely hang if you set this to anything but zero. fp@2584: * fp@2584: * Valid Range: 0-65535 fp@2584: */ fp@2584: E1000_PARAM(RxIntDelay, "Receive Interrupt Delay"); fp@2584: #define MAX_RXDELAY 0xFFFF fp@2584: #define MIN_RXDELAY 0 fp@2584: fp@2584: /* Receive Absolute Interrupt Delay in units of 1.024 microseconds fp@2584: * fp@2584: * Valid Range: 0-65535 fp@2584: */ fp@2584: E1000_PARAM(RxAbsIntDelay, "Receive Absolute Interrupt Delay"); fp@2584: #define MAX_RXABSDELAY 0xFFFF fp@2584: #define MIN_RXABSDELAY 0 fp@2584: fp@2584: /* Interrupt Throttle Rate (interrupts/sec) fp@2584: * fp@2584: * Valid Range: 100-100000 or one of: 0=off, 1=dynamic, 3=dynamic conservative fp@2584: */ fp@2584: E1000_PARAM(InterruptThrottleRate, "Interrupt Throttling Rate"); fp@2584: #define DEFAULT_ITR 3 fp@2584: #define MAX_ITR 100000 fp@2584: #define MIN_ITR 100 fp@2584: fp@2584: /* IntMode (Interrupt Mode) fp@2584: * fp@2584: * Valid Range: varies depending on kernel configuration & hardware support fp@2584: * fp@2584: * legacy=0, MSI=1, MSI-X=2 fp@2584: * fp@2584: * When MSI/MSI-X support is enabled in kernel- fp@2584: * Default Value: 2 (MSI-X) when supported by hardware, 1 (MSI) otherwise fp@2584: * When MSI/MSI-X support is not enabled in kernel- fp@2584: * Default Value: 0 (legacy) fp@2584: * fp@2584: * When a mode is specified that is not allowed/supported, it will be fp@2584: * demoted to the most advanced interrupt mode available. fp@2584: */ fp@2584: E1000_PARAM(IntMode, "Interrupt Mode"); fp@2584: #define MAX_INTMODE 2 fp@2584: #define MIN_INTMODE 0 fp@2584: fp@2584: /* Enable Smart Power Down of the PHY fp@2584: * fp@2584: * Valid Range: 0, 1 fp@2584: * fp@2584: * Default Value: 0 (disabled) fp@2584: */ fp@2584: E1000_PARAM(SmartPowerDownEnable, "Enable PHY smart power down"); fp@2584: fp@2584: /* Enable Kumeran Lock Loss workaround fp@2584: * fp@2584: * Valid Range: 0, 1 fp@2584: * fp@2584: * Default Value: 1 (enabled) fp@2584: */ fp@2584: E1000_PARAM(KumeranLockLoss, "Enable Kumeran lock loss workaround"); fp@2584: fp@2584: /* Write Protect NVM fp@2584: * fp@2584: * Valid Range: 0, 1 fp@2584: * fp@2584: * Default Value: 1 (enabled) fp@2584: */ fp@2584: E1000_PARAM(WriteProtectNVM, "Write-protect NVM [WARNING: disabling this can lead to corrupted NVM]"); fp@2584: fp@2584: /* Enable CRC Stripping fp@2584: * fp@2584: * Valid Range: 0, 1 fp@2584: * fp@2584: * Default Value: 1 (enabled) fp@2584: */ fp@2584: E1000_PARAM(CrcStripping, fp@2584: "Enable CRC Stripping, disable if your BMC needs the CRC"); fp@2584: fp@2584: struct e1000_option { fp@2584: enum { enable_option, range_option, list_option } type; fp@2584: const char *name; fp@2584: const char *err; fp@2584: int def; fp@2584: union { fp@2584: struct { /* range_option info */ fp@2584: int min; fp@2584: int max; fp@2584: } r; fp@2584: struct { /* list_option info */ fp@2584: int nr; fp@2584: struct e1000_opt_list { int i; char *str; } *p; fp@2584: } l; fp@2584: } arg; fp@2584: }; fp@2584: fp@2584: static int e1000_validate_option(unsigned int *value, fp@2584: const struct e1000_option *opt, fp@2584: struct e1000_adapter *adapter) fp@2584: { fp@2584: if (*value == OPTION_UNSET) { fp@2584: *value = opt->def; fp@2584: return 0; fp@2584: } fp@2584: fp@2584: switch (opt->type) { fp@2584: case enable_option: fp@2584: switch (*value) { fp@2584: case OPTION_ENABLED: fp@2584: dev_info(&adapter->pdev->dev, "%s Enabled\n", fp@2584: opt->name); fp@2584: return 0; fp@2584: case OPTION_DISABLED: fp@2584: dev_info(&adapter->pdev->dev, "%s Disabled\n", fp@2584: opt->name); fp@2584: return 0; fp@2584: } fp@2584: break; fp@2584: case range_option: fp@2584: if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) { fp@2584: dev_info(&adapter->pdev->dev, "%s set to %i\n", fp@2584: opt->name, *value); fp@2584: return 0; fp@2584: } fp@2584: break; fp@2584: case list_option: { fp@2584: int i; fp@2584: struct e1000_opt_list *ent; fp@2584: fp@2584: for (i = 0; i < opt->arg.l.nr; i++) { fp@2584: ent = &opt->arg.l.p[i]; fp@2584: if (*value == ent->i) { fp@2584: if (ent->str[0] != '\0') fp@2584: dev_info(&adapter->pdev->dev, "%s\n", fp@2584: ent->str); fp@2584: return 0; fp@2584: } fp@2584: } fp@2584: } fp@2584: break; fp@2584: default: fp@2584: BUG(); fp@2584: } fp@2584: fp@2584: dev_info(&adapter->pdev->dev, "Invalid %s value specified (%i) %s\n", fp@2584: opt->name, *value, opt->err); fp@2584: *value = opt->def; fp@2584: return -1; fp@2584: } fp@2584: fp@2584: /** fp@2584: * e1000e_check_options - Range Checking for Command Line Parameters fp@2584: * @adapter: board private structure fp@2584: * fp@2584: * This routine checks all command line parameters for valid user fp@2584: * input. If an invalid value is given, or if no user specified fp@2584: * value exists, a default value is used. The final value is stored fp@2584: * in a variable in the adapter structure. fp@2584: **/ fp@2584: void e1000e_check_options(struct e1000_adapter *adapter) fp@2584: { fp@2584: struct e1000_hw *hw = &adapter->hw; fp@2584: int bd = adapter->bd_number; fp@2584: fp@2584: if (bd >= E1000_MAX_NIC) { fp@2584: dev_notice(&adapter->pdev->dev, fp@2584: "Warning: no configuration for board #%i\n", bd); fp@2584: dev_notice(&adapter->pdev->dev, fp@2584: "Using defaults for all values\n"); fp@2584: } fp@2584: fp@2584: { /* Transmit Interrupt Delay */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Transmit Interrupt Delay", fp@2584: .err = "using default of " fp@2584: __MODULE_STRING(DEFAULT_TIDV), fp@2584: .def = DEFAULT_TIDV, fp@2584: .arg = { .r = { .min = MIN_TXDELAY, fp@2584: .max = MAX_TXDELAY } } fp@2584: }; fp@2584: fp@2584: if (num_TxIntDelay > bd) { fp@2584: adapter->tx_int_delay = TxIntDelay[bd]; fp@2584: e1000_validate_option(&adapter->tx_int_delay, &opt, fp@2584: adapter); fp@2584: } else { fp@2584: adapter->tx_int_delay = opt.def; fp@2584: } fp@2584: } fp@2584: { /* Transmit Absolute Interrupt Delay */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Transmit Absolute Interrupt Delay", fp@2584: .err = "using default of " fp@2584: __MODULE_STRING(DEFAULT_TADV), fp@2584: .def = DEFAULT_TADV, fp@2584: .arg = { .r = { .min = MIN_TXABSDELAY, fp@2584: .max = MAX_TXABSDELAY } } fp@2584: }; fp@2584: fp@2584: if (num_TxAbsIntDelay > bd) { fp@2584: adapter->tx_abs_int_delay = TxAbsIntDelay[bd]; fp@2584: e1000_validate_option(&adapter->tx_abs_int_delay, &opt, fp@2584: adapter); fp@2584: } else { fp@2584: adapter->tx_abs_int_delay = opt.def; fp@2584: } fp@2584: } fp@2584: { /* Receive Interrupt Delay */ fp@2584: static struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Receive Interrupt Delay", fp@2584: .err = "using default of " fp@2584: __MODULE_STRING(DEFAULT_RDTR), fp@2584: .def = DEFAULT_RDTR, fp@2584: .arg = { .r = { .min = MIN_RXDELAY, fp@2584: .max = MAX_RXDELAY } } fp@2584: }; fp@2584: fp@2584: if (num_RxIntDelay > bd) { fp@2584: adapter->rx_int_delay = RxIntDelay[bd]; fp@2584: e1000_validate_option(&adapter->rx_int_delay, &opt, fp@2584: adapter); fp@2584: } else { fp@2584: adapter->rx_int_delay = opt.def; fp@2584: } fp@2584: } fp@2584: { /* Receive Absolute Interrupt Delay */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Receive Absolute Interrupt Delay", fp@2584: .err = "using default of " fp@2584: __MODULE_STRING(DEFAULT_RADV), fp@2584: .def = DEFAULT_RADV, fp@2584: .arg = { .r = { .min = MIN_RXABSDELAY, fp@2584: .max = MAX_RXABSDELAY } } fp@2584: }; fp@2584: fp@2584: if (num_RxAbsIntDelay > bd) { fp@2584: adapter->rx_abs_int_delay = RxAbsIntDelay[bd]; fp@2584: e1000_validate_option(&adapter->rx_abs_int_delay, &opt, fp@2584: adapter); fp@2584: } else { fp@2584: adapter->rx_abs_int_delay = opt.def; fp@2584: } fp@2584: } fp@2584: { /* Interrupt Throttling Rate */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Interrupt Throttling Rate (ints/sec)", fp@2584: .err = "using default of " fp@2584: __MODULE_STRING(DEFAULT_ITR), fp@2584: .def = DEFAULT_ITR, fp@2584: .arg = { .r = { .min = MIN_ITR, fp@2584: .max = MAX_ITR } } fp@2584: }; fp@2584: fp@2584: if (num_InterruptThrottleRate > bd) { fp@2584: adapter->itr = InterruptThrottleRate[bd]; fp@2584: fp@2584: /* Make sure a message is printed for non-special fp@2584: * values. And in case of an invalid option, display fp@2584: * warning, use default and go through itr/itr_setting fp@2584: * adjustment logic below fp@2584: */ fp@2584: if ((adapter->itr > 4) && fp@2584: e1000_validate_option(&adapter->itr, &opt, adapter)) fp@2584: adapter->itr = opt.def; fp@2584: } else { fp@2584: /* If no option specified, use default value and go fp@2584: * through the logic below to adjust itr/itr_setting fp@2584: */ fp@2584: adapter->itr = opt.def; fp@2584: fp@2584: /* Make sure a message is printed for non-special fp@2584: * default values fp@2584: */ fp@2584: if (adapter->itr > 4) fp@2584: dev_info(&adapter->pdev->dev, fp@2584: "%s set to default %d\n", opt.name, fp@2584: adapter->itr); fp@2584: } fp@2584: fp@2584: adapter->itr_setting = adapter->itr; fp@2584: switch (adapter->itr) { fp@2584: case 0: fp@2584: dev_info(&adapter->pdev->dev, "%s turned off\n", fp@2584: opt.name); fp@2584: break; fp@2584: case 1: fp@2584: dev_info(&adapter->pdev->dev, fp@2584: "%s set to dynamic mode\n", opt.name); fp@2584: adapter->itr = 20000; fp@2584: break; fp@2584: case 3: fp@2584: dev_info(&adapter->pdev->dev, fp@2584: "%s set to dynamic conservative mode\n", fp@2584: opt.name); fp@2584: adapter->itr = 20000; fp@2584: break; fp@2584: case 4: fp@2584: dev_info(&adapter->pdev->dev, fp@2584: "%s set to simplified (2000-8000 ints) mode\n", fp@2584: opt.name); fp@2584: break; fp@2584: default: fp@2584: /* Save the setting, because the dynamic bits fp@2584: * change itr. fp@2584: * fp@2584: * Clear the lower two bits because fp@2584: * they are used as control. fp@2584: */ fp@2584: adapter->itr_setting &= ~3; fp@2584: break; fp@2584: } fp@2584: } fp@2584: { /* Interrupt Mode */ fp@2584: static struct e1000_option opt = { fp@2584: .type = range_option, fp@2584: .name = "Interrupt Mode", fp@2584: #ifndef CONFIG_PCI_MSI fp@2584: .err = "defaulting to 0 (legacy)", fp@2584: .def = E1000E_INT_MODE_LEGACY, fp@2584: .arg = { .r = { .min = 0, fp@2584: .max = 0 } } fp@2584: #endif fp@2584: }; fp@2584: fp@2584: #ifdef CONFIG_PCI_MSI fp@2584: if (adapter->flags & FLAG_HAS_MSIX) { fp@2584: opt.err = kstrdup("defaulting to 2 (MSI-X)", fp@2584: GFP_KERNEL); fp@2584: opt.def = E1000E_INT_MODE_MSIX; fp@2584: opt.arg.r.max = E1000E_INT_MODE_MSIX; fp@2584: } else { fp@2584: opt.err = kstrdup("defaulting to 1 (MSI)", GFP_KERNEL); fp@2584: opt.def = E1000E_INT_MODE_MSI; fp@2584: opt.arg.r.max = E1000E_INT_MODE_MSI; fp@2584: } fp@2584: fp@2584: if (!opt.err) { fp@2584: dev_err(&adapter->pdev->dev, fp@2584: "Failed to allocate memory\n"); fp@2584: return; fp@2584: } fp@2584: #endif fp@2584: fp@2584: if (num_IntMode > bd) { fp@2584: unsigned int int_mode = IntMode[bd]; fp@2584: e1000_validate_option(&int_mode, &opt, adapter); fp@2584: adapter->int_mode = int_mode; fp@2584: } else { fp@2584: adapter->int_mode = opt.def; fp@2584: } fp@2584: fp@2584: #ifdef CONFIG_PCI_MSI fp@2584: kfree(opt.err); fp@2584: #endif fp@2584: } fp@2584: { /* Smart Power Down */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = enable_option, fp@2584: .name = "PHY Smart Power Down", fp@2584: .err = "defaulting to Disabled", fp@2584: .def = OPTION_DISABLED fp@2584: }; fp@2584: fp@2584: if (num_SmartPowerDownEnable > bd) { fp@2584: unsigned int spd = SmartPowerDownEnable[bd]; fp@2584: e1000_validate_option(&spd, &opt, adapter); fp@2584: if ((adapter->flags & FLAG_HAS_SMART_POWER_DOWN) fp@2584: && spd) fp@2584: adapter->flags |= FLAG_SMART_POWER_DOWN; fp@2584: } fp@2584: } fp@2584: { /* CRC Stripping */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = enable_option, fp@2584: .name = "CRC Stripping", fp@2584: .err = "defaulting to Enabled", fp@2584: .def = OPTION_ENABLED fp@2584: }; fp@2584: fp@2584: if (num_CrcStripping > bd) { fp@2584: unsigned int crc_stripping = CrcStripping[bd]; fp@2584: e1000_validate_option(&crc_stripping, &opt, adapter); fp@2584: if (crc_stripping == OPTION_ENABLED) { fp@2584: adapter->flags2 |= FLAG2_CRC_STRIPPING; fp@2584: adapter->flags2 |= FLAG2_DFLT_CRC_STRIPPING; fp@2584: } fp@2584: } else { fp@2584: adapter->flags2 |= FLAG2_CRC_STRIPPING; fp@2584: adapter->flags2 |= FLAG2_DFLT_CRC_STRIPPING; fp@2584: } fp@2584: } fp@2584: { /* Kumeran Lock Loss Workaround */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = enable_option, fp@2584: .name = "Kumeran Lock Loss Workaround", fp@2584: .err = "defaulting to Enabled", fp@2584: .def = OPTION_ENABLED fp@2584: }; fp@2584: fp@2584: if (num_KumeranLockLoss > bd) { fp@2584: unsigned int kmrn_lock_loss = KumeranLockLoss[bd]; fp@2584: e1000_validate_option(&kmrn_lock_loss, &opt, adapter); fp@2584: if (hw->mac.type == e1000_ich8lan) fp@2584: e1000e_set_kmrn_lock_loss_workaround_ich8lan(hw, fp@2584: kmrn_lock_loss); fp@2584: } else { fp@2584: if (hw->mac.type == e1000_ich8lan) fp@2584: e1000e_set_kmrn_lock_loss_workaround_ich8lan(hw, fp@2584: opt.def); fp@2584: } fp@2584: } fp@2584: { /* Write-protect NVM */ fp@2584: static const struct e1000_option opt = { fp@2584: .type = enable_option, fp@2584: .name = "Write-protect NVM", fp@2584: .err = "defaulting to Enabled", fp@2584: .def = OPTION_ENABLED fp@2584: }; fp@2584: fp@2584: if (adapter->flags & FLAG_IS_ICH) { fp@2584: if (num_WriteProtectNVM > bd) { fp@2584: unsigned int write_protect_nvm = WriteProtectNVM[bd]; fp@2584: e1000_validate_option(&write_protect_nvm, &opt, fp@2584: adapter); fp@2584: if (write_protect_nvm) fp@2584: adapter->flags |= FLAG_READ_ONLY_NVM; fp@2584: } else { fp@2584: if (opt.def) fp@2584: adapter->flags |= FLAG_READ_ONLY_NVM; fp@2584: } fp@2584: } fp@2584: } fp@2584: }