USB: serial core should respect driver requirements
[linux-2.6/mini2440.git] / drivers / usb / serial / usb-serial.c
blob4b1bd7def4a5a32243753431ffd526952c017368
1 /*
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/kernel.h>
20 #include <linux/errno.h>
21 #include <linux/init.h>
22 #include <linux/slab.h>
23 #include <linux/tty.h>
24 #include <linux/tty_driver.h>
25 #include <linux/tty_flip.h>
26 #include <linux/module.h>
27 #include <linux/moduleparam.h>
28 #include <linux/spinlock.h>
29 #include <linux/mutex.h>
30 #include <linux/list.h>
31 #include <asm/uaccess.h>
32 #include <linux/usb.h>
33 #include <linux/usb/serial.h>
34 #include "pl2303.h"
37 * Version Information
39 #define DRIVER_AUTHOR "Greg Kroah-Hartman, greg@kroah.com, http://www.kroah.com/linux/"
40 #define DRIVER_DESC "USB Serial Driver core"
42 static void port_free(struct usb_serial_port *port);
44 /* Driver structure we register with the USB core */
45 static struct usb_driver usb_serial_driver = {
46 .name = "usbserial",
47 .probe = usb_serial_probe,
48 .disconnect = usb_serial_disconnect,
49 .suspend = usb_serial_suspend,
50 .resume = usb_serial_resume,
51 .no_dynamic_id = 1,
54 /* There is no MODULE_DEVICE_TABLE for usbserial.c. Instead
55 the MODULE_DEVICE_TABLE declarations in each serial driver
56 cause the "hotplug" program to pull in whatever module is necessary
57 via modprobe, and modprobe will load usbserial because the serial
58 drivers depend on it.
61 static int debug;
62 static struct usb_serial *serial_table[SERIAL_TTY_MINORS]; /* initially all NULL */
63 static DEFINE_MUTEX(table_lock);
64 static LIST_HEAD(usb_serial_driver_list);
66 struct usb_serial *usb_serial_get_by_index(unsigned index)
68 struct usb_serial *serial;
70 mutex_lock(&table_lock);
71 serial = serial_table[index];
73 if (serial)
74 kref_get(&serial->kref);
75 mutex_unlock(&table_lock);
76 return serial;
79 static struct usb_serial *get_free_serial (struct usb_serial *serial, int num_ports, unsigned int *minor)
81 unsigned int i, j;
82 int good_spot;
84 dbg("%s %d", __FUNCTION__, num_ports);
86 *minor = 0;
87 mutex_lock(&table_lock);
88 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
89 if (serial_table[i])
90 continue;
92 good_spot = 1;
93 for (j = 1; j <= num_ports-1; ++j)
94 if ((i+j >= SERIAL_TTY_MINORS) || (serial_table[i+j])) {
95 good_spot = 0;
96 i += j;
97 break;
99 if (good_spot == 0)
100 continue;
102 *minor = i;
103 j = 0;
104 dbg("%s - minor base = %d", __FUNCTION__, *minor);
105 for (i = *minor; (i < (*minor + num_ports)) && (i < SERIAL_TTY_MINORS); ++i) {
106 serial_table[i] = serial;
107 serial->port[j++]->number = i;
109 mutex_unlock(&table_lock);
110 return serial;
112 mutex_unlock(&table_lock);
113 return NULL;
116 static void return_serial(struct usb_serial *serial)
118 int i;
120 dbg("%s", __FUNCTION__);
122 if (serial == NULL)
123 return;
125 for (i = 0; i < serial->num_ports; ++i) {
126 serial_table[serial->minor + i] = NULL;
130 static void destroy_serial(struct kref *kref)
132 struct usb_serial *serial;
133 struct usb_serial_port *port;
134 int i;
136 serial = to_usb_serial(kref);
138 dbg("%s - %s", __FUNCTION__, serial->type->description);
140 serial->type->shutdown(serial);
142 /* return the minor range that this device had */
143 return_serial(serial);
145 for (i = 0; i < serial->num_ports; ++i)
146 serial->port[i]->open_count = 0;
148 /* the ports are cleaned up and released in port_release() */
149 for (i = 0; i < serial->num_ports; ++i)
150 if (serial->port[i]->dev.parent != NULL) {
151 device_unregister(&serial->port[i]->dev);
152 serial->port[i] = NULL;
155 /* If this is a "fake" port, we have to clean it up here, as it will
156 * not get cleaned up in port_release() as it was never registered with
157 * the driver core */
158 if (serial->num_ports < serial->num_port_pointers) {
159 for (i = serial->num_ports; i < serial->num_port_pointers; ++i) {
160 port = serial->port[i];
161 if (!port)
162 continue;
163 port_free(port);
167 usb_put_dev(serial->dev);
169 /* free up any memory that we allocated */
170 kfree (serial);
173 void usb_serial_put(struct usb_serial *serial)
175 mutex_lock(&table_lock);
176 kref_put(&serial->kref, destroy_serial);
177 mutex_unlock(&table_lock);
180 /*****************************************************************************
181 * Driver tty interface functions
182 *****************************************************************************/
183 static int serial_open (struct tty_struct *tty, struct file * filp)
185 struct usb_serial *serial;
186 struct usb_serial_port *port;
187 unsigned int portNumber;
188 int retval;
190 dbg("%s", __FUNCTION__);
192 /* get the serial object associated with this tty pointer */
193 serial = usb_serial_get_by_index(tty->index);
194 if (!serial) {
195 tty->driver_data = NULL;
196 return -ENODEV;
199 portNumber = tty->index - serial->minor;
200 port = serial->port[portNumber];
201 if (!port) {
202 retval = -ENODEV;
203 goto bailout_kref_put;
206 if (mutex_lock_interruptible(&port->mutex)) {
207 retval = -ERESTARTSYS;
208 goto bailout_kref_put;
211 ++port->open_count;
213 /* set up our port structure making the tty driver
214 * remember our port object, and us it */
215 tty->driver_data = port;
216 port->tty = tty;
218 if (port->open_count == 1) {
220 /* lock this module before we call it
221 * this may fail, which means we must bail out,
222 * safe because we are called with BKL held */
223 if (!try_module_get(serial->type->driver.owner)) {
224 retval = -ENODEV;
225 goto bailout_mutex_unlock;
228 /* only call the device specific open if this
229 * is the first time the port is opened */
230 retval = serial->type->open(port, filp);
231 if (retval)
232 goto bailout_module_put;
235 mutex_unlock(&port->mutex);
236 return 0;
238 bailout_module_put:
239 module_put(serial->type->driver.owner);
240 bailout_mutex_unlock:
241 port->open_count = 0;
242 tty->driver_data = NULL;
243 port->tty = NULL;
244 mutex_unlock(&port->mutex);
245 bailout_kref_put:
246 usb_serial_put(serial);
247 return retval;
250 static void serial_close(struct tty_struct *tty, struct file * filp)
252 struct usb_serial_port *port = tty->driver_data;
254 if (!port)
255 return;
257 dbg("%s - port %d", __FUNCTION__, port->number);
259 mutex_lock(&port->mutex);
261 if (port->open_count == 0) {
262 mutex_unlock(&port->mutex);
263 return;
266 --port->open_count;
267 if (port->open_count == 0) {
268 /* only call the device specific close if this
269 * port is being closed by the last owner */
270 port->serial->type->close(port, filp);
272 if (port->tty) {
273 if (port->tty->driver_data)
274 port->tty->driver_data = NULL;
275 port->tty = NULL;
278 module_put(port->serial->type->driver.owner);
281 mutex_unlock(&port->mutex);
282 usb_serial_put(port->serial);
285 static int serial_write (struct tty_struct * tty, const unsigned char *buf, int count)
287 struct usb_serial_port *port = tty->driver_data;
288 int retval = -ENODEV;
290 if (!port || port->serial->dev->state == USB_STATE_NOTATTACHED)
291 goto exit;
293 dbg("%s - port %d, %d byte(s)", __FUNCTION__, port->number, count);
295 if (!port->open_count) {
296 retval = -EINVAL;
297 dbg("%s - port not opened", __FUNCTION__);
298 goto exit;
301 /* pass on to the driver specific version of this function */
302 retval = port->serial->type->write(port, buf, count);
304 exit:
305 return retval;
308 static int serial_write_room (struct tty_struct *tty)
310 struct usb_serial_port *port = tty->driver_data;
311 int retval = -ENODEV;
313 if (!port)
314 goto exit;
316 dbg("%s - port %d", __FUNCTION__, port->number);
318 if (!port->open_count) {
319 dbg("%s - port not open", __FUNCTION__);
320 goto exit;
323 /* pass on to the driver specific version of this function */
324 retval = port->serial->type->write_room(port);
326 exit:
327 return retval;
330 static int serial_chars_in_buffer (struct tty_struct *tty)
332 struct usb_serial_port *port = tty->driver_data;
333 int retval = -ENODEV;
335 if (!port)
336 goto exit;
338 dbg("%s = port %d", __FUNCTION__, port->number);
340 if (!port->open_count) {
341 dbg("%s - port not open", __FUNCTION__);
342 goto exit;
345 /* pass on to the driver specific version of this function */
346 retval = port->serial->type->chars_in_buffer(port);
348 exit:
349 return retval;
352 static void serial_throttle (struct tty_struct * tty)
354 struct usb_serial_port *port = tty->driver_data;
356 if (!port)
357 return;
359 dbg("%s - port %d", __FUNCTION__, port->number);
361 if (!port->open_count) {
362 dbg ("%s - port not open", __FUNCTION__);
363 return;
366 /* pass on to the driver specific version of this function */
367 if (port->serial->type->throttle)
368 port->serial->type->throttle(port);
371 static void serial_unthrottle (struct tty_struct * tty)
373 struct usb_serial_port *port = tty->driver_data;
375 if (!port)
376 return;
378 dbg("%s - port %d", __FUNCTION__, port->number);
380 if (!port->open_count) {
381 dbg("%s - port not open", __FUNCTION__);
382 return;
385 /* pass on to the driver specific version of this function */
386 if (port->serial->type->unthrottle)
387 port->serial->type->unthrottle(port);
390 static int serial_ioctl (struct tty_struct *tty, struct file * file, unsigned int cmd, unsigned long arg)
392 struct usb_serial_port *port = tty->driver_data;
393 int retval = -ENODEV;
395 if (!port)
396 goto exit;
398 dbg("%s - port %d, cmd 0x%.4x", __FUNCTION__, port->number, cmd);
400 if (!port->open_count) {
401 dbg ("%s - port not open", __FUNCTION__);
402 goto exit;
405 /* pass on to the driver specific version of this function if it is available */
406 if (port->serial->type->ioctl)
407 retval = port->serial->type->ioctl(port, file, cmd, arg);
408 else
409 retval = -ENOIOCTLCMD;
411 exit:
412 return retval;
415 static void serial_set_termios (struct tty_struct *tty, struct ktermios * old)
417 struct usb_serial_port *port = tty->driver_data;
419 if (!port)
420 return;
422 dbg("%s - port %d", __FUNCTION__, port->number);
424 if (!port->open_count) {
425 dbg("%s - port not open", __FUNCTION__);
426 return;
429 /* pass on to the driver specific version of this function if it is available */
430 if (port->serial->type->set_termios)
431 port->serial->type->set_termios(port, old);
434 static void serial_break (struct tty_struct *tty, int break_state)
436 struct usb_serial_port *port = tty->driver_data;
438 if (!port)
439 return;
441 dbg("%s - port %d", __FUNCTION__, port->number);
443 if (!port->open_count) {
444 dbg("%s - port not open", __FUNCTION__);
445 return;
448 /* pass on to the driver specific version of this function if it is available */
449 if (port->serial->type->break_ctl)
450 port->serial->type->break_ctl(port, break_state);
453 static int serial_read_proc (char *page, char **start, off_t off, int count, int *eof, void *data)
455 struct usb_serial *serial;
456 int length = 0;
457 int i;
458 off_t begin = 0;
459 char tmp[40];
461 dbg("%s", __FUNCTION__);
462 length += sprintf (page, "usbserinfo:1.0 driver:2.0\n");
463 for (i = 0; i < SERIAL_TTY_MINORS && length < PAGE_SIZE; ++i) {
464 serial = usb_serial_get_by_index(i);
465 if (serial == NULL)
466 continue;
468 length += sprintf (page+length, "%d:", i);
469 if (serial->type->driver.owner)
470 length += sprintf (page+length, " module:%s", module_name(serial->type->driver.owner));
471 length += sprintf (page+length, " name:\"%s\"", serial->type->description);
472 length += sprintf (page+length, " vendor:%04x product:%04x",
473 le16_to_cpu(serial->dev->descriptor.idVendor),
474 le16_to_cpu(serial->dev->descriptor.idProduct));
475 length += sprintf (page+length, " num_ports:%d", serial->num_ports);
476 length += sprintf (page+length, " port:%d", i - serial->minor + 1);
478 usb_make_path(serial->dev, tmp, sizeof(tmp));
479 length += sprintf (page+length, " path:%s", tmp);
481 length += sprintf (page+length, "\n");
482 if ((length + begin) > (off + count)) {
483 usb_serial_put(serial);
484 goto done;
486 if ((length + begin) < off) {
487 begin += length;
488 length = 0;
490 usb_serial_put(serial);
492 *eof = 1;
493 done:
494 if (off >= (length + begin))
495 return 0;
496 *start = page + (off-begin);
497 return ((count < begin+length-off) ? count : begin+length-off);
500 static int serial_tiocmget (struct tty_struct *tty, struct file *file)
502 struct usb_serial_port *port = tty->driver_data;
504 if (!port)
505 return -ENODEV;
507 dbg("%s - port %d", __FUNCTION__, port->number);
509 if (!port->open_count) {
510 dbg("%s - port not open", __FUNCTION__);
511 return -ENODEV;
514 if (port->serial->type->tiocmget)
515 return port->serial->type->tiocmget(port, file);
517 return -EINVAL;
520 static int serial_tiocmset (struct tty_struct *tty, struct file *file,
521 unsigned int set, unsigned int clear)
523 struct usb_serial_port *port = tty->driver_data;
525 if (!port)
526 return -ENODEV;
528 dbg("%s - port %d", __FUNCTION__, port->number);
530 if (!port->open_count) {
531 dbg("%s - port not open", __FUNCTION__);
532 return -ENODEV;
535 if (port->serial->type->tiocmset)
536 return port->serial->type->tiocmset(port, file, set, clear);
538 return -EINVAL;
542 * We would be calling tty_wakeup here, but unfortunately some line
543 * disciplines have an annoying habit of calling tty->write from
544 * the write wakeup callback (e.g. n_hdlc.c).
546 void usb_serial_port_softint(struct usb_serial_port *port)
548 schedule_work(&port->work);
551 static void usb_serial_port_work(struct work_struct *work)
553 struct usb_serial_port *port =
554 container_of(work, struct usb_serial_port, work);
555 struct tty_struct *tty;
557 dbg("%s - port %d", __FUNCTION__, port->number);
559 if (!port)
560 return;
562 tty = port->tty;
563 if (!tty)
564 return;
566 tty_wakeup(tty);
569 static void port_release(struct device *dev)
571 struct usb_serial_port *port = to_usb_serial_port(dev);
573 dbg ("%s - %s", __FUNCTION__, dev->bus_id);
574 port_free(port);
577 static void kill_traffic(struct usb_serial_port *port)
579 usb_kill_urb(port->read_urb);
580 usb_kill_urb(port->write_urb);
582 * This is tricky.
583 * Some drivers submit the read_urb in the
584 * handler for the write_urb or vice versa
585 * this order determines the order in which
586 * usb_kill_urb() must be used to reliably
587 * kill the URBs. As it is unknown here,
588 * both orders must be used in turn.
589 * The call below is not redundant.
591 usb_kill_urb(port->read_urb);
592 usb_kill_urb(port->interrupt_in_urb);
593 usb_kill_urb(port->interrupt_out_urb);
596 static void port_free(struct usb_serial_port *port)
598 kill_traffic(port);
599 usb_free_urb(port->read_urb);
600 usb_free_urb(port->write_urb);
601 usb_free_urb(port->interrupt_in_urb);
602 usb_free_urb(port->interrupt_out_urb);
603 kfree(port->bulk_in_buffer);
604 kfree(port->bulk_out_buffer);
605 kfree(port->interrupt_in_buffer);
606 kfree(port->interrupt_out_buffer);
607 flush_scheduled_work(); /* port->work */
608 kfree(port);
611 static struct usb_serial * create_serial (struct usb_device *dev,
612 struct usb_interface *interface,
613 struct usb_serial_driver *driver)
615 struct usb_serial *serial;
617 serial = kzalloc(sizeof(*serial), GFP_KERNEL);
618 if (!serial) {
619 dev_err(&dev->dev, "%s - out of memory\n", __FUNCTION__);
620 return NULL;
622 serial->dev = usb_get_dev(dev);
623 serial->type = driver;
624 serial->interface = interface;
625 kref_init(&serial->kref);
627 return serial;
630 static const struct usb_device_id *match_dynamic_id(struct usb_interface *intf,
631 struct usb_serial_driver *drv)
633 struct usb_dynid *dynid;
635 spin_lock(&drv->dynids.lock);
636 list_for_each_entry(dynid, &drv->dynids.list, node) {
637 if (usb_match_one_id(intf, &dynid->id)) {
638 spin_unlock(&drv->dynids.lock);
639 return &dynid->id;
642 spin_unlock(&drv->dynids.lock);
643 return NULL;
646 static const struct usb_device_id *get_iface_id(struct usb_serial_driver *drv,
647 struct usb_interface *intf)
649 const struct usb_device_id *id;
651 id = usb_match_id(intf, drv->id_table);
652 if (id) {
653 dbg("static descriptor matches");
654 goto exit;
656 id = match_dynamic_id(intf, drv);
657 if (id)
658 dbg("dynamic descriptor matches");
659 exit:
660 return id;
663 static struct usb_serial_driver *search_serial_device(struct usb_interface *iface)
665 const struct usb_device_id *id;
666 struct usb_serial_driver *drv;
668 /* Check if the usb id matches a known device */
669 list_for_each_entry(drv, &usb_serial_driver_list, driver_list) {
670 id = get_iface_id(drv, iface);
671 if (id)
672 return drv;
675 return NULL;
678 int usb_serial_probe(struct usb_interface *interface,
679 const struct usb_device_id *id)
681 struct usb_device *dev = interface_to_usbdev (interface);
682 struct usb_serial *serial = NULL;
683 struct usb_serial_port *port;
684 struct usb_host_interface *iface_desc;
685 struct usb_endpoint_descriptor *endpoint;
686 struct usb_endpoint_descriptor *interrupt_in_endpoint[MAX_NUM_PORTS];
687 struct usb_endpoint_descriptor *interrupt_out_endpoint[MAX_NUM_PORTS];
688 struct usb_endpoint_descriptor *bulk_in_endpoint[MAX_NUM_PORTS];
689 struct usb_endpoint_descriptor *bulk_out_endpoint[MAX_NUM_PORTS];
690 struct usb_serial_driver *type = NULL;
691 int retval;
692 int minor;
693 int buffer_size;
694 int i;
695 int num_interrupt_in = 0;
696 int num_interrupt_out = 0;
697 int num_bulk_in = 0;
698 int num_bulk_out = 0;
699 int num_ports = 0;
700 int max_endpoints;
702 lock_kernel(); /* guard against unloading a serial driver module */
703 type = search_serial_device(interface);
704 if (!type) {
705 unlock_kernel();
706 dbg("none matched");
707 return -ENODEV;
710 serial = create_serial (dev, interface, type);
711 if (!serial) {
712 unlock_kernel();
713 dev_err(&interface->dev, "%s - out of memory\n", __FUNCTION__);
714 return -ENOMEM;
717 /* if this device type has a probe function, call it */
718 if (type->probe) {
719 const struct usb_device_id *id;
721 if (!try_module_get(type->driver.owner)) {
722 unlock_kernel();
723 dev_err(&interface->dev, "module get failed, exiting\n");
724 kfree (serial);
725 return -EIO;
728 id = get_iface_id(type, interface);
729 retval = type->probe(serial, id);
730 module_put(type->driver.owner);
732 if (retval) {
733 unlock_kernel();
734 dbg ("sub driver rejected device");
735 kfree (serial);
736 return retval;
740 /* descriptor matches, let's find the endpoints needed */
741 /* check out the endpoints */
742 iface_desc = interface->cur_altsetting;
743 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
744 endpoint = &iface_desc->endpoint[i].desc;
746 if (usb_endpoint_is_bulk_in(endpoint)) {
747 /* we found a bulk in endpoint */
748 dbg("found bulk in on endpoint %d", i);
749 bulk_in_endpoint[num_bulk_in] = endpoint;
750 ++num_bulk_in;
753 if (usb_endpoint_is_bulk_out(endpoint)) {
754 /* we found a bulk out endpoint */
755 dbg("found bulk out on endpoint %d", i);
756 bulk_out_endpoint[num_bulk_out] = endpoint;
757 ++num_bulk_out;
760 if (usb_endpoint_is_int_in(endpoint)) {
761 /* we found a interrupt in endpoint */
762 dbg("found interrupt in on endpoint %d", i);
763 interrupt_in_endpoint[num_interrupt_in] = endpoint;
764 ++num_interrupt_in;
767 if (usb_endpoint_is_int_out(endpoint)) {
768 /* we found an interrupt out endpoint */
769 dbg("found interrupt out on endpoint %d", i);
770 interrupt_out_endpoint[num_interrupt_out] = endpoint;
771 ++num_interrupt_out;
775 #if defined(CONFIG_USB_SERIAL_PL2303) || defined(CONFIG_USB_SERIAL_PL2303_MODULE)
776 /* BEGIN HORRIBLE HACK FOR PL2303 */
777 /* this is needed due to the looney way its endpoints are set up */
778 if (((le16_to_cpu(dev->descriptor.idVendor) == PL2303_VENDOR_ID) &&
779 (le16_to_cpu(dev->descriptor.idProduct) == PL2303_PRODUCT_ID)) ||
780 ((le16_to_cpu(dev->descriptor.idVendor) == ATEN_VENDOR_ID) &&
781 (le16_to_cpu(dev->descriptor.idProduct) == ATEN_PRODUCT_ID)) ||
782 ((le16_to_cpu(dev->descriptor.idVendor) == ALCOR_VENDOR_ID) &&
783 (le16_to_cpu(dev->descriptor.idProduct) == ALCOR_PRODUCT_ID))) {
784 if (interface != dev->actconfig->interface[0]) {
785 /* check out the endpoints of the other interface*/
786 iface_desc = dev->actconfig->interface[0]->cur_altsetting;
787 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
788 endpoint = &iface_desc->endpoint[i].desc;
789 if (usb_endpoint_is_int_in(endpoint)) {
790 /* we found a interrupt in endpoint */
791 dbg("found interrupt in for Prolific device on separate interface");
792 interrupt_in_endpoint[num_interrupt_in] = endpoint;
793 ++num_interrupt_in;
798 /* Now make sure the PL-2303 is configured correctly.
799 * If not, give up now and hope this hack will work
800 * properly during a later invocation of usb_serial_probe
802 if (num_bulk_in == 0 || num_bulk_out == 0) {
803 unlock_kernel();
804 dev_info(&interface->dev, "PL-2303 hack: descriptors matched but endpoints did not\n");
805 kfree (serial);
806 return -ENODEV;
809 /* END HORRIBLE HACK FOR PL2303 */
810 #endif
812 #ifdef CONFIG_USB_SERIAL_GENERIC
813 if (type == &usb_serial_generic_device) {
814 num_ports = num_bulk_out;
815 if (num_ports == 0) {
816 unlock_kernel();
817 dev_err(&interface->dev, "Generic device with no bulk out, not allowed.\n");
818 kfree (serial);
819 return -EIO;
822 #endif
823 if (!num_ports) {
824 /* if this device type has a calc_num_ports function, call it */
825 if (type->calc_num_ports) {
826 if (!try_module_get(type->driver.owner)) {
827 unlock_kernel();
828 dev_err(&interface->dev, "module get failed, exiting\n");
829 kfree (serial);
830 return -EIO;
832 num_ports = type->calc_num_ports (serial);
833 module_put(type->driver.owner);
835 if (!num_ports)
836 num_ports = type->num_ports;
839 serial->num_ports = num_ports;
840 serial->num_bulk_in = num_bulk_in;
841 serial->num_bulk_out = num_bulk_out;
842 serial->num_interrupt_in = num_interrupt_in;
843 serial->num_interrupt_out = num_interrupt_out;
845 /* check that the device meets the driver's requirements */
846 if ((type->num_interrupt_in != NUM_DONT_CARE &&
847 type->num_interrupt_in != num_interrupt_in)
848 || (type->num_interrupt_out != NUM_DONT_CARE &&
849 type->num_interrupt_out != num_interrupt_out)
850 || (type->num_bulk_in != NUM_DONT_CARE &&
851 type->num_bulk_in != num_bulk_in)
852 || (type->num_bulk_out != NUM_DONT_CARE &&
853 type->num_bulk_out != num_bulk_out)) {
854 dbg("wrong number of endpoints");
855 kfree(serial);
856 return -EIO;
859 /* found all that we need */
860 dev_info(&interface->dev, "%s converter detected\n",
861 type->description);
863 /* create our ports, we need as many as the max endpoints */
864 /* we don't use num_ports here cauz some devices have more endpoint pairs than ports */
865 max_endpoints = max(num_bulk_in, num_bulk_out);
866 max_endpoints = max(max_endpoints, num_interrupt_in);
867 max_endpoints = max(max_endpoints, num_interrupt_out);
868 max_endpoints = max(max_endpoints, (int)serial->num_ports);
869 serial->num_port_pointers = max_endpoints;
870 unlock_kernel();
872 dbg("%s - setting up %d port structures for this device", __FUNCTION__, max_endpoints);
873 for (i = 0; i < max_endpoints; ++i) {
874 port = kzalloc(sizeof(struct usb_serial_port), GFP_KERNEL);
875 if (!port)
876 goto probe_error;
877 port->serial = serial;
878 spin_lock_init(&port->lock);
879 mutex_init(&port->mutex);
880 INIT_WORK(&port->work, usb_serial_port_work);
881 serial->port[i] = port;
884 /* set up the endpoint information */
885 for (i = 0; i < num_bulk_in; ++i) {
886 endpoint = bulk_in_endpoint[i];
887 port = serial->port[i];
888 port->read_urb = usb_alloc_urb (0, GFP_KERNEL);
889 if (!port->read_urb) {
890 dev_err(&interface->dev, "No free urbs available\n");
891 goto probe_error;
893 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
894 port->bulk_in_size = buffer_size;
895 port->bulk_in_endpointAddress = endpoint->bEndpointAddress;
896 port->bulk_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
897 if (!port->bulk_in_buffer) {
898 dev_err(&interface->dev, "Couldn't allocate bulk_in_buffer\n");
899 goto probe_error;
901 usb_fill_bulk_urb (port->read_urb, dev,
902 usb_rcvbulkpipe (dev,
903 endpoint->bEndpointAddress),
904 port->bulk_in_buffer, buffer_size,
905 serial->type->read_bulk_callback,
906 port);
909 for (i = 0; i < num_bulk_out; ++i) {
910 endpoint = bulk_out_endpoint[i];
911 port = serial->port[i];
912 port->write_urb = usb_alloc_urb(0, GFP_KERNEL);
913 if (!port->write_urb) {
914 dev_err(&interface->dev, "No free urbs available\n");
915 goto probe_error;
917 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
918 port->bulk_out_size = buffer_size;
919 port->bulk_out_endpointAddress = endpoint->bEndpointAddress;
920 port->bulk_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
921 if (!port->bulk_out_buffer) {
922 dev_err(&interface->dev, "Couldn't allocate bulk_out_buffer\n");
923 goto probe_error;
925 usb_fill_bulk_urb (port->write_urb, dev,
926 usb_sndbulkpipe (dev,
927 endpoint->bEndpointAddress),
928 port->bulk_out_buffer, buffer_size,
929 serial->type->write_bulk_callback,
930 port);
933 if (serial->type->read_int_callback) {
934 for (i = 0; i < num_interrupt_in; ++i) {
935 endpoint = interrupt_in_endpoint[i];
936 port = serial->port[i];
937 port->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
938 if (!port->interrupt_in_urb) {
939 dev_err(&interface->dev, "No free urbs available\n");
940 goto probe_error;
942 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
943 port->interrupt_in_endpointAddress = endpoint->bEndpointAddress;
944 port->interrupt_in_buffer = kmalloc (buffer_size, GFP_KERNEL);
945 if (!port->interrupt_in_buffer) {
946 dev_err(&interface->dev, "Couldn't allocate interrupt_in_buffer\n");
947 goto probe_error;
949 usb_fill_int_urb (port->interrupt_in_urb, dev,
950 usb_rcvintpipe (dev,
951 endpoint->bEndpointAddress),
952 port->interrupt_in_buffer, buffer_size,
953 serial->type->read_int_callback, port,
954 endpoint->bInterval);
956 } else if (num_interrupt_in) {
957 dbg("the device claims to support interrupt in transfers, but read_int_callback is not defined");
960 if (serial->type->write_int_callback) {
961 for (i = 0; i < num_interrupt_out; ++i) {
962 endpoint = interrupt_out_endpoint[i];
963 port = serial->port[i];
964 port->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
965 if (!port->interrupt_out_urb) {
966 dev_err(&interface->dev, "No free urbs available\n");
967 goto probe_error;
969 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
970 port->interrupt_out_size = buffer_size;
971 port->interrupt_out_endpointAddress = endpoint->bEndpointAddress;
972 port->interrupt_out_buffer = kmalloc (buffer_size, GFP_KERNEL);
973 if (!port->interrupt_out_buffer) {
974 dev_err(&interface->dev, "Couldn't allocate interrupt_out_buffer\n");
975 goto probe_error;
977 usb_fill_int_urb (port->interrupt_out_urb, dev,
978 usb_sndintpipe (dev,
979 endpoint->bEndpointAddress),
980 port->interrupt_out_buffer, buffer_size,
981 serial->type->write_int_callback, port,
982 endpoint->bInterval);
984 } else if (num_interrupt_out) {
985 dbg("the device claims to support interrupt out transfers, but write_int_callback is not defined");
988 /* if this device type has an attach function, call it */
989 if (type->attach) {
990 if (!try_module_get(type->driver.owner)) {
991 dev_err(&interface->dev, "module get failed, exiting\n");
992 goto probe_error;
994 retval = type->attach (serial);
995 module_put(type->driver.owner);
996 if (retval < 0)
997 goto probe_error;
998 if (retval > 0) {
999 /* quietly accept this device, but don't bind to a serial port
1000 * as it's about to disappear */
1001 goto exit;
1005 if (get_free_serial (serial, num_ports, &minor) == NULL) {
1006 dev_err(&interface->dev, "No more free serial devices\n");
1007 goto probe_error;
1009 serial->minor = minor;
1011 /* register all of the individual ports with the driver core */
1012 for (i = 0; i < num_ports; ++i) {
1013 port = serial->port[i];
1014 port->dev.parent = &interface->dev;
1015 port->dev.driver = NULL;
1016 port->dev.bus = &usb_serial_bus_type;
1017 port->dev.release = &port_release;
1019 snprintf (&port->dev.bus_id[0], sizeof(port->dev.bus_id), "ttyUSB%d", port->number);
1020 dbg ("%s - registering %s", __FUNCTION__, port->dev.bus_id);
1021 retval = device_register(&port->dev);
1022 if (retval)
1023 dev_err(&port->dev, "Error registering port device, "
1024 "continuing\n");
1027 usb_serial_console_init (debug, minor);
1029 exit:
1030 /* success */
1031 usb_set_intfdata (interface, serial);
1032 return 0;
1034 probe_error:
1035 for (i = 0; i < num_bulk_in; ++i) {
1036 port = serial->port[i];
1037 if (!port)
1038 continue;
1039 usb_free_urb(port->read_urb);
1040 kfree(port->bulk_in_buffer);
1042 for (i = 0; i < num_bulk_out; ++i) {
1043 port = serial->port[i];
1044 if (!port)
1045 continue;
1046 usb_free_urb(port->write_urb);
1047 kfree(port->bulk_out_buffer);
1049 for (i = 0; i < num_interrupt_in; ++i) {
1050 port = serial->port[i];
1051 if (!port)
1052 continue;
1053 usb_free_urb(port->interrupt_in_urb);
1054 kfree(port->interrupt_in_buffer);
1056 for (i = 0; i < num_interrupt_out; ++i) {
1057 port = serial->port[i];
1058 if (!port)
1059 continue;
1060 usb_free_urb(port->interrupt_out_urb);
1061 kfree(port->interrupt_out_buffer);
1064 /* free up any memory that we allocated */
1065 for (i = 0; i < serial->num_port_pointers; ++i)
1066 kfree(serial->port[i]);
1067 kfree (serial);
1068 return -EIO;
1071 void usb_serial_disconnect(struct usb_interface *interface)
1073 int i;
1074 struct usb_serial *serial = usb_get_intfdata (interface);
1075 struct device *dev = &interface->dev;
1076 struct usb_serial_port *port;
1078 usb_serial_console_disconnect(serial);
1079 dbg ("%s", __FUNCTION__);
1081 usb_set_intfdata (interface, NULL);
1082 if (serial) {
1083 for (i = 0; i < serial->num_ports; ++i) {
1084 port = serial->port[i];
1085 if (port) {
1086 if (port->tty)
1087 tty_hangup(port->tty);
1088 kill_traffic(port);
1091 /* let the last holder of this object
1092 * cause it to be cleaned up */
1093 usb_serial_put(serial);
1095 dev_info(dev, "device disconnected\n");
1098 int usb_serial_suspend(struct usb_interface *intf, pm_message_t message)
1100 struct usb_serial *serial = usb_get_intfdata(intf);
1101 struct usb_serial_port *port;
1102 int i, r = 0;
1104 if (!serial) /* device has been disconnected */
1105 return 0;
1107 for (i = 0; i < serial->num_ports; ++i) {
1108 port = serial->port[i];
1109 if (port)
1110 kill_traffic(port);
1113 if (serial->type->suspend)
1114 r = serial->type->suspend(serial, message);
1116 return r;
1118 EXPORT_SYMBOL(usb_serial_suspend);
1120 int usb_serial_resume(struct usb_interface *intf)
1122 struct usb_serial *serial = usb_get_intfdata(intf);
1124 return serial->type->resume(serial);
1126 EXPORT_SYMBOL(usb_serial_resume);
1128 static const struct tty_operations serial_ops = {
1129 .open = serial_open,
1130 .close = serial_close,
1131 .write = serial_write,
1132 .write_room = serial_write_room,
1133 .ioctl = serial_ioctl,
1134 .set_termios = serial_set_termios,
1135 .throttle = serial_throttle,
1136 .unthrottle = serial_unthrottle,
1137 .break_ctl = serial_break,
1138 .chars_in_buffer = serial_chars_in_buffer,
1139 .read_proc = serial_read_proc,
1140 .tiocmget = serial_tiocmget,
1141 .tiocmset = serial_tiocmset,
1144 struct tty_driver *usb_serial_tty_driver;
1146 static int __init usb_serial_init(void)
1148 int i;
1149 int result;
1151 usb_serial_tty_driver = alloc_tty_driver(SERIAL_TTY_MINORS);
1152 if (!usb_serial_tty_driver)
1153 return -ENOMEM;
1155 /* Initialize our global data */
1156 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
1157 serial_table[i] = NULL;
1160 result = bus_register(&usb_serial_bus_type);
1161 if (result) {
1162 err("%s - registering bus driver failed", __FUNCTION__);
1163 goto exit_bus;
1166 usb_serial_tty_driver->owner = THIS_MODULE;
1167 usb_serial_tty_driver->driver_name = "usbserial";
1168 usb_serial_tty_driver->name = "ttyUSB";
1169 usb_serial_tty_driver->major = SERIAL_TTY_MAJOR;
1170 usb_serial_tty_driver->minor_start = 0;
1171 usb_serial_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
1172 usb_serial_tty_driver->subtype = SERIAL_TYPE_NORMAL;
1173 usb_serial_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_DYNAMIC_DEV;
1174 usb_serial_tty_driver->init_termios = tty_std_termios;
1175 usb_serial_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
1176 tty_set_operations(usb_serial_tty_driver, &serial_ops);
1177 result = tty_register_driver(usb_serial_tty_driver);
1178 if (result) {
1179 err("%s - tty_register_driver failed", __FUNCTION__);
1180 goto exit_reg_driver;
1183 /* register the USB driver */
1184 result = usb_register(&usb_serial_driver);
1185 if (result < 0) {
1186 err("%s - usb_register failed", __FUNCTION__);
1187 goto exit_tty;
1190 /* register the generic driver, if we should */
1191 result = usb_serial_generic_register(debug);
1192 if (result < 0) {
1193 err("%s - registering generic driver failed", __FUNCTION__);
1194 goto exit_generic;
1197 info(DRIVER_DESC);
1199 return result;
1201 exit_generic:
1202 usb_deregister(&usb_serial_driver);
1204 exit_tty:
1205 tty_unregister_driver(usb_serial_tty_driver);
1207 exit_reg_driver:
1208 bus_unregister(&usb_serial_bus_type);
1210 exit_bus:
1211 err ("%s - returning with error %d", __FUNCTION__, result);
1212 put_tty_driver(usb_serial_tty_driver);
1213 return result;
1217 static void __exit usb_serial_exit(void)
1219 usb_serial_console_exit();
1221 usb_serial_generic_deregister();
1223 usb_deregister(&usb_serial_driver);
1224 tty_unregister_driver(usb_serial_tty_driver);
1225 put_tty_driver(usb_serial_tty_driver);
1226 bus_unregister(&usb_serial_bus_type);
1230 module_init(usb_serial_init);
1231 module_exit(usb_serial_exit);
1233 #define set_to_generic_if_null(type, function) \
1234 do { \
1235 if (!type->function) { \
1236 type->function = usb_serial_generic_##function; \
1237 dbg("Had to override the " #function \
1238 " usb serial operation with the generic one.");\
1240 } while (0)
1242 static void fixup_generic(struct usb_serial_driver *device)
1244 set_to_generic_if_null(device, open);
1245 set_to_generic_if_null(device, write);
1246 set_to_generic_if_null(device, close);
1247 set_to_generic_if_null(device, write_room);
1248 set_to_generic_if_null(device, chars_in_buffer);
1249 set_to_generic_if_null(device, read_bulk_callback);
1250 set_to_generic_if_null(device, write_bulk_callback);
1251 set_to_generic_if_null(device, shutdown);
1254 int usb_serial_register(struct usb_serial_driver *driver) /* must be called with BKL held */
1256 int retval;
1258 fixup_generic(driver);
1260 if (!driver->description)
1261 driver->description = driver->driver.name;
1263 /* Add this device to our list of devices */
1264 list_add(&driver->driver_list, &usb_serial_driver_list);
1266 retval = usb_serial_bus_register(driver);
1267 if (retval) {
1268 err("problem %d when registering driver %s", retval, driver->description);
1269 list_del(&driver->driver_list);
1271 else
1272 info("USB Serial support registered for %s", driver->description);
1274 return retval;
1278 void usb_serial_deregister(struct usb_serial_driver *device) /* must be called with BKL held */
1280 info("USB Serial deregistering driver %s", device->description);
1281 list_del(&device->driver_list);
1282 usb_serial_bus_deregister(device);
1287 /* If the usb-serial core is built into the core, the usb-serial drivers
1288 need these symbols to load properly as modules. */
1289 EXPORT_SYMBOL_GPL(usb_serial_register);
1290 EXPORT_SYMBOL_GPL(usb_serial_deregister);
1291 EXPORT_SYMBOL_GPL(usb_serial_probe);
1292 EXPORT_SYMBOL_GPL(usb_serial_disconnect);
1293 EXPORT_SYMBOL_GPL(usb_serial_port_softint);
1296 /* Module information */
1297 MODULE_AUTHOR( DRIVER_AUTHOR );
1298 MODULE_DESCRIPTION( DRIVER_DESC );
1299 MODULE_LICENSE("GPL");
1301 module_param(debug, bool, S_IRUGO | S_IWUSR);
1302 MODULE_PARM_DESC(debug, "Debug enabled or not");