spectrum_cs.c 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336
  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. #define DRIVER_NAME "spectrum_cs"
  21. #define PFX DRIVER_NAME ": "
  22. #include <linux/module.h>
  23. #include <linux/kernel.h>
  24. #include <linux/init.h>
  25. #include <linux/delay.h>
  26. #include <pcmcia/cistpl.h>
  27. #include <pcmcia/cisreg.h>
  28. #include <pcmcia/ds.h>
  29. #include "orinoco.h"
  30. /********************************************************************/
  31. /* Module stuff */
  32. /********************************************************************/
  33. MODULE_AUTHOR("Pavel Roskin <proski@gnu.org>");
  34. MODULE_DESCRIPTION("Driver for Symbol Spectrum24 Trilogy cards with firmware downloader");
  35. MODULE_LICENSE("Dual MPL/GPL");
  36. /* Module parameters */
  37. /* Some D-Link cards have buggy CIS. They do work at 5v properly, but
  38. * don't have any CIS entry for it. This workaround it... */
  39. static int ignore_cis_vcc; /* = 0 */
  40. module_param(ignore_cis_vcc, int, 0);
  41. MODULE_PARM_DESC(ignore_cis_vcc, "Allow voltage mismatch between card and socket");
  42. /********************************************************************/
  43. /* Data structures */
  44. /********************************************************************/
  45. /* PCMCIA specific device information (goes in the card field of
  46. * struct orinoco_private */
  47. struct orinoco_pccard {
  48. struct pcmcia_device *p_dev;
  49. };
  50. /********************************************************************/
  51. /* Function prototypes */
  52. /********************************************************************/
  53. static int spectrum_cs_config(struct pcmcia_device *link);
  54. static void spectrum_cs_release(struct pcmcia_device *link);
  55. /* Constants for the CISREG_CCSR register */
  56. #define HCR_RUN 0x07 /* run firmware after reset */
  57. #define HCR_IDLE 0x0E /* don't run firmware after reset */
  58. #define HCR_MEM16 0x10 /* memory width bit, should be preserved */
  59. /*
  60. * Reset the card using configuration registers COR and CCSR.
  61. * If IDLE is 1, stop the firmware, so that it can be safely rewritten.
  62. */
  63. static int
  64. spectrum_reset(struct pcmcia_device *link, int idle)
  65. {
  66. int ret;
  67. u8 save_cor;
  68. u8 ccsr;
  69. /* Doing it if hardware is gone is guaranteed crash */
  70. if (!pcmcia_dev_present(link))
  71. return -ENODEV;
  72. /* Save original COR value */
  73. ret = pcmcia_read_config_byte(link, CISREG_COR, &save_cor);
  74. if (ret)
  75. goto failed;
  76. /* Soft-Reset card */
  77. ret = pcmcia_write_config_byte(link, CISREG_COR,
  78. (save_cor | COR_SOFT_RESET));
  79. if (ret)
  80. goto failed;
  81. udelay(1000);
  82. /* Read CCSR */
  83. ret = pcmcia_read_config_byte(link, CISREG_CCSR, &ccsr);
  84. if (ret)
  85. goto failed;
  86. /*
  87. * Start or stop the firmware. Memory width bit should be
  88. * preserved from the value we've just read.
  89. */
  90. ccsr = (idle ? HCR_IDLE : HCR_RUN) | (ccsr & HCR_MEM16);
  91. ret = pcmcia_write_config_byte(link, CISREG_CCSR, ccsr);
  92. if (ret)
  93. goto failed;
  94. udelay(1000);
  95. /* Restore original COR configuration index */
  96. ret = pcmcia_write_config_byte(link, CISREG_COR,
  97. (save_cor & ~COR_SOFT_RESET));
  98. if (ret)
  99. goto failed;
  100. udelay(1000);
  101. return 0;
  102. failed:
  103. return -ENODEV;
  104. }
  105. /********************************************************************/
  106. /* Device methods */
  107. /********************************************************************/
  108. static int
  109. spectrum_cs_hard_reset(struct orinoco_private *priv)
  110. {
  111. struct orinoco_pccard *card = priv->card;
  112. struct pcmcia_device *link = card->p_dev;
  113. /* Soft reset using COR and HCR */
  114. spectrum_reset(link, 0);
  115. return 0;
  116. }
  117. static int
  118. spectrum_cs_stop_firmware(struct orinoco_private *priv, int idle)
  119. {
  120. struct orinoco_pccard *card = priv->card;
  121. struct pcmcia_device *link = card->p_dev;
  122. return spectrum_reset(link, idle);
  123. }
  124. /********************************************************************/
  125. /* PCMCIA stuff */
  126. /********************************************************************/
  127. static int
  128. spectrum_cs_probe(struct pcmcia_device *link)
  129. {
  130. struct orinoco_private *priv;
  131. struct orinoco_pccard *card;
  132. priv = alloc_orinocodev(sizeof(*card), &link->dev,
  133. spectrum_cs_hard_reset,
  134. spectrum_cs_stop_firmware);
  135. if (!priv)
  136. return -ENOMEM;
  137. card = priv->card;
  138. /* Link both structures together */
  139. card->p_dev = link;
  140. link->priv = priv;
  141. return spectrum_cs_config(link);
  142. } /* spectrum_cs_attach */
  143. static void spectrum_cs_detach(struct pcmcia_device *link)
  144. {
  145. struct orinoco_private *priv = link->priv;
  146. orinoco_if_del(priv);
  147. spectrum_cs_release(link);
  148. free_orinocodev(priv);
  149. } /* spectrum_cs_detach */
  150. static int spectrum_cs_config_check(struct pcmcia_device *p_dev,
  151. void *priv_data)
  152. {
  153. if (p_dev->config_index == 0)
  154. return -EINVAL;
  155. return pcmcia_request_io(p_dev);
  156. };
  157. static int
  158. spectrum_cs_config(struct pcmcia_device *link)
  159. {
  160. struct orinoco_private *priv = link->priv;
  161. struct hermes *hw = &priv->hw;
  162. int ret;
  163. void __iomem *mem;
  164. link->config_flags |= CONF_AUTO_SET_VPP | CONF_AUTO_CHECK_VCC |
  165. CONF_AUTO_SET_IO | CONF_ENABLE_IRQ;
  166. if (ignore_cis_vcc)
  167. link->config_flags &= ~CONF_AUTO_CHECK_VCC;
  168. ret = pcmcia_loop_config(link, spectrum_cs_config_check, NULL);
  169. if (ret) {
  170. if (!ignore_cis_vcc)
  171. printk(KERN_ERR PFX "GetNextTuple(): No matching "
  172. "CIS configuration. Maybe you need the "
  173. "ignore_cis_vcc=1 parameter.\n");
  174. goto failed;
  175. }
  176. mem = ioport_map(link->resource[0]->start,
  177. resource_size(link->resource[0]));
  178. if (!mem)
  179. goto failed;
  180. /* We initialize the hermes structure before completing PCMCIA
  181. * configuration just in case the interrupt handler gets
  182. * called. */
  183. hermes_struct_init(hw, mem, HERMES_16BIT_REGSPACING);
  184. hw->eeprom_pda = true;
  185. ret = pcmcia_request_irq(link, orinoco_interrupt);
  186. if (ret)
  187. goto failed;
  188. ret = pcmcia_enable_device(link);
  189. if (ret)
  190. goto failed;
  191. /* Reset card */
  192. if (spectrum_cs_hard_reset(priv) != 0)
  193. goto failed;
  194. /* Initialise the main driver */
  195. if (orinoco_init(priv) != 0) {
  196. printk(KERN_ERR PFX "orinoco_init() failed\n");
  197. goto failed;
  198. }
  199. /* Register an interface with the stack */
  200. if (orinoco_if_add(priv, link->resource[0]->start,
  201. link->irq, NULL) != 0) {
  202. printk(KERN_ERR PFX "orinoco_if_add() failed\n");
  203. goto failed;
  204. }
  205. return 0;
  206. failed:
  207. spectrum_cs_release(link);
  208. return -ENODEV;
  209. } /* spectrum_cs_config */
  210. static void
  211. spectrum_cs_release(struct pcmcia_device *link)
  212. {
  213. struct orinoco_private *priv = link->priv;
  214. unsigned long flags;
  215. /* We're committed to taking the device away now, so mark the
  216. * hardware as unavailable */
  217. priv->hw.ops->lock_irqsave(&priv->lock, &flags);
  218. priv->hw_unavailable++;
  219. priv->hw.ops->unlock_irqrestore(&priv->lock, &flags);
  220. pcmcia_disable_device(link);
  221. if (priv->hw.iobase)
  222. ioport_unmap(priv->hw.iobase);
  223. } /* spectrum_cs_release */
  224. static int
  225. spectrum_cs_suspend(struct pcmcia_device *link)
  226. {
  227. struct orinoco_private *priv = link->priv;
  228. int err = 0;
  229. /* Mark the device as stopped, to block IO until later */
  230. orinoco_down(priv);
  231. return err;
  232. }
  233. static int
  234. spectrum_cs_resume(struct pcmcia_device *link)
  235. {
  236. struct orinoco_private *priv = link->priv;
  237. int err = orinoco_up(priv);
  238. return err;
  239. }
  240. /********************************************************************/
  241. /* Module initialization */
  242. /********************************************************************/
  243. static const struct pcmcia_device_id spectrum_cs_ids[] = {
  244. PCMCIA_DEVICE_MANF_CARD(0x026c, 0x0001), /* Symbol Spectrum24 LA4137 */
  245. PCMCIA_DEVICE_MANF_CARD(0x0104, 0x0001), /* Socket Communications CF */
  246. PCMCIA_DEVICE_PROD_ID12("Intel", "PRO/Wireless LAN PC Card", 0x816cc815, 0x6fbf459a), /* 2011B, not 2011 */
  247. PCMCIA_DEVICE_NULL,
  248. };
  249. MODULE_DEVICE_TABLE(pcmcia, spectrum_cs_ids);
  250. static struct pcmcia_driver orinoco_driver = {
  251. .owner = THIS_MODULE,
  252. .name = DRIVER_NAME,
  253. .probe = spectrum_cs_probe,
  254. .remove = spectrum_cs_detach,
  255. .suspend = spectrum_cs_suspend,
  256. .resume = spectrum_cs_resume,
  257. .id_table = spectrum_cs_ids,
  258. };
  259. static int __init
  260. init_spectrum_cs(void)
  261. {
  262. return pcmcia_register_driver(&orinoco_driver);
  263. }
  264. static void __exit
  265. exit_spectrum_cs(void)
  266. {
  267. pcmcia_unregister_driver(&orinoco_driver);
  268. }
  269. module_init(init_spectrum_cs);
  270. module_exit(exit_spectrum_cs);