]> git.proxmox.com Git - mirror_ubuntu-hirsute-kernel.git/blame - drivers/usb/serial/usb-serial.c
USB: pl2303: fix abuse of interface data
[mirror_ubuntu-hirsute-kernel.git] / drivers / usb / serial / usb-serial.c
CommitLineData
1da177e4
LT
1/*
2 * USB Serial Converter driver
3 *
502b95c1 4 * Copyright (C) 1999 - 2005 Greg Kroah-Hartman (greg@kroah.com)
1da177e4
LT
5 * Copyright (C) 2000 Peter Berger (pberger@brimson.com)
6 * Copyright (C) 2000 Al Borchers (borchers@steinerpoint.com)
7 *
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.
11 *
502b95c1 12 * This driver was originally based on the ACM driver by Armin Fuerst (which was
1da177e4
LT
13 * based on a driver by Brad Keryan)
14 *
a8d6f0a9
AC
15 * See Documentation/usb/usb-serial.txt for more information on using this
16 * driver
1da177e4 17 *
1da177e4
LT
18 */
19
1da177e4
LT
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>
6fd69d3c 29#include <linux/seq_file.h>
1da177e4 30#include <linux/spinlock.h>
1ce7dd26 31#include <linux/mutex.h>
1da177e4 32#include <linux/list.h>
a8d6f0a9 33#include <linux/uaccess.h>
c56d3000 34#include <linux/serial.h>
1da177e4 35#include <linux/usb.h>
a969888c 36#include <linux/usb/serial.h>
8e8dce06 37#include <linux/kfifo.h>
1da177e4
LT
38#include "pl2303.h"
39
40/*
41 * Version Information
42 */
1da177e4
LT
43#define DRIVER_AUTHOR "Greg Kroah-Hartman, greg@kroah.com, http://www.kroah.com/linux/"
44#define DRIVER_DESC "USB Serial Driver core"
45
46/* Driver structure we register with the USB core */
47static struct usb_driver usb_serial_driver = {
1da177e4
LT
48 .name = "usbserial",
49 .probe = usb_serial_probe,
50 .disconnect = usb_serial_disconnect,
ec22559e
ON
51 .suspend = usb_serial_suspend,
52 .resume = usb_serial_resume,
3e1f4901 53 .no_dynamic_id = 1,
abf03184 54 .supports_autosuspend = 1,
1da177e4
LT
55};
56
57/* There is no MODULE_DEVICE_TABLE for usbserial.c. Instead
58 the MODULE_DEVICE_TABLE declarations in each serial driver
59 cause the "hotplug" program to pull in whatever module is necessary
60 via modprobe, and modprobe will load usbserial because the serial
61 drivers depend on it.
62*/
63
90ab5ee9 64static bool debug;
a8d6f0a9
AC
65/* initially all NULL */
66static struct usb_serial *serial_table[SERIAL_TTY_MINORS];
3ddad823 67static DEFINE_MUTEX(table_lock);
1da177e4
LT
68static LIST_HEAD(usb_serial_driver_list);
69
8bc2c1b2
AS
70/*
71 * Look up the serial structure. If it is found and it hasn't been
72 * disconnected, return with its disc_mutex held and its refcount
73 * incremented. Otherwise return NULL.
74 */
1da177e4
LT
75struct usb_serial *usb_serial_get_by_index(unsigned index)
76{
34ef50e5
ON
77 struct usb_serial *serial;
78
3ddad823 79 mutex_lock(&table_lock);
34ef50e5 80 serial = serial_table[index];
1da177e4 81
8bc2c1b2
AS
82 if (serial) {
83 mutex_lock(&serial->disc_mutex);
84 if (serial->disconnected) {
85 mutex_unlock(&serial->disc_mutex);
86 serial = NULL;
87 } else {
88 kref_get(&serial->kref);
89 }
90 }
3ddad823 91 mutex_unlock(&table_lock);
1da177e4
LT
92 return serial;
93}
94
a8d6f0a9
AC
95static struct usb_serial *get_free_serial(struct usb_serial *serial,
96 int num_ports, unsigned int *minor)
1da177e4
LT
97{
98 unsigned int i, j;
99 int good_spot;
100
441b62c1 101 dbg("%s %d", __func__, num_ports);
1da177e4
LT
102
103 *minor = 0;
3ddad823 104 mutex_lock(&table_lock);
1da177e4
LT
105 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
106 if (serial_table[i])
107 continue;
108
109 good_spot = 1;
110 for (j = 1; j <= num_ports-1; ++j)
111 if ((i+j >= SERIAL_TTY_MINORS) || (serial_table[i+j])) {
112 good_spot = 0;
113 i += j;
114 break;
115 }
116 if (good_spot == 0)
117 continue;
118
119 *minor = i;
a1f721c8 120 j = 0;
441b62c1 121 dbg("%s - minor base = %d", __func__, *minor);
a1f721c8 122 for (i = *minor; (i < (*minor + num_ports)) && (i < SERIAL_TTY_MINORS); ++i) {
1da177e4 123 serial_table[i] = serial;
a1f721c8
ON
124 serial->port[j++]->number = i;
125 }
3ddad823 126 mutex_unlock(&table_lock);
1da177e4
LT
127 return serial;
128 }
3ddad823 129 mutex_unlock(&table_lock);
1da177e4
LT
130 return NULL;
131}
132
133static void return_serial(struct usb_serial *serial)
134{
135 int i;
136
441b62c1 137 dbg("%s", __func__);
1da177e4 138
8bc2c1b2 139 mutex_lock(&table_lock);
a8d6f0a9 140 for (i = 0; i < serial->num_ports; ++i)
1da177e4 141 serial_table[serial->minor + i] = NULL;
8bc2c1b2 142 mutex_unlock(&table_lock);
1da177e4
LT
143}
144
145static void destroy_serial(struct kref *kref)
146{
147 struct usb_serial *serial;
148 struct usb_serial_port *port;
149 int i;
150
151 serial = to_usb_serial(kref);
152
441b62c1 153 dbg("%s - %s", __func__, serial->type->description);
1da177e4 154
521b85ae 155 /* return the minor range that this device had */
0282b7f2
AS
156 if (serial->minor != SERIAL_TTY_NO_MINOR)
157 return_serial(serial);
521b85ae 158
a4720c65
AS
159 if (serial->attached)
160 serial->type->release(serial);
f9c99bb8 161
41bd34dd
AS
162 /* Now that nothing is using the ports, they can be freed */
163 for (i = 0; i < serial->num_port_pointers; ++i) {
f9c99bb8 164 port = serial->port[i];
41bd34dd
AS
165 if (port) {
166 port->serial = NULL;
f9c99bb8 167 put_device(&port->dev);
1da177e4
LT
168 }
169 }
170
171 usb_put_dev(serial->dev);
a8d6f0a9 172 kfree(serial);
1da177e4
LT
173}
174
73e487fd
GL
175void usb_serial_put(struct usb_serial *serial)
176{
177 kref_put(&serial->kref, destroy_serial);
178}
179
1da177e4
LT
180/*****************************************************************************
181 * Driver tty interface functions
182 *****************************************************************************/
f5b0953a
AS
183
184/**
185 * serial_install - install tty
186 * @driver: the driver (USB in our case)
187 * @tty: the tty being created
188 *
189 * Create the termios objects for this tty. We use the default
190 * USB serial settings but permit them to be overridden by
191 * serial->type->init_termios.
cc56cd01
AS
192 *
193 * This is the first place a new tty gets used. Hence this is where we
194 * acquire references to the usb_serial structure and the driver module,
195 * where we store a pointer to the port, and where we do an autoresume.
f278a2f7 196 * All these actions are reversed in serial_cleanup().
f5b0953a
AS
197 */
198static int serial_install(struct tty_driver *driver, struct tty_struct *tty)
199{
200 int idx = tty->index;
201 struct usb_serial *serial;
cc56cd01
AS
202 struct usb_serial_port *port;
203 int retval = -ENODEV;
204
ff8324df
AS
205 dbg("%s", __func__);
206
cc56cd01
AS
207 serial = usb_serial_get_by_index(idx);
208 if (!serial)
209 return retval;
210
211 port = serial->port[idx - serial->minor];
212 if (!port)
213 goto error_no_port;
214 if (!try_module_get(serial->type->driver.owner))
215 goto error_module_get;
216
217 retval = usb_autopm_get_interface(serial->interface);
218 if (retval)
219 goto error_get_interface;
f5b0953a 220
76f82a7a
JS
221 retval = tty_standard_install(driver, tty);
222 if (retval)
223 goto error_init_termios;
224
cc56cd01
AS
225 mutex_unlock(&serial->disc_mutex);
226
7e29bb4b
AS
227 /* allow the driver to update the settings */
228 if (serial->type->init_termios)
229 serial->type->init_termios(tty);
230
cc56cd01
AS
231 tty->driver_data = port;
232
cc56cd01
AS
233 return retval;
234
7e29bb4b 235 error_init_termios:
76f82a7a
JS
236 usb_autopm_put_interface(serial->interface);
237 error_get_interface:
cc56cd01
AS
238 module_put(serial->type->driver.owner);
239 error_module_get:
240 error_no_port:
241 usb_serial_put(serial);
242 mutex_unlock(&serial->disc_mutex);
243 return retval;
f5b0953a
AS
244}
245
64bc3979 246static int serial_activate(struct tty_port *tport, struct tty_struct *tty)
1da177e4 247{
64bc3979
AC
248 struct usb_serial_port *port =
249 container_of(tport, struct usb_serial_port, port);
320348c8
AS
250 struct usb_serial *serial = port->serial;
251 int retval;
331879fd 252
64bc3979
AC
253 mutex_lock(&serial->disc_mutex);
254 if (serial->disconnected)
255 retval = -ENODEV;
256 else
257 retval = port->serial->type->open(tty, port);
258 mutex_unlock(&serial->disc_mutex);
3827d876
JH
259
260 if (retval < 0)
261 retval = usb_translate_errors(retval);
262
64bc3979
AC
263 return retval;
264}
1da177e4 265
64bc3979
AC
266static int serial_open(struct tty_struct *tty, struct file *filp)
267{
268 struct usb_serial_port *port = tty->driver_data;
320348c8 269
64bc3979
AC
270 dbg("%s - port %d", __func__, port->number);
271 return tty_port_open(&port->port, tty, filp);
1da177e4
LT
272}
273
335f8514 274/**
74556123 275 * serial_down - shut down hardware
e1108a63 276 * @tport: tty port to shut down
335f8514 277 *
f5b0953a 278 * Shut down a USB serial port unless it is the console. We never
e1108a63
AC
279 * shut down the console hardware as it will always be in use. Serialized
280 * against activate by the tport mutex and kept to matching open/close pairs
281 * of calls by the ASYNCB_INITIALIZED flag.
335f8514 282 */
e1108a63 283static void serial_down(struct tty_port *tport)
1da177e4 284{
e1108a63
AC
285 struct usb_serial_port *port =
286 container_of(tport, struct usb_serial_port, port);
335f8514 287 struct usb_serial_driver *drv = port->serial->type;
f5b0953a
AS
288 /*
289 * The console is magical. Do not hang up the console hardware
290 * or there will be tears.
291 */
bd5afa9e 292 if (port->port.console)
1da177e4 293 return;
335f8514
AC
294 if (drv->close)
295 drv->close(port);
335f8514
AC
296}
297
f5b0953a
AS
298static void serial_hangup(struct tty_struct *tty)
299{
300 struct usb_serial_port *port = tty->driver_data;
ff8324df 301 dbg("%s - port %d", __func__, port->number);
f5b0953a 302 tty_port_hangup(&port->port);
f5b0953a
AS
303}
304
305static void serial_close(struct tty_struct *tty, struct file *filp)
306{
307 struct usb_serial_port *port = tty->driver_data;
f5b0953a 308 dbg("%s - port %d", __func__, port->number);
e1108a63 309 tty_port_close(&port->port, tty, filp);
f5b0953a
AS
310}
311
335f8514 312/**
f278a2f7 313 * serial_cleanup - free resources post close/hangup
f5b0953a 314 * @port: port to free up
335f8514 315 *
f5b0953a
AS
316 * Do the resource freeing and refcount dropping for the port.
317 * Avoid freeing the console.
4455e344 318 *
f278a2f7
DY
319 * Called asynchronously after the last tty kref is dropped,
320 * and the tty layer has already done the tty_shutdown(tty);
335f8514 321 */
f278a2f7 322static void serial_cleanup(struct tty_struct *tty)
335f8514 323{
4455e344 324 struct usb_serial_port *port = tty->driver_data;
335f8514
AC
325 struct usb_serial *serial;
326 struct module *owner;
327
f5b0953a
AS
328 /* The console is magical. Do not hang up the console hardware
329 * or there will be tears.
330 */
bd5afa9e 331 if (port->port.console)
335f8514
AC
332 return;
333
ff8324df
AS
334 dbg("%s - port %d", __func__, port->number);
335
cc56cd01
AS
336 tty->driver_data = NULL;
337
335f8514
AC
338 serial = port->serial;
339 owner = serial->type->driver.owner;
41bd34dd 340
335f8514
AC
341 mutex_lock(&serial->disc_mutex);
342 if (!serial->disconnected)
343 usb_autopm_put_interface(serial->interface);
344 mutex_unlock(&serial->disc_mutex);
41bd34dd 345
2d93148a 346 usb_serial_put(serial);
335f8514
AC
347 module_put(owner);
348}
349
a8d6f0a9
AC
350static int serial_write(struct tty_struct *tty, const unsigned char *buf,
351 int count)
1da177e4 352{
81671ddb 353 struct usb_serial_port *port = tty->driver_data;
3ff4fd94 354 int retval = -ENODEV;
1da177e4 355
f34d7a5b 356 if (port->serial->dev->state == USB_STATE_NOTATTACHED)
487f9c67
LFC
357 goto exit;
358
441b62c1 359 dbg("%s - port %d, %d byte(s)", __func__, port->number, count);
1da177e4 360
1da177e4 361 /* pass on to the driver specific version of this function */
95da310e 362 retval = port->serial->type->write(tty, port, buf, count);
c6249ff7
JH
363 if (retval < 0)
364 retval = usb_translate_errors(retval);
1da177e4
LT
365exit:
366 return retval;
367}
368
a8d6f0a9 369static int serial_write_room(struct tty_struct *tty)
1da177e4 370{
81671ddb 371 struct usb_serial_port *port = tty->driver_data;
441b62c1 372 dbg("%s - port %d", __func__, port->number);
1da177e4 373 /* pass on to the driver specific version of this function */
95da310e 374 return port->serial->type->write_room(tty);
1da177e4
LT
375}
376
a8d6f0a9 377static int serial_chars_in_buffer(struct tty_struct *tty)
1da177e4 378{
81671ddb 379 struct usb_serial_port *port = tty->driver_data;
b4fc2aee 380 dbg("%s - port %d", __func__, port->number);
1da177e4 381
eff6937a
AC
382 /* if the device was unplugged then any remaining characters
383 fell out of the connector ;) */
384 if (port->serial->disconnected)
385 return 0;
1da177e4 386 /* pass on to the driver specific version of this function */
95da310e 387 return port->serial->type->chars_in_buffer(tty);
1da177e4
LT
388}
389
a8d6f0a9 390static void serial_throttle(struct tty_struct *tty)
1da177e4 391{
81671ddb 392 struct usb_serial_port *port = tty->driver_data;
441b62c1 393 dbg("%s - port %d", __func__, port->number);
1da177e4 394
1da177e4
LT
395 /* pass on to the driver specific version of this function */
396 if (port->serial->type->throttle)
95da310e 397 port->serial->type->throttle(tty);
1da177e4
LT
398}
399
a8d6f0a9 400static void serial_unthrottle(struct tty_struct *tty)
1da177e4 401{
81671ddb 402 struct usb_serial_port *port = tty->driver_data;
441b62c1 403 dbg("%s - port %d", __func__, port->number);
1da177e4 404
1da177e4
LT
405 /* pass on to the driver specific version of this function */
406 if (port->serial->type->unthrottle)
95da310e 407 port->serial->type->unthrottle(tty);
1da177e4
LT
408}
409
6caa76b7 410static int serial_ioctl(struct tty_struct *tty,
a8d6f0a9 411 unsigned int cmd, unsigned long arg)
1da177e4 412{
81671ddb 413 struct usb_serial_port *port = tty->driver_data;
1da177e4
LT
414 int retval = -ENODEV;
415
441b62c1 416 dbg("%s - port %d, cmd 0x%.4x", __func__, port->number, cmd);
1da177e4 417
a8d6f0a9
AC
418 /* pass on to the driver specific version of this function
419 if it is available */
f34d7a5b 420 if (port->serial->type->ioctl) {
00a0d0d6 421 retval = port->serial->type->ioctl(tty, cmd, arg);
a8d6f0a9 422 } else
1da177e4 423 retval = -ENOIOCTLCMD;
1da177e4
LT
424 return retval;
425}
426
a8d6f0a9 427static void serial_set_termios(struct tty_struct *tty, struct ktermios *old)
1da177e4 428{
81671ddb 429 struct usb_serial_port *port = tty->driver_data;
441b62c1 430 dbg("%s - port %d", __func__, port->number);
1da177e4 431
a8d6f0a9
AC
432 /* pass on to the driver specific version of this function
433 if it is available */
1da177e4 434 if (port->serial->type->set_termios)
95da310e 435 port->serial->type->set_termios(tty, port, old);
33785091
AC
436 else
437 tty_termios_copy_hw(tty->termios, old);
1da177e4
LT
438}
439
9e98966c 440static int serial_break(struct tty_struct *tty, int break_state)
1da177e4 441{
81671ddb 442 struct usb_serial_port *port = tty->driver_data;
1da177e4 443
441b62c1 444 dbg("%s - port %d", __func__, port->number);
1da177e4 445
a8d6f0a9
AC
446 /* pass on to the driver specific version of this function
447 if it is available */
6b447f04 448 if (port->serial->type->break_ctl)
95da310e 449 port->serial->type->break_ctl(tty, break_state);
9e98966c 450 return 0;
1da177e4
LT
451}
452
6fd69d3c 453static int serial_proc_show(struct seq_file *m, void *v)
1da177e4
LT
454{
455 struct usb_serial *serial;
1da177e4 456 int i;
1da177e4
LT
457 char tmp[40];
458
441b62c1 459 dbg("%s", __func__);
6fd69d3c
AD
460 seq_puts(m, "usbserinfo:1.0 driver:2.0\n");
461 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
1da177e4
LT
462 serial = usb_serial_get_by_index(i);
463 if (serial == NULL)
464 continue;
465
6fd69d3c 466 seq_printf(m, "%d:", i);
18fcac35 467 if (serial->type->driver.owner)
6fd69d3c 468 seq_printf(m, " module:%s",
a8d6f0a9 469 module_name(serial->type->driver.owner));
6fd69d3c 470 seq_printf(m, " name:\"%s\"",
a8d6f0a9 471 serial->type->description);
6fd69d3c 472 seq_printf(m, " vendor:%04x product:%04x",
a8d6f0a9
AC
473 le16_to_cpu(serial->dev->descriptor.idVendor),
474 le16_to_cpu(serial->dev->descriptor.idProduct));
6fd69d3c
AD
475 seq_printf(m, " num_ports:%d", serial->num_ports);
476 seq_printf(m, " port:%d", i - serial->minor + 1);
1da177e4 477 usb_make_path(serial->dev, tmp, sizeof(tmp));
6fd69d3c 478 seq_printf(m, " path:%s", tmp);
a8d6f0a9 479
6fd69d3c 480 seq_putc(m, '\n');
73e487fd 481 usb_serial_put(serial);
8bc2c1b2 482 mutex_unlock(&serial->disc_mutex);
1da177e4 483 }
6fd69d3c 484 return 0;
1da177e4
LT
485}
486
6fd69d3c
AD
487static int serial_proc_open(struct inode *inode, struct file *file)
488{
489 return single_open(file, serial_proc_show, NULL);
490}
491
492static const struct file_operations serial_proc_fops = {
493 .owner = THIS_MODULE,
494 .open = serial_proc_open,
495 .read = seq_read,
496 .llseek = seq_lseek,
497 .release = single_release,
498};
499
60b33c13 500static int serial_tiocmget(struct tty_struct *tty)
1da177e4 501{
81671ddb 502 struct usb_serial_port *port = tty->driver_data;
1da177e4 503
441b62c1 504 dbg("%s - port %d", __func__, port->number);
1da177e4 505
1da177e4 506 if (port->serial->type->tiocmget)
60b33c13 507 return port->serial->type->tiocmget(tty);
1da177e4
LT
508 return -EINVAL;
509}
510
20b9d177 511static int serial_tiocmset(struct tty_struct *tty,
1da177e4
LT
512 unsigned int set, unsigned int clear)
513{
81671ddb 514 struct usb_serial_port *port = tty->driver_data;
1da177e4 515
441b62c1 516 dbg("%s - port %d", __func__, port->number);
1da177e4 517
1da177e4 518 if (port->serial->type->tiocmset)
20b9d177 519 return port->serial->type->tiocmset(tty, set, clear);
1da177e4
LT
520 return -EINVAL;
521}
522
d281da7f
AC
523static int serial_get_icount(struct tty_struct *tty,
524 struct serial_icounter_struct *icount)
525{
526 struct usb_serial_port *port = tty->driver_data;
527
528 dbg("%s - port %d", __func__, port->number);
529
530 if (port->serial->type->get_icount)
531 return port->serial->type->get_icount(tty, icount);
532 return -EINVAL;
533}
534
cf2c7481
PZ
535/*
536 * We would be calling tty_wakeup here, but unfortunately some line
537 * disciplines have an annoying habit of calling tty->write from
538 * the write wakeup callback (e.g. n_hdlc.c).
539 */
540void usb_serial_port_softint(struct usb_serial_port *port)
541{
542 schedule_work(&port->work);
543}
a8d6f0a9 544EXPORT_SYMBOL_GPL(usb_serial_port_softint);
cf2c7481 545
c4028958 546static void usb_serial_port_work(struct work_struct *work)
1da177e4 547{
c4028958
DH
548 struct usb_serial_port *port =
549 container_of(work, struct usb_serial_port, work);
1da177e4
LT
550 struct tty_struct *tty;
551
441b62c1 552 dbg("%s - port %d", __func__, port->number);
a8d6f0a9 553
4a90f09b 554 tty = tty_port_tty_get(&port->port);
1da177e4
LT
555 if (!tty)
556 return;
557
558 tty_wakeup(tty);
4a90f09b 559 tty_kref_put(tty);
1da177e4
LT
560}
561
34ef50e5 562static void kill_traffic(struct usb_serial_port *port)
34f8e761 563{
27c7acf2
JH
564 int i;
565
d83b4053
JH
566 for (i = 0; i < ARRAY_SIZE(port->read_urbs); ++i)
567 usb_kill_urb(port->read_urbs[i]);
27c7acf2
JH
568 for (i = 0; i < ARRAY_SIZE(port->write_urbs); ++i)
569 usb_kill_urb(port->write_urbs[i]);
5adceac5
ON
570 /*
571 * This is tricky.
572 * Some drivers submit the read_urb in the
573 * handler for the write_urb or vice versa
574 * this order determines the order in which
575 * usb_kill_urb() must be used to reliably
576 * kill the URBs. As it is unknown here,
577 * both orders must be used in turn.
578 * The call below is not redundant.
579 */
580 usb_kill_urb(port->read_urb);
1da177e4 581 usb_kill_urb(port->interrupt_in_urb);
1da177e4 582 usb_kill_urb(port->interrupt_out_urb);
34ef50e5
ON
583}
584
41bd34dd 585static void port_release(struct device *dev)
34ef50e5 586{
41bd34dd 587 struct usb_serial_port *port = to_usb_serial_port(dev);
27c7acf2 588 int i;
41bd34dd
AS
589
590 dbg ("%s - %s", __func__, dev_name(dev));
591
2d93148a
AS
592 /*
593 * Stop all the traffic before cancelling the work, so that
594 * nobody will restart it by calling usb_serial_port_softint.
595 */
34ef50e5 596 kill_traffic(port);
2d93148a
AS
597 cancel_work_sync(&port->work);
598
34ef50e5 599 usb_free_urb(port->interrupt_in_urb);
1da177e4 600 usb_free_urb(port->interrupt_out_urb);
d83b4053
JH
601 for (i = 0; i < ARRAY_SIZE(port->read_urbs); ++i) {
602 usb_free_urb(port->read_urbs[i]);
603 kfree(port->bulk_in_buffers[i]);
604 }
27c7acf2
JH
605 for (i = 0; i < ARRAY_SIZE(port->write_urbs); ++i) {
606 usb_free_urb(port->write_urbs[i]);
607 kfree(port->bulk_out_buffers[i]);
608 }
119eecc8 609 kfifo_free(&port->write_fifo);
1da177e4
LT
610 kfree(port->interrupt_in_buffer);
611 kfree(port->interrupt_out_buffer);
612 kfree(port);
613}
614
a8d6f0a9
AC
615static struct usb_serial *create_serial(struct usb_device *dev,
616 struct usb_interface *interface,
617 struct usb_serial_driver *driver)
1da177e4
LT
618{
619 struct usb_serial *serial;
620
80b6ca48 621 serial = kzalloc(sizeof(*serial), GFP_KERNEL);
1da177e4 622 if (!serial) {
441b62c1 623 dev_err(&dev->dev, "%s - out of memory\n", __func__);
1da177e4
LT
624 return NULL;
625 }
1da177e4 626 serial->dev = usb_get_dev(dev);
ea65370d 627 serial->type = driver;
1da177e4
LT
628 serial->interface = interface;
629 kref_init(&serial->kref);
a1cd7e99 630 mutex_init(&serial->disc_mutex);
0282b7f2 631 serial->minor = SERIAL_TTY_NO_MINOR;
1da177e4
LT
632
633 return serial;
634}
635
93bacefc 636static const struct usb_device_id *match_dynamic_id(struct usb_interface *intf,
a8d6f0a9 637 struct usb_serial_driver *drv)
93bacefc
GKH
638{
639 struct usb_dynid *dynid;
640
641 spin_lock(&drv->dynids.lock);
642 list_for_each_entry(dynid, &drv->dynids.list, node) {
643 if (usb_match_one_id(intf, &dynid->id)) {
644 spin_unlock(&drv->dynids.lock);
645 return &dynid->id;
646 }
647 }
648 spin_unlock(&drv->dynids.lock);
649 return NULL;
650}
651
652static const struct usb_device_id *get_iface_id(struct usb_serial_driver *drv,
653 struct usb_interface *intf)
654{
655 const struct usb_device_id *id;
656
657 id = usb_match_id(intf, drv->id_table);
658 if (id) {
659 dbg("static descriptor matches");
660 goto exit;
661 }
662 id = match_dynamic_id(intf, drv);
663 if (id)
664 dbg("dynamic descriptor matches");
665exit:
666 return id;
667}
668
0daeed38 669/* Caller must hold table_lock */
a8d6f0a9
AC
670static struct usb_serial_driver *search_serial_device(
671 struct usb_interface *iface)
1da177e4 672{
1da177e4 673 const struct usb_device_id *id;
063a2da8 674 struct usb_serial_driver *drv;
1da177e4 675
93b1fae4 676 /* Check if the usb id matches a known device */
063a2da8
AS
677 list_for_each_entry(drv, &usb_serial_driver_list, driver_list) {
678 id = get_iface_id(drv, iface);
93bacefc 679 if (id)
063a2da8 680 return drv;
1da177e4
LT
681 }
682
683 return NULL;
684}
685
335f8514
AC
686static int serial_carrier_raised(struct tty_port *port)
687{
688 struct usb_serial_port *p = container_of(port, struct usb_serial_port, port);
689 struct usb_serial_driver *drv = p->serial->type;
3e1f4901 690
335f8514
AC
691 if (drv->carrier_raised)
692 return drv->carrier_raised(p);
693 /* No carrier control - don't block */
3e1f4901 694 return 1;
335f8514
AC
695}
696
697static void serial_dtr_rts(struct tty_port *port, int on)
698{
699 struct usb_serial_port *p = container_of(port, struct usb_serial_port, port);
700 struct usb_serial_driver *drv = p->serial->type;
3e1f4901 701
335f8514
AC
702 if (drv->dtr_rts)
703 drv->dtr_rts(p, on);
704}
705
706static const struct tty_port_operations serial_port_ops = {
707 .carrier_raised = serial_carrier_raised,
708 .dtr_rts = serial_dtr_rts,
64bc3979 709 .activate = serial_activate,
e1108a63 710 .shutdown = serial_down,
335f8514
AC
711};
712
1da177e4
LT
713int usb_serial_probe(struct usb_interface *interface,
714 const struct usb_device_id *id)
715{
a8d6f0a9 716 struct usb_device *dev = interface_to_usbdev(interface);
1da177e4
LT
717 struct usb_serial *serial = NULL;
718 struct usb_serial_port *port;
719 struct usb_host_interface *iface_desc;
720 struct usb_endpoint_descriptor *endpoint;
721 struct usb_endpoint_descriptor *interrupt_in_endpoint[MAX_NUM_PORTS];
722 struct usb_endpoint_descriptor *interrupt_out_endpoint[MAX_NUM_PORTS];
723 struct usb_endpoint_descriptor *bulk_in_endpoint[MAX_NUM_PORTS];
724 struct usb_endpoint_descriptor *bulk_out_endpoint[MAX_NUM_PORTS];
ea65370d 725 struct usb_serial_driver *type = NULL;
1da177e4 726 int retval;
dd9ca5d9 727 unsigned int minor;
1da177e4
LT
728 int buffer_size;
729 int i;
d83b4053 730 int j;
1da177e4
LT
731 int num_interrupt_in = 0;
732 int num_interrupt_out = 0;
733 int num_bulk_in = 0;
734 int num_bulk_out = 0;
735 int num_ports = 0;
736 int max_endpoints;
737
0daeed38 738 mutex_lock(&table_lock);
1da177e4
LT
739 type = search_serial_device(interface);
740 if (!type) {
0daeed38 741 mutex_unlock(&table_lock);
1da177e4
LT
742 dbg("none matched");
743 return -ENODEV;
744 }
745
0daeed38
AK
746 if (!try_module_get(type->driver.owner)) {
747 mutex_unlock(&table_lock);
748 dev_err(&interface->dev, "module get failed, exiting\n");
749 return -EIO;
750 }
751 mutex_unlock(&table_lock);
752
a8d6f0a9 753 serial = create_serial(dev, interface, type);
1da177e4 754 if (!serial) {
d92a3ca6 755 module_put(type->driver.owner);
441b62c1 756 dev_err(&interface->dev, "%s - out of memory\n", __func__);
1da177e4
LT
757 return -ENOMEM;
758 }
759
760 /* if this device type has a probe function, call it */
761 if (type->probe) {
762 const struct usb_device_id *id;
763
93bacefc 764 id = get_iface_id(type, interface);
1da177e4 765 retval = type->probe(serial, id);
1da177e4
LT
766
767 if (retval) {
a8d6f0a9
AC
768 dbg("sub driver rejected device");
769 kfree(serial);
d92a3ca6 770 module_put(type->driver.owner);
1da177e4
LT
771 return retval;
772 }
773 }
774
775 /* descriptor matches, let's find the endpoints needed */
776 /* check out the endpoints */
777 iface_desc = interface->cur_altsetting;
778 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
779 endpoint = &iface_desc->endpoint[i].desc;
4fa1bbf5
LFC
780
781 if (usb_endpoint_is_bulk_in(endpoint)) {
1da177e4
LT
782 /* we found a bulk in endpoint */
783 dbg("found bulk in on endpoint %d", i);
784 bulk_in_endpoint[num_bulk_in] = endpoint;
785 ++num_bulk_in;
786 }
787
4fa1bbf5 788 if (usb_endpoint_is_bulk_out(endpoint)) {
1da177e4
LT
789 /* we found a bulk out endpoint */
790 dbg("found bulk out on endpoint %d", i);
791 bulk_out_endpoint[num_bulk_out] = endpoint;
792 ++num_bulk_out;
793 }
4fa1bbf5
LFC
794
795 if (usb_endpoint_is_int_in(endpoint)) {
1da177e4
LT
796 /* we found a interrupt in endpoint */
797 dbg("found interrupt in on endpoint %d", i);
798 interrupt_in_endpoint[num_interrupt_in] = endpoint;
799 ++num_interrupt_in;
800 }
801
4fa1bbf5 802 if (usb_endpoint_is_int_out(endpoint)) {
1da177e4
LT
803 /* we found an interrupt out endpoint */
804 dbg("found interrupt out on endpoint %d", i);
805 interrupt_out_endpoint[num_interrupt_out] = endpoint;
806 ++num_interrupt_out;
807 }
808 }
809
810#if defined(CONFIG_USB_SERIAL_PL2303) || defined(CONFIG_USB_SERIAL_PL2303_MODULE)
a8d6f0a9 811 /* BEGIN HORRIBLE HACK FOR PL2303 */
1da177e4
LT
812 /* this is needed due to the looney way its endpoints are set up */
813 if (((le16_to_cpu(dev->descriptor.idVendor) == PL2303_VENDOR_ID) &&
814 (le16_to_cpu(dev->descriptor.idProduct) == PL2303_PRODUCT_ID)) ||
815 ((le16_to_cpu(dev->descriptor.idVendor) == ATEN_VENDOR_ID) &&
8fd80133
JS
816 (le16_to_cpu(dev->descriptor.idProduct) == ATEN_PRODUCT_ID)) ||
817 ((le16_to_cpu(dev->descriptor.idVendor) == ALCOR_VENDOR_ID) &&
ce816cf9
AB
818 (le16_to_cpu(dev->descriptor.idProduct) == ALCOR_PRODUCT_ID)) ||
819 ((le16_to_cpu(dev->descriptor.idVendor) == SIEMENS_VENDOR_ID) &&
820 (le16_to_cpu(dev->descriptor.idProduct) == SIEMENS_PRODUCT_ID_EF81))) {
1da177e4
LT
821 if (interface != dev->actconfig->interface[0]) {
822 /* check out the endpoints of the other interface*/
823 iface_desc = dev->actconfig->interface[0]->cur_altsetting;
824 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
825 endpoint = &iface_desc->endpoint[i].desc;
4fa1bbf5 826 if (usb_endpoint_is_int_in(endpoint)) {
1da177e4
LT
827 /* we found a interrupt in endpoint */
828 dbg("found interrupt in for Prolific device on separate interface");
829 interrupt_in_endpoint[num_interrupt_in] = endpoint;
830 ++num_interrupt_in;
831 }
832 }
833 }
834
835 /* Now make sure the PL-2303 is configured correctly.
836 * If not, give up now and hope this hack will work
837 * properly during a later invocation of usb_serial_probe
838 */
839 if (num_bulk_in == 0 || num_bulk_out == 0) {
840 dev_info(&interface->dev, "PL-2303 hack: descriptors matched but endpoints did not\n");
a8d6f0a9 841 kfree(serial);
d92a3ca6 842 module_put(type->driver.owner);
1da177e4
LT
843 return -ENODEV;
844 }
845 }
846 /* END HORRIBLE HACK FOR PL2303 */
847#endif
848
1da177e4
LT
849#ifdef CONFIG_USB_SERIAL_GENERIC
850 if (type == &usb_serial_generic_device) {
851 num_ports = num_bulk_out;
852 if (num_ports == 0) {
a8d6f0a9
AC
853 dev_err(&interface->dev,
854 "Generic device with no bulk out, not allowed.\n");
855 kfree(serial);
d92a3ca6 856 module_put(type->driver.owner);
1da177e4
LT
857 return -EIO;
858 }
859 }
860#endif
861 if (!num_ports) {
862 /* if this device type has a calc_num_ports function, call it */
d92a3ca6 863 if (type->calc_num_ports)
a8d6f0a9 864 num_ports = type->calc_num_ports(serial);
1da177e4
LT
865 if (!num_ports)
866 num_ports = type->num_ports;
867 }
868
1da177e4
LT
869 serial->num_ports = num_ports;
870 serial->num_bulk_in = num_bulk_in;
871 serial->num_bulk_out = num_bulk_out;
872 serial->num_interrupt_in = num_interrupt_in;
873 serial->num_interrupt_out = num_interrupt_out;
874
063a2da8
AS
875 /* found all that we need */
876 dev_info(&interface->dev, "%s converter detected\n",
877 type->description);
878
1da177e4 879 /* create our ports, we need as many as the max endpoints */
a8d6f0a9
AC
880 /* we don't use num_ports here because some devices have more
881 endpoint pairs than ports */
1da177e4
LT
882 max_endpoints = max(num_bulk_in, num_bulk_out);
883 max_endpoints = max(max_endpoints, num_interrupt_in);
884 max_endpoints = max(max_endpoints, num_interrupt_out);
885 max_endpoints = max(max_endpoints, (int)serial->num_ports);
886 serial->num_port_pointers = max_endpoints;
4b10f0f3 887
a8d6f0a9
AC
888 dbg("%s - setting up %d port structures for this device",
889 __func__, max_endpoints);
1da177e4 890 for (i = 0; i < max_endpoints; ++i) {
80b6ca48 891 port = kzalloc(sizeof(struct usb_serial_port), GFP_KERNEL);
1da177e4
LT
892 if (!port)
893 goto probe_error;
4a90f09b 894 tty_port_init(&port->port);
335f8514 895 port->port.ops = &serial_port_ops;
1da177e4 896 port->serial = serial;
507ca9bc 897 spin_lock_init(&port->lock);
e1108a63
AC
898 /* Keep this for private driver use for the moment but
899 should probably go away */
c4028958 900 INIT_WORK(&port->work, usb_serial_port_work);
1da177e4 901 serial->port[i] = port;
41bd34dd
AS
902 port->dev.parent = &interface->dev;
903 port->dev.driver = NULL;
904 port->dev.bus = &usb_serial_bus_type;
905 port->dev.release = &port_release;
906 device_initialize(&port->dev);
1da177e4
LT
907 }
908
909 /* set up the endpoint information */
910 for (i = 0; i < num_bulk_in; ++i) {
911 endpoint = bulk_in_endpoint[i];
912 port = serial->port[i];
969e3033 913 buffer_size = max_t(int, serial->type->bulk_in_size,
29cc8897 914 usb_endpoint_maxp(endpoint));
1da177e4
LT
915 port->bulk_in_size = buffer_size;
916 port->bulk_in_endpointAddress = endpoint->bEndpointAddress;
d83b4053
JH
917
918 for (j = 0; j < ARRAY_SIZE(port->read_urbs); ++j) {
919 set_bit(j, &port->read_urbs_free);
920 port->read_urbs[j] = usb_alloc_urb(0, GFP_KERNEL);
921 if (!port->read_urbs[j]) {
922 dev_err(&interface->dev,
923 "No free urbs available\n");
924 goto probe_error;
925 }
926 port->bulk_in_buffers[j] = kmalloc(buffer_size,
927 GFP_KERNEL);
928 if (!port->bulk_in_buffers[j]) {
929 dev_err(&interface->dev,
a8d6f0a9 930 "Couldn't allocate bulk_in_buffer\n");
d83b4053
JH
931 goto probe_error;
932 }
933 usb_fill_bulk_urb(port->read_urbs[j], dev,
934 usb_rcvbulkpipe(dev,
a8d6f0a9 935 endpoint->bEndpointAddress),
d83b4053
JH
936 port->bulk_in_buffers[j], buffer_size,
937 serial->type->read_bulk_callback,
938 port);
939 }
940
941 port->read_urb = port->read_urbs[0];
942 port->bulk_in_buffer = port->bulk_in_buffers[0];
1da177e4
LT
943 }
944
945 for (i = 0; i < num_bulk_out; ++i) {
946 endpoint = bulk_out_endpoint[i];
947 port = serial->port[i];
119eecc8 948 if (kfifo_alloc(&port->write_fifo, PAGE_SIZE, GFP_KERNEL))
8e8dce06 949 goto probe_error;
bbcb2b90
JH
950 buffer_size = serial->type->bulk_out_size;
951 if (!buffer_size)
29cc8897 952 buffer_size = usb_endpoint_maxp(endpoint);
1da177e4
LT
953 port->bulk_out_size = buffer_size;
954 port->bulk_out_endpointAddress = endpoint->bEndpointAddress;
1ce7b934 955
27c7acf2
JH
956 for (j = 0; j < ARRAY_SIZE(port->write_urbs); ++j) {
957 set_bit(j, &port->write_urbs_free);
958 port->write_urbs[j] = usb_alloc_urb(0, GFP_KERNEL);
959 if (!port->write_urbs[j]) {
960 dev_err(&interface->dev,
961 "No free urbs available\n");
962 goto probe_error;
963 }
964 port->bulk_out_buffers[j] = kmalloc(buffer_size,
965 GFP_KERNEL);
966 if (!port->bulk_out_buffers[j]) {
967 dev_err(&interface->dev,
968 "Couldn't allocate bulk_out_buffer\n");
969 goto probe_error;
970 }
971 usb_fill_bulk_urb(port->write_urbs[j], dev,
972 usb_sndbulkpipe(dev,
973 endpoint->bEndpointAddress),
974 port->bulk_out_buffers[j], buffer_size,
975 serial->type->write_bulk_callback,
976 port);
977 }
1ce7b934
JH
978
979 port->write_urb = port->write_urbs[0];
980 port->bulk_out_buffer = port->bulk_out_buffers[0];
1da177e4
LT
981 }
982
983 if (serial->type->read_int_callback) {
984 for (i = 0; i < num_interrupt_in; ++i) {
985 endpoint = interrupt_in_endpoint[i];
986 port = serial->port[i];
987 port->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
988 if (!port->interrupt_in_urb) {
a8d6f0a9
AC
989 dev_err(&interface->dev,
990 "No free urbs available\n");
1da177e4
LT
991 goto probe_error;
992 }
29cc8897 993 buffer_size = usb_endpoint_maxp(endpoint);
a8d6f0a9
AC
994 port->interrupt_in_endpointAddress =
995 endpoint->bEndpointAddress;
996 port->interrupt_in_buffer = kmalloc(buffer_size,
997 GFP_KERNEL);
1da177e4 998 if (!port->interrupt_in_buffer) {
a8d6f0a9
AC
999 dev_err(&interface->dev,
1000 "Couldn't allocate interrupt_in_buffer\n");
1da177e4
LT
1001 goto probe_error;
1002 }
a8d6f0a9
AC
1003 usb_fill_int_urb(port->interrupt_in_urb, dev,
1004 usb_rcvintpipe(dev,
1005 endpoint->bEndpointAddress),
1006 port->interrupt_in_buffer, buffer_size,
1007 serial->type->read_int_callback, port,
1008 endpoint->bInterval);
1da177e4
LT
1009 }
1010 } else if (num_interrupt_in) {
1011 dbg("the device claims to support interrupt in transfers, but read_int_callback is not defined");
1012 }
a8d6f0a9 1013
1da177e4
LT
1014 if (serial->type->write_int_callback) {
1015 for (i = 0; i < num_interrupt_out; ++i) {
1016 endpoint = interrupt_out_endpoint[i];
1017 port = serial->port[i];
1018 port->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
1019 if (!port->interrupt_out_urb) {
a8d6f0a9
AC
1020 dev_err(&interface->dev,
1021 "No free urbs available\n");
1da177e4
LT
1022 goto probe_error;
1023 }
29cc8897 1024 buffer_size = usb_endpoint_maxp(endpoint);
1da177e4 1025 port->interrupt_out_size = buffer_size;
a8d6f0a9
AC
1026 port->interrupt_out_endpointAddress =
1027 endpoint->bEndpointAddress;
1028 port->interrupt_out_buffer = kmalloc(buffer_size,
1029 GFP_KERNEL);
1da177e4 1030 if (!port->interrupt_out_buffer) {
a8d6f0a9
AC
1031 dev_err(&interface->dev,
1032 "Couldn't allocate interrupt_out_buffer\n");
1da177e4
LT
1033 goto probe_error;
1034 }
a8d6f0a9
AC
1035 usb_fill_int_urb(port->interrupt_out_urb, dev,
1036 usb_sndintpipe(dev,
1037 endpoint->bEndpointAddress),
1038 port->interrupt_out_buffer, buffer_size,
1039 serial->type->write_int_callback, port,
1040 endpoint->bInterval);
1da177e4
LT
1041 }
1042 } else if (num_interrupt_out) {
1043 dbg("the device claims to support interrupt out transfers, but write_int_callback is not defined");
1044 }
a8d6f0a9 1045
1da177e4
LT
1046 /* if this device type has an attach function, call it */
1047 if (type->attach) {
a8d6f0a9 1048 retval = type->attach(serial);
1da177e4
LT
1049 if (retval < 0)
1050 goto probe_error;
a4720c65 1051 serial->attached = 1;
1da177e4 1052 if (retval > 0) {
a8d6f0a9
AC
1053 /* quietly accept this device, but don't bind to a
1054 serial port as it's about to disappear */
0a3c8549 1055 serial->num_ports = 0;
1da177e4
LT
1056 goto exit;
1057 }
a4720c65
AS
1058 } else {
1059 serial->attached = 1;
1da177e4
LT
1060 }
1061
a65a6f14
JH
1062 /* Avoid race with tty_open and serial_install by setting the
1063 * disconnected flag and not clearing it until all ports have been
1064 * registered.
1065 */
1066 serial->disconnected = 1;
1067
a8d6f0a9 1068 if (get_free_serial(serial, num_ports, &minor) == NULL) {
34ef50e5
ON
1069 dev_err(&interface->dev, "No more free serial devices\n");
1070 goto probe_error;
1071 }
c744f99e 1072 serial->minor = minor;
34ef50e5 1073
1da177e4
LT
1074 /* register all of the individual ports with the driver core */
1075 for (i = 0; i < num_ports; ++i) {
1076 port = serial->port[i];
0031a06e 1077 dev_set_name(&port->dev, "ttyUSB%d", port->number);
7071a3ce 1078 dbg ("%s - registering %s", __func__, dev_name(&port->dev));
a7a6b79b
ML
1079 device_enable_async_suspend(&port->dev);
1080
41bd34dd 1081 retval = device_add(&port->dev);
891a3b1f 1082 if (retval)
13f4db9e
GKH
1083 dev_err(&port->dev, "Error registering port device, "
1084 "continuing\n");
1da177e4
LT
1085 }
1086
a65a6f14
JH
1087 serial->disconnected = 0;
1088
a8d6f0a9 1089 usb_serial_console_init(debug, minor);
1da177e4
LT
1090
1091exit:
1092 /* success */
a8d6f0a9 1093 usb_set_intfdata(interface, serial);
d92a3ca6 1094 module_put(type->driver.owner);
1da177e4
LT
1095 return 0;
1096
1097probe_error:
41bd34dd 1098 usb_serial_put(serial);
d92a3ca6 1099 module_put(type->driver.owner);
1da177e4
LT
1100 return -EIO;
1101}
a8d6f0a9 1102EXPORT_SYMBOL_GPL(usb_serial_probe);
1da177e4
LT
1103
1104void usb_serial_disconnect(struct usb_interface *interface)
1105{
1106 int i;
a8d6f0a9 1107 struct usb_serial *serial = usb_get_intfdata(interface);
1da177e4
LT
1108 struct device *dev = &interface->dev;
1109 struct usb_serial_port *port;
1110
73e487fd 1111 usb_serial_console_disconnect(serial);
a8d6f0a9 1112 dbg("%s", __func__);
1da177e4 1113
a1cd7e99 1114 mutex_lock(&serial->disc_mutex);
a8d6f0a9 1115 usb_set_intfdata(interface, NULL);
a1cd7e99
ON
1116 /* must set a flag, to signal subdrivers */
1117 serial->disconnected = 1;
2d93148a
AS
1118 mutex_unlock(&serial->disc_mutex);
1119
a1cd7e99
ON
1120 for (i = 0; i < serial->num_ports; ++i) {
1121 port = serial->port[i];
1122 if (port) {
4a90f09b
AC
1123 struct tty_struct *tty = tty_port_tty_get(&port->port);
1124 if (tty) {
d2b39182 1125 tty_vhangup(tty);
4a90f09b
AC
1126 tty_kref_put(tty);
1127 }
a1cd7e99 1128 kill_traffic(port);
2d93148a 1129 cancel_work_sync(&port->work);
891a3b1f 1130 if (device_is_registered(&port->dev))
c706ebdf 1131 device_del(&port->dev);
2d93148a
AS
1132 }
1133 }
f9c99bb8 1134 serial->type->disconnect(serial);
2d93148a 1135
41bd34dd 1136 /* let the last holder of this object cause it to be cleaned up */
a1cd7e99 1137 usb_serial_put(serial);
1da177e4
LT
1138 dev_info(dev, "device disconnected\n");
1139}
a8d6f0a9 1140EXPORT_SYMBOL_GPL(usb_serial_disconnect);
1da177e4 1141
ec22559e
ON
1142int usb_serial_suspend(struct usb_interface *intf, pm_message_t message)
1143{
1144 struct usb_serial *serial = usb_get_intfdata(intf);
1145 struct usb_serial_port *port;
1146 int i, r = 0;
1147
f8bece8d
ON
1148 serial->suspending = 1;
1149
81e5b23c
ON
1150 if (serial->type->suspend) {
1151 r = serial->type->suspend(serial, message);
a5f6005d
ON
1152 if (r < 0) {
1153 serial->suspending = 0;
81e5b23c 1154 goto err_out;
a5f6005d 1155 }
81e5b23c
ON
1156 }
1157
e31c1880
ON
1158 for (i = 0; i < serial->num_ports; ++i) {
1159 port = serial->port[i];
1160 if (port)
1161 kill_traffic(port);
ec22559e
ON
1162 }
1163
81e5b23c 1164err_out:
ec22559e
ON
1165 return r;
1166}
1167EXPORT_SYMBOL(usb_serial_suspend);
1168
1169int usb_serial_resume(struct usb_interface *intf)
1170{
1171 struct usb_serial *serial = usb_get_intfdata(intf);
c49cfa91 1172 int rv;
ec22559e 1173
f8bece8d 1174 serial->suspending = 0;
8abaee23 1175 if (serial->type->resume)
c49cfa91
ON
1176 rv = serial->type->resume(serial);
1177 else
1178 rv = usb_serial_generic_resume(serial);
f8bece8d 1179
c49cfa91 1180 return rv;
ec22559e
ON
1181}
1182EXPORT_SYMBOL(usb_serial_resume);
1183
b68e31d0 1184static const struct tty_operations serial_ops = {
1da177e4
LT
1185 .open = serial_open,
1186 .close = serial_close,
1187 .write = serial_write,
3e1f4901 1188 .hangup = serial_hangup,
1da177e4
LT
1189 .write_room = serial_write_room,
1190 .ioctl = serial_ioctl,
1191 .set_termios = serial_set_termios,
1192 .throttle = serial_throttle,
1193 .unthrottle = serial_unthrottle,
1194 .break_ctl = serial_break,
1195 .chars_in_buffer = serial_chars_in_buffer,
1da177e4
LT
1196 .tiocmget = serial_tiocmget,
1197 .tiocmset = serial_tiocmset,
3e1f4901
JH
1198 .get_icount = serial_get_icount,
1199 .cleanup = serial_cleanup,
1200 .install = serial_install,
6fd69d3c 1201 .proc_fops = &serial_proc_fops,
1da177e4
LT
1202};
1203
335f8514 1204
1da177e4
LT
1205struct tty_driver *usb_serial_tty_driver;
1206
1207static int __init usb_serial_init(void)
1208{
1209 int i;
1210 int result;
1211
1212 usb_serial_tty_driver = alloc_tty_driver(SERIAL_TTY_MINORS);
1213 if (!usb_serial_tty_driver)
1214 return -ENOMEM;
1215
1216 /* Initialize our global data */
a8d6f0a9 1217 for (i = 0; i < SERIAL_TTY_MINORS; ++i)
1da177e4 1218 serial_table[i] = NULL;
1da177e4
LT
1219
1220 result = bus_register(&usb_serial_bus_type);
1221 if (result) {
194343d9
GKH
1222 printk(KERN_ERR "usb-serial: %s - registering bus driver "
1223 "failed\n", __func__);
1da177e4
LT
1224 goto exit_bus;
1225 }
1226
1da177e4 1227 usb_serial_tty_driver->driver_name = "usbserial";
3e1f4901 1228 usb_serial_tty_driver->name = "ttyUSB";
1da177e4
LT
1229 usb_serial_tty_driver->major = SERIAL_TTY_MAJOR;
1230 usb_serial_tty_driver->minor_start = 0;
1231 usb_serial_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
1232 usb_serial_tty_driver->subtype = SERIAL_TYPE_NORMAL;
a8d6f0a9
AC
1233 usb_serial_tty_driver->flags = TTY_DRIVER_REAL_RAW |
1234 TTY_DRIVER_DYNAMIC_DEV;
1da177e4 1235 usb_serial_tty_driver->init_termios = tty_std_termios;
a8d6f0a9
AC
1236 usb_serial_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD
1237 | HUPCL | CLOCAL;
a5b6f60c
AC
1238 usb_serial_tty_driver->init_termios.c_ispeed = 9600;
1239 usb_serial_tty_driver->init_termios.c_ospeed = 9600;
1da177e4
LT
1240 tty_set_operations(usb_serial_tty_driver, &serial_ops);
1241 result = tty_register_driver(usb_serial_tty_driver);
1242 if (result) {
194343d9
GKH
1243 printk(KERN_ERR "usb-serial: %s - tty_register_driver failed\n",
1244 __func__);
1da177e4
LT
1245 goto exit_reg_driver;
1246 }
1247
1248 /* register the USB driver */
1249 result = usb_register(&usb_serial_driver);
1250 if (result < 0) {
194343d9
GKH
1251 printk(KERN_ERR "usb-serial: %s - usb_register failed\n",
1252 __func__);
1da177e4
LT
1253 goto exit_tty;
1254 }
1255
06299db3
GKH
1256 /* register the generic driver, if we should */
1257 result = usb_serial_generic_register(debug);
1258 if (result < 0) {
194343d9
GKH
1259 printk(KERN_ERR "usb-serial: %s - registering generic "
1260 "driver failed\n", __func__);
06299db3
GKH
1261 goto exit_generic;
1262 }
1263
c197a8db 1264 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_DESC "\n");
1da177e4
LT
1265
1266 return result;
1267
06299db3
GKH
1268exit_generic:
1269 usb_deregister(&usb_serial_driver);
1270
1da177e4
LT
1271exit_tty:
1272 tty_unregister_driver(usb_serial_tty_driver);
1273
1274exit_reg_driver:
1da177e4
LT
1275 bus_unregister(&usb_serial_bus_type);
1276
1277exit_bus:
194343d9
GKH
1278 printk(KERN_ERR "usb-serial: %s - returning with error %d\n",
1279 __func__, result);
1da177e4
LT
1280 put_tty_driver(usb_serial_tty_driver);
1281 return result;
1282}
1283
1284
1285static void __exit usb_serial_exit(void)
1286{
1287 usb_serial_console_exit();
1288
1289 usb_serial_generic_deregister();
1290
1291 usb_deregister(&usb_serial_driver);
1292 tty_unregister_driver(usb_serial_tty_driver);
1293 put_tty_driver(usb_serial_tty_driver);
1294 bus_unregister(&usb_serial_bus_type);
1295}
1296
1297
1298module_init(usb_serial_init);
1299module_exit(usb_serial_exit);
1300
1301#define set_to_generic_if_null(type, function) \
1302 do { \
1303 if (!type->function) { \
1304 type->function = usb_serial_generic_##function; \
1305 dbg("Had to override the " #function \
a8d6f0a9 1306 " usb serial operation with the generic one.");\
1da177e4
LT
1307 } \
1308 } while (0)
1309
ea65370d 1310static void fixup_generic(struct usb_serial_driver *device)
1da177e4
LT
1311{
1312 set_to_generic_if_null(device, open);
1313 set_to_generic_if_null(device, write);
1314 set_to_generic_if_null(device, close);
1315 set_to_generic_if_null(device, write_room);
1316 set_to_generic_if_null(device, chars_in_buffer);
1317 set_to_generic_if_null(device, read_bulk_callback);
1318 set_to_generic_if_null(device, write_bulk_callback);
f9c99bb8
AS
1319 set_to_generic_if_null(device, disconnect);
1320 set_to_generic_if_null(device, release);
23154320 1321 set_to_generic_if_null(device, process_read_urb);
eaa3bcb0 1322 set_to_generic_if_null(device, prepare_write_buffer);
1da177e4
LT
1323}
1324
f799e767 1325static int usb_serial_register(struct usb_serial_driver *driver)
1da177e4
LT
1326{
1327 int retval;
1328
e4abe665
DY
1329 if (usb_disabled())
1330 return -ENODEV;
1331
ea65370d 1332 fixup_generic(driver);
1da177e4 1333
269bda1c
GKH
1334 if (!driver->description)
1335 driver->description = driver->driver.name;
5620b5f7
AS
1336 if (!driver->usb_driver) {
1337 WARN(1, "Serial driver %s has no usb_driver\n",
1338 driver->description);
1339 return -EINVAL;
1340 }
1341 driver->usb_driver->supports_autosuspend = 1;
269bda1c 1342
1da177e4 1343 /* Add this device to our list of devices */
0daeed38 1344 mutex_lock(&table_lock);
ea65370d 1345 list_add(&driver->driver_list, &usb_serial_driver_list);
1da177e4 1346
ea65370d 1347 retval = usb_serial_bus_register(driver);
1da177e4 1348 if (retval) {
194343d9
GKH
1349 printk(KERN_ERR "usb-serial: problem %d when registering "
1350 "driver %s\n", retval, driver->description);
ea65370d 1351 list_del(&driver->driver_list);
a8d6f0a9 1352 } else
c197a8db 1353 printk(KERN_INFO "USB Serial support registered for %s\n",
a8d6f0a9 1354 driver->description);
1da177e4 1355
0daeed38 1356 mutex_unlock(&table_lock);
1da177e4
LT
1357 return retval;
1358}
1359
f799e767 1360static void usb_serial_deregister(struct usb_serial_driver *device)
1da177e4 1361{
c197a8db
GKH
1362 printk(KERN_INFO "USB Serial deregistering driver %s\n",
1363 device->description);
0daeed38 1364 mutex_lock(&table_lock);
1da177e4
LT
1365 list_del(&device->driver_list);
1366 usb_serial_bus_deregister(device);
0daeed38 1367 mutex_unlock(&table_lock);
1da177e4 1368}
1da177e4 1369
765e0ba6
AS
1370/**
1371 * usb_serial_register_drivers - register drivers for a usb-serial module
1372 * @udriver: usb_driver used for matching devices/interfaces
1373 * @serial_drivers: NULL-terminated array of pointers to drivers to be registered
1374 *
1375 * Registers @udriver and all the drivers in the @serial_drivers array.
1376 * Automatically fills in the .no_dynamic_id field in @udriver and
1377 * the .usb_driver field in each serial driver.
1378 */
1379int usb_serial_register_drivers(struct usb_driver *udriver,
1380 struct usb_serial_driver * const serial_drivers[])
1381{
1382 int rc;
1383 const struct usb_device_id *saved_id_table;
1384 struct usb_serial_driver * const *sd;
1385
1386 /*
1387 * udriver must be registered before any of the serial drivers,
1388 * because the store_new_id() routine for the serial drivers (in
1389 * bus.c) probes udriver.
1390 *
1391 * Performance hack: We don't want udriver to be probed until
1392 * the serial drivers are registered, because the probe would
1393 * simply fail for lack of a matching serial driver.
1394 * Therefore save off udriver's id_table until we are all set.
1395 */
1396 saved_id_table = udriver->id_table;
1397 udriver->id_table = NULL;
1398
1399 udriver->no_dynamic_id = 1;
1400 rc = usb_register(udriver);
1401 if (rc)
1402 return rc;
1403
1404 for (sd = serial_drivers; *sd; ++sd) {
1405 (*sd)->usb_driver = udriver;
1406 rc = usb_serial_register(*sd);
1407 if (rc)
1408 goto failed;
1409 }
1410
1411 /* Now restore udriver's id_table and look for matches */
1412 udriver->id_table = saved_id_table;
1413 rc = driver_attach(&udriver->drvwrap.driver);
1414 return 0;
1415
1416 failed:
1417 while (sd-- > serial_drivers)
1418 usb_serial_deregister(*sd);
1419 usb_deregister(udriver);
1420 return rc;
1421}
1422EXPORT_SYMBOL_GPL(usb_serial_register_drivers);
1423
1424/**
1425 * usb_serial_deregister_drivers - deregister drivers for a usb-serial module
1426 * @udriver: usb_driver to unregister
1427 * @serial_drivers: NULL-terminated array of pointers to drivers to be deregistered
1428 *
1429 * Deregisters @udriver and all the drivers in the @serial_drivers array.
1430 */
1431void usb_serial_deregister_drivers(struct usb_driver *udriver,
1432 struct usb_serial_driver * const serial_drivers[])
1433{
1434 for (; *serial_drivers; ++serial_drivers)
1435 usb_serial_deregister(*serial_drivers);
1436 usb_deregister(udriver);
1437}
1438EXPORT_SYMBOL_GPL(usb_serial_deregister_drivers);
1da177e4
LT
1439
1440/* Module information */
a8d6f0a9
AC
1441MODULE_AUTHOR(DRIVER_AUTHOR);
1442MODULE_DESCRIPTION(DRIVER_DESC);
1da177e4
LT
1443MODULE_LICENSE("GPL");
1444
1445module_param(debug, bool, S_IRUGO | S_IWUSR);
1446MODULE_PARM_DESC(debug, "Debug enabled or not");