4 * Copyright (c) 1999 Armin Fuerst <fuerst@in.tum.de>
5 * Copyright (c) 1999 Pavel Machek <pavel@ucw.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 * Copyright (c) 2011 Johan Hovold <jhovold@gmail.com>
12 * USB Abstract Control Model driver for USB modems and ISDN adapters
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation; either version 2 of the License, or
19 * (at your option) any later version.
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
26 * You should have received a copy of the GNU General Public License
27 * along with this program; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
34 #include <linux/kernel.h>
35 #include <linux/errno.h>
36 #include <linux/init.h>
37 #include <linux/slab.h>
38 #include <linux/tty.h>
39 #include <linux/serial.h>
40 #include <linux/tty_driver.h>
41 #include <linux/tty_flip.h>
42 #include <linux/module.h>
43 #include <linux/mutex.h>
44 #include <linux/uaccess.h>
45 #include <linux/usb.h>
46 #include <linux/usb/cdc.h>
47 #include <asm/byteorder.h>
48 #include <asm/unaligned.h>
49 #include <linux/idr.h>
50 #include <linux/list.h>
55 #define DRIVER_AUTHOR "Armin Fuerst, Pavel Machek, Johannes Erdfelt, Vojtech Pavlik, David Kubicek, Johan Hovold"
56 #define DRIVER_DESC "USB Abstract Control Model driver for USB modems and ISDN adapters"
58 static struct usb_driver acm_driver;
59 static struct tty_driver *acm_tty_driver;
61 static DEFINE_IDR(acm_minors);
62 static DEFINE_MUTEX(acm_minors_lock);
64 static void acm_tty_set_termios(struct tty_struct *tty,
65 struct ktermios *termios_old);
68 * acm_minors accessors
72 * Look up an ACM structure by minor. If found and not disconnected, increment
73 * its refcount and return it with its mutex held.
75 static struct acm *acm_get_by_minor(unsigned int minor)
79 mutex_lock(&acm_minors_lock);
80 acm = idr_find(&acm_minors, minor);
82 mutex_lock(&acm->mutex);
83 if (acm->disconnected) {
84 mutex_unlock(&acm->mutex);
87 tty_port_get(&acm->port);
88 mutex_unlock(&acm->mutex);
91 mutex_unlock(&acm_minors_lock);
96 * Try to find an available minor number and if found, associate it with 'acm'.
98 static int acm_alloc_minor(struct acm *acm)
102 mutex_lock(&acm_minors_lock);
103 minor = idr_alloc(&acm_minors, acm, 0, ACM_TTY_MINORS, GFP_KERNEL);
104 mutex_unlock(&acm_minors_lock);
109 /* Release the minor number associated with 'acm'. */
110 static void acm_release_minor(struct acm *acm)
112 mutex_lock(&acm_minors_lock);
113 idr_remove(&acm_minors, acm->minor);
114 mutex_unlock(&acm_minors_lock);
118 * Functions for ACM control messages.
121 static int acm_ctrl_msg(struct acm *acm, int request, int value,
126 retval = usb_autopm_get_interface(acm->control);
130 retval = usb_control_msg(acm->dev, usb_sndctrlpipe(acm->dev, 0),
131 request, USB_RT_ACM, value,
132 acm->control->altsetting[0].desc.bInterfaceNumber,
135 dev_dbg(&acm->control->dev,
136 "%s - rq 0x%02x, val %#x, len %#x, result %d\n",
137 __func__, request, value, len, retval);
139 usb_autopm_put_interface(acm->control);
141 return retval < 0 ? retval : 0;
144 /* devices aren't required to support these requests.
145 * the cdc acm descriptor tells whether they do...
147 static inline int acm_set_control(struct acm *acm, int control)
149 if (acm->quirks & QUIRK_CONTROL_LINE_STATE)
152 return acm_ctrl_msg(acm, USB_CDC_REQ_SET_CONTROL_LINE_STATE,
156 #define acm_set_line(acm, line) \
157 acm_ctrl_msg(acm, USB_CDC_REQ_SET_LINE_CODING, 0, line, sizeof *(line))
158 #define acm_send_break(acm, ms) \
159 acm_ctrl_msg(acm, USB_CDC_REQ_SEND_BREAK, ms, NULL, 0)
162 * Write buffer management.
163 * All of these assume proper locks taken by the caller.
166 static int acm_wb_alloc(struct acm *acm)
179 wbn = (wbn + 1) % ACM_NW;
185 static int acm_wb_is_avail(struct acm *acm)
191 spin_lock_irqsave(&acm->write_lock, flags);
192 for (i = 0; i < ACM_NW; i++)
194 spin_unlock_irqrestore(&acm->write_lock, flags);
199 * Finish write. Caller must hold acm->write_lock
201 static void acm_write_done(struct acm *acm, struct acm_wb *wb)
205 usb_autopm_put_interface_async(acm->control);
211 * the caller is responsible for locking
214 static int acm_start_wb(struct acm *acm, struct acm_wb *wb)
220 wb->urb->transfer_buffer = wb->buf;
221 wb->urb->transfer_dma = wb->dmah;
222 wb->urb->transfer_buffer_length = wb->len;
223 wb->urb->dev = acm->dev;
225 rc = usb_submit_urb(wb->urb, GFP_ATOMIC);
227 dev_err(&acm->data->dev,
228 "%s - usb_submit_urb(write bulk) failed: %d\n",
230 acm_write_done(acm, wb);
236 * attributes exported through sysfs
238 static ssize_t show_caps
239 (struct device *dev, struct device_attribute *attr, char *buf)
241 struct usb_interface *intf = to_usb_interface(dev);
242 struct acm *acm = usb_get_intfdata(intf);
244 return sprintf(buf, "%d", acm->ctrl_caps);
246 static DEVICE_ATTR(bmCapabilities, S_IRUGO, show_caps, NULL);
248 static ssize_t show_country_codes
249 (struct device *dev, struct device_attribute *attr, char *buf)
251 struct usb_interface *intf = to_usb_interface(dev);
252 struct acm *acm = usb_get_intfdata(intf);
254 memcpy(buf, acm->country_codes, acm->country_code_size);
255 return acm->country_code_size;
258 static DEVICE_ATTR(wCountryCodes, S_IRUGO, show_country_codes, NULL);
260 static ssize_t show_country_rel_date
261 (struct device *dev, struct device_attribute *attr, char *buf)
263 struct usb_interface *intf = to_usb_interface(dev);
264 struct acm *acm = usb_get_intfdata(intf);
266 return sprintf(buf, "%d", acm->country_rel_date);
269 static DEVICE_ATTR(iCountryCodeRelDate, S_IRUGO, show_country_rel_date, NULL);
271 * Interrupt handlers for various ACM device responses
274 /* control interface reports status changes with "interrupt" transfers */
275 static void acm_ctrl_irq(struct urb *urb)
277 struct acm *acm = urb->context;
278 struct usb_cdc_notification *dr = urb->transfer_buffer;
283 int status = urb->status;
292 /* this urb is terminated, clean up */
293 dev_dbg(&acm->control->dev,
294 "%s - urb shutting down with status: %d\n",
298 dev_dbg(&acm->control->dev,
299 "%s - nonzero urb status received: %d\n",
304 usb_mark_last_busy(acm->dev);
306 data = (unsigned char *)(dr + 1);
307 switch (dr->bNotificationType) {
308 case USB_CDC_NOTIFY_NETWORK_CONNECTION:
309 dev_dbg(&acm->control->dev, "%s - network connection: %d\n",
310 __func__, dr->wValue);
313 case USB_CDC_NOTIFY_SERIAL_STATE:
314 if (le16_to_cpu(dr->wLength) != 2) {
315 dev_dbg(&acm->control->dev,
316 "%s - malformed serial state\n", __func__);
320 newctrl = get_unaligned_le16(data);
322 if (!acm->clocal && (acm->ctrlin & ~newctrl & ACM_CTRL_DCD)) {
323 dev_dbg(&acm->control->dev, "%s - calling hangup\n",
325 tty_port_tty_hangup(&acm->port, false);
328 difference = acm->ctrlin ^ newctrl;
329 spin_lock(&acm->read_lock);
330 acm->ctrlin = newctrl;
331 acm->oldcount = acm->iocount;
333 if (difference & ACM_CTRL_DSR)
335 if (difference & ACM_CTRL_DCD)
337 if (newctrl & ACM_CTRL_BRK) {
339 tty_insert_flip_char(&acm->port, 0, TTY_BREAK);
341 if (newctrl & ACM_CTRL_RI)
343 if (newctrl & ACM_CTRL_FRAMING)
344 acm->iocount.frame++;
345 if (newctrl & ACM_CTRL_PARITY)
346 acm->iocount.parity++;
347 if (newctrl & ACM_CTRL_OVERRUN)
348 acm->iocount.overrun++;
349 spin_unlock(&acm->read_lock);
351 if (newctrl & ACM_CTRL_BRK)
352 tty_flip_buffer_push(&acm->port);
355 wake_up_all(&acm->wioctl);
360 dev_dbg(&acm->control->dev,
361 "%s - unknown notification %d received: index %d len %d\n",
363 dr->bNotificationType, dr->wIndex, dr->wLength);
368 retval = usb_submit_urb(urb, GFP_ATOMIC);
369 if (retval && retval != -EPERM)
370 dev_err(&acm->control->dev, "%s - usb_submit_urb failed: %d\n",
374 static int acm_submit_read_urb(struct acm *acm, int index, gfp_t mem_flags)
378 if (!test_and_clear_bit(index, &acm->read_urbs_free))
381 dev_vdbg(&acm->data->dev, "%s - urb %d\n", __func__, index);
383 res = usb_submit_urb(acm->read_urbs[index], mem_flags);
385 if (res != -EPERM && res != -ENODEV) {
386 dev_err(&acm->data->dev,
387 "%s - usb_submit_urb failed: %d\n",
390 set_bit(index, &acm->read_urbs_free);
397 static int acm_submit_read_urbs(struct acm *acm, gfp_t mem_flags)
402 for (i = 0; i < acm->rx_buflimit; ++i) {
403 res = acm_submit_read_urb(acm, i, mem_flags);
411 static void acm_process_read_urb(struct acm *acm, struct urb *urb)
415 if (!urb->actual_length)
418 spin_lock_irqsave(&acm->read_lock, flags);
419 tty_insert_flip_string(&acm->port, urb->transfer_buffer,
421 spin_unlock_irqrestore(&acm->read_lock, flags);
423 tty_flip_buffer_push(&acm->port);
426 static void acm_read_bulk_callback(struct urb *urb)
428 struct acm_rb *rb = urb->context;
429 struct acm *acm = rb->instance;
431 int status = urb->status;
433 dev_vdbg(&acm->data->dev, "%s - urb %d, len %d\n", __func__,
434 rb->index, urb->actual_length);
437 set_bit(rb->index, &acm->read_urbs_free);
438 dev_dbg(&acm->data->dev, "%s - disconnected\n", __func__);
443 set_bit(rb->index, &acm->read_urbs_free);
444 dev_dbg(&acm->data->dev, "%s - non-zero urb status: %d\n",
446 if ((status != -ENOENT) || (urb->actual_length == 0))
450 usb_mark_last_busy(acm->dev);
452 acm_process_read_urb(acm, urb);
454 * Unthrottle may run on another CPU which needs to see events
455 * in the same order. Submission has an implict barrier
457 smp_mb__before_atomic();
458 set_bit(rb->index, &acm->read_urbs_free);
460 /* throttle device if requested by tty */
461 spin_lock_irqsave(&acm->read_lock, flags);
462 acm->throttled = acm->throttle_req;
463 if (!acm->throttled) {
464 spin_unlock_irqrestore(&acm->read_lock, flags);
465 acm_submit_read_urb(acm, rb->index, GFP_ATOMIC);
467 spin_unlock_irqrestore(&acm->read_lock, flags);
471 /* data interface wrote those outgoing bytes */
472 static void acm_write_bulk(struct urb *urb)
474 struct acm_wb *wb = urb->context;
475 struct acm *acm = wb->instance;
477 int status = urb->status;
479 if (status || (urb->actual_length != urb->transfer_buffer_length))
480 dev_vdbg(&acm->data->dev, "%s - len %d/%d, status %d\n",
483 urb->transfer_buffer_length,
486 spin_lock_irqsave(&acm->write_lock, flags);
487 acm_write_done(acm, wb);
488 spin_unlock_irqrestore(&acm->write_lock, flags);
489 schedule_work(&acm->work);
492 static void acm_softint(struct work_struct *work)
494 struct acm *acm = container_of(work, struct acm, work);
496 dev_vdbg(&acm->data->dev, "%s\n", __func__);
498 tty_port_tty_wakeup(&acm->port);
505 static int acm_tty_install(struct tty_driver *driver, struct tty_struct *tty)
510 dev_dbg(tty->dev, "%s\n", __func__);
512 acm = acm_get_by_minor(tty->index);
516 retval = tty_standard_install(driver, tty);
518 goto error_init_termios;
521 * Suppress initial echoing for some devices which might send data
522 * immediately after acm driver has been installed.
524 if (acm->quirks & DISABLE_ECHO)
525 tty->termios.c_lflag &= ~ECHO;
527 tty->driver_data = acm;
532 tty_port_put(&acm->port);
536 static int acm_tty_open(struct tty_struct *tty, struct file *filp)
538 struct acm *acm = tty->driver_data;
540 dev_dbg(tty->dev, "%s\n", __func__);
542 return tty_port_open(&acm->port, tty, filp);
545 static void acm_port_dtr_rts(struct tty_port *port, int raise)
547 struct acm *acm = container_of(port, struct acm, port);
552 val = ACM_CTRL_DTR | ACM_CTRL_RTS;
556 /* FIXME: add missing ctrlout locking throughout driver */
559 res = acm_set_control(acm, val);
560 if (res && (acm->ctrl_caps & USB_CDC_CAP_LINE))
561 /* This is broken in too many devices to spam the logs */
562 dev_dbg(&acm->control->dev, "failed to set dtr/rts\n");
565 static int acm_port_activate(struct tty_port *port, struct tty_struct *tty)
567 struct acm *acm = container_of(port, struct acm, port);
568 int retval = -ENODEV;
571 dev_dbg(&acm->control->dev, "%s\n", __func__);
573 mutex_lock(&acm->mutex);
574 if (acm->disconnected)
577 retval = usb_autopm_get_interface(acm->control);
579 goto error_get_interface;
582 * FIXME: Why do we need this? Allocating 64K of physically contiguous
583 * memory is really nasty...
585 set_bit(TTY_NO_WRITE_SPLIT, &tty->flags);
586 acm->control->needs_remote_wakeup = 1;
588 acm->ctrlurb->dev = acm->dev;
589 retval = usb_submit_urb(acm->ctrlurb, GFP_KERNEL);
591 dev_err(&acm->control->dev,
592 "%s - usb_submit_urb(ctrl irq) failed\n", __func__);
593 goto error_submit_urb;
596 acm_tty_set_termios(tty, NULL);
599 * Unthrottle device in case the TTY was closed while throttled.
601 spin_lock_irq(&acm->read_lock);
603 acm->throttle_req = 0;
604 spin_unlock_irq(&acm->read_lock);
606 retval = acm_submit_read_urbs(acm, GFP_KERNEL);
608 goto error_submit_read_urbs;
610 usb_autopm_put_interface(acm->control);
612 mutex_unlock(&acm->mutex);
616 error_submit_read_urbs:
617 for (i = 0; i < acm->rx_buflimit; i++)
618 usb_kill_urb(acm->read_urbs[i]);
619 usb_kill_urb(acm->ctrlurb);
621 usb_autopm_put_interface(acm->control);
624 mutex_unlock(&acm->mutex);
626 return usb_translate_errors(retval);
629 static void acm_port_destruct(struct tty_port *port)
631 struct acm *acm = container_of(port, struct acm, port);
633 dev_dbg(&acm->control->dev, "%s\n", __func__);
635 acm_release_minor(acm);
636 usb_put_intf(acm->control);
637 kfree(acm->country_codes);
641 static void acm_port_shutdown(struct tty_port *port)
643 struct acm *acm = container_of(port, struct acm, port);
648 dev_dbg(&acm->control->dev, "%s\n", __func__);
651 * Need to grab write_lock to prevent race with resume, but no need to
652 * hold it due to the tty-port initialised flag.
654 spin_lock_irq(&acm->write_lock);
655 spin_unlock_irq(&acm->write_lock);
657 usb_autopm_get_interface_no_resume(acm->control);
658 acm->control->needs_remote_wakeup = 0;
659 usb_autopm_put_interface(acm->control);
662 urb = usb_get_from_anchor(&acm->delayed);
667 usb_autopm_put_interface_async(acm->control);
670 usb_kill_urb(acm->ctrlurb);
671 for (i = 0; i < ACM_NW; i++)
672 usb_kill_urb(acm->wb[i].urb);
673 for (i = 0; i < acm->rx_buflimit; i++)
674 usb_kill_urb(acm->read_urbs[i]);
677 static void acm_tty_cleanup(struct tty_struct *tty)
679 struct acm *acm = tty->driver_data;
680 dev_dbg(&acm->control->dev, "%s\n", __func__);
681 tty_port_put(&acm->port);
684 static void acm_tty_hangup(struct tty_struct *tty)
686 struct acm *acm = tty->driver_data;
687 dev_dbg(&acm->control->dev, "%s\n", __func__);
688 tty_port_hangup(&acm->port);
691 static void acm_tty_close(struct tty_struct *tty, struct file *filp)
693 struct acm *acm = tty->driver_data;
694 dev_dbg(&acm->control->dev, "%s\n", __func__);
695 tty_port_close(&acm->port, tty, filp);
698 static int acm_tty_write(struct tty_struct *tty,
699 const unsigned char *buf, int count)
701 struct acm *acm = tty->driver_data;
710 dev_vdbg(&acm->data->dev, "%s - count %d\n", __func__, count);
712 spin_lock_irqsave(&acm->write_lock, flags);
713 wbn = acm_wb_alloc(acm);
715 spin_unlock_irqrestore(&acm->write_lock, flags);
722 spin_unlock_irqrestore(&acm->write_lock, flags);
726 count = (count > acm->writesize) ? acm->writesize : count;
727 dev_vdbg(&acm->data->dev, "%s - write %d\n", __func__, count);
728 memcpy(wb->buf, buf, count);
731 stat = usb_autopm_get_interface_async(acm->control);
734 spin_unlock_irqrestore(&acm->write_lock, flags);
738 if (acm->susp_count) {
739 usb_anchor_urb(wb->urb, &acm->delayed);
740 spin_unlock_irqrestore(&acm->write_lock, flags);
744 stat = acm_start_wb(acm, wb);
745 spin_unlock_irqrestore(&acm->write_lock, flags);
752 static int acm_tty_write_room(struct tty_struct *tty)
754 struct acm *acm = tty->driver_data;
756 * Do not let the line discipline to know that we have a reserve,
757 * or it might get too enthusiastic.
759 return acm_wb_is_avail(acm) ? acm->writesize : 0;
762 static int acm_tty_chars_in_buffer(struct tty_struct *tty)
764 struct acm *acm = tty->driver_data;
766 * if the device was unplugged then any remaining characters fell out
767 * of the connector ;)
769 if (acm->disconnected)
772 * This is inaccurate (overcounts), but it works.
774 return (ACM_NW - acm_wb_is_avail(acm)) * acm->writesize;
777 static void acm_tty_throttle(struct tty_struct *tty)
779 struct acm *acm = tty->driver_data;
781 spin_lock_irq(&acm->read_lock);
782 acm->throttle_req = 1;
783 spin_unlock_irq(&acm->read_lock);
786 static void acm_tty_unthrottle(struct tty_struct *tty)
788 struct acm *acm = tty->driver_data;
789 unsigned int was_throttled;
791 spin_lock_irq(&acm->read_lock);
792 was_throttled = acm->throttled;
794 acm->throttle_req = 0;
795 spin_unlock_irq(&acm->read_lock);
798 acm_submit_read_urbs(acm, GFP_KERNEL);
801 static int acm_tty_break_ctl(struct tty_struct *tty, int state)
803 struct acm *acm = tty->driver_data;
806 retval = acm_send_break(acm, state ? 0xffff : 0);
808 dev_dbg(&acm->control->dev, "%s - send break failed\n",
813 static int acm_tty_tiocmget(struct tty_struct *tty)
815 struct acm *acm = tty->driver_data;
817 return (acm->ctrlout & ACM_CTRL_DTR ? TIOCM_DTR : 0) |
818 (acm->ctrlout & ACM_CTRL_RTS ? TIOCM_RTS : 0) |
819 (acm->ctrlin & ACM_CTRL_DSR ? TIOCM_DSR : 0) |
820 (acm->ctrlin & ACM_CTRL_RI ? TIOCM_RI : 0) |
821 (acm->ctrlin & ACM_CTRL_DCD ? TIOCM_CD : 0) |
825 static int acm_tty_tiocmset(struct tty_struct *tty,
826 unsigned int set, unsigned int clear)
828 struct acm *acm = tty->driver_data;
829 unsigned int newctrl;
831 newctrl = acm->ctrlout;
832 set = (set & TIOCM_DTR ? ACM_CTRL_DTR : 0) |
833 (set & TIOCM_RTS ? ACM_CTRL_RTS : 0);
834 clear = (clear & TIOCM_DTR ? ACM_CTRL_DTR : 0) |
835 (clear & TIOCM_RTS ? ACM_CTRL_RTS : 0);
837 newctrl = (newctrl & ~clear) | set;
839 if (acm->ctrlout == newctrl)
841 return acm_set_control(acm, acm->ctrlout = newctrl);
844 static int get_serial_info(struct acm *acm, struct serial_struct __user *info)
846 struct serial_struct tmp;
851 memset(&tmp, 0, sizeof(tmp));
852 tmp.flags = ASYNC_LOW_LATENCY;
853 tmp.xmit_fifo_size = acm->writesize;
854 tmp.baud_base = le32_to_cpu(acm->line.dwDTERate);
855 tmp.close_delay = jiffies_to_msecs(acm->port.close_delay) / 10;
856 tmp.closing_wait = acm->port.closing_wait == ASYNC_CLOSING_WAIT_NONE ?
857 ASYNC_CLOSING_WAIT_NONE :
858 jiffies_to_msecs(acm->port.closing_wait) / 10;
860 if (copy_to_user(info, &tmp, sizeof(tmp)))
866 static int set_serial_info(struct acm *acm,
867 struct serial_struct __user *newinfo)
869 struct serial_struct new_serial;
870 unsigned int closing_wait, close_delay;
871 unsigned int old_closing_wait, old_close_delay;
874 if (copy_from_user(&new_serial, newinfo, sizeof(new_serial)))
877 close_delay = msecs_to_jiffies(new_serial.close_delay * 10);
878 closing_wait = new_serial.closing_wait == ASYNC_CLOSING_WAIT_NONE ?
879 ASYNC_CLOSING_WAIT_NONE :
880 msecs_to_jiffies(new_serial.closing_wait * 10);
882 /* we must redo the rounding here, so that the values match */
883 old_close_delay = jiffies_to_msecs(acm->port.close_delay) / 10;
884 old_closing_wait = acm->port.closing_wait == ASYNC_CLOSING_WAIT_NONE ?
885 ASYNC_CLOSING_WAIT_NONE :
886 jiffies_to_msecs(acm->port.closing_wait) / 10;
888 mutex_lock(&acm->port.mutex);
890 if (!capable(CAP_SYS_ADMIN)) {
891 if ((new_serial.close_delay != old_close_delay) ||
892 (new_serial.closing_wait != old_closing_wait))
895 acm->port.close_delay = close_delay;
896 acm->port.closing_wait = closing_wait;
899 mutex_unlock(&acm->port.mutex);
903 static int wait_serial_change(struct acm *acm, unsigned long arg)
906 DECLARE_WAITQUEUE(wait, current);
907 struct async_icount old, new;
910 spin_lock_irq(&acm->read_lock);
914 spin_unlock_irq(&acm->read_lock);
916 if ((arg & TIOCM_DSR) &&
919 if ((arg & TIOCM_CD) &&
922 if ((arg & TIOCM_RI) &&
926 add_wait_queue(&acm->wioctl, &wait);
927 set_current_state(TASK_INTERRUPTIBLE);
929 remove_wait_queue(&acm->wioctl, &wait);
930 if (acm->disconnected) {
936 if (signal_pending(current))
946 static int get_serial_usage(struct acm *acm,
947 struct serial_icounter_struct __user *count)
949 struct serial_icounter_struct icount;
952 memset(&icount, 0, sizeof(icount));
953 icount.dsr = acm->iocount.dsr;
954 icount.rng = acm->iocount.rng;
955 icount.dcd = acm->iocount.dcd;
956 icount.frame = acm->iocount.frame;
957 icount.overrun = acm->iocount.overrun;
958 icount.parity = acm->iocount.parity;
959 icount.brk = acm->iocount.brk;
961 if (copy_to_user(count, &icount, sizeof(icount)) > 0)
967 static int acm_tty_ioctl(struct tty_struct *tty,
968 unsigned int cmd, unsigned long arg)
970 struct acm *acm = tty->driver_data;
971 int rv = -ENOIOCTLCMD;
974 case TIOCGSERIAL: /* gets serial port data */
975 rv = get_serial_info(acm, (struct serial_struct __user *) arg);
978 rv = set_serial_info(acm, (struct serial_struct __user *) arg);
981 rv = usb_autopm_get_interface(acm->control);
986 rv = wait_serial_change(acm, arg);
987 usb_autopm_put_interface(acm->control);
990 rv = get_serial_usage(acm, (struct serial_icounter_struct __user *) arg);
997 static void acm_tty_set_termios(struct tty_struct *tty,
998 struct ktermios *termios_old)
1000 struct acm *acm = tty->driver_data;
1001 struct ktermios *termios = &tty->termios;
1002 struct usb_cdc_line_coding newline;
1003 int newctrl = acm->ctrlout;
1005 newline.dwDTERate = cpu_to_le32(tty_get_baud_rate(tty));
1006 newline.bCharFormat = termios->c_cflag & CSTOPB ? 2 : 0;
1007 newline.bParityType = termios->c_cflag & PARENB ?
1008 (termios->c_cflag & PARODD ? 1 : 2) +
1009 (termios->c_cflag & CMSPAR ? 2 : 0) : 0;
1010 switch (termios->c_cflag & CSIZE) {
1012 newline.bDataBits = 5;
1015 newline.bDataBits = 6;
1018 newline.bDataBits = 7;
1022 newline.bDataBits = 8;
1025 /* FIXME: Needs to clear unsupported bits in the termios */
1026 acm->clocal = ((termios->c_cflag & CLOCAL) != 0);
1028 if (C_BAUD(tty) == B0) {
1029 newline.dwDTERate = acm->line.dwDTERate;
1030 newctrl &= ~ACM_CTRL_DTR;
1031 } else if (termios_old && (termios_old->c_cflag & CBAUD) == B0) {
1032 newctrl |= ACM_CTRL_DTR;
1035 if (newctrl != acm->ctrlout)
1036 acm_set_control(acm, acm->ctrlout = newctrl);
1038 if (memcmp(&acm->line, &newline, sizeof newline)) {
1039 memcpy(&acm->line, &newline, sizeof newline);
1040 dev_dbg(&acm->control->dev, "%s - set line: %d %d %d %d\n",
1042 le32_to_cpu(newline.dwDTERate),
1043 newline.bCharFormat, newline.bParityType,
1045 acm_set_line(acm, &acm->line);
1049 static const struct tty_port_operations acm_port_ops = {
1050 .dtr_rts = acm_port_dtr_rts,
1051 .shutdown = acm_port_shutdown,
1052 .activate = acm_port_activate,
1053 .destruct = acm_port_destruct,
1057 * USB probe and disconnect routines.
1060 /* Little helpers: write/read buffers free */
1061 static void acm_write_buffers_free(struct acm *acm)
1065 struct usb_device *usb_dev = interface_to_usbdev(acm->control);
1067 for (wb = &acm->wb[0], i = 0; i < ACM_NW; i++, wb++)
1068 usb_free_coherent(usb_dev, acm->writesize, wb->buf, wb->dmah);
1071 static void acm_read_buffers_free(struct acm *acm)
1073 struct usb_device *usb_dev = interface_to_usbdev(acm->control);
1076 for (i = 0; i < acm->rx_buflimit; i++)
1077 usb_free_coherent(usb_dev, acm->readsize,
1078 acm->read_buffers[i].base, acm->read_buffers[i].dma);
1081 /* Little helper: write buffers allocate */
1082 static int acm_write_buffers_alloc(struct acm *acm)
1087 for (wb = &acm->wb[0], i = 0; i < ACM_NW; i++, wb++) {
1088 wb->buf = usb_alloc_coherent(acm->dev, acm->writesize, GFP_KERNEL,
1094 usb_free_coherent(acm->dev, acm->writesize,
1103 static int acm_probe(struct usb_interface *intf,
1104 const struct usb_device_id *id)
1106 struct usb_cdc_union_desc *union_header = NULL;
1107 struct usb_cdc_country_functional_desc *cfd = NULL;
1108 unsigned char *buffer = intf->altsetting->extra;
1109 int buflen = intf->altsetting->extralen;
1110 struct usb_interface *control_interface;
1111 struct usb_interface *data_interface;
1112 struct usb_endpoint_descriptor *epctrl = NULL;
1113 struct usb_endpoint_descriptor *epread = NULL;
1114 struct usb_endpoint_descriptor *epwrite = NULL;
1115 struct usb_device *usb_dev = interface_to_usbdev(intf);
1118 int ctrlsize, readsize;
1120 u8 ac_management_function = 0;
1121 u8 call_management_function = 0;
1122 int call_interface_num = -1;
1123 int data_interface_num = -1;
1124 unsigned long quirks;
1127 unsigned int elength = 0;
1128 int combined_interfaces = 0;
1129 struct device *tty_dev;
1133 quirks = (unsigned long)id->driver_info;
1135 if (quirks == IGNORE_DEVICE)
1138 num_rx_buf = (quirks == SINGLE_RX_URB) ? 1 : ACM_NR;
1140 /* handle quirks deadly to normal probing*/
1141 if (quirks == NO_UNION_NORMAL) {
1142 data_interface = usb_ifnum_to_if(usb_dev, 1);
1143 control_interface = usb_ifnum_to_if(usb_dev, 0);
1144 /* we would crash */
1145 if (!data_interface || !control_interface)
1147 goto skip_normal_probe;
1152 dev_err(&intf->dev, "Weird descriptor references\n");
1157 if (intf->cur_altsetting->endpoint &&
1158 intf->cur_altsetting->endpoint->extralen &&
1159 intf->cur_altsetting->endpoint->extra) {
1161 "Seeking extra descriptors on endpoint\n");
1162 buflen = intf->cur_altsetting->endpoint->extralen;
1163 buffer = intf->cur_altsetting->endpoint->extra;
1166 "Zero length descriptor references\n");
1171 while (buflen > 0) {
1172 elength = buffer[0];
1174 dev_err(&intf->dev, "skipping garbage byte\n");
1178 if (buffer[1] != USB_DT_CS_INTERFACE) {
1179 dev_err(&intf->dev, "skipping garbage\n");
1183 switch (buffer[2]) {
1184 case USB_CDC_UNION_TYPE: /* we've found it */
1185 if (elength < sizeof(struct usb_cdc_union_desc))
1188 dev_err(&intf->dev, "More than one "
1189 "union descriptor, skipping ...\n");
1192 union_header = (struct usb_cdc_union_desc *)buffer;
1194 case USB_CDC_COUNTRY_TYPE: /* export through sysfs*/
1195 if (elength < sizeof(struct usb_cdc_country_functional_desc))
1197 cfd = (struct usb_cdc_country_functional_desc *)buffer;
1199 case USB_CDC_HEADER_TYPE: /* maybe check version */
1200 break; /* for now we ignore it */
1201 case USB_CDC_ACM_TYPE:
1204 ac_management_function = buffer[3];
1206 case USB_CDC_CALL_MANAGEMENT_TYPE:
1209 call_management_function = buffer[3];
1210 call_interface_num = buffer[4];
1214 * there are LOTS more CDC descriptors that
1215 * could legitimately be found here.
1217 dev_dbg(&intf->dev, "Ignoring descriptor: "
1218 "type %02x, length %ud\n",
1219 buffer[2], elength);
1227 if (!union_header) {
1228 if (call_interface_num > 0) {
1229 dev_dbg(&intf->dev, "No union descriptor, using call management descriptor\n");
1230 /* quirks for Droids MuIn LCD */
1231 if (quirks & NO_DATA_INTERFACE)
1232 data_interface = usb_ifnum_to_if(usb_dev, 0);
1234 data_interface = usb_ifnum_to_if(usb_dev, (data_interface_num = call_interface_num));
1235 control_interface = intf;
1237 if (intf->cur_altsetting->desc.bNumEndpoints != 3) {
1238 dev_dbg(&intf->dev,"No union descriptor, giving up\n");
1241 dev_warn(&intf->dev,"No union descriptor, testing for castrated device\n");
1242 combined_interfaces = 1;
1243 control_interface = data_interface = intf;
1244 goto look_for_collapsed_interface;
1248 control_interface = usb_ifnum_to_if(usb_dev, union_header->bMasterInterface0);
1249 data_interface = usb_ifnum_to_if(usb_dev, (data_interface_num = union_header->bSlaveInterface0));
1252 if (!control_interface || !data_interface) {
1253 dev_dbg(&intf->dev, "no interfaces\n");
1257 if (data_interface_num != call_interface_num)
1258 dev_dbg(&intf->dev, "Separate call control interface. That is not fully supported.\n");
1260 if (control_interface == data_interface) {
1261 /* some broken devices designed for windows work this way */
1262 dev_warn(&intf->dev,"Control and data interfaces are not separated!\n");
1263 combined_interfaces = 1;
1264 /* a popular other OS doesn't use it */
1265 quirks |= NO_CAP_LINE;
1266 if (data_interface->cur_altsetting->desc.bNumEndpoints != 3) {
1267 dev_err(&intf->dev, "This needs exactly 3 endpoints\n");
1270 look_for_collapsed_interface:
1271 for (i = 0; i < 3; i++) {
1272 struct usb_endpoint_descriptor *ep;
1273 ep = &data_interface->cur_altsetting->endpoint[i].desc;
1275 if (usb_endpoint_is_int_in(ep))
1277 else if (usb_endpoint_is_bulk_out(ep))
1279 else if (usb_endpoint_is_bulk_in(ep))
1284 if (!epctrl || !epread || !epwrite)
1287 goto made_compressed_probe;
1292 /*workaround for switched interfaces */
1293 if (data_interface->cur_altsetting->desc.bInterfaceClass
1294 != CDC_DATA_INTERFACE_TYPE) {
1295 if (control_interface->cur_altsetting->desc.bInterfaceClass
1296 == CDC_DATA_INTERFACE_TYPE) {
1298 "Your device has switched interfaces.\n");
1299 swap(control_interface, data_interface);
1305 /* Accept probe requests only for the control interface */
1306 if (!combined_interfaces && intf != control_interface)
1309 if (!combined_interfaces && usb_interface_claimed(data_interface)) {
1310 /* valid in this context */
1311 dev_dbg(&intf->dev, "The data interface isn't available\n");
1316 if (data_interface->cur_altsetting->desc.bNumEndpoints < 2 ||
1317 control_interface->cur_altsetting->desc.bNumEndpoints == 0)
1320 epctrl = &control_interface->cur_altsetting->endpoint[0].desc;
1321 epread = &data_interface->cur_altsetting->endpoint[0].desc;
1322 epwrite = &data_interface->cur_altsetting->endpoint[1].desc;
1325 /* workaround for switched endpoints */
1326 if (!usb_endpoint_dir_in(epread)) {
1327 /* descriptors are swapped */
1329 "The data interface has switched endpoints\n");
1330 swap(epread, epwrite);
1332 made_compressed_probe:
1333 dev_dbg(&intf->dev, "interfaces are valid\n");
1335 acm = kzalloc(sizeof(struct acm), GFP_KERNEL);
1339 ctrlsize = usb_endpoint_maxp(epctrl);
1340 readsize = usb_endpoint_maxp(epread) *
1341 (quirks == SINGLE_RX_URB ? 1 : 2);
1342 acm->combined_interfaces = combined_interfaces;
1343 acm->writesize = usb_endpoint_maxp(epwrite) * 20;
1344 acm->control = control_interface;
1345 acm->data = data_interface;
1347 usb_get_intf(acm->control); /* undone in destruct() */
1349 minor = acm_alloc_minor(acm);
1351 dev_err(&intf->dev, "no more free acm devices\n");
1358 acm->ctrl_caps = ac_management_function;
1359 if (quirks & NO_CAP_LINE)
1360 acm->ctrl_caps &= ~USB_CDC_CAP_LINE;
1361 acm->ctrlsize = ctrlsize;
1362 acm->readsize = readsize;
1363 acm->rx_buflimit = num_rx_buf;
1364 INIT_WORK(&acm->work, acm_softint);
1365 init_waitqueue_head(&acm->wioctl);
1366 spin_lock_init(&acm->write_lock);
1367 spin_lock_init(&acm->read_lock);
1368 mutex_init(&acm->mutex);
1369 acm->is_int_ep = usb_endpoint_xfer_int(epread);
1371 acm->bInterval = epread->bInterval;
1372 tty_port_init(&acm->port);
1373 acm->port.ops = &acm_port_ops;
1374 init_usb_anchor(&acm->delayed);
1375 acm->quirks = quirks;
1377 buf = usb_alloc_coherent(usb_dev, ctrlsize, GFP_KERNEL, &acm->ctrl_dma);
1380 acm->ctrl_buffer = buf;
1382 if (acm_write_buffers_alloc(acm) < 0)
1385 acm->ctrlurb = usb_alloc_urb(0, GFP_KERNEL);
1389 for (i = 0; i < num_rx_buf; i++) {
1390 struct acm_rb *rb = &(acm->read_buffers[i]);
1393 rb->base = usb_alloc_coherent(acm->dev, readsize, GFP_KERNEL,
1400 urb = usb_alloc_urb(0, GFP_KERNEL);
1404 urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1405 urb->transfer_dma = rb->dma;
1406 if (acm->is_int_ep) {
1407 usb_fill_int_urb(urb, acm->dev,
1408 usb_rcvintpipe(usb_dev, epread->bEndpointAddress),
1411 acm_read_bulk_callback, rb,
1414 usb_fill_bulk_urb(urb, acm->dev,
1415 usb_rcvbulkpipe(usb_dev, epread->bEndpointAddress),
1418 acm_read_bulk_callback, rb);
1421 acm->read_urbs[i] = urb;
1422 __set_bit(i, &acm->read_urbs_free);
1424 for (i = 0; i < ACM_NW; i++) {
1425 struct acm_wb *snd = &(acm->wb[i]);
1427 snd->urb = usb_alloc_urb(0, GFP_KERNEL);
1428 if (snd->urb == NULL)
1431 if (usb_endpoint_xfer_int(epwrite))
1432 usb_fill_int_urb(snd->urb, usb_dev,
1433 usb_sndintpipe(usb_dev, epwrite->bEndpointAddress),
1434 NULL, acm->writesize, acm_write_bulk, snd, epwrite->bInterval);
1436 usb_fill_bulk_urb(snd->urb, usb_dev,
1437 usb_sndbulkpipe(usb_dev, epwrite->bEndpointAddress),
1438 NULL, acm->writesize, acm_write_bulk, snd);
1439 snd->urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1440 if (quirks & SEND_ZERO_PACKET)
1441 snd->urb->transfer_flags |= URB_ZERO_PACKET;
1442 snd->instance = acm;
1445 usb_set_intfdata(intf, acm);
1447 i = device_create_file(&intf->dev, &dev_attr_bmCapabilities);
1451 if (cfd) { /* export the country data */
1452 acm->country_codes = kmalloc(cfd->bLength - 4, GFP_KERNEL);
1453 if (!acm->country_codes)
1454 goto skip_countries;
1455 acm->country_code_size = cfd->bLength - 4;
1456 memcpy(acm->country_codes, (u8 *)&cfd->wCountyCode0,
1458 acm->country_rel_date = cfd->iCountryCodeRelDate;
1460 i = device_create_file(&intf->dev, &dev_attr_wCountryCodes);
1462 kfree(acm->country_codes);
1463 acm->country_codes = NULL;
1464 acm->country_code_size = 0;
1465 goto skip_countries;
1468 i = device_create_file(&intf->dev,
1469 &dev_attr_iCountryCodeRelDate);
1471 device_remove_file(&intf->dev, &dev_attr_wCountryCodes);
1472 kfree(acm->country_codes);
1473 acm->country_codes = NULL;
1474 acm->country_code_size = 0;
1475 goto skip_countries;
1480 usb_fill_int_urb(acm->ctrlurb, usb_dev,
1481 usb_rcvintpipe(usb_dev, epctrl->bEndpointAddress),
1482 acm->ctrl_buffer, ctrlsize, acm_ctrl_irq, acm,
1483 /* works around buggy devices */
1484 epctrl->bInterval ? epctrl->bInterval : 16);
1485 acm->ctrlurb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1486 acm->ctrlurb->transfer_dma = acm->ctrl_dma;
1488 dev_info(&intf->dev, "ttyACM%d: USB ACM device\n", minor);
1490 acm->line.dwDTERate = cpu_to_le32(9600);
1491 acm->line.bDataBits = 8;
1492 acm_set_line(acm, &acm->line);
1494 usb_driver_claim_interface(&acm_driver, data_interface, acm);
1495 usb_set_intfdata(data_interface, acm);
1497 tty_dev = tty_port_register_device(&acm->port, acm_tty_driver, minor,
1498 &control_interface->dev);
1499 if (IS_ERR(tty_dev)) {
1500 rv = PTR_ERR(tty_dev);
1504 if (quirks & CLEAR_HALT_CONDITIONS) {
1505 usb_clear_halt(usb_dev, usb_rcvbulkpipe(usb_dev, epread->bEndpointAddress));
1506 usb_clear_halt(usb_dev, usb_sndbulkpipe(usb_dev, epwrite->bEndpointAddress));
1511 if (!acm->combined_interfaces) {
1512 /* Clear driver data so that disconnect() returns early. */
1513 usb_set_intfdata(data_interface, NULL);
1514 usb_driver_release_interface(&acm_driver, data_interface);
1516 if (acm->country_codes) {
1517 device_remove_file(&acm->control->dev,
1518 &dev_attr_wCountryCodes);
1519 device_remove_file(&acm->control->dev,
1520 &dev_attr_iCountryCodeRelDate);
1521 kfree(acm->country_codes);
1523 device_remove_file(&acm->control->dev, &dev_attr_bmCapabilities);
1525 usb_set_intfdata(intf, NULL);
1526 for (i = 0; i < ACM_NW; i++)
1527 usb_free_urb(acm->wb[i].urb);
1529 for (i = 0; i < num_rx_buf; i++)
1530 usb_free_urb(acm->read_urbs[i]);
1531 acm_read_buffers_free(acm);
1532 usb_free_urb(acm->ctrlurb);
1534 acm_write_buffers_free(acm);
1536 usb_free_coherent(usb_dev, ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
1538 acm_release_minor(acm);
1544 static void stop_data_traffic(struct acm *acm)
1548 dev_dbg(&acm->control->dev, "%s\n", __func__);
1550 usb_kill_urb(acm->ctrlurb);
1551 for (i = 0; i < ACM_NW; i++)
1552 usb_kill_urb(acm->wb[i].urb);
1553 for (i = 0; i < acm->rx_buflimit; i++)
1554 usb_kill_urb(acm->read_urbs[i]);
1556 cancel_work_sync(&acm->work);
1559 static void acm_disconnect(struct usb_interface *intf)
1561 struct acm *acm = usb_get_intfdata(intf);
1562 struct usb_device *usb_dev = interface_to_usbdev(intf);
1563 struct tty_struct *tty;
1566 dev_dbg(&intf->dev, "%s\n", __func__);
1568 /* sibling interface is already cleaning up */
1572 mutex_lock(&acm->mutex);
1573 acm->disconnected = true;
1574 if (acm->country_codes) {
1575 device_remove_file(&acm->control->dev,
1576 &dev_attr_wCountryCodes);
1577 device_remove_file(&acm->control->dev,
1578 &dev_attr_iCountryCodeRelDate);
1580 wake_up_all(&acm->wioctl);
1581 device_remove_file(&acm->control->dev, &dev_attr_bmCapabilities);
1582 usb_set_intfdata(acm->control, NULL);
1583 usb_set_intfdata(acm->data, NULL);
1584 mutex_unlock(&acm->mutex);
1586 tty = tty_port_tty_get(&acm->port);
1592 stop_data_traffic(acm);
1594 tty_unregister_device(acm_tty_driver, acm->minor);
1596 usb_free_urb(acm->ctrlurb);
1597 for (i = 0; i < ACM_NW; i++)
1598 usb_free_urb(acm->wb[i].urb);
1599 for (i = 0; i < acm->rx_buflimit; i++)
1600 usb_free_urb(acm->read_urbs[i]);
1601 acm_write_buffers_free(acm);
1602 usb_free_coherent(usb_dev, acm->ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
1603 acm_read_buffers_free(acm);
1605 if (!acm->combined_interfaces)
1606 usb_driver_release_interface(&acm_driver, intf == acm->control ?
1607 acm->data : acm->control);
1609 tty_port_put(&acm->port);
1613 static int acm_suspend(struct usb_interface *intf, pm_message_t message)
1615 struct acm *acm = usb_get_intfdata(intf);
1618 spin_lock_irq(&acm->write_lock);
1619 if (PMSG_IS_AUTO(message)) {
1620 if (acm->transmitting) {
1621 spin_unlock_irq(&acm->write_lock);
1625 cnt = acm->susp_count++;
1626 spin_unlock_irq(&acm->write_lock);
1631 stop_data_traffic(acm);
1636 static int acm_resume(struct usb_interface *intf)
1638 struct acm *acm = usb_get_intfdata(intf);
1642 spin_lock_irq(&acm->write_lock);
1644 if (--acm->susp_count)
1647 if (test_bit(ASYNCB_INITIALIZED, &acm->port.flags)) {
1648 rv = usb_submit_urb(acm->ctrlurb, GFP_ATOMIC);
1651 urb = usb_get_from_anchor(&acm->delayed);
1655 acm_start_wb(acm, urb->context);
1659 * delayed error checking because we must
1660 * do the write path at all cost
1665 rv = acm_submit_read_urbs(acm, GFP_ATOMIC);
1668 spin_unlock_irq(&acm->write_lock);
1673 static int acm_reset_resume(struct usb_interface *intf)
1675 struct acm *acm = usb_get_intfdata(intf);
1677 if (test_bit(ASYNCB_INITIALIZED, &acm->port.flags))
1678 tty_port_tty_hangup(&acm->port, false);
1680 return acm_resume(intf);
1683 #endif /* CONFIG_PM */
1685 #define NOKIA_PCSUITE_ACM_INFO(x) \
1686 USB_DEVICE_AND_INTERFACE_INFO(0x0421, x, \
1687 USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1688 USB_CDC_ACM_PROTO_VENDOR)
1690 #define SAMSUNG_PCSUITE_ACM_INFO(x) \
1691 USB_DEVICE_AND_INTERFACE_INFO(0x04e7, x, \
1692 USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1693 USB_CDC_ACM_PROTO_VENDOR)
1696 * USB driver structure.
1699 static const struct usb_device_id acm_ids[] = {
1700 /* quirky and broken devices */
1701 { USB_DEVICE(0x0424, 0x274e), /* Microchip Technology, Inc. (formerly SMSC) */
1702 .driver_info = DISABLE_ECHO, }, /* DISABLE ECHO in termios flag */
1703 { USB_DEVICE(0x076d, 0x0006), /* Denso Cradle CU-321 */
1704 .driver_info = NO_UNION_NORMAL, },/* has no union descriptor */
1705 { USB_DEVICE(0x17ef, 0x7000), /* Lenovo USB modem */
1706 .driver_info = NO_UNION_NORMAL, },/* has no union descriptor */
1707 { USB_DEVICE(0x0870, 0x0001), /* Metricom GS Modem */
1708 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1710 { USB_DEVICE(0x045b, 0x023c), /* Renesas USB Download mode */
1711 .driver_info = DISABLE_ECHO, /* Don't echo banner */
1713 { USB_DEVICE(0x045b, 0x0248), /* Renesas USB Download mode */
1714 .driver_info = DISABLE_ECHO, /* Don't echo banner */
1716 { USB_DEVICE(0x045b, 0x024D), /* Renesas USB Download mode */
1717 .driver_info = DISABLE_ECHO, /* Don't echo banner */
1719 { USB_DEVICE(0x0e8d, 0x0003), /* FIREFLY, MediaTek Inc; andrey.arapov@gmail.com */
1720 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1722 { USB_DEVICE(0x0e8d, 0x2000), /* MediaTek Inc Preloader */
1723 .driver_info = DISABLE_ECHO, /* DISABLE ECHO in termios flag */
1725 { USB_DEVICE(0x0e8d, 0x3329), /* MediaTek Inc GPS */
1726 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1728 { USB_DEVICE(0x0482, 0x0203), /* KYOCERA AH-K3001V */
1729 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1731 { USB_DEVICE(0x079b, 0x000f), /* BT On-Air USB MODEM */
1732 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1734 { USB_DEVICE(0x0ace, 0x1602), /* ZyDAS 56K USB MODEM */
1735 .driver_info = SINGLE_RX_URB,
1737 { USB_DEVICE(0x0ace, 0x1608), /* ZyDAS 56K USB MODEM */
1738 .driver_info = SINGLE_RX_URB, /* firmware bug */
1740 { USB_DEVICE(0x0ace, 0x1611), /* ZyDAS 56K USB MODEM - new version */
1741 .driver_info = SINGLE_RX_URB, /* firmware bug */
1743 { USB_DEVICE(0x11ca, 0x0201), /* VeriFone Mx870 Gadget Serial */
1744 .driver_info = SINGLE_RX_URB,
1746 { USB_DEVICE(0x1965, 0x0018), /* Uniden UBC125XLT */
1747 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1749 { USB_DEVICE(0x22b8, 0x7000), /* Motorola Q Phone */
1750 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1752 { USB_DEVICE(0x0803, 0x3095), /* Zoom Telephonics Model 3095F USB MODEM */
1753 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1755 { USB_DEVICE(0x0572, 0x1321), /* Conexant USB MODEM CX93010 */
1756 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1758 { USB_DEVICE(0x0572, 0x1324), /* Conexant USB MODEM RD02-D400 */
1759 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1761 { USB_DEVICE(0x0572, 0x1328), /* Shiro / Aztech USB MODEM UM-3100 */
1762 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1764 { USB_DEVICE(0x0572, 0x1349), /* Hiro (Conexant) USB MODEM H50228 */
1765 .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1767 { USB_DEVICE(0x20df, 0x0001), /* Simtec Electronics Entropy Key */
1768 .driver_info = QUIRK_CONTROL_LINE_STATE, },
1769 { USB_DEVICE(0x2184, 0x001c) }, /* GW Instek AFG-2225 */
1770 { USB_DEVICE(0x2184, 0x0036) }, /* GW Instek AFG-125 */
1771 { USB_DEVICE(0x22b8, 0x6425), /* Motorola MOTOMAGX phones */
1773 /* Motorola H24 HSPA module: */
1774 { USB_DEVICE(0x22b8, 0x2d91) }, /* modem */
1775 { USB_DEVICE(0x22b8, 0x2d92), /* modem + diagnostics */
1776 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1778 { USB_DEVICE(0x22b8, 0x2d93), /* modem + AT port */
1779 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1781 { USB_DEVICE(0x22b8, 0x2d95), /* modem + AT port + diagnostics */
1782 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1784 { USB_DEVICE(0x22b8, 0x2d96), /* modem + NMEA */
1785 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1787 { USB_DEVICE(0x22b8, 0x2d97), /* modem + diagnostics + NMEA */
1788 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1790 { USB_DEVICE(0x22b8, 0x2d99), /* modem + AT port + NMEA */
1791 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1793 { USB_DEVICE(0x22b8, 0x2d9a), /* modem + AT port + diagnostics + NMEA */
1794 .driver_info = NO_UNION_NORMAL, /* handle only modem interface */
1797 { USB_DEVICE(0x0572, 0x1329), /* Hummingbird huc56s (Conexant) */
1798 .driver_info = NO_UNION_NORMAL, /* union descriptor misplaced on
1799 data interface instead of
1800 communications interface.
1801 Maybe we should define a new
1804 { USB_DEVICE(0x0572, 0x1340), /* Conexant CX93010-2x UCMxx */
1805 .driver_info = NO_UNION_NORMAL,
1807 { USB_DEVICE(0x05f9, 0x4002), /* PSC Scanning, Magellan 800i */
1808 .driver_info = NO_UNION_NORMAL,
1810 { USB_DEVICE(0x1bbb, 0x0003), /* Alcatel OT-I650 */
1811 .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1813 { USB_DEVICE(0x1576, 0x03b1), /* Maretron USB100 */
1814 .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1816 { USB_DEVICE(0xfff0, 0x0100), /* DATECS FP-2000 */
1817 .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1819 { USB_DEVICE(0x09d8, 0x0320), /* Elatec GmbH TWN3 */
1820 .driver_info = NO_UNION_NORMAL, /* has misplaced union descriptor */
1822 { USB_DEVICE(0x0ca6, 0xa050), /* Castles VEGA3000 */
1823 .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1826 { USB_DEVICE(0x2912, 0x0001), /* ATOL FPrint */
1827 .driver_info = CLEAR_HALT_CONDITIONS,
1830 /* Nokia S60 phones expose two ACM channels. The first is
1831 * a modem and is picked up by the standard AT-command
1832 * information below. The second is 'vendor-specific' but
1833 * is treated as a serial device at the S60 end, so we want
1834 * to expose it on Linux too. */
1835 { NOKIA_PCSUITE_ACM_INFO(0x042D), }, /* Nokia 3250 */
1836 { NOKIA_PCSUITE_ACM_INFO(0x04D8), }, /* Nokia 5500 Sport */
1837 { NOKIA_PCSUITE_ACM_INFO(0x04C9), }, /* Nokia E50 */
1838 { NOKIA_PCSUITE_ACM_INFO(0x0419), }, /* Nokia E60 */
1839 { NOKIA_PCSUITE_ACM_INFO(0x044D), }, /* Nokia E61 */
1840 { NOKIA_PCSUITE_ACM_INFO(0x0001), }, /* Nokia E61i */
1841 { NOKIA_PCSUITE_ACM_INFO(0x0475), }, /* Nokia E62 */
1842 { NOKIA_PCSUITE_ACM_INFO(0x0508), }, /* Nokia E65 */
1843 { NOKIA_PCSUITE_ACM_INFO(0x0418), }, /* Nokia E70 */
1844 { NOKIA_PCSUITE_ACM_INFO(0x0425), }, /* Nokia N71 */
1845 { NOKIA_PCSUITE_ACM_INFO(0x0486), }, /* Nokia N73 */
1846 { NOKIA_PCSUITE_ACM_INFO(0x04DF), }, /* Nokia N75 */
1847 { NOKIA_PCSUITE_ACM_INFO(0x000e), }, /* Nokia N77 */
1848 { NOKIA_PCSUITE_ACM_INFO(0x0445), }, /* Nokia N80 */
1849 { NOKIA_PCSUITE_ACM_INFO(0x042F), }, /* Nokia N91 & N91 8GB */
1850 { NOKIA_PCSUITE_ACM_INFO(0x048E), }, /* Nokia N92 */
1851 { NOKIA_PCSUITE_ACM_INFO(0x0420), }, /* Nokia N93 */
1852 { NOKIA_PCSUITE_ACM_INFO(0x04E6), }, /* Nokia N93i */
1853 { NOKIA_PCSUITE_ACM_INFO(0x04B2), }, /* Nokia 5700 XpressMusic */
1854 { NOKIA_PCSUITE_ACM_INFO(0x0134), }, /* Nokia 6110 Navigator (China) */
1855 { NOKIA_PCSUITE_ACM_INFO(0x046E), }, /* Nokia 6110 Navigator */
1856 { NOKIA_PCSUITE_ACM_INFO(0x002f), }, /* Nokia 6120 classic & */
1857 { NOKIA_PCSUITE_ACM_INFO(0x0088), }, /* Nokia 6121 classic */
1858 { NOKIA_PCSUITE_ACM_INFO(0x00fc), }, /* Nokia 6124 classic */
1859 { NOKIA_PCSUITE_ACM_INFO(0x0042), }, /* Nokia E51 */
1860 { NOKIA_PCSUITE_ACM_INFO(0x00b0), }, /* Nokia E66 */
1861 { NOKIA_PCSUITE_ACM_INFO(0x00ab), }, /* Nokia E71 */
1862 { NOKIA_PCSUITE_ACM_INFO(0x0481), }, /* Nokia N76 */
1863 { NOKIA_PCSUITE_ACM_INFO(0x0007), }, /* Nokia N81 & N81 8GB */
1864 { NOKIA_PCSUITE_ACM_INFO(0x0071), }, /* Nokia N82 */
1865 { NOKIA_PCSUITE_ACM_INFO(0x04F0), }, /* Nokia N95 & N95-3 NAM */
1866 { NOKIA_PCSUITE_ACM_INFO(0x0070), }, /* Nokia N95 8GB */
1867 { NOKIA_PCSUITE_ACM_INFO(0x00e9), }, /* Nokia 5320 XpressMusic */
1868 { NOKIA_PCSUITE_ACM_INFO(0x0099), }, /* Nokia 6210 Navigator, RM-367 */
1869 { NOKIA_PCSUITE_ACM_INFO(0x0128), }, /* Nokia 6210 Navigator, RM-419 */
1870 { NOKIA_PCSUITE_ACM_INFO(0x008f), }, /* Nokia 6220 Classic */
1871 { NOKIA_PCSUITE_ACM_INFO(0x00a0), }, /* Nokia 6650 */
1872 { NOKIA_PCSUITE_ACM_INFO(0x007b), }, /* Nokia N78 */
1873 { NOKIA_PCSUITE_ACM_INFO(0x0094), }, /* Nokia N85 */
1874 { NOKIA_PCSUITE_ACM_INFO(0x003a), }, /* Nokia N96 & N96-3 */
1875 { NOKIA_PCSUITE_ACM_INFO(0x00e9), }, /* Nokia 5320 XpressMusic */
1876 { NOKIA_PCSUITE_ACM_INFO(0x0108), }, /* Nokia 5320 XpressMusic 2G */
1877 { NOKIA_PCSUITE_ACM_INFO(0x01f5), }, /* Nokia N97, RM-505 */
1878 { NOKIA_PCSUITE_ACM_INFO(0x02e3), }, /* Nokia 5230, RM-588 */
1879 { NOKIA_PCSUITE_ACM_INFO(0x0178), }, /* Nokia E63 */
1880 { NOKIA_PCSUITE_ACM_INFO(0x010e), }, /* Nokia E75 */
1881 { NOKIA_PCSUITE_ACM_INFO(0x02d9), }, /* Nokia 6760 Slide */
1882 { NOKIA_PCSUITE_ACM_INFO(0x01d0), }, /* Nokia E52 */
1883 { NOKIA_PCSUITE_ACM_INFO(0x0223), }, /* Nokia E72 */
1884 { NOKIA_PCSUITE_ACM_INFO(0x0275), }, /* Nokia X6 */
1885 { NOKIA_PCSUITE_ACM_INFO(0x026c), }, /* Nokia N97 Mini */
1886 { NOKIA_PCSUITE_ACM_INFO(0x0154), }, /* Nokia 5800 XpressMusic */
1887 { NOKIA_PCSUITE_ACM_INFO(0x04ce), }, /* Nokia E90 */
1888 { NOKIA_PCSUITE_ACM_INFO(0x01d4), }, /* Nokia E55 */
1889 { NOKIA_PCSUITE_ACM_INFO(0x0302), }, /* Nokia N8 */
1890 { NOKIA_PCSUITE_ACM_INFO(0x0335), }, /* Nokia E7 */
1891 { NOKIA_PCSUITE_ACM_INFO(0x03cd), }, /* Nokia C7 */
1892 { SAMSUNG_PCSUITE_ACM_INFO(0x6651), }, /* Samsung GTi8510 (INNOV8) */
1894 /* Support for Owen devices */
1895 { USB_DEVICE(0x03eb, 0x0030), }, /* Owen SI30 */
1897 /* NOTE: non-Nokia COMM/ACM/0xff is likely MSFT RNDIS... NOT a modem! */
1899 /* Support for Droids MuIn LCD */
1900 { USB_DEVICE(0x04d8, 0x000b),
1901 .driver_info = NO_DATA_INTERFACE,
1904 #if IS_ENABLED(CONFIG_INPUT_IMS_PCU)
1905 { USB_DEVICE(0x04d8, 0x0082), /* Application mode */
1906 .driver_info = IGNORE_DEVICE,
1908 { USB_DEVICE(0x04d8, 0x0083), /* Bootloader mode */
1909 .driver_info = IGNORE_DEVICE,
1912 { USB_DEVICE(0x04d8, 0xf58b),
1913 .driver_info = IGNORE_DEVICE,
1917 /*Samsung phone in firmware update mode */
1918 { USB_DEVICE(0x04e8, 0x685d),
1919 .driver_info = IGNORE_DEVICE,
1922 /* Exclude Infineon Flash Loader utility */
1923 { USB_DEVICE(0x058b, 0x0041),
1924 .driver_info = IGNORE_DEVICE,
1927 /* Exclude ETAS ES58x */
1928 { USB_DEVICE(0x108c, 0x0159), /* ES581.4 */
1929 .driver_info = IGNORE_DEVICE,
1931 { USB_DEVICE(0x108c, 0x0168), /* ES582.1 */
1932 .driver_info = IGNORE_DEVICE,
1934 { USB_DEVICE(0x108c, 0x0169), /* ES584.1 */
1935 .driver_info = IGNORE_DEVICE,
1938 { USB_DEVICE(0x1bc7, 0x0021), /* Telit 3G ACM only composition */
1939 .driver_info = SEND_ZERO_PACKET,
1941 { USB_DEVICE(0x1bc7, 0x0023), /* Telit 3G ACM + ECM composition */
1942 .driver_info = SEND_ZERO_PACKET,
1945 /* Exclude Goodix Fingerprint Reader */
1946 { USB_DEVICE(0x27c6, 0x5395),
1947 .driver_info = IGNORE_DEVICE,
1950 /* Exclude Heimann Sensor GmbH USB appset demo */
1951 { USB_DEVICE(0x32a7, 0x0000),
1952 .driver_info = IGNORE_DEVICE,
1955 /* control interfaces without any protocol set */
1956 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1957 USB_CDC_PROTO_NONE) },
1959 /* control interfaces with various AT-command sets */
1960 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1961 USB_CDC_ACM_PROTO_AT_V25TER) },
1962 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1963 USB_CDC_ACM_PROTO_AT_PCCA101) },
1964 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1965 USB_CDC_ACM_PROTO_AT_PCCA101_WAKE) },
1966 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1967 USB_CDC_ACM_PROTO_AT_GSM) },
1968 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1969 USB_CDC_ACM_PROTO_AT_3G) },
1970 { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1971 USB_CDC_ACM_PROTO_AT_CDMA) },
1973 { USB_DEVICE(0x1519, 0x0452), /* Intel 7260 modem */
1974 .driver_info = SEND_ZERO_PACKET,
1980 MODULE_DEVICE_TABLE(usb, acm_ids);
1982 static struct usb_driver acm_driver = {
1985 .disconnect = acm_disconnect,
1987 .suspend = acm_suspend,
1988 .resume = acm_resume,
1989 .reset_resume = acm_reset_resume,
1991 .id_table = acm_ids,
1993 .supports_autosuspend = 1,
1995 .disable_hub_initiated_lpm = 1,
1999 * TTY driver structures.
2002 static const struct tty_operations acm_ops = {
2003 .install = acm_tty_install,
2004 .open = acm_tty_open,
2005 .close = acm_tty_close,
2006 .cleanup = acm_tty_cleanup,
2007 .hangup = acm_tty_hangup,
2008 .write = acm_tty_write,
2009 .write_room = acm_tty_write_room,
2010 .ioctl = acm_tty_ioctl,
2011 .throttle = acm_tty_throttle,
2012 .unthrottle = acm_tty_unthrottle,
2013 .chars_in_buffer = acm_tty_chars_in_buffer,
2014 .break_ctl = acm_tty_break_ctl,
2015 .set_termios = acm_tty_set_termios,
2016 .tiocmget = acm_tty_tiocmget,
2017 .tiocmset = acm_tty_tiocmset,
2024 static int __init acm_init(void)
2027 acm_tty_driver = alloc_tty_driver(ACM_TTY_MINORS);
2028 if (!acm_tty_driver)
2030 acm_tty_driver->driver_name = "acm",
2031 acm_tty_driver->name = "ttyACM",
2032 acm_tty_driver->major = ACM_TTY_MAJOR,
2033 acm_tty_driver->minor_start = 0,
2034 acm_tty_driver->type = TTY_DRIVER_TYPE_SERIAL,
2035 acm_tty_driver->subtype = SERIAL_TYPE_NORMAL,
2036 acm_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_DYNAMIC_DEV;
2037 acm_tty_driver->init_termios = tty_std_termios;
2038 acm_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD |
2040 tty_set_operations(acm_tty_driver, &acm_ops);
2042 retval = tty_register_driver(acm_tty_driver);
2044 put_tty_driver(acm_tty_driver);
2048 retval = usb_register(&acm_driver);
2050 tty_unregister_driver(acm_tty_driver);
2051 put_tty_driver(acm_tty_driver);
2055 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_DESC "\n");
2060 static void __exit acm_exit(void)
2062 usb_deregister(&acm_driver);
2063 tty_unregister_driver(acm_tty_driver);
2064 put_tty_driver(acm_tty_driver);
2065 idr_destroy(&acm_minors);
2068 module_init(acm_init);
2069 module_exit(acm_exit);
2071 MODULE_AUTHOR(DRIVER_AUTHOR);
2072 MODULE_DESCRIPTION(DRIVER_DESC);
2073 MODULE_LICENSE("GPL");
2074 MODULE_ALIAS_CHARDEV_MAJOR(ACM_TTY_MAJOR);