Merge master.kernel.org:/pub/scm/linux/kernel/git/gregkh/pci-2.6
[linux-2.6] / 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 }