1 // SPDX-License-Identifier: GPL-2.0+
5 * Copyright (c) 1999 Armin Fuerst <fuerst@in.tum.de>
6 * Copyright (c) 1999 Pavel Machek <pavel@ucw.cz>
7 * Copyright (c) 1999 Johannes Erdfelt <johannes@erdfelt.com>
8 * Copyright (c) 2000 Vojtech Pavlik <vojtech@suse.cz>
9 * Copyright (c) 2004 Oliver Neukum <oliver@neukum.name>
10 * Copyright (c) 2005 David Kubicek <dave@awk.cz>
11 * Copyright (c) 2011 Johan Hovold <jhovold@gmail.com>
13 * USB Abstract Control Model driver for USB modems and ISDN adapters
21 #include <linux/kernel.h>
22 #include <linux/sched/signal.h>
23 #include <linux/errno.h>
24 #include <linux/init.h>
25 #include <linux/slab.h>
26 #include <linux/log2.h>
27 #include <linux/tty.h>
28 #include <linux/serial.h>
29 #include <linux/tty_driver.h>
30 #include <linux/tty_flip.h>
31 #include <linux/module.h>
32 #include <linux/mutex.h>
33 #include <linux/uaccess.h>
34 #include <linux/usb.h>
35 #include <linux/usb/cdc.h>
36 #include <asm/byteorder.h>
37 #include <asm/unaligned.h>
38 #include <linux/idr.h>
39 #include <linux/list.h>
44 #define DRIVER_AUTHOR "Armin Fuerst, Pavel Machek, Johannes Erdfelt, Vojtech Pavlik, David Kubicek, Johan Hovold"
45 #define DRIVER_DESC "USB Abstract Control Model driver for USB modems and ISDN adapters"
47 static struct usb_driver acm_driver
;
48 static struct tty_driver
*acm_tty_driver
;
50 static DEFINE_IDR(acm_minors
);
51 static DEFINE_MUTEX(acm_minors_lock
);
53 static void acm_tty_set_termios(struct tty_struct
*tty
,
54 struct ktermios
*termios_old
);
57 * acm_minors accessors
61 * Look up an ACM structure by minor. If found and not disconnected, increment
62 * its refcount and return it with its mutex held.
64 static struct acm
*acm_get_by_minor(unsigned int minor
)
68 mutex_lock(&acm_minors_lock
);
69 acm
= idr_find(&acm_minors
, minor
);
71 mutex_lock(&acm
->mutex
);
72 if (acm
->disconnected
) {
73 mutex_unlock(&acm
->mutex
);
76 tty_port_get(&acm
->port
);
77 mutex_unlock(&acm
->mutex
);
80 mutex_unlock(&acm_minors_lock
);
85 * Try to find an available minor number and if found, associate it with 'acm'.
87 static int acm_alloc_minor(struct acm
*acm
)
91 mutex_lock(&acm_minors_lock
);
92 minor
= idr_alloc(&acm_minors
, acm
, 0, ACM_TTY_MINORS
, GFP_KERNEL
);
93 mutex_unlock(&acm_minors_lock
);
98 /* Release the minor number associated with 'acm'. */
99 static void acm_release_minor(struct acm
*acm
)
101 mutex_lock(&acm_minors_lock
);
102 idr_remove(&acm_minors
, acm
->minor
);
103 mutex_unlock(&acm_minors_lock
);
107 * Functions for ACM control messages.
110 static int acm_ctrl_msg(struct acm
*acm
, int request
, int value
,
115 retval
= usb_autopm_get_interface(acm
->control
);
119 retval
= usb_control_msg(acm
->dev
, usb_sndctrlpipe(acm
->dev
, 0),
120 request
, USB_RT_ACM
, value
,
121 acm
->control
->altsetting
[0].desc
.bInterfaceNumber
,
124 dev_dbg(&acm
->control
->dev
,
125 "%s - rq 0x%02x, val %#x, len %#x, result %d\n",
126 __func__
, request
, value
, len
, retval
);
128 usb_autopm_put_interface(acm
->control
);
130 return retval
< 0 ? retval
: 0;
133 /* devices aren't required to support these requests.
134 * the cdc acm descriptor tells whether they do...
136 static inline int acm_set_control(struct acm
*acm
, int control
)
138 if (acm
->quirks
& QUIRK_CONTROL_LINE_STATE
)
141 return acm_ctrl_msg(acm
, USB_CDC_REQ_SET_CONTROL_LINE_STATE
,
145 #define acm_set_line(acm, line) \
146 acm_ctrl_msg(acm, USB_CDC_REQ_SET_LINE_CODING, 0, line, sizeof *(line))
147 #define acm_send_break(acm, ms) \
148 acm_ctrl_msg(acm, USB_CDC_REQ_SEND_BREAK, ms, NULL, 0)
150 static void acm_kill_urbs(struct acm
*acm
)
154 usb_kill_urb(acm
->ctrlurb
);
155 for (i
= 0; i
< ACM_NW
; i
++)
156 usb_kill_urb(acm
->wb
[i
].urb
);
157 for (i
= 0; i
< acm
->rx_buflimit
; i
++)
158 usb_kill_urb(acm
->read_urbs
[i
]);
162 * Write buffer management.
163 * All of these assume proper locks taken by the caller.
166 static int acm_wb_alloc(struct acm
*acm
)
180 wbn
= (wbn
+ 1) % ACM_NW
;
186 static int acm_wb_is_avail(struct acm
*acm
)
192 spin_lock_irqsave(&acm
->write_lock
, flags
);
193 for (i
= 0; i
< ACM_NW
; i
++)
195 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
200 * Finish write. Caller must hold acm->write_lock
202 static void acm_write_done(struct acm
*acm
, struct acm_wb
*wb
)
206 usb_autopm_put_interface_async(acm
->control
);
212 * the caller is responsible for locking
215 static int acm_start_wb(struct acm
*acm
, struct acm_wb
*wb
)
221 wb
->urb
->transfer_buffer
= wb
->buf
;
222 wb
->urb
->transfer_dma
= wb
->dmah
;
223 wb
->urb
->transfer_buffer_length
= wb
->len
;
224 wb
->urb
->dev
= acm
->dev
;
226 rc
= usb_submit_urb(wb
->urb
, GFP_ATOMIC
);
228 dev_err(&acm
->data
->dev
,
229 "%s - usb_submit_urb(write bulk) failed: %d\n",
231 acm_write_done(acm
, wb
);
237 * attributes exported through sysfs
239 static ssize_t bmCapabilities_show
240 (struct device
*dev
, struct device_attribute
*attr
, char *buf
)
242 struct usb_interface
*intf
= to_usb_interface(dev
);
243 struct acm
*acm
= usb_get_intfdata(intf
);
245 return sprintf(buf
, "%d", acm
->ctrl_caps
);
247 static DEVICE_ATTR_RO(bmCapabilities
);
249 static ssize_t wCountryCodes_show
250 (struct device
*dev
, struct device_attribute
*attr
, char *buf
)
252 struct usb_interface
*intf
= to_usb_interface(dev
);
253 struct acm
*acm
= usb_get_intfdata(intf
);
255 memcpy(buf
, acm
->country_codes
, acm
->country_code_size
);
256 return acm
->country_code_size
;
259 static DEVICE_ATTR_RO(wCountryCodes
);
261 static ssize_t iCountryCodeRelDate_show
262 (struct device
*dev
, struct device_attribute
*attr
, char *buf
)
264 struct usb_interface
*intf
= to_usb_interface(dev
);
265 struct acm
*acm
= usb_get_intfdata(intf
);
267 return sprintf(buf
, "%d", acm
->country_rel_date
);
270 static DEVICE_ATTR_RO(iCountryCodeRelDate
);
272 * Interrupt handlers for various ACM device responses
275 static void acm_process_notification(struct acm
*acm
, unsigned char *buf
)
280 struct usb_cdc_notification
*dr
= (struct usb_cdc_notification
*)buf
;
281 unsigned char *data
= buf
+ sizeof(struct usb_cdc_notification
);
283 switch (dr
->bNotificationType
) {
284 case USB_CDC_NOTIFY_NETWORK_CONNECTION
:
285 dev_dbg(&acm
->control
->dev
,
286 "%s - network connection: %d\n", __func__
, dr
->wValue
);
289 case USB_CDC_NOTIFY_SERIAL_STATE
:
290 if (le16_to_cpu(dr
->wLength
) != 2) {
291 dev_dbg(&acm
->control
->dev
,
292 "%s - malformed serial state\n", __func__
);
296 newctrl
= get_unaligned_le16(data
);
297 dev_dbg(&acm
->control
->dev
,
298 "%s - serial state: 0x%x\n", __func__
, newctrl
);
300 if (!acm
->clocal
&& (acm
->ctrlin
& ~newctrl
& ACM_CTRL_DCD
)) {
301 dev_dbg(&acm
->control
->dev
,
302 "%s - calling hangup\n", __func__
);
303 tty_port_tty_hangup(&acm
->port
, false);
306 difference
= acm
->ctrlin
^ newctrl
;
307 spin_lock_irqsave(&acm
->read_lock
, flags
);
308 acm
->ctrlin
= newctrl
;
309 acm
->oldcount
= acm
->iocount
;
311 if (difference
& ACM_CTRL_DSR
)
313 if (difference
& ACM_CTRL_DCD
)
315 if (newctrl
& ACM_CTRL_BRK
)
317 if (newctrl
& ACM_CTRL_RI
)
319 if (newctrl
& ACM_CTRL_FRAMING
)
320 acm
->iocount
.frame
++;
321 if (newctrl
& ACM_CTRL_PARITY
)
322 acm
->iocount
.parity
++;
323 if (newctrl
& ACM_CTRL_OVERRUN
)
324 acm
->iocount
.overrun
++;
325 spin_unlock_irqrestore(&acm
->read_lock
, flags
);
328 wake_up_all(&acm
->wioctl
);
333 dev_dbg(&acm
->control
->dev
,
334 "%s - unknown notification %d received: index %d len %d\n",
336 dr
->bNotificationType
, dr
->wIndex
, dr
->wLength
);
340 /* control interface reports status changes with "interrupt" transfers */
341 static void acm_ctrl_irq(struct urb
*urb
)
343 struct acm
*acm
= urb
->context
;
344 struct usb_cdc_notification
*dr
= urb
->transfer_buffer
;
345 unsigned int current_size
= urb
->actual_length
;
346 unsigned int expected_size
, copy_size
, alloc_size
;
348 int status
= urb
->status
;
357 /* this urb is terminated, clean up */
358 dev_dbg(&acm
->control
->dev
,
359 "%s - urb shutting down with status: %d\n",
363 dev_dbg(&acm
->control
->dev
,
364 "%s - nonzero urb status received: %d\n",
369 usb_mark_last_busy(acm
->dev
);
372 dr
= (struct usb_cdc_notification
*)acm
->notification_buffer
;
374 /* size = notification-header + (optional) data */
375 expected_size
= sizeof(struct usb_cdc_notification
) +
376 le16_to_cpu(dr
->wLength
);
378 if (current_size
< expected_size
) {
379 /* notification is transmitted fragmented, reassemble */
380 if (acm
->nb_size
< expected_size
) {
382 kfree(acm
->notification_buffer
);
385 alloc_size
= roundup_pow_of_two(expected_size
);
387 * kmalloc ensures a valid notification_buffer after a
388 * use of kfree in case the previous allocation was too
389 * small. Final freeing is done on disconnect.
391 acm
->notification_buffer
=
392 kmalloc(alloc_size
, GFP_ATOMIC
);
393 if (!acm
->notification_buffer
)
395 acm
->nb_size
= alloc_size
;
398 copy_size
= min(current_size
,
399 expected_size
- acm
->nb_index
);
401 memcpy(&acm
->notification_buffer
[acm
->nb_index
],
402 urb
->transfer_buffer
, copy_size
);
403 acm
->nb_index
+= copy_size
;
404 current_size
= acm
->nb_index
;
407 if (current_size
>= expected_size
) {
408 /* notification complete */
409 acm_process_notification(acm
, (unsigned char *)dr
);
414 retval
= usb_submit_urb(urb
, GFP_ATOMIC
);
415 if (retval
&& retval
!= -EPERM
)
416 dev_err(&acm
->control
->dev
,
417 "%s - usb_submit_urb failed: %d\n", __func__
, retval
);
420 static int acm_submit_read_urb(struct acm
*acm
, int index
, gfp_t mem_flags
)
424 if (!test_and_clear_bit(index
, &acm
->read_urbs_free
))
427 res
= usb_submit_urb(acm
->read_urbs
[index
], mem_flags
);
429 if (res
!= -EPERM
&& res
!= -ENODEV
) {
430 dev_err(&acm
->data
->dev
,
431 "urb %d failed submission with %d\n",
434 set_bit(index
, &acm
->read_urbs_free
);
437 dev_vdbg(&acm
->data
->dev
, "submitted urb %d\n", index
);
443 static int acm_submit_read_urbs(struct acm
*acm
, gfp_t mem_flags
)
448 for (i
= 0; i
< acm
->rx_buflimit
; ++i
) {
449 res
= acm_submit_read_urb(acm
, i
, mem_flags
);
457 static void acm_process_read_urb(struct acm
*acm
, struct urb
*urb
)
459 if (!urb
->actual_length
)
462 tty_insert_flip_string(&acm
->port
, urb
->transfer_buffer
,
464 tty_flip_buffer_push(&acm
->port
);
467 static void acm_read_bulk_callback(struct urb
*urb
)
469 struct acm_rb
*rb
= urb
->context
;
470 struct acm
*acm
= rb
->instance
;
472 int status
= urb
->status
;
473 bool stopped
= false;
474 bool stalled
= false;
476 dev_vdbg(&acm
->data
->dev
, "got urb %d, len %d, status %d\n",
477 rb
->index
, urb
->actual_length
, status
);
480 dev_dbg(&acm
->data
->dev
, "%s - disconnected\n", __func__
);
486 usb_mark_last_busy(acm
->dev
);
487 acm_process_read_urb(acm
, urb
);
490 set_bit(EVENT_RX_STALL
, &acm
->flags
);
496 dev_dbg(&acm
->data
->dev
,
497 "%s - urb shutting down with status: %d\n",
502 dev_dbg(&acm
->data
->dev
,
503 "%s - nonzero urb status received: %d\n",
509 * Make sure URB processing is done before marking as free to avoid
510 * racing with unthrottle() on another CPU. Matches the barriers
511 * implied by the test_and_clear_bit() in acm_submit_read_urb().
513 smp_mb__before_atomic();
514 set_bit(rb
->index
, &acm
->read_urbs_free
);
516 * Make sure URB is marked as free before checking the throttled flag
517 * to avoid racing with unthrottle() on another CPU. Matches the
518 * smp_mb() in unthrottle().
520 smp_mb__after_atomic();
522 if (stopped
|| stalled
) {
524 schedule_work(&acm
->work
);
528 /* throttle device if requested by tty */
529 spin_lock_irqsave(&acm
->read_lock
, flags
);
530 acm
->throttled
= acm
->throttle_req
;
531 if (!acm
->throttled
) {
532 spin_unlock_irqrestore(&acm
->read_lock
, flags
);
533 acm_submit_read_urb(acm
, rb
->index
, GFP_ATOMIC
);
535 spin_unlock_irqrestore(&acm
->read_lock
, flags
);
539 /* data interface wrote those outgoing bytes */
540 static void acm_write_bulk(struct urb
*urb
)
542 struct acm_wb
*wb
= urb
->context
;
543 struct acm
*acm
= wb
->instance
;
545 int status
= urb
->status
;
547 if (status
|| (urb
->actual_length
!= urb
->transfer_buffer_length
))
548 dev_vdbg(&acm
->data
->dev
, "wrote len %d/%d, status %d\n",
550 urb
->transfer_buffer_length
,
553 spin_lock_irqsave(&acm
->write_lock
, flags
);
554 acm_write_done(acm
, wb
);
555 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
556 set_bit(EVENT_TTY_WAKEUP
, &acm
->flags
);
557 schedule_work(&acm
->work
);
560 static void acm_softint(struct work_struct
*work
)
563 struct acm
*acm
= container_of(work
, struct acm
, work
);
565 if (test_bit(EVENT_RX_STALL
, &acm
->flags
)) {
566 if (!(usb_autopm_get_interface(acm
->data
))) {
567 for (i
= 0; i
< acm
->rx_buflimit
; i
++)
568 usb_kill_urb(acm
->read_urbs
[i
]);
569 usb_clear_halt(acm
->dev
, acm
->in
);
570 acm_submit_read_urbs(acm
, GFP_KERNEL
);
571 usb_autopm_put_interface(acm
->data
);
573 clear_bit(EVENT_RX_STALL
, &acm
->flags
);
576 if (test_and_clear_bit(EVENT_TTY_WAKEUP
, &acm
->flags
))
577 tty_port_tty_wakeup(&acm
->port
);
584 static int acm_tty_install(struct tty_driver
*driver
, struct tty_struct
*tty
)
589 acm
= acm_get_by_minor(tty
->index
);
593 retval
= tty_standard_install(driver
, tty
);
595 goto error_init_termios
;
598 * Suppress initial echoing for some devices which might send data
599 * immediately after acm driver has been installed.
601 if (acm
->quirks
& DISABLE_ECHO
)
602 tty
->termios
.c_lflag
&= ~ECHO
;
604 tty
->driver_data
= acm
;
609 tty_port_put(&acm
->port
);
613 static int acm_tty_open(struct tty_struct
*tty
, struct file
*filp
)
615 struct acm
*acm
= tty
->driver_data
;
617 return tty_port_open(&acm
->port
, tty
, filp
);
620 static void acm_port_dtr_rts(struct tty_port
*port
, int raise
)
622 struct acm
*acm
= container_of(port
, struct acm
, port
);
627 val
= ACM_CTRL_DTR
| ACM_CTRL_RTS
;
631 /* FIXME: add missing ctrlout locking throughout driver */
634 res
= acm_set_control(acm
, val
);
635 if (res
&& (acm
->ctrl_caps
& USB_CDC_CAP_LINE
))
636 dev_err(&acm
->control
->dev
, "failed to set dtr/rts\n");
639 static int acm_port_activate(struct tty_port
*port
, struct tty_struct
*tty
)
641 struct acm
*acm
= container_of(port
, struct acm
, port
);
642 int retval
= -ENODEV
;
645 mutex_lock(&acm
->mutex
);
646 if (acm
->disconnected
)
649 retval
= usb_autopm_get_interface(acm
->control
);
651 goto error_get_interface
;
654 * FIXME: Why do we need this? Allocating 64K of physically contiguous
655 * memory is really nasty...
657 set_bit(TTY_NO_WRITE_SPLIT
, &tty
->flags
);
658 acm
->control
->needs_remote_wakeup
= 1;
660 acm
->ctrlurb
->dev
= acm
->dev
;
661 retval
= usb_submit_urb(acm
->ctrlurb
, GFP_KERNEL
);
663 dev_err(&acm
->control
->dev
,
664 "%s - usb_submit_urb(ctrl irq) failed\n", __func__
);
665 goto error_submit_urb
;
668 acm_tty_set_termios(tty
, NULL
);
671 * Unthrottle device in case the TTY was closed while throttled.
673 spin_lock_irq(&acm
->read_lock
);
675 acm
->throttle_req
= 0;
676 spin_unlock_irq(&acm
->read_lock
);
678 retval
= acm_submit_read_urbs(acm
, GFP_KERNEL
);
680 goto error_submit_read_urbs
;
682 usb_autopm_put_interface(acm
->control
);
684 mutex_unlock(&acm
->mutex
);
688 error_submit_read_urbs
:
689 for (i
= 0; i
< acm
->rx_buflimit
; i
++)
690 usb_kill_urb(acm
->read_urbs
[i
]);
691 usb_kill_urb(acm
->ctrlurb
);
693 usb_autopm_put_interface(acm
->control
);
696 mutex_unlock(&acm
->mutex
);
698 return usb_translate_errors(retval
);
701 static void acm_port_destruct(struct tty_port
*port
)
703 struct acm
*acm
= container_of(port
, struct acm
, port
);
705 acm_release_minor(acm
);
706 usb_put_intf(acm
->control
);
707 kfree(acm
->country_codes
);
711 static void acm_port_shutdown(struct tty_port
*port
)
713 struct acm
*acm
= container_of(port
, struct acm
, port
);
718 * Need to grab write_lock to prevent race with resume, but no need to
719 * hold it due to the tty-port initialised flag.
721 spin_lock_irq(&acm
->write_lock
);
722 spin_unlock_irq(&acm
->write_lock
);
724 usb_autopm_get_interface_no_resume(acm
->control
);
725 acm
->control
->needs_remote_wakeup
= 0;
726 usb_autopm_put_interface(acm
->control
);
729 urb
= usb_get_from_anchor(&acm
->delayed
);
734 usb_autopm_put_interface_async(acm
->control
);
740 static void acm_tty_cleanup(struct tty_struct
*tty
)
742 struct acm
*acm
= tty
->driver_data
;
744 tty_port_put(&acm
->port
);
747 static void acm_tty_hangup(struct tty_struct
*tty
)
749 struct acm
*acm
= tty
->driver_data
;
751 tty_port_hangup(&acm
->port
);
754 static void acm_tty_close(struct tty_struct
*tty
, struct file
*filp
)
756 struct acm
*acm
= tty
->driver_data
;
758 tty_port_close(&acm
->port
, tty
, filp
);
761 static int acm_tty_write(struct tty_struct
*tty
,
762 const unsigned char *buf
, int count
)
764 struct acm
*acm
= tty
->driver_data
;
773 dev_vdbg(&acm
->data
->dev
, "%d bytes from tty layer\n", count
);
775 spin_lock_irqsave(&acm
->write_lock
, flags
);
776 wbn
= acm_wb_alloc(acm
);
778 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
785 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
789 count
= (count
> acm
->writesize
) ? acm
->writesize
: count
;
790 dev_vdbg(&acm
->data
->dev
, "writing %d bytes\n", count
);
791 memcpy(wb
->buf
, buf
, count
);
794 stat
= usb_autopm_get_interface_async(acm
->control
);
797 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
801 if (acm
->susp_count
) {
802 usb_anchor_urb(wb
->urb
, &acm
->delayed
);
803 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
807 stat
= acm_start_wb(acm
, wb
);
808 spin_unlock_irqrestore(&acm
->write_lock
, flags
);
815 static int acm_tty_write_room(struct tty_struct
*tty
)
817 struct acm
*acm
= tty
->driver_data
;
819 * Do not let the line discipline to know that we have a reserve,
820 * or it might get too enthusiastic.
822 return acm_wb_is_avail(acm
) ? acm
->writesize
: 0;
825 static int acm_tty_chars_in_buffer(struct tty_struct
*tty
)
827 struct acm
*acm
= tty
->driver_data
;
829 * if the device was unplugged then any remaining characters fell out
830 * of the connector ;)
832 if (acm
->disconnected
)
835 * This is inaccurate (overcounts), but it works.
837 return (ACM_NW
- acm_wb_is_avail(acm
)) * acm
->writesize
;
840 static void acm_tty_throttle(struct tty_struct
*tty
)
842 struct acm
*acm
= tty
->driver_data
;
844 spin_lock_irq(&acm
->read_lock
);
845 acm
->throttle_req
= 1;
846 spin_unlock_irq(&acm
->read_lock
);
849 static void acm_tty_unthrottle(struct tty_struct
*tty
)
851 struct acm
*acm
= tty
->driver_data
;
852 unsigned int was_throttled
;
854 spin_lock_irq(&acm
->read_lock
);
855 was_throttled
= acm
->throttled
;
857 acm
->throttle_req
= 0;
858 spin_unlock_irq(&acm
->read_lock
);
860 /* Matches the smp_mb__after_atomic() in acm_read_bulk_callback(). */
864 acm_submit_read_urbs(acm
, GFP_KERNEL
);
867 static int acm_tty_break_ctl(struct tty_struct
*tty
, int state
)
869 struct acm
*acm
= tty
->driver_data
;
872 retval
= acm_send_break(acm
, state
? 0xffff : 0);
874 dev_dbg(&acm
->control
->dev
,
875 "%s - send break failed\n", __func__
);
879 static int acm_tty_tiocmget(struct tty_struct
*tty
)
881 struct acm
*acm
= tty
->driver_data
;
883 return (acm
->ctrlout
& ACM_CTRL_DTR
? TIOCM_DTR
: 0) |
884 (acm
->ctrlout
& ACM_CTRL_RTS
? TIOCM_RTS
: 0) |
885 (acm
->ctrlin
& ACM_CTRL_DSR
? TIOCM_DSR
: 0) |
886 (acm
->ctrlin
& ACM_CTRL_RI
? TIOCM_RI
: 0) |
887 (acm
->ctrlin
& ACM_CTRL_DCD
? TIOCM_CD
: 0) |
891 static int acm_tty_tiocmset(struct tty_struct
*tty
,
892 unsigned int set
, unsigned int clear
)
894 struct acm
*acm
= tty
->driver_data
;
895 unsigned int newctrl
;
897 newctrl
= acm
->ctrlout
;
898 set
= (set
& TIOCM_DTR
? ACM_CTRL_DTR
: 0) |
899 (set
& TIOCM_RTS
? ACM_CTRL_RTS
: 0);
900 clear
= (clear
& TIOCM_DTR
? ACM_CTRL_DTR
: 0) |
901 (clear
& TIOCM_RTS
? ACM_CTRL_RTS
: 0);
903 newctrl
= (newctrl
& ~clear
) | set
;
905 if (acm
->ctrlout
== newctrl
)
907 return acm_set_control(acm
, acm
->ctrlout
= newctrl
);
910 static int get_serial_info(struct tty_struct
*tty
, struct serial_struct
*ss
)
912 struct acm
*acm
= tty
->driver_data
;
914 ss
->xmit_fifo_size
= acm
->writesize
;
915 ss
->baud_base
= le32_to_cpu(acm
->line
.dwDTERate
);
916 ss
->close_delay
= acm
->port
.close_delay
/ 10;
917 ss
->closing_wait
= acm
->port
.closing_wait
== ASYNC_CLOSING_WAIT_NONE
?
918 ASYNC_CLOSING_WAIT_NONE
:
919 acm
->port
.closing_wait
/ 10;
923 static int set_serial_info(struct tty_struct
*tty
, struct serial_struct
*ss
)
925 struct acm
*acm
= tty
->driver_data
;
926 unsigned int closing_wait
, close_delay
;
929 close_delay
= ss
->close_delay
* 10;
930 closing_wait
= ss
->closing_wait
== ASYNC_CLOSING_WAIT_NONE
?
931 ASYNC_CLOSING_WAIT_NONE
: ss
->closing_wait
* 10;
933 mutex_lock(&acm
->port
.mutex
);
935 if (!capable(CAP_SYS_ADMIN
)) {
936 if ((close_delay
!= acm
->port
.close_delay
) ||
937 (closing_wait
!= acm
->port
.closing_wait
))
940 retval
= -EOPNOTSUPP
;
942 acm
->port
.close_delay
= close_delay
;
943 acm
->port
.closing_wait
= closing_wait
;
946 mutex_unlock(&acm
->port
.mutex
);
950 static int wait_serial_change(struct acm
*acm
, unsigned long arg
)
953 DECLARE_WAITQUEUE(wait
, current
);
954 struct async_icount old
, new;
957 spin_lock_irq(&acm
->read_lock
);
961 spin_unlock_irq(&acm
->read_lock
);
963 if ((arg
& TIOCM_DSR
) &&
966 if ((arg
& TIOCM_CD
) &&
969 if ((arg
& TIOCM_RI
) &&
973 add_wait_queue(&acm
->wioctl
, &wait
);
974 set_current_state(TASK_INTERRUPTIBLE
);
976 remove_wait_queue(&acm
->wioctl
, &wait
);
977 if (acm
->disconnected
) {
983 if (signal_pending(current
))
993 static int acm_tty_get_icount(struct tty_struct
*tty
,
994 struct serial_icounter_struct
*icount
)
996 struct acm
*acm
= tty
->driver_data
;
998 icount
->dsr
= acm
->iocount
.dsr
;
999 icount
->rng
= acm
->iocount
.rng
;
1000 icount
->dcd
= acm
->iocount
.dcd
;
1001 icount
->frame
= acm
->iocount
.frame
;
1002 icount
->overrun
= acm
->iocount
.overrun
;
1003 icount
->parity
= acm
->iocount
.parity
;
1004 icount
->brk
= acm
->iocount
.brk
;
1009 static int acm_tty_ioctl(struct tty_struct
*tty
,
1010 unsigned int cmd
, unsigned long arg
)
1012 struct acm
*acm
= tty
->driver_data
;
1013 int rv
= -ENOIOCTLCMD
;
1017 rv
= usb_autopm_get_interface(acm
->control
);
1022 rv
= wait_serial_change(acm
, arg
);
1023 usb_autopm_put_interface(acm
->control
);
1030 static void acm_tty_set_termios(struct tty_struct
*tty
,
1031 struct ktermios
*termios_old
)
1033 struct acm
*acm
= tty
->driver_data
;
1034 struct ktermios
*termios
= &tty
->termios
;
1035 struct usb_cdc_line_coding newline
;
1036 int newctrl
= acm
->ctrlout
;
1038 newline
.dwDTERate
= cpu_to_le32(tty_get_baud_rate(tty
));
1039 newline
.bCharFormat
= termios
->c_cflag
& CSTOPB
? 2 : 0;
1040 newline
.bParityType
= termios
->c_cflag
& PARENB
?
1041 (termios
->c_cflag
& PARODD
? 1 : 2) +
1042 (termios
->c_cflag
& CMSPAR
? 2 : 0) : 0;
1043 switch (termios
->c_cflag
& CSIZE
) {
1045 newline
.bDataBits
= 5;
1048 newline
.bDataBits
= 6;
1051 newline
.bDataBits
= 7;
1055 newline
.bDataBits
= 8;
1058 /* FIXME: Needs to clear unsupported bits in the termios */
1059 acm
->clocal
= ((termios
->c_cflag
& CLOCAL
) != 0);
1061 if (C_BAUD(tty
) == B0
) {
1062 newline
.dwDTERate
= acm
->line
.dwDTERate
;
1063 newctrl
&= ~ACM_CTRL_DTR
;
1064 } else if (termios_old
&& (termios_old
->c_cflag
& CBAUD
) == B0
) {
1065 newctrl
|= ACM_CTRL_DTR
;
1068 if (newctrl
!= acm
->ctrlout
)
1069 acm_set_control(acm
, acm
->ctrlout
= newctrl
);
1071 if (memcmp(&acm
->line
, &newline
, sizeof newline
)) {
1072 memcpy(&acm
->line
, &newline
, sizeof newline
);
1073 dev_dbg(&acm
->control
->dev
, "%s - set line: %d %d %d %d\n",
1075 le32_to_cpu(newline
.dwDTERate
),
1076 newline
.bCharFormat
, newline
.bParityType
,
1078 acm_set_line(acm
, &acm
->line
);
1082 static const struct tty_port_operations acm_port_ops
= {
1083 .dtr_rts
= acm_port_dtr_rts
,
1084 .shutdown
= acm_port_shutdown
,
1085 .activate
= acm_port_activate
,
1086 .destruct
= acm_port_destruct
,
1090 * USB probe and disconnect routines.
1093 /* Little helpers: write/read buffers free */
1094 static void acm_write_buffers_free(struct acm
*acm
)
1099 for (wb
= &acm
->wb
[0], i
= 0; i
< ACM_NW
; i
++, wb
++)
1100 usb_free_coherent(acm
->dev
, acm
->writesize
, wb
->buf
, wb
->dmah
);
1103 static void acm_read_buffers_free(struct acm
*acm
)
1107 for (i
= 0; i
< acm
->rx_buflimit
; i
++)
1108 usb_free_coherent(acm
->dev
, acm
->readsize
,
1109 acm
->read_buffers
[i
].base
, acm
->read_buffers
[i
].dma
);
1112 /* Little helper: write buffers allocate */
1113 static int acm_write_buffers_alloc(struct acm
*acm
)
1118 for (wb
= &acm
->wb
[0], i
= 0; i
< ACM_NW
; i
++, wb
++) {
1119 wb
->buf
= usb_alloc_coherent(acm
->dev
, acm
->writesize
, GFP_KERNEL
,
1125 usb_free_coherent(acm
->dev
, acm
->writesize
,
1134 static int acm_probe(struct usb_interface
*intf
,
1135 const struct usb_device_id
*id
)
1137 struct usb_cdc_union_desc
*union_header
= NULL
;
1138 struct usb_cdc_call_mgmt_descriptor
*cmgmd
= NULL
;
1139 unsigned char *buffer
= intf
->altsetting
->extra
;
1140 int buflen
= intf
->altsetting
->extralen
;
1141 struct usb_interface
*control_interface
;
1142 struct usb_interface
*data_interface
;
1143 struct usb_endpoint_descriptor
*epctrl
= NULL
;
1144 struct usb_endpoint_descriptor
*epread
= NULL
;
1145 struct usb_endpoint_descriptor
*epwrite
= NULL
;
1146 struct usb_device
*usb_dev
= interface_to_usbdev(intf
);
1147 struct usb_cdc_parsed_header h
;
1150 int ctrlsize
, readsize
;
1152 int call_intf_num
= -1;
1153 int data_intf_num
= -1;
1154 unsigned long quirks
;
1157 int combined_interfaces
= 0;
1158 struct device
*tty_dev
;
1163 quirks
= (unsigned long)id
->driver_info
;
1165 if (quirks
== IGNORE_DEVICE
)
1168 memset(&h
, 0x00, sizeof(struct usb_cdc_parsed_header
));
1170 num_rx_buf
= (quirks
== SINGLE_RX_URB
) ? 1 : ACM_NR
;
1172 /* handle quirks deadly to normal probing*/
1173 if (quirks
== NO_UNION_NORMAL
) {
1174 data_interface
= usb_ifnum_to_if(usb_dev
, 1);
1175 control_interface
= usb_ifnum_to_if(usb_dev
, 0);
1176 /* we would crash */
1177 if (!data_interface
|| !control_interface
)
1179 goto skip_normal_probe
;
1184 dev_err(&intf
->dev
, "Weird descriptor references\n");
1188 if (!intf
->cur_altsetting
)
1192 if (intf
->cur_altsetting
->endpoint
&&
1193 intf
->cur_altsetting
->endpoint
->extralen
&&
1194 intf
->cur_altsetting
->endpoint
->extra
) {
1196 "Seeking extra descriptors on endpoint\n");
1197 buflen
= intf
->cur_altsetting
->endpoint
->extralen
;
1198 buffer
= intf
->cur_altsetting
->endpoint
->extra
;
1201 "Zero length descriptor references\n");
1206 cdc_parse_cdc_header(&h
, intf
, buffer
, buflen
);
1207 union_header
= h
.usb_cdc_union_desc
;
1208 cmgmd
= h
.usb_cdc_call_mgmt_descriptor
;
1210 call_intf_num
= cmgmd
->bDataInterface
;
1212 if (!union_header
) {
1213 if (call_intf_num
> 0) {
1214 dev_dbg(&intf
->dev
, "No union descriptor, using call management descriptor\n");
1215 /* quirks for Droids MuIn LCD */
1216 if (quirks
& NO_DATA_INTERFACE
) {
1217 data_interface
= usb_ifnum_to_if(usb_dev
, 0);
1219 data_intf_num
= call_intf_num
;
1220 data_interface
= usb_ifnum_to_if(usb_dev
, data_intf_num
);
1222 control_interface
= intf
;
1224 if (intf
->cur_altsetting
->desc
.bNumEndpoints
!= 3) {
1225 dev_dbg(&intf
->dev
,"No union descriptor, giving up\n");
1228 dev_warn(&intf
->dev
,"No union descriptor, testing for castrated device\n");
1229 combined_interfaces
= 1;
1230 control_interface
= data_interface
= intf
;
1231 goto look_for_collapsed_interface
;
1235 data_intf_num
= union_header
->bSlaveInterface0
;
1236 control_interface
= usb_ifnum_to_if(usb_dev
, union_header
->bMasterInterface0
);
1237 data_interface
= usb_ifnum_to_if(usb_dev
, data_intf_num
);
1240 if (!control_interface
|| !data_interface
) {
1241 dev_dbg(&intf
->dev
, "no interfaces\n");
1244 if (!data_interface
->cur_altsetting
|| !control_interface
->cur_altsetting
)
1247 if (data_intf_num
!= call_intf_num
)
1248 dev_dbg(&intf
->dev
, "Separate call control interface. That is not fully supported.\n");
1250 if (control_interface
== data_interface
) {
1251 /* some broken devices designed for windows work this way */
1252 dev_warn(&intf
->dev
,"Control and data interfaces are not separated!\n");
1253 combined_interfaces
= 1;
1254 /* a popular other OS doesn't use it */
1255 quirks
|= NO_CAP_LINE
;
1256 if (data_interface
->cur_altsetting
->desc
.bNumEndpoints
!= 3) {
1257 dev_err(&intf
->dev
, "This needs exactly 3 endpoints\n");
1260 look_for_collapsed_interface
:
1261 res
= usb_find_common_endpoints(data_interface
->cur_altsetting
,
1262 &epread
, &epwrite
, &epctrl
, NULL
);
1266 goto made_compressed_probe
;
1271 /*workaround for switched interfaces */
1272 if (data_interface
->cur_altsetting
->desc
.bInterfaceClass
1273 != CDC_DATA_INTERFACE_TYPE
) {
1274 if (control_interface
->cur_altsetting
->desc
.bInterfaceClass
1275 == CDC_DATA_INTERFACE_TYPE
) {
1277 "Your device has switched interfaces.\n");
1278 swap(control_interface
, data_interface
);
1284 /* Accept probe requests only for the control interface */
1285 if (!combined_interfaces
&& intf
!= control_interface
)
1288 if (!combined_interfaces
&& usb_interface_claimed(data_interface
)) {
1289 /* valid in this context */
1290 dev_dbg(&intf
->dev
, "The data interface isn't available\n");
1295 if (data_interface
->cur_altsetting
->desc
.bNumEndpoints
< 2 ||
1296 control_interface
->cur_altsetting
->desc
.bNumEndpoints
== 0)
1299 epctrl
= &control_interface
->cur_altsetting
->endpoint
[0].desc
;
1300 epread
= &data_interface
->cur_altsetting
->endpoint
[0].desc
;
1301 epwrite
= &data_interface
->cur_altsetting
->endpoint
[1].desc
;
1304 /* workaround for switched endpoints */
1305 if (!usb_endpoint_dir_in(epread
)) {
1306 /* descriptors are swapped */
1308 "The data interface has switched endpoints\n");
1309 swap(epread
, epwrite
);
1311 made_compressed_probe
:
1312 dev_dbg(&intf
->dev
, "interfaces are valid\n");
1314 acm
= kzalloc(sizeof(struct acm
), GFP_KERNEL
);
1318 tty_port_init(&acm
->port
);
1319 acm
->port
.ops
= &acm_port_ops
;
1321 minor
= acm_alloc_minor(acm
);
1325 ctrlsize
= usb_endpoint_maxp(epctrl
);
1326 readsize
= usb_endpoint_maxp(epread
) *
1327 (quirks
== SINGLE_RX_URB
? 1 : 2);
1328 acm
->combined_interfaces
= combined_interfaces
;
1329 acm
->writesize
= usb_endpoint_maxp(epwrite
) * 20;
1330 acm
->control
= control_interface
;
1331 acm
->data
= data_interface
;
1334 if (h
.usb_cdc_acm_descriptor
)
1335 acm
->ctrl_caps
= h
.usb_cdc_acm_descriptor
->bmCapabilities
;
1336 if (quirks
& NO_CAP_LINE
)
1337 acm
->ctrl_caps
&= ~USB_CDC_CAP_LINE
;
1338 acm
->ctrlsize
= ctrlsize
;
1339 acm
->readsize
= readsize
;
1340 acm
->rx_buflimit
= num_rx_buf
;
1341 INIT_WORK(&acm
->work
, acm_softint
);
1342 init_waitqueue_head(&acm
->wioctl
);
1343 spin_lock_init(&acm
->write_lock
);
1344 spin_lock_init(&acm
->read_lock
);
1345 mutex_init(&acm
->mutex
);
1346 if (usb_endpoint_xfer_int(epread
)) {
1347 acm
->bInterval
= epread
->bInterval
;
1348 acm
->in
= usb_rcvintpipe(usb_dev
, epread
->bEndpointAddress
);
1350 acm
->in
= usb_rcvbulkpipe(usb_dev
, epread
->bEndpointAddress
);
1352 if (usb_endpoint_xfer_int(epwrite
))
1353 acm
->out
= usb_sndintpipe(usb_dev
, epwrite
->bEndpointAddress
);
1355 acm
->out
= usb_sndbulkpipe(usb_dev
, epwrite
->bEndpointAddress
);
1356 init_usb_anchor(&acm
->delayed
);
1357 acm
->quirks
= quirks
;
1359 buf
= usb_alloc_coherent(usb_dev
, ctrlsize
, GFP_KERNEL
, &acm
->ctrl_dma
);
1362 acm
->ctrl_buffer
= buf
;
1364 if (acm_write_buffers_alloc(acm
) < 0)
1367 acm
->ctrlurb
= usb_alloc_urb(0, GFP_KERNEL
);
1371 for (i
= 0; i
< num_rx_buf
; i
++) {
1372 struct acm_rb
*rb
= &(acm
->read_buffers
[i
]);
1375 rb
->base
= usb_alloc_coherent(acm
->dev
, readsize
, GFP_KERNEL
,
1382 urb
= usb_alloc_urb(0, GFP_KERNEL
);
1386 urb
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
1387 urb
->transfer_dma
= rb
->dma
;
1388 if (usb_endpoint_xfer_int(epread
))
1389 usb_fill_int_urb(urb
, acm
->dev
, acm
->in
, rb
->base
,
1391 acm_read_bulk_callback
, rb
,
1394 usb_fill_bulk_urb(urb
, acm
->dev
, acm
->in
, rb
->base
,
1396 acm_read_bulk_callback
, rb
);
1398 acm
->read_urbs
[i
] = urb
;
1399 __set_bit(i
, &acm
->read_urbs_free
);
1401 for (i
= 0; i
< ACM_NW
; i
++) {
1402 struct acm_wb
*snd
= &(acm
->wb
[i
]);
1404 snd
->urb
= usb_alloc_urb(0, GFP_KERNEL
);
1405 if (snd
->urb
== NULL
)
1408 if (usb_endpoint_xfer_int(epwrite
))
1409 usb_fill_int_urb(snd
->urb
, usb_dev
, acm
->out
,
1410 NULL
, acm
->writesize
, acm_write_bulk
, snd
, epwrite
->bInterval
);
1412 usb_fill_bulk_urb(snd
->urb
, usb_dev
, acm
->out
,
1413 NULL
, acm
->writesize
, acm_write_bulk
, snd
);
1414 snd
->urb
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
1415 if (quirks
& SEND_ZERO_PACKET
)
1416 snd
->urb
->transfer_flags
|= URB_ZERO_PACKET
;
1417 snd
->instance
= acm
;
1420 usb_set_intfdata(intf
, acm
);
1422 i
= device_create_file(&intf
->dev
, &dev_attr_bmCapabilities
);
1426 if (h
.usb_cdc_country_functional_desc
) { /* export the country data */
1427 struct usb_cdc_country_functional_desc
* cfd
=
1428 h
.usb_cdc_country_functional_desc
;
1430 acm
->country_codes
= kmalloc(cfd
->bLength
- 4, GFP_KERNEL
);
1431 if (!acm
->country_codes
)
1432 goto skip_countries
;
1433 acm
->country_code_size
= cfd
->bLength
- 4;
1434 memcpy(acm
->country_codes
, (u8
*)&cfd
->wCountyCode0
,
1436 acm
->country_rel_date
= cfd
->iCountryCodeRelDate
;
1438 i
= device_create_file(&intf
->dev
, &dev_attr_wCountryCodes
);
1440 kfree(acm
->country_codes
);
1441 acm
->country_codes
= NULL
;
1442 acm
->country_code_size
= 0;
1443 goto skip_countries
;
1446 i
= device_create_file(&intf
->dev
,
1447 &dev_attr_iCountryCodeRelDate
);
1449 device_remove_file(&intf
->dev
, &dev_attr_wCountryCodes
);
1450 kfree(acm
->country_codes
);
1451 acm
->country_codes
= NULL
;
1452 acm
->country_code_size
= 0;
1453 goto skip_countries
;
1458 usb_fill_int_urb(acm
->ctrlurb
, usb_dev
,
1459 usb_rcvintpipe(usb_dev
, epctrl
->bEndpointAddress
),
1460 acm
->ctrl_buffer
, ctrlsize
, acm_ctrl_irq
, acm
,
1461 /* works around buggy devices */
1462 epctrl
->bInterval
? epctrl
->bInterval
: 16);
1463 acm
->ctrlurb
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
1464 acm
->ctrlurb
->transfer_dma
= acm
->ctrl_dma
;
1465 acm
->notification_buffer
= NULL
;
1469 dev_info(&intf
->dev
, "ttyACM%d: USB ACM device\n", minor
);
1471 acm
->line
.dwDTERate
= cpu_to_le32(9600);
1472 acm
->line
.bDataBits
= 8;
1473 acm_set_line(acm
, &acm
->line
);
1475 usb_driver_claim_interface(&acm_driver
, data_interface
, acm
);
1476 usb_set_intfdata(data_interface
, acm
);
1478 usb_get_intf(control_interface
);
1479 tty_dev
= tty_port_register_device(&acm
->port
, acm_tty_driver
, minor
,
1480 &control_interface
->dev
);
1481 if (IS_ERR(tty_dev
)) {
1482 rv
= PTR_ERR(tty_dev
);
1486 if (quirks
& CLEAR_HALT_CONDITIONS
) {
1487 usb_clear_halt(usb_dev
, acm
->in
);
1488 usb_clear_halt(usb_dev
, acm
->out
);
1493 if (acm
->country_codes
) {
1494 device_remove_file(&acm
->control
->dev
,
1495 &dev_attr_wCountryCodes
);
1496 device_remove_file(&acm
->control
->dev
,
1497 &dev_attr_iCountryCodeRelDate
);
1498 kfree(acm
->country_codes
);
1500 device_remove_file(&acm
->control
->dev
, &dev_attr_bmCapabilities
);
1502 usb_set_intfdata(intf
, NULL
);
1503 for (i
= 0; i
< ACM_NW
; i
++)
1504 usb_free_urb(acm
->wb
[i
].urb
);
1506 for (i
= 0; i
< num_rx_buf
; i
++)
1507 usb_free_urb(acm
->read_urbs
[i
]);
1508 acm_read_buffers_free(acm
);
1509 usb_free_urb(acm
->ctrlurb
);
1511 acm_write_buffers_free(acm
);
1513 usb_free_coherent(usb_dev
, ctrlsize
, acm
->ctrl_buffer
, acm
->ctrl_dma
);
1515 tty_port_put(&acm
->port
);
1520 static void acm_disconnect(struct usb_interface
*intf
)
1522 struct acm
*acm
= usb_get_intfdata(intf
);
1523 struct tty_struct
*tty
;
1526 /* sibling interface is already cleaning up */
1530 mutex_lock(&acm
->mutex
);
1531 acm
->disconnected
= true;
1532 if (acm
->country_codes
) {
1533 device_remove_file(&acm
->control
->dev
,
1534 &dev_attr_wCountryCodes
);
1535 device_remove_file(&acm
->control
->dev
,
1536 &dev_attr_iCountryCodeRelDate
);
1538 wake_up_all(&acm
->wioctl
);
1539 device_remove_file(&acm
->control
->dev
, &dev_attr_bmCapabilities
);
1540 usb_set_intfdata(acm
->control
, NULL
);
1541 usb_set_intfdata(acm
->data
, NULL
);
1542 mutex_unlock(&acm
->mutex
);
1544 tty
= tty_port_tty_get(&acm
->port
);
1551 cancel_work_sync(&acm
->work
);
1553 tty_unregister_device(acm_tty_driver
, acm
->minor
);
1555 usb_free_urb(acm
->ctrlurb
);
1556 for (i
= 0; i
< ACM_NW
; i
++)
1557 usb_free_urb(acm
->wb
[i
].urb
);
1558 for (i
= 0; i
< acm
->rx_buflimit
; i
++)
1559 usb_free_urb(acm
->read_urbs
[i
]);
1560 acm_write_buffers_free(acm
);
1561 usb_free_coherent(acm
->dev
, acm
->ctrlsize
, acm
->ctrl_buffer
, acm
->ctrl_dma
);
1562 acm_read_buffers_free(acm
);
1564 kfree(acm
->notification_buffer
);
1566 if (!acm
->combined_interfaces
)
1567 usb_driver_release_interface(&acm_driver
, intf
== acm
->control
?
1568 acm
->data
: acm
->control
);
1570 tty_port_put(&acm
->port
);
1574 static int acm_suspend(struct usb_interface
*intf
, pm_message_t message
)
1576 struct acm
*acm
= usb_get_intfdata(intf
);
1579 spin_lock_irq(&acm
->write_lock
);
1580 if (PMSG_IS_AUTO(message
)) {
1581 if (acm
->transmitting
) {
1582 spin_unlock_irq(&acm
->write_lock
);
1586 cnt
= acm
->susp_count
++;
1587 spin_unlock_irq(&acm
->write_lock
);
1593 cancel_work_sync(&acm
->work
);
1598 static int acm_resume(struct usb_interface
*intf
)
1600 struct acm
*acm
= usb_get_intfdata(intf
);
1604 spin_lock_irq(&acm
->write_lock
);
1606 if (--acm
->susp_count
)
1609 if (tty_port_initialized(&acm
->port
)) {
1610 rv
= usb_submit_urb(acm
->ctrlurb
, GFP_ATOMIC
);
1613 urb
= usb_get_from_anchor(&acm
->delayed
);
1617 acm_start_wb(acm
, urb
->context
);
1621 * delayed error checking because we must
1622 * do the write path at all cost
1627 rv
= acm_submit_read_urbs(acm
, GFP_ATOMIC
);
1630 spin_unlock_irq(&acm
->write_lock
);
1635 static int acm_reset_resume(struct usb_interface
*intf
)
1637 struct acm
*acm
= usb_get_intfdata(intf
);
1639 if (tty_port_initialized(&acm
->port
))
1640 tty_port_tty_hangup(&acm
->port
, false);
1642 return acm_resume(intf
);
1645 #endif /* CONFIG_PM */
1647 static int acm_pre_reset(struct usb_interface
*intf
)
1649 struct acm
*acm
= usb_get_intfdata(intf
);
1651 clear_bit(EVENT_RX_STALL
, &acm
->flags
);
1652 acm
->nb_index
= 0; /* pending control transfers are lost */
1657 #define NOKIA_PCSUITE_ACM_INFO(x) \
1658 USB_DEVICE_AND_INTERFACE_INFO(0x0421, x, \
1659 USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1660 USB_CDC_ACM_PROTO_VENDOR)
1662 #define SAMSUNG_PCSUITE_ACM_INFO(x) \
1663 USB_DEVICE_AND_INTERFACE_INFO(0x04e7, x, \
1664 USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1665 USB_CDC_ACM_PROTO_VENDOR)
1668 * USB driver structure.
1671 static const struct usb_device_id acm_ids
[] = {
1672 /* quirky and broken devices */
1673 { USB_DEVICE(0x076d, 0x0006), /* Denso Cradle CU-321 */
1674 .driver_info
= NO_UNION_NORMAL
, },/* has no union descriptor */
1675 { USB_DEVICE(0x17ef, 0x7000), /* Lenovo USB modem */
1676 .driver_info
= NO_UNION_NORMAL
, },/* has no union descriptor */
1677 { USB_DEVICE(0x0870, 0x0001), /* Metricom GS Modem */
1678 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1680 { USB_DEVICE(0x0e8d, 0x0003), /* FIREFLY, MediaTek Inc; andrey.arapov@gmail.com */
1681 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1683 { USB_DEVICE(0x0e8d, 0x2000), /* MediaTek Inc Preloader */
1684 .driver_info
= DISABLE_ECHO
, /* DISABLE ECHO in termios flag */
1686 { USB_DEVICE(0x0e8d, 0x3329), /* MediaTek Inc GPS */
1687 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1689 { USB_DEVICE(0x0482, 0x0203), /* KYOCERA AH-K3001V */
1690 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1692 { USB_DEVICE(0x079b, 0x000f), /* BT On-Air USB MODEM */
1693 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1695 { USB_DEVICE(0x0ace, 0x1602), /* ZyDAS 56K USB MODEM */
1696 .driver_info
= SINGLE_RX_URB
,
1698 { USB_DEVICE(0x0ace, 0x1608), /* ZyDAS 56K USB MODEM */
1699 .driver_info
= SINGLE_RX_URB
, /* firmware bug */
1701 { USB_DEVICE(0x0ace, 0x1611), /* ZyDAS 56K USB MODEM - new version */
1702 .driver_info
= SINGLE_RX_URB
, /* firmware bug */
1704 { USB_DEVICE(0x11ca, 0x0201), /* VeriFone Mx870 Gadget Serial */
1705 .driver_info
= SINGLE_RX_URB
,
1707 { USB_DEVICE(0x1965, 0x0018), /* Uniden UBC125XLT */
1708 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1710 { USB_DEVICE(0x22b8, 0x7000), /* Motorola Q Phone */
1711 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1713 { USB_DEVICE(0x0803, 0x3095), /* Zoom Telephonics Model 3095F USB MODEM */
1714 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1716 { USB_DEVICE(0x0572, 0x1321), /* Conexant USB MODEM CX93010 */
1717 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1719 { USB_DEVICE(0x0572, 0x1324), /* Conexant USB MODEM RD02-D400 */
1720 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1722 { USB_DEVICE(0x0572, 0x1328), /* Shiro / Aztech USB MODEM UM-3100 */
1723 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1725 { USB_DEVICE(0x0572, 0x1349), /* Hiro (Conexant) USB MODEM H50228 */
1726 .driver_info
= NO_UNION_NORMAL
, /* has no union descriptor */
1728 { USB_DEVICE(0x20df, 0x0001), /* Simtec Electronics Entropy Key */
1729 .driver_info
= QUIRK_CONTROL_LINE_STATE
, },
1730 { USB_DEVICE(0x2184, 0x001c) }, /* GW Instek AFG-2225 */
1731 { USB_DEVICE(0x2184, 0x0036) }, /* GW Instek AFG-125 */
1732 { USB_DEVICE(0x22b8, 0x6425), /* Motorola MOTOMAGX phones */
1734 /* Motorola H24 HSPA module: */
1735 { USB_DEVICE(0x22b8, 0x2d91) }, /* modem */
1736 { USB_DEVICE(0x22b8, 0x2d92), /* modem + diagnostics */
1737 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1739 { USB_DEVICE(0x22b8, 0x2d93), /* modem + AT port */
1740 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1742 { USB_DEVICE(0x22b8, 0x2d95), /* modem + AT port + diagnostics */
1743 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1745 { USB_DEVICE(0x22b8, 0x2d96), /* modem + NMEA */
1746 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1748 { USB_DEVICE(0x22b8, 0x2d97), /* modem + diagnostics + NMEA */
1749 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1751 { USB_DEVICE(0x22b8, 0x2d99), /* modem + AT port + NMEA */
1752 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1754 { USB_DEVICE(0x22b8, 0x2d9a), /* modem + AT port + diagnostics + NMEA */
1755 .driver_info
= NO_UNION_NORMAL
, /* handle only modem interface */
1758 { USB_DEVICE(0x0572, 0x1329), /* Hummingbird huc56s (Conexant) */
1759 .driver_info
= NO_UNION_NORMAL
, /* union descriptor misplaced on
1760 data interface instead of
1761 communications interface.
1762 Maybe we should define a new
1765 { USB_DEVICE(0x0572, 0x1340), /* Conexant CX93010-2x UCMxx */
1766 .driver_info
= NO_UNION_NORMAL
,
1768 { USB_DEVICE(0x05f9, 0x4002), /* PSC Scanning, Magellan 800i */
1769 .driver_info
= NO_UNION_NORMAL
,
1771 { USB_DEVICE(0x1bbb, 0x0003), /* Alcatel OT-I650 */
1772 .driver_info
= NO_UNION_NORMAL
, /* reports zero length descriptor */
1774 { USB_DEVICE(0x1576, 0x03b1), /* Maretron USB100 */
1775 .driver_info
= NO_UNION_NORMAL
, /* reports zero length descriptor */
1777 { USB_DEVICE(0xfff0, 0x0100), /* DATECS FP-2000 */
1778 .driver_info
= NO_UNION_NORMAL
, /* reports zero length descriptor */
1780 { USB_DEVICE(0x09d8, 0x0320), /* Elatec GmbH TWN3 */
1781 .driver_info
= NO_UNION_NORMAL
, /* has misplaced union descriptor */
1783 { USB_DEVICE(0x0ca6, 0xa050), /* Castles VEGA3000 */
1784 .driver_info
= NO_UNION_NORMAL
, /* reports zero length descriptor */
1787 { USB_DEVICE(0x2912, 0x0001), /* ATOL FPrint */
1788 .driver_info
= CLEAR_HALT_CONDITIONS
,
1791 /* Nokia S60 phones expose two ACM channels. The first is
1792 * a modem and is picked up by the standard AT-command
1793 * information below. The second is 'vendor-specific' but
1794 * is treated as a serial device at the S60 end, so we want
1795 * to expose it on Linux too. */
1796 { NOKIA_PCSUITE_ACM_INFO(0x042D), }, /* Nokia 3250 */
1797 { NOKIA_PCSUITE_ACM_INFO(0x04D8), }, /* Nokia 5500 Sport */
1798 { NOKIA_PCSUITE_ACM_INFO(0x04C9), }, /* Nokia E50 */
1799 { NOKIA_PCSUITE_ACM_INFO(0x0419), }, /* Nokia E60 */
1800 { NOKIA_PCSUITE_ACM_INFO(0x044D), }, /* Nokia E61 */
1801 { NOKIA_PCSUITE_ACM_INFO(0x0001), }, /* Nokia E61i */
1802 { NOKIA_PCSUITE_ACM_INFO(0x0475), }, /* Nokia E62 */
1803 { NOKIA_PCSUITE_ACM_INFO(0x0508), }, /* Nokia E65 */
1804 { NOKIA_PCSUITE_ACM_INFO(0x0418), }, /* Nokia E70 */
1805 { NOKIA_PCSUITE_ACM_INFO(0x0425), }, /* Nokia N71 */
1806 { NOKIA_PCSUITE_ACM_INFO(0x0486), }, /* Nokia N73 */
1807 { NOKIA_PCSUITE_ACM_INFO(0x04DF), }, /* Nokia N75 */
1808 { NOKIA_PCSUITE_ACM_INFO(0x000e), }, /* Nokia N77 */
1809 { NOKIA_PCSUITE_ACM_INFO(0x0445), }, /* Nokia N80 */
1810 { NOKIA_PCSUITE_ACM_INFO(0x042F), }, /* Nokia N91 & N91 8GB */
1811 { NOKIA_PCSUITE_ACM_INFO(0x048E), }, /* Nokia N92 */
1812 { NOKIA_PCSUITE_ACM_INFO(0x0420), }, /* Nokia N93 */
1813 { NOKIA_PCSUITE_ACM_INFO(0x04E6), }, /* Nokia N93i */
1814 { NOKIA_PCSUITE_ACM_INFO(0x04B2), }, /* Nokia 5700 XpressMusic */
1815 { NOKIA_PCSUITE_ACM_INFO(0x0134), }, /* Nokia 6110 Navigator (China) */
1816 { NOKIA_PCSUITE_ACM_INFO(0x046E), }, /* Nokia 6110 Navigator */
1817 { NOKIA_PCSUITE_ACM_INFO(0x002f), }, /* Nokia 6120 classic & */
1818 { NOKIA_PCSUITE_ACM_INFO(0x0088), }, /* Nokia 6121 classic */
1819 { NOKIA_PCSUITE_ACM_INFO(0x00fc), }, /* Nokia 6124 classic */
1820 { NOKIA_PCSUITE_ACM_INFO(0x0042), }, /* Nokia E51 */
1821 { NOKIA_PCSUITE_ACM_INFO(0x00b0), }, /* Nokia E66 */
1822 { NOKIA_PCSUITE_ACM_INFO(0x00ab), }, /* Nokia E71 */
1823 { NOKIA_PCSUITE_ACM_INFO(0x0481), }, /* Nokia N76 */
1824 { NOKIA_PCSUITE_ACM_INFO(0x0007), }, /* Nokia N81 & N81 8GB */
1825 { NOKIA_PCSUITE_ACM_INFO(0x0071), }, /* Nokia N82 */
1826 { NOKIA_PCSUITE_ACM_INFO(0x04F0), }, /* Nokia N95 & N95-3 NAM */
1827 { NOKIA_PCSUITE_ACM_INFO(0x0070), }, /* Nokia N95 8GB */
1828 { NOKIA_PCSUITE_ACM_INFO(0x00e9), }, /* Nokia 5320 XpressMusic */
1829 { NOKIA_PCSUITE_ACM_INFO(0x0099), }, /* Nokia 6210 Navigator, RM-367 */
1830 { NOKIA_PCSUITE_ACM_INFO(0x0128), }, /* Nokia 6210 Navigator, RM-419 */
1831 { NOKIA_PCSUITE_ACM_INFO(0x008f), }, /* Nokia 6220 Classic */
1832 { NOKIA_PCSUITE_ACM_INFO(0x00a0), }, /* Nokia 6650 */
1833 { NOKIA_PCSUITE_ACM_INFO(0x007b), }, /* Nokia N78 */
1834 { NOKIA_PCSUITE_ACM_INFO(0x0094), }, /* Nokia N85 */
1835 { NOKIA_PCSUITE_ACM_INFO(0x003a), }, /* Nokia N96 & N96-3 */
1836 { NOKIA_PCSUITE_ACM_INFO(0x00e9), }, /* Nokia 5320 XpressMusic */
1837 { NOKIA_PCSUITE_ACM_INFO(0x0108), }, /* Nokia 5320 XpressMusic 2G */
1838 { NOKIA_PCSUITE_ACM_INFO(0x01f5), }, /* Nokia N97, RM-505 */
1839 { NOKIA_PCSUITE_ACM_INFO(0x02e3), }, /* Nokia 5230, RM-588 */
1840 { NOKIA_PCSUITE_ACM_INFO(0x0178), }, /* Nokia E63 */
1841 { NOKIA_PCSUITE_ACM_INFO(0x010e), }, /* Nokia E75 */
1842 { NOKIA_PCSUITE_ACM_INFO(0x02d9), }, /* Nokia 6760 Slide */
1843 { NOKIA_PCSUITE_ACM_INFO(0x01d0), }, /* Nokia E52 */
1844 { NOKIA_PCSUITE_ACM_INFO(0x0223), }, /* Nokia E72 */
1845 { NOKIA_PCSUITE_ACM_INFO(0x0275), }, /* Nokia X6 */
1846 { NOKIA_PCSUITE_ACM_INFO(0x026c), }, /* Nokia N97 Mini */
1847 { NOKIA_PCSUITE_ACM_INFO(0x0154), }, /* Nokia 5800 XpressMusic */
1848 { NOKIA_PCSUITE_ACM_INFO(0x04ce), }, /* Nokia E90 */
1849 { NOKIA_PCSUITE_ACM_INFO(0x01d4), }, /* Nokia E55 */
1850 { NOKIA_PCSUITE_ACM_INFO(0x0302), }, /* Nokia N8 */
1851 { NOKIA_PCSUITE_ACM_INFO(0x0335), }, /* Nokia E7 */
1852 { NOKIA_PCSUITE_ACM_INFO(0x03cd), }, /* Nokia C7 */
1853 { SAMSUNG_PCSUITE_ACM_INFO(0x6651), }, /* Samsung GTi8510 (INNOV8) */
1855 /* Support for Owen devices */
1856 { USB_DEVICE(0x03eb, 0x0030), }, /* Owen SI30 */
1858 /* NOTE: non-Nokia COMM/ACM/0xff is likely MSFT RNDIS... NOT a modem! */
1860 /* Support for Droids MuIn LCD */
1861 { USB_DEVICE(0x04d8, 0x000b),
1862 .driver_info
= NO_DATA_INTERFACE
,
1865 #if IS_ENABLED(CONFIG_INPUT_IMS_PCU)
1866 { USB_DEVICE(0x04d8, 0x0082), /* Application mode */
1867 .driver_info
= IGNORE_DEVICE
,
1869 { USB_DEVICE(0x04d8, 0x0083), /* Bootloader mode */
1870 .driver_info
= IGNORE_DEVICE
,
1874 /*Samsung phone in firmware update mode */
1875 { USB_DEVICE(0x04e8, 0x685d),
1876 .driver_info
= IGNORE_DEVICE
,
1879 /* Exclude Infineon Flash Loader utility */
1880 { USB_DEVICE(0x058b, 0x0041),
1881 .driver_info
= IGNORE_DEVICE
,
1884 { USB_DEVICE(0x1bc7, 0x0021), /* Telit 3G ACM only composition */
1885 .driver_info
= SEND_ZERO_PACKET
,
1887 { USB_DEVICE(0x1bc7, 0x0023), /* Telit 3G ACM + ECM composition */
1888 .driver_info
= SEND_ZERO_PACKET
,
1891 /* control interfaces without any protocol set */
1892 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1893 USB_CDC_PROTO_NONE
) },
1895 /* control interfaces with various AT-command sets */
1896 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1897 USB_CDC_ACM_PROTO_AT_V25TER
) },
1898 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1899 USB_CDC_ACM_PROTO_AT_PCCA101
) },
1900 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1901 USB_CDC_ACM_PROTO_AT_PCCA101_WAKE
) },
1902 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1903 USB_CDC_ACM_PROTO_AT_GSM
) },
1904 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1905 USB_CDC_ACM_PROTO_AT_3G
) },
1906 { USB_INTERFACE_INFO(USB_CLASS_COMM
, USB_CDC_SUBCLASS_ACM
,
1907 USB_CDC_ACM_PROTO_AT_CDMA
) },
1909 { USB_DEVICE(0x1519, 0x0452), /* Intel 7260 modem */
1910 .driver_info
= SEND_ZERO_PACKET
,
1916 MODULE_DEVICE_TABLE(usb
, acm_ids
);
1918 static struct usb_driver acm_driver
= {
1921 .disconnect
= acm_disconnect
,
1923 .suspend
= acm_suspend
,
1924 .resume
= acm_resume
,
1925 .reset_resume
= acm_reset_resume
,
1927 .pre_reset
= acm_pre_reset
,
1928 .id_table
= acm_ids
,
1930 .supports_autosuspend
= 1,
1932 .disable_hub_initiated_lpm
= 1,
1936 * TTY driver structures.
1939 static const struct tty_operations acm_ops
= {
1940 .install
= acm_tty_install
,
1941 .open
= acm_tty_open
,
1942 .close
= acm_tty_close
,
1943 .cleanup
= acm_tty_cleanup
,
1944 .hangup
= acm_tty_hangup
,
1945 .write
= acm_tty_write
,
1946 .write_room
= acm_tty_write_room
,
1947 .ioctl
= acm_tty_ioctl
,
1948 .throttle
= acm_tty_throttle
,
1949 .unthrottle
= acm_tty_unthrottle
,
1950 .chars_in_buffer
= acm_tty_chars_in_buffer
,
1951 .break_ctl
= acm_tty_break_ctl
,
1952 .set_termios
= acm_tty_set_termios
,
1953 .tiocmget
= acm_tty_tiocmget
,
1954 .tiocmset
= acm_tty_tiocmset
,
1955 .get_serial
= get_serial_info
,
1956 .set_serial
= set_serial_info
,
1957 .get_icount
= acm_tty_get_icount
,
1964 static int __init
acm_init(void)
1967 acm_tty_driver
= alloc_tty_driver(ACM_TTY_MINORS
);
1968 if (!acm_tty_driver
)
1970 acm_tty_driver
->driver_name
= "acm",
1971 acm_tty_driver
->name
= "ttyACM",
1972 acm_tty_driver
->major
= ACM_TTY_MAJOR
,
1973 acm_tty_driver
->minor_start
= 0,
1974 acm_tty_driver
->type
= TTY_DRIVER_TYPE_SERIAL
,
1975 acm_tty_driver
->subtype
= SERIAL_TYPE_NORMAL
,
1976 acm_tty_driver
->flags
= TTY_DRIVER_REAL_RAW
| TTY_DRIVER_DYNAMIC_DEV
;
1977 acm_tty_driver
->init_termios
= tty_std_termios
;
1978 acm_tty_driver
->init_termios
.c_cflag
= B9600
| CS8
| CREAD
|
1980 tty_set_operations(acm_tty_driver
, &acm_ops
);
1982 retval
= tty_register_driver(acm_tty_driver
);
1984 put_tty_driver(acm_tty_driver
);
1988 retval
= usb_register(&acm_driver
);
1990 tty_unregister_driver(acm_tty_driver
);
1991 put_tty_driver(acm_tty_driver
);
1995 printk(KERN_INFO KBUILD_MODNAME
": " DRIVER_DESC
"\n");
2000 static void __exit
acm_exit(void)
2002 usb_deregister(&acm_driver
);
2003 tty_unregister_driver(acm_tty_driver
);
2004 put_tty_driver(acm_tty_driver
);
2005 idr_destroy(&acm_minors
);
2008 module_init(acm_init
);
2009 module_exit(acm_exit
);
2011 MODULE_AUTHOR(DRIVER_AUTHOR
);
2012 MODULE_DESCRIPTION(DRIVER_DESC
);
2013 MODULE_LICENSE("GPL");
2014 MODULE_ALIAS_CHARDEV_MAJOR(ACM_TTY_MAJOR
);