linux/drivers/net/ethernet/atheros/atl1e/atl1e_param.c
<<
>>
Prefs
   1/*
   2 * Copyright(c) 2007 Atheros Corporation. All rights reserved.
   3 *
   4 * Derived from Intel e1000 driver
   5 * Copyright(c) 1999 - 2005 Intel Corporation. All rights reserved.
   6 *
   7 * This program is free software; you can redistribute it and/or modify it
   8 * under the terms of the GNU General Public License as published by the Free
   9 * Software Foundation; either version 2 of the License, or (at your option)
  10 * any later version.
  11 *
  12 * This program is distributed in the hope that it will be useful, but WITHOUT
  13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  15 * more details.
  16 *
  17 * You should have received a copy of the GNU General Public License along with
  18 * this program; if not, write to the Free Software Foundation, Inc., 59
  19 * Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  20 */
  21
  22#include <linux/netdevice.h>
  23
  24#include "atl1e.h"
  25
  26/* This is the only thing that needs to be changed to adjust the
  27 * maximum number of ports that the driver can manage.
  28 */
  29
  30#define ATL1E_MAX_NIC 32
  31
  32#define OPTION_UNSET    -1
  33#define OPTION_DISABLED 0
  34#define OPTION_ENABLED  1
  35
  36/* All parameters are treated the same, as an integer array of values.
  37 * This macro just reduces the need to repeat the same declaration code
  38 * over and over (plus this helps to avoid typo bugs).
  39 */
  40#define ATL1E_PARAM_INIT { [0 ... ATL1E_MAX_NIC] = OPTION_UNSET }
  41
  42#define ATL1E_PARAM(x, desc) \
  43        static int x[ATL1E_MAX_NIC + 1] = ATL1E_PARAM_INIT; \
  44        static unsigned int num_##x; \
  45        module_param_array_named(x, x, int, &num_##x, 0); \
  46        MODULE_PARM_DESC(x, desc);
  47
  48/* Transmit Memory count
  49 *
  50 * Valid Range: 64-2048
  51 *
  52 * Default Value: 128
  53 */
  54#define ATL1E_MIN_TX_DESC_CNT           32
  55#define ATL1E_MAX_TX_DESC_CNT           1020
  56#define ATL1E_DEFAULT_TX_DESC_CNT       128
  57ATL1E_PARAM(tx_desc_cnt, "Transmit description count");
  58
  59/* Receive Memory Block Count
  60 *
  61 * Valid Range: 16-512
  62 *
  63 * Default Value: 128
  64 */
  65#define ATL1E_MIN_RX_MEM_SIZE           8    /* 8KB   */
  66#define ATL1E_MAX_RX_MEM_SIZE           1024 /* 1MB   */
  67#define ATL1E_DEFAULT_RX_MEM_SIZE       256  /* 128KB */
  68ATL1E_PARAM(rx_mem_size, "memory size of rx buffer(KB)");
  69
  70/* User Specified MediaType Override
  71 *
  72 * Valid Range: 0-5
  73 *  - 0    - auto-negotiate at all supported speeds
  74 *  - 1    - only link at 100Mbps Full Duplex
  75 *  - 2    - only link at 100Mbps Half Duplex
  76 *  - 3    - only link at 10Mbps Full Duplex
  77 *  - 4    - only link at 10Mbps Half Duplex
  78 * Default Value: 0
  79 */
  80
  81ATL1E_PARAM(media_type, "MediaType Select");
  82
  83/* Interrupt Moderate Timer in units of 2 us
  84 *
  85 * Valid Range: 10-65535
  86 *
  87 * Default Value: 45000(90ms)
  88 */
  89#define INT_MOD_DEFAULT_CNT             100 /* 200us */
  90#define INT_MOD_MAX_CNT                 65000
  91#define INT_MOD_MIN_CNT                 50
  92ATL1E_PARAM(int_mod_timer, "Interrupt Moderator Timer");
  93
  94#define AUTONEG_ADV_DEFAULT  0x2F
  95#define AUTONEG_ADV_MASK     0x2F
  96#define FLOW_CONTROL_DEFAULT FLOW_CONTROL_FULL
  97
  98#define FLASH_VENDOR_DEFAULT    0
  99#define FLASH_VENDOR_MIN        0
 100#define FLASH_VENDOR_MAX        2
 101
 102struct atl1e_option {
 103        enum { enable_option, range_option, list_option } type;
 104        char *name;
 105        char *err;
 106        int  def;
 107        union {
 108                struct { /* range_option info */
 109                        int min;
 110                        int max;
 111                } r;
 112                struct { /* list_option info */
 113                        int nr;
 114                        struct atl1e_opt_list { int i; char *str; } *p;
 115                } l;
 116        } arg;
 117};
 118
 119static int atl1e_validate_option(int *value, struct atl1e_option *opt,
 120                                 struct atl1e_adapter *adapter)
 121{
 122        if (*value == OPTION_UNSET) {
 123                *value = opt->def;
 124                return 0;
 125        }
 126
 127        switch (opt->type) {
 128        case enable_option:
 129                switch (*value) {
 130                case OPTION_ENABLED:
 131                        netdev_info(adapter->netdev,
 132                                    "%s Enabled\n", opt->name);
 133                        return 0;
 134                case OPTION_DISABLED:
 135                        netdev_info(adapter->netdev,
 136                                    "%s Disabled\n", opt->name);
 137                        return 0;
 138                }
 139                break;
 140        case range_option:
 141                if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) {
 142                        netdev_info(adapter->netdev, "%s set to %i\n",
 143                                    opt->name, *value);
 144                        return 0;
 145                }
 146                break;
 147        case list_option:{
 148                        int i;
 149                        struct atl1e_opt_list *ent;
 150
 151                        for (i = 0; i < opt->arg.l.nr; i++) {
 152                                ent = &opt->arg.l.p[i];
 153                                if (*value == ent->i) {
 154                                        if (ent->str[0] != '\0')
 155                                                netdev_info(adapter->netdev,
 156                                                            "%s\n", ent->str);
 157                                        return 0;
 158                                }
 159                        }
 160                        break;
 161                }
 162        default:
 163                BUG();
 164        }
 165
 166        netdev_info(adapter->netdev, "Invalid %s specified (%i) %s\n",
 167                    opt->name, *value, opt->err);
 168        *value = opt->def;
 169        return -1;
 170}
 171
 172/**
 173 * atl1e_check_options - Range Checking for Command Line Parameters
 174 * @adapter: board private structure
 175 *
 176 * This routine checks all command line parameters for valid user
 177 * input.  If an invalid value is given, or if no user specified
 178 * value exists, a default value is used.  The final value is stored
 179 * in a variable in the adapter structure.
 180 */
 181void atl1e_check_options(struct atl1e_adapter *adapter)
 182{
 183        int bd = adapter->bd_number;
 184
 185        if (bd >= ATL1E_MAX_NIC) {
 186                netdev_notice(adapter->netdev,
 187                              "no configuration for board #%i\n", bd);
 188                netdev_notice(adapter->netdev,
 189                              "Using defaults for all values\n");
 190        }
 191
 192        {               /* Transmit Ring Size */
 193                struct atl1e_option opt = {
 194                        .type = range_option,
 195                        .name = "Transmit Ddescription Count",
 196                        .err  = "using default of "
 197                                __MODULE_STRING(ATL1E_DEFAULT_TX_DESC_CNT),
 198                        .def  = ATL1E_DEFAULT_TX_DESC_CNT,
 199                        .arg  = { .r = { .min = ATL1E_MIN_TX_DESC_CNT,
 200                                         .max = ATL1E_MAX_TX_DESC_CNT} }
 201                };
 202                int val;
 203                if (num_tx_desc_cnt > bd) {
 204                        val = tx_desc_cnt[bd];
 205                        atl1e_validate_option(&val, &opt, adapter);
 206                        adapter->tx_ring.count = (u16) val & 0xFFFC;
 207                } else
 208                        adapter->tx_ring.count = (u16)opt.def;
 209        }
 210
 211        {               /* Receive Memory Block Count */
 212                struct atl1e_option opt = {
 213                        .type = range_option,
 214                        .name = "Memory size of rx buffer(KB)",
 215                        .err  = "using default of "
 216                                __MODULE_STRING(ATL1E_DEFAULT_RX_MEM_SIZE),
 217                        .def  = ATL1E_DEFAULT_RX_MEM_SIZE,
 218                        .arg  = { .r = { .min = ATL1E_MIN_RX_MEM_SIZE,
 219                                         .max = ATL1E_MAX_RX_MEM_SIZE} }
 220                };
 221                int val;
 222                if (num_rx_mem_size > bd) {
 223                        val = rx_mem_size[bd];
 224                        atl1e_validate_option(&val, &opt, adapter);
 225                        adapter->rx_ring.page_size = (u32)val * 1024;
 226                } else {
 227                        adapter->rx_ring.page_size = (u32)opt.def * 1024;
 228                }
 229        }
 230
 231        {               /* Interrupt Moderate Timer */
 232                struct atl1e_option opt = {
 233                        .type = range_option,
 234                        .name = "Interrupt Moderate Timer",
 235                        .err  = "using default of "
 236                                __MODULE_STRING(INT_MOD_DEFAULT_CNT),
 237                        .def  = INT_MOD_DEFAULT_CNT,
 238                        .arg  = { .r = { .min = INT_MOD_MIN_CNT,
 239                                         .max = INT_MOD_MAX_CNT} }
 240                } ;
 241                int val;
 242                if (num_int_mod_timer > bd) {
 243                        val = int_mod_timer[bd];
 244                        atl1e_validate_option(&val, &opt, adapter);
 245                        adapter->hw.imt = (u16) val;
 246                } else
 247                        adapter->hw.imt = (u16)(opt.def);
 248        }
 249
 250        {               /* MediaType */
 251                struct atl1e_option opt = {
 252                        .type = range_option,
 253                        .name = "Speed/Duplex Selection",
 254                        .err  = "using default of "
 255                                __MODULE_STRING(MEDIA_TYPE_AUTO_SENSOR),
 256                        .def  = MEDIA_TYPE_AUTO_SENSOR,
 257                        .arg  = { .r = { .min = MEDIA_TYPE_AUTO_SENSOR,
 258                                         .max = MEDIA_TYPE_10M_HALF} }
 259                } ;
 260                int val;
 261                if (num_media_type > bd) {
 262                        val = media_type[bd];
 263                        atl1e_validate_option(&val, &opt, adapter);
 264                        adapter->hw.media_type = (u16) val;
 265                } else
 266                        adapter->hw.media_type = (u16)(opt.def);
 267
 268        }
 269}
 270