Commit | Line | Data |
---|---|---|
3a48c4c2 PR |
1 | /* |
2 | * Driver for 802.11b cards using RAM-loadable Symbol firmware, such as | |
4ebe2eb0 | 3 | * Symbol Wireless Networker LA4137, CompactFlash cards by Socket |
3a48c4c2 PR |
4 | * Communications and Intel PRO/Wireless 2011B. |
5 | * | |
6 | * The driver implements Symbol firmware download. The rest is handled | |
47445cb9 | 7 | * in hermes.c and main.c. |
3a48c4c2 PR |
8 | * |
9 | * Utilities for downloading the Symbol firmware are available at | |
10 | * http://sourceforge.net/projects/orinoco/ | |
11 | * | |
12 | * Copyright (C) 2002-2005 Pavel Roskin <proski@gnu.org> | |
13 | * Portions based on orinoco_cs.c: | |
933d5943 | 14 | * Copyright (C) David Gibson, Linuxcare Australia |
3a48c4c2 | 15 | * Portions based on Spectrum24tDnld.c from original spectrum24 driver: |
933d5943 | 16 | * Copyright (C) Symbol Technologies. |
3a48c4c2 | 17 | * |
47445cb9 | 18 | * See copyright notice in file main.c. |
3a48c4c2 PR |
19 | */ |
20 | ||
21 | #define DRIVER_NAME "spectrum_cs" | |
22 | #define PFX DRIVER_NAME ": " | |
23 | ||
3a48c4c2 PR |
24 | #include <linux/module.h> |
25 | #include <linux/kernel.h> | |
26 | #include <linux/init.h> | |
ef846bf0 | 27 | #include <linux/delay.h> |
3a48c4c2 PR |
28 | #include <pcmcia/cistpl.h> |
29 | #include <pcmcia/cisreg.h> | |
30 | #include <pcmcia/ds.h> | |
31 | ||
3a48c4c2 | 32 | #include "orinoco.h" |
3a48c4c2 PR |
33 | |
34 | /********************************************************************/ | |
35 | /* Module stuff */ | |
36 | /********************************************************************/ | |
37 | ||
38 | MODULE_AUTHOR("Pavel Roskin <proski@gnu.org>"); | |
39 | MODULE_DESCRIPTION("Driver for Symbol Spectrum24 Trilogy cards with firmware downloader"); | |
40 | MODULE_LICENSE("Dual MPL/GPL"); | |
41 | ||
42 | /* Module parameters */ | |
43 | ||
44 | /* Some D-Link cards have buggy CIS. They do work at 5v properly, but | |
45 | * don't have any CIS entry for it. This workaround it... */ | |
46 | static int ignore_cis_vcc; /* = 0 */ | |
47 | module_param(ignore_cis_vcc, int, 0); | |
48 | MODULE_PARM_DESC(ignore_cis_vcc, "Allow voltage mismatch between card and socket"); | |
49 | ||
3a48c4c2 PR |
50 | /********************************************************************/ |
51 | /* Data structures */ | |
52 | /********************************************************************/ | |
53 | ||
54 | /* PCMCIA specific device information (goes in the card field of | |
55 | * struct orinoco_private */ | |
56 | struct orinoco_pccard { | |
fd238232 | 57 | struct pcmcia_device *p_dev; |
3a48c4c2 PR |
58 | }; |
59 | ||
3a48c4c2 PR |
60 | /********************************************************************/ |
61 | /* Function prototypes */ | |
62 | /********************************************************************/ | |
63 | ||
15b99ac1 | 64 | static int spectrum_cs_config(struct pcmcia_device *link); |
fba395ee | 65 | static void spectrum_cs_release(struct pcmcia_device *link); |
3a48c4c2 | 66 | |
3a48c4c2 PR |
67 | /* Constants for the CISREG_CCSR register */ |
68 | #define HCR_RUN 0x07 /* run firmware after reset */ | |
69 | #define HCR_IDLE 0x0E /* don't run firmware after reset */ | |
70 | #define HCR_MEM16 0x10 /* memory width bit, should be preserved */ | |
71 | ||
3a48c4c2 | 72 | |
3a48c4c2 PR |
73 | /* |
74 | * Reset the card using configuration registers COR and CCSR. | |
75 | * If IDLE is 1, stop the firmware, so that it can be safely rewritten. | |
76 | */ | |
77 | static int | |
fba395ee | 78 | spectrum_reset(struct pcmcia_device *link, int idle) |
3a48c4c2 | 79 | { |
2caff147 | 80 | int ret; |
1d5cc192 DB |
81 | u8 save_cor; |
82 | u8 ccsr; | |
3a48c4c2 PR |
83 | |
84 | /* Doing it if hardware is gone is guaranteed crash */ | |
c5ab964d | 85 | if (!pcmcia_dev_present(link)) |
3a48c4c2 PR |
86 | return -ENODEV; |
87 | ||
88 | /* Save original COR value */ | |
1d5cc192 | 89 | ret = pcmcia_read_config_byte(link, CISREG_COR, &save_cor); |
2caff147 DB |
90 | if (ret) |
91 | goto failed; | |
3a48c4c2 PR |
92 | |
93 | /* Soft-Reset card */ | |
1d5cc192 DB |
94 | ret = pcmcia_write_config_byte(link, CISREG_COR, |
95 | (save_cor | COR_SOFT_RESET)); | |
2caff147 DB |
96 | if (ret) |
97 | goto failed; | |
3a48c4c2 PR |
98 | udelay(1000); |
99 | ||
100 | /* Read CCSR */ | |
1d5cc192 | 101 | ret = pcmcia_read_config_byte(link, CISREG_CCSR, &ccsr); |
2caff147 DB |
102 | if (ret) |
103 | goto failed; | |
3a48c4c2 PR |
104 | |
105 | /* | |
106 | * Start or stop the firmware. Memory width bit should be | |
107 | * preserved from the value we've just read. | |
108 | */ | |
1d5cc192 DB |
109 | ccsr = (idle ? HCR_IDLE : HCR_RUN) | (ccsr & HCR_MEM16); |
110 | ret = pcmcia_write_config_byte(link, CISREG_CCSR, ccsr); | |
2caff147 DB |
111 | if (ret) |
112 | goto failed; | |
3a48c4c2 PR |
113 | udelay(1000); |
114 | ||
115 | /* Restore original COR configuration index */ | |
1d5cc192 DB |
116 | ret = pcmcia_write_config_byte(link, CISREG_COR, |
117 | (save_cor & ~COR_SOFT_RESET)); | |
2caff147 DB |
118 | if (ret) |
119 | goto failed; | |
3a48c4c2 PR |
120 | udelay(1000); |
121 | return 0; | |
122 | ||
2caff147 | 123 | failed: |
3a48c4c2 PR |
124 | return -ENODEV; |
125 | } | |
126 | ||
3994d502 | 127 | /********************************************************************/ |
933d5943 | 128 | /* Device methods */ |
3994d502 | 129 | /********************************************************************/ |
3a48c4c2 | 130 | |
3a48c4c2 | 131 | static int |
3994d502 | 132 | spectrum_cs_hard_reset(struct orinoco_private *priv) |
3a48c4c2 | 133 | { |
3994d502 DK |
134 | struct orinoco_pccard *card = priv->card; |
135 | struct pcmcia_device *link = card->p_dev; | |
3a48c4c2 | 136 | |
3994d502 DK |
137 | /* Soft reset using COR and HCR */ |
138 | spectrum_reset(link, 0); | |
3a48c4c2 PR |
139 | |
140 | return 0; | |
141 | } | |
142 | ||
3a48c4c2 | 143 | static int |
3994d502 | 144 | spectrum_cs_stop_firmware(struct orinoco_private *priv, int idle) |
3a48c4c2 PR |
145 | { |
146 | struct orinoco_pccard *card = priv->card; | |
fba395ee | 147 | struct pcmcia_device *link = card->p_dev; |
3a48c4c2 | 148 | |
3994d502 | 149 | return spectrum_reset(link, idle); |
3a48c4c2 PR |
150 | } |
151 | ||
152 | /********************************************************************/ | |
933d5943 | 153 | /* PCMCIA stuff */ |
3a48c4c2 PR |
154 | /********************************************************************/ |
155 | ||
f8cfa618 | 156 | static int |
15b99ac1 | 157 | spectrum_cs_probe(struct pcmcia_device *link) |
3a48c4c2 | 158 | { |
3a48c4c2 PR |
159 | struct orinoco_private *priv; |
160 | struct orinoco_pccard *card; | |
3a48c4c2 | 161 | |
dd2e5a15 | 162 | priv = alloc_orinocodev(sizeof(*card), &link->dev, |
a2608362 DK |
163 | spectrum_cs_hard_reset, |
164 | spectrum_cs_stop_firmware); | |
165 | if (!priv) | |
f8cfa618 | 166 | return -ENOMEM; |
3a48c4c2 PR |
167 | card = priv->card; |
168 | ||
169 | /* Link both structures together */ | |
fba395ee | 170 | card->p_dev = link; |
a2608362 | 171 | link->priv = priv; |
3a48c4c2 | 172 | |
15b99ac1 | 173 | return spectrum_cs_config(link); |
3a48c4c2 PR |
174 | } /* spectrum_cs_attach */ |
175 | ||
fba395ee | 176 | static void spectrum_cs_detach(struct pcmcia_device *link) |
3a48c4c2 | 177 | { |
a2608362 | 178 | struct orinoco_private *priv = link->priv; |
3a48c4c2 | 179 | |
c7c2fa07 | 180 | orinoco_if_del(priv); |
e4f4f98e | 181 | |
e2d40963 | 182 | spectrum_cs_release(link); |
3a48c4c2 | 183 | |
a2608362 | 184 | free_orinocodev(priv); |
3a48c4c2 PR |
185 | } /* spectrum_cs_detach */ |
186 | ||
b54bf94b | 187 | static int spectrum_cs_config_check(struct pcmcia_device *p_dev, |
b54bf94b DB |
188 | void *priv_data) |
189 | { | |
00990e7c DB |
190 | if (p_dev->config_index == 0) |
191 | return -EINVAL; | |
b54bf94b | 192 | |
00990e7c | 193 | return pcmcia_request_io(p_dev); |
b54bf94b DB |
194 | }; |
195 | ||
15b99ac1 | 196 | static int |
fba395ee | 197 | spectrum_cs_config(struct pcmcia_device *link) |
3a48c4c2 | 198 | { |
a2608362 | 199 | struct orinoco_private *priv = link->priv; |
933d5943 | 200 | struct hermes *hw = &priv->hw; |
2caff147 | 201 | int ret; |
3a48c4c2 PR |
202 | void __iomem *mem; |
203 | ||
00990e7c DB |
204 | link->config_flags |= CONF_AUTO_SET_VPP | CONF_AUTO_CHECK_VCC | |
205 | CONF_AUTO_SET_IO | CONF_ENABLE_IRQ; | |
440eed43 DB |
206 | if (ignore_cis_vcc) |
207 | link->config_flags &= ~CONF_AUTO_CHECK_VCC; | |
2caff147 DB |
208 | ret = pcmcia_loop_config(link, spectrum_cs_config_check, NULL); |
209 | if (ret) { | |
b54bf94b | 210 | if (!ignore_cis_vcc) |
3a48c4c2 PR |
211 | printk(KERN_ERR PFX "GetNextTuple(): No matching " |
212 | "CIS configuration. Maybe you need the " | |
213 | "ignore_cis_vcc=1 parameter.\n"); | |
b54bf94b | 214 | goto failed; |
3a48c4c2 PR |
215 | } |
216 | ||
9a017a91 DB |
217 | mem = ioport_map(link->resource[0]->start, |
218 | resource_size(link->resource[0])); | |
3a48c4c2 | 219 | if (!mem) |
2caff147 | 220 | goto failed; |
3a48c4c2 | 221 | |
229bd792 DK |
222 | /* We initialize the hermes structure before completing PCMCIA |
223 | * configuration just in case the interrupt handler gets | |
224 | * called. */ | |
3a48c4c2 | 225 | hermes_struct_init(hw, mem, HERMES_16BIT_REGSPACING); |
07cefe7a | 226 | hw->eeprom_pda = true; |
3a48c4c2 | 227 | |
229bd792 DK |
228 | ret = pcmcia_request_irq(link, orinoco_interrupt); |
229 | if (ret) | |
230 | goto failed; | |
231 | ||
1ac71e5a | 232 | ret = pcmcia_enable_device(link); |
2caff147 DB |
233 | if (ret) |
234 | goto failed; | |
3a48c4c2 | 235 | |
3994d502 | 236 | /* Reset card */ |
d14c7c1d | 237 | if (spectrum_cs_hard_reset(priv) != 0) |
3a48c4c2 | 238 | goto failed; |
3a48c4c2 | 239 | |
8e638267 DK |
240 | /* Initialise the main driver */ |
241 | if (orinoco_init(priv) != 0) { | |
242 | printk(KERN_ERR PFX "orinoco_init() failed\n"); | |
243 | goto failed; | |
244 | } | |
245 | ||
5381956b | 246 | /* Register an interface with the stack */ |
9a017a91 | 247 | if (orinoco_if_add(priv, link->resource[0]->start, |
f8965467 | 248 | link->irq, NULL) != 0) { |
5381956b | 249 | printk(KERN_ERR PFX "orinoco_if_add() failed\n"); |
3a48c4c2 PR |
250 | goto failed; |
251 | } | |
252 | ||
15b99ac1 | 253 | return 0; |
3a48c4c2 | 254 | |
3a48c4c2 PR |
255 | failed: |
256 | spectrum_cs_release(link); | |
15b99ac1 | 257 | return -ENODEV; |
3a48c4c2 PR |
258 | } /* spectrum_cs_config */ |
259 | ||
3a48c4c2 | 260 | static void |
fba395ee | 261 | spectrum_cs_release(struct pcmcia_device *link) |
3a48c4c2 | 262 | { |
a2608362 | 263 | struct orinoco_private *priv = link->priv; |
3a48c4c2 PR |
264 | unsigned long flags; |
265 | ||
266 | /* We're committed to taking the device away now, so mark the | |
267 | * hardware as unavailable */ | |
bcad6e80 | 268 | priv->hw.ops->lock_irqsave(&priv->lock, &flags); |
3a48c4c2 | 269 | priv->hw_unavailable++; |
bcad6e80 | 270 | priv->hw.ops->unlock_irqrestore(&priv->lock, &flags); |
3a48c4c2 | 271 | |
fba395ee | 272 | pcmcia_disable_device(link); |
3a48c4c2 PR |
273 | if (priv->hw.iobase) |
274 | ioport_unmap(priv->hw.iobase); | |
275 | } /* spectrum_cs_release */ | |
276 | ||
98e4c28b DB |
277 | |
278 | static int | |
fba395ee | 279 | spectrum_cs_suspend(struct pcmcia_device *link) |
98e4c28b | 280 | { |
a2608362 | 281 | struct orinoco_private *priv = link->priv; |
98e4c28b DB |
282 | int err = 0; |
283 | ||
98e4c28b | 284 | /* Mark the device as stopped, to block IO until later */ |
6415f7df | 285 | orinoco_down(priv); |
98e4c28b | 286 | |
6cbaa330 | 287 | return err; |
98e4c28b DB |
288 | } |
289 | ||
290 | static int | |
fba395ee | 291 | spectrum_cs_resume(struct pcmcia_device *link) |
98e4c28b | 292 | { |
a2608362 | 293 | struct orinoco_private *priv = link->priv; |
6415f7df | 294 | int err = orinoco_up(priv); |
ac7cafd7 | 295 | |
6415f7df | 296 | return err; |
98e4c28b DB |
297 | } |
298 | ||
3a48c4c2 PR |
299 | |
300 | /********************************************************************/ | |
301 | /* Module initialization */ | |
302 | /********************************************************************/ | |
303 | ||
25f8f54f | 304 | static const struct pcmcia_device_id spectrum_cs_ids[] = { |
4ebe2eb0 | 305 | PCMCIA_DEVICE_MANF_CARD(0x026c, 0x0001), /* Symbol Spectrum24 LA4137 */ |
3a48c4c2 | 306 | PCMCIA_DEVICE_MANF_CARD(0x0104, 0x0001), /* Socket Communications CF */ |
9c8a11d7 | 307 | PCMCIA_DEVICE_PROD_ID12("Intel", "PRO/Wireless LAN PC Card", 0x816cc815, 0x6fbf459a), /* 2011B, not 2011 */ |
3a48c4c2 PR |
308 | PCMCIA_DEVICE_NULL, |
309 | }; | |
310 | MODULE_DEVICE_TABLE(pcmcia, spectrum_cs_ids); | |
311 | ||
312 | static struct pcmcia_driver orinoco_driver = { | |
313 | .owner = THIS_MODULE, | |
2e9b981a | 314 | .name = DRIVER_NAME, |
15b99ac1 | 315 | .probe = spectrum_cs_probe, |
cc3b4866 | 316 | .remove = spectrum_cs_detach, |
98e4c28b DB |
317 | .suspend = spectrum_cs_suspend, |
318 | .resume = spectrum_cs_resume, | |
3a48c4c2 PR |
319 | .id_table = spectrum_cs_ids, |
320 | }; | |
321 | ||
322 | static int __init | |
323 | init_spectrum_cs(void) | |
324 | { | |
3a48c4c2 PR |
325 | return pcmcia_register_driver(&orinoco_driver); |
326 | } | |
327 | ||
328 | static void __exit | |
329 | exit_spectrum_cs(void) | |
330 | { | |
331 | pcmcia_unregister_driver(&orinoco_driver); | |
3a48c4c2 PR |
332 | } |
333 | ||
334 | module_init(init_spectrum_cs); | |
335 | module_exit(exit_spectrum_cs); |