drivers/net/atl1/atl1_param.c

   1 /*
   2  * Copyright(c) 2005 - 2006 Attansic Corporation. All rights reserved.
   3  * Copyright(c) 2006 Chris Snook <csnook@redhat.com>
   4  * Copyright(c) 2006 Jay Cliburn <jcliburn@gmail.com>
   5  *
   6  * Derived from Intel e1000 driver
   7  * Copyright(c) 1999 - 2005 Intel Corporation. All rights reserved.
   8  *
   9  * This program is free software; you can redistribute it and/or modify it
  10  * under the terms of the GNU General Public License as published by the Free
  11  * Software Foundation; either version 2 of the License, or (at your option)
  12  * any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  16  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  17  * more details.
  18  *
  19  * You should have received a copy of the GNU General Public License along with
  20  * this program; if not, write to the Free Software Foundation, Inc., 59
  21  * Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  22  */
  23
  24 #include <linux/types.h>
  25 #include <linux/pci.h>
  26 #include <linux/moduleparam.h>
  27 #include "atl1.h"
  28
  29 /*
  30  * This is the only thing that needs to be changed to adjust the
  31  * maximum number of ports that the driver can manage.
  32  */
  33 #define ATL1_MAX_NIC 4
  34
  35 #define OPTION_UNSET    -1
  36 #define OPTION_DISABLED 0
  37 #define OPTION_ENABLED  1
  38
  39 #define ATL1_PARAM_INIT { [0 ... ATL1_MAX_NIC] = OPTION_UNSET }
  40
  41 /*
  42  * Interrupt Moderate Timer in units of 2 us
  43  *
  44  * Valid Range: 10-65535
  45  *
  46  * Default Value: 100 (200us)
  47  */
  48 static int __devinitdata int_mod_timer[ATL1_MAX_NIC+1] = ATL1_PARAM_INIT;
  49 static int num_int_mod_timer = 0;
  50 module_param_array_named(int_mod_timer, int_mod_timer, int, &num_int_mod_timer, 0);
  51 MODULE_PARM_DESC(int_mod_timer, "Interrupt moderator timer");
  52
  53 /*
  54  * flash_vendor
  55  *
  56  * Valid Range: 0-2
  57  *
  58  * 0 - Atmel
  59  * 1 - SST
  60  * 2 - ST
  61  *
  62  * Default Value: 0
  63  */
  64 static int __devinitdata flash_vendor[ATL1_MAX_NIC+1] = ATL1_PARAM_INIT;
  65 static int num_flash_vendor = 0;
  66 module_param_array_named(flash_vendor, flash_vendor, int, &num_flash_vendor, 0);
  67 MODULE_PARM_DESC(flash_vendor, "SPI flash vendor");
  68
  69 #define DEFAULT_INT_MOD_CNT     100     /* 200us */
  70 #define MAX_INT_MOD_CNT         65000
  71 #define MIN_INT_MOD_CNT         50
  72
  73 #define FLASH_VENDOR_DEFAULT    0
  74 #define FLASH_VENDOR_MIN        0
  75 #define FLASH_VENDOR_MAX        2
  76
  77 struct atl1_option {
  78         enum { enable_option, range_option, list_option } type;
  79         char *name;
  80         char *err;
  81         int def;
  82         union {
  83                 struct {        /* range_option info */
  84                         int min;
  85                         int max;
  86                 } r;
  87                 struct {        /* list_option info */
  88                         int nr;
  89                         struct atl1_opt_list {
  90                                 int i;
  91                                 char *str;
  92                         } *p;
  93                 } l;
  94         } arg;
  95 };
  96
  97 static int __devinit atl1_validate_option(int *value, struct atl1_option *opt)
  98 {
  99         if (*value == OPTION_UNSET) {
 100                 *value = opt->def;
 101                 return 0;
 102         }
 103
 104         switch (opt->type) {
 105         case enable_option:
 106                 switch (*value) {
 107                 case OPTION_ENABLED:
 108                         printk(KERN_INFO "%s: %s Enabled\n", atl1_driver_name,
 109                                 opt->name);
 110                         return 0;
 111                 case OPTION_DISABLED:
 112                         printk(KERN_INFO "%s: %s Disabled\n", atl1_driver_name,
 113                                 opt->name);
 114                         return 0;
 115                 }
 116                 break;
 117         case range_option:
 118                 if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) {
 119                         printk(KERN_INFO "%s: %s set to %i\n",
 120                                 atl1_driver_name, opt->name, *value);
 121                         return 0;
 122                 }
 123                 break;
 124         case list_option:{
 125                         int i;
 126                         struct atl1_opt_list *ent;
 127
 128                         for (i = 0; i < opt->arg.l.nr; i++) {
 129                                 ent = &opt->arg.l.p[i];
 130                                 if (*value == ent->i) {
 131                                         if (ent->str[0] != '\0')
 132                                                 printk(KERN_INFO "%s: %s\n",
 133                                                        atl1_driver_name, ent->str);
 134                                         return 0;
 135                                 }
 136                         }
 137                 }
 138                 break;
 139
 140         default:
 141                 break;
 142         }
 143
 144         printk(KERN_INFO "%s: invalid %s specified (%i) %s\n",
 145                atl1_driver_name, opt->name, *value, opt->err);
 146         *value = opt->def;
 147         return -1;
 148 }
 149
 150 /*
 151  * atl1_check_options - Range Checking for Command Line Parameters
 152  * @adapter: board private structure
 153  *
 154  * This routine checks all command line parameters for valid user
 155  * input.  If an invalid value is given, or if no user specified
 156  * value exists, a default value is used.  The final value is stored
 157  * in a variable in the adapter structure.
 158  */
 159 void __devinit atl1_check_options(struct atl1_adapter *adapter)
 160 {
 161         int bd = adapter->bd_number;
 162         if (bd >= ATL1_MAX_NIC) {
 163                 printk(KERN_NOTICE "%s: warning: no configuration for board #%i\n",
 164                         atl1_driver_name, bd);
 165                 printk(KERN_NOTICE "%s: using defaults for all values\n",
 166                         atl1_driver_name);
 167         }
 168         {                       /* Interrupt Moderate Timer */
 169                 struct atl1_option opt = {
 170                         .type = range_option,
 171                         .name = "Interrupt Moderator Timer",
 172                         .err = "using default of "
 173                                 __MODULE_STRING(DEFAULT_INT_MOD_CNT),
 174                         .def = DEFAULT_INT_MOD_CNT,
 175                         .arg = {.r =
 176                                 {.min = MIN_INT_MOD_CNT,.max = MAX_INT_MOD_CNT}}
 177                 };
 178                 int val;
 179                 if (num_int_mod_timer > bd) {
 180                         val = int_mod_timer[bd];
 181                         atl1_validate_option(&val, &opt);
 182                         adapter->imt = (u16) val;
 183                 } else
 184                         adapter->imt = (u16) (opt.def);
 185         }
 186
 187         {                       /* Flash Vendor */
 188                 struct atl1_option opt = {
 189                         .type = range_option,
 190                         .name = "SPI Flash Vendor",
 191                         .err = "using default of "
 192                                 __MODULE_STRING(FLASH_VENDOR_DEFAULT),
 193                         .def = DEFAULT_INT_MOD_CNT,
 194                         .arg = {.r =
 195                                 {.min = FLASH_VENDOR_MIN,.max =
 196                                  FLASH_VENDOR_MAX}}
 197                 };
 198                 int val;
 199                 if (num_flash_vendor > bd) {
 200                         val = flash_vendor[bd];
 201                         atl1_validate_option(&val, &opt);
 202                         adapter->hw.flash_vendor = (u8) val;
 203                 } else
 204                         adapter->hw.flash_vendor = (u8) (opt.def);
 205         }
 206 }