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/list.h>
31 #include <linux/smp_lock.h>
32 #include <asm/uaccess.h>
33 #include <asm/semaphore.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 usb_put_dev(serial->dev);
167 /* free up any memory that we allocated */
171 /*****************************************************************************
172 * Driver tty interface functions
173 *****************************************************************************/
174 static int serial_open (struct tty_struct *tty, struct file * filp)
176 struct usb_serial *serial;
177 struct usb_serial_port *port;
178 unsigned int portNumber;
181 dbg("%s", __FUNCTION__);
183 /* get the serial object associated with this tty pointer */
184 serial = usb_serial_get_by_index(tty->index);
186 tty->driver_data = NULL;
190 portNumber = tty->index - serial->minor;
191 port = serial->port[portNumber];
195 if (down_interruptible(&port->sem))
200 if (port->open_count == 1) {
202 /* set up our port structure making the tty driver
203 * remember our port object, and us it */
204 tty->driver_data = port;
207 /* lock this module before we call it
208 * this may fail, which means we must bail out,
209 * safe because we are called with BKL held */
210 if (!try_module_get(serial->type->driver.owner)) {
212 goto bailout_kref_put;
215 /* only call the device specific open if this
216 * is the first time the port is opened */
217 retval = serial->type->open(port, filp);
219 goto bailout_module_put;
226 module_put(serial->type->driver.owner);
228 kref_put(&serial->kref, destroy_serial);
229 port->open_count = 0;
234 static void serial_close(struct tty_struct *tty, struct file * filp)
236 struct usb_serial_port *port = tty->driver_data;
241 dbg("%s - port %d", __FUNCTION__, port->number);
245 if (port->open_count == 0) {
251 if (port->open_count == 0) {
252 /* only call the device specific close if this
253 * port is being closed by the last owner */
254 port->serial->type->close(port, filp);
257 if (port->tty->driver_data)
258 port->tty->driver_data = NULL;
262 module_put(port->serial->type->driver.owner);
266 kref_put(&port->serial->kref, destroy_serial);
269 static int serial_write (struct tty_struct * tty, const unsigned char *buf, int count)
271 struct usb_serial_port *port = tty->driver_data;
272 int retval = -EINVAL;
277 dbg("%s - port %d, %d byte(s)", __FUNCTION__, port->number, count);
279 if (!port->open_count) {
280 dbg("%s - port not opened", __FUNCTION__);
284 /* pass on to the driver specific version of this function */
285 retval = port->serial->type->write(port, buf, count);
291 static int serial_write_room (struct tty_struct *tty)
293 struct usb_serial_port *port = tty->driver_data;
294 int retval = -EINVAL;
299 dbg("%s - port %d", __FUNCTION__, port->number);
301 if (!port->open_count) {
302 dbg("%s - port not open", __FUNCTION__);
306 /* pass on to the driver specific version of this function */
307 retval = port->serial->type->write_room(port);
313 static int serial_chars_in_buffer (struct tty_struct *tty)
315 struct usb_serial_port *port = tty->driver_data;
316 int retval = -EINVAL;
321 dbg("%s = port %d", __FUNCTION__, port->number);
323 if (!port->open_count) {
324 dbg("%s - port not open", __FUNCTION__);
328 /* pass on to the driver specific version of this function */
329 retval = port->serial->type->chars_in_buffer(port);
335 static void serial_throttle (struct tty_struct * tty)
337 struct usb_serial_port *port = tty->driver_data;
342 dbg("%s - port %d", __FUNCTION__, port->number);
344 if (!port->open_count) {
345 dbg ("%s - port not open", __FUNCTION__);
349 /* pass on to the driver specific version of this function */
350 if (port->serial->type->throttle)
351 port->serial->type->throttle(port);
354 static void serial_unthrottle (struct tty_struct * tty)
356 struct usb_serial_port *port = tty->driver_data;
361 dbg("%s - port %d", __FUNCTION__, port->number);
363 if (!port->open_count) {
364 dbg("%s - port not open", __FUNCTION__);
368 /* pass on to the driver specific version of this function */
369 if (port->serial->type->unthrottle)
370 port->serial->type->unthrottle(port);
373 static int serial_ioctl (struct tty_struct *tty, struct file * file, unsigned int cmd, unsigned long arg)
375 struct usb_serial_port *port = tty->driver_data;
376 int retval = -ENODEV;
381 dbg("%s - port %d, cmd 0x%.4x", __FUNCTION__, port->number, cmd);
383 if (!port->open_count) {
384 dbg ("%s - port not open", __FUNCTION__);
388 /* pass on to the driver specific version of this function if it is available */
389 if (port->serial->type->ioctl)
390 retval = port->serial->type->ioctl(port, file, cmd, arg);
392 retval = -ENOIOCTLCMD;
398 static void serial_set_termios (struct tty_struct *tty, struct termios * old)
400 struct usb_serial_port *port = tty->driver_data;
405 dbg("%s - port %d", __FUNCTION__, port->number);
407 if (!port->open_count) {
408 dbg("%s - port not open", __FUNCTION__);
412 /* pass on to the driver specific version of this function if it is available */
413 if (port->serial->type->set_termios)
414 port->serial->type->set_termios(port, old);
417 static void serial_break (struct tty_struct *tty, int break_state)
419 struct usb_serial_port *port = tty->driver_data;
424 dbg("%s - port %d", __FUNCTION__, port->number);
426 if (!port->open_count) {
427 dbg("%s - port not open", __FUNCTION__);
431 /* pass on to the driver specific version of this function if it is available */
432 if (port->serial->type->break_ctl)
433 port->serial->type->break_ctl(port, break_state);
436 static int serial_read_proc (char *page, char **start, off_t off, int count, int *eof, void *data)
438 struct usb_serial *serial;
444 dbg("%s", __FUNCTION__);
445 length += sprintf (page, "usbserinfo:1.0 driver:2.0\n");
446 for (i = 0; i < SERIAL_TTY_MINORS && length < PAGE_SIZE; ++i) {
447 serial = usb_serial_get_by_index(i);
451 length += sprintf (page+length, "%d:", i);
452 if (serial->type->driver.owner)
453 length += sprintf (page+length, " module:%s", module_name(serial->type->driver.owner));
454 length += sprintf (page+length, " name:\"%s\"", serial->type->description);
455 length += sprintf (page+length, " vendor:%04x product:%04x",
456 le16_to_cpu(serial->dev->descriptor.idVendor),
457 le16_to_cpu(serial->dev->descriptor.idProduct));
458 length += sprintf (page+length, " num_ports:%d", serial->num_ports);
459 length += sprintf (page+length, " port:%d", i - serial->minor + 1);
461 usb_make_path(serial->dev, tmp, sizeof(tmp));
462 length += sprintf (page+length, " path:%s", tmp);
464 length += sprintf (page+length, "\n");
465 if ((length + begin) > (off + count))
467 if ((length + begin) < off) {
471 kref_put(&serial->kref, destroy_serial);
475 if (off >= (length + begin))
477 *start = page + (off-begin);
478 return ((count < begin+length-off) ? count : begin+length-off);
481 static int serial_tiocmget (struct tty_struct *tty, struct file *file)
483 struct usb_serial_port *port = tty->driver_data;
488 dbg("%s - port %d", __FUNCTION__, port->number);
490 if (!port->open_count) {
491 dbg("%s - port not open", __FUNCTION__);
495 if (port->serial->type->tiocmget)
496 return port->serial->type->tiocmget(port, file);
502 static int serial_tiocmset (struct tty_struct *tty, struct file *file,
503 unsigned int set, unsigned int clear)
505 struct usb_serial_port *port = tty->driver_data;
510 dbg("%s - port %d", __FUNCTION__, port->number);
512 if (!port->open_count) {
513 dbg("%s - port not open", __FUNCTION__);
517 if (port->serial->type->tiocmset)
518 return port->serial->type->tiocmset(port, file, set, clear);
524 void usb_serial_port_softint(void *private)
526 struct usb_serial_port *port = private;
527 struct tty_struct *tty;
529 dbg("%s - port %d", __FUNCTION__, port->number);
541 static void port_release(struct device *dev)
543 struct usb_serial_port *port = to_usb_serial_port(dev);
545 dbg ("%s - %s", __FUNCTION__, dev->bus_id);
546 usb_kill_urb(port->read_urb);
547 usb_free_urb(port->read_urb);
548 usb_kill_urb(port->write_urb);
549 usb_free_urb(port->write_urb);
550 usb_kill_urb(port->interrupt_in_urb);
551 usb_free_urb(port->interrupt_in_urb);
552 usb_kill_urb(port->interrupt_out_urb);
553 usb_free_urb(port->interrupt_out_urb);
554 kfree(port->bulk_in_buffer);
555 kfree(port->bulk_out_buffer);
556 kfree(port->interrupt_in_buffer);
557 kfree(port->interrupt_out_buffer);
561 static struct usb_serial * create_serial (struct usb_device *dev,
562 struct usb_interface *interface,
563 struct usb_serial_driver *driver)
565 struct usb_serial *serial;
567 serial = kzalloc(sizeof(*serial), GFP_KERNEL);
569 dev_err(&dev->dev, "%s - out of memory\n", __FUNCTION__);
572 serial->dev = usb_get_dev(dev);
573 serial->type = driver;
574 serial->interface = interface;
575 kref_init(&serial->kref);
580 static struct usb_serial_driver *search_serial_device(struct usb_interface *iface)
583 const struct usb_device_id *id;
584 struct usb_serial_driver *t;
586 /* Check if the usb id matches a known device */
587 list_for_each(p, &usb_serial_driver_list) {
588 t = list_entry(p, struct usb_serial_driver, driver_list);
589 id = usb_match_id(iface, t->id_table);
591 dbg("descriptor matches");
599 int usb_serial_probe(struct usb_interface *interface,
600 const struct usb_device_id *id)
602 struct usb_device *dev = interface_to_usbdev (interface);
603 struct usb_serial *serial = NULL;
604 struct usb_serial_port *port;
605 struct usb_host_interface *iface_desc;
606 struct usb_endpoint_descriptor *endpoint;
607 struct usb_endpoint_descriptor *interrupt_in_endpoint[MAX_NUM_PORTS];
608 struct usb_endpoint_descriptor *interrupt_out_endpoint[MAX_NUM_PORTS];
609 struct usb_endpoint_descriptor *bulk_in_endpoint[MAX_NUM_PORTS];
610 struct usb_endpoint_descriptor *bulk_out_endpoint[MAX_NUM_PORTS];
611 struct usb_serial_driver *type = NULL;
616 int num_interrupt_in = 0;
617 int num_interrupt_out = 0;
619 int num_bulk_out = 0;
623 type = search_serial_device(interface);
629 serial = create_serial (dev, interface, type);
631 dev_err(&interface->dev, "%s - out of memory\n", __FUNCTION__);
635 /* if this device type has a probe function, call it */
637 const struct usb_device_id *id;
639 if (!try_module_get(type->driver.owner)) {
640 dev_err(&interface->dev, "module get failed, exiting\n");
645 id = usb_match_id(interface, type->id_table);
646 retval = type->probe(serial, id);
647 module_put(type->driver.owner);
650 dbg ("sub driver rejected device");
656 /* descriptor matches, let's find the endpoints needed */
657 /* check out the endpoints */
658 iface_desc = interface->cur_altsetting;
659 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
660 endpoint = &iface_desc->endpoint[i].desc;
662 if ((endpoint->bEndpointAddress & 0x80) &&
663 ((endpoint->bmAttributes & 3) == 0x02)) {
664 /* we found a bulk in endpoint */
665 dbg("found bulk in on endpoint %d", i);
666 bulk_in_endpoint[num_bulk_in] = endpoint;
670 if (((endpoint->bEndpointAddress & 0x80) == 0x00) &&
671 ((endpoint->bmAttributes & 3) == 0x02)) {
672 /* we found a bulk out endpoint */
673 dbg("found bulk out on endpoint %d", i);
674 bulk_out_endpoint[num_bulk_out] = endpoint;
678 if ((endpoint->bEndpointAddress & 0x80) &&
679 ((endpoint->bmAttributes & 3) == 0x03)) {
680 /* we found a interrupt in endpoint */
681 dbg("found interrupt in on endpoint %d", i);
682 interrupt_in_endpoint[num_interrupt_in] = endpoint;
686 if (((endpoint->bEndpointAddress & 0x80) == 0x00) &&
687 ((endpoint->bmAttributes & 3) == 0x03)) {
688 /* we found an interrupt out endpoint */
689 dbg("found interrupt out on endpoint %d", i);
690 interrupt_out_endpoint[num_interrupt_out] = endpoint;
695 #if defined(CONFIG_USB_SERIAL_PL2303) || defined(CONFIG_USB_SERIAL_PL2303_MODULE)
696 /* BEGIN HORRIBLE HACK FOR PL2303 */
697 /* this is needed due to the looney way its endpoints are set up */
698 if (((le16_to_cpu(dev->descriptor.idVendor) == PL2303_VENDOR_ID) &&
699 (le16_to_cpu(dev->descriptor.idProduct) == PL2303_PRODUCT_ID)) ||
700 ((le16_to_cpu(dev->descriptor.idVendor) == ATEN_VENDOR_ID) &&
701 (le16_to_cpu(dev->descriptor.idProduct) == ATEN_PRODUCT_ID))) {
702 if (interface != dev->actconfig->interface[0]) {
703 /* check out the endpoints of the other interface*/
704 iface_desc = dev->actconfig->interface[0]->cur_altsetting;
705 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
706 endpoint = &iface_desc->endpoint[i].desc;
707 if ((endpoint->bEndpointAddress & 0x80) &&
708 ((endpoint->bmAttributes & 3) == 0x03)) {
709 /* we found a interrupt in endpoint */
710 dbg("found interrupt in for Prolific device on separate interface");
711 interrupt_in_endpoint[num_interrupt_in] = endpoint;
717 /* Now make sure the PL-2303 is configured correctly.
718 * If not, give up now and hope this hack will work
719 * properly during a later invocation of usb_serial_probe
721 if (num_bulk_in == 0 || num_bulk_out == 0) {
722 dev_info(&interface->dev, "PL-2303 hack: descriptors matched but endpoints did not\n");
727 /* END HORRIBLE HACK FOR PL2303 */
730 /* found all that we need */
731 dev_info(&interface->dev, "%s converter detected\n", type->description);
733 #ifdef CONFIG_USB_SERIAL_GENERIC
734 if (type == &usb_serial_generic_device) {
735 num_ports = num_bulk_out;
736 if (num_ports == 0) {
737 dev_err(&interface->dev, "Generic device with no bulk out, not allowed.\n");
744 /* if this device type has a calc_num_ports function, call it */
745 if (type->calc_num_ports) {
746 if (!try_module_get(type->driver.owner)) {
747 dev_err(&interface->dev, "module get failed, exiting\n");
751 num_ports = type->calc_num_ports (serial);
752 module_put(type->driver.owner);
755 num_ports = type->num_ports;
758 if (get_free_serial (serial, num_ports, &minor) == NULL) {
759 dev_err(&interface->dev, "No more free serial devices\n");
764 serial->minor = minor;
765 serial->num_ports = num_ports;
766 serial->num_bulk_in = num_bulk_in;
767 serial->num_bulk_out = num_bulk_out;
768 serial->num_interrupt_in = num_interrupt_in;
769 serial->num_interrupt_out = num_interrupt_out;
771 /* create our ports, we need as many as the max endpoints */
772 /* we don't use num_ports here cauz some devices have more endpoint pairs than ports */
773 max_endpoints = max(num_bulk_in, num_bulk_out);
774 max_endpoints = max(max_endpoints, num_interrupt_in);
775 max_endpoints = max(max_endpoints, num_interrupt_out);
776 max_endpoints = max(max_endpoints, (int)serial->num_ports);
777 serial->num_port_pointers = max_endpoints;
778 dbg("%s - setting up %d port structures for this device", __FUNCTION__, max_endpoints);
779 for (i = 0; i < max_endpoints; ++i) {
780 port = kzalloc(sizeof(struct usb_serial_port), GFP_KERNEL);
783 port->number = i + serial->minor;
784 port->serial = serial;
785 spin_lock_init(&port->lock);
786 sema_init(&port->sem, 1);
787 INIT_WORK(&port->work, usb_serial_port_softint, port);
788 serial->port[i] = port;
791 /* set up the endpoint information */
792 for (i = 0; i < num_bulk_in; ++i) {
793 endpoint = bulk_in_endpoint[i];
794 port = serial->port[i];
795 port->read_urb = usb_alloc_urb (0, GFP_KERNEL);
796 if (!port->read_urb) {
797 dev_err(&interface->dev, "No free urbs available\n");
800 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
801 port->bulk_in_size = buffer_size;
802 port->bulk_in_endpointAddress = endpoint->bEndpointAddress;
803 port->bulk_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
804 if (!port->bulk_in_buffer) {
805 dev_err(&interface->dev, "Couldn't allocate bulk_in_buffer\n");
808 usb_fill_bulk_urb (port->read_urb, dev,
809 usb_rcvbulkpipe (dev,
810 endpoint->bEndpointAddress),
811 port->bulk_in_buffer, buffer_size,
812 serial->type->read_bulk_callback,
816 for (i = 0; i < num_bulk_out; ++i) {
817 endpoint = bulk_out_endpoint[i];
818 port = serial->port[i];
819 port->write_urb = usb_alloc_urb(0, GFP_KERNEL);
820 if (!port->write_urb) {
821 dev_err(&interface->dev, "No free urbs available\n");
824 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
825 port->bulk_out_size = buffer_size;
826 port->bulk_out_endpointAddress = endpoint->bEndpointAddress;
827 port->bulk_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
828 if (!port->bulk_out_buffer) {
829 dev_err(&interface->dev, "Couldn't allocate bulk_out_buffer\n");
832 usb_fill_bulk_urb (port->write_urb, dev,
833 usb_sndbulkpipe (dev,
834 endpoint->bEndpointAddress),
835 port->bulk_out_buffer, buffer_size,
836 serial->type->write_bulk_callback,
840 if (serial->type->read_int_callback) {
841 for (i = 0; i < num_interrupt_in; ++i) {
842 endpoint = interrupt_in_endpoint[i];
843 port = serial->port[i];
844 port->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
845 if (!port->interrupt_in_urb) {
846 dev_err(&interface->dev, "No free urbs available\n");
849 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
850 port->interrupt_in_endpointAddress = endpoint->bEndpointAddress;
851 port->interrupt_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
852 if (!port->interrupt_in_buffer) {
853 dev_err(&interface->dev, "Couldn't allocate interrupt_in_buffer\n");
856 usb_fill_int_urb (port->interrupt_in_urb, dev,
858 endpoint->bEndpointAddress),
859 port->interrupt_in_buffer, buffer_size,
860 serial->type->read_int_callback, port,
861 endpoint->bInterval);
863 } else if (num_interrupt_in) {
864 dbg("the device claims to support interrupt in transfers, but read_int_callback is not defined");
867 if (serial->type->write_int_callback) {
868 for (i = 0; i < num_interrupt_out; ++i) {
869 endpoint = interrupt_out_endpoint[i];
870 port = serial->port[i];
871 port->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
872 if (!port->interrupt_out_urb) {
873 dev_err(&interface->dev, "No free urbs available\n");
876 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
877 port->interrupt_out_size = buffer_size;
878 port->interrupt_out_endpointAddress = endpoint->bEndpointAddress;
879 port->interrupt_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
880 if (!port->interrupt_out_buffer) {
881 dev_err(&interface->dev, "Couldn't allocate interrupt_out_buffer\n");
884 usb_fill_int_urb (port->interrupt_out_urb, dev,
886 endpoint->bEndpointAddress),
887 port->interrupt_out_buffer, buffer_size,
888 serial->type->write_int_callback, port,
889 endpoint->bInterval);
891 } else if (num_interrupt_out) {
892 dbg("the device claims to support interrupt out transfers, but write_int_callback is not defined");
895 /* if this device type has an attach function, call it */
897 if (!try_module_get(type->driver.owner)) {
898 dev_err(&interface->dev, "module get failed, exiting\n");
901 retval = type->attach (serial);
902 module_put(type->driver.owner);
906 /* quietly accept this device, but don't bind to a serial port
907 * as it's about to disappear */
912 /* register all of the individual ports with the driver core */
913 for (i = 0; i < num_ports; ++i) {
914 port = serial->port[i];
915 port->dev.parent = &interface->dev;
916 port->dev.driver = NULL;
917 port->dev.bus = &usb_serial_bus_type;
918 port->dev.release = &port_release;
920 snprintf (&port->dev.bus_id[0], sizeof(port->dev.bus_id), "ttyUSB%d", port->number);
921 dbg ("%s - registering %s", __FUNCTION__, port->dev.bus_id);
922 device_register (&port->dev);
925 usb_serial_console_init (debug, minor);
929 usb_set_intfdata (interface, serial);
933 for (i = 0; i < num_bulk_in; ++i) {
934 port = serial->port[i];
938 usb_free_urb (port->read_urb);
939 kfree(port->bulk_in_buffer);
941 for (i = 0; i < num_bulk_out; ++i) {
942 port = serial->port[i];
946 usb_free_urb (port->write_urb);
947 kfree(port->bulk_out_buffer);
949 for (i = 0; i < num_interrupt_in; ++i) {
950 port = serial->port[i];
953 if (port->interrupt_in_urb)
954 usb_free_urb (port->interrupt_in_urb);
955 kfree(port->interrupt_in_buffer);
957 for (i = 0; i < num_interrupt_out; ++i) {
958 port = serial->port[i];
961 if (port->interrupt_out_urb)
962 usb_free_urb (port->interrupt_out_urb);
963 kfree(port->interrupt_out_buffer);
966 /* return the minor range that this device had */
967 return_serial (serial);
969 /* free up any memory that we allocated */
970 for (i = 0; i < serial->num_port_pointers; ++i)
971 kfree(serial->port[i]);
976 void usb_serial_disconnect(struct usb_interface *interface)
979 struct usb_serial *serial = usb_get_intfdata (interface);
980 struct device *dev = &interface->dev;
981 struct usb_serial_port *port;
983 dbg ("%s", __FUNCTION__);
985 usb_set_intfdata (interface, NULL);
987 for (i = 0; i < serial->num_ports; ++i) {
988 port = serial->port[i];
989 if (port && port->tty)
990 tty_hangup(port->tty);
992 /* let the last holder of this object
993 * cause it to be cleaned up */
994 kref_put(&serial->kref, destroy_serial);
996 dev_info(dev, "device disconnected\n");
999 static struct tty_operations serial_ops = {
1000 .open = serial_open,
1001 .close = serial_close,
1002 .write = serial_write,
1003 .write_room = serial_write_room,
1004 .ioctl = serial_ioctl,
1005 .set_termios = serial_set_termios,
1006 .throttle = serial_throttle,
1007 .unthrottle = serial_unthrottle,
1008 .break_ctl = serial_break,
1009 .chars_in_buffer = serial_chars_in_buffer,
1010 .read_proc = serial_read_proc,
1011 .tiocmget = serial_tiocmget,
1012 .tiocmset = serial_tiocmset,
1015 struct tty_driver *usb_serial_tty_driver;
1017 static int __init usb_serial_init(void)
1022 usb_serial_tty_driver = alloc_tty_driver(SERIAL_TTY_MINORS);
1023 if (!usb_serial_tty_driver)
1026 /* Initialize our global data */
1027 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
1028 serial_table[i] = NULL;
1031 result = bus_register(&usb_serial_bus_type);
1033 err("%s - registering bus driver failed", __FUNCTION__);
1037 usb_serial_tty_driver->owner = THIS_MODULE;
1038 usb_serial_tty_driver->driver_name = "usbserial";
1039 usb_serial_tty_driver->devfs_name = "usb/tts/";
1040 usb_serial_tty_driver->name = "ttyUSB";
1041 usb_serial_tty_driver->major = SERIAL_TTY_MAJOR;
1042 usb_serial_tty_driver->minor_start = 0;
1043 usb_serial_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
1044 usb_serial_tty_driver->subtype = SERIAL_TYPE_NORMAL;
1045 usb_serial_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_NO_DEVFS;
1046 usb_serial_tty_driver->init_termios = tty_std_termios;
1047 usb_serial_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
1048 tty_set_operations(usb_serial_tty_driver, &serial_ops);
1049 result = tty_register_driver(usb_serial_tty_driver);
1051 err("%s - tty_register_driver failed", __FUNCTION__);
1052 goto exit_reg_driver;
1055 /* register the USB driver */
1056 result = usb_register(&usb_serial_driver);
1058 err("%s - usb_register failed", __FUNCTION__);
1062 /* register the generic driver, if we should */
1063 result = usb_serial_generic_register(debug);
1065 err("%s - registering generic driver failed", __FUNCTION__);
1074 usb_deregister(&usb_serial_driver);
1077 tty_unregister_driver(usb_serial_tty_driver);
1080 bus_unregister(&usb_serial_bus_type);
1083 err ("%s - returning with error %d", __FUNCTION__, result);
1084 put_tty_driver(usb_serial_tty_driver);
1089 static void __exit usb_serial_exit(void)
1091 usb_serial_console_exit();
1093 usb_serial_generic_deregister();
1095 usb_deregister(&usb_serial_driver);
1096 tty_unregister_driver(usb_serial_tty_driver);
1097 put_tty_driver(usb_serial_tty_driver);
1098 bus_unregister(&usb_serial_bus_type);
1102 module_init(usb_serial_init);
1103 module_exit(usb_serial_exit);
1105 #define set_to_generic_if_null(type, function) \
1107 if (!type->function) { \
1108 type->function = usb_serial_generic_##function; \
1109 dbg("Had to override the " #function \
1110 " usb serial operation with the generic one.");\
1114 static void fixup_generic(struct usb_serial_driver *device)
1116 set_to_generic_if_null(device, open);
1117 set_to_generic_if_null(device, write);
1118 set_to_generic_if_null(device, close);
1119 set_to_generic_if_null(device, write_room);
1120 set_to_generic_if_null(device, chars_in_buffer);
1121 set_to_generic_if_null(device, read_bulk_callback);
1122 set_to_generic_if_null(device, write_bulk_callback);
1123 set_to_generic_if_null(device, shutdown);
1126 int usb_serial_register(struct usb_serial_driver *driver)
1130 fixup_generic(driver);
1132 if (!driver->description)
1133 driver->description = driver->driver.name;
1135 /* Add this device to our list of devices */
1136 list_add(&driver->driver_list, &usb_serial_driver_list);
1138 retval = usb_serial_bus_register(driver);
1140 err("problem %d when registering driver %s", retval, driver->description);
1141 list_del(&driver->driver_list);
1144 info("USB Serial support registered for %s", driver->description);
1150 void usb_serial_deregister(struct usb_serial_driver *device)
1152 info("USB Serial deregistering driver %s", device->description);
1153 list_del(&device->driver_list);
1154 usb_serial_bus_deregister(device);
1159 /* If the usb-serial core is built into the core, the usb-serial drivers
1160 need these symbols to load properly as modules. */
1161 EXPORT_SYMBOL_GPL(usb_serial_register);
1162 EXPORT_SYMBOL_GPL(usb_serial_deregister);
1163 EXPORT_SYMBOL_GPL(usb_serial_probe);
1164 EXPORT_SYMBOL_GPL(usb_serial_disconnect);
1165 EXPORT_SYMBOL_GPL(usb_serial_port_softint);
1168 /* Module information */
1169 MODULE_AUTHOR( DRIVER_AUTHOR );
1170 MODULE_DESCRIPTION( DRIVER_DESC );
1171 MODULE_LICENSE("GPL");
1173 module_param(debug, bool, S_IRUGO | S_IWUSR);
1174 MODULE_PARM_DESC(debug, "Debug enabled or not");