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