cdc-acm.c 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170
  1. /*
  2. * cdc-acm.c
  3. *
  4. * Copyright (c) 1999 Armin Fuerst <fuerst@in.tum.de>
  5. * Copyright (c) 1999 Pavel Machek <pavel@suse.cz>
  6. * Copyright (c) 1999 Johannes Erdfelt <johannes@erdfelt.com>
  7. * Copyright (c) 2000 Vojtech Pavlik <vojtech@suse.cz>
  8. * Copyright (c) 2004 Oliver Neukum <oliver@neukum.name>
  9. * Copyright (c) 2005 David Kubicek <dave@awk.cz>
  10. *
  11. * USB Abstract Control Model driver for USB modems and ISDN adapters
  12. *
  13. * Sponsored by SuSE
  14. *
  15. * ChangeLog:
  16. * v0.9 - thorough cleaning, URBification, almost a rewrite
  17. * v0.10 - some more cleanups
  18. * v0.11 - fixed flow control, read error doesn't stop reads
  19. * v0.12 - added TIOCM ioctls, added break handling, made struct acm kmalloced
  20. * v0.13 - added termios, added hangup
  21. * v0.14 - sized down struct acm
  22. * v0.15 - fixed flow control again - characters could be lost
  23. * v0.16 - added code for modems with swapped data and control interfaces
  24. * v0.17 - added new style probing
  25. * v0.18 - fixed new style probing for devices with more configurations
  26. * v0.19 - fixed CLOCAL handling (thanks to Richard Shih-Ping Chan)
  27. * v0.20 - switched to probing on interface (rather than device) class
  28. * v0.21 - revert to probing on device for devices with multiple configs
  29. * v0.22 - probe only the control interface. if usbcore doesn't choose the
  30. * config we want, sysadmin changes bConfigurationValue in sysfs.
  31. * v0.23 - use softirq for rx processing, as needed by tty layer
  32. * v0.24 - change probe method to evaluate CDC union descriptor
  33. * v0.25 - downstream tasks paralelized to maximize throughput
  34. */
  35. /*
  36. * This program is free software; you can redistribute it and/or modify
  37. * it under the terms of the GNU General Public License as published by
  38. * the Free Software Foundation; either version 2 of the License, or
  39. * (at your option) any later version.
  40. *
  41. * This program is distributed in the hope that it will be useful,
  42. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  43. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  44. * GNU General Public License for more details.
  45. *
  46. * You should have received a copy of the GNU General Public License
  47. * along with this program; if not, write to the Free Software
  48. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  49. */
  50. #undef DEBUG
  51. #include <linux/kernel.h>
  52. #include <linux/errno.h>
  53. #include <linux/init.h>
  54. #include <linux/slab.h>
  55. #include <linux/tty.h>
  56. #include <linux/tty_driver.h>
  57. #include <linux/tty_flip.h>
  58. #include <linux/module.h>
  59. #include <linux/smp_lock.h>
  60. #include <asm/uaccess.h>
  61. #include <linux/usb.h>
  62. #include <linux/usb_cdc.h>
  63. #include <asm/byteorder.h>
  64. #include <asm/unaligned.h>
  65. #include <linux/list.h>
  66. #include "cdc-acm.h"
  67. /*
  68. * Version Information
  69. */
  70. #define DRIVER_VERSION "v0.25"
  71. #define DRIVER_AUTHOR "Armin Fuerst, Pavel Machek, Johannes Erdfelt, Vojtech Pavlik, David Kubicek"
  72. #define DRIVER_DESC "USB Abstract Control Model driver for USB modems and ISDN adapters"
  73. static struct usb_driver acm_driver;
  74. static struct tty_driver *acm_tty_driver;
  75. static struct acm *acm_table[ACM_TTY_MINORS];
  76. static DECLARE_MUTEX(open_sem);
  77. #define ACM_READY(acm) (acm && acm->dev && acm->used)
  78. /*
  79. * Functions for ACM control messages.
  80. */
  81. static int acm_ctrl_msg(struct acm *acm, int request, int value, void *buf, int len)
  82. {
  83. int retval = usb_control_msg(acm->dev, usb_sndctrlpipe(acm->dev, 0),
  84. request, USB_RT_ACM, value,
  85. acm->control->altsetting[0].desc.bInterfaceNumber,
  86. buf, len, 5000);
  87. dbg("acm_control_msg: rq: 0x%02x val: %#x len: %#x result: %d", request, value, len, retval);
  88. return retval < 0 ? retval : 0;
  89. }
  90. /* devices aren't required to support these requests.
  91. * the cdc acm descriptor tells whether they do...
  92. */
  93. #define acm_set_control(acm, control) \
  94. acm_ctrl_msg(acm, USB_CDC_REQ_SET_CONTROL_LINE_STATE, control, NULL, 0)
  95. #define acm_set_line(acm, line) \
  96. acm_ctrl_msg(acm, USB_CDC_REQ_SET_LINE_CODING, 0, line, sizeof *(line))
  97. #define acm_send_break(acm, ms) \
  98. acm_ctrl_msg(acm, USB_CDC_REQ_SEND_BREAK, ms, NULL, 0)
  99. /*
  100. * Write buffer management.
  101. * All of these assume proper locks taken by the caller.
  102. */
  103. static int acm_wb_alloc(struct acm *acm)
  104. {
  105. int i, wbn;
  106. struct acm_wb *wb;
  107. wbn = acm->write_current;
  108. i = 0;
  109. for (;;) {
  110. wb = &acm->wb[wbn];
  111. if (!wb->use) {
  112. wb->use = 1;
  113. return wbn;
  114. }
  115. wbn = (wbn + 1) % ACM_NWB;
  116. if (++i >= ACM_NWB)
  117. return -1;
  118. }
  119. }
  120. static void acm_wb_free(struct acm *acm, int wbn)
  121. {
  122. acm->wb[wbn].use = 0;
  123. }
  124. static int acm_wb_is_avail(struct acm *acm)
  125. {
  126. int i, n;
  127. n = 0;
  128. for (i = 0; i < ACM_NWB; i++) {
  129. if (!acm->wb[i].use)
  130. n++;
  131. }
  132. return n;
  133. }
  134. static inline int acm_wb_is_used(struct acm *acm, int wbn)
  135. {
  136. return acm->wb[wbn].use;
  137. }
  138. /*
  139. * Finish write.
  140. */
  141. static void acm_write_done(struct acm *acm)
  142. {
  143. unsigned long flags;
  144. int wbn;
  145. spin_lock_irqsave(&acm->write_lock, flags);
  146. acm->write_ready = 1;
  147. wbn = acm->write_current;
  148. acm_wb_free(acm, wbn);
  149. acm->write_current = (wbn + 1) % ACM_NWB;
  150. spin_unlock_irqrestore(&acm->write_lock, flags);
  151. }
  152. /*
  153. * Poke write.
  154. */
  155. static int acm_write_start(struct acm *acm)
  156. {
  157. unsigned long flags;
  158. int wbn;
  159. struct acm_wb *wb;
  160. int rc;
  161. spin_lock_irqsave(&acm->write_lock, flags);
  162. if (!acm->dev) {
  163. spin_unlock_irqrestore(&acm->write_lock, flags);
  164. return -ENODEV;
  165. }
  166. if (!acm->write_ready) {
  167. spin_unlock_irqrestore(&acm->write_lock, flags);
  168. return 0; /* A white lie */
  169. }
  170. wbn = acm->write_current;
  171. if (!acm_wb_is_used(acm, wbn)) {
  172. spin_unlock_irqrestore(&acm->write_lock, flags);
  173. return 0;
  174. }
  175. wb = &acm->wb[wbn];
  176. acm->write_ready = 0;
  177. spin_unlock_irqrestore(&acm->write_lock, flags);
  178. acm->writeurb->transfer_buffer = wb->buf;
  179. acm->writeurb->transfer_dma = wb->dmah;
  180. acm->writeurb->transfer_buffer_length = wb->len;
  181. acm->writeurb->dev = acm->dev;
  182. if ((rc = usb_submit_urb(acm->writeurb, GFP_ATOMIC)) < 0) {
  183. dbg("usb_submit_urb(write bulk) failed: %d", rc);
  184. acm_write_done(acm);
  185. }
  186. return rc;
  187. }
  188. /*
  189. * Interrupt handlers for various ACM device responses
  190. */
  191. /* control interface reports status changes with "interrupt" transfers */
  192. static void acm_ctrl_irq(struct urb *urb, struct pt_regs *regs)
  193. {
  194. struct acm *acm = urb->context;
  195. struct usb_cdc_notification *dr = urb->transfer_buffer;
  196. unsigned char *data;
  197. int newctrl;
  198. int status;
  199. switch (urb->status) {
  200. case 0:
  201. /* success */
  202. break;
  203. case -ECONNRESET:
  204. case -ENOENT:
  205. case -ESHUTDOWN:
  206. /* this urb is terminated, clean up */
  207. dbg("%s - urb shutting down with status: %d", __FUNCTION__, urb->status);
  208. return;
  209. default:
  210. dbg("%s - nonzero urb status received: %d", __FUNCTION__, urb->status);
  211. goto exit;
  212. }
  213. if (!ACM_READY(acm))
  214. goto exit;
  215. data = (unsigned char *)(dr + 1);
  216. switch (dr->bNotificationType) {
  217. case USB_CDC_NOTIFY_NETWORK_CONNECTION:
  218. dbg("%s network", dr->wValue ? "connected to" : "disconnected from");
  219. break;
  220. case USB_CDC_NOTIFY_SERIAL_STATE:
  221. newctrl = le16_to_cpu(get_unaligned((__le16 *) data));
  222. if (acm->tty && !acm->clocal && (acm->ctrlin & ~newctrl & ACM_CTRL_DCD)) {
  223. dbg("calling hangup");
  224. tty_hangup(acm->tty);
  225. }
  226. acm->ctrlin = newctrl;
  227. dbg("input control lines: dcd%c dsr%c break%c ring%c framing%c parity%c overrun%c",
  228. acm->ctrlin & ACM_CTRL_DCD ? '+' : '-', acm->ctrlin & ACM_CTRL_DSR ? '+' : '-',
  229. acm->ctrlin & ACM_CTRL_BRK ? '+' : '-', acm->ctrlin & ACM_CTRL_RI ? '+' : '-',
  230. acm->ctrlin & ACM_CTRL_FRAMING ? '+' : '-', acm->ctrlin & ACM_CTRL_PARITY ? '+' : '-',
  231. acm->ctrlin & ACM_CTRL_OVERRUN ? '+' : '-');
  232. break;
  233. default:
  234. dbg("unknown notification %d received: index %d len %d data0 %d data1 %d",
  235. dr->bNotificationType, dr->wIndex,
  236. dr->wLength, data[0], data[1]);
  237. break;
  238. }
  239. exit:
  240. status = usb_submit_urb (urb, GFP_ATOMIC);
  241. if (status)
  242. err ("%s - usb_submit_urb failed with result %d",
  243. __FUNCTION__, status);
  244. }
  245. /* data interface returns incoming bytes, or we got unthrottled */
  246. static void acm_read_bulk(struct urb *urb, struct pt_regs *regs)
  247. {
  248. struct acm_rb *buf;
  249. struct acm_ru *rcv = urb->context;
  250. struct acm *acm = rcv->instance;
  251. dbg("Entering acm_read_bulk with status %d\n", urb->status);
  252. if (!ACM_READY(acm))
  253. return;
  254. if (urb->status)
  255. dev_dbg(&acm->data->dev, "bulk rx status %d\n", urb->status);
  256. buf = rcv->buffer;
  257. buf->size = urb->actual_length;
  258. spin_lock(&acm->read_lock);
  259. list_add_tail(&rcv->list, &acm->spare_read_urbs);
  260. list_add_tail(&buf->list, &acm->filled_read_bufs);
  261. spin_unlock(&acm->read_lock);
  262. tasklet_schedule(&acm->urb_task);
  263. }
  264. static void acm_rx_tasklet(unsigned long _acm)
  265. {
  266. struct acm *acm = (void *)_acm;
  267. struct acm_rb *buf;
  268. struct tty_struct *tty = acm->tty;
  269. struct acm_ru *rcv;
  270. //unsigned long flags;
  271. int i = 0;
  272. dbg("Entering acm_rx_tasklet");
  273. if (!ACM_READY(acm) || acm->throttle)
  274. return;
  275. next_buffer:
  276. spin_lock(&acm->read_lock);
  277. if (list_empty(&acm->filled_read_bufs)) {
  278. spin_unlock(&acm->read_lock);
  279. goto urbs;
  280. }
  281. buf = list_entry(acm->filled_read_bufs.next,
  282. struct acm_rb, list);
  283. list_del(&buf->list);
  284. spin_unlock(&acm->read_lock);
  285. dbg("acm_rx_tasklet: procesing buf 0x%p, size = %d\n", buf, buf->size);
  286. for (i = 0; i < buf->size && !acm->throttle; i++) {
  287. /* if we insert more than TTY_FLIPBUF_SIZE characters,
  288. we drop them. */
  289. if (tty->flip.count >= TTY_FLIPBUF_SIZE) {
  290. tty_flip_buffer_push(tty);
  291. }
  292. tty_insert_flip_char(tty, buf->base[i], 0);
  293. }
  294. tty_flip_buffer_push(tty);
  295. spin_lock(&acm->throttle_lock);
  296. if (acm->throttle) {
  297. dbg("Throtteling noticed");
  298. memmove(buf->base, buf->base + i, buf->size - i);
  299. buf->size -= i;
  300. spin_unlock(&acm->throttle_lock);
  301. spin_lock(&acm->read_lock);
  302. list_add(&buf->list, &acm->filled_read_bufs);
  303. spin_unlock(&acm->read_lock);
  304. return;
  305. }
  306. spin_unlock(&acm->throttle_lock);
  307. spin_lock(&acm->read_lock);
  308. list_add(&buf->list, &acm->spare_read_bufs);
  309. spin_unlock(&acm->read_lock);
  310. goto next_buffer;
  311. urbs:
  312. while (!list_empty(&acm->spare_read_bufs)) {
  313. spin_lock(&acm->read_lock);
  314. if (list_empty(&acm->spare_read_urbs)) {
  315. spin_unlock(&acm->read_lock);
  316. return;
  317. }
  318. rcv = list_entry(acm->spare_read_urbs.next,
  319. struct acm_ru, list);
  320. list_del(&rcv->list);
  321. spin_unlock(&acm->read_lock);
  322. buf = list_entry(acm->spare_read_bufs.next,
  323. struct acm_rb, list);
  324. list_del(&buf->list);
  325. rcv->buffer = buf;
  326. usb_fill_bulk_urb(rcv->urb, acm->dev,
  327. acm->rx_endpoint,
  328. buf->base,
  329. acm->readsize,
  330. acm_read_bulk, rcv);
  331. rcv->urb->transfer_dma = buf->dma;
  332. rcv->urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  333. dbg("acm_rx_tasklet: sending urb 0x%p, rcv 0x%p, buf 0x%p\n", rcv->urb, rcv, buf);
  334. /* This shouldn't kill the driver as unsuccessful URBs are returned to the
  335. free-urbs-pool and resubmited ASAP */
  336. if (usb_submit_urb(rcv->urb, GFP_ATOMIC) < 0) {
  337. list_add(&buf->list, &acm->spare_read_bufs);
  338. spin_lock(&acm->read_lock);
  339. list_add(&rcv->list, &acm->spare_read_urbs);
  340. spin_unlock(&acm->read_lock);
  341. return;
  342. }
  343. }
  344. }
  345. /* data interface wrote those outgoing bytes */
  346. static void acm_write_bulk(struct urb *urb, struct pt_regs *regs)
  347. {
  348. struct acm *acm = (struct acm *)urb->context;
  349. dbg("Entering acm_write_bulk with status %d\n", urb->status);
  350. acm_write_done(acm);
  351. acm_write_start(acm);
  352. if (ACM_READY(acm))
  353. schedule_work(&acm->work);
  354. }
  355. static void acm_softint(void *private)
  356. {
  357. struct acm *acm = private;
  358. dbg("Entering acm_softint.\n");
  359. if (!ACM_READY(acm))
  360. return;
  361. tty_wakeup(acm->tty);
  362. }
  363. /*
  364. * TTY handlers
  365. */
  366. static int acm_tty_open(struct tty_struct *tty, struct file *filp)
  367. {
  368. struct acm *acm;
  369. int rv = -EINVAL;
  370. int i;
  371. dbg("Entering acm_tty_open.\n");
  372. down(&open_sem);
  373. acm = acm_table[tty->index];
  374. if (!acm || !acm->dev)
  375. goto err_out;
  376. else
  377. rv = 0;
  378. tty->driver_data = acm;
  379. acm->tty = tty;
  380. /* force low_latency on so that our tty_push actually forces the data through,
  381. otherwise it is scheduled, and with high data rates data can get lost. */
  382. tty->low_latency = 1;
  383. if (acm->used++) {
  384. goto done;
  385. }
  386. acm->ctrlurb->dev = acm->dev;
  387. if (usb_submit_urb(acm->ctrlurb, GFP_KERNEL)) {
  388. dbg("usb_submit_urb(ctrl irq) failed");
  389. goto bail_out;
  390. }
  391. if (0 > acm_set_control(acm, acm->ctrlout = ACM_CTRL_DTR | ACM_CTRL_RTS))
  392. goto full_bailout;
  393. INIT_LIST_HEAD(&acm->spare_read_urbs);
  394. INIT_LIST_HEAD(&acm->spare_read_bufs);
  395. INIT_LIST_HEAD(&acm->filled_read_bufs);
  396. for (i = 0; i < ACM_NRU; i++) {
  397. list_add(&(acm->ru[i].list), &acm->spare_read_urbs);
  398. }
  399. for (i = 0; i < ACM_NRB; i++) {
  400. list_add(&(acm->rb[i].list), &acm->spare_read_bufs);
  401. }
  402. tasklet_schedule(&acm->urb_task);
  403. done:
  404. err_out:
  405. up(&open_sem);
  406. return rv;
  407. full_bailout:
  408. usb_kill_urb(acm->ctrlurb);
  409. bail_out:
  410. acm->used--;
  411. up(&open_sem);
  412. return -EIO;
  413. }
  414. static void acm_tty_unregister(struct acm *acm)
  415. {
  416. int i;
  417. tty_unregister_device(acm_tty_driver, acm->minor);
  418. usb_put_intf(acm->control);
  419. acm_table[acm->minor] = NULL;
  420. usb_free_urb(acm->ctrlurb);
  421. usb_free_urb(acm->writeurb);
  422. for (i = 0; i < ACM_NRU; i++)
  423. usb_free_urb(acm->ru[i].urb);
  424. kfree(acm);
  425. }
  426. static void acm_tty_close(struct tty_struct *tty, struct file *filp)
  427. {
  428. struct acm *acm = tty->driver_data;
  429. int i;
  430. if (!acm || !acm->used)
  431. return;
  432. down(&open_sem);
  433. if (!--acm->used) {
  434. if (acm->dev) {
  435. acm_set_control(acm, acm->ctrlout = 0);
  436. usb_kill_urb(acm->ctrlurb);
  437. usb_kill_urb(acm->writeurb);
  438. for (i = 0; i < ACM_NRU; i++)
  439. usb_kill_urb(acm->ru[i].urb);
  440. } else
  441. acm_tty_unregister(acm);
  442. }
  443. up(&open_sem);
  444. }
  445. static int acm_tty_write(struct tty_struct *tty, const unsigned char *buf, int count)
  446. {
  447. struct acm *acm = tty->driver_data;
  448. int stat;
  449. unsigned long flags;
  450. int wbn;
  451. struct acm_wb *wb;
  452. dbg("Entering acm_tty_write to write %d bytes,\n", count);
  453. if (!ACM_READY(acm))
  454. return -EINVAL;
  455. if (!count)
  456. return 0;
  457. spin_lock_irqsave(&acm->write_lock, flags);
  458. if ((wbn = acm_wb_alloc(acm)) < 0) {
  459. spin_unlock_irqrestore(&acm->write_lock, flags);
  460. acm_write_start(acm);
  461. return 0;
  462. }
  463. wb = &acm->wb[wbn];
  464. count = (count > acm->writesize) ? acm->writesize : count;
  465. dbg("Get %d bytes...", count);
  466. memcpy(wb->buf, buf, count);
  467. wb->len = count;
  468. spin_unlock_irqrestore(&acm->write_lock, flags);
  469. if ((stat = acm_write_start(acm)) < 0)
  470. return stat;
  471. return count;
  472. }
  473. static int acm_tty_write_room(struct tty_struct *tty)
  474. {
  475. struct acm *acm = tty->driver_data;
  476. if (!ACM_READY(acm))
  477. return -EINVAL;
  478. /*
  479. * Do not let the line discipline to know that we have a reserve,
  480. * or it might get too enthusiastic.
  481. */
  482. return (acm->write_ready && acm_wb_is_avail(acm)) ? acm->writesize : 0;
  483. }
  484. static int acm_tty_chars_in_buffer(struct tty_struct *tty)
  485. {
  486. struct acm *acm = tty->driver_data;
  487. if (!ACM_READY(acm))
  488. return -EINVAL;
  489. /*
  490. * This is inaccurate (overcounts), but it works.
  491. */
  492. return (ACM_NWB - acm_wb_is_avail(acm)) * acm->writesize;
  493. }
  494. static void acm_tty_throttle(struct tty_struct *tty)
  495. {
  496. struct acm *acm = tty->driver_data;
  497. if (!ACM_READY(acm))
  498. return;
  499. spin_lock_bh(&acm->throttle_lock);
  500. acm->throttle = 1;
  501. spin_unlock_bh(&acm->throttle_lock);
  502. }
  503. static void acm_tty_unthrottle(struct tty_struct *tty)
  504. {
  505. struct acm *acm = tty->driver_data;
  506. if (!ACM_READY(acm))
  507. return;
  508. spin_lock_bh(&acm->throttle_lock);
  509. acm->throttle = 0;
  510. spin_unlock_bh(&acm->throttle_lock);
  511. tasklet_schedule(&acm->urb_task);
  512. }
  513. static void acm_tty_break_ctl(struct tty_struct *tty, int state)
  514. {
  515. struct acm *acm = tty->driver_data;
  516. if (!ACM_READY(acm))
  517. return;
  518. if (acm_send_break(acm, state ? 0xffff : 0))
  519. dbg("send break failed");
  520. }
  521. static int acm_tty_tiocmget(struct tty_struct *tty, struct file *file)
  522. {
  523. struct acm *acm = tty->driver_data;
  524. if (!ACM_READY(acm))
  525. return -EINVAL;
  526. return (acm->ctrlout & ACM_CTRL_DTR ? TIOCM_DTR : 0) |
  527. (acm->ctrlout & ACM_CTRL_RTS ? TIOCM_RTS : 0) |
  528. (acm->ctrlin & ACM_CTRL_DSR ? TIOCM_DSR : 0) |
  529. (acm->ctrlin & ACM_CTRL_RI ? TIOCM_RI : 0) |
  530. (acm->ctrlin & ACM_CTRL_DCD ? TIOCM_CD : 0) |
  531. TIOCM_CTS;
  532. }
  533. static int acm_tty_tiocmset(struct tty_struct *tty, struct file *file,
  534. unsigned int set, unsigned int clear)
  535. {
  536. struct acm *acm = tty->driver_data;
  537. unsigned int newctrl;
  538. if (!ACM_READY(acm))
  539. return -EINVAL;
  540. newctrl = acm->ctrlout;
  541. set = (set & TIOCM_DTR ? ACM_CTRL_DTR : 0) | (set & TIOCM_RTS ? ACM_CTRL_RTS : 0);
  542. clear = (clear & TIOCM_DTR ? ACM_CTRL_DTR : 0) | (clear & TIOCM_RTS ? ACM_CTRL_RTS : 0);
  543. newctrl = (newctrl & ~clear) | set;
  544. if (acm->ctrlout == newctrl)
  545. return 0;
  546. return acm_set_control(acm, acm->ctrlout = newctrl);
  547. }
  548. static int acm_tty_ioctl(struct tty_struct *tty, struct file *file, unsigned int cmd, unsigned long arg)
  549. {
  550. struct acm *acm = tty->driver_data;
  551. if (!ACM_READY(acm))
  552. return -EINVAL;
  553. return -ENOIOCTLCMD;
  554. }
  555. static const __u32 acm_tty_speed[] = {
  556. 0, 50, 75, 110, 134, 150, 200, 300, 600,
  557. 1200, 1800, 2400, 4800, 9600, 19200, 38400,
  558. 57600, 115200, 230400, 460800, 500000, 576000,
  559. 921600, 1000000, 1152000, 1500000, 2000000,
  560. 2500000, 3000000, 3500000, 4000000
  561. };
  562. static const __u8 acm_tty_size[] = {
  563. 5, 6, 7, 8
  564. };
  565. static void acm_tty_set_termios(struct tty_struct *tty, struct termios *termios_old)
  566. {
  567. struct acm *acm = tty->driver_data;
  568. struct termios *termios = tty->termios;
  569. struct usb_cdc_line_coding newline;
  570. int newctrl = acm->ctrlout;
  571. if (!ACM_READY(acm))
  572. return;
  573. newline.dwDTERate = cpu_to_le32p(acm_tty_speed +
  574. (termios->c_cflag & CBAUD & ~CBAUDEX) + (termios->c_cflag & CBAUDEX ? 15 : 0));
  575. newline.bCharFormat = termios->c_cflag & CSTOPB ? 2 : 0;
  576. newline.bParityType = termios->c_cflag & PARENB ?
  577. (termios->c_cflag & PARODD ? 1 : 2) + (termios->c_cflag & CMSPAR ? 2 : 0) : 0;
  578. newline.bDataBits = acm_tty_size[(termios->c_cflag & CSIZE) >> 4];
  579. acm->clocal = ((termios->c_cflag & CLOCAL) != 0);
  580. if (!newline.dwDTERate) {
  581. newline.dwDTERate = acm->line.dwDTERate;
  582. newctrl &= ~ACM_CTRL_DTR;
  583. } else newctrl |= ACM_CTRL_DTR;
  584. if (newctrl != acm->ctrlout)
  585. acm_set_control(acm, acm->ctrlout = newctrl);
  586. if (memcmp(&acm->line, &newline, sizeof newline)) {
  587. memcpy(&acm->line, &newline, sizeof newline);
  588. dbg("set line: %d %d %d %d", le32_to_cpu(newline.dwDTERate),
  589. newline.bCharFormat, newline.bParityType,
  590. newline.bDataBits);
  591. acm_set_line(acm, &acm->line);
  592. }
  593. }
  594. /*
  595. * USB probe and disconnect routines.
  596. */
  597. /* Little helper: write buffers free */
  598. static void acm_write_buffers_free(struct acm *acm)
  599. {
  600. int i;
  601. struct acm_wb *wb;
  602. for (wb = &acm->wb[0], i = 0; i < ACM_NWB; i++, wb++) {
  603. usb_buffer_free(acm->dev, acm->writesize, wb->buf, wb->dmah);
  604. }
  605. }
  606. /* Little helper: write buffers allocate */
  607. static int acm_write_buffers_alloc(struct acm *acm)
  608. {
  609. int i;
  610. struct acm_wb *wb;
  611. for (wb = &acm->wb[0], i = 0; i < ACM_NWB; i++, wb++) {
  612. wb->buf = usb_buffer_alloc(acm->dev, acm->writesize, GFP_KERNEL,
  613. &wb->dmah);
  614. if (!wb->buf) {
  615. while (i != 0) {
  616. --i;
  617. --wb;
  618. usb_buffer_free(acm->dev, acm->writesize,
  619. wb->buf, wb->dmah);
  620. }
  621. return -ENOMEM;
  622. }
  623. }
  624. return 0;
  625. }
  626. static int acm_probe (struct usb_interface *intf,
  627. const struct usb_device_id *id)
  628. {
  629. struct usb_cdc_union_desc *union_header = NULL;
  630. char *buffer = intf->altsetting->extra;
  631. int buflen = intf->altsetting->extralen;
  632. struct usb_interface *control_interface;
  633. struct usb_interface *data_interface;
  634. struct usb_endpoint_descriptor *epctrl;
  635. struct usb_endpoint_descriptor *epread;
  636. struct usb_endpoint_descriptor *epwrite;
  637. struct usb_device *usb_dev = interface_to_usbdev(intf);
  638. struct acm *acm;
  639. int minor;
  640. int ctrlsize,readsize;
  641. u8 *buf;
  642. u8 ac_management_function = 0;
  643. u8 call_management_function = 0;
  644. int call_interface_num = -1;
  645. int data_interface_num;
  646. unsigned long quirks;
  647. int i;
  648. /* handle quirks deadly to normal probing*/
  649. quirks = (unsigned long)id->driver_info;
  650. if (quirks == NO_UNION_NORMAL) {
  651. data_interface = usb_ifnum_to_if(usb_dev, 1);
  652. control_interface = usb_ifnum_to_if(usb_dev, 0);
  653. goto skip_normal_probe;
  654. }
  655. /* normal probing*/
  656. if (!buffer) {
  657. err("Wierd descriptor references\n");
  658. return -EINVAL;
  659. }
  660. if (!buflen) {
  661. if (intf->cur_altsetting->endpoint->extralen && intf->cur_altsetting->endpoint->extra) {
  662. dev_dbg(&intf->dev,"Seeking extra descriptors on endpoint\n");
  663. buflen = intf->cur_altsetting->endpoint->extralen;
  664. buffer = intf->cur_altsetting->endpoint->extra;
  665. } else {
  666. err("Zero length descriptor references\n");
  667. return -EINVAL;
  668. }
  669. }
  670. while (buflen > 0) {
  671. if (buffer [1] != USB_DT_CS_INTERFACE) {
  672. err("skipping garbage\n");
  673. goto next_desc;
  674. }
  675. switch (buffer [2]) {
  676. case USB_CDC_UNION_TYPE: /* we've found it */
  677. if (union_header) {
  678. err("More than one union descriptor, skipping ...");
  679. goto next_desc;
  680. }
  681. union_header = (struct usb_cdc_union_desc *)
  682. buffer;
  683. break;
  684. case USB_CDC_COUNTRY_TYPE: /* maybe somehow export */
  685. break; /* for now we ignore it */
  686. case USB_CDC_HEADER_TYPE: /* maybe check version */
  687. break; /* for now we ignore it */
  688. case USB_CDC_ACM_TYPE:
  689. ac_management_function = buffer[3];
  690. break;
  691. case USB_CDC_CALL_MANAGEMENT_TYPE:
  692. call_management_function = buffer[3];
  693. call_interface_num = buffer[4];
  694. if ((call_management_function & 3) != 3)
  695. err("This device cannot do calls on its own. It is no modem.");
  696. break;
  697. default:
  698. err("Ignoring extra header, type %d, length %d", buffer[2], buffer[0]);
  699. break;
  700. }
  701. next_desc:
  702. buflen -= buffer[0];
  703. buffer += buffer[0];
  704. }
  705. if (!union_header) {
  706. if (call_interface_num > 0) {
  707. dev_dbg(&intf->dev,"No union descriptor, using call management descriptor\n");
  708. data_interface = usb_ifnum_to_if(usb_dev, (data_interface_num = call_interface_num));
  709. control_interface = intf;
  710. } else {
  711. dev_dbg(&intf->dev,"No union descriptor, giving up\n");
  712. return -ENODEV;
  713. }
  714. } else {
  715. control_interface = usb_ifnum_to_if(usb_dev, union_header->bMasterInterface0);
  716. data_interface = usb_ifnum_to_if(usb_dev, (data_interface_num = union_header->bSlaveInterface0));
  717. if (!control_interface || !data_interface) {
  718. dev_dbg(&intf->dev,"no interfaces\n");
  719. return -ENODEV;
  720. }
  721. }
  722. if (data_interface_num != call_interface_num)
  723. dev_dbg(&intf->dev,"Seperate call control interface. That is not fully supported.\n");
  724. skip_normal_probe:
  725. /*workaround for switched interfaces */
  726. if (data_interface->cur_altsetting->desc.bInterfaceClass != CDC_DATA_INTERFACE_TYPE) {
  727. if (control_interface->cur_altsetting->desc.bInterfaceClass == CDC_DATA_INTERFACE_TYPE) {
  728. struct usb_interface *t;
  729. dev_dbg(&intf->dev,"Your device has switched interfaces.\n");
  730. t = control_interface;
  731. control_interface = data_interface;
  732. data_interface = t;
  733. } else {
  734. return -EINVAL;
  735. }
  736. }
  737. if (usb_interface_claimed(data_interface)) { /* valid in this context */
  738. dev_dbg(&intf->dev,"The data interface isn't available\n");
  739. return -EBUSY;
  740. }
  741. if (data_interface->cur_altsetting->desc.bNumEndpoints < 2)
  742. return -EINVAL;
  743. epctrl = &control_interface->cur_altsetting->endpoint[0].desc;
  744. epread = &data_interface->cur_altsetting->endpoint[0].desc;
  745. epwrite = &data_interface->cur_altsetting->endpoint[1].desc;
  746. /* workaround for switched endpoints */
  747. if ((epread->bEndpointAddress & USB_DIR_IN) != USB_DIR_IN) {
  748. /* descriptors are swapped */
  749. struct usb_endpoint_descriptor *t;
  750. dev_dbg(&intf->dev,"The data interface has switched endpoints\n");
  751. t = epread;
  752. epread = epwrite;
  753. epwrite = t;
  754. }
  755. dbg("interfaces are valid");
  756. for (minor = 0; minor < ACM_TTY_MINORS && acm_table[minor]; minor++);
  757. if (minor == ACM_TTY_MINORS) {
  758. err("no more free acm devices");
  759. return -ENODEV;
  760. }
  761. if (!(acm = kzalloc(sizeof(struct acm), GFP_KERNEL))) {
  762. dev_dbg(&intf->dev, "out of memory (acm kzalloc)\n");
  763. goto alloc_fail;
  764. }
  765. ctrlsize = le16_to_cpu(epctrl->wMaxPacketSize);
  766. readsize = le16_to_cpu(epread->wMaxPacketSize)*2;
  767. acm->writesize = le16_to_cpu(epwrite->wMaxPacketSize);
  768. acm->control = control_interface;
  769. acm->data = data_interface;
  770. acm->minor = minor;
  771. acm->dev = usb_dev;
  772. acm->ctrl_caps = ac_management_function;
  773. acm->ctrlsize = ctrlsize;
  774. acm->readsize = readsize;
  775. acm->urb_task.func = acm_rx_tasklet;
  776. acm->urb_task.data = (unsigned long) acm;
  777. INIT_WORK(&acm->work, acm_softint, acm);
  778. spin_lock_init(&acm->throttle_lock);
  779. spin_lock_init(&acm->write_lock);
  780. spin_lock_init(&acm->read_lock);
  781. acm->write_ready = 1;
  782. acm->rx_endpoint = usb_rcvbulkpipe(usb_dev, epread->bEndpointAddress);
  783. buf = usb_buffer_alloc(usb_dev, ctrlsize, GFP_KERNEL, &acm->ctrl_dma);
  784. if (!buf) {
  785. dev_dbg(&intf->dev, "out of memory (ctrl buffer alloc)\n");
  786. goto alloc_fail2;
  787. }
  788. acm->ctrl_buffer = buf;
  789. if (acm_write_buffers_alloc(acm) < 0) {
  790. dev_dbg(&intf->dev, "out of memory (write buffer alloc)\n");
  791. goto alloc_fail4;
  792. }
  793. acm->ctrlurb = usb_alloc_urb(0, GFP_KERNEL);
  794. if (!acm->ctrlurb) {
  795. dev_dbg(&intf->dev, "out of memory (ctrlurb kmalloc)\n");
  796. goto alloc_fail5;
  797. }
  798. for (i = 0; i < ACM_NRU; i++) {
  799. struct acm_ru *rcv = &(acm->ru[i]);
  800. if (!(rcv->urb = usb_alloc_urb(0, GFP_KERNEL))) {
  801. dev_dbg(&intf->dev, "out of memory (read urbs usb_alloc_urb)\n");
  802. goto alloc_fail7;
  803. }
  804. rcv->urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  805. rcv->instance = acm;
  806. }
  807. for (i = 0; i < ACM_NRB; i++) {
  808. struct acm_rb *buf = &(acm->rb[i]);
  809. // Using usb_buffer_alloc instead of kmalloc as Oliver suggested
  810. if (!(buf->base = usb_buffer_alloc(acm->dev, readsize, GFP_KERNEL, &buf->dma))) {
  811. dev_dbg(&intf->dev, "out of memory (read bufs usb_buffer_alloc)\n");
  812. goto alloc_fail7;
  813. }
  814. }
  815. acm->writeurb = usb_alloc_urb(0, GFP_KERNEL);
  816. if (!acm->writeurb) {
  817. dev_dbg(&intf->dev, "out of memory (writeurb kmalloc)\n");
  818. goto alloc_fail7;
  819. }
  820. usb_fill_int_urb(acm->ctrlurb, usb_dev, usb_rcvintpipe(usb_dev, epctrl->bEndpointAddress),
  821. acm->ctrl_buffer, ctrlsize, acm_ctrl_irq, acm, epctrl->bInterval);
  822. acm->ctrlurb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  823. acm->ctrlurb->transfer_dma = acm->ctrl_dma;
  824. usb_fill_bulk_urb(acm->writeurb, usb_dev, usb_sndbulkpipe(usb_dev, epwrite->bEndpointAddress),
  825. NULL, acm->writesize, acm_write_bulk, acm);
  826. acm->writeurb->transfer_flags |= URB_NO_FSBR | URB_NO_TRANSFER_DMA_MAP;
  827. dev_info(&intf->dev, "ttyACM%d: USB ACM device\n", minor);
  828. acm_set_control(acm, acm->ctrlout);
  829. acm->line.dwDTERate = cpu_to_le32(9600);
  830. acm->line.bDataBits = 8;
  831. acm_set_line(acm, &acm->line);
  832. usb_driver_claim_interface(&acm_driver, data_interface, acm);
  833. usb_get_intf(control_interface);
  834. tty_register_device(acm_tty_driver, minor, &control_interface->dev);
  835. acm_table[minor] = acm;
  836. usb_set_intfdata (intf, acm);
  837. return 0;
  838. alloc_fail7:
  839. for (i = 0; i < ACM_NRB; i++)
  840. usb_buffer_free(usb_dev, acm->readsize, acm->rb[i].base, acm->rb[i].dma);
  841. for (i = 0; i < ACM_NRU; i++)
  842. usb_free_urb(acm->ru[i].urb);
  843. usb_free_urb(acm->ctrlurb);
  844. alloc_fail5:
  845. acm_write_buffers_free(acm);
  846. alloc_fail4:
  847. usb_buffer_free(usb_dev, ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
  848. alloc_fail2:
  849. kfree(acm);
  850. alloc_fail:
  851. return -ENOMEM;
  852. }
  853. static void acm_disconnect(struct usb_interface *intf)
  854. {
  855. struct acm *acm = usb_get_intfdata (intf);
  856. struct usb_device *usb_dev = interface_to_usbdev(intf);
  857. int i;
  858. if (!acm || !acm->dev) {
  859. dbg("disconnect on nonexisting interface");
  860. return;
  861. }
  862. down(&open_sem);
  863. acm->dev = NULL;
  864. usb_set_intfdata (intf, NULL);
  865. tasklet_disable(&acm->urb_task);
  866. usb_kill_urb(acm->ctrlurb);
  867. usb_kill_urb(acm->writeurb);
  868. for (i = 0; i < ACM_NRU; i++)
  869. usb_kill_urb(acm->ru[i].urb);
  870. INIT_LIST_HEAD(&acm->filled_read_bufs);
  871. INIT_LIST_HEAD(&acm->spare_read_bufs);
  872. tasklet_enable(&acm->urb_task);
  873. flush_scheduled_work(); /* wait for acm_softint */
  874. acm_write_buffers_free(acm);
  875. usb_buffer_free(usb_dev, acm->ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
  876. for (i = 0; i < ACM_NRB; i++)
  877. usb_buffer_free(usb_dev, acm->readsize, acm->rb[i].base, acm->rb[i].dma);
  878. usb_driver_release_interface(&acm_driver, acm->data);
  879. if (!acm->used) {
  880. acm_tty_unregister(acm);
  881. up(&open_sem);
  882. return;
  883. }
  884. up(&open_sem);
  885. if (acm->tty)
  886. tty_hangup(acm->tty);
  887. }
  888. /*
  889. * USB driver structure.
  890. */
  891. static struct usb_device_id acm_ids[] = {
  892. /* quirky and broken devices */
  893. { USB_DEVICE(0x0870, 0x0001), /* Metricom GS Modem */
  894. .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
  895. },
  896. { USB_DEVICE(0x0482, 0x0203), /* KYOCERA AH-K3001V */
  897. .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
  898. },
  899. /* control interfaces with various AT-command sets */
  900. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  901. USB_CDC_ACM_PROTO_AT_V25TER) },
  902. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  903. USB_CDC_ACM_PROTO_AT_PCCA101) },
  904. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  905. USB_CDC_ACM_PROTO_AT_PCCA101_WAKE) },
  906. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  907. USB_CDC_ACM_PROTO_AT_GSM) },
  908. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  909. USB_CDC_ACM_PROTO_AT_3G ) },
  910. { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
  911. USB_CDC_ACM_PROTO_AT_CDMA) },
  912. /* NOTE: COMM/ACM/0xff is likely MSFT RNDIS ... NOT a modem!! */
  913. { }
  914. };
  915. MODULE_DEVICE_TABLE (usb, acm_ids);
  916. static struct usb_driver acm_driver = {
  917. .name = "cdc_acm",
  918. .probe = acm_probe,
  919. .disconnect = acm_disconnect,
  920. .id_table = acm_ids,
  921. };
  922. /*
  923. * TTY driver structures.
  924. */
  925. static struct tty_operations acm_ops = {
  926. .open = acm_tty_open,
  927. .close = acm_tty_close,
  928. .write = acm_tty_write,
  929. .write_room = acm_tty_write_room,
  930. .ioctl = acm_tty_ioctl,
  931. .throttle = acm_tty_throttle,
  932. .unthrottle = acm_tty_unthrottle,
  933. .chars_in_buffer = acm_tty_chars_in_buffer,
  934. .break_ctl = acm_tty_break_ctl,
  935. .set_termios = acm_tty_set_termios,
  936. .tiocmget = acm_tty_tiocmget,
  937. .tiocmset = acm_tty_tiocmset,
  938. };
  939. /*
  940. * Init / exit.
  941. */
  942. static int __init acm_init(void)
  943. {
  944. int retval;
  945. acm_tty_driver = alloc_tty_driver(ACM_TTY_MINORS);
  946. if (!acm_tty_driver)
  947. return -ENOMEM;
  948. acm_tty_driver->owner = THIS_MODULE,
  949. acm_tty_driver->driver_name = "acm",
  950. acm_tty_driver->name = "ttyACM",
  951. acm_tty_driver->devfs_name = "usb/acm/",
  952. acm_tty_driver->major = ACM_TTY_MAJOR,
  953. acm_tty_driver->minor_start = 0,
  954. acm_tty_driver->type = TTY_DRIVER_TYPE_SERIAL,
  955. acm_tty_driver->subtype = SERIAL_TYPE_NORMAL,
  956. acm_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_NO_DEVFS,
  957. acm_tty_driver->init_termios = tty_std_termios;
  958. acm_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
  959. tty_set_operations(acm_tty_driver, &acm_ops);
  960. retval = tty_register_driver(acm_tty_driver);
  961. if (retval) {
  962. put_tty_driver(acm_tty_driver);
  963. return retval;
  964. }
  965. retval = usb_register(&acm_driver);
  966. if (retval) {
  967. tty_unregister_driver(acm_tty_driver);
  968. put_tty_driver(acm_tty_driver);
  969. return retval;
  970. }
  971. info(DRIVER_VERSION ":" DRIVER_DESC);
  972. return 0;
  973. }
  974. static void __exit acm_exit(void)
  975. {
  976. usb_deregister(&acm_driver);
  977. tty_unregister_driver(acm_tty_driver);
  978. put_tty_driver(acm_tty_driver);
  979. }
  980. module_init(acm_init);
  981. module_exit(acm_exit);
  982. MODULE_AUTHOR( DRIVER_AUTHOR );
  983. MODULE_DESCRIPTION( DRIVER_DESC );
  984. MODULE_LICENSE("GPL");