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