Back to home page

OSCL-LXR

 
 

    


0001 // SPDX-License-Identifier: GPL-2.0+
0002 /*
0003  * cdc-acm.c
0004  *
0005  * Copyright (c) 1999 Armin Fuerst  <fuerst@in.tum.de>
0006  * Copyright (c) 1999 Pavel Machek  <pavel@ucw.cz>
0007  * Copyright (c) 1999 Johannes Erdfelt  <johannes@erdfelt.com>
0008  * Copyright (c) 2000 Vojtech Pavlik    <vojtech@suse.cz>
0009  * Copyright (c) 2004 Oliver Neukum <oliver@neukum.name>
0010  * Copyright (c) 2005 David Kubicek <dave@awk.cz>
0011  * Copyright (c) 2011 Johan Hovold  <jhovold@gmail.com>
0012  *
0013  * USB Abstract Control Model driver for USB modems and ISDN adapters
0014  *
0015  * Sponsored by SuSE
0016  */
0017 
0018 #undef DEBUG
0019 #undef VERBOSE_DEBUG
0020 
0021 #include <linux/kernel.h>
0022 #include <linux/sched/signal.h>
0023 #include <linux/errno.h>
0024 #include <linux/init.h>
0025 #include <linux/slab.h>
0026 #include <linux/log2.h>
0027 #include <linux/tty.h>
0028 #include <linux/serial.h>
0029 #include <linux/tty_driver.h>
0030 #include <linux/tty_flip.h>
0031 #include <linux/module.h>
0032 #include <linux/mutex.h>
0033 #include <linux/uaccess.h>
0034 #include <linux/usb.h>
0035 #include <linux/usb/cdc.h>
0036 #include <asm/byteorder.h>
0037 #include <asm/unaligned.h>
0038 #include <linux/idr.h>
0039 #include <linux/list.h>
0040 
0041 #include "cdc-acm.h"
0042 
0043 
0044 #define DRIVER_AUTHOR "Armin Fuerst, Pavel Machek, Johannes Erdfelt, Vojtech Pavlik, David Kubicek, Johan Hovold"
0045 #define DRIVER_DESC "USB Abstract Control Model driver for USB modems and ISDN adapters"
0046 
0047 static struct usb_driver acm_driver;
0048 static struct tty_driver *acm_tty_driver;
0049 
0050 static DEFINE_IDR(acm_minors);
0051 static DEFINE_MUTEX(acm_minors_lock);
0052 
0053 static void acm_tty_set_termios(struct tty_struct *tty,
0054                 struct ktermios *termios_old);
0055 
0056 /*
0057  * acm_minors accessors
0058  */
0059 
0060 /*
0061  * Look up an ACM structure by minor. If found and not disconnected, increment
0062  * its refcount and return it with its mutex held.
0063  */
0064 static struct acm *acm_get_by_minor(unsigned int minor)
0065 {
0066     struct acm *acm;
0067 
0068     mutex_lock(&acm_minors_lock);
0069     acm = idr_find(&acm_minors, minor);
0070     if (acm) {
0071         mutex_lock(&acm->mutex);
0072         if (acm->disconnected) {
0073             mutex_unlock(&acm->mutex);
0074             acm = NULL;
0075         } else {
0076             tty_port_get(&acm->port);
0077             mutex_unlock(&acm->mutex);
0078         }
0079     }
0080     mutex_unlock(&acm_minors_lock);
0081     return acm;
0082 }
0083 
0084 /*
0085  * Try to find an available minor number and if found, associate it with 'acm'.
0086  */
0087 static int acm_alloc_minor(struct acm *acm)
0088 {
0089     int minor;
0090 
0091     mutex_lock(&acm_minors_lock);
0092     minor = idr_alloc(&acm_minors, acm, 0, ACM_TTY_MINORS, GFP_KERNEL);
0093     mutex_unlock(&acm_minors_lock);
0094 
0095     return minor;
0096 }
0097 
0098 /* Release the minor number associated with 'acm'.  */
0099 static void acm_release_minor(struct acm *acm)
0100 {
0101     mutex_lock(&acm_minors_lock);
0102     idr_remove(&acm_minors, acm->minor);
0103     mutex_unlock(&acm_minors_lock);
0104 }
0105 
0106 /*
0107  * Functions for ACM control messages.
0108  */
0109 
0110 static int acm_ctrl_msg(struct acm *acm, int request, int value,
0111                             void *buf, int len)
0112 {
0113     int retval;
0114 
0115     retval = usb_autopm_get_interface(acm->control);
0116     if (retval)
0117         return retval;
0118 
0119     retval = usb_control_msg(acm->dev, usb_sndctrlpipe(acm->dev, 0),
0120         request, USB_RT_ACM, value,
0121         acm->control->altsetting[0].desc.bInterfaceNumber,
0122         buf, len, USB_CTRL_SET_TIMEOUT);
0123 
0124     dev_dbg(&acm->control->dev,
0125         "%s - rq 0x%02x, val %#x, len %#x, result %d\n",
0126         __func__, request, value, len, retval);
0127 
0128     usb_autopm_put_interface(acm->control);
0129 
0130     return retval < 0 ? retval : 0;
0131 }
0132 
0133 /* devices aren't required to support these requests.
0134  * the cdc acm descriptor tells whether they do...
0135  */
0136 static inline int acm_set_control(struct acm *acm, int control)
0137 {
0138     if (acm->quirks & QUIRK_CONTROL_LINE_STATE)
0139         return -EOPNOTSUPP;
0140 
0141     return acm_ctrl_msg(acm, USB_CDC_REQ_SET_CONTROL_LINE_STATE,
0142             control, NULL, 0);
0143 }
0144 
0145 #define acm_set_line(acm, line) \
0146     acm_ctrl_msg(acm, USB_CDC_REQ_SET_LINE_CODING, 0, line, sizeof *(line))
0147 #define acm_send_break(acm, ms) \
0148     acm_ctrl_msg(acm, USB_CDC_REQ_SEND_BREAK, ms, NULL, 0)
0149 
0150 static void acm_poison_urbs(struct acm *acm)
0151 {
0152     int i;
0153 
0154     usb_poison_urb(acm->ctrlurb);
0155     for (i = 0; i < ACM_NW; i++)
0156         usb_poison_urb(acm->wb[i].urb);
0157     for (i = 0; i < acm->rx_buflimit; i++)
0158         usb_poison_urb(acm->read_urbs[i]);
0159 }
0160 
0161 static void acm_unpoison_urbs(struct acm *acm)
0162 {
0163     int i;
0164 
0165     for (i = 0; i < acm->rx_buflimit; i++)
0166         usb_unpoison_urb(acm->read_urbs[i]);
0167     for (i = 0; i < ACM_NW; i++)
0168         usb_unpoison_urb(acm->wb[i].urb);
0169     usb_unpoison_urb(acm->ctrlurb);
0170 }
0171 
0172 
0173 /*
0174  * Write buffer management.
0175  * All of these assume proper locks taken by the caller.
0176  */
0177 
0178 static int acm_wb_alloc(struct acm *acm)
0179 {
0180     int i, wbn;
0181     struct acm_wb *wb;
0182 
0183     wbn = 0;
0184     i = 0;
0185     for (;;) {
0186         wb = &acm->wb[wbn];
0187         if (!wb->use) {
0188             wb->use = true;
0189             wb->len = 0;
0190             return wbn;
0191         }
0192         wbn = (wbn + 1) % ACM_NW;
0193         if (++i >= ACM_NW)
0194             return -1;
0195     }
0196 }
0197 
0198 static int acm_wb_is_avail(struct acm *acm)
0199 {
0200     int i, n;
0201     unsigned long flags;
0202 
0203     n = ACM_NW;
0204     spin_lock_irqsave(&acm->write_lock, flags);
0205     for (i = 0; i < ACM_NW; i++)
0206         if(acm->wb[i].use)
0207             n--;
0208     spin_unlock_irqrestore(&acm->write_lock, flags);
0209     return n;
0210 }
0211 
0212 /*
0213  * Finish write. Caller must hold acm->write_lock
0214  */
0215 static void acm_write_done(struct acm *acm, struct acm_wb *wb)
0216 {
0217     wb->use = false;
0218     acm->transmitting--;
0219     usb_autopm_put_interface_async(acm->control);
0220 }
0221 
0222 /*
0223  * Poke write.
0224  *
0225  * the caller is responsible for locking
0226  */
0227 
0228 static int acm_start_wb(struct acm *acm, struct acm_wb *wb)
0229 {
0230     int rc;
0231 
0232     acm->transmitting++;
0233 
0234     wb->urb->transfer_buffer = wb->buf;
0235     wb->urb->transfer_dma = wb->dmah;
0236     wb->urb->transfer_buffer_length = wb->len;
0237     wb->urb->dev = acm->dev;
0238 
0239     rc = usb_submit_urb(wb->urb, GFP_ATOMIC);
0240     if (rc < 0) {
0241         if (rc != -EPERM)
0242             dev_err(&acm->data->dev,
0243                 "%s - usb_submit_urb(write bulk) failed: %d\n",
0244                 __func__, rc);
0245         acm_write_done(acm, wb);
0246     }
0247     return rc;
0248 }
0249 
0250 /*
0251  * attributes exported through sysfs
0252  */
0253 static ssize_t bmCapabilities_show
0254 (struct device *dev, struct device_attribute *attr, char *buf)
0255 {
0256     struct usb_interface *intf = to_usb_interface(dev);
0257     struct acm *acm = usb_get_intfdata(intf);
0258 
0259     return sprintf(buf, "%d", acm->ctrl_caps);
0260 }
0261 static DEVICE_ATTR_RO(bmCapabilities);
0262 
0263 static ssize_t wCountryCodes_show
0264 (struct device *dev, struct device_attribute *attr, char *buf)
0265 {
0266     struct usb_interface *intf = to_usb_interface(dev);
0267     struct acm *acm = usb_get_intfdata(intf);
0268 
0269     memcpy(buf, acm->country_codes, acm->country_code_size);
0270     return acm->country_code_size;
0271 }
0272 
0273 static DEVICE_ATTR_RO(wCountryCodes);
0274 
0275 static ssize_t iCountryCodeRelDate_show
0276 (struct device *dev, struct device_attribute *attr, char *buf)
0277 {
0278     struct usb_interface *intf = to_usb_interface(dev);
0279     struct acm *acm = usb_get_intfdata(intf);
0280 
0281     return sprintf(buf, "%d", acm->country_rel_date);
0282 }
0283 
0284 static DEVICE_ATTR_RO(iCountryCodeRelDate);
0285 /*
0286  * Interrupt handlers for various ACM device responses
0287  */
0288 
0289 static void acm_process_notification(struct acm *acm, unsigned char *buf)
0290 {
0291     int newctrl;
0292     int difference;
0293     unsigned long flags;
0294     struct usb_cdc_notification *dr = (struct usb_cdc_notification *)buf;
0295     unsigned char *data = buf + sizeof(struct usb_cdc_notification);
0296 
0297     switch (dr->bNotificationType) {
0298     case USB_CDC_NOTIFY_NETWORK_CONNECTION:
0299         dev_dbg(&acm->control->dev,
0300             "%s - network connection: %d\n", __func__, dr->wValue);
0301         break;
0302 
0303     case USB_CDC_NOTIFY_SERIAL_STATE:
0304         if (le16_to_cpu(dr->wLength) != 2) {
0305             dev_dbg(&acm->control->dev,
0306                 "%s - malformed serial state\n", __func__);
0307             break;
0308         }
0309 
0310         newctrl = get_unaligned_le16(data);
0311         dev_dbg(&acm->control->dev,
0312             "%s - serial state: 0x%x\n", __func__, newctrl);
0313 
0314         if (!acm->clocal && (acm->ctrlin & ~newctrl & USB_CDC_SERIAL_STATE_DCD)) {
0315             dev_dbg(&acm->control->dev,
0316                 "%s - calling hangup\n", __func__);
0317             tty_port_tty_hangup(&acm->port, false);
0318         }
0319 
0320         difference = acm->ctrlin ^ newctrl;
0321         spin_lock_irqsave(&acm->read_lock, flags);
0322         acm->ctrlin = newctrl;
0323         acm->oldcount = acm->iocount;
0324 
0325         if (difference & USB_CDC_SERIAL_STATE_DSR)
0326             acm->iocount.dsr++;
0327         if (difference & USB_CDC_SERIAL_STATE_DCD)
0328             acm->iocount.dcd++;
0329         if (newctrl & USB_CDC_SERIAL_STATE_BREAK) {
0330             acm->iocount.brk++;
0331             tty_insert_flip_char(&acm->port, 0, TTY_BREAK);
0332         }
0333         if (newctrl & USB_CDC_SERIAL_STATE_RING_SIGNAL)
0334             acm->iocount.rng++;
0335         if (newctrl & USB_CDC_SERIAL_STATE_FRAMING)
0336             acm->iocount.frame++;
0337         if (newctrl & USB_CDC_SERIAL_STATE_PARITY)
0338             acm->iocount.parity++;
0339         if (newctrl & USB_CDC_SERIAL_STATE_OVERRUN)
0340             acm->iocount.overrun++;
0341         spin_unlock_irqrestore(&acm->read_lock, flags);
0342 
0343         if (newctrl & USB_CDC_SERIAL_STATE_BREAK)
0344             tty_flip_buffer_push(&acm->port);
0345 
0346         if (difference)
0347             wake_up_all(&acm->wioctl);
0348 
0349         break;
0350 
0351     default:
0352         dev_dbg(&acm->control->dev,
0353             "%s - unknown notification %d received: index %d len %d\n",
0354             __func__,
0355             dr->bNotificationType, dr->wIndex, dr->wLength);
0356     }
0357 }
0358 
0359 /* control interface reports status changes with "interrupt" transfers */
0360 static void acm_ctrl_irq(struct urb *urb)
0361 {
0362     struct acm *acm = urb->context;
0363     struct usb_cdc_notification *dr = urb->transfer_buffer;
0364     unsigned int current_size = urb->actual_length;
0365     unsigned int expected_size, copy_size, alloc_size;
0366     int retval;
0367     int status = urb->status;
0368 
0369     switch (status) {
0370     case 0:
0371         /* success */
0372         break;
0373     case -ECONNRESET:
0374     case -ENOENT:
0375     case -ESHUTDOWN:
0376         /* this urb is terminated, clean up */
0377         dev_dbg(&acm->control->dev,
0378             "%s - urb shutting down with status: %d\n",
0379             __func__, status);
0380         return;
0381     default:
0382         dev_dbg(&acm->control->dev,
0383             "%s - nonzero urb status received: %d\n",
0384             __func__, status);
0385         goto exit;
0386     }
0387 
0388     usb_mark_last_busy(acm->dev);
0389 
0390     if (acm->nb_index)
0391         dr = (struct usb_cdc_notification *)acm->notification_buffer;
0392 
0393     /* size = notification-header + (optional) data */
0394     expected_size = sizeof(struct usb_cdc_notification) +
0395                     le16_to_cpu(dr->wLength);
0396 
0397     if (current_size < expected_size) {
0398         /* notification is transmitted fragmented, reassemble */
0399         if (acm->nb_size < expected_size) {
0400             u8 *new_buffer;
0401             alloc_size = roundup_pow_of_two(expected_size);
0402             /* Final freeing is done on disconnect. */
0403             new_buffer = krealloc(acm->notification_buffer,
0404                           alloc_size, GFP_ATOMIC);
0405             if (!new_buffer) {
0406                 acm->nb_index = 0;
0407                 goto exit;
0408             }
0409 
0410             acm->notification_buffer = new_buffer;
0411             acm->nb_size = alloc_size;
0412             dr = (struct usb_cdc_notification *)acm->notification_buffer;
0413         }
0414 
0415         copy_size = min(current_size,
0416                 expected_size - acm->nb_index);
0417 
0418         memcpy(&acm->notification_buffer[acm->nb_index],
0419                urb->transfer_buffer, copy_size);
0420         acm->nb_index += copy_size;
0421         current_size = acm->nb_index;
0422     }
0423 
0424     if (current_size >= expected_size) {
0425         /* notification complete */
0426         acm_process_notification(acm, (unsigned char *)dr);
0427         acm->nb_index = 0;
0428     }
0429 
0430 exit:
0431     retval = usb_submit_urb(urb, GFP_ATOMIC);
0432     if (retval && retval != -EPERM && retval != -ENODEV)
0433         dev_err(&acm->control->dev,
0434             "%s - usb_submit_urb failed: %d\n", __func__, retval);
0435     else
0436         dev_vdbg(&acm->control->dev,
0437             "control resubmission terminated %d\n", retval);
0438 }
0439 
0440 static int acm_submit_read_urb(struct acm *acm, int index, gfp_t mem_flags)
0441 {
0442     int res;
0443 
0444     if (!test_and_clear_bit(index, &acm->read_urbs_free))
0445         return 0;
0446 
0447     res = usb_submit_urb(acm->read_urbs[index], mem_flags);
0448     if (res) {
0449         if (res != -EPERM && res != -ENODEV) {
0450             dev_err(&acm->data->dev,
0451                 "urb %d failed submission with %d\n",
0452                 index, res);
0453         } else {
0454             dev_vdbg(&acm->data->dev, "intended failure %d\n", res);
0455         }
0456         set_bit(index, &acm->read_urbs_free);
0457         return res;
0458     } else {
0459         dev_vdbg(&acm->data->dev, "submitted urb %d\n", index);
0460     }
0461 
0462     return 0;
0463 }
0464 
0465 static int acm_submit_read_urbs(struct acm *acm, gfp_t mem_flags)
0466 {
0467     int res;
0468     int i;
0469 
0470     for (i = 0; i < acm->rx_buflimit; ++i) {
0471         res = acm_submit_read_urb(acm, i, mem_flags);
0472         if (res)
0473             return res;
0474     }
0475 
0476     return 0;
0477 }
0478 
0479 static void acm_process_read_urb(struct acm *acm, struct urb *urb)
0480 {
0481     unsigned long flags;
0482 
0483     if (!urb->actual_length)
0484         return;
0485 
0486     spin_lock_irqsave(&acm->read_lock, flags);
0487     tty_insert_flip_string(&acm->port, urb->transfer_buffer,
0488             urb->actual_length);
0489     spin_unlock_irqrestore(&acm->read_lock, flags);
0490 
0491     tty_flip_buffer_push(&acm->port);
0492 }
0493 
0494 static void acm_read_bulk_callback(struct urb *urb)
0495 {
0496     struct acm_rb *rb = urb->context;
0497     struct acm *acm = rb->instance;
0498     int status = urb->status;
0499     bool stopped = false;
0500     bool stalled = false;
0501     bool cooldown = false;
0502 
0503     dev_vdbg(&acm->data->dev, "got urb %d, len %d, status %d\n",
0504         rb->index, urb->actual_length, status);
0505 
0506     switch (status) {
0507     case 0:
0508         usb_mark_last_busy(acm->dev);
0509         acm_process_read_urb(acm, urb);
0510         break;
0511     case -EPIPE:
0512         set_bit(EVENT_RX_STALL, &acm->flags);
0513         stalled = true;
0514         break;
0515     case -ENOENT:
0516     case -ECONNRESET:
0517     case -ESHUTDOWN:
0518         dev_dbg(&acm->data->dev,
0519             "%s - urb shutting down with status: %d\n",
0520             __func__, status);
0521         stopped = true;
0522         break;
0523     case -EOVERFLOW:
0524     case -EPROTO:
0525         dev_dbg(&acm->data->dev,
0526             "%s - cooling babbling device\n", __func__);
0527         usb_mark_last_busy(acm->dev);
0528         set_bit(rb->index, &acm->urbs_in_error_delay);
0529         set_bit(ACM_ERROR_DELAY, &acm->flags);
0530         cooldown = true;
0531         break;
0532     default:
0533         dev_dbg(&acm->data->dev,
0534             "%s - nonzero urb status received: %d\n",
0535             __func__, status);
0536         break;
0537     }
0538 
0539     /*
0540      * Make sure URB processing is done before marking as free to avoid
0541      * racing with unthrottle() on another CPU. Matches the barriers
0542      * implied by the test_and_clear_bit() in acm_submit_read_urb().
0543      */
0544     smp_mb__before_atomic();
0545     set_bit(rb->index, &acm->read_urbs_free);
0546     /*
0547      * Make sure URB is marked as free before checking the throttled flag
0548      * to avoid racing with unthrottle() on another CPU. Matches the
0549      * smp_mb() in unthrottle().
0550      */
0551     smp_mb__after_atomic();
0552 
0553     if (stopped || stalled || cooldown) {
0554         if (stalled)
0555             schedule_delayed_work(&acm->dwork, 0);
0556         else if (cooldown)
0557             schedule_delayed_work(&acm->dwork, HZ / 2);
0558         return;
0559     }
0560 
0561     if (test_bit(ACM_THROTTLED, &acm->flags))
0562         return;
0563 
0564     acm_submit_read_urb(acm, rb->index, GFP_ATOMIC);
0565 }
0566 
0567 /* data interface wrote those outgoing bytes */
0568 static void acm_write_bulk(struct urb *urb)
0569 {
0570     struct acm_wb *wb = urb->context;
0571     struct acm *acm = wb->instance;
0572     unsigned long flags;
0573     int status = urb->status;
0574 
0575     if (status || (urb->actual_length != urb->transfer_buffer_length))
0576         dev_vdbg(&acm->data->dev, "wrote len %d/%d, status %d\n",
0577             urb->actual_length,
0578             urb->transfer_buffer_length,
0579             status);
0580 
0581     spin_lock_irqsave(&acm->write_lock, flags);
0582     acm_write_done(acm, wb);
0583     spin_unlock_irqrestore(&acm->write_lock, flags);
0584     set_bit(EVENT_TTY_WAKEUP, &acm->flags);
0585     schedule_delayed_work(&acm->dwork, 0);
0586 }
0587 
0588 static void acm_softint(struct work_struct *work)
0589 {
0590     int i;
0591     struct acm *acm = container_of(work, struct acm, dwork.work);
0592 
0593     if (test_bit(EVENT_RX_STALL, &acm->flags)) {
0594         smp_mb(); /* against acm_suspend() */
0595         if (!acm->susp_count) {
0596             for (i = 0; i < acm->rx_buflimit; i++)
0597                 usb_kill_urb(acm->read_urbs[i]);
0598             usb_clear_halt(acm->dev, acm->in);
0599             acm_submit_read_urbs(acm, GFP_KERNEL);
0600             clear_bit(EVENT_RX_STALL, &acm->flags);
0601         }
0602     }
0603 
0604     if (test_and_clear_bit(ACM_ERROR_DELAY, &acm->flags)) {
0605         for (i = 0; i < acm->rx_buflimit; i++)
0606             if (test_and_clear_bit(i, &acm->urbs_in_error_delay))
0607                 acm_submit_read_urb(acm, i, GFP_KERNEL);
0608     }
0609 
0610     if (test_and_clear_bit(EVENT_TTY_WAKEUP, &acm->flags))
0611         tty_port_tty_wakeup(&acm->port);
0612 }
0613 
0614 /*
0615  * TTY handlers
0616  */
0617 
0618 static int acm_tty_install(struct tty_driver *driver, struct tty_struct *tty)
0619 {
0620     struct acm *acm;
0621     int retval;
0622 
0623     acm = acm_get_by_minor(tty->index);
0624     if (!acm)
0625         return -ENODEV;
0626 
0627     retval = tty_standard_install(driver, tty);
0628     if (retval)
0629         goto error_init_termios;
0630 
0631     /*
0632      * Suppress initial echoing for some devices which might send data
0633      * immediately after acm driver has been installed.
0634      */
0635     if (acm->quirks & DISABLE_ECHO)
0636         tty->termios.c_lflag &= ~ECHO;
0637 
0638     tty->driver_data = acm;
0639 
0640     return 0;
0641 
0642 error_init_termios:
0643     tty_port_put(&acm->port);
0644     return retval;
0645 }
0646 
0647 static int acm_tty_open(struct tty_struct *tty, struct file *filp)
0648 {
0649     struct acm *acm = tty->driver_data;
0650 
0651     return tty_port_open(&acm->port, tty, filp);
0652 }
0653 
0654 static void acm_port_dtr_rts(struct tty_port *port, int raise)
0655 {
0656     struct acm *acm = container_of(port, struct acm, port);
0657     int val;
0658     int res;
0659 
0660     if (raise)
0661         val = USB_CDC_CTRL_DTR | USB_CDC_CTRL_RTS;
0662     else
0663         val = 0;
0664 
0665     /* FIXME: add missing ctrlout locking throughout driver */
0666     acm->ctrlout = val;
0667 
0668     res = acm_set_control(acm, val);
0669     if (res && (acm->ctrl_caps & USB_CDC_CAP_LINE))
0670         /* This is broken in too many devices to spam the logs */
0671         dev_dbg(&acm->control->dev, "failed to set dtr/rts\n");
0672 }
0673 
0674 static int acm_port_activate(struct tty_port *port, struct tty_struct *tty)
0675 {
0676     struct acm *acm = container_of(port, struct acm, port);
0677     int retval = -ENODEV;
0678     int i;
0679 
0680     mutex_lock(&acm->mutex);
0681     if (acm->disconnected)
0682         goto disconnected;
0683 
0684     retval = usb_autopm_get_interface(acm->control);
0685     if (retval)
0686         goto error_get_interface;
0687 
0688     set_bit(TTY_NO_WRITE_SPLIT, &tty->flags);
0689     acm->control->needs_remote_wakeup = 1;
0690 
0691     acm->ctrlurb->dev = acm->dev;
0692     retval = usb_submit_urb(acm->ctrlurb, GFP_KERNEL);
0693     if (retval) {
0694         dev_err(&acm->control->dev,
0695             "%s - usb_submit_urb(ctrl irq) failed\n", __func__);
0696         goto error_submit_urb;
0697     }
0698 
0699     acm_tty_set_termios(tty, NULL);
0700 
0701     /*
0702      * Unthrottle device in case the TTY was closed while throttled.
0703      */
0704     clear_bit(ACM_THROTTLED, &acm->flags);
0705 
0706     retval = acm_submit_read_urbs(acm, GFP_KERNEL);
0707     if (retval)
0708         goto error_submit_read_urbs;
0709 
0710     usb_autopm_put_interface(acm->control);
0711 
0712     mutex_unlock(&acm->mutex);
0713 
0714     return 0;
0715 
0716 error_submit_read_urbs:
0717     for (i = 0; i < acm->rx_buflimit; i++)
0718         usb_kill_urb(acm->read_urbs[i]);
0719     usb_kill_urb(acm->ctrlurb);
0720 error_submit_urb:
0721     usb_autopm_put_interface(acm->control);
0722 error_get_interface:
0723 disconnected:
0724     mutex_unlock(&acm->mutex);
0725 
0726     return usb_translate_errors(retval);
0727 }
0728 
0729 static void acm_port_destruct(struct tty_port *port)
0730 {
0731     struct acm *acm = container_of(port, struct acm, port);
0732 
0733     if (acm->minor != ACM_MINOR_INVALID)
0734         acm_release_minor(acm);
0735     usb_put_intf(acm->control);
0736     kfree(acm->country_codes);
0737     kfree(acm);
0738 }
0739 
0740 static void acm_port_shutdown(struct tty_port *port)
0741 {
0742     struct acm *acm = container_of(port, struct acm, port);
0743     struct urb *urb;
0744     struct acm_wb *wb;
0745 
0746     /*
0747      * Need to grab write_lock to prevent race with resume, but no need to
0748      * hold it due to the tty-port initialised flag.
0749      */
0750     acm_poison_urbs(acm);
0751     spin_lock_irq(&acm->write_lock);
0752     spin_unlock_irq(&acm->write_lock);
0753 
0754     usb_autopm_get_interface_no_resume(acm->control);
0755     acm->control->needs_remote_wakeup = 0;
0756     usb_autopm_put_interface(acm->control);
0757 
0758     for (;;) {
0759         urb = usb_get_from_anchor(&acm->delayed);
0760         if (!urb)
0761             break;
0762         wb = urb->context;
0763         wb->use = false;
0764         usb_autopm_put_interface_async(acm->control);
0765     }
0766 
0767     acm_unpoison_urbs(acm);
0768 
0769 }
0770 
0771 static void acm_tty_cleanup(struct tty_struct *tty)
0772 {
0773     struct acm *acm = tty->driver_data;
0774 
0775     tty_port_put(&acm->port);
0776 }
0777 
0778 static void acm_tty_hangup(struct tty_struct *tty)
0779 {
0780     struct acm *acm = tty->driver_data;
0781 
0782     tty_port_hangup(&acm->port);
0783 }
0784 
0785 static void acm_tty_close(struct tty_struct *tty, struct file *filp)
0786 {
0787     struct acm *acm = tty->driver_data;
0788 
0789     tty_port_close(&acm->port, tty, filp);
0790 }
0791 
0792 static int acm_tty_write(struct tty_struct *tty,
0793                     const unsigned char *buf, int count)
0794 {
0795     struct acm *acm = tty->driver_data;
0796     int stat;
0797     unsigned long flags;
0798     int wbn;
0799     struct acm_wb *wb;
0800 
0801     if (!count)
0802         return 0;
0803 
0804     dev_vdbg(&acm->data->dev, "%d bytes from tty layer\n", count);
0805 
0806     spin_lock_irqsave(&acm->write_lock, flags);
0807     wbn = acm_wb_alloc(acm);
0808     if (wbn < 0) {
0809         spin_unlock_irqrestore(&acm->write_lock, flags);
0810         return 0;
0811     }
0812     wb = &acm->wb[wbn];
0813 
0814     if (!acm->dev) {
0815         wb->use = false;
0816         spin_unlock_irqrestore(&acm->write_lock, flags);
0817         return -ENODEV;
0818     }
0819 
0820     count = (count > acm->writesize) ? acm->writesize : count;
0821     dev_vdbg(&acm->data->dev, "writing %d bytes\n", count);
0822     memcpy(wb->buf, buf, count);
0823     wb->len = count;
0824 
0825     stat = usb_autopm_get_interface_async(acm->control);
0826     if (stat) {
0827         wb->use = false;
0828         spin_unlock_irqrestore(&acm->write_lock, flags);
0829         return stat;
0830     }
0831 
0832     if (acm->susp_count) {
0833         usb_anchor_urb(wb->urb, &acm->delayed);
0834         spin_unlock_irqrestore(&acm->write_lock, flags);
0835         return count;
0836     }
0837 
0838     stat = acm_start_wb(acm, wb);
0839     spin_unlock_irqrestore(&acm->write_lock, flags);
0840 
0841     if (stat < 0)
0842         return stat;
0843     return count;
0844 }
0845 
0846 static unsigned int acm_tty_write_room(struct tty_struct *tty)
0847 {
0848     struct acm *acm = tty->driver_data;
0849     /*
0850      * Do not let the line discipline to know that we have a reserve,
0851      * or it might get too enthusiastic.
0852      */
0853     return acm_wb_is_avail(acm) ? acm->writesize : 0;
0854 }
0855 
0856 static unsigned int acm_tty_chars_in_buffer(struct tty_struct *tty)
0857 {
0858     struct acm *acm = tty->driver_data;
0859     /*
0860      * if the device was unplugged then any remaining characters fell out
0861      * of the connector ;)
0862      */
0863     if (acm->disconnected)
0864         return 0;
0865     /*
0866      * This is inaccurate (overcounts), but it works.
0867      */
0868     return (ACM_NW - acm_wb_is_avail(acm)) * acm->writesize;
0869 }
0870 
0871 static void acm_tty_throttle(struct tty_struct *tty)
0872 {
0873     struct acm *acm = tty->driver_data;
0874 
0875     set_bit(ACM_THROTTLED, &acm->flags);
0876 }
0877 
0878 static void acm_tty_unthrottle(struct tty_struct *tty)
0879 {
0880     struct acm *acm = tty->driver_data;
0881 
0882     clear_bit(ACM_THROTTLED, &acm->flags);
0883 
0884     /* Matches the smp_mb__after_atomic() in acm_read_bulk_callback(). */
0885     smp_mb();
0886 
0887     acm_submit_read_urbs(acm, GFP_KERNEL);
0888 }
0889 
0890 static int acm_tty_break_ctl(struct tty_struct *tty, int state)
0891 {
0892     struct acm *acm = tty->driver_data;
0893     int retval;
0894 
0895     retval = acm_send_break(acm, state ? 0xffff : 0);
0896     if (retval < 0)
0897         dev_dbg(&acm->control->dev,
0898             "%s - send break failed\n", __func__);
0899     return retval;
0900 }
0901 
0902 static int acm_tty_tiocmget(struct tty_struct *tty)
0903 {
0904     struct acm *acm = tty->driver_data;
0905 
0906     return (acm->ctrlout & USB_CDC_CTRL_DTR ? TIOCM_DTR : 0) |
0907            (acm->ctrlout & USB_CDC_CTRL_RTS ? TIOCM_RTS : 0) |
0908            (acm->ctrlin  & USB_CDC_SERIAL_STATE_DSR ? TIOCM_DSR : 0) |
0909            (acm->ctrlin  & USB_CDC_SERIAL_STATE_RING_SIGNAL ? TIOCM_RI : 0) |
0910            (acm->ctrlin  & USB_CDC_SERIAL_STATE_DCD ? TIOCM_CD : 0) |
0911            TIOCM_CTS;
0912 }
0913 
0914 static int acm_tty_tiocmset(struct tty_struct *tty,
0915                 unsigned int set, unsigned int clear)
0916 {
0917     struct acm *acm = tty->driver_data;
0918     unsigned int newctrl;
0919 
0920     newctrl = acm->ctrlout;
0921     set = (set & TIOCM_DTR ? USB_CDC_CTRL_DTR : 0) |
0922           (set & TIOCM_RTS ? USB_CDC_CTRL_RTS : 0);
0923     clear = (clear & TIOCM_DTR ? USB_CDC_CTRL_DTR : 0) |
0924         (clear & TIOCM_RTS ? USB_CDC_CTRL_RTS : 0);
0925 
0926     newctrl = (newctrl & ~clear) | set;
0927 
0928     if (acm->ctrlout == newctrl)
0929         return 0;
0930     return acm_set_control(acm, acm->ctrlout = newctrl);
0931 }
0932 
0933 static int get_serial_info(struct tty_struct *tty, struct serial_struct *ss)
0934 {
0935     struct acm *acm = tty->driver_data;
0936 
0937     ss->line = acm->minor;
0938     ss->close_delay = jiffies_to_msecs(acm->port.close_delay) / 10;
0939     ss->closing_wait = acm->port.closing_wait == ASYNC_CLOSING_WAIT_NONE ?
0940                 ASYNC_CLOSING_WAIT_NONE :
0941                 jiffies_to_msecs(acm->port.closing_wait) / 10;
0942     return 0;
0943 }
0944 
0945 static int set_serial_info(struct tty_struct *tty, struct serial_struct *ss)
0946 {
0947     struct acm *acm = tty->driver_data;
0948     unsigned int closing_wait, close_delay;
0949     int retval = 0;
0950 
0951     close_delay = msecs_to_jiffies(ss->close_delay * 10);
0952     closing_wait = ss->closing_wait == ASYNC_CLOSING_WAIT_NONE ?
0953             ASYNC_CLOSING_WAIT_NONE :
0954             msecs_to_jiffies(ss->closing_wait * 10);
0955 
0956     mutex_lock(&acm->port.mutex);
0957 
0958     if (!capable(CAP_SYS_ADMIN)) {
0959         if ((close_delay != acm->port.close_delay) ||
0960             (closing_wait != acm->port.closing_wait))
0961             retval = -EPERM;
0962     } else {
0963         acm->port.close_delay  = close_delay;
0964         acm->port.closing_wait = closing_wait;
0965     }
0966 
0967     mutex_unlock(&acm->port.mutex);
0968     return retval;
0969 }
0970 
0971 static int wait_serial_change(struct acm *acm, unsigned long arg)
0972 {
0973     int rv = 0;
0974     DECLARE_WAITQUEUE(wait, current);
0975     struct async_icount old, new;
0976 
0977     do {
0978         spin_lock_irq(&acm->read_lock);
0979         old = acm->oldcount;
0980         new = acm->iocount;
0981         acm->oldcount = new;
0982         spin_unlock_irq(&acm->read_lock);
0983 
0984         if ((arg & TIOCM_DSR) &&
0985             old.dsr != new.dsr)
0986             break;
0987         if ((arg & TIOCM_CD)  &&
0988             old.dcd != new.dcd)
0989             break;
0990         if ((arg & TIOCM_RI) &&
0991             old.rng != new.rng)
0992             break;
0993 
0994         add_wait_queue(&acm->wioctl, &wait);
0995         set_current_state(TASK_INTERRUPTIBLE);
0996         schedule();
0997         remove_wait_queue(&acm->wioctl, &wait);
0998         if (acm->disconnected) {
0999             if (arg & TIOCM_CD)
1000                 break;
1001             else
1002                 rv = -ENODEV;
1003         } else {
1004             if (signal_pending(current))
1005                 rv = -ERESTARTSYS;
1006         }
1007     } while (!rv);
1008 
1009     
1010 
1011     return rv;
1012 }
1013 
1014 static int acm_tty_get_icount(struct tty_struct *tty,
1015                     struct serial_icounter_struct *icount)
1016 {
1017     struct acm *acm = tty->driver_data;
1018 
1019     icount->dsr = acm->iocount.dsr;
1020     icount->rng = acm->iocount.rng;
1021     icount->dcd = acm->iocount.dcd;
1022     icount->frame = acm->iocount.frame;
1023     icount->overrun = acm->iocount.overrun;
1024     icount->parity = acm->iocount.parity;
1025     icount->brk = acm->iocount.brk;
1026 
1027     return 0;
1028 }
1029 
1030 static int acm_tty_ioctl(struct tty_struct *tty,
1031                     unsigned int cmd, unsigned long arg)
1032 {
1033     struct acm *acm = tty->driver_data;
1034     int rv = -ENOIOCTLCMD;
1035 
1036     switch (cmd) {
1037     case TIOCMIWAIT:
1038         rv = usb_autopm_get_interface(acm->control);
1039         if (rv < 0) {
1040             rv = -EIO;
1041             break;
1042         }
1043         rv = wait_serial_change(acm, arg);
1044         usb_autopm_put_interface(acm->control);
1045         break;
1046     }
1047 
1048     return rv;
1049 }
1050 
1051 static void acm_tty_set_termios(struct tty_struct *tty,
1052                         struct ktermios *termios_old)
1053 {
1054     struct acm *acm = tty->driver_data;
1055     struct ktermios *termios = &tty->termios;
1056     struct usb_cdc_line_coding newline;
1057     int newctrl = acm->ctrlout;
1058 
1059     newline.dwDTERate = cpu_to_le32(tty_get_baud_rate(tty));
1060     newline.bCharFormat = termios->c_cflag & CSTOPB ? 2 : 0;
1061     newline.bParityType = termios->c_cflag & PARENB ?
1062                 (termios->c_cflag & PARODD ? 1 : 2) +
1063                 (termios->c_cflag & CMSPAR ? 2 : 0) : 0;
1064     newline.bDataBits = tty_get_char_size(termios->c_cflag);
1065 
1066     /* FIXME: Needs to clear unsupported bits in the termios */
1067     acm->clocal = ((termios->c_cflag & CLOCAL) != 0);
1068 
1069     if (C_BAUD(tty) == B0) {
1070         newline.dwDTERate = acm->line.dwDTERate;
1071         newctrl &= ~USB_CDC_CTRL_DTR;
1072     } else if (termios_old && (termios_old->c_cflag & CBAUD) == B0) {
1073         newctrl |=  USB_CDC_CTRL_DTR;
1074     }
1075 
1076     if (newctrl != acm->ctrlout)
1077         acm_set_control(acm, acm->ctrlout = newctrl);
1078 
1079     if (memcmp(&acm->line, &newline, sizeof newline)) {
1080         memcpy(&acm->line, &newline, sizeof newline);
1081         dev_dbg(&acm->control->dev, "%s - set line: %d %d %d %d\n",
1082             __func__,
1083             le32_to_cpu(newline.dwDTERate),
1084             newline.bCharFormat, newline.bParityType,
1085             newline.bDataBits);
1086         acm_set_line(acm, &acm->line);
1087     }
1088 }
1089 
1090 static const struct tty_port_operations acm_port_ops = {
1091     .dtr_rts = acm_port_dtr_rts,
1092     .shutdown = acm_port_shutdown,
1093     .activate = acm_port_activate,
1094     .destruct = acm_port_destruct,
1095 };
1096 
1097 /*
1098  * USB probe and disconnect routines.
1099  */
1100 
1101 /* Little helpers: write/read buffers free */
1102 static void acm_write_buffers_free(struct acm *acm)
1103 {
1104     int i;
1105     struct acm_wb *wb;
1106 
1107     for (wb = &acm->wb[0], i = 0; i < ACM_NW; i++, wb++)
1108         usb_free_coherent(acm->dev, acm->writesize, wb->buf, wb->dmah);
1109 }
1110 
1111 static void acm_read_buffers_free(struct acm *acm)
1112 {
1113     int i;
1114 
1115     for (i = 0; i < acm->rx_buflimit; i++)
1116         usb_free_coherent(acm->dev, acm->readsize,
1117               acm->read_buffers[i].base, acm->read_buffers[i].dma);
1118 }
1119 
1120 /* Little helper: write buffers allocate */
1121 static int acm_write_buffers_alloc(struct acm *acm)
1122 {
1123     int i;
1124     struct acm_wb *wb;
1125 
1126     for (wb = &acm->wb[0], i = 0; i < ACM_NW; i++, wb++) {
1127         wb->buf = usb_alloc_coherent(acm->dev, acm->writesize, GFP_KERNEL,
1128             &wb->dmah);
1129         if (!wb->buf) {
1130             while (i != 0) {
1131                 --i;
1132                 --wb;
1133                 usb_free_coherent(acm->dev, acm->writesize,
1134                     wb->buf, wb->dmah);
1135             }
1136             return -ENOMEM;
1137         }
1138     }
1139     return 0;
1140 }
1141 
1142 static int acm_probe(struct usb_interface *intf,
1143              const struct usb_device_id *id)
1144 {
1145     struct usb_cdc_union_desc *union_header = NULL;
1146     struct usb_cdc_call_mgmt_descriptor *cmgmd = NULL;
1147     unsigned char *buffer = intf->altsetting->extra;
1148     int buflen = intf->altsetting->extralen;
1149     struct usb_interface *control_interface;
1150     struct usb_interface *data_interface;
1151     struct usb_endpoint_descriptor *epctrl = NULL;
1152     struct usb_endpoint_descriptor *epread = NULL;
1153     struct usb_endpoint_descriptor *epwrite = NULL;
1154     struct usb_device *usb_dev = interface_to_usbdev(intf);
1155     struct usb_cdc_parsed_header h;
1156     struct acm *acm;
1157     int minor;
1158     int ctrlsize, readsize;
1159     u8 *buf;
1160     int call_intf_num = -1;
1161     int data_intf_num = -1;
1162     unsigned long quirks;
1163     int num_rx_buf;
1164     int i;
1165     int combined_interfaces = 0;
1166     struct device *tty_dev;
1167     int rv = -ENOMEM;
1168     int res;
1169 
1170     /* normal quirks */
1171     quirks = (unsigned long)id->driver_info;
1172 
1173     if (quirks == IGNORE_DEVICE)
1174         return -ENODEV;
1175 
1176     memset(&h, 0x00, sizeof(struct usb_cdc_parsed_header));
1177 
1178     num_rx_buf = (quirks == SINGLE_RX_URB) ? 1 : ACM_NR;
1179 
1180     /* handle quirks deadly to normal probing*/
1181     if (quirks == NO_UNION_NORMAL) {
1182         data_interface = usb_ifnum_to_if(usb_dev, 1);
1183         control_interface = usb_ifnum_to_if(usb_dev, 0);
1184         /* we would crash */
1185         if (!data_interface || !control_interface)
1186             return -ENODEV;
1187         goto skip_normal_probe;
1188     }
1189 
1190     /* normal probing*/
1191     if (!buffer) {
1192         dev_err(&intf->dev, "Weird descriptor references\n");
1193         return -EINVAL;
1194     }
1195 
1196     if (!buflen) {
1197         if (intf->cur_altsetting->endpoint &&
1198                 intf->cur_altsetting->endpoint->extralen &&
1199                 intf->cur_altsetting->endpoint->extra) {
1200             dev_dbg(&intf->dev,
1201                 "Seeking extra descriptors on endpoint\n");
1202             buflen = intf->cur_altsetting->endpoint->extralen;
1203             buffer = intf->cur_altsetting->endpoint->extra;
1204         } else {
1205             dev_err(&intf->dev,
1206                 "Zero length descriptor references\n");
1207             return -EINVAL;
1208         }
1209     }
1210 
1211     cdc_parse_cdc_header(&h, intf, buffer, buflen);
1212     union_header = h.usb_cdc_union_desc;
1213     cmgmd = h.usb_cdc_call_mgmt_descriptor;
1214     if (cmgmd)
1215         call_intf_num = cmgmd->bDataInterface;
1216 
1217     if (!union_header) {
1218         if (intf->cur_altsetting->desc.bNumEndpoints == 3) {
1219             dev_dbg(&intf->dev, "No union descriptor, assuming single interface\n");
1220             combined_interfaces = 1;
1221             control_interface = data_interface = intf;
1222             goto look_for_collapsed_interface;
1223         } else if (call_intf_num > 0) {
1224             dev_dbg(&intf->dev, "No union descriptor, using call management descriptor\n");
1225             data_intf_num = call_intf_num;
1226             data_interface = usb_ifnum_to_if(usb_dev, data_intf_num);
1227             control_interface = intf;
1228         } else {
1229             dev_dbg(&intf->dev, "No union descriptor, giving up\n");
1230             return -ENODEV;
1231         }
1232     } else {
1233         int class = -1;
1234 
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);
1238 
1239         if (control_interface)
1240             class = control_interface->cur_altsetting->desc.bInterfaceClass;
1241 
1242         if (class != USB_CLASS_COMM && class != USB_CLASS_CDC_DATA) {
1243             dev_dbg(&intf->dev, "Broken union descriptor, assuming single interface\n");
1244             combined_interfaces = 1;
1245             control_interface = data_interface = intf;
1246             goto look_for_collapsed_interface;
1247         }
1248     }
1249 
1250     if (!control_interface || !data_interface) {
1251         dev_dbg(&intf->dev, "no interfaces\n");
1252         return -ENODEV;
1253     }
1254 
1255     if (data_intf_num != call_intf_num)
1256         dev_dbg(&intf->dev, "Separate call control interface. That is not fully supported.\n");
1257 
1258     if (control_interface == data_interface) {
1259         /* some broken devices designed for windows work this way */
1260         dev_warn(&intf->dev,"Control and data interfaces are not separated!\n");
1261         combined_interfaces = 1;
1262         /* a popular other OS doesn't use it */
1263         quirks |= NO_CAP_LINE;
1264         if (data_interface->cur_altsetting->desc.bNumEndpoints != 3) {
1265             dev_err(&intf->dev, "This needs exactly 3 endpoints\n");
1266             return -EINVAL;
1267         }
1268 look_for_collapsed_interface:
1269         res = usb_find_common_endpoints(data_interface->cur_altsetting,
1270                 &epread, &epwrite, &epctrl, NULL);
1271         if (res)
1272             return res;
1273 
1274         goto made_compressed_probe;
1275     }
1276 
1277 skip_normal_probe:
1278 
1279     /*workaround for switched interfaces */
1280     if (data_interface->cur_altsetting->desc.bInterfaceClass != USB_CLASS_CDC_DATA) {
1281         if (control_interface->cur_altsetting->desc.bInterfaceClass == USB_CLASS_CDC_DATA) {
1282             dev_dbg(&intf->dev,
1283                 "Your device has switched interfaces.\n");
1284             swap(control_interface, data_interface);
1285         } else {
1286             return -EINVAL;
1287         }
1288     }
1289 
1290     /* Accept probe requests only for the control interface */
1291     if (!combined_interfaces && intf != control_interface)
1292         return -ENODEV;
1293 
1294     if (data_interface->cur_altsetting->desc.bNumEndpoints < 2 ||
1295         control_interface->cur_altsetting->desc.bNumEndpoints == 0)
1296         return -EINVAL;
1297 
1298     epctrl = &control_interface->cur_altsetting->endpoint[0].desc;
1299     epread = &data_interface->cur_altsetting->endpoint[0].desc;
1300     epwrite = &data_interface->cur_altsetting->endpoint[1].desc;
1301 
1302 
1303     /* workaround for switched endpoints */
1304     if (!usb_endpoint_dir_in(epread)) {
1305         /* descriptors are swapped */
1306         dev_dbg(&intf->dev,
1307             "The data interface has switched endpoints\n");
1308         swap(epread, epwrite);
1309     }
1310 made_compressed_probe:
1311     dev_dbg(&intf->dev, "interfaces are valid\n");
1312 
1313     acm = kzalloc(sizeof(struct acm), GFP_KERNEL);
1314     if (!acm)
1315         return -ENOMEM;
1316 
1317     tty_port_init(&acm->port);
1318     acm->port.ops = &acm_port_ops;
1319 
1320     ctrlsize = usb_endpoint_maxp(epctrl);
1321     readsize = usb_endpoint_maxp(epread) *
1322                 (quirks == SINGLE_RX_URB ? 1 : 2);
1323     acm->combined_interfaces = combined_interfaces;
1324     acm->writesize = usb_endpoint_maxp(epwrite) * 20;
1325     acm->control = control_interface;
1326     acm->data = data_interface;
1327 
1328     usb_get_intf(acm->control); /* undone in destruct() */
1329 
1330     minor = acm_alloc_minor(acm);
1331     if (minor < 0) {
1332         acm->minor = ACM_MINOR_INVALID;
1333         goto err_put_port;
1334     }
1335 
1336     acm->minor = minor;
1337     acm->dev = usb_dev;
1338     if (h.usb_cdc_acm_descriptor)
1339         acm->ctrl_caps = h.usb_cdc_acm_descriptor->bmCapabilities;
1340     if (quirks & NO_CAP_LINE)
1341         acm->ctrl_caps &= ~USB_CDC_CAP_LINE;
1342     acm->ctrlsize = ctrlsize;
1343     acm->readsize = readsize;
1344     acm->rx_buflimit = num_rx_buf;
1345     INIT_DELAYED_WORK(&acm->dwork, acm_softint);
1346     init_waitqueue_head(&acm->wioctl);
1347     spin_lock_init(&acm->write_lock);
1348     spin_lock_init(&acm->read_lock);
1349     mutex_init(&acm->mutex);
1350     if (usb_endpoint_xfer_int(epread)) {
1351         acm->bInterval = epread->bInterval;
1352         acm->in = usb_rcvintpipe(usb_dev, epread->bEndpointAddress);
1353     } else {
1354         acm->in = usb_rcvbulkpipe(usb_dev, epread->bEndpointAddress);
1355     }
1356     if (usb_endpoint_xfer_int(epwrite))
1357         acm->out = usb_sndintpipe(usb_dev, epwrite->bEndpointAddress);
1358     else
1359         acm->out = usb_sndbulkpipe(usb_dev, epwrite->bEndpointAddress);
1360     init_usb_anchor(&acm->delayed);
1361     acm->quirks = quirks;
1362 
1363     buf = usb_alloc_coherent(usb_dev, ctrlsize, GFP_KERNEL, &acm->ctrl_dma);
1364     if (!buf)
1365         goto err_put_port;
1366     acm->ctrl_buffer = buf;
1367 
1368     if (acm_write_buffers_alloc(acm) < 0)
1369         goto err_free_ctrl_buffer;
1370 
1371     acm->ctrlurb = usb_alloc_urb(0, GFP_KERNEL);
1372     if (!acm->ctrlurb)
1373         goto err_free_write_buffers;
1374 
1375     for (i = 0; i < num_rx_buf; i++) {
1376         struct acm_rb *rb = &(acm->read_buffers[i]);
1377         struct urb *urb;
1378 
1379         rb->base = usb_alloc_coherent(acm->dev, readsize, GFP_KERNEL,
1380                                 &rb->dma);
1381         if (!rb->base)
1382             goto err_free_read_urbs;
1383         rb->index = i;
1384         rb->instance = acm;
1385 
1386         urb = usb_alloc_urb(0, GFP_KERNEL);
1387         if (!urb)
1388             goto err_free_read_urbs;
1389 
1390         urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1391         urb->transfer_dma = rb->dma;
1392         if (usb_endpoint_xfer_int(epread))
1393             usb_fill_int_urb(urb, acm->dev, acm->in, rb->base,
1394                      acm->readsize,
1395                      acm_read_bulk_callback, rb,
1396                      acm->bInterval);
1397         else
1398             usb_fill_bulk_urb(urb, acm->dev, acm->in, rb->base,
1399                       acm->readsize,
1400                       acm_read_bulk_callback, rb);
1401 
1402         acm->read_urbs[i] = urb;
1403         __set_bit(i, &acm->read_urbs_free);
1404     }
1405     for (i = 0; i < ACM_NW; i++) {
1406         struct acm_wb *snd = &(acm->wb[i]);
1407 
1408         snd->urb = usb_alloc_urb(0, GFP_KERNEL);
1409         if (!snd->urb)
1410             goto err_free_write_urbs;
1411 
1412         if (usb_endpoint_xfer_int(epwrite))
1413             usb_fill_int_urb(snd->urb, usb_dev, acm->out,
1414                 NULL, acm->writesize, acm_write_bulk, snd, epwrite->bInterval);
1415         else
1416             usb_fill_bulk_urb(snd->urb, usb_dev, acm->out,
1417                 NULL, acm->writesize, acm_write_bulk, snd);
1418         snd->urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1419         if (quirks & SEND_ZERO_PACKET)
1420             snd->urb->transfer_flags |= URB_ZERO_PACKET;
1421         snd->instance = acm;
1422     }
1423 
1424     usb_set_intfdata(intf, acm);
1425 
1426     i = device_create_file(&intf->dev, &dev_attr_bmCapabilities);
1427     if (i < 0)
1428         goto err_free_write_urbs;
1429 
1430     if (h.usb_cdc_country_functional_desc) { /* export the country data */
1431         struct usb_cdc_country_functional_desc * cfd =
1432                     h.usb_cdc_country_functional_desc;
1433 
1434         acm->country_codes = kmalloc(cfd->bLength - 4, GFP_KERNEL);
1435         if (!acm->country_codes)
1436             goto skip_countries;
1437         acm->country_code_size = cfd->bLength - 4;
1438         memcpy(acm->country_codes, (u8 *)&cfd->wCountyCode0,
1439                             cfd->bLength - 4);
1440         acm->country_rel_date = cfd->iCountryCodeRelDate;
1441 
1442         i = device_create_file(&intf->dev, &dev_attr_wCountryCodes);
1443         if (i < 0) {
1444             kfree(acm->country_codes);
1445             acm->country_codes = NULL;
1446             acm->country_code_size = 0;
1447             goto skip_countries;
1448         }
1449 
1450         i = device_create_file(&intf->dev,
1451                         &dev_attr_iCountryCodeRelDate);
1452         if (i < 0) {
1453             device_remove_file(&intf->dev, &dev_attr_wCountryCodes);
1454             kfree(acm->country_codes);
1455             acm->country_codes = NULL;
1456             acm->country_code_size = 0;
1457             goto skip_countries;
1458         }
1459     }
1460 
1461 skip_countries:
1462     usb_fill_int_urb(acm->ctrlurb, usb_dev,
1463              usb_rcvintpipe(usb_dev, epctrl->bEndpointAddress),
1464              acm->ctrl_buffer, ctrlsize, acm_ctrl_irq, acm,
1465              /* works around buggy devices */
1466              epctrl->bInterval ? epctrl->bInterval : 16);
1467     acm->ctrlurb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
1468     acm->ctrlurb->transfer_dma = acm->ctrl_dma;
1469     acm->notification_buffer = NULL;
1470     acm->nb_index = 0;
1471     acm->nb_size = 0;
1472 
1473     acm->line.dwDTERate = cpu_to_le32(9600);
1474     acm->line.bDataBits = 8;
1475     acm_set_line(acm, &acm->line);
1476 
1477     if (!acm->combined_interfaces) {
1478         rv = usb_driver_claim_interface(&acm_driver, data_interface, acm);
1479         if (rv)
1480             goto err_remove_files;
1481     }
1482 
1483     tty_dev = tty_port_register_device(&acm->port, acm_tty_driver, minor,
1484             &control_interface->dev);
1485     if (IS_ERR(tty_dev)) {
1486         rv = PTR_ERR(tty_dev);
1487         goto err_release_data_interface;
1488     }
1489 
1490     if (quirks & CLEAR_HALT_CONDITIONS) {
1491         usb_clear_halt(usb_dev, acm->in);
1492         usb_clear_halt(usb_dev, acm->out);
1493     }
1494 
1495     dev_info(&intf->dev, "ttyACM%d: USB ACM device\n", minor);
1496 
1497     return 0;
1498 
1499 err_release_data_interface:
1500     if (!acm->combined_interfaces) {
1501         /* Clear driver data so that disconnect() returns early. */
1502         usb_set_intfdata(data_interface, NULL);
1503         usb_driver_release_interface(&acm_driver, data_interface);
1504     }
1505 err_remove_files:
1506     if (acm->country_codes) {
1507         device_remove_file(&acm->control->dev,
1508                 &dev_attr_wCountryCodes);
1509         device_remove_file(&acm->control->dev,
1510                 &dev_attr_iCountryCodeRelDate);
1511     }
1512     device_remove_file(&acm->control->dev, &dev_attr_bmCapabilities);
1513 err_free_write_urbs:
1514     for (i = 0; i < ACM_NW; i++)
1515         usb_free_urb(acm->wb[i].urb);
1516 err_free_read_urbs:
1517     for (i = 0; i < num_rx_buf; i++)
1518         usb_free_urb(acm->read_urbs[i]);
1519     acm_read_buffers_free(acm);
1520     usb_free_urb(acm->ctrlurb);
1521 err_free_write_buffers:
1522     acm_write_buffers_free(acm);
1523 err_free_ctrl_buffer:
1524     usb_free_coherent(usb_dev, ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
1525 err_put_port:
1526     tty_port_put(&acm->port);
1527 
1528     return rv;
1529 }
1530 
1531 static void acm_disconnect(struct usb_interface *intf)
1532 {
1533     struct acm *acm = usb_get_intfdata(intf);
1534     struct tty_struct *tty;
1535     int i;
1536 
1537     /* sibling interface is already cleaning up */
1538     if (!acm)
1539         return;
1540 
1541     acm->disconnected = true;
1542     /*
1543      * there is a circular dependency. acm_softint() can resubmit
1544      * the URBs in error handling so we need to block any
1545      * submission right away
1546      */
1547     acm_poison_urbs(acm);
1548     mutex_lock(&acm->mutex);
1549     if (acm->country_codes) {
1550         device_remove_file(&acm->control->dev,
1551                 &dev_attr_wCountryCodes);
1552         device_remove_file(&acm->control->dev,
1553                 &dev_attr_iCountryCodeRelDate);
1554     }
1555     wake_up_all(&acm->wioctl);
1556     device_remove_file(&acm->control->dev, &dev_attr_bmCapabilities);
1557     usb_set_intfdata(acm->control, NULL);
1558     usb_set_intfdata(acm->data, NULL);
1559     mutex_unlock(&acm->mutex);
1560 
1561     tty = tty_port_tty_get(&acm->port);
1562     if (tty) {
1563         tty_vhangup(tty);
1564         tty_kref_put(tty);
1565     }
1566 
1567     cancel_delayed_work_sync(&acm->dwork);
1568 
1569     tty_unregister_device(acm_tty_driver, acm->minor);
1570 
1571     usb_free_urb(acm->ctrlurb);
1572     for (i = 0; i < ACM_NW; i++)
1573         usb_free_urb(acm->wb[i].urb);
1574     for (i = 0; i < acm->rx_buflimit; i++)
1575         usb_free_urb(acm->read_urbs[i]);
1576     acm_write_buffers_free(acm);
1577     usb_free_coherent(acm->dev, acm->ctrlsize, acm->ctrl_buffer, acm->ctrl_dma);
1578     acm_read_buffers_free(acm);
1579 
1580     kfree(acm->notification_buffer);
1581 
1582     if (!acm->combined_interfaces)
1583         usb_driver_release_interface(&acm_driver, intf == acm->control ?
1584                     acm->data : acm->control);
1585 
1586     tty_port_put(&acm->port);
1587 }
1588 
1589 #ifdef CONFIG_PM
1590 static int acm_suspend(struct usb_interface *intf, pm_message_t message)
1591 {
1592     struct acm *acm = usb_get_intfdata(intf);
1593     int cnt;
1594 
1595     spin_lock_irq(&acm->write_lock);
1596     if (PMSG_IS_AUTO(message)) {
1597         if (acm->transmitting) {
1598             spin_unlock_irq(&acm->write_lock);
1599             return -EBUSY;
1600         }
1601     }
1602     cnt = acm->susp_count++;
1603     spin_unlock_irq(&acm->write_lock);
1604 
1605     if (cnt)
1606         return 0;
1607 
1608     acm_poison_urbs(acm);
1609     cancel_delayed_work_sync(&acm->dwork);
1610     acm->urbs_in_error_delay = 0;
1611 
1612     return 0;
1613 }
1614 
1615 static int acm_resume(struct usb_interface *intf)
1616 {
1617     struct acm *acm = usb_get_intfdata(intf);
1618     struct urb *urb;
1619     int rv = 0;
1620 
1621     spin_lock_irq(&acm->write_lock);
1622 
1623     if (--acm->susp_count)
1624         goto out;
1625 
1626     acm_unpoison_urbs(acm);
1627 
1628     if (tty_port_initialized(&acm->port)) {
1629         rv = usb_submit_urb(acm->ctrlurb, GFP_ATOMIC);
1630 
1631         for (;;) {
1632             urb = usb_get_from_anchor(&acm->delayed);
1633             if (!urb)
1634                 break;
1635 
1636             acm_start_wb(acm, urb->context);
1637         }
1638 
1639         /*
1640          * delayed error checking because we must
1641          * do the write path at all cost
1642          */
1643         if (rv < 0)
1644             goto out;
1645 
1646         rv = acm_submit_read_urbs(acm, GFP_ATOMIC);
1647     }
1648 out:
1649     spin_unlock_irq(&acm->write_lock);
1650 
1651     return rv;
1652 }
1653 
1654 static int acm_reset_resume(struct usb_interface *intf)
1655 {
1656     struct acm *acm = usb_get_intfdata(intf);
1657 
1658     if (tty_port_initialized(&acm->port))
1659         tty_port_tty_hangup(&acm->port, false);
1660 
1661     return acm_resume(intf);
1662 }
1663 
1664 #endif /* CONFIG_PM */
1665 
1666 static int acm_pre_reset(struct usb_interface *intf)
1667 {
1668     struct acm *acm = usb_get_intfdata(intf);
1669 
1670     clear_bit(EVENT_RX_STALL, &acm->flags);
1671     acm->nb_index = 0; /* pending control transfers are lost */
1672 
1673     return 0;
1674 }
1675 
1676 #define NOKIA_PCSUITE_ACM_INFO(x) \
1677         USB_DEVICE_AND_INTERFACE_INFO(0x0421, x, \
1678         USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1679         USB_CDC_ACM_PROTO_VENDOR)
1680 
1681 #define SAMSUNG_PCSUITE_ACM_INFO(x) \
1682         USB_DEVICE_AND_INTERFACE_INFO(0x04e7, x, \
1683         USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM, \
1684         USB_CDC_ACM_PROTO_VENDOR)
1685 
1686 /*
1687  * USB driver structure.
1688  */
1689 
1690 static const struct usb_device_id acm_ids[] = {
1691     /* quirky and broken devices */
1692     { USB_DEVICE(0x0424, 0x274e), /* Microchip Technology, Inc. (formerly SMSC) */
1693       .driver_info = DISABLE_ECHO, }, /* DISABLE ECHO in termios flag */
1694     { USB_DEVICE(0x076d, 0x0006), /* Denso Cradle CU-321 */
1695     .driver_info = NO_UNION_NORMAL, },/* has no union descriptor */
1696     { USB_DEVICE(0x17ef, 0x7000), /* Lenovo USB modem */
1697     .driver_info = NO_UNION_NORMAL, },/* has no union descriptor */
1698     { USB_DEVICE(0x0870, 0x0001), /* Metricom GS Modem */
1699     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1700     },
1701     { USB_DEVICE(0x045b, 0x023c),   /* Renesas USB Download mode */
1702     .driver_info = DISABLE_ECHO,    /* Don't echo banner */
1703     },
1704     { USB_DEVICE(0x045b, 0x0248),   /* Renesas USB Download mode */
1705     .driver_info = DISABLE_ECHO,    /* Don't echo banner */
1706     },
1707     { USB_DEVICE(0x045b, 0x024D),   /* Renesas USB Download mode */
1708     .driver_info = DISABLE_ECHO,    /* Don't echo banner */
1709     },
1710     { USB_DEVICE(0x0e8d, 0x0003), /* FIREFLY, MediaTek Inc; andrey.arapov@gmail.com */
1711     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1712     },
1713     { USB_DEVICE(0x0e8d, 0x2000), /* MediaTek Inc Preloader */
1714     .driver_info = DISABLE_ECHO, /* DISABLE ECHO in termios flag */
1715     },
1716     { USB_DEVICE(0x0e8d, 0x3329), /* MediaTek Inc GPS */
1717     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1718     },
1719     { USB_DEVICE(0x0482, 0x0203), /* KYOCERA AH-K3001V */
1720     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1721     },
1722     { USB_DEVICE(0x079b, 0x000f), /* BT On-Air USB MODEM */
1723     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1724     },
1725     { USB_DEVICE(0x0ace, 0x1602), /* ZyDAS 56K USB MODEM */
1726     .driver_info = SINGLE_RX_URB,
1727     },
1728     { USB_DEVICE(0x0ace, 0x1608), /* ZyDAS 56K USB MODEM */
1729     .driver_info = SINGLE_RX_URB, /* firmware bug */
1730     },
1731     { USB_DEVICE(0x0ace, 0x1611), /* ZyDAS 56K USB MODEM - new version */
1732     .driver_info = SINGLE_RX_URB, /* firmware bug */
1733     },
1734     { USB_DEVICE(0x11ca, 0x0201), /* VeriFone Mx870 Gadget Serial */
1735     .driver_info = SINGLE_RX_URB,
1736     },
1737     { USB_DEVICE(0x1965, 0x0018), /* Uniden UBC125XLT */
1738     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1739     },
1740     { USB_DEVICE(0x22b8, 0x7000), /* Motorola Q Phone */
1741     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1742     },
1743     { USB_DEVICE(0x0803, 0x3095), /* Zoom Telephonics Model 3095F USB MODEM */
1744     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1745     },
1746     { USB_DEVICE(0x0572, 0x1321), /* Conexant USB MODEM CX93010 */
1747     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1748     },
1749     { USB_DEVICE(0x0572, 0x1324), /* Conexant USB MODEM RD02-D400 */
1750     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1751     },
1752     { USB_DEVICE(0x0572, 0x1328), /* Shiro / Aztech USB MODEM UM-3100 */
1753     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1754     },
1755     { USB_DEVICE(0x0572, 0x1349), /* Hiro (Conexant) USB MODEM H50228 */
1756     .driver_info = NO_UNION_NORMAL, /* has no union descriptor */
1757     },
1758     { USB_DEVICE(0x20df, 0x0001), /* Simtec Electronics Entropy Key */
1759     .driver_info = QUIRK_CONTROL_LINE_STATE, },
1760     { USB_DEVICE(0x2184, 0x001c) }, /* GW Instek AFG-2225 */
1761     { USB_DEVICE(0x2184, 0x0036) }, /* GW Instek AFG-125 */
1762     { USB_DEVICE(0x22b8, 0x6425), /* Motorola MOTOMAGX phones */
1763     },
1764     /* Motorola H24 HSPA module: */
1765     { USB_DEVICE(0x22b8, 0x2d91) }, /* modem                                */
1766     { USB_DEVICE(0x22b8, 0x2d92),   /* modem           + diagnostics        */
1767     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1768     },
1769     { USB_DEVICE(0x22b8, 0x2d93),   /* modem + AT port                      */
1770     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1771     },
1772     { USB_DEVICE(0x22b8, 0x2d95),   /* modem + AT port + diagnostics        */
1773     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1774     },
1775     { USB_DEVICE(0x22b8, 0x2d96),   /* modem                         + NMEA */
1776     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1777     },
1778     { USB_DEVICE(0x22b8, 0x2d97),   /* modem           + diagnostics + NMEA */
1779     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1780     },
1781     { USB_DEVICE(0x22b8, 0x2d99),   /* modem + AT port               + NMEA */
1782     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1783     },
1784     { USB_DEVICE(0x22b8, 0x2d9a),   /* modem + AT port + diagnostics + NMEA */
1785     .driver_info = NO_UNION_NORMAL, /* handle only modem interface          */
1786     },
1787 
1788     { USB_DEVICE(0x0572, 0x1329), /* Hummingbird huc56s (Conexant) */
1789     .driver_info = NO_UNION_NORMAL, /* union descriptor misplaced on
1790                        data interface instead of
1791                        communications interface.
1792                        Maybe we should define a new
1793                        quirk for this. */
1794     },
1795     { USB_DEVICE(0x0572, 0x1340), /* Conexant CX93010-2x UCMxx */
1796     .driver_info = NO_UNION_NORMAL,
1797     },
1798     { USB_DEVICE(0x05f9, 0x4002), /* PSC Scanning, Magellan 800i */
1799     .driver_info = NO_UNION_NORMAL,
1800     },
1801     { USB_DEVICE(0x1bbb, 0x0003), /* Alcatel OT-I650 */
1802     .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1803     },
1804     { USB_DEVICE(0x1576, 0x03b1), /* Maretron USB100 */
1805     .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1806     },
1807     { USB_DEVICE(0xfff0, 0x0100), /* DATECS FP-2000 */
1808     .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1809     },
1810     { USB_DEVICE(0x09d8, 0x0320), /* Elatec GmbH TWN3 */
1811     .driver_info = NO_UNION_NORMAL, /* has misplaced union descriptor */
1812     },
1813     { USB_DEVICE(0x0c26, 0x0020), /* Icom ICF3400 Serie */
1814     .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1815     },
1816     { USB_DEVICE(0x0ca6, 0xa050), /* Castles VEGA3000 */
1817     .driver_info = NO_UNION_NORMAL, /* reports zero length descriptor */
1818     },
1819 
1820     { USB_DEVICE(0x2912, 0x0001), /* ATOL FPrint */
1821     .driver_info = CLEAR_HALT_CONDITIONS,
1822     },
1823 
1824     /* Nokia S60 phones expose two ACM channels. The first is
1825      * a modem and is picked up by the standard AT-command
1826      * information below. The second is 'vendor-specific' but
1827      * is treated as a serial device at the S60 end, so we want
1828      * to expose it on Linux too. */
1829     { NOKIA_PCSUITE_ACM_INFO(0x042D), }, /* Nokia 3250 */
1830     { NOKIA_PCSUITE_ACM_INFO(0x04D8), }, /* Nokia 5500 Sport */
1831     { NOKIA_PCSUITE_ACM_INFO(0x04C9), }, /* Nokia E50 */
1832     { NOKIA_PCSUITE_ACM_INFO(0x0419), }, /* Nokia E60 */
1833     { NOKIA_PCSUITE_ACM_INFO(0x044D), }, /* Nokia E61 */
1834     { NOKIA_PCSUITE_ACM_INFO(0x0001), }, /* Nokia E61i */
1835     { NOKIA_PCSUITE_ACM_INFO(0x0475), }, /* Nokia E62 */
1836     { NOKIA_PCSUITE_ACM_INFO(0x0508), }, /* Nokia E65 */
1837     { NOKIA_PCSUITE_ACM_INFO(0x0418), }, /* Nokia E70 */
1838     { NOKIA_PCSUITE_ACM_INFO(0x0425), }, /* Nokia N71 */
1839     { NOKIA_PCSUITE_ACM_INFO(0x0486), }, /* Nokia N73 */
1840     { NOKIA_PCSUITE_ACM_INFO(0x04DF), }, /* Nokia N75 */
1841     { NOKIA_PCSUITE_ACM_INFO(0x000e), }, /* Nokia N77 */
1842     { NOKIA_PCSUITE_ACM_INFO(0x0445), }, /* Nokia N80 */
1843     { NOKIA_PCSUITE_ACM_INFO(0x042F), }, /* Nokia N91 & N91 8GB */
1844     { NOKIA_PCSUITE_ACM_INFO(0x048E), }, /* Nokia N92 */
1845     { NOKIA_PCSUITE_ACM_INFO(0x0420), }, /* Nokia N93 */
1846     { NOKIA_PCSUITE_ACM_INFO(0x04E6), }, /* Nokia N93i  */
1847     { NOKIA_PCSUITE_ACM_INFO(0x04B2), }, /* Nokia 5700 XpressMusic */
1848     { NOKIA_PCSUITE_ACM_INFO(0x0134), }, /* Nokia 6110 Navigator (China) */
1849     { NOKIA_PCSUITE_ACM_INFO(0x046E), }, /* Nokia 6110 Navigator */
1850     { NOKIA_PCSUITE_ACM_INFO(0x002f), }, /* Nokia 6120 classic &  */
1851     { NOKIA_PCSUITE_ACM_INFO(0x0088), }, /* Nokia 6121 classic */
1852     { NOKIA_PCSUITE_ACM_INFO(0x00fc), }, /* Nokia 6124 classic */
1853     { NOKIA_PCSUITE_ACM_INFO(0x0042), }, /* Nokia E51 */
1854     { NOKIA_PCSUITE_ACM_INFO(0x00b0), }, /* Nokia E66 */
1855     { NOKIA_PCSUITE_ACM_INFO(0x00ab), }, /* Nokia E71 */
1856     { NOKIA_PCSUITE_ACM_INFO(0x0481), }, /* Nokia N76 */
1857     { NOKIA_PCSUITE_ACM_INFO(0x0007), }, /* Nokia N81 & N81 8GB */
1858     { NOKIA_PCSUITE_ACM_INFO(0x0071), }, /* Nokia N82 */
1859     { NOKIA_PCSUITE_ACM_INFO(0x04F0), }, /* Nokia N95 & N95-3 NAM */
1860     { NOKIA_PCSUITE_ACM_INFO(0x0070), }, /* Nokia N95 8GB  */
1861     { NOKIA_PCSUITE_ACM_INFO(0x0099), }, /* Nokia 6210 Navigator, RM-367 */
1862     { NOKIA_PCSUITE_ACM_INFO(0x0128), }, /* Nokia 6210 Navigator, RM-419 */
1863     { NOKIA_PCSUITE_ACM_INFO(0x008f), }, /* Nokia 6220 Classic */
1864     { NOKIA_PCSUITE_ACM_INFO(0x00a0), }, /* Nokia 6650 */
1865     { NOKIA_PCSUITE_ACM_INFO(0x007b), }, /* Nokia N78 */
1866     { NOKIA_PCSUITE_ACM_INFO(0x0094), }, /* Nokia N85 */
1867     { NOKIA_PCSUITE_ACM_INFO(0x003a), }, /* Nokia N96 & N96-3  */
1868     { NOKIA_PCSUITE_ACM_INFO(0x00e9), }, /* Nokia 5320 XpressMusic */
1869     { NOKIA_PCSUITE_ACM_INFO(0x0108), }, /* Nokia 5320 XpressMusic 2G */
1870     { NOKIA_PCSUITE_ACM_INFO(0x01f5), }, /* Nokia N97, RM-505 */
1871     { NOKIA_PCSUITE_ACM_INFO(0x02e3), }, /* Nokia 5230, RM-588 */
1872     { NOKIA_PCSUITE_ACM_INFO(0x0178), }, /* Nokia E63 */
1873     { NOKIA_PCSUITE_ACM_INFO(0x010e), }, /* Nokia E75 */
1874     { NOKIA_PCSUITE_ACM_INFO(0x02d9), }, /* Nokia 6760 Slide */
1875     { NOKIA_PCSUITE_ACM_INFO(0x01d0), }, /* Nokia E52 */
1876     { NOKIA_PCSUITE_ACM_INFO(0x0223), }, /* Nokia E72 */
1877     { NOKIA_PCSUITE_ACM_INFO(0x0275), }, /* Nokia X6 */
1878     { NOKIA_PCSUITE_ACM_INFO(0x026c), }, /* Nokia N97 Mini */
1879     { NOKIA_PCSUITE_ACM_INFO(0x0154), }, /* Nokia 5800 XpressMusic */
1880     { NOKIA_PCSUITE_ACM_INFO(0x04ce), }, /* Nokia E90 */
1881     { NOKIA_PCSUITE_ACM_INFO(0x01d4), }, /* Nokia E55 */
1882     { NOKIA_PCSUITE_ACM_INFO(0x0302), }, /* Nokia N8 */
1883     { NOKIA_PCSUITE_ACM_INFO(0x0335), }, /* Nokia E7 */
1884     { NOKIA_PCSUITE_ACM_INFO(0x03cd), }, /* Nokia C7 */
1885     { SAMSUNG_PCSUITE_ACM_INFO(0x6651), }, /* Samsung GTi8510 (INNOV8) */
1886 
1887     /* Support for Owen devices */
1888     { USB_DEVICE(0x03eb, 0x0030), }, /* Owen SI30 */
1889 
1890     /* NOTE: non-Nokia COMM/ACM/0xff is likely MSFT RNDIS... NOT a modem! */
1891 
1892 #if IS_ENABLED(CONFIG_INPUT_IMS_PCU)
1893     { USB_DEVICE(0x04d8, 0x0082),   /* Application mode */
1894     .driver_info = IGNORE_DEVICE,
1895     },
1896     { USB_DEVICE(0x04d8, 0x0083),   /* Bootloader mode */
1897     .driver_info = IGNORE_DEVICE,
1898     },
1899 #endif
1900 
1901 #if IS_ENABLED(CONFIG_IR_TOY)
1902     { USB_DEVICE(0x04d8, 0xfd08),
1903     .driver_info = IGNORE_DEVICE,
1904     },
1905 
1906     { USB_DEVICE(0x04d8, 0xf58b),
1907     .driver_info = IGNORE_DEVICE,
1908     },
1909 #endif
1910 
1911 #if IS_ENABLED(CONFIG_USB_SERIAL_XR)
1912     { USB_DEVICE(0x04e2, 0x1400), .driver_info = IGNORE_DEVICE },
1913     { USB_DEVICE(0x04e2, 0x1401), .driver_info = IGNORE_DEVICE },
1914     { USB_DEVICE(0x04e2, 0x1402), .driver_info = IGNORE_DEVICE },
1915     { USB_DEVICE(0x04e2, 0x1403), .driver_info = IGNORE_DEVICE },
1916     { USB_DEVICE(0x04e2, 0x1410), .driver_info = IGNORE_DEVICE },
1917     { USB_DEVICE(0x04e2, 0x1411), .driver_info = IGNORE_DEVICE },
1918     { USB_DEVICE(0x04e2, 0x1412), .driver_info = IGNORE_DEVICE },
1919     { USB_DEVICE(0x04e2, 0x1414), .driver_info = IGNORE_DEVICE },
1920     { USB_DEVICE(0x04e2, 0x1420), .driver_info = IGNORE_DEVICE },
1921     { USB_DEVICE(0x04e2, 0x1422), .driver_info = IGNORE_DEVICE },
1922     { USB_DEVICE(0x04e2, 0x1424), .driver_info = IGNORE_DEVICE },
1923 #endif
1924 
1925     /*Samsung phone in firmware update mode */
1926     { USB_DEVICE(0x04e8, 0x685d),
1927     .driver_info = IGNORE_DEVICE,
1928     },
1929 
1930     /* Exclude Infineon Flash Loader utility */
1931     { USB_DEVICE(0x058b, 0x0041),
1932     .driver_info = IGNORE_DEVICE,
1933     },
1934 
1935     /* Exclude ETAS ES58x */
1936     { USB_DEVICE(0x108c, 0x0159), /* ES581.4 */
1937     .driver_info = IGNORE_DEVICE,
1938     },
1939     { USB_DEVICE(0x108c, 0x0168), /* ES582.1 */
1940     .driver_info = IGNORE_DEVICE,
1941     },
1942     { USB_DEVICE(0x108c, 0x0169), /* ES584.1 */
1943     .driver_info = IGNORE_DEVICE,
1944     },
1945 
1946     { USB_DEVICE(0x1bc7, 0x0021), /* Telit 3G ACM only composition */
1947     .driver_info = SEND_ZERO_PACKET,
1948     },
1949     { USB_DEVICE(0x1bc7, 0x0023), /* Telit 3G ACM + ECM composition */
1950     .driver_info = SEND_ZERO_PACKET,
1951     },
1952 
1953     /* Exclude Goodix Fingerprint Reader */
1954     { USB_DEVICE(0x27c6, 0x5395),
1955     .driver_info = IGNORE_DEVICE,
1956     },
1957 
1958     /* Exclude Heimann Sensor GmbH USB appset demo */
1959     { USB_DEVICE(0x32a7, 0x0000),
1960     .driver_info = IGNORE_DEVICE,
1961     },
1962 
1963     /* control interfaces without any protocol set */
1964     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1965         USB_CDC_PROTO_NONE) },
1966 
1967     /* control interfaces with various AT-command sets */
1968     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1969         USB_CDC_ACM_PROTO_AT_V25TER) },
1970     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1971         USB_CDC_ACM_PROTO_AT_PCCA101) },
1972     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1973         USB_CDC_ACM_PROTO_AT_PCCA101_WAKE) },
1974     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1975         USB_CDC_ACM_PROTO_AT_GSM) },
1976     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1977         USB_CDC_ACM_PROTO_AT_3G) },
1978     { USB_INTERFACE_INFO(USB_CLASS_COMM, USB_CDC_SUBCLASS_ACM,
1979         USB_CDC_ACM_PROTO_AT_CDMA) },
1980 
1981     { USB_DEVICE(0x1519, 0x0452), /* Intel 7260 modem */
1982     .driver_info = SEND_ZERO_PACKET,
1983     },
1984 
1985     { }
1986 };
1987 
1988 MODULE_DEVICE_TABLE(usb, acm_ids);
1989 
1990 static struct usb_driver acm_driver = {
1991     .name =     "cdc_acm",
1992     .probe =    acm_probe,
1993     .disconnect =   acm_disconnect,
1994 #ifdef CONFIG_PM
1995     .suspend =  acm_suspend,
1996     .resume =   acm_resume,
1997     .reset_resume = acm_reset_resume,
1998 #endif
1999     .pre_reset =    acm_pre_reset,
2000     .id_table = acm_ids,
2001 #ifdef CONFIG_PM
2002     .supports_autosuspend = 1,
2003 #endif
2004     .disable_hub_initiated_lpm = 1,
2005 };
2006 
2007 /*
2008  * TTY driver structures.
2009  */
2010 
2011 static const struct tty_operations acm_ops = {
2012     .install =      acm_tty_install,
2013     .open =         acm_tty_open,
2014     .close =        acm_tty_close,
2015     .cleanup =      acm_tty_cleanup,
2016     .hangup =       acm_tty_hangup,
2017     .write =        acm_tty_write,
2018     .write_room =       acm_tty_write_room,
2019     .ioctl =        acm_tty_ioctl,
2020     .throttle =     acm_tty_throttle,
2021     .unthrottle =       acm_tty_unthrottle,
2022     .chars_in_buffer =  acm_tty_chars_in_buffer,
2023     .break_ctl =        acm_tty_break_ctl,
2024     .set_termios =      acm_tty_set_termios,
2025     .tiocmget =     acm_tty_tiocmget,
2026     .tiocmset =     acm_tty_tiocmset,
2027     .get_serial =       get_serial_info,
2028     .set_serial =       set_serial_info,
2029     .get_icount =       acm_tty_get_icount,
2030 };
2031 
2032 /*
2033  * Init / exit.
2034  */
2035 
2036 static int __init acm_init(void)
2037 {
2038     int retval;
2039     acm_tty_driver = tty_alloc_driver(ACM_TTY_MINORS, TTY_DRIVER_REAL_RAW |
2040             TTY_DRIVER_DYNAMIC_DEV);
2041     if (IS_ERR(acm_tty_driver))
2042         return PTR_ERR(acm_tty_driver);
2043     acm_tty_driver->driver_name = "acm",
2044     acm_tty_driver->name = "ttyACM",
2045     acm_tty_driver->major = ACM_TTY_MAJOR,
2046     acm_tty_driver->minor_start = 0,
2047     acm_tty_driver->type = TTY_DRIVER_TYPE_SERIAL,
2048     acm_tty_driver->subtype = SERIAL_TYPE_NORMAL,
2049     acm_tty_driver->init_termios = tty_std_termios;
2050     acm_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD |
2051                                 HUPCL | CLOCAL;
2052     tty_set_operations(acm_tty_driver, &acm_ops);
2053 
2054     retval = tty_register_driver(acm_tty_driver);
2055     if (retval) {
2056         tty_driver_kref_put(acm_tty_driver);
2057         return retval;
2058     }
2059 
2060     retval = usb_register(&acm_driver);
2061     if (retval) {
2062         tty_unregister_driver(acm_tty_driver);
2063         tty_driver_kref_put(acm_tty_driver);
2064         return retval;
2065     }
2066 
2067     printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_DESC "\n");
2068 
2069     return 0;
2070 }
2071 
2072 static void __exit acm_exit(void)
2073 {
2074     usb_deregister(&acm_driver);
2075     tty_unregister_driver(acm_tty_driver);
2076     tty_driver_kref_put(acm_tty_driver);
2077     idr_destroy(&acm_minors);
2078 }
2079 
2080 module_init(acm_init);
2081 module_exit(acm_exit);
2082 
2083 MODULE_AUTHOR(DRIVER_AUTHOR);
2084 MODULE_DESCRIPTION(DRIVER_DESC);
2085 MODULE_LICENSE("GPL");
2086 MODULE_ALIAS_CHARDEV_MAJOR(ACM_TTY_MAJOR);