if_usb.c 30 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183
  1. /*
  2. * This file contains functions used in USB interface module.
  3. */
  4. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  5. #include <linux/delay.h>
  6. #include <linux/moduleparam.h>
  7. #include <linux/firmware.h>
  8. #include <linux/netdevice.h>
  9. #include <linux/slab.h>
  10. #include <linux/usb.h>
  11. #ifdef CONFIG_OLPC
  12. #include <asm/olpc.h>
  13. #endif
  14. #define DRV_NAME "usb8xxx"
  15. #include "host.h"
  16. #include "decl.h"
  17. #include "defs.h"
  18. #include "dev.h"
  19. #include "cmd.h"
  20. #include "if_usb.h"
  21. #define INSANEDEBUG 0
  22. #define lbs_deb_usb2(...) do { if (INSANEDEBUG) lbs_deb_usbd(__VA_ARGS__); } while (0)
  23. #define MESSAGE_HEADER_LEN 4
  24. static char *lbs_fw_name = NULL;
  25. module_param_named(fw_name, lbs_fw_name, charp, 0644);
  26. MODULE_FIRMWARE("libertas/usb8388_v9.bin");
  27. MODULE_FIRMWARE("libertas/usb8388_v5.bin");
  28. MODULE_FIRMWARE("libertas/usb8388.bin");
  29. MODULE_FIRMWARE("libertas/usb8682.bin");
  30. MODULE_FIRMWARE("usb8388.bin");
  31. enum {
  32. MODEL_UNKNOWN = 0x0,
  33. MODEL_8388 = 0x1,
  34. MODEL_8682 = 0x2
  35. };
  36. static struct usb_device_id if_usb_table[] = {
  37. /* Enter the device signature inside */
  38. { USB_DEVICE(0x1286, 0x2001), .driver_info = MODEL_8388 },
  39. { USB_DEVICE(0x05a3, 0x8388), .driver_info = MODEL_8388 },
  40. {} /* Terminating entry */
  41. };
  42. MODULE_DEVICE_TABLE(usb, if_usb_table);
  43. static void if_usb_receive(struct urb *urb);
  44. static void if_usb_receive_fwload(struct urb *urb);
  45. static int __if_usb_prog_firmware(struct if_usb_card *cardp,
  46. const char *fwname, int cmd);
  47. static int if_usb_prog_firmware(struct if_usb_card *cardp,
  48. const char *fwname, int cmd);
  49. static int if_usb_host_to_card(struct lbs_private *priv, uint8_t type,
  50. uint8_t *payload, uint16_t nb);
  51. static int usb_tx_block(struct if_usb_card *cardp, uint8_t *payload,
  52. uint16_t nb);
  53. static void if_usb_free(struct if_usb_card *cardp);
  54. static int if_usb_submit_rx_urb(struct if_usb_card *cardp);
  55. static int if_usb_reset_device(struct if_usb_card *cardp);
  56. /* sysfs hooks */
  57. /*
  58. * Set function to write firmware to device's persistent memory
  59. */
  60. static ssize_t if_usb_firmware_set(struct device *dev,
  61. struct device_attribute *attr, const char *buf, size_t count)
  62. {
  63. struct lbs_private *priv = to_net_dev(dev)->ml_priv;
  64. struct if_usb_card *cardp = priv->card;
  65. int ret;
  66. BUG_ON(buf == NULL);
  67. ret = if_usb_prog_firmware(cardp, buf, BOOT_CMD_UPDATE_FW);
  68. if (ret == 0)
  69. return count;
  70. return ret;
  71. }
  72. /*
  73. * lbs_flash_fw attribute to be exported per ethX interface through sysfs
  74. * (/sys/class/net/ethX/lbs_flash_fw). Use this like so to write firmware to
  75. * the device's persistent memory:
  76. * echo usb8388-5.126.0.p5.bin > /sys/class/net/ethX/lbs_flash_fw
  77. */
  78. static DEVICE_ATTR(lbs_flash_fw, 0200, NULL, if_usb_firmware_set);
  79. /**
  80. * if_usb_boot2_set - write firmware to device's persistent memory
  81. *
  82. * @dev: target device
  83. * @attr: device attributes
  84. * @buf: firmware buffer to write
  85. * @count: number of bytes to write
  86. *
  87. * returns: number of bytes written or negative error code
  88. */
  89. static ssize_t if_usb_boot2_set(struct device *dev,
  90. struct device_attribute *attr, const char *buf, size_t count)
  91. {
  92. struct lbs_private *priv = to_net_dev(dev)->ml_priv;
  93. struct if_usb_card *cardp = priv->card;
  94. int ret;
  95. BUG_ON(buf == NULL);
  96. ret = if_usb_prog_firmware(cardp, buf, BOOT_CMD_UPDATE_BOOT2);
  97. if (ret == 0)
  98. return count;
  99. return ret;
  100. }
  101. /*
  102. * lbs_flash_boot2 attribute to be exported per ethX interface through sysfs
  103. * (/sys/class/net/ethX/lbs_flash_boot2). Use this like so to write firmware
  104. * to the device's persistent memory:
  105. * echo usb8388-5.126.0.p5.bin > /sys/class/net/ethX/lbs_flash_boot2
  106. */
  107. static DEVICE_ATTR(lbs_flash_boot2, 0200, NULL, if_usb_boot2_set);
  108. /**
  109. * if_usb_write_bulk_callback - callback function to handle the status
  110. * of the URB
  111. * @urb: pointer to &urb structure
  112. * returns: N/A
  113. */
  114. static void if_usb_write_bulk_callback(struct urb *urb)
  115. {
  116. struct if_usb_card *cardp = (struct if_usb_card *) urb->context;
  117. /* handle the transmission complete validations */
  118. if (urb->status == 0) {
  119. struct lbs_private *priv = cardp->priv;
  120. lbs_deb_usb2(&urb->dev->dev, "URB status is successful\n");
  121. lbs_deb_usb2(&urb->dev->dev, "Actual length transmitted %d\n",
  122. urb->actual_length);
  123. /* Boot commands such as UPDATE_FW and UPDATE_BOOT2 are not
  124. * passed up to the lbs level.
  125. */
  126. if (priv && priv->dnld_sent != DNLD_BOOTCMD_SENT)
  127. lbs_host_to_card_done(priv);
  128. } else {
  129. /* print the failure status number for debug */
  130. pr_info("URB in failure status: %d\n", urb->status);
  131. }
  132. }
  133. /**
  134. * if_usb_free - free tx/rx urb, skb and rx buffer
  135. * @cardp: pointer to &if_usb_card
  136. * returns: N/A
  137. */
  138. static void if_usb_free(struct if_usb_card *cardp)
  139. {
  140. lbs_deb_enter(LBS_DEB_USB);
  141. /* Unlink tx & rx urb */
  142. usb_kill_urb(cardp->tx_urb);
  143. usb_kill_urb(cardp->rx_urb);
  144. usb_free_urb(cardp->tx_urb);
  145. cardp->tx_urb = NULL;
  146. usb_free_urb(cardp->rx_urb);
  147. cardp->rx_urb = NULL;
  148. kfree(cardp->ep_out_buf);
  149. cardp->ep_out_buf = NULL;
  150. lbs_deb_leave(LBS_DEB_USB);
  151. }
  152. static void if_usb_setup_firmware(struct lbs_private *priv)
  153. {
  154. struct if_usb_card *cardp = priv->card;
  155. struct cmd_ds_set_boot2_ver b2_cmd;
  156. struct cmd_ds_802_11_fw_wake_method wake_method;
  157. b2_cmd.hdr.size = cpu_to_le16(sizeof(b2_cmd));
  158. b2_cmd.action = 0;
  159. b2_cmd.version = cardp->boot2_version;
  160. if (lbs_cmd_with_response(priv, CMD_SET_BOOT2_VER, &b2_cmd))
  161. lbs_deb_usb("Setting boot2 version failed\n");
  162. priv->wol_gpio = 2; /* Wake via GPIO2... */
  163. priv->wol_gap = 20; /* ... after 20ms */
  164. lbs_host_sleep_cfg(priv, EHS_WAKE_ON_UNICAST_DATA,
  165. (struct wol_config *) NULL);
  166. wake_method.hdr.size = cpu_to_le16(sizeof(wake_method));
  167. wake_method.action = cpu_to_le16(CMD_ACT_GET);
  168. if (lbs_cmd_with_response(priv, CMD_802_11_FW_WAKE_METHOD, &wake_method)) {
  169. netdev_info(priv->dev, "Firmware does not seem to support PS mode\n");
  170. priv->fwcapinfo &= ~FW_CAPINFO_PS;
  171. } else {
  172. if (le16_to_cpu(wake_method.method) == CMD_WAKE_METHOD_COMMAND_INT) {
  173. lbs_deb_usb("Firmware seems to support PS with wake-via-command\n");
  174. } else {
  175. /* The versions which boot up this way don't seem to
  176. work even if we set it to the command interrupt */
  177. priv->fwcapinfo &= ~FW_CAPINFO_PS;
  178. netdev_info(priv->dev,
  179. "Firmware doesn't wake via command interrupt; disabling PS mode\n");
  180. }
  181. }
  182. }
  183. static void if_usb_fw_timeo(unsigned long priv)
  184. {
  185. struct if_usb_card *cardp = (void *)priv;
  186. if (cardp->fwdnldover) {
  187. lbs_deb_usb("Download complete, no event. Assuming success\n");
  188. } else {
  189. pr_err("Download timed out\n");
  190. cardp->surprise_removed = 1;
  191. }
  192. wake_up(&cardp->fw_wq);
  193. }
  194. #ifdef CONFIG_OLPC
  195. static void if_usb_reset_olpc_card(struct lbs_private *priv)
  196. {
  197. printk(KERN_CRIT "Resetting OLPC wireless via EC...\n");
  198. olpc_ec_cmd(0x25, NULL, 0, NULL, 0);
  199. }
  200. #endif
  201. /**
  202. * if_usb_probe - sets the configuration values
  203. * @intf: &usb_interface pointer
  204. * @id: pointer to usb_device_id
  205. * returns: 0 on success, error code on failure
  206. */
  207. static int if_usb_probe(struct usb_interface *intf,
  208. const struct usb_device_id *id)
  209. {
  210. struct usb_device *udev;
  211. struct usb_host_interface *iface_desc;
  212. struct usb_endpoint_descriptor *endpoint;
  213. struct lbs_private *priv;
  214. struct if_usb_card *cardp;
  215. int i;
  216. udev = interface_to_usbdev(intf);
  217. cardp = kzalloc(sizeof(struct if_usb_card), GFP_KERNEL);
  218. if (!cardp) {
  219. pr_err("Out of memory allocating private data\n");
  220. goto error;
  221. }
  222. setup_timer(&cardp->fw_timeout, if_usb_fw_timeo, (unsigned long)cardp);
  223. init_waitqueue_head(&cardp->fw_wq);
  224. cardp->udev = udev;
  225. cardp->model = (uint32_t) id->driver_info;
  226. iface_desc = intf->cur_altsetting;
  227. lbs_deb_usbd(&udev->dev, "bcdUSB = 0x%X bDeviceClass = 0x%X"
  228. " bDeviceSubClass = 0x%X, bDeviceProtocol = 0x%X\n",
  229. le16_to_cpu(udev->descriptor.bcdUSB),
  230. udev->descriptor.bDeviceClass,
  231. udev->descriptor.bDeviceSubClass,
  232. udev->descriptor.bDeviceProtocol);
  233. for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
  234. endpoint = &iface_desc->endpoint[i].desc;
  235. if (usb_endpoint_is_bulk_in(endpoint)) {
  236. cardp->ep_in_size = le16_to_cpu(endpoint->wMaxPacketSize);
  237. cardp->ep_in = usb_endpoint_num(endpoint);
  238. lbs_deb_usbd(&udev->dev, "in_endpoint = %d\n", cardp->ep_in);
  239. lbs_deb_usbd(&udev->dev, "Bulk in size is %d\n", cardp->ep_in_size);
  240. } else if (usb_endpoint_is_bulk_out(endpoint)) {
  241. cardp->ep_out_size = le16_to_cpu(endpoint->wMaxPacketSize);
  242. cardp->ep_out = usb_endpoint_num(endpoint);
  243. lbs_deb_usbd(&udev->dev, "out_endpoint = %d\n", cardp->ep_out);
  244. lbs_deb_usbd(&udev->dev, "Bulk out size is %d\n", cardp->ep_out_size);
  245. }
  246. }
  247. if (!cardp->ep_out_size || !cardp->ep_in_size) {
  248. lbs_deb_usbd(&udev->dev, "Endpoints not found\n");
  249. goto dealloc;
  250. }
  251. if (!(cardp->rx_urb = usb_alloc_urb(0, GFP_KERNEL))) {
  252. lbs_deb_usbd(&udev->dev, "Rx URB allocation failed\n");
  253. goto dealloc;
  254. }
  255. if (!(cardp->tx_urb = usb_alloc_urb(0, GFP_KERNEL))) {
  256. lbs_deb_usbd(&udev->dev, "Tx URB allocation failed\n");
  257. goto dealloc;
  258. }
  259. cardp->ep_out_buf = kmalloc(MRVDRV_ETH_TX_PACKET_BUFFER_SIZE, GFP_KERNEL);
  260. if (!cardp->ep_out_buf) {
  261. lbs_deb_usbd(&udev->dev, "Could not allocate buffer\n");
  262. goto dealloc;
  263. }
  264. /* Upload firmware */
  265. kparam_block_sysfs_write(fw_name);
  266. if (__if_usb_prog_firmware(cardp, lbs_fw_name, BOOT_CMD_FW_BY_USB)) {
  267. kparam_unblock_sysfs_write(fw_name);
  268. lbs_deb_usbd(&udev->dev, "FW upload failed\n");
  269. goto err_prog_firmware;
  270. }
  271. kparam_unblock_sysfs_write(fw_name);
  272. if (!(priv = lbs_add_card(cardp, &udev->dev)))
  273. goto err_prog_firmware;
  274. cardp->priv = priv;
  275. cardp->priv->fw_ready = 1;
  276. priv->hw_host_to_card = if_usb_host_to_card;
  277. priv->enter_deep_sleep = NULL;
  278. priv->exit_deep_sleep = NULL;
  279. priv->reset_deep_sleep_wakeup = NULL;
  280. #ifdef CONFIG_OLPC
  281. if (machine_is_olpc())
  282. priv->reset_card = if_usb_reset_olpc_card;
  283. #endif
  284. cardp->boot2_version = udev->descriptor.bcdDevice;
  285. if_usb_submit_rx_urb(cardp);
  286. if (lbs_start_card(priv))
  287. goto err_start_card;
  288. if_usb_setup_firmware(priv);
  289. usb_get_dev(udev);
  290. usb_set_intfdata(intf, cardp);
  291. if (device_create_file(&priv->dev->dev, &dev_attr_lbs_flash_fw))
  292. netdev_err(priv->dev,
  293. "cannot register lbs_flash_fw attribute\n");
  294. if (device_create_file(&priv->dev->dev, &dev_attr_lbs_flash_boot2))
  295. netdev_err(priv->dev,
  296. "cannot register lbs_flash_boot2 attribute\n");
  297. /*
  298. * EHS_REMOVE_WAKEUP is not supported on all versions of the firmware.
  299. */
  300. priv->wol_criteria = EHS_REMOVE_WAKEUP;
  301. if (lbs_host_sleep_cfg(priv, priv->wol_criteria, NULL))
  302. priv->ehs_remove_supported = false;
  303. return 0;
  304. err_start_card:
  305. lbs_remove_card(priv);
  306. err_prog_firmware:
  307. if_usb_reset_device(cardp);
  308. dealloc:
  309. if_usb_free(cardp);
  310. error:
  311. return -ENOMEM;
  312. }
  313. /**
  314. * if_usb_disconnect - free resource and cleanup
  315. * @intf: USB interface structure
  316. * returns: N/A
  317. */
  318. static void if_usb_disconnect(struct usb_interface *intf)
  319. {
  320. struct if_usb_card *cardp = usb_get_intfdata(intf);
  321. struct lbs_private *priv = (struct lbs_private *) cardp->priv;
  322. lbs_deb_enter(LBS_DEB_MAIN);
  323. device_remove_file(&priv->dev->dev, &dev_attr_lbs_flash_boot2);
  324. device_remove_file(&priv->dev->dev, &dev_attr_lbs_flash_fw);
  325. cardp->surprise_removed = 1;
  326. if (priv) {
  327. priv->surpriseremoved = 1;
  328. lbs_stop_card(priv);
  329. lbs_remove_card(priv);
  330. }
  331. /* Unlink and free urb */
  332. if_usb_free(cardp);
  333. usb_set_intfdata(intf, NULL);
  334. usb_put_dev(interface_to_usbdev(intf));
  335. lbs_deb_leave(LBS_DEB_MAIN);
  336. }
  337. /**
  338. * if_usb_send_fw_pkt - download FW
  339. * @cardp: pointer to &struct if_usb_card
  340. * returns: 0
  341. */
  342. static int if_usb_send_fw_pkt(struct if_usb_card *cardp)
  343. {
  344. struct fwdata *fwdata = cardp->ep_out_buf;
  345. const uint8_t *firmware = cardp->fw->data;
  346. /* If we got a CRC failure on the last block, back
  347. up and retry it */
  348. if (!cardp->CRC_OK) {
  349. cardp->totalbytes = cardp->fwlastblksent;
  350. cardp->fwseqnum--;
  351. }
  352. lbs_deb_usb2(&cardp->udev->dev, "totalbytes = %d\n",
  353. cardp->totalbytes);
  354. /* struct fwdata (which we sent to the card) has an
  355. extra __le32 field in between the header and the data,
  356. which is not in the struct fwheader in the actual
  357. firmware binary. Insert the seqnum in the middle... */
  358. memcpy(&fwdata->hdr, &firmware[cardp->totalbytes],
  359. sizeof(struct fwheader));
  360. cardp->fwlastblksent = cardp->totalbytes;
  361. cardp->totalbytes += sizeof(struct fwheader);
  362. memcpy(fwdata->data, &firmware[cardp->totalbytes],
  363. le32_to_cpu(fwdata->hdr.datalength));
  364. lbs_deb_usb2(&cardp->udev->dev, "Data length = %d\n",
  365. le32_to_cpu(fwdata->hdr.datalength));
  366. fwdata->seqnum = cpu_to_le32(++cardp->fwseqnum);
  367. cardp->totalbytes += le32_to_cpu(fwdata->hdr.datalength);
  368. usb_tx_block(cardp, cardp->ep_out_buf, sizeof(struct fwdata) +
  369. le32_to_cpu(fwdata->hdr.datalength));
  370. if (fwdata->hdr.dnldcmd == cpu_to_le32(FW_HAS_DATA_TO_RECV)) {
  371. lbs_deb_usb2(&cardp->udev->dev, "There are data to follow\n");
  372. lbs_deb_usb2(&cardp->udev->dev, "seqnum = %d totalbytes = %d\n",
  373. cardp->fwseqnum, cardp->totalbytes);
  374. } else if (fwdata->hdr.dnldcmd == cpu_to_le32(FW_HAS_LAST_BLOCK)) {
  375. lbs_deb_usb2(&cardp->udev->dev, "Host has finished FW downloading\n");
  376. lbs_deb_usb2(&cardp->udev->dev, "Donwloading FW JUMP BLOCK\n");
  377. cardp->fwfinalblk = 1;
  378. }
  379. lbs_deb_usb2(&cardp->udev->dev, "Firmware download done; size %d\n",
  380. cardp->totalbytes);
  381. return 0;
  382. }
  383. static int if_usb_reset_device(struct if_usb_card *cardp)
  384. {
  385. struct cmd_header *cmd = cardp->ep_out_buf + 4;
  386. int ret;
  387. lbs_deb_enter(LBS_DEB_USB);
  388. *(__le32 *)cardp->ep_out_buf = cpu_to_le32(CMD_TYPE_REQUEST);
  389. cmd->command = cpu_to_le16(CMD_802_11_RESET);
  390. cmd->size = cpu_to_le16(sizeof(cmd));
  391. cmd->result = cpu_to_le16(0);
  392. cmd->seqnum = cpu_to_le16(0x5a5a);
  393. usb_tx_block(cardp, cardp->ep_out_buf, 4 + sizeof(struct cmd_header));
  394. msleep(100);
  395. ret = usb_reset_device(cardp->udev);
  396. msleep(100);
  397. #ifdef CONFIG_OLPC
  398. if (ret && machine_is_olpc())
  399. if_usb_reset_olpc_card(NULL);
  400. #endif
  401. lbs_deb_leave_args(LBS_DEB_USB, "ret %d", ret);
  402. return ret;
  403. }
  404. /**
  405. * usb_tx_block - transfer the data to the device
  406. * @cardp: pointer to &struct if_usb_card
  407. * @payload: pointer to payload data
  408. * @nb: data length
  409. * returns: 0 for success or negative error code
  410. */
  411. static int usb_tx_block(struct if_usb_card *cardp, uint8_t *payload, uint16_t nb)
  412. {
  413. int ret;
  414. /* check if device is removed */
  415. if (cardp->surprise_removed) {
  416. lbs_deb_usbd(&cardp->udev->dev, "Device removed\n");
  417. ret = -ENODEV;
  418. goto tx_ret;
  419. }
  420. usb_fill_bulk_urb(cardp->tx_urb, cardp->udev,
  421. usb_sndbulkpipe(cardp->udev,
  422. cardp->ep_out),
  423. payload, nb, if_usb_write_bulk_callback, cardp);
  424. cardp->tx_urb->transfer_flags |= URB_ZERO_PACKET;
  425. if ((ret = usb_submit_urb(cardp->tx_urb, GFP_ATOMIC))) {
  426. lbs_deb_usbd(&cardp->udev->dev, "usb_submit_urb failed: %d\n", ret);
  427. } else {
  428. lbs_deb_usb2(&cardp->udev->dev, "usb_submit_urb success\n");
  429. ret = 0;
  430. }
  431. tx_ret:
  432. return ret;
  433. }
  434. static int __if_usb_submit_rx_urb(struct if_usb_card *cardp,
  435. void (*callbackfn)(struct urb *urb))
  436. {
  437. struct sk_buff *skb;
  438. int ret = -1;
  439. if (!(skb = dev_alloc_skb(MRVDRV_ETH_RX_PACKET_BUFFER_SIZE))) {
  440. pr_err("No free skb\n");
  441. goto rx_ret;
  442. }
  443. cardp->rx_skb = skb;
  444. /* Fill the receive configuration URB and initialise the Rx call back */
  445. usb_fill_bulk_urb(cardp->rx_urb, cardp->udev,
  446. usb_rcvbulkpipe(cardp->udev, cardp->ep_in),
  447. skb->data + IPFIELD_ALIGN_OFFSET,
  448. MRVDRV_ETH_RX_PACKET_BUFFER_SIZE, callbackfn,
  449. cardp);
  450. cardp->rx_urb->transfer_flags |= URB_ZERO_PACKET;
  451. lbs_deb_usb2(&cardp->udev->dev, "Pointer for rx_urb %p\n", cardp->rx_urb);
  452. if ((ret = usb_submit_urb(cardp->rx_urb, GFP_ATOMIC))) {
  453. lbs_deb_usbd(&cardp->udev->dev, "Submit Rx URB failed: %d\n", ret);
  454. kfree_skb(skb);
  455. cardp->rx_skb = NULL;
  456. ret = -1;
  457. } else {
  458. lbs_deb_usb2(&cardp->udev->dev, "Submit Rx URB success\n");
  459. ret = 0;
  460. }
  461. rx_ret:
  462. return ret;
  463. }
  464. static int if_usb_submit_rx_urb_fwload(struct if_usb_card *cardp)
  465. {
  466. return __if_usb_submit_rx_urb(cardp, &if_usb_receive_fwload);
  467. }
  468. static int if_usb_submit_rx_urb(struct if_usb_card *cardp)
  469. {
  470. return __if_usb_submit_rx_urb(cardp, &if_usb_receive);
  471. }
  472. static void if_usb_receive_fwload(struct urb *urb)
  473. {
  474. struct if_usb_card *cardp = urb->context;
  475. struct sk_buff *skb = cardp->rx_skb;
  476. struct fwsyncheader *syncfwheader;
  477. struct bootcmdresp bootcmdresp;
  478. if (urb->status) {
  479. lbs_deb_usbd(&cardp->udev->dev,
  480. "URB status is failed during fw load\n");
  481. kfree_skb(skb);
  482. return;
  483. }
  484. if (cardp->fwdnldover) {
  485. __le32 *tmp = (__le32 *)(skb->data + IPFIELD_ALIGN_OFFSET);
  486. if (tmp[0] == cpu_to_le32(CMD_TYPE_INDICATION) &&
  487. tmp[1] == cpu_to_le32(MACREG_INT_CODE_FIRMWARE_READY)) {
  488. pr_info("Firmware ready event received\n");
  489. wake_up(&cardp->fw_wq);
  490. } else {
  491. lbs_deb_usb("Waiting for confirmation; got %x %x\n",
  492. le32_to_cpu(tmp[0]), le32_to_cpu(tmp[1]));
  493. if_usb_submit_rx_urb_fwload(cardp);
  494. }
  495. kfree_skb(skb);
  496. return;
  497. }
  498. if (cardp->bootcmdresp <= 0) {
  499. memcpy (&bootcmdresp, skb->data + IPFIELD_ALIGN_OFFSET,
  500. sizeof(bootcmdresp));
  501. if (le16_to_cpu(cardp->udev->descriptor.bcdDevice) < 0x3106) {
  502. kfree_skb(skb);
  503. if_usb_submit_rx_urb_fwload(cardp);
  504. cardp->bootcmdresp = BOOT_CMD_RESP_OK;
  505. lbs_deb_usbd(&cardp->udev->dev,
  506. "Received valid boot command response\n");
  507. return;
  508. }
  509. if (bootcmdresp.magic != cpu_to_le32(BOOT_CMD_MAGIC_NUMBER)) {
  510. if (bootcmdresp.magic == cpu_to_le32(CMD_TYPE_REQUEST) ||
  511. bootcmdresp.magic == cpu_to_le32(CMD_TYPE_DATA) ||
  512. bootcmdresp.magic == cpu_to_le32(CMD_TYPE_INDICATION)) {
  513. if (!cardp->bootcmdresp)
  514. pr_info("Firmware already seems alive; resetting\n");
  515. cardp->bootcmdresp = -1;
  516. } else {
  517. pr_info("boot cmd response wrong magic number (0x%x)\n",
  518. le32_to_cpu(bootcmdresp.magic));
  519. }
  520. } else if ((bootcmdresp.cmd != BOOT_CMD_FW_BY_USB) &&
  521. (bootcmdresp.cmd != BOOT_CMD_UPDATE_FW) &&
  522. (bootcmdresp.cmd != BOOT_CMD_UPDATE_BOOT2)) {
  523. pr_info("boot cmd response cmd_tag error (%d)\n",
  524. bootcmdresp.cmd);
  525. } else if (bootcmdresp.result != BOOT_CMD_RESP_OK) {
  526. pr_info("boot cmd response result error (%d)\n",
  527. bootcmdresp.result);
  528. } else {
  529. cardp->bootcmdresp = 1;
  530. lbs_deb_usbd(&cardp->udev->dev,
  531. "Received valid boot command response\n");
  532. }
  533. kfree_skb(skb);
  534. if_usb_submit_rx_urb_fwload(cardp);
  535. return;
  536. }
  537. syncfwheader = kmemdup(skb->data + IPFIELD_ALIGN_OFFSET,
  538. sizeof(struct fwsyncheader), GFP_ATOMIC);
  539. if (!syncfwheader) {
  540. lbs_deb_usbd(&cardp->udev->dev, "Failure to allocate syncfwheader\n");
  541. kfree_skb(skb);
  542. return;
  543. }
  544. if (!syncfwheader->cmd) {
  545. lbs_deb_usb2(&cardp->udev->dev, "FW received Blk with correct CRC\n");
  546. lbs_deb_usb2(&cardp->udev->dev, "FW received Blk seqnum = %d\n",
  547. le32_to_cpu(syncfwheader->seqnum));
  548. cardp->CRC_OK = 1;
  549. } else {
  550. lbs_deb_usbd(&cardp->udev->dev, "FW received Blk with CRC error\n");
  551. cardp->CRC_OK = 0;
  552. }
  553. kfree_skb(skb);
  554. /* Give device 5s to either write firmware to its RAM or eeprom */
  555. mod_timer(&cardp->fw_timeout, jiffies + (HZ*5));
  556. if (cardp->fwfinalblk) {
  557. cardp->fwdnldover = 1;
  558. goto exit;
  559. }
  560. if_usb_send_fw_pkt(cardp);
  561. exit:
  562. if_usb_submit_rx_urb_fwload(cardp);
  563. kfree(syncfwheader);
  564. }
  565. #define MRVDRV_MIN_PKT_LEN 30
  566. static inline void process_cmdtypedata(int recvlength, struct sk_buff *skb,
  567. struct if_usb_card *cardp,
  568. struct lbs_private *priv)
  569. {
  570. if (recvlength > MRVDRV_ETH_RX_PACKET_BUFFER_SIZE + MESSAGE_HEADER_LEN
  571. || recvlength < MRVDRV_MIN_PKT_LEN) {
  572. lbs_deb_usbd(&cardp->udev->dev, "Packet length is Invalid\n");
  573. kfree_skb(skb);
  574. return;
  575. }
  576. skb_reserve(skb, IPFIELD_ALIGN_OFFSET);
  577. skb_put(skb, recvlength);
  578. skb_pull(skb, MESSAGE_HEADER_LEN);
  579. lbs_process_rxed_packet(priv, skb);
  580. }
  581. static inline void process_cmdrequest(int recvlength, uint8_t *recvbuff,
  582. struct sk_buff *skb,
  583. struct if_usb_card *cardp,
  584. struct lbs_private *priv)
  585. {
  586. u8 i;
  587. if (recvlength > LBS_CMD_BUFFER_SIZE) {
  588. lbs_deb_usbd(&cardp->udev->dev,
  589. "The receive buffer is too large\n");
  590. kfree_skb(skb);
  591. return;
  592. }
  593. BUG_ON(!in_interrupt());
  594. spin_lock(&priv->driver_lock);
  595. i = (priv->resp_idx == 0) ? 1 : 0;
  596. BUG_ON(priv->resp_len[i]);
  597. priv->resp_len[i] = (recvlength - MESSAGE_HEADER_LEN);
  598. memcpy(priv->resp_buf[i], recvbuff + MESSAGE_HEADER_LEN,
  599. priv->resp_len[i]);
  600. kfree_skb(skb);
  601. lbs_notify_command_response(priv, i);
  602. spin_unlock(&priv->driver_lock);
  603. lbs_deb_usbd(&cardp->udev->dev,
  604. "Wake up main thread to handle cmd response\n");
  605. }
  606. /**
  607. * if_usb_receive - read the packet into the upload buffer,
  608. * wake up the main thread and initialise the Rx callack
  609. *
  610. * @urb: pointer to &struct urb
  611. * returns: N/A
  612. */
  613. static void if_usb_receive(struct urb *urb)
  614. {
  615. struct if_usb_card *cardp = urb->context;
  616. struct sk_buff *skb = cardp->rx_skb;
  617. struct lbs_private *priv = cardp->priv;
  618. int recvlength = urb->actual_length;
  619. uint8_t *recvbuff = NULL;
  620. uint32_t recvtype = 0;
  621. __le32 *pkt = (__le32 *)(skb->data + IPFIELD_ALIGN_OFFSET);
  622. uint32_t event;
  623. lbs_deb_enter(LBS_DEB_USB);
  624. if (recvlength) {
  625. if (urb->status) {
  626. lbs_deb_usbd(&cardp->udev->dev, "RX URB failed: %d\n",
  627. urb->status);
  628. kfree_skb(skb);
  629. goto setup_for_next;
  630. }
  631. recvbuff = skb->data + IPFIELD_ALIGN_OFFSET;
  632. recvtype = le32_to_cpu(pkt[0]);
  633. lbs_deb_usbd(&cardp->udev->dev,
  634. "Recv length = 0x%x, Recv type = 0x%X\n",
  635. recvlength, recvtype);
  636. } else if (urb->status) {
  637. kfree_skb(skb);
  638. goto rx_exit;
  639. }
  640. switch (recvtype) {
  641. case CMD_TYPE_DATA:
  642. process_cmdtypedata(recvlength, skb, cardp, priv);
  643. break;
  644. case CMD_TYPE_REQUEST:
  645. process_cmdrequest(recvlength, recvbuff, skb, cardp, priv);
  646. break;
  647. case CMD_TYPE_INDICATION:
  648. /* Event handling */
  649. event = le32_to_cpu(pkt[1]);
  650. lbs_deb_usbd(&cardp->udev->dev, "**EVENT** 0x%X\n", event);
  651. kfree_skb(skb);
  652. /* Icky undocumented magic special case */
  653. if (event & 0xffff0000) {
  654. u32 trycount = (event & 0xffff0000) >> 16;
  655. lbs_send_tx_feedback(priv, trycount);
  656. } else
  657. lbs_queue_event(priv, event & 0xFF);
  658. break;
  659. default:
  660. lbs_deb_usbd(&cardp->udev->dev, "Unknown command type 0x%X\n",
  661. recvtype);
  662. kfree_skb(skb);
  663. break;
  664. }
  665. setup_for_next:
  666. if_usb_submit_rx_urb(cardp);
  667. rx_exit:
  668. lbs_deb_leave(LBS_DEB_USB);
  669. }
  670. /**
  671. * if_usb_host_to_card - downloads data to FW
  672. * @priv: pointer to &struct lbs_private structure
  673. * @type: type of data
  674. * @payload: pointer to data buffer
  675. * @nb: number of bytes
  676. * returns: 0 for success or negative error code
  677. */
  678. static int if_usb_host_to_card(struct lbs_private *priv, uint8_t type,
  679. uint8_t *payload, uint16_t nb)
  680. {
  681. struct if_usb_card *cardp = priv->card;
  682. lbs_deb_usbd(&cardp->udev->dev,"*** type = %u\n", type);
  683. lbs_deb_usbd(&cardp->udev->dev,"size after = %d\n", nb);
  684. if (type == MVMS_CMD) {
  685. *(__le32 *)cardp->ep_out_buf = cpu_to_le32(CMD_TYPE_REQUEST);
  686. priv->dnld_sent = DNLD_CMD_SENT;
  687. } else {
  688. *(__le32 *)cardp->ep_out_buf = cpu_to_le32(CMD_TYPE_DATA);
  689. priv->dnld_sent = DNLD_DATA_SENT;
  690. }
  691. memcpy((cardp->ep_out_buf + MESSAGE_HEADER_LEN), payload, nb);
  692. return usb_tx_block(cardp, cardp->ep_out_buf, nb + MESSAGE_HEADER_LEN);
  693. }
  694. /**
  695. * if_usb_issue_boot_command - issues Boot command to the Boot2 code
  696. * @cardp: pointer to &if_usb_card
  697. * @ivalue: 1:Boot from FW by USB-Download
  698. * 2:Boot from FW in EEPROM
  699. * returns: 0 for success or negative error code
  700. */
  701. static int if_usb_issue_boot_command(struct if_usb_card *cardp, int ivalue)
  702. {
  703. struct bootcmd *bootcmd = cardp->ep_out_buf;
  704. /* Prepare command */
  705. bootcmd->magic = cpu_to_le32(BOOT_CMD_MAGIC_NUMBER);
  706. bootcmd->cmd = ivalue;
  707. memset(bootcmd->pad, 0, sizeof(bootcmd->pad));
  708. /* Issue command */
  709. usb_tx_block(cardp, cardp->ep_out_buf, sizeof(*bootcmd));
  710. return 0;
  711. }
  712. /**
  713. * check_fwfile_format - check the validity of Boot2/FW image
  714. *
  715. * @data: pointer to image
  716. * @totlen: image length
  717. * returns: 0 (good) or 1 (failure)
  718. */
  719. static int check_fwfile_format(const uint8_t *data, uint32_t totlen)
  720. {
  721. uint32_t bincmd, exit;
  722. uint32_t blksize, offset, len;
  723. int ret;
  724. ret = 1;
  725. exit = len = 0;
  726. do {
  727. struct fwheader *fwh = (void *)data;
  728. bincmd = le32_to_cpu(fwh->dnldcmd);
  729. blksize = le32_to_cpu(fwh->datalength);
  730. switch (bincmd) {
  731. case FW_HAS_DATA_TO_RECV:
  732. offset = sizeof(struct fwheader) + blksize;
  733. data += offset;
  734. len += offset;
  735. if (len >= totlen)
  736. exit = 1;
  737. break;
  738. case FW_HAS_LAST_BLOCK:
  739. exit = 1;
  740. ret = 0;
  741. break;
  742. default:
  743. exit = 1;
  744. break;
  745. }
  746. } while (!exit);
  747. if (ret)
  748. pr_err("firmware file format check FAIL\n");
  749. else
  750. lbs_deb_fw("firmware file format check PASS\n");
  751. return ret;
  752. }
  753. /**
  754. * if_usb_prog_firmware - programs the firmware subject to cmd
  755. *
  756. * @cardp: the if_usb_card descriptor
  757. * @fwname: firmware or boot2 image file name
  758. * @cmd: either BOOT_CMD_FW_BY_USB, BOOT_CMD_UPDATE_FW,
  759. * or BOOT_CMD_UPDATE_BOOT2.
  760. * returns: 0 or error code
  761. */
  762. static int if_usb_prog_firmware(struct if_usb_card *cardp,
  763. const char *fwname, int cmd)
  764. {
  765. struct lbs_private *priv = cardp->priv;
  766. unsigned long flags, caps;
  767. int ret;
  768. caps = priv->fwcapinfo;
  769. if (((cmd == BOOT_CMD_UPDATE_FW) && !(caps & FW_CAPINFO_FIRMWARE_UPGRADE)) ||
  770. ((cmd == BOOT_CMD_UPDATE_BOOT2) && !(caps & FW_CAPINFO_BOOT2_UPGRADE)))
  771. return -EOPNOTSUPP;
  772. /* Ensure main thread is idle. */
  773. spin_lock_irqsave(&priv->driver_lock, flags);
  774. while (priv->cur_cmd != NULL || priv->dnld_sent != DNLD_RES_RECEIVED) {
  775. spin_unlock_irqrestore(&priv->driver_lock, flags);
  776. if (wait_event_interruptible(priv->waitq,
  777. (priv->cur_cmd == NULL &&
  778. priv->dnld_sent == DNLD_RES_RECEIVED))) {
  779. return -ERESTARTSYS;
  780. }
  781. spin_lock_irqsave(&priv->driver_lock, flags);
  782. }
  783. priv->dnld_sent = DNLD_BOOTCMD_SENT;
  784. spin_unlock_irqrestore(&priv->driver_lock, flags);
  785. ret = __if_usb_prog_firmware(cardp, fwname, cmd);
  786. spin_lock_irqsave(&priv->driver_lock, flags);
  787. priv->dnld_sent = DNLD_RES_RECEIVED;
  788. spin_unlock_irqrestore(&priv->driver_lock, flags);
  789. wake_up_interruptible(&priv->waitq);
  790. return ret;
  791. }
  792. /* table of firmware file names */
  793. static const struct {
  794. u32 model;
  795. const char *fwname;
  796. } fw_table[] = {
  797. { MODEL_8388, "libertas/usb8388_v9.bin" },
  798. { MODEL_8388, "libertas/usb8388_v5.bin" },
  799. { MODEL_8388, "libertas/usb8388.bin" },
  800. { MODEL_8388, "usb8388.bin" },
  801. { MODEL_8682, "libertas/usb8682.bin" }
  802. };
  803. static int get_fw(struct if_usb_card *cardp, const char *fwname)
  804. {
  805. int i;
  806. /* Try user-specified firmware first */
  807. if (fwname)
  808. return request_firmware(&cardp->fw, fwname, &cardp->udev->dev);
  809. /* Otherwise search for firmware to use */
  810. for (i = 0; i < ARRAY_SIZE(fw_table); i++) {
  811. if (fw_table[i].model != cardp->model)
  812. continue;
  813. if (request_firmware(&cardp->fw, fw_table[i].fwname,
  814. &cardp->udev->dev) == 0)
  815. return 0;
  816. }
  817. return -ENOENT;
  818. }
  819. static int __if_usb_prog_firmware(struct if_usb_card *cardp,
  820. const char *fwname, int cmd)
  821. {
  822. int i = 0;
  823. static int reset_count = 10;
  824. int ret = 0;
  825. lbs_deb_enter(LBS_DEB_USB);
  826. ret = get_fw(cardp, fwname);
  827. if (ret) {
  828. pr_err("failed to find firmware (%d)\n", ret);
  829. goto done;
  830. }
  831. if (check_fwfile_format(cardp->fw->data, cardp->fw->size)) {
  832. ret = -EINVAL;
  833. goto release_fw;
  834. }
  835. /* Cancel any pending usb business */
  836. usb_kill_urb(cardp->rx_urb);
  837. usb_kill_urb(cardp->tx_urb);
  838. cardp->fwlastblksent = 0;
  839. cardp->fwdnldover = 0;
  840. cardp->totalbytes = 0;
  841. cardp->fwfinalblk = 0;
  842. cardp->bootcmdresp = 0;
  843. restart:
  844. if (if_usb_submit_rx_urb_fwload(cardp) < 0) {
  845. lbs_deb_usbd(&cardp->udev->dev, "URB submission is failed\n");
  846. ret = -EIO;
  847. goto release_fw;
  848. }
  849. cardp->bootcmdresp = 0;
  850. do {
  851. int j = 0;
  852. i++;
  853. if_usb_issue_boot_command(cardp, cmd);
  854. /* wait for command response */
  855. do {
  856. j++;
  857. msleep_interruptible(100);
  858. } while (cardp->bootcmdresp == 0 && j < 10);
  859. } while (cardp->bootcmdresp == 0 && i < 5);
  860. if (cardp->bootcmdresp == BOOT_CMD_RESP_NOT_SUPPORTED) {
  861. /* Return to normal operation */
  862. ret = -EOPNOTSUPP;
  863. usb_kill_urb(cardp->rx_urb);
  864. usb_kill_urb(cardp->tx_urb);
  865. if (if_usb_submit_rx_urb(cardp) < 0)
  866. ret = -EIO;
  867. goto release_fw;
  868. } else if (cardp->bootcmdresp <= 0) {
  869. if (--reset_count >= 0) {
  870. if_usb_reset_device(cardp);
  871. goto restart;
  872. }
  873. ret = -EIO;
  874. goto release_fw;
  875. }
  876. i = 0;
  877. cardp->totalbytes = 0;
  878. cardp->fwlastblksent = 0;
  879. cardp->CRC_OK = 1;
  880. cardp->fwdnldover = 0;
  881. cardp->fwseqnum = -1;
  882. cardp->totalbytes = 0;
  883. cardp->fwfinalblk = 0;
  884. /* Send the first firmware packet... */
  885. if_usb_send_fw_pkt(cardp);
  886. /* ... and wait for the process to complete */
  887. wait_event_interruptible(cardp->fw_wq, cardp->surprise_removed || cardp->fwdnldover);
  888. del_timer_sync(&cardp->fw_timeout);
  889. usb_kill_urb(cardp->rx_urb);
  890. if (!cardp->fwdnldover) {
  891. pr_info("failed to load fw, resetting device!\n");
  892. if (--reset_count >= 0) {
  893. if_usb_reset_device(cardp);
  894. goto restart;
  895. }
  896. pr_info("FW download failure, time = %d ms\n", i * 100);
  897. ret = -EIO;
  898. goto release_fw;
  899. }
  900. release_fw:
  901. release_firmware(cardp->fw);
  902. cardp->fw = NULL;
  903. done:
  904. lbs_deb_leave_args(LBS_DEB_USB, "ret %d", ret);
  905. return ret;
  906. }
  907. #ifdef CONFIG_PM
  908. static int if_usb_suspend(struct usb_interface *intf, pm_message_t message)
  909. {
  910. struct if_usb_card *cardp = usb_get_intfdata(intf);
  911. struct lbs_private *priv = cardp->priv;
  912. int ret;
  913. lbs_deb_enter(LBS_DEB_USB);
  914. if (priv->psstate != PS_STATE_FULL_POWER)
  915. return -1;
  916. ret = lbs_suspend(priv);
  917. if (ret)
  918. goto out;
  919. /* Unlink tx & rx urb */
  920. usb_kill_urb(cardp->tx_urb);
  921. usb_kill_urb(cardp->rx_urb);
  922. out:
  923. lbs_deb_leave(LBS_DEB_USB);
  924. return ret;
  925. }
  926. static int if_usb_resume(struct usb_interface *intf)
  927. {
  928. struct if_usb_card *cardp = usb_get_intfdata(intf);
  929. struct lbs_private *priv = cardp->priv;
  930. lbs_deb_enter(LBS_DEB_USB);
  931. if_usb_submit_rx_urb(cardp);
  932. lbs_resume(priv);
  933. lbs_deb_leave(LBS_DEB_USB);
  934. return 0;
  935. }
  936. #else
  937. #define if_usb_suspend NULL
  938. #define if_usb_resume NULL
  939. #endif
  940. static struct usb_driver if_usb_driver = {
  941. .name = DRV_NAME,
  942. .probe = if_usb_probe,
  943. .disconnect = if_usb_disconnect,
  944. .id_table = if_usb_table,
  945. .suspend = if_usb_suspend,
  946. .resume = if_usb_resume,
  947. .reset_resume = if_usb_resume,
  948. };
  949. static int __init if_usb_init_module(void)
  950. {
  951. int ret = 0;
  952. lbs_deb_enter(LBS_DEB_MAIN);
  953. ret = usb_register(&if_usb_driver);
  954. lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
  955. return ret;
  956. }
  957. static void __exit if_usb_exit_module(void)
  958. {
  959. lbs_deb_enter(LBS_DEB_MAIN);
  960. usb_deregister(&if_usb_driver);
  961. lbs_deb_leave(LBS_DEB_MAIN);
  962. }
  963. module_init(if_usb_init_module);
  964. module_exit(if_usb_exit_module);
  965. MODULE_DESCRIPTION("8388 USB WLAN Driver");
  966. MODULE_AUTHOR("Marvell International Ltd. and Red Hat, Inc.");
  967. MODULE_LICENSE("GPL");