if_usb.c 29 KB

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