2 * USB Serial Converter driver
4 * Copyright (C) 1999 - 2005 Greg Kroah-Hartman (greg@kroah.com)
5 * Copyright (C) 2000 Peter Berger (pberger@brimson.com)
6 * Copyright (C) 2000 Al Borchers (borchers@steinerpoint.com)
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License version
10 * 2 as published by the Free Software Foundation.
12 * This driver was originally based on the ACM driver by Armin Fuerst (which was
13 * based on a driver by Brad Keryan)
15 * See Documentation/usb/usb-serial.txt for more information on using this driver
19 #include <linux/config.h>
20 #include <linux/kernel.h>
21 #include <linux/errno.h>
22 #include <linux/init.h>
23 #include <linux/slab.h>
24 #include <linux/tty.h>
25 #include <linux/tty_driver.h>
26 #include <linux/tty_flip.h>
27 #include <linux/module.h>
28 #include <linux/moduleparam.h>
29 #include <linux/spinlock.h>
30 #include <linux/mutex.h>
31 #include <linux/list.h>
32 #include <linux/smp_lock.h>
33 #include <asm/uaccess.h>
34 #include <linux/usb.h>
35 #include "usb-serial.h"
41 #define DRIVER_AUTHOR "Greg Kroah-Hartman, greg@kroah.com, http://www.kroah.com/linux/"
42 #define DRIVER_DESC "USB Serial Driver core"
44 /* Driver structure we register with the USB core */
45 static struct usb_driver usb_serial_driver = {
47 .probe = usb_serial_probe,
48 .disconnect = usb_serial_disconnect,
52 /* There is no MODULE_DEVICE_TABLE for usbserial.c. Instead
53 the MODULE_DEVICE_TABLE declarations in each serial driver
54 cause the "hotplug" program to pull in whatever module is necessary
55 via modprobe, and modprobe will load usbserial because the serial
60 static struct usb_serial *serial_table[SERIAL_TTY_MINORS]; /* initially all NULL */
61 static LIST_HEAD(usb_serial_driver_list);
63 struct usb_serial *usb_serial_get_by_index(unsigned index)
65 struct usb_serial *serial = serial_table[index];
68 kref_get(&serial->kref);
72 static struct usb_serial *get_free_serial (struct usb_serial *serial, int num_ports, unsigned int *minor)
77 dbg("%s %d", __FUNCTION__, num_ports);
80 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
85 for (j = 1; j <= num_ports-1; ++j)
86 if ((i+j >= SERIAL_TTY_MINORS) || (serial_table[i+j])) {
95 dbg("%s - minor base = %d", __FUNCTION__, *minor);
96 for (i = *minor; (i < (*minor + num_ports)) && (i < SERIAL_TTY_MINORS); ++i)
97 serial_table[i] = serial;
103 static void return_serial(struct usb_serial *serial)
107 dbg("%s", __FUNCTION__);
112 for (i = 0; i < serial->num_ports; ++i) {
113 serial_table[serial->minor + i] = NULL;
117 static void destroy_serial(struct kref *kref)
119 struct usb_serial *serial;
120 struct usb_serial_port *port;
123 serial = to_usb_serial(kref);
125 dbg("%s - %s", __FUNCTION__, serial->type->description);
127 serial->type->shutdown(serial);
129 /* return the minor range that this device had */
130 return_serial(serial);
132 for (i = 0; i < serial->num_ports; ++i)
133 serial->port[i]->open_count = 0;
135 /* the ports are cleaned up and released in port_release() */
136 for (i = 0; i < serial->num_ports; ++i)
137 if (serial->port[i]->dev.parent != NULL) {
138 device_unregister(&serial->port[i]->dev);
139 serial->port[i] = NULL;
142 /* If this is a "fake" port, we have to clean it up here, as it will
143 * not get cleaned up in port_release() as it was never registered with
145 if (serial->num_ports < serial->num_port_pointers) {
146 for (i = serial->num_ports; i < serial->num_port_pointers; ++i) {
147 port = serial->port[i];
150 usb_kill_urb(port->read_urb);
151 usb_free_urb(port->read_urb);
152 usb_kill_urb(port->write_urb);
153 usb_free_urb(port->write_urb);
154 usb_kill_urb(port->interrupt_in_urb);
155 usb_free_urb(port->interrupt_in_urb);
156 usb_kill_urb(port->interrupt_out_urb);
157 usb_free_urb(port->interrupt_out_urb);
158 kfree(port->bulk_in_buffer);
159 kfree(port->bulk_out_buffer);
160 kfree(port->interrupt_in_buffer);
161 kfree(port->interrupt_out_buffer);
165 flush_scheduled_work(); /* port->work */
167 usb_put_dev(serial->dev);
169 /* free up any memory that we allocated */
173 void usb_serial_put(struct usb_serial *serial)
175 kref_put(&serial->kref, destroy_serial);
178 /*****************************************************************************
179 * Driver tty interface functions
180 *****************************************************************************/
181 static int serial_open (struct tty_struct *tty, struct file * filp)
183 struct usb_serial *serial;
184 struct usb_serial_port *port;
185 unsigned int portNumber;
188 dbg("%s", __FUNCTION__);
190 /* get the serial object associated with this tty pointer */
191 serial = usb_serial_get_by_index(tty->index);
193 tty->driver_data = NULL;
197 portNumber = tty->index - serial->minor;
198 port = serial->port[portNumber];
201 goto bailout_kref_put;
204 if (mutex_lock_interruptible(&port->mutex)) {
205 retval = -ERESTARTSYS;
206 goto bailout_kref_put;
211 /* set up our port structure making the tty driver
212 * remember our port object, and us it */
213 tty->driver_data = port;
216 if (port->open_count == 1) {
218 /* lock this module before we call it
219 * this may fail, which means we must bail out,
220 * safe because we are called with BKL held */
221 if (!try_module_get(serial->type->driver.owner)) {
223 goto bailout_mutex_unlock;
226 /* only call the device specific open if this
227 * is the first time the port is opened */
228 retval = serial->type->open(port, filp);
230 goto bailout_module_put;
233 mutex_unlock(&port->mutex);
237 module_put(serial->type->driver.owner);
238 bailout_mutex_unlock:
239 port->open_count = 0;
240 tty->driver_data = NULL;
242 mutex_unlock(&port->mutex);
244 usb_serial_put(serial);
248 static void serial_close(struct tty_struct *tty, struct file * filp)
250 struct usb_serial_port *port = tty->driver_data;
255 dbg("%s - port %d", __FUNCTION__, port->number);
257 mutex_lock(&port->mutex);
259 if (port->open_count == 0) {
260 mutex_unlock(&port->mutex);
265 if (port->open_count == 0) {
266 /* only call the device specific close if this
267 * port is being closed by the last owner */
268 port->serial->type->close(port, filp);
271 if (port->tty->driver_data)
272 port->tty->driver_data = NULL;
276 module_put(port->serial->type->driver.owner);
279 mutex_unlock(&port->mutex);
280 usb_serial_put(port->serial);
283 static int serial_write (struct tty_struct * tty, const unsigned char *buf, int count)
285 struct usb_serial_port *port = tty->driver_data;
286 int retval = -EINVAL;
288 if (!port || port->serial->dev->state == USB_STATE_NOTATTACHED)
291 dbg("%s - port %d, %d byte(s)", __FUNCTION__, port->number, count);
293 if (!port->open_count) {
294 dbg("%s - port not opened", __FUNCTION__);
298 /* pass on to the driver specific version of this function */
299 retval = port->serial->type->write(port, buf, count);
305 static int serial_write_room (struct tty_struct *tty)
307 struct usb_serial_port *port = tty->driver_data;
308 int retval = -EINVAL;
313 dbg("%s - port %d", __FUNCTION__, port->number);
315 if (!port->open_count) {
316 dbg("%s - port not open", __FUNCTION__);
320 /* pass on to the driver specific version of this function */
321 retval = port->serial->type->write_room(port);
327 static int serial_chars_in_buffer (struct tty_struct *tty)
329 struct usb_serial_port *port = tty->driver_data;
330 int retval = -EINVAL;
335 dbg("%s = port %d", __FUNCTION__, port->number);
337 if (!port->open_count) {
338 dbg("%s - port not open", __FUNCTION__);
342 /* pass on to the driver specific version of this function */
343 retval = port->serial->type->chars_in_buffer(port);
349 static void serial_throttle (struct tty_struct * tty)
351 struct usb_serial_port *port = tty->driver_data;
356 dbg("%s - port %d", __FUNCTION__, port->number);
358 if (!port->open_count) {
359 dbg ("%s - port not open", __FUNCTION__);
363 /* pass on to the driver specific version of this function */
364 if (port->serial->type->throttle)
365 port->serial->type->throttle(port);
368 static void serial_unthrottle (struct tty_struct * tty)
370 struct usb_serial_port *port = tty->driver_data;
375 dbg("%s - port %d", __FUNCTION__, port->number);
377 if (!port->open_count) {
378 dbg("%s - port not open", __FUNCTION__);
382 /* pass on to the driver specific version of this function */
383 if (port->serial->type->unthrottle)
384 port->serial->type->unthrottle(port);
387 static int serial_ioctl (struct tty_struct *tty, struct file * file, unsigned int cmd, unsigned long arg)
389 struct usb_serial_port *port = tty->driver_data;
390 int retval = -ENODEV;
395 dbg("%s - port %d, cmd 0x%.4x", __FUNCTION__, port->number, cmd);
397 if (!port->open_count) {
398 dbg ("%s - port not open", __FUNCTION__);
402 /* pass on to the driver specific version of this function if it is available */
403 if (port->serial->type->ioctl)
404 retval = port->serial->type->ioctl(port, file, cmd, arg);
406 retval = -ENOIOCTLCMD;
412 static void serial_set_termios (struct tty_struct *tty, struct termios * old)
414 struct usb_serial_port *port = tty->driver_data;
419 dbg("%s - port %d", __FUNCTION__, port->number);
421 if (!port->open_count) {
422 dbg("%s - port not open", __FUNCTION__);
426 /* pass on to the driver specific version of this function if it is available */
427 if (port->serial->type->set_termios)
428 port->serial->type->set_termios(port, old);
431 static void serial_break (struct tty_struct *tty, int break_state)
433 struct usb_serial_port *port = tty->driver_data;
438 dbg("%s - port %d", __FUNCTION__, port->number);
440 if (!port->open_count) {
441 dbg("%s - port not open", __FUNCTION__);
445 /* pass on to the driver specific version of this function if it is available */
446 if (port->serial->type->break_ctl)
447 port->serial->type->break_ctl(port, break_state);
450 static int serial_read_proc (char *page, char **start, off_t off, int count, int *eof, void *data)
452 struct usb_serial *serial;
458 dbg("%s", __FUNCTION__);
459 length += sprintf (page, "usbserinfo:1.0 driver:2.0\n");
460 for (i = 0; i < SERIAL_TTY_MINORS && length < PAGE_SIZE; ++i) {
461 serial = usb_serial_get_by_index(i);
465 length += sprintf (page+length, "%d:", i);
466 if (serial->type->driver.owner)
467 length += sprintf (page+length, " module:%s", module_name(serial->type->driver.owner));
468 length += sprintf (page+length, " name:\"%s\"", serial->type->description);
469 length += sprintf (page+length, " vendor:%04x product:%04x",
470 le16_to_cpu(serial->dev->descriptor.idVendor),
471 le16_to_cpu(serial->dev->descriptor.idProduct));
472 length += sprintf (page+length, " num_ports:%d", serial->num_ports);
473 length += sprintf (page+length, " port:%d", i - serial->minor + 1);
475 usb_make_path(serial->dev, tmp, sizeof(tmp));
476 length += sprintf (page+length, " path:%s", tmp);
478 length += sprintf (page+length, "\n");
479 if ((length + begin) > (off + count))
481 if ((length + begin) < off) {
485 usb_serial_put(serial);
489 if (off >= (length + begin))
491 *start = page + (off-begin);
492 return ((count < begin+length-off) ? count : begin+length-off);
495 static int serial_tiocmget (struct tty_struct *tty, struct file *file)
497 struct usb_serial_port *port = tty->driver_data;
502 dbg("%s - port %d", __FUNCTION__, port->number);
504 if (!port->open_count) {
505 dbg("%s - port not open", __FUNCTION__);
509 if (port->serial->type->tiocmget)
510 return port->serial->type->tiocmget(port, file);
516 static int serial_tiocmset (struct tty_struct *tty, struct file *file,
517 unsigned int set, unsigned int clear)
519 struct usb_serial_port *port = tty->driver_data;
524 dbg("%s - port %d", __FUNCTION__, port->number);
526 if (!port->open_count) {
527 dbg("%s - port not open", __FUNCTION__);
531 if (port->serial->type->tiocmset)
532 return port->serial->type->tiocmset(port, file, set, clear);
539 * We would be calling tty_wakeup here, but unfortunately some line
540 * disciplines have an annoying habit of calling tty->write from
541 * the write wakeup callback (e.g. n_hdlc.c).
543 void usb_serial_port_softint(struct usb_serial_port *port)
545 schedule_work(&port->work);
548 static void usb_serial_port_work(void *private)
550 struct usb_serial_port *port = private;
551 struct tty_struct *tty;
553 dbg("%s - port %d", __FUNCTION__, port->number);
565 static void port_release(struct device *dev)
567 struct usb_serial_port *port = to_usb_serial_port(dev);
569 dbg ("%s - %s", __FUNCTION__, dev->bus_id);
570 usb_kill_urb(port->read_urb);
571 usb_free_urb(port->read_urb);
572 usb_kill_urb(port->write_urb);
573 usb_free_urb(port->write_urb);
574 usb_kill_urb(port->interrupt_in_urb);
575 usb_free_urb(port->interrupt_in_urb);
576 usb_kill_urb(port->interrupt_out_urb);
577 usb_free_urb(port->interrupt_out_urb);
578 kfree(port->bulk_in_buffer);
579 kfree(port->bulk_out_buffer);
580 kfree(port->interrupt_in_buffer);
581 kfree(port->interrupt_out_buffer);
585 static struct usb_serial * create_serial (struct usb_device *dev,
586 struct usb_interface *interface,
587 struct usb_serial_driver *driver)
589 struct usb_serial *serial;
591 serial = kzalloc(sizeof(*serial), GFP_KERNEL);
593 dev_err(&dev->dev, "%s - out of memory\n", __FUNCTION__);
596 serial->dev = usb_get_dev(dev);
597 serial->type = driver;
598 serial->interface = interface;
599 kref_init(&serial->kref);
604 static struct usb_serial_driver *search_serial_device(struct usb_interface *iface)
607 const struct usb_device_id *id;
608 struct usb_serial_driver *t;
610 /* Check if the usb id matches a known device */
611 list_for_each(p, &usb_serial_driver_list) {
612 t = list_entry(p, struct usb_serial_driver, driver_list);
613 id = usb_match_id(iface, t->id_table);
615 dbg("descriptor matches");
623 int usb_serial_probe(struct usb_interface *interface,
624 const struct usb_device_id *id)
626 struct usb_device *dev = interface_to_usbdev (interface);
627 struct usb_serial *serial = NULL;
628 struct usb_serial_port *port;
629 struct usb_host_interface *iface_desc;
630 struct usb_endpoint_descriptor *endpoint;
631 struct usb_endpoint_descriptor *interrupt_in_endpoint[MAX_NUM_PORTS];
632 struct usb_endpoint_descriptor *interrupt_out_endpoint[MAX_NUM_PORTS];
633 struct usb_endpoint_descriptor *bulk_in_endpoint[MAX_NUM_PORTS];
634 struct usb_endpoint_descriptor *bulk_out_endpoint[MAX_NUM_PORTS];
635 struct usb_serial_driver *type = NULL;
640 int num_interrupt_in = 0;
641 int num_interrupt_out = 0;
643 int num_bulk_out = 0;
647 type = search_serial_device(interface);
653 serial = create_serial (dev, interface, type);
655 dev_err(&interface->dev, "%s - out of memory\n", __FUNCTION__);
659 /* if this device type has a probe function, call it */
661 const struct usb_device_id *id;
663 if (!try_module_get(type->driver.owner)) {
664 dev_err(&interface->dev, "module get failed, exiting\n");
669 id = usb_match_id(interface, type->id_table);
670 retval = type->probe(serial, id);
671 module_put(type->driver.owner);
674 dbg ("sub driver rejected device");
680 /* descriptor matches, let's find the endpoints needed */
681 /* check out the endpoints */
682 iface_desc = interface->cur_altsetting;
683 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
684 endpoint = &iface_desc->endpoint[i].desc;
686 if ((endpoint->bEndpointAddress & 0x80) &&
687 ((endpoint->bmAttributes & 3) == 0x02)) {
688 /* we found a bulk in endpoint */
689 dbg("found bulk in on endpoint %d", i);
690 bulk_in_endpoint[num_bulk_in] = endpoint;
694 if (((endpoint->bEndpointAddress & 0x80) == 0x00) &&
695 ((endpoint->bmAttributes & 3) == 0x02)) {
696 /* we found a bulk out endpoint */
697 dbg("found bulk out on endpoint %d", i);
698 bulk_out_endpoint[num_bulk_out] = endpoint;
702 if ((endpoint->bEndpointAddress & 0x80) &&
703 ((endpoint->bmAttributes & 3) == 0x03)) {
704 /* we found a interrupt in endpoint */
705 dbg("found interrupt in on endpoint %d", i);
706 interrupt_in_endpoint[num_interrupt_in] = endpoint;
710 if (((endpoint->bEndpointAddress & 0x80) == 0x00) &&
711 ((endpoint->bmAttributes & 3) == 0x03)) {
712 /* we found an interrupt out endpoint */
713 dbg("found interrupt out on endpoint %d", i);
714 interrupt_out_endpoint[num_interrupt_out] = endpoint;
719 #if defined(CONFIG_USB_SERIAL_PL2303) || defined(CONFIG_USB_SERIAL_PL2303_MODULE)
720 /* BEGIN HORRIBLE HACK FOR PL2303 */
721 /* this is needed due to the looney way its endpoints are set up */
722 if (((le16_to_cpu(dev->descriptor.idVendor) == PL2303_VENDOR_ID) &&
723 (le16_to_cpu(dev->descriptor.idProduct) == PL2303_PRODUCT_ID)) ||
724 ((le16_to_cpu(dev->descriptor.idVendor) == ATEN_VENDOR_ID) &&
725 (le16_to_cpu(dev->descriptor.idProduct) == ATEN_PRODUCT_ID))) {
726 if (interface != dev->actconfig->interface[0]) {
727 /* check out the endpoints of the other interface*/
728 iface_desc = dev->actconfig->interface[0]->cur_altsetting;
729 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
730 endpoint = &iface_desc->endpoint[i].desc;
731 if ((endpoint->bEndpointAddress & 0x80) &&
732 ((endpoint->bmAttributes & 3) == 0x03)) {
733 /* we found a interrupt in endpoint */
734 dbg("found interrupt in for Prolific device on separate interface");
735 interrupt_in_endpoint[num_interrupt_in] = endpoint;
741 /* Now make sure the PL-2303 is configured correctly.
742 * If not, give up now and hope this hack will work
743 * properly during a later invocation of usb_serial_probe
745 if (num_bulk_in == 0 || num_bulk_out == 0) {
746 dev_info(&interface->dev, "PL-2303 hack: descriptors matched but endpoints did not\n");
751 /* END HORRIBLE HACK FOR PL2303 */
754 /* found all that we need */
755 dev_info(&interface->dev, "%s converter detected\n", type->description);
757 #ifdef CONFIG_USB_SERIAL_GENERIC
758 if (type == &usb_serial_generic_device) {
759 num_ports = num_bulk_out;
760 if (num_ports == 0) {
761 dev_err(&interface->dev, "Generic device with no bulk out, not allowed.\n");
768 /* if this device type has a calc_num_ports function, call it */
769 if (type->calc_num_ports) {
770 if (!try_module_get(type->driver.owner)) {
771 dev_err(&interface->dev, "module get failed, exiting\n");
775 num_ports = type->calc_num_ports (serial);
776 module_put(type->driver.owner);
779 num_ports = type->num_ports;
782 if (get_free_serial (serial, num_ports, &minor) == NULL) {
783 dev_err(&interface->dev, "No more free serial devices\n");
788 serial->minor = minor;
789 serial->num_ports = num_ports;
790 serial->num_bulk_in = num_bulk_in;
791 serial->num_bulk_out = num_bulk_out;
792 serial->num_interrupt_in = num_interrupt_in;
793 serial->num_interrupt_out = num_interrupt_out;
795 /* create our ports, we need as many as the max endpoints */
796 /* we don't use num_ports here cauz some devices have more endpoint pairs than ports */
797 max_endpoints = max(num_bulk_in, num_bulk_out);
798 max_endpoints = max(max_endpoints, num_interrupt_in);
799 max_endpoints = max(max_endpoints, num_interrupt_out);
800 max_endpoints = max(max_endpoints, (int)serial->num_ports);
801 serial->num_port_pointers = max_endpoints;
802 dbg("%s - setting up %d port structures for this device", __FUNCTION__, max_endpoints);
803 for (i = 0; i < max_endpoints; ++i) {
804 port = kzalloc(sizeof(struct usb_serial_port), GFP_KERNEL);
807 port->number = i + serial->minor;
808 port->serial = serial;
809 spin_lock_init(&port->lock);
810 mutex_init(&port->mutex);
811 INIT_WORK(&port->work, usb_serial_port_work, port);
812 serial->port[i] = port;
815 /* set up the endpoint information */
816 for (i = 0; i < num_bulk_in; ++i) {
817 endpoint = bulk_in_endpoint[i];
818 port = serial->port[i];
819 port->read_urb = usb_alloc_urb (0, GFP_KERNEL);
820 if (!port->read_urb) {
821 dev_err(&interface->dev, "No free urbs available\n");
824 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
825 port->bulk_in_size = buffer_size;
826 port->bulk_in_endpointAddress = endpoint->bEndpointAddress;
827 port->bulk_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
828 if (!port->bulk_in_buffer) {
829 dev_err(&interface->dev, "Couldn't allocate bulk_in_buffer\n");
832 usb_fill_bulk_urb (port->read_urb, dev,
833 usb_rcvbulkpipe (dev,
834 endpoint->bEndpointAddress),
835 port->bulk_in_buffer, buffer_size,
836 serial->type->read_bulk_callback,
840 for (i = 0; i < num_bulk_out; ++i) {
841 endpoint = bulk_out_endpoint[i];
842 port = serial->port[i];
843 port->write_urb = usb_alloc_urb(0, GFP_KERNEL);
844 if (!port->write_urb) {
845 dev_err(&interface->dev, "No free urbs available\n");
848 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
849 port->bulk_out_size = buffer_size;
850 port->bulk_out_endpointAddress = endpoint->bEndpointAddress;
851 port->bulk_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
852 if (!port->bulk_out_buffer) {
853 dev_err(&interface->dev, "Couldn't allocate bulk_out_buffer\n");
856 usb_fill_bulk_urb (port->write_urb, dev,
857 usb_sndbulkpipe (dev,
858 endpoint->bEndpointAddress),
859 port->bulk_out_buffer, buffer_size,
860 serial->type->write_bulk_callback,
864 if (serial->type->read_int_callback) {
865 for (i = 0; i < num_interrupt_in; ++i) {
866 endpoint = interrupt_in_endpoint[i];
867 port = serial->port[i];
868 port->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
869 if (!port->interrupt_in_urb) {
870 dev_err(&interface->dev, "No free urbs available\n");
873 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
874 port->interrupt_in_endpointAddress = endpoint->bEndpointAddress;
875 port->interrupt_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
876 if (!port->interrupt_in_buffer) {
877 dev_err(&interface->dev, "Couldn't allocate interrupt_in_buffer\n");
880 usb_fill_int_urb (port->interrupt_in_urb, dev,
882 endpoint->bEndpointAddress),
883 port->interrupt_in_buffer, buffer_size,
884 serial->type->read_int_callback, port,
885 endpoint->bInterval);
887 } else if (num_interrupt_in) {
888 dbg("the device claims to support interrupt in transfers, but read_int_callback is not defined");
891 if (serial->type->write_int_callback) {
892 for (i = 0; i < num_interrupt_out; ++i) {
893 endpoint = interrupt_out_endpoint[i];
894 port = serial->port[i];
895 port->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
896 if (!port->interrupt_out_urb) {
897 dev_err(&interface->dev, "No free urbs available\n");
900 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
901 port->interrupt_out_size = buffer_size;
902 port->interrupt_out_endpointAddress = endpoint->bEndpointAddress;
903 port->interrupt_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
904 if (!port->interrupt_out_buffer) {
905 dev_err(&interface->dev, "Couldn't allocate interrupt_out_buffer\n");
908 usb_fill_int_urb (port->interrupt_out_urb, dev,
910 endpoint->bEndpointAddress),
911 port->interrupt_out_buffer, buffer_size,
912 serial->type->write_int_callback, port,
913 endpoint->bInterval);
915 } else if (num_interrupt_out) {
916 dbg("the device claims to support interrupt out transfers, but write_int_callback is not defined");
919 /* if this device type has an attach function, call it */
921 if (!try_module_get(type->driver.owner)) {
922 dev_err(&interface->dev, "module get failed, exiting\n");
925 retval = type->attach (serial);
926 module_put(type->driver.owner);
930 /* quietly accept this device, but don't bind to a serial port
931 * as it's about to disappear */
936 /* register all of the individual ports with the driver core */
937 for (i = 0; i < num_ports; ++i) {
938 port = serial->port[i];
939 port->dev.parent = &interface->dev;
940 port->dev.driver = NULL;
941 port->dev.bus = &usb_serial_bus_type;
942 port->dev.release = &port_release;
944 snprintf (&port->dev.bus_id[0], sizeof(port->dev.bus_id), "ttyUSB%d", port->number);
945 dbg ("%s - registering %s", __FUNCTION__, port->dev.bus_id);
946 device_register (&port->dev);
949 usb_serial_console_init (debug, minor);
953 usb_set_intfdata (interface, serial);
957 for (i = 0; i < num_bulk_in; ++i) {
958 port = serial->port[i];
962 usb_free_urb (port->read_urb);
963 kfree(port->bulk_in_buffer);
965 for (i = 0; i < num_bulk_out; ++i) {
966 port = serial->port[i];
970 usb_free_urb (port->write_urb);
971 kfree(port->bulk_out_buffer);
973 for (i = 0; i < num_interrupt_in; ++i) {
974 port = serial->port[i];
977 if (port->interrupt_in_urb)
978 usb_free_urb (port->interrupt_in_urb);
979 kfree(port->interrupt_in_buffer);
981 for (i = 0; i < num_interrupt_out; ++i) {
982 port = serial->port[i];
985 if (port->interrupt_out_urb)
986 usb_free_urb (port->interrupt_out_urb);
987 kfree(port->interrupt_out_buffer);
990 /* return the minor range that this device had */
991 return_serial (serial);
993 /* free up any memory that we allocated */
994 for (i = 0; i < serial->num_port_pointers; ++i)
995 kfree(serial->port[i]);
1000 void usb_serial_disconnect(struct usb_interface *interface)
1003 struct usb_serial *serial = usb_get_intfdata (interface);
1004 struct device *dev = &interface->dev;
1005 struct usb_serial_port *port;
1007 usb_serial_console_disconnect(serial);
1008 dbg ("%s", __FUNCTION__);
1010 usb_set_intfdata (interface, NULL);
1012 for (i = 0; i < serial->num_ports; ++i) {
1013 port = serial->port[i];
1014 if (port && port->tty)
1015 tty_hangup(port->tty);
1017 /* let the last holder of this object
1018 * cause it to be cleaned up */
1019 usb_serial_put(serial);
1021 dev_info(dev, "device disconnected\n");
1024 static struct tty_operations serial_ops = {
1025 .open = serial_open,
1026 .close = serial_close,
1027 .write = serial_write,
1028 .write_room = serial_write_room,
1029 .ioctl = serial_ioctl,
1030 .set_termios = serial_set_termios,
1031 .throttle = serial_throttle,
1032 .unthrottle = serial_unthrottle,
1033 .break_ctl = serial_break,
1034 .chars_in_buffer = serial_chars_in_buffer,
1035 .read_proc = serial_read_proc,
1036 .tiocmget = serial_tiocmget,
1037 .tiocmset = serial_tiocmset,
1040 struct tty_driver *usb_serial_tty_driver;
1042 static int __init usb_serial_init(void)
1047 usb_serial_tty_driver = alloc_tty_driver(SERIAL_TTY_MINORS);
1048 if (!usb_serial_tty_driver)
1051 /* Initialize our global data */
1052 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
1053 serial_table[i] = NULL;
1056 result = bus_register(&usb_serial_bus_type);
1058 err("%s - registering bus driver failed", __FUNCTION__);
1062 usb_serial_tty_driver->owner = THIS_MODULE;
1063 usb_serial_tty_driver->driver_name = "usbserial";
1064 usb_serial_tty_driver->devfs_name = "usb/tts/";
1065 usb_serial_tty_driver->name = "ttyUSB";
1066 usb_serial_tty_driver->major = SERIAL_TTY_MAJOR;
1067 usb_serial_tty_driver->minor_start = 0;
1068 usb_serial_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
1069 usb_serial_tty_driver->subtype = SERIAL_TYPE_NORMAL;
1070 usb_serial_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_NO_DEVFS;
1071 usb_serial_tty_driver->init_termios = tty_std_termios;
1072 usb_serial_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
1073 tty_set_operations(usb_serial_tty_driver, &serial_ops);
1074 result = tty_register_driver(usb_serial_tty_driver);
1076 err("%s - tty_register_driver failed", __FUNCTION__);
1077 goto exit_reg_driver;
1080 /* register the USB driver */
1081 result = usb_register(&usb_serial_driver);
1083 err("%s - usb_register failed", __FUNCTION__);
1087 /* register the generic driver, if we should */
1088 result = usb_serial_generic_register(debug);
1090 err("%s - registering generic driver failed", __FUNCTION__);
1099 usb_deregister(&usb_serial_driver);
1102 tty_unregister_driver(usb_serial_tty_driver);
1105 bus_unregister(&usb_serial_bus_type);
1108 err ("%s - returning with error %d", __FUNCTION__, result);
1109 put_tty_driver(usb_serial_tty_driver);
1114 static void __exit usb_serial_exit(void)
1116 usb_serial_console_exit();
1118 usb_serial_generic_deregister();
1120 usb_deregister(&usb_serial_driver);
1121 tty_unregister_driver(usb_serial_tty_driver);
1122 put_tty_driver(usb_serial_tty_driver);
1123 bus_unregister(&usb_serial_bus_type);
1127 module_init(usb_serial_init);
1128 module_exit(usb_serial_exit);
1130 #define set_to_generic_if_null(type, function) \
1132 if (!type->function) { \
1133 type->function = usb_serial_generic_##function; \
1134 dbg("Had to override the " #function \
1135 " usb serial operation with the generic one.");\
1139 static void fixup_generic(struct usb_serial_driver *device)
1141 set_to_generic_if_null(device, open);
1142 set_to_generic_if_null(device, write);
1143 set_to_generic_if_null(device, close);
1144 set_to_generic_if_null(device, write_room);
1145 set_to_generic_if_null(device, chars_in_buffer);
1146 set_to_generic_if_null(device, read_bulk_callback);
1147 set_to_generic_if_null(device, write_bulk_callback);
1148 set_to_generic_if_null(device, shutdown);
1151 int usb_serial_register(struct usb_serial_driver *driver)
1155 fixup_generic(driver);
1157 if (!driver->description)
1158 driver->description = driver->driver.name;
1160 /* Add this device to our list of devices */
1161 list_add(&driver->driver_list, &usb_serial_driver_list);
1163 retval = usb_serial_bus_register(driver);
1165 err("problem %d when registering driver %s", retval, driver->description);
1166 list_del(&driver->driver_list);
1169 info("USB Serial support registered for %s", driver->description);
1175 void usb_serial_deregister(struct usb_serial_driver *device)
1177 info("USB Serial deregistering driver %s", device->description);
1178 list_del(&device->driver_list);
1179 usb_serial_bus_deregister(device);
1184 /* If the usb-serial core is built into the core, the usb-serial drivers
1185 need these symbols to load properly as modules. */
1186 EXPORT_SYMBOL_GPL(usb_serial_register);
1187 EXPORT_SYMBOL_GPL(usb_serial_deregister);
1188 EXPORT_SYMBOL_GPL(usb_serial_probe);
1189 EXPORT_SYMBOL_GPL(usb_serial_disconnect);
1190 EXPORT_SYMBOL_GPL(usb_serial_port_softint);
1193 /* Module information */
1194 MODULE_AUTHOR( DRIVER_AUTHOR );
1195 MODULE_DESCRIPTION( DRIVER_DESC );
1196 MODULE_LICENSE("GPL");
1198 module_param(debug, bool, S_IRUGO | S_IWUSR);
1199 MODULE_PARM_DESC(debug, "Debug enabled or not");