Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
wl_cs.c
Go to the documentation of this file.
1 /*******************************************************************************
2  * Agere Systems Inc.
3  * Wireless device driver for Linux (wlags49).
4  *
5  * Copyright (c) 1998-2003 Agere Systems Inc.
6  * All rights reserved.
7  * http://www.agere.com
8  *
9  * Initially developed by TriplePoint, Inc.
10  * http://www.triplepoint.com
11  *
12  *------------------------------------------------------------------------------
13  *
14  * This file contains processing and initialization specific to Card Services
15  * devices (PCMCIA, CF).
16  *
17  *------------------------------------------------------------------------------
18  *
19  * SOFTWARE LICENSE
20  *
21  * This software is provided subject to the following terms and conditions,
22  * which you should read carefully before using the software. Using this
23  * software indicates your acceptance of these terms and conditions. If you do
24  * not agree with these terms and conditions, do not use the software.
25  *
26  * Copyright (c) 2003 Agere Systems Inc.
27  * All rights reserved.
28  *
29  * Redistribution and use in source or binary forms, with or without
30  * modifications, are permitted provided that the following conditions are met:
31  *
32  * . Redistributions of source code must retain the above copyright notice, this
33  * list of conditions and the following Disclaimer as comments in the code as
34  * well as in the documentation and/or other materials provided with the
35  * distribution.
36  *
37  * . Redistributions in binary form must reproduce the above copyright notice,
38  * this list of conditions and the following Disclaimer in the documentation
39  * and/or other materials provided with the distribution.
40  *
41  * . Neither the name of Agere Systems Inc. nor the names of the contributors
42  * may be used to endorse or promote products derived from this software
43  * without specific prior written permission.
44  *
45  * Disclaimer
46  *
47  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
48  * INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
49  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ANY
50  * USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
51  * RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
52  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
53  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
54  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
55  * ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
56  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
57  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
58  * DAMAGE.
59  *
60  ******************************************************************************/
61 
62 /*******************************************************************************
63  * include files
64  ******************************************************************************/
65 #include <wl_version.h>
66 
67 #include <linux/kernel.h>
68 #include <linux/sched.h>
69 #include <linux/ptrace.h>
70 #include <linux/ctype.h>
71 #include <linux/string.h>
72 #include <linux/timer.h>
73 #include <linux/interrupt.h>
74 #include <linux/in.h>
75 #include <linux/delay.h>
76 #include <asm/io.h>
77 #include <asm/bitops.h>
78 
79 #include <linux/netdevice.h>
80 #include <linux/etherdevice.h>
81 #include <linux/skbuff.h>
82 #include <linux/if_arp.h>
83 #include <linux/ioport.h>
84 #include <linux/module.h>
85 
86 #include <pcmcia/cistpl.h>
87 #include <pcmcia/cisreg.h>
88 #include <pcmcia/ciscode.h>
89 #include <pcmcia/ds.h>
90 #include <debug.h>
91 
92 #include <hcf.h>
93 #include <dhf.h>
94 #include <hcfdef.h>
95 
96 #include <wl_if.h>
97 #include <wl_internal.h>
98 #include <wl_util.h>
99 #include <wl_main.h>
100 #include <wl_netdev.h>
101 #include <wl_cs.h>
102 #include <wl_sysfs.h>
103 
104 
105 /*******************************************************************************
106  * global definitions
107  ******************************************************************************/
108 #if DBG
109 extern dbg_info_t *DbgInfo;
110 #endif /* DBG */
111 
112 
113 /*******************************************************************************
114  * wl_adapter_attach()
115  *******************************************************************************
116  *
117  * DESCRIPTION:
118  *
119  * Creates an instance of the driver, allocating local data structures for
120  * one device. The device is registered with Card Services.
121  *
122  * PARAMETERS:
123  *
124  * none
125  *
126  * RETURNS:
127  *
128  * pointer to an allocated dev_link_t structure
129  * NULL on failure
130  *
131  ******************************************************************************/
132 static int wl_adapter_attach(struct pcmcia_device *link)
133 {
134  struct net_device *dev;
135  struct wl_private *lp;
136  /*--------------------------------------------------------------------*/
137 
138  DBG_FUNC("wl_adapter_attach");
139  DBG_ENTER(DbgInfo);
140 
141  dev = wl_device_alloc();
142  if (dev == NULL) {
143  DBG_ERROR(DbgInfo, "wl_device_alloc returned NULL\n");
144  return -ENOMEM;
145  }
146 
147  link->resource[0]->end = HCF_NUM_IO_PORTS;
148  link->resource[0]->flags= IO_DATA_PATH_WIDTH_16;
149  link->config_flags |= CONF_ENABLE_IRQ;
150  link->config_index = 5;
151  link->config_regs = PRESENT_OPTION;
152 
153  link->priv = dev;
154  lp = wl_priv(dev);
155  lp->link = link;
156 
157  wl_adapter_insert(link);
158 
159  DBG_LEAVE(DbgInfo);
160  return 0;
161 } /* wl_adapter_attach */
162 /*============================================================================*/
163 
164 
165 
166 static void wl_adapter_detach(struct pcmcia_device *link)
167 {
168  struct net_device *dev = link->priv;
169  /*--------------------------------------------------------------------*/
170 
171  DBG_FUNC("wl_adapter_detach");
172  DBG_ENTER(DbgInfo);
173  DBG_PARAM(DbgInfo, "link", "0x%p", link);
174 
175  wl_adapter_release(link);
176 
177  if (dev) {
179  unregister_netdev(dev);
180  wl_device_dealloc(dev);
181  }
182 
183  DBG_LEAVE(DbgInfo);
184 } /* wl_adapter_detach */
185 /*============================================================================*/
186 
187 
188 void wl_adapter_release(struct pcmcia_device *link)
189 {
190  DBG_FUNC("wl_adapter_release");
191  DBG_ENTER(DbgInfo);
192  DBG_PARAM(DbgInfo, "link", "0x%p", link);
193 
194  /* Stop hardware */
195  wl_remove(link->priv);
196 
197  pcmcia_disable_device(link);
198 
199  DBG_LEAVE(DbgInfo);
200 } /* wl_adapter_release */
201 /*============================================================================*/
202 
203 static int wl_adapter_suspend(struct pcmcia_device *link)
204 {
205  struct net_device *dev = link->priv;
206 
207  /* if (link->open) { */
208  netif_device_detach(dev);
209  wl_suspend(dev);
210  /* CHECK! pcmcia_release_configuration(link->handle); */
211  /* } */
212 
213  return 0;
214 } /* wl_adapter_suspend */
215 
216 static int wl_adapter_resume(struct pcmcia_device *link)
217 {
218  struct net_device *dev = link->priv;
219 
220  wl_resume(dev);
221 
222  netif_device_attach(dev);
223 
224  return 0;
225 } /* wl_adapter_resume */
226 
227 void wl_adapter_insert(struct pcmcia_device *link)
228 {
229  struct net_device *dev;
230  int ret;
231  /*--------------------------------------------------------------------*/
232 
233  DBG_FUNC("wl_adapter_insert");
234  DBG_ENTER(DbgInfo);
235  DBG_PARAM(DbgInfo, "link", "0x%p", link);
236 
237  dev = link->priv;
238 
239  /* Do we need to allocate an interrupt? */
240  link->config_flags |= CONF_ENABLE_IRQ;
241  link->io_lines = 6;
242 
243  ret = pcmcia_request_io(link);
244  if (ret != 0)
245  goto failed;
246 
247  ret = pcmcia_request_irq(link, (void *) wl_isr);
248  if (ret != 0)
249  goto failed;
250 
251  ret = pcmcia_enable_device(link);
252  if (ret != 0)
253  goto failed;
254 
255  dev->irq = link->irq;
256  dev->base_addr = link->resource[0]->start;
257 
258  SET_NETDEV_DEV(dev, &link->dev);
259  if (register_netdev(dev) != 0) {
260  printk("%s: register_netdev() failed\n", MODULE_NAME);
261  goto failed;
262  }
263 
265 
266  printk(KERN_INFO "%s: Wireless, io_addr %#03lx, irq %d, mac_address"
267  " %pM\n", dev->name, dev->base_addr, dev->irq, dev->dev_addr);
268 
269  DBG_LEAVE(DbgInfo);
270  return;
271 
272 failed:
273  wl_adapter_release(link);
274 
275  DBG_LEAVE(DbgInfo);
276  return;
277 } /* wl_adapter_insert */
278 /*============================================================================*/
279 
280 
281 /*******************************************************************************
282  * wl_adapter_open()
283  *******************************************************************************
284  *
285  * DESCRIPTION:
286  *
287  * Open the device.
288  *
289  * PARAMETERS:
290  *
291  * dev - a pointer to a net_device structure representing the network
292  * device to open.
293  *
294  * RETURNS:
295  *
296  * 0 on success
297  * errno value otherwise
298  *
299  ******************************************************************************/
300 int wl_adapter_open(struct net_device *dev)
301 {
302  struct wl_private *lp = wl_priv(dev);
303  struct pcmcia_device *link = lp->link;
304  int result = 0;
305  int hcf_status = HCF_SUCCESS;
306  /*--------------------------------------------------------------------*/
307 
308  DBG_FUNC("wl_adapter_open");
309  DBG_ENTER(DbgInfo);
310  DBG_PRINT("%s\n", VERSION_INFO);
311  DBG_PARAM(DbgInfo, "dev", "%s (0x%p)", dev->name, dev);
312 
313  if (!pcmcia_dev_present(link)) {
314  DBG_LEAVE(DbgInfo);
315  return -ENODEV;
316  }
317 
318  link->open++;
319 
320  hcf_status = wl_open(dev);
321 
322  if (hcf_status != HCF_SUCCESS) {
323  link->open--;
324  result = -ENODEV;
325  }
326 
327  DBG_LEAVE(DbgInfo);
328  return result;
329 } /* wl_adapter_open */
330 /*============================================================================*/
331 
332 
333 /*******************************************************************************
334  * wl_adapter_close()
335  *******************************************************************************
336  *
337  * DESCRIPTION:
338  *
339  * Close the device.
340  *
341  * PARAMETERS:
342  *
343  * dev - a pointer to a net_device structure representing the network
344  * device to close.
345  *
346  * RETURNS:
347  *
348  * 0 on success
349  * errno value otherwise
350  *
351  ******************************************************************************/
352 int wl_adapter_close(struct net_device *dev)
353 {
354  struct wl_private *lp = wl_priv(dev);
355  struct pcmcia_device *link = lp->link;
356  /*--------------------------------------------------------------------*/
357 
358  DBG_FUNC("wl_adapter_close");
359  DBG_ENTER(DbgInfo);
360  DBG_PARAM(DbgInfo, "dev", "%s (0x%p)", dev->name, dev);
361 
362  if (link == NULL) {
363  DBG_LEAVE(DbgInfo);
364  return -ENODEV;
365  }
366 
367  DBG_TRACE(DbgInfo, "%s: Shutting down adapter.\n", dev->name);
368  wl_close(dev);
369 
370  link->open--;
371 
372  DBG_LEAVE(DbgInfo);
373  return 0;
374 } /* wl_adapter_close */
375 /*============================================================================*/
376 
377 static const struct pcmcia_device_id wl_adapter_ids[] = {
378 #if !((HCF_TYPE) & HCF_TYPE_HII5)
379  PCMCIA_DEVICE_MANF_CARD(0x0156, 0x0003),
380  PCMCIA_DEVICE_PROD_ID12("Agere Systems", "Wireless PC Card Model 0110",
381  0x33103a9b, 0xe175b0dd),
382 #else
383  PCMCIA_DEVICE_MANF_CARD(0x0156, 0x0004),
384  PCMCIA_DEVICE_PROD_ID12("Linksys", "WCF54G_Wireless-G_CompactFlash_Card",
385  0x0733cc81, 0x98a599e1),
386 #endif /* (HCF_TYPE) & HCF_TYPE_HII5 */
387  PCMCIA_DEVICE_NULL,
388 };
389 MODULE_DEVICE_TABLE(pcmcia, wl_adapter_ids);
390 
391 static struct pcmcia_driver wlags49_driver = {
392  .owner = THIS_MODULE,
393  .name = DRIVER_NAME,
394  .probe = wl_adapter_attach,
395  .remove = wl_adapter_detach,
396  .id_table = wl_adapter_ids,
397  .suspend = wl_adapter_suspend,
398  .resume = wl_adapter_resume,
399 };
400 
401 
402 
403 /*******************************************************************************
404  * wl_adapter_init_module()
405  *******************************************************************************
406  *
407  * DESCRIPTION:
408  *
409  * Called by init_module() to perform PCMCIA driver initialization.
410  *
411  * PARAMETERS:
412  *
413  * N/A
414  *
415  * RETURNS:
416  *
417  * 0 on success
418  * -1 on error
419  *
420  ******************************************************************************/
422 {
423  int ret;
424  /*--------------------------------------------------------------------*/
425 
426  DBG_FUNC("wl_adapter_init_module");
427  DBG_ENTER(DbgInfo);
428  DBG_TRACE(DbgInfo, "wl_adapter_init_module() -- PCMCIA\n");
429 
430  ret = pcmcia_register_driver(&wlags49_driver);
431 
432  DBG_LEAVE(DbgInfo);
433  return ret;
434 } /* wl_adapter_init_module */
435 /*============================================================================*/
436 
437 
438 /*******************************************************************************
439  * wl_adapter_cleanup_module()
440  *******************************************************************************
441  *
442  * DESCRIPTION:
443  *
444  * Called by cleanup_module() to perform driver uninitialization.
445  *
446  * PARAMETERS:
447  *
448  * N/A
449  *
450  * RETURNS:
451  *
452  * N/A
453  *
454  ******************************************************************************/
456 {
457  DBG_FUNC("wl_adapter_cleanup_module");
458  DBG_ENTER(DbgInfo);
459  DBG_TRACE(DbgInfo, "wl_adapter_cleanup_module() -- PCMCIA\n");
460 
461 
462  pcmcia_unregister_driver(&wlags49_driver);
463 
464  DBG_LEAVE(DbgInfo);
465  return;
466 } /* wl_adapter_cleanup_module */
467 /*============================================================================*/
468 
469 
470 /*******************************************************************************
471  * wl_adapter_is_open()
472  *******************************************************************************
473  *
474  * DESCRIPTION:
475  *
476  * Check with Card Services to determine if this device is open.
477  *
478  * PARAMETERS:
479  *
480  * dev - a pointer to the net_device structure whose open status will be
481  * checked
482  *
483  * RETURNS:
484  *
485  * nonzero if device is open
486  * 0 otherwise
487  *
488  ******************************************************************************/
490 {
491  struct wl_private *lp = wl_priv(dev);
492  struct pcmcia_device *link = lp->link;
493 
494  if (!pcmcia_dev_present(link))
495  return 0;
496 
497  return link->open;
498 } /* wl_adapter_is_open */
499 /*============================================================================*/