3 * Driver for Prism 2.5/3 devices that have a direct PCI interface
4 * (i.e. these are not PCMCIA cards in a PCMCIA-to-PCI bridge).
5 * The card contains only one PCI region, which contains all the usual
6 * hermes registers, as well as the COR register.
8 * Current maintainers are:
9 * Pavel Roskin <proski AT gnu.org>
10 * and David Gibson <hermes AT gibson.dropbear.id.au>
12 * Some of this code is borrowed from orinoco_plx.c
13 * Copyright (C) 2001 Daniel Barlow <dan AT telent.net>
14 * Some of this code is "inspired" by linux-wlan-ng-0.1.10, but nothing
15 * has been copied from it. linux-wlan-ng-0.1.10 is originally :
16 * Copyright (C) 1999 AbsoluteValue Systems, Inc. All Rights Reserved.
17 * This file originally written by:
18 * Copyright (C) 2001 Jean Tourrilhes <jt AT hpl.hp.com>
19 * And is now maintained by:
20 * (C) Copyright David Gibson, IBM Corp. 2002-2003.
22 * The contents of this file are subject to the Mozilla Public License
23 * Version 1.1 (the "License"); you may not use this file except in
24 * compliance with the License. You may obtain a copy of the License
25 * at http://www.mozilla.org/MPL/
27 * Software distributed under the License is distributed on an "AS IS"
28 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
29 * the License for the specific language governing rights and
30 * limitations under the License.
32 * Alternatively, the contents of this file may be used under the
33 * terms of the GNU General Public License version 2 (the "GPL"), in
34 * which case the provisions of the GPL are applicable instead of the
35 * above. If you wish to allow the use of your version of this file
36 * only under the terms of the GPL and not to allow others to use your
37 * version of this file under the MPL, indicate your decision by
38 * deleting the provisions above and replace them with the notice and
39 * other provisions required by the GPL. If you do not delete the
40 * provisions above, a recipient may use your version of this file
41 * under either the MPL or the GPL.
44 #define DRIVER_NAME "orinoco_pci"
45 #define PFX DRIVER_NAME ": "
47 #include <linux/module.h>
48 #include <linux/kernel.h>
49 #include <linux/init.h>
50 #include <linux/delay.h>
51 #include <linux/pci.h>
54 #include "orinoco_pci.h"
56 /* Offset of the COR register of the PCI card */
57 #define HERMES_PCI_COR (0x26)
59 /* Bitmask to reset the card */
60 #define HERMES_PCI_COR_MASK (0x0080)
62 /* Magic timeouts for doing the reset.
63 * Those times are straight from wlan-ng, and it is claimed that they
64 * are necessary. Alan will kill me. Take your time and grab a coffee. */
65 #define HERMES_PCI_COR_ONT (250) /* ms */
66 #define HERMES_PCI_COR_OFFT (500) /* ms */
67 #define HERMES_PCI_COR_BUSYT (500) /* ms */
70 * Do a soft reset of the card using the Configuration Option Register
71 * We need this to get going...
72 * This is the part of the code that is strongly inspired from wlan-ng
74 * Note : This code is done with irq enabled. This mean that many
75 * interrupts will occur while we are there. This is why we use the
76 * jiffies to regulate time instead of a straight mdelay(). Usually we
77 * need only around 245 iteration of the loop to do 250 ms delay.
79 * Note bis : Don't try to access HERMES_CMD during the reset phase.
80 * It just won't work !
82 static int orinoco_pci_cor_reset(struct orinoco_private *priv)
84 hermes_t *hw = &priv->hw;
85 unsigned long timeout;
88 /* Assert the reset until the card notices */
89 hermes_write_regn(hw, PCI_COR, HERMES_PCI_COR_MASK);
90 mdelay(HERMES_PCI_COR_ONT);
92 /* Give time for the card to recover from this hard effort */
93 hermes_write_regn(hw, PCI_COR, 0x0000);
94 mdelay(HERMES_PCI_COR_OFFT);
96 /* The card is ready when it's no longer busy */
97 timeout = jiffies + (HERMES_PCI_COR_BUSYT * HZ / 1000);
98 reg = hermes_read_regn(hw, CMD);
99 while (time_before(jiffies, timeout) && (reg & HERMES_CMD_BUSY)) {
101 reg = hermes_read_regn(hw, CMD);
105 if (reg & HERMES_CMD_BUSY) {
106 printk(KERN_ERR PFX "Busy timeout\n");
113 static int orinoco_pci_init_one(struct pci_dev *pdev,
114 const struct pci_device_id *ent)
117 struct orinoco_private *priv;
118 struct orinoco_pci_card *card;
119 struct net_device *dev;
120 void __iomem *hermes_io;
122 err = pci_enable_device(pdev);
124 printk(KERN_ERR PFX "Cannot enable PCI device\n");
128 err = pci_request_regions(pdev, DRIVER_NAME);
130 printk(KERN_ERR PFX "Cannot obtain PCI resources\n");
134 hermes_io = pci_iomap(pdev, 0, 0);
136 printk(KERN_ERR PFX "Cannot remap chipset registers\n");
138 goto fail_map_hermes;
141 /* Allocate network device */
142 dev = alloc_orinocodev(sizeof(*card), orinoco_pci_cor_reset);
144 printk(KERN_ERR PFX "Cannot allocate network device\n");
149 priv = netdev_priv(dev);
151 SET_MODULE_OWNER(dev);
152 SET_NETDEV_DEV(dev, &pdev->dev);
154 hermes_struct_init(&priv->hw, hermes_io, HERMES_32BIT_REGSPACING);
156 err = request_irq(pdev->irq, orinoco_interrupt, IRQF_SHARED,
159 printk(KERN_ERR PFX "Cannot allocate IRQ %d\n", pdev->irq);
164 err = orinoco_pci_cor_reset(priv);
166 printk(KERN_ERR PFX "Initial reset failed\n");
170 err = register_netdev(dev);
172 printk(KERN_ERR PFX "Cannot register network device\n");
176 pci_set_drvdata(pdev, dev);
177 printk(KERN_DEBUG "%s: " DRIVER_NAME " at %s\n", dev->name,
183 free_irq(pdev->irq, dev);
186 pci_set_drvdata(pdev, NULL);
187 free_orinocodev(dev);
190 pci_iounmap(pdev, hermes_io);
193 pci_release_regions(pdev);
196 pci_disable_device(pdev);
201 static void __devexit orinoco_pci_remove_one(struct pci_dev *pdev)
203 struct net_device *dev = pci_get_drvdata(pdev);
204 struct orinoco_private *priv = netdev_priv(dev);
206 unregister_netdev(dev);
207 free_irq(pdev->irq, dev);
208 pci_set_drvdata(pdev, NULL);
209 free_orinocodev(dev);
210 pci_iounmap(pdev, priv->hw.iobase);
211 pci_release_regions(pdev);
212 pci_disable_device(pdev);
215 static struct pci_device_id orinoco_pci_id_table[] = {
216 /* Intersil Prism 3 */
217 {0x1260, 0x3872, PCI_ANY_ID, PCI_ANY_ID,},
218 /* Intersil Prism 2.5 */
219 {0x1260, 0x3873, PCI_ANY_ID, PCI_ANY_ID,},
220 /* Samsung MagicLAN SWL-2210P */
221 {0x167d, 0xa000, PCI_ANY_ID, PCI_ANY_ID,},
225 MODULE_DEVICE_TABLE(pci, orinoco_pci_id_table);
227 static struct pci_driver orinoco_pci_driver = {
229 .id_table = orinoco_pci_id_table,
230 .probe = orinoco_pci_init_one,
231 .remove = __devexit_p(orinoco_pci_remove_one),
232 .suspend = orinoco_pci_suspend,
233 .resume = orinoco_pci_resume,
236 static char version[] __initdata = DRIVER_NAME " " DRIVER_VERSION
237 " (Pavel Roskin <proski@gnu.org>,"
238 " David Gibson <hermes@gibson.dropbear.id.au> &"
239 " Jean Tourrilhes <jt@hpl.hp.com>)";
240 MODULE_AUTHOR("Pavel Roskin <proski@gnu.org> & David Gibson <hermes@gibson.dropbear.id.au>");
241 MODULE_DESCRIPTION("Driver for wireless LAN cards using direct PCI interface");
242 MODULE_LICENSE("Dual MPL/GPL");
244 static int __init orinoco_pci_init(void)
246 printk(KERN_DEBUG "%s\n", version);
247 return pci_module_init(&orinoco_pci_driver);
250 static void __exit orinoco_pci_exit(void)
252 pci_unregister_driver(&orinoco_pci_driver);
255 module_init(orinoco_pci_init);
256 module_exit(orinoco_pci_exit);