wusbhc.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509
  1. /*
  2. * Wireless USB Host Controller
  3. * sysfs glue, wusbcore module support and life cycle management
  4. *
  5. *
  6. * Copyright (C) 2005-2006 Intel Corporation
  7. * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
  8. *
  9. * This program is free software; you can redistribute it and/or
  10. * modify it under the terms of the GNU General Public License version
  11. * 2 as published by the Free Software Foundation.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  21. * 02110-1301, USA.
  22. *
  23. *
  24. * Creation/destruction of wusbhc is split in two parts; that that
  25. * doesn't require the HCD to be added (wusbhc_{create,destroy}) and
  26. * the one that requires (phase B, wusbhc_b_{create,destroy}).
  27. *
  28. * This is so because usb_add_hcd() will start the HC, and thus, all
  29. * the HC specific stuff has to be already initialized (like sysfs
  30. * thingies).
  31. */
  32. #include <linux/device.h>
  33. #include <linux/module.h>
  34. #include "wusbhc.h"
  35. /**
  36. * Extract the wusbhc that corresponds to a USB Host Controller class device
  37. *
  38. * WARNING! Apply only if @dev is that of a
  39. * wusbhc.usb_hcd.self->class_dev; otherwise, you loose.
  40. */
  41. static struct wusbhc *usbhc_dev_to_wusbhc(struct device *dev)
  42. {
  43. struct usb_bus *usb_bus = dev_get_drvdata(dev);
  44. struct usb_hcd *usb_hcd = bus_to_hcd(usb_bus);
  45. return usb_hcd_to_wusbhc(usb_hcd);
  46. }
  47. /*
  48. * Show & store the current WUSB trust timeout
  49. *
  50. * We don't do locking--it is an 'atomic' value.
  51. *
  52. * The units that we store/show are always MILLISECONDS. However, the
  53. * value of trust_timeout is jiffies.
  54. */
  55. static ssize_t wusb_trust_timeout_show(struct device *dev,
  56. struct device_attribute *attr,
  57. char *buf)
  58. {
  59. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  60. return scnprintf(buf, PAGE_SIZE, "%u\n", wusbhc->trust_timeout);
  61. }
  62. static ssize_t wusb_trust_timeout_store(struct device *dev,
  63. struct device_attribute *attr,
  64. const char *buf, size_t size)
  65. {
  66. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  67. ssize_t result = -ENOSYS;
  68. unsigned trust_timeout;
  69. result = sscanf(buf, "%u", &trust_timeout);
  70. if (result != 1) {
  71. result = -EINVAL;
  72. goto out;
  73. }
  74. wusbhc->trust_timeout = min_t(unsigned, trust_timeout, 500);
  75. cancel_delayed_work(&wusbhc->keep_alive_timer);
  76. flush_workqueue(wusbd);
  77. queue_delayed_work(wusbd, &wusbhc->keep_alive_timer,
  78. msecs_to_jiffies(wusbhc->trust_timeout / 2));
  79. out:
  80. return result < 0 ? result : size;
  81. }
  82. static DEVICE_ATTR_RW(wusb_trust_timeout);
  83. /*
  84. * Show the current WUSB CHID.
  85. */
  86. static ssize_t wusb_chid_show(struct device *dev,
  87. struct device_attribute *attr, char *buf)
  88. {
  89. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  90. const struct wusb_ckhdid *chid;
  91. ssize_t result = 0;
  92. if (wusbhc->wuie_host_info != NULL)
  93. chid = &wusbhc->wuie_host_info->CHID;
  94. else
  95. chid = &wusb_ckhdid_zero;
  96. result += ckhdid_printf(buf, PAGE_SIZE, chid);
  97. result += sprintf(buf + result, "\n");
  98. return result;
  99. }
  100. /*
  101. * Store a new CHID.
  102. *
  103. * - Write an all zeros CHID and it will stop the controller
  104. * - Write a non-zero CHID and it will start it.
  105. *
  106. * See wusbhc_chid_set() for more info.
  107. */
  108. static ssize_t wusb_chid_store(struct device *dev,
  109. struct device_attribute *attr,
  110. const char *buf, size_t size)
  111. {
  112. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  113. struct wusb_ckhdid chid;
  114. ssize_t result;
  115. result = sscanf(buf,
  116. "%02hhx %02hhx %02hhx %02hhx "
  117. "%02hhx %02hhx %02hhx %02hhx "
  118. "%02hhx %02hhx %02hhx %02hhx "
  119. "%02hhx %02hhx %02hhx %02hhx\n",
  120. &chid.data[0] , &chid.data[1] ,
  121. &chid.data[2] , &chid.data[3] ,
  122. &chid.data[4] , &chid.data[5] ,
  123. &chid.data[6] , &chid.data[7] ,
  124. &chid.data[8] , &chid.data[9] ,
  125. &chid.data[10], &chid.data[11],
  126. &chid.data[12], &chid.data[13],
  127. &chid.data[14], &chid.data[15]);
  128. if (result != 16) {
  129. dev_err(dev, "Unrecognized CHID (need 16 8-bit hex digits): "
  130. "%d\n", (int)result);
  131. return -EINVAL;
  132. }
  133. result = wusbhc_chid_set(wusbhc, &chid);
  134. return result < 0 ? result : size;
  135. }
  136. static DEVICE_ATTR_RW(wusb_chid);
  137. static ssize_t wusb_phy_rate_show(struct device *dev,
  138. struct device_attribute *attr,
  139. char *buf)
  140. {
  141. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  142. return sprintf(buf, "%d\n", wusbhc->phy_rate);
  143. }
  144. static ssize_t wusb_phy_rate_store(struct device *dev,
  145. struct device_attribute *attr,
  146. const char *buf, size_t size)
  147. {
  148. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  149. uint8_t phy_rate;
  150. ssize_t result;
  151. result = sscanf(buf, "%hhu", &phy_rate);
  152. if (result != 1)
  153. return -EINVAL;
  154. if (phy_rate >= UWB_PHY_RATE_INVALID)
  155. return -EINVAL;
  156. wusbhc->phy_rate = phy_rate;
  157. return size;
  158. }
  159. static DEVICE_ATTR_RW(wusb_phy_rate);
  160. static ssize_t wusb_dnts_show(struct device *dev,
  161. struct device_attribute *attr,
  162. char *buf)
  163. {
  164. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  165. return sprintf(buf, "num slots: %d\ninterval: %dms\n",
  166. wusbhc->dnts_num_slots, wusbhc->dnts_interval);
  167. }
  168. static ssize_t wusb_dnts_store(struct device *dev,
  169. struct device_attribute *attr,
  170. const char *buf, size_t size)
  171. {
  172. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  173. uint8_t num_slots, interval;
  174. ssize_t result;
  175. result = sscanf(buf, "%hhu %hhu", &num_slots, &interval);
  176. if (result != 2)
  177. return -EINVAL;
  178. wusbhc->dnts_num_slots = num_slots;
  179. wusbhc->dnts_interval = interval;
  180. return size;
  181. }
  182. static DEVICE_ATTR_RW(wusb_dnts);
  183. static ssize_t wusb_retry_count_show(struct device *dev,
  184. struct device_attribute *attr,
  185. char *buf)
  186. {
  187. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  188. return sprintf(buf, "%d\n", wusbhc->retry_count);
  189. }
  190. static ssize_t wusb_retry_count_store(struct device *dev,
  191. struct device_attribute *attr,
  192. const char *buf, size_t size)
  193. {
  194. struct wusbhc *wusbhc = usbhc_dev_to_wusbhc(dev);
  195. uint8_t retry_count;
  196. ssize_t result;
  197. result = sscanf(buf, "%hhu", &retry_count);
  198. if (result != 1)
  199. return -EINVAL;
  200. wusbhc->retry_count = max_t(uint8_t, retry_count,
  201. WUSB_RETRY_COUNT_MAX);
  202. return size;
  203. }
  204. static DEVICE_ATTR_RW(wusb_retry_count);
  205. /* Group all the WUSBHC attributes */
  206. static struct attribute *wusbhc_attrs[] = {
  207. &dev_attr_wusb_trust_timeout.attr,
  208. &dev_attr_wusb_chid.attr,
  209. &dev_attr_wusb_phy_rate.attr,
  210. &dev_attr_wusb_dnts.attr,
  211. &dev_attr_wusb_retry_count.attr,
  212. NULL,
  213. };
  214. static const struct attribute_group wusbhc_attr_group = {
  215. .name = NULL, /* we want them in the same directory */
  216. .attrs = wusbhc_attrs,
  217. };
  218. /*
  219. * Create a wusbhc instance
  220. *
  221. * NOTEs:
  222. *
  223. * - assumes *wusbhc has been zeroed and wusbhc->usb_hcd has been
  224. * initialized but not added.
  225. *
  226. * - fill out ports_max, mmcies_max and mmcie_{add,rm} before calling.
  227. *
  228. * - fill out wusbhc->uwb_rc and refcount it before calling
  229. * - fill out the wusbhc->sec_modes array
  230. */
  231. int wusbhc_create(struct wusbhc *wusbhc)
  232. {
  233. int result = 0;
  234. /* set defaults. These can be overwritten using sysfs attributes. */
  235. wusbhc->trust_timeout = WUSB_TRUST_TIMEOUT_MS;
  236. wusbhc->phy_rate = UWB_PHY_RATE_INVALID - 1;
  237. wusbhc->dnts_num_slots = 4;
  238. wusbhc->dnts_interval = 2;
  239. wusbhc->retry_count = WUSB_RETRY_COUNT_INFINITE;
  240. mutex_init(&wusbhc->mutex);
  241. result = wusbhc_mmcie_create(wusbhc);
  242. if (result < 0)
  243. goto error_mmcie_create;
  244. result = wusbhc_devconnect_create(wusbhc);
  245. if (result < 0)
  246. goto error_devconnect_create;
  247. result = wusbhc_rh_create(wusbhc);
  248. if (result < 0)
  249. goto error_rh_create;
  250. result = wusbhc_sec_create(wusbhc);
  251. if (result < 0)
  252. goto error_sec_create;
  253. return 0;
  254. error_sec_create:
  255. wusbhc_rh_destroy(wusbhc);
  256. error_rh_create:
  257. wusbhc_devconnect_destroy(wusbhc);
  258. error_devconnect_create:
  259. wusbhc_mmcie_destroy(wusbhc);
  260. error_mmcie_create:
  261. return result;
  262. }
  263. EXPORT_SYMBOL_GPL(wusbhc_create);
  264. static inline struct kobject *wusbhc_kobj(struct wusbhc *wusbhc)
  265. {
  266. return &wusbhc->usb_hcd.self.controller->kobj;
  267. }
  268. /*
  269. * Phase B of a wusbhc instance creation
  270. *
  271. * Creates fields that depend on wusbhc->usb_hcd having been
  272. * added. This is where we create the sysfs files in
  273. * /sys/class/usb_host/usb_hostX/.
  274. *
  275. * NOTE: Assumes wusbhc->usb_hcd has been already added by the upper
  276. * layer (hwahc or whci)
  277. */
  278. int wusbhc_b_create(struct wusbhc *wusbhc)
  279. {
  280. int result = 0;
  281. struct device *dev = wusbhc->usb_hcd.self.controller;
  282. result = sysfs_create_group(wusbhc_kobj(wusbhc), &wusbhc_attr_group);
  283. if (result < 0) {
  284. dev_err(dev, "Cannot register WUSBHC attributes: %d\n",
  285. result);
  286. goto error_create_attr_group;
  287. }
  288. return 0;
  289. error_create_attr_group:
  290. return result;
  291. }
  292. EXPORT_SYMBOL_GPL(wusbhc_b_create);
  293. void wusbhc_b_destroy(struct wusbhc *wusbhc)
  294. {
  295. wusbhc_pal_unregister(wusbhc);
  296. sysfs_remove_group(wusbhc_kobj(wusbhc), &wusbhc_attr_group);
  297. }
  298. EXPORT_SYMBOL_GPL(wusbhc_b_destroy);
  299. void wusbhc_destroy(struct wusbhc *wusbhc)
  300. {
  301. wusbhc_sec_destroy(wusbhc);
  302. wusbhc_rh_destroy(wusbhc);
  303. wusbhc_devconnect_destroy(wusbhc);
  304. wusbhc_mmcie_destroy(wusbhc);
  305. }
  306. EXPORT_SYMBOL_GPL(wusbhc_destroy);
  307. struct workqueue_struct *wusbd;
  308. EXPORT_SYMBOL_GPL(wusbd);
  309. /*
  310. * WUSB Cluster ID allocation map
  311. *
  312. * Each WUSB bus in a channel is identified with a Cluster Id in the
  313. * unauth address pace (WUSB1.0[4.3]). We take the range 0xe0 to 0xff
  314. * (that's space for 31 WUSB controllers, as 0xff can't be taken). We
  315. * start taking from 0xff, 0xfe, 0xfd... (hence the += or -= 0xff).
  316. *
  317. * For each one we taken, we pin it in the bitap
  318. */
  319. #define CLUSTER_IDS 32
  320. static DECLARE_BITMAP(wusb_cluster_id_table, CLUSTER_IDS);
  321. static DEFINE_SPINLOCK(wusb_cluster_ids_lock);
  322. /*
  323. * Get a WUSB Cluster ID
  324. *
  325. * Need to release with wusb_cluster_id_put() when done w/ it.
  326. */
  327. /* FIXME: coordinate with the choose_addres() from the USB stack */
  328. /* we want to leave the top of the 128 range for cluster addresses and
  329. * the bottom for device addresses (as we map them one on one with
  330. * ports). */
  331. u8 wusb_cluster_id_get(void)
  332. {
  333. u8 id;
  334. spin_lock(&wusb_cluster_ids_lock);
  335. id = find_first_zero_bit(wusb_cluster_id_table, CLUSTER_IDS);
  336. if (id >= CLUSTER_IDS) {
  337. id = 0;
  338. goto out;
  339. }
  340. set_bit(id, wusb_cluster_id_table);
  341. id = (u8) 0xff - id;
  342. out:
  343. spin_unlock(&wusb_cluster_ids_lock);
  344. return id;
  345. }
  346. EXPORT_SYMBOL_GPL(wusb_cluster_id_get);
  347. /*
  348. * Release a WUSB Cluster ID
  349. *
  350. * Obtained it with wusb_cluster_id_get()
  351. */
  352. void wusb_cluster_id_put(u8 id)
  353. {
  354. id = 0xff - id;
  355. BUG_ON(id >= CLUSTER_IDS);
  356. spin_lock(&wusb_cluster_ids_lock);
  357. WARN_ON(!test_bit(id, wusb_cluster_id_table));
  358. clear_bit(id, wusb_cluster_id_table);
  359. spin_unlock(&wusb_cluster_ids_lock);
  360. }
  361. EXPORT_SYMBOL_GPL(wusb_cluster_id_put);
  362. /**
  363. * wusbhc_giveback_urb - return an URB to the USB core
  364. * @wusbhc: the host controller the URB is from.
  365. * @urb: the URB.
  366. * @status: the URB's status.
  367. *
  368. * Return an URB to the USB core doing some additional WUSB specific
  369. * processing.
  370. *
  371. * - After a successful transfer, update the trust timeout timestamp
  372. * for the WUSB device.
  373. *
  374. * - [WUSB] sections 4.13 and 7.5.1 specify the stop retransmission
  375. * condition for the WCONNECTACK_IE is that the host has observed
  376. * the associated device responding to a control transfer.
  377. */
  378. void wusbhc_giveback_urb(struct wusbhc *wusbhc, struct urb *urb, int status)
  379. {
  380. struct wusb_dev *wusb_dev = __wusb_dev_get_by_usb_dev(wusbhc,
  381. urb->dev);
  382. if (status == 0 && wusb_dev) {
  383. wusb_dev->entry_ts = jiffies;
  384. /* wusbhc_devconnect_acked() can't be called from
  385. atomic context so defer it to a work queue. */
  386. if (!list_empty(&wusb_dev->cack_node))
  387. queue_work(wusbd, &wusb_dev->devconnect_acked_work);
  388. else
  389. wusb_dev_put(wusb_dev);
  390. }
  391. usb_hcd_giveback_urb(&wusbhc->usb_hcd, urb, status);
  392. }
  393. EXPORT_SYMBOL_GPL(wusbhc_giveback_urb);
  394. /**
  395. * wusbhc_reset_all - reset the HC hardware
  396. * @wusbhc: the host controller to reset.
  397. *
  398. * Request a full hardware reset of the chip. This will also reset
  399. * the radio controller and any other PALs.
  400. */
  401. void wusbhc_reset_all(struct wusbhc *wusbhc)
  402. {
  403. if (wusbhc->uwb_rc)
  404. uwb_rc_reset_all(wusbhc->uwb_rc);
  405. }
  406. EXPORT_SYMBOL_GPL(wusbhc_reset_all);
  407. static struct notifier_block wusb_usb_notifier = {
  408. .notifier_call = wusb_usb_ncb,
  409. .priority = INT_MAX /* Need to be called first of all */
  410. };
  411. static int __init wusbcore_init(void)
  412. {
  413. int result;
  414. result = wusb_crypto_init();
  415. if (result < 0)
  416. goto error_crypto_init;
  417. /* WQ is singlethread because we need to serialize notifications */
  418. wusbd = create_singlethread_workqueue("wusbd");
  419. if (wusbd == NULL) {
  420. result = -ENOMEM;
  421. printk(KERN_ERR "WUSB-core: Cannot create wusbd workqueue\n");
  422. goto error_wusbd_create;
  423. }
  424. usb_register_notify(&wusb_usb_notifier);
  425. bitmap_zero(wusb_cluster_id_table, CLUSTER_IDS);
  426. set_bit(0, wusb_cluster_id_table); /* reserve Cluster ID 0xff */
  427. return 0;
  428. error_wusbd_create:
  429. wusb_crypto_exit();
  430. error_crypto_init:
  431. return result;
  432. }
  433. module_init(wusbcore_init);
  434. static void __exit wusbcore_exit(void)
  435. {
  436. clear_bit(0, wusb_cluster_id_table);
  437. if (!bitmap_empty(wusb_cluster_id_table, CLUSTER_IDS)) {
  438. printk(KERN_ERR "BUG: WUSB Cluster IDs not released on exit: %*pb\n",
  439. CLUSTER_IDS, wusb_cluster_id_table);
  440. WARN_ON(1);
  441. }
  442. usb_unregister_notify(&wusb_usb_notifier);
  443. destroy_workqueue(wusbd);
  444. wusb_crypto_exit();
  445. }
  446. module_exit(wusbcore_exit);
  447. MODULE_AUTHOR("Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>");
  448. MODULE_DESCRIPTION("Wireless USB core");
  449. MODULE_LICENSE("GPL");