atusb.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876
  1. /*
  2. * atusb.c - Driver for the ATUSB IEEE 802.15.4 dongle
  3. *
  4. * Written 2013 by Werner Almesberger <werner@almesberger.net>
  5. *
  6. * Copyright (c) 2015 - 2016 Stefan Schmidt <stefan@datenfreihafen.org>
  7. *
  8. * This program is free software; you can redistribute it and/or
  9. * modify it under the terms of the GNU General Public License as
  10. * published by the Free Software Foundation, version 2
  11. *
  12. * Based on at86rf230.c and spi_atusb.c.
  13. * at86rf230.c is
  14. * Copyright (C) 2009 Siemens AG
  15. * Written by: Dmitry Eremin-Solenikov <dmitry.baryshkov@siemens.com>
  16. *
  17. * spi_atusb.c is
  18. * Copyright (c) 2011 Richard Sharpe <realrichardsharpe@gmail.com>
  19. * Copyright (c) 2011 Stefan Schmidt <stefan@datenfreihafen.org>
  20. * Copyright (c) 2011 Werner Almesberger <werner@almesberger.net>
  21. *
  22. * USB initialization is
  23. * Copyright (c) 2013 Alexander Aring <alex.aring@gmail.com>
  24. */
  25. #include <linux/kernel.h>
  26. #include <linux/slab.h>
  27. #include <linux/module.h>
  28. #include <linux/jiffies.h>
  29. #include <linux/usb.h>
  30. #include <linux/skbuff.h>
  31. #include <net/cfg802154.h>
  32. #include <net/mac802154.h>
  33. #include "at86rf230.h"
  34. #include "atusb.h"
  35. #define ATUSB_JEDEC_ATMEL 0x1f /* JEDEC manufacturer ID */
  36. #define ATUSB_NUM_RX_URBS 4 /* allow for a bit of local latency */
  37. #define ATUSB_ALLOC_DELAY_MS 100 /* delay after failed allocation */
  38. #define ATUSB_TX_TIMEOUT_MS 200 /* on the air timeout */
  39. struct atusb {
  40. struct ieee802154_hw *hw;
  41. struct usb_device *usb_dev;
  42. int shutdown; /* non-zero if shutting down */
  43. int err; /* set by first error */
  44. /* RX variables */
  45. struct delayed_work work; /* memory allocations */
  46. struct usb_anchor idle_urbs; /* URBs waiting to be submitted */
  47. struct usb_anchor rx_urbs; /* URBs waiting for reception */
  48. /* TX variables */
  49. struct usb_ctrlrequest tx_dr;
  50. struct urb *tx_urb;
  51. struct sk_buff *tx_skb;
  52. uint8_t tx_ack_seq; /* current TX ACK sequence number */
  53. };
  54. /* ----- USB commands without data ----------------------------------------- */
  55. /* To reduce the number of error checks in the code, we record the first error
  56. * in atusb->err and reject all subsequent requests until the error is cleared.
  57. */
  58. static int atusb_control_msg(struct atusb *atusb, unsigned int pipe,
  59. __u8 request, __u8 requesttype,
  60. __u16 value, __u16 index,
  61. void *data, __u16 size, int timeout)
  62. {
  63. struct usb_device *usb_dev = atusb->usb_dev;
  64. int ret;
  65. if (atusb->err)
  66. return atusb->err;
  67. ret = usb_control_msg(usb_dev, pipe, request, requesttype,
  68. value, index, data, size, timeout);
  69. if (ret < 0) {
  70. atusb->err = ret;
  71. dev_err(&usb_dev->dev,
  72. "atusb_control_msg: req 0x%02x val 0x%x idx 0x%x, error %d\n",
  73. request, value, index, ret);
  74. }
  75. return ret;
  76. }
  77. static int atusb_command(struct atusb *atusb, uint8_t cmd, uint8_t arg)
  78. {
  79. struct usb_device *usb_dev = atusb->usb_dev;
  80. dev_dbg(&usb_dev->dev, "atusb_command: cmd = 0x%x\n", cmd);
  81. return atusb_control_msg(atusb, usb_sndctrlpipe(usb_dev, 0),
  82. cmd, ATUSB_REQ_TO_DEV, arg, 0, NULL, 0, 1000);
  83. }
  84. static int atusb_write_reg(struct atusb *atusb, uint8_t reg, uint8_t value)
  85. {
  86. struct usb_device *usb_dev = atusb->usb_dev;
  87. dev_dbg(&usb_dev->dev, "atusb_write_reg: 0x%02x <- 0x%02x\n",
  88. reg, value);
  89. return atusb_control_msg(atusb, usb_sndctrlpipe(usb_dev, 0),
  90. ATUSB_REG_WRITE, ATUSB_REQ_TO_DEV,
  91. value, reg, NULL, 0, 1000);
  92. }
  93. static int atusb_read_reg(struct atusb *atusb, uint8_t reg)
  94. {
  95. struct usb_device *usb_dev = atusb->usb_dev;
  96. int ret;
  97. uint8_t *buffer;
  98. uint8_t value;
  99. buffer = kmalloc(1, GFP_KERNEL);
  100. if (!buffer)
  101. return -ENOMEM;
  102. dev_dbg(&usb_dev->dev, "atusb: reg = 0x%x\n", reg);
  103. ret = atusb_control_msg(atusb, usb_rcvctrlpipe(usb_dev, 0),
  104. ATUSB_REG_READ, ATUSB_REQ_FROM_DEV,
  105. 0, reg, buffer, 1, 1000);
  106. if (ret >= 0) {
  107. value = buffer[0];
  108. kfree(buffer);
  109. return value;
  110. } else {
  111. kfree(buffer);
  112. return ret;
  113. }
  114. }
  115. static int atusb_write_subreg(struct atusb *atusb, uint8_t reg, uint8_t mask,
  116. uint8_t shift, uint8_t value)
  117. {
  118. struct usb_device *usb_dev = atusb->usb_dev;
  119. uint8_t orig, tmp;
  120. int ret = 0;
  121. dev_dbg(&usb_dev->dev, "atusb_write_subreg: 0x%02x <- 0x%02x\n",
  122. reg, value);
  123. orig = atusb_read_reg(atusb, reg);
  124. /* Write the value only into that part of the register which is allowed
  125. * by the mask. All other bits stay as before.
  126. */
  127. tmp = orig & ~mask;
  128. tmp |= (value << shift) & mask;
  129. if (tmp != orig)
  130. ret = atusb_write_reg(atusb, reg, tmp);
  131. return ret;
  132. }
  133. static int atusb_get_and_clear_error(struct atusb *atusb)
  134. {
  135. int err = atusb->err;
  136. atusb->err = 0;
  137. return err;
  138. }
  139. /* ----- skb allocation ---------------------------------------------------- */
  140. #define MAX_PSDU 127
  141. #define MAX_RX_XFER (1 + MAX_PSDU + 2 + 1) /* PHR+PSDU+CRC+LQI */
  142. #define SKB_ATUSB(skb) (*(struct atusb **)(skb)->cb)
  143. static void atusb_in(struct urb *urb);
  144. static int atusb_submit_rx_urb(struct atusb *atusb, struct urb *urb)
  145. {
  146. struct usb_device *usb_dev = atusb->usb_dev;
  147. struct sk_buff *skb = urb->context;
  148. int ret;
  149. if (!skb) {
  150. skb = alloc_skb(MAX_RX_XFER, GFP_KERNEL);
  151. if (!skb) {
  152. dev_warn_ratelimited(&usb_dev->dev,
  153. "atusb_in: can't allocate skb\n");
  154. return -ENOMEM;
  155. }
  156. skb_put(skb, MAX_RX_XFER);
  157. SKB_ATUSB(skb) = atusb;
  158. }
  159. usb_fill_bulk_urb(urb, usb_dev, usb_rcvbulkpipe(usb_dev, 1),
  160. skb->data, MAX_RX_XFER, atusb_in, skb);
  161. usb_anchor_urb(urb, &atusb->rx_urbs);
  162. ret = usb_submit_urb(urb, GFP_KERNEL);
  163. if (ret) {
  164. usb_unanchor_urb(urb);
  165. kfree_skb(skb);
  166. urb->context = NULL;
  167. }
  168. return ret;
  169. }
  170. static void atusb_work_urbs(struct work_struct *work)
  171. {
  172. struct atusb *atusb =
  173. container_of(to_delayed_work(work), struct atusb, work);
  174. struct usb_device *usb_dev = atusb->usb_dev;
  175. struct urb *urb;
  176. int ret;
  177. if (atusb->shutdown)
  178. return;
  179. do {
  180. urb = usb_get_from_anchor(&atusb->idle_urbs);
  181. if (!urb)
  182. return;
  183. ret = atusb_submit_rx_urb(atusb, urb);
  184. } while (!ret);
  185. usb_anchor_urb(urb, &atusb->idle_urbs);
  186. dev_warn_ratelimited(&usb_dev->dev,
  187. "atusb_in: can't allocate/submit URB (%d)\n", ret);
  188. schedule_delayed_work(&atusb->work,
  189. msecs_to_jiffies(ATUSB_ALLOC_DELAY_MS) + 1);
  190. }
  191. /* ----- Asynchronous USB -------------------------------------------------- */
  192. static void atusb_tx_done(struct atusb *atusb, uint8_t seq)
  193. {
  194. struct usb_device *usb_dev = atusb->usb_dev;
  195. uint8_t expect = atusb->tx_ack_seq;
  196. dev_dbg(&usb_dev->dev, "atusb_tx_done (0x%02x/0x%02x)\n", seq, expect);
  197. if (seq == expect) {
  198. /* TODO check for ifs handling in firmware */
  199. ieee802154_xmit_complete(atusb->hw, atusb->tx_skb, false);
  200. } else {
  201. /* TODO I experience this case when atusb has a tx complete
  202. * irq before probing, we should fix the firmware it's an
  203. * unlikely case now that seq == expect is then true, but can
  204. * happen and fail with a tx_skb = NULL;
  205. */
  206. ieee802154_wake_queue(atusb->hw);
  207. if (atusb->tx_skb)
  208. dev_kfree_skb_irq(atusb->tx_skb);
  209. }
  210. }
  211. static void atusb_in_good(struct urb *urb)
  212. {
  213. struct usb_device *usb_dev = urb->dev;
  214. struct sk_buff *skb = urb->context;
  215. struct atusb *atusb = SKB_ATUSB(skb);
  216. uint8_t len, lqi;
  217. if (!urb->actual_length) {
  218. dev_dbg(&usb_dev->dev, "atusb_in: zero-sized URB ?\n");
  219. return;
  220. }
  221. len = *skb->data;
  222. if (urb->actual_length == 1) {
  223. atusb_tx_done(atusb, len);
  224. return;
  225. }
  226. if (len + 1 > urb->actual_length - 1) {
  227. dev_dbg(&usb_dev->dev, "atusb_in: frame len %d+1 > URB %u-1\n",
  228. len, urb->actual_length);
  229. return;
  230. }
  231. if (!ieee802154_is_valid_psdu_len(len)) {
  232. dev_dbg(&usb_dev->dev, "atusb_in: frame corrupted\n");
  233. return;
  234. }
  235. lqi = skb->data[len + 1];
  236. dev_dbg(&usb_dev->dev, "atusb_in: rx len %d lqi 0x%02x\n", len, lqi);
  237. skb_pull(skb, 1); /* remove PHR */
  238. skb_trim(skb, len); /* get payload only */
  239. ieee802154_rx_irqsafe(atusb->hw, skb, lqi);
  240. urb->context = NULL; /* skb is gone */
  241. }
  242. static void atusb_in(struct urb *urb)
  243. {
  244. struct usb_device *usb_dev = urb->dev;
  245. struct sk_buff *skb = urb->context;
  246. struct atusb *atusb = SKB_ATUSB(skb);
  247. dev_dbg(&usb_dev->dev, "atusb_in: status %d len %d\n",
  248. urb->status, urb->actual_length);
  249. if (urb->status) {
  250. if (urb->status == -ENOENT) { /* being killed */
  251. kfree_skb(skb);
  252. urb->context = NULL;
  253. return;
  254. }
  255. dev_dbg(&usb_dev->dev, "atusb_in: URB error %d\n", urb->status);
  256. } else {
  257. atusb_in_good(urb);
  258. }
  259. usb_anchor_urb(urb, &atusb->idle_urbs);
  260. if (!atusb->shutdown)
  261. schedule_delayed_work(&atusb->work, 0);
  262. }
  263. /* ----- URB allocation/deallocation --------------------------------------- */
  264. static void atusb_free_urbs(struct atusb *atusb)
  265. {
  266. struct urb *urb;
  267. while (1) {
  268. urb = usb_get_from_anchor(&atusb->idle_urbs);
  269. if (!urb)
  270. break;
  271. kfree_skb(urb->context);
  272. usb_free_urb(urb);
  273. }
  274. }
  275. static int atusb_alloc_urbs(struct atusb *atusb, int n)
  276. {
  277. struct urb *urb;
  278. while (n) {
  279. urb = usb_alloc_urb(0, GFP_KERNEL);
  280. if (!urb) {
  281. atusb_free_urbs(atusb);
  282. return -ENOMEM;
  283. }
  284. usb_anchor_urb(urb, &atusb->idle_urbs);
  285. n--;
  286. }
  287. return 0;
  288. }
  289. /* ----- IEEE 802.15.4 interface operations -------------------------------- */
  290. static void atusb_xmit_complete(struct urb *urb)
  291. {
  292. dev_dbg(&urb->dev->dev, "atusb_xmit urb completed");
  293. }
  294. static int atusb_xmit(struct ieee802154_hw *hw, struct sk_buff *skb)
  295. {
  296. struct atusb *atusb = hw->priv;
  297. struct usb_device *usb_dev = atusb->usb_dev;
  298. int ret;
  299. dev_dbg(&usb_dev->dev, "atusb_xmit (%d)\n", skb->len);
  300. atusb->tx_skb = skb;
  301. atusb->tx_ack_seq++;
  302. atusb->tx_dr.wIndex = cpu_to_le16(atusb->tx_ack_seq);
  303. atusb->tx_dr.wLength = cpu_to_le16(skb->len);
  304. usb_fill_control_urb(atusb->tx_urb, usb_dev,
  305. usb_sndctrlpipe(usb_dev, 0),
  306. (unsigned char *)&atusb->tx_dr, skb->data,
  307. skb->len, atusb_xmit_complete, NULL);
  308. ret = usb_submit_urb(atusb->tx_urb, GFP_ATOMIC);
  309. dev_dbg(&usb_dev->dev, "atusb_xmit done (%d)\n", ret);
  310. return ret;
  311. }
  312. static int atusb_channel(struct ieee802154_hw *hw, u8 page, u8 channel)
  313. {
  314. struct atusb *atusb = hw->priv;
  315. int ret;
  316. ret = atusb_write_subreg(atusb, SR_CHANNEL, channel);
  317. if (ret < 0)
  318. return ret;
  319. msleep(1); /* @@@ ugly synchronization */
  320. return 0;
  321. }
  322. static int atusb_ed(struct ieee802154_hw *hw, u8 *level)
  323. {
  324. BUG_ON(!level);
  325. *level = 0xbe;
  326. return 0;
  327. }
  328. static int atusb_set_hw_addr_filt(struct ieee802154_hw *hw,
  329. struct ieee802154_hw_addr_filt *filt,
  330. unsigned long changed)
  331. {
  332. struct atusb *atusb = hw->priv;
  333. struct device *dev = &atusb->usb_dev->dev;
  334. if (changed & IEEE802154_AFILT_SADDR_CHANGED) {
  335. u16 addr = le16_to_cpu(filt->short_addr);
  336. dev_vdbg(dev, "atusb_set_hw_addr_filt called for saddr\n");
  337. atusb_write_reg(atusb, RG_SHORT_ADDR_0, addr);
  338. atusb_write_reg(atusb, RG_SHORT_ADDR_1, addr >> 8);
  339. }
  340. if (changed & IEEE802154_AFILT_PANID_CHANGED) {
  341. u16 pan = le16_to_cpu(filt->pan_id);
  342. dev_vdbg(dev, "atusb_set_hw_addr_filt called for pan id\n");
  343. atusb_write_reg(atusb, RG_PAN_ID_0, pan);
  344. atusb_write_reg(atusb, RG_PAN_ID_1, pan >> 8);
  345. }
  346. if (changed & IEEE802154_AFILT_IEEEADDR_CHANGED) {
  347. u8 i, addr[IEEE802154_EXTENDED_ADDR_LEN];
  348. memcpy(addr, &filt->ieee_addr, IEEE802154_EXTENDED_ADDR_LEN);
  349. dev_vdbg(dev, "atusb_set_hw_addr_filt called for IEEE addr\n");
  350. for (i = 0; i < 8; i++)
  351. atusb_write_reg(atusb, RG_IEEE_ADDR_0 + i, addr[i]);
  352. }
  353. if (changed & IEEE802154_AFILT_PANC_CHANGED) {
  354. dev_vdbg(dev,
  355. "atusb_set_hw_addr_filt called for panc change\n");
  356. if (filt->pan_coord)
  357. atusb_write_subreg(atusb, SR_AACK_I_AM_COORD, 1);
  358. else
  359. atusb_write_subreg(atusb, SR_AACK_I_AM_COORD, 0);
  360. }
  361. return atusb_get_and_clear_error(atusb);
  362. }
  363. static int atusb_start(struct ieee802154_hw *hw)
  364. {
  365. struct atusb *atusb = hw->priv;
  366. struct usb_device *usb_dev = atusb->usb_dev;
  367. int ret;
  368. dev_dbg(&usb_dev->dev, "atusb_start\n");
  369. schedule_delayed_work(&atusb->work, 0);
  370. atusb_command(atusb, ATUSB_RX_MODE, 1);
  371. ret = atusb_get_and_clear_error(atusb);
  372. if (ret < 0)
  373. usb_kill_anchored_urbs(&atusb->idle_urbs);
  374. return ret;
  375. }
  376. static void atusb_stop(struct ieee802154_hw *hw)
  377. {
  378. struct atusb *atusb = hw->priv;
  379. struct usb_device *usb_dev = atusb->usb_dev;
  380. dev_dbg(&usb_dev->dev, "atusb_stop\n");
  381. usb_kill_anchored_urbs(&atusb->idle_urbs);
  382. atusb_command(atusb, ATUSB_RX_MODE, 0);
  383. atusb_get_and_clear_error(atusb);
  384. }
  385. #define ATUSB_MAX_TX_POWERS 0xF
  386. static const s32 atusb_powers[ATUSB_MAX_TX_POWERS + 1] = {
  387. 300, 280, 230, 180, 130, 70, 0, -100, -200, -300, -400, -500, -700,
  388. -900, -1200, -1700,
  389. };
  390. static int
  391. atusb_set_txpower(struct ieee802154_hw *hw, s32 mbm)
  392. {
  393. struct atusb *atusb = hw->priv;
  394. u32 i;
  395. for (i = 0; i < hw->phy->supported.tx_powers_size; i++) {
  396. if (hw->phy->supported.tx_powers[i] == mbm)
  397. return atusb_write_subreg(atusb, SR_TX_PWR_23X, i);
  398. }
  399. return -EINVAL;
  400. }
  401. #define ATUSB_MAX_ED_LEVELS 0xF
  402. static const s32 atusb_ed_levels[ATUSB_MAX_ED_LEVELS + 1] = {
  403. -9100, -8900, -8700, -8500, -8300, -8100, -7900, -7700, -7500, -7300,
  404. -7100, -6900, -6700, -6500, -6300, -6100,
  405. };
  406. static int
  407. atusb_set_cca_mode(struct ieee802154_hw *hw, const struct wpan_phy_cca *cca)
  408. {
  409. struct atusb *atusb = hw->priv;
  410. u8 val;
  411. /* mapping 802.15.4 to driver spec */
  412. switch (cca->mode) {
  413. case NL802154_CCA_ENERGY:
  414. val = 1;
  415. break;
  416. case NL802154_CCA_CARRIER:
  417. val = 2;
  418. break;
  419. case NL802154_CCA_ENERGY_CARRIER:
  420. switch (cca->opt) {
  421. case NL802154_CCA_OPT_ENERGY_CARRIER_AND:
  422. val = 3;
  423. break;
  424. case NL802154_CCA_OPT_ENERGY_CARRIER_OR:
  425. val = 0;
  426. break;
  427. default:
  428. return -EINVAL;
  429. }
  430. break;
  431. default:
  432. return -EINVAL;
  433. }
  434. return atusb_write_subreg(atusb, SR_CCA_MODE, val);
  435. }
  436. static int
  437. atusb_set_cca_ed_level(struct ieee802154_hw *hw, s32 mbm)
  438. {
  439. struct atusb *atusb = hw->priv;
  440. u32 i;
  441. for (i = 0; i < hw->phy->supported.cca_ed_levels_size; i++) {
  442. if (hw->phy->supported.cca_ed_levels[i] == mbm)
  443. return atusb_write_subreg(atusb, SR_CCA_ED_THRES, i);
  444. }
  445. return -EINVAL;
  446. }
  447. static int
  448. atusb_set_csma_params(struct ieee802154_hw *hw, u8 min_be, u8 max_be, u8 retries)
  449. {
  450. struct atusb *atusb = hw->priv;
  451. int ret;
  452. ret = atusb_write_subreg(atusb, SR_MIN_BE, min_be);
  453. if (ret)
  454. return ret;
  455. ret = atusb_write_subreg(atusb, SR_MAX_BE, max_be);
  456. if (ret)
  457. return ret;
  458. return atusb_write_subreg(atusb, SR_MAX_CSMA_RETRIES, retries);
  459. }
  460. static int
  461. atusb_set_promiscuous_mode(struct ieee802154_hw *hw, const bool on)
  462. {
  463. struct atusb *atusb = hw->priv;
  464. int ret;
  465. if (on) {
  466. ret = atusb_write_subreg(atusb, SR_AACK_DIS_ACK, 1);
  467. if (ret < 0)
  468. return ret;
  469. ret = atusb_write_subreg(atusb, SR_AACK_PROM_MODE, 1);
  470. if (ret < 0)
  471. return ret;
  472. } else {
  473. ret = atusb_write_subreg(atusb, SR_AACK_PROM_MODE, 0);
  474. if (ret < 0)
  475. return ret;
  476. ret = atusb_write_subreg(atusb, SR_AACK_DIS_ACK, 0);
  477. if (ret < 0)
  478. return ret;
  479. }
  480. return 0;
  481. }
  482. static struct ieee802154_ops atusb_ops = {
  483. .owner = THIS_MODULE,
  484. .xmit_async = atusb_xmit,
  485. .ed = atusb_ed,
  486. .set_channel = atusb_channel,
  487. .start = atusb_start,
  488. .stop = atusb_stop,
  489. .set_hw_addr_filt = atusb_set_hw_addr_filt,
  490. .set_txpower = atusb_set_txpower,
  491. .set_cca_mode = atusb_set_cca_mode,
  492. .set_cca_ed_level = atusb_set_cca_ed_level,
  493. .set_csma_params = atusb_set_csma_params,
  494. .set_promiscuous_mode = atusb_set_promiscuous_mode,
  495. };
  496. /* ----- Firmware and chip version information ----------------------------- */
  497. static int atusb_get_and_show_revision(struct atusb *atusb)
  498. {
  499. struct usb_device *usb_dev = atusb->usb_dev;
  500. unsigned char *buffer;
  501. int ret;
  502. buffer = kmalloc(3, GFP_KERNEL);
  503. if (!buffer)
  504. return -ENOMEM;
  505. /* Get a couple of the ATMega Firmware values */
  506. ret = atusb_control_msg(atusb, usb_rcvctrlpipe(usb_dev, 0),
  507. ATUSB_ID, ATUSB_REQ_FROM_DEV, 0, 0,
  508. buffer, 3, 1000);
  509. if (ret >= 0)
  510. dev_info(&usb_dev->dev,
  511. "Firmware: major: %u, minor: %u, hardware type: %u\n",
  512. buffer[0], buffer[1], buffer[2]);
  513. if (buffer[0] == 0 && buffer[1] < 2) {
  514. dev_info(&usb_dev->dev,
  515. "Firmware version (%u.%u) is predates our first public release.",
  516. buffer[0], buffer[1]);
  517. dev_info(&usb_dev->dev, "Please update to version 0.2 or newer");
  518. }
  519. kfree(buffer);
  520. return ret;
  521. }
  522. static int atusb_get_and_show_build(struct atusb *atusb)
  523. {
  524. struct usb_device *usb_dev = atusb->usb_dev;
  525. char *build;
  526. int ret;
  527. build = kmalloc(ATUSB_BUILD_SIZE + 1, GFP_KERNEL);
  528. if (!build)
  529. return -ENOMEM;
  530. ret = atusb_control_msg(atusb, usb_rcvctrlpipe(usb_dev, 0),
  531. ATUSB_BUILD, ATUSB_REQ_FROM_DEV, 0, 0,
  532. build, ATUSB_BUILD_SIZE, 1000);
  533. if (ret >= 0) {
  534. build[ret] = 0;
  535. dev_info(&usb_dev->dev, "Firmware: build %s\n", build);
  536. }
  537. kfree(build);
  538. return ret;
  539. }
  540. static int atusb_get_and_show_chip(struct atusb *atusb)
  541. {
  542. struct usb_device *usb_dev = atusb->usb_dev;
  543. uint8_t man_id_0, man_id_1, part_num, version_num;
  544. const char *chip;
  545. man_id_0 = atusb_read_reg(atusb, RG_MAN_ID_0);
  546. man_id_1 = atusb_read_reg(atusb, RG_MAN_ID_1);
  547. part_num = atusb_read_reg(atusb, RG_PART_NUM);
  548. version_num = atusb_read_reg(atusb, RG_VERSION_NUM);
  549. if (atusb->err)
  550. return atusb->err;
  551. if ((man_id_1 << 8 | man_id_0) != ATUSB_JEDEC_ATMEL) {
  552. dev_err(&usb_dev->dev,
  553. "non-Atmel transceiver xxxx%02x%02x\n",
  554. man_id_1, man_id_0);
  555. goto fail;
  556. }
  557. switch (part_num) {
  558. case 2:
  559. chip = "AT86RF230";
  560. break;
  561. case 3:
  562. chip = "AT86RF231";
  563. break;
  564. default:
  565. dev_err(&usb_dev->dev,
  566. "unexpected transceiver, part 0x%02x version 0x%02x\n",
  567. part_num, version_num);
  568. goto fail;
  569. }
  570. dev_info(&usb_dev->dev, "ATUSB: %s version %d\n", chip, version_num);
  571. return 0;
  572. fail:
  573. atusb->err = -ENODEV;
  574. return -ENODEV;
  575. }
  576. /* ----- Setup ------------------------------------------------------------- */
  577. static int atusb_probe(struct usb_interface *interface,
  578. const struct usb_device_id *id)
  579. {
  580. struct usb_device *usb_dev = interface_to_usbdev(interface);
  581. struct ieee802154_hw *hw;
  582. struct atusb *atusb = NULL;
  583. int ret = -ENOMEM;
  584. hw = ieee802154_alloc_hw(sizeof(struct atusb), &atusb_ops);
  585. if (!hw)
  586. return -ENOMEM;
  587. atusb = hw->priv;
  588. atusb->hw = hw;
  589. atusb->usb_dev = usb_get_dev(usb_dev);
  590. usb_set_intfdata(interface, atusb);
  591. atusb->shutdown = 0;
  592. atusb->err = 0;
  593. INIT_DELAYED_WORK(&atusb->work, atusb_work_urbs);
  594. init_usb_anchor(&atusb->idle_urbs);
  595. init_usb_anchor(&atusb->rx_urbs);
  596. if (atusb_alloc_urbs(atusb, ATUSB_NUM_RX_URBS))
  597. goto fail;
  598. atusb->tx_dr.bRequestType = ATUSB_REQ_TO_DEV;
  599. atusb->tx_dr.bRequest = ATUSB_TX;
  600. atusb->tx_dr.wValue = cpu_to_le16(0);
  601. atusb->tx_urb = usb_alloc_urb(0, GFP_ATOMIC);
  602. if (!atusb->tx_urb)
  603. goto fail;
  604. hw->parent = &usb_dev->dev;
  605. hw->flags = IEEE802154_HW_TX_OMIT_CKSUM | IEEE802154_HW_AFILT |
  606. IEEE802154_HW_PROMISCUOUS | IEEE802154_HW_CSMA_PARAMS;
  607. hw->phy->flags = WPAN_PHY_FLAG_TXPOWER | WPAN_PHY_FLAG_CCA_ED_LEVEL |
  608. WPAN_PHY_FLAG_CCA_MODE;
  609. hw->phy->supported.cca_modes = BIT(NL802154_CCA_ENERGY) |
  610. BIT(NL802154_CCA_CARRIER) | BIT(NL802154_CCA_ENERGY_CARRIER);
  611. hw->phy->supported.cca_opts = BIT(NL802154_CCA_OPT_ENERGY_CARRIER_AND) |
  612. BIT(NL802154_CCA_OPT_ENERGY_CARRIER_OR);
  613. hw->phy->supported.cca_ed_levels = atusb_ed_levels;
  614. hw->phy->supported.cca_ed_levels_size = ARRAY_SIZE(atusb_ed_levels);
  615. hw->phy->cca.mode = NL802154_CCA_ENERGY;
  616. hw->phy->current_page = 0;
  617. hw->phy->current_channel = 11; /* reset default */
  618. hw->phy->supported.channels[0] = 0x7FFF800;
  619. hw->phy->supported.tx_powers = atusb_powers;
  620. hw->phy->supported.tx_powers_size = ARRAY_SIZE(atusb_powers);
  621. hw->phy->transmit_power = hw->phy->supported.tx_powers[0];
  622. ieee802154_random_extended_addr(&hw->phy->perm_extended_addr);
  623. hw->phy->cca_ed_level = hw->phy->supported.cca_ed_levels[7];
  624. atusb_command(atusb, ATUSB_RF_RESET, 0);
  625. atusb_get_and_show_chip(atusb);
  626. atusb_get_and_show_revision(atusb);
  627. atusb_get_and_show_build(atusb);
  628. ret = atusb_get_and_clear_error(atusb);
  629. if (ret) {
  630. dev_err(&atusb->usb_dev->dev,
  631. "%s: initialization failed, error = %d\n",
  632. __func__, ret);
  633. goto fail;
  634. }
  635. ret = ieee802154_register_hw(hw);
  636. if (ret)
  637. goto fail;
  638. /* If we just powered on, we're now in P_ON and need to enter TRX_OFF
  639. * explicitly. Any resets after that will send us straight to TRX_OFF,
  640. * making the command below redundant.
  641. */
  642. atusb_write_reg(atusb, RG_TRX_STATE, STATE_FORCE_TRX_OFF);
  643. msleep(1); /* reset => TRX_OFF, tTR13 = 37 us */
  644. #if 0
  645. /* Calculating the maximum time available to empty the frame buffer
  646. * on reception:
  647. *
  648. * According to [1], the inter-frame gap is
  649. * R * 20 * 16 us + 128 us
  650. * where R is a random number from 0 to 7. Furthermore, we have 20 bit
  651. * times (80 us at 250 kbps) of SHR of the next frame before the
  652. * transceiver begins storing data in the frame buffer.
  653. *
  654. * This yields a minimum time of 208 us between the last data of a
  655. * frame and the first data of the next frame. This time is further
  656. * reduced by interrupt latency in the atusb firmware.
  657. *
  658. * atusb currently needs about 500 us to retrieve a maximum-sized
  659. * frame. We therefore have to allow reception of a new frame to begin
  660. * while we retrieve the previous frame.
  661. *
  662. * [1] "JN-AN-1035 Calculating data rates in an IEEE 802.15.4-based
  663. * network", Jennic 2006.
  664. * http://www.jennic.com/download_file.php?supportFile=JN-AN-1035%20Calculating%20802-15-4%20Data%20Rates-1v0.pdf
  665. */
  666. atusb_write_subreg(atusb, SR_RX_SAFE_MODE, 1);
  667. #endif
  668. atusb_write_reg(atusb, RG_IRQ_MASK, 0xff);
  669. ret = atusb_get_and_clear_error(atusb);
  670. if (!ret)
  671. return 0;
  672. dev_err(&atusb->usb_dev->dev,
  673. "%s: setup failed, error = %d\n",
  674. __func__, ret);
  675. ieee802154_unregister_hw(hw);
  676. fail:
  677. atusb_free_urbs(atusb);
  678. usb_kill_urb(atusb->tx_urb);
  679. usb_free_urb(atusb->tx_urb);
  680. usb_put_dev(usb_dev);
  681. ieee802154_free_hw(hw);
  682. return ret;
  683. }
  684. static void atusb_disconnect(struct usb_interface *interface)
  685. {
  686. struct atusb *atusb = usb_get_intfdata(interface);
  687. dev_dbg(&atusb->usb_dev->dev, "atusb_disconnect\n");
  688. atusb->shutdown = 1;
  689. cancel_delayed_work_sync(&atusb->work);
  690. usb_kill_anchored_urbs(&atusb->rx_urbs);
  691. atusb_free_urbs(atusb);
  692. usb_kill_urb(atusb->tx_urb);
  693. usb_free_urb(atusb->tx_urb);
  694. ieee802154_unregister_hw(atusb->hw);
  695. ieee802154_free_hw(atusb->hw);
  696. usb_set_intfdata(interface, NULL);
  697. usb_put_dev(atusb->usb_dev);
  698. pr_debug("atusb_disconnect done\n");
  699. }
  700. /* The devices we work with */
  701. static const struct usb_device_id atusb_device_table[] = {
  702. {
  703. .match_flags = USB_DEVICE_ID_MATCH_DEVICE |
  704. USB_DEVICE_ID_MATCH_INT_INFO,
  705. .idVendor = ATUSB_VENDOR_ID,
  706. .idProduct = ATUSB_PRODUCT_ID,
  707. .bInterfaceClass = USB_CLASS_VENDOR_SPEC
  708. },
  709. /* end with null element */
  710. {}
  711. };
  712. MODULE_DEVICE_TABLE(usb, atusb_device_table);
  713. static struct usb_driver atusb_driver = {
  714. .name = "atusb",
  715. .probe = atusb_probe,
  716. .disconnect = atusb_disconnect,
  717. .id_table = atusb_device_table,
  718. };
  719. module_usb_driver(atusb_driver);
  720. MODULE_AUTHOR("Alexander Aring <alex.aring@gmail.com>");
  721. MODULE_AUTHOR("Richard Sharpe <realrichardsharpe@gmail.com>");
  722. MODULE_AUTHOR("Stefan Schmidt <stefan@datenfreihafen.org>");
  723. MODULE_AUTHOR("Werner Almesberger <werner@almesberger.net>");
  724. MODULE_DESCRIPTION("ATUSB IEEE 802.15.4 Driver");
  725. MODULE_LICENSE("GPL");