]> git.proxmox.com Git - mirror_ubuntu-hirsute-kernel.git/blame - drivers/usb/serial/usb-serial.c
tty_port: coding style cleaning pass
[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>
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>
8e8dce06 38#include <linux/kfifo.h>
1da177e4
LT
39#include "pl2303.h"
40
41/*
42 * Version Information
43 */
1da177e4
LT
44#define DRIVER_AUTHOR "Greg Kroah-Hartman, greg@kroah.com, http://www.kroah.com/linux/"
45#define DRIVER_DESC "USB Serial Driver core"
46
47/* Driver structure we register with the USB core */
48static struct usb_driver usb_serial_driver = {
1da177e4
LT
49 .name = "usbserial",
50 .probe = usb_serial_probe,
51 .disconnect = usb_serial_disconnect,
ec22559e
ON
52 .suspend = usb_serial_suspend,
53 .resume = usb_serial_resume,
ba9dc657 54 .no_dynamic_id = 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
64static int 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
7e29bb4b
AS
217 /* perform the standard setup */
218 retval = tty_init_termios(tty);
219 if (retval)
220 goto error_init_termios;
221
cc56cd01
AS
222 retval = usb_autopm_get_interface(serial->interface);
223 if (retval)
224 goto error_get_interface;
f5b0953a 225
cc56cd01
AS
226 mutex_unlock(&serial->disc_mutex);
227
7e29bb4b
AS
228 /* allow the driver to update the settings */
229 if (serial->type->init_termios)
230 serial->type->init_termios(tty);
231
cc56cd01
AS
232 tty->driver_data = port;
233
f5b0953a
AS
234 /* Final install (we use the default method) */
235 tty_driver_kref_get(driver);
236 tty->count++;
237 driver->ttys[idx] = tty;
cc56cd01
AS
238 return retval;
239
cc56cd01 240 error_get_interface:
7e29bb4b 241 error_init_termios:
cc56cd01
AS
242 module_put(serial->type->driver.owner);
243 error_module_get:
244 error_no_port:
245 usb_serial_put(serial);
246 mutex_unlock(&serial->disc_mutex);
247 return retval;
f5b0953a
AS
248}
249
64bc3979 250static int serial_activate(struct tty_port *tport, struct tty_struct *tty)
1da177e4 251{
64bc3979
AC
252 struct usb_serial_port *port =
253 container_of(tport, struct usb_serial_port, port);
320348c8
AS
254 struct usb_serial *serial = port->serial;
255 int retval;
331879fd 256
64bc3979
AC
257 if (mutex_lock_interruptible(&port->mutex))
258 return -ERESTARTSYS;
259 mutex_lock(&serial->disc_mutex);
260 if (serial->disconnected)
261 retval = -ENODEV;
262 else
263 retval = port->serial->type->open(tty, port);
264 mutex_unlock(&serial->disc_mutex);
265 mutex_unlock(&port->mutex);
266 return retval;
267}
1da177e4 268
64bc3979
AC
269static int serial_open(struct tty_struct *tty, struct file *filp)
270{
271 struct usb_serial_port *port = tty->driver_data;
320348c8 272
64bc3979
AC
273 dbg("%s - port %d", __func__, port->number);
274 return tty_port_open(&port->port, tty, filp);
1da177e4
LT
275}
276
335f8514 277/**
74556123 278 * serial_down - shut down hardware
f5b0953a 279 * @port: port to shut down
335f8514 280 *
f5b0953a
AS
281 * Shut down a USB serial port unless it is the console. We never
282 * shut down the console hardware as it will always be in use.
335f8514 283 */
74556123 284static void serial_down(struct usb_serial_port *port)
1da177e4 285{
335f8514 286 struct usb_serial_driver *drv = port->serial->type;
1da177e4 287
f5b0953a
AS
288 /*
289 * The console is magical. Do not hang up the console hardware
290 * or there will be tears.
291 */
335f8514 292 if (port->console)
1da177e4
LT
293 return;
294
ff8324df
AS
295 /* Don't call the close method if the hardware hasn't been
296 * initialized.
297 */
298 if (!test_and_clear_bit(ASYNCB_INITIALIZED, &port->port.flags))
299 return;
300
1ce7dd26 301 mutex_lock(&port->mutex);
335f8514
AC
302 if (drv->close)
303 drv->close(port);
1ce7dd26 304 mutex_unlock(&port->mutex);
335f8514
AC
305}
306
f5b0953a
AS
307static void serial_hangup(struct tty_struct *tty)
308{
309 struct usb_serial_port *port = tty->driver_data;
ff8324df
AS
310
311 dbg("%s - port %d", __func__, port->number);
312
74556123 313 serial_down(port);
f5b0953a 314 tty_port_hangup(&port->port);
f5b0953a
AS
315}
316
317static void serial_close(struct tty_struct *tty, struct file *filp)
318{
319 struct usb_serial_port *port = tty->driver_data;
320
f5b0953a
AS
321 dbg("%s - port %d", __func__, port->number);
322
ff8324df
AS
323 if (tty_hung_up_p(filp))
324 return;
f5b0953a
AS
325 if (tty_port_close_start(&port->port, tty, filp) == 0)
326 return;
74556123 327 serial_down(port);
f5b0953a
AS
328 tty_port_close_end(&port->port, tty);
329 tty_port_tty_set(&port->port, NULL);
f5b0953a
AS
330}
331
335f8514 332/**
f278a2f7 333 * serial_cleanup - free resources post close/hangup
f5b0953a 334 * @port: port to free up
335f8514 335 *
f5b0953a
AS
336 * Do the resource freeing and refcount dropping for the port.
337 * Avoid freeing the console.
4455e344 338 *
f278a2f7
DY
339 * Called asynchronously after the last tty kref is dropped,
340 * and the tty layer has already done the tty_shutdown(tty);
335f8514 341 */
f278a2f7 342static void serial_cleanup(struct tty_struct *tty)
335f8514 343{
4455e344 344 struct usb_serial_port *port = tty->driver_data;
335f8514
AC
345 struct usb_serial *serial;
346 struct module *owner;
347
f5b0953a
AS
348 /* The console is magical. Do not hang up the console hardware
349 * or there will be tears.
350 */
cc56cd01 351 if (port->console)
335f8514
AC
352 return;
353
ff8324df
AS
354 dbg("%s - port %d", __func__, port->number);
355
cc56cd01
AS
356 tty->driver_data = NULL;
357
335f8514
AC
358 serial = port->serial;
359 owner = serial->type->driver.owner;
41bd34dd 360
335f8514
AC
361 mutex_lock(&serial->disc_mutex);
362 if (!serial->disconnected)
363 usb_autopm_put_interface(serial->interface);
364 mutex_unlock(&serial->disc_mutex);
41bd34dd 365
2d93148a 366 usb_serial_put(serial);
335f8514
AC
367 module_put(owner);
368}
369
a8d6f0a9
AC
370static int serial_write(struct tty_struct *tty, const unsigned char *buf,
371 int count)
1da177e4 372{
81671ddb 373 struct usb_serial_port *port = tty->driver_data;
3ff4fd94 374 int retval = -ENODEV;
1da177e4 375
f34d7a5b 376 if (port->serial->dev->state == USB_STATE_NOTATTACHED)
487f9c67
LFC
377 goto exit;
378
441b62c1 379 dbg("%s - port %d, %d byte(s)", __func__, port->number, count);
1da177e4 380
95da310e 381 /* count is managed under the mutex lock for the tty so cannot
a8d6f0a9 382 drop to zero until after the last close completes */
95da310e 383 WARN_ON(!port->port.count);
1da177e4
LT
384
385 /* pass on to the driver specific version of this function */
95da310e 386 retval = port->serial->type->write(tty, port, buf, count);
1da177e4
LT
387
388exit:
389 return retval;
390}
391
a8d6f0a9 392static int serial_write_room(struct tty_struct *tty)
1da177e4 393{
81671ddb 394 struct usb_serial_port *port = tty->driver_data;
441b62c1 395 dbg("%s - port %d", __func__, port->number);
95da310e 396 WARN_ON(!port->port.count);
1da177e4 397 /* pass on to the driver specific version of this function */
95da310e 398 return port->serial->type->write_room(tty);
1da177e4
LT
399}
400
a8d6f0a9 401static int serial_chars_in_buffer(struct tty_struct *tty)
1da177e4 402{
81671ddb 403 struct usb_serial_port *port = tty->driver_data;
441b62c1 404 dbg("%s = port %d", __func__, port->number);
1da177e4 405
eff6937a
AC
406 /* if the device was unplugged then any remaining characters
407 fell out of the connector ;) */
408 if (port->serial->disconnected)
409 return 0;
1da177e4 410 /* pass on to the driver specific version of this function */
95da310e 411 return port->serial->type->chars_in_buffer(tty);
1da177e4
LT
412}
413
a8d6f0a9 414static void serial_throttle(struct tty_struct *tty)
1da177e4 415{
81671ddb 416 struct usb_serial_port *port = tty->driver_data;
441b62c1 417 dbg("%s - port %d", __func__, port->number);
1da177e4 418
95da310e 419 WARN_ON(!port->port.count);
1da177e4
LT
420 /* pass on to the driver specific version of this function */
421 if (port->serial->type->throttle)
95da310e 422 port->serial->type->throttle(tty);
1da177e4
LT
423}
424
a8d6f0a9 425static void serial_unthrottle(struct tty_struct *tty)
1da177e4 426{
81671ddb 427 struct usb_serial_port *port = tty->driver_data;
441b62c1 428 dbg("%s - port %d", __func__, port->number);
1da177e4 429
95da310e 430 WARN_ON(!port->port.count);
1da177e4
LT
431 /* pass on to the driver specific version of this function */
432 if (port->serial->type->unthrottle)
95da310e 433 port->serial->type->unthrottle(tty);
1da177e4
LT
434}
435
a8d6f0a9
AC
436static int serial_ioctl(struct tty_struct *tty, struct file *file,
437 unsigned int cmd, unsigned long arg)
1da177e4 438{
81671ddb 439 struct usb_serial_port *port = tty->driver_data;
1da177e4
LT
440 int retval = -ENODEV;
441
441b62c1 442 dbg("%s - port %d, cmd 0x%.4x", __func__, port->number, cmd);
1da177e4 443
95da310e 444 WARN_ON(!port->port.count);
1da177e4 445
a8d6f0a9
AC
446 /* pass on to the driver specific version of this function
447 if it is available */
f34d7a5b 448 if (port->serial->type->ioctl) {
95da310e 449 retval = port->serial->type->ioctl(tty, file, cmd, arg);
a8d6f0a9 450 } else
1da177e4 451 retval = -ENOIOCTLCMD;
1da177e4
LT
452 return retval;
453}
454
a8d6f0a9 455static void serial_set_termios(struct tty_struct *tty, struct ktermios *old)
1da177e4 456{
81671ddb 457 struct usb_serial_port *port = tty->driver_data;
441b62c1 458 dbg("%s - port %d", __func__, port->number);
1da177e4 459
95da310e 460 WARN_ON(!port->port.count);
a8d6f0a9
AC
461 /* pass on to the driver specific version of this function
462 if it is available */
1da177e4 463 if (port->serial->type->set_termios)
95da310e 464 port->serial->type->set_termios(tty, port, old);
33785091
AC
465 else
466 tty_termios_copy_hw(tty->termios, old);
1da177e4
LT
467}
468
9e98966c 469static int serial_break(struct tty_struct *tty, int break_state)
1da177e4 470{
81671ddb 471 struct usb_serial_port *port = tty->driver_data;
1da177e4 472
441b62c1 473 dbg("%s - port %d", __func__, port->number);
1da177e4 474
95da310e 475 WARN_ON(!port->port.count);
a8d6f0a9
AC
476 /* pass on to the driver specific version of this function
477 if it is available */
6b447f04 478 if (port->serial->type->break_ctl)
95da310e 479 port->serial->type->break_ctl(tty, break_state);
9e98966c 480 return 0;
1da177e4
LT
481}
482
6fd69d3c 483static int serial_proc_show(struct seq_file *m, void *v)
1da177e4
LT
484{
485 struct usb_serial *serial;
1da177e4 486 int i;
1da177e4
LT
487 char tmp[40];
488
441b62c1 489 dbg("%s", __func__);
6fd69d3c
AD
490 seq_puts(m, "usbserinfo:1.0 driver:2.0\n");
491 for (i = 0; i < SERIAL_TTY_MINORS; ++i) {
1da177e4
LT
492 serial = usb_serial_get_by_index(i);
493 if (serial == NULL)
494 continue;
495
6fd69d3c 496 seq_printf(m, "%d:", i);
18fcac35 497 if (serial->type->driver.owner)
6fd69d3c 498 seq_printf(m, " module:%s",
a8d6f0a9 499 module_name(serial->type->driver.owner));
6fd69d3c 500 seq_printf(m, " name:\"%s\"",
a8d6f0a9 501 serial->type->description);
6fd69d3c 502 seq_printf(m, " vendor:%04x product:%04x",
a8d6f0a9
AC
503 le16_to_cpu(serial->dev->descriptor.idVendor),
504 le16_to_cpu(serial->dev->descriptor.idProduct));
6fd69d3c
AD
505 seq_printf(m, " num_ports:%d", serial->num_ports);
506 seq_printf(m, " port:%d", i - serial->minor + 1);
1da177e4 507 usb_make_path(serial->dev, tmp, sizeof(tmp));
6fd69d3c 508 seq_printf(m, " path:%s", tmp);
a8d6f0a9 509
6fd69d3c 510 seq_putc(m, '\n');
73e487fd 511 usb_serial_put(serial);
8bc2c1b2 512 mutex_unlock(&serial->disc_mutex);
1da177e4 513 }
6fd69d3c 514 return 0;
1da177e4
LT
515}
516
6fd69d3c
AD
517static int serial_proc_open(struct inode *inode, struct file *file)
518{
519 return single_open(file, serial_proc_show, NULL);
520}
521
522static const struct file_operations serial_proc_fops = {
523 .owner = THIS_MODULE,
524 .open = serial_proc_open,
525 .read = seq_read,
526 .llseek = seq_lseek,
527 .release = single_release,
528};
529
a8d6f0a9 530static int serial_tiocmget(struct tty_struct *tty, struct file *file)
1da177e4 531{
81671ddb 532 struct usb_serial_port *port = tty->driver_data;
1da177e4 533
441b62c1 534 dbg("%s - port %d", __func__, port->number);
1da177e4 535
95da310e 536 WARN_ON(!port->port.count);
1da177e4 537 if (port->serial->type->tiocmget)
95da310e 538 return port->serial->type->tiocmget(tty, file);
1da177e4
LT
539 return -EINVAL;
540}
541
a8d6f0a9 542static int serial_tiocmset(struct tty_struct *tty, struct file *file,
1da177e4
LT
543 unsigned int set, unsigned int clear)
544{
81671ddb 545 struct usb_serial_port *port = tty->driver_data;
1da177e4 546
441b62c1 547 dbg("%s - port %d", __func__, port->number);
1da177e4 548
95da310e 549 WARN_ON(!port->port.count);
1da177e4 550 if (port->serial->type->tiocmset)
95da310e 551 return port->serial->type->tiocmset(tty, file, set, clear);
1da177e4
LT
552 return -EINVAL;
553}
554
cf2c7481
PZ
555/*
556 * We would be calling tty_wakeup here, but unfortunately some line
557 * disciplines have an annoying habit of calling tty->write from
558 * the write wakeup callback (e.g. n_hdlc.c).
559 */
560void usb_serial_port_softint(struct usb_serial_port *port)
561{
562 schedule_work(&port->work);
563}
a8d6f0a9 564EXPORT_SYMBOL_GPL(usb_serial_port_softint);
cf2c7481 565
c4028958 566static void usb_serial_port_work(struct work_struct *work)
1da177e4 567{
c4028958
DH
568 struct usb_serial_port *port =
569 container_of(work, struct usb_serial_port, work);
1da177e4
LT
570 struct tty_struct *tty;
571
441b62c1 572 dbg("%s - port %d", __func__, port->number);
a8d6f0a9 573
4a90f09b 574 tty = tty_port_tty_get(&port->port);
1da177e4
LT
575 if (!tty)
576 return;
577
578 tty_wakeup(tty);
4a90f09b 579 tty_kref_put(tty);
1da177e4
LT
580}
581
34ef50e5 582static void kill_traffic(struct usb_serial_port *port)
34f8e761 583{
1da177e4 584 usb_kill_urb(port->read_urb);
1da177e4 585 usb_kill_urb(port->write_urb);
5adceac5
ON
586 /*
587 * This is tricky.
588 * Some drivers submit the read_urb in the
589 * handler for the write_urb or vice versa
590 * this order determines the order in which
591 * usb_kill_urb() must be used to reliably
592 * kill the URBs. As it is unknown here,
593 * both orders must be used in turn.
594 * The call below is not redundant.
595 */
596 usb_kill_urb(port->read_urb);
1da177e4 597 usb_kill_urb(port->interrupt_in_urb);
1da177e4 598 usb_kill_urb(port->interrupt_out_urb);
34ef50e5
ON
599}
600
41bd34dd 601static void port_release(struct device *dev)
34ef50e5 602{
41bd34dd
AS
603 struct usb_serial_port *port = to_usb_serial_port(dev);
604
605 dbg ("%s - %s", __func__, dev_name(dev));
606
2d93148a
AS
607 /*
608 * Stop all the traffic before cancelling the work, so that
609 * nobody will restart it by calling usb_serial_port_softint.
610 */
34ef50e5 611 kill_traffic(port);
2d93148a
AS
612 cancel_work_sync(&port->work);
613
34ef50e5
ON
614 usb_free_urb(port->read_urb);
615 usb_free_urb(port->write_urb);
616 usb_free_urb(port->interrupt_in_urb);
1da177e4 617 usb_free_urb(port->interrupt_out_urb);
8e8dce06
DV
618 if (!IS_ERR(port->write_fifo) && port->write_fifo)
619 kfifo_free(port->write_fifo);
1da177e4
LT
620 kfree(port->bulk_in_buffer);
621 kfree(port->bulk_out_buffer);
622 kfree(port->interrupt_in_buffer);
623 kfree(port->interrupt_out_buffer);
624 kfree(port);
625}
626
a8d6f0a9
AC
627static struct usb_serial *create_serial(struct usb_device *dev,
628 struct usb_interface *interface,
629 struct usb_serial_driver *driver)
1da177e4
LT
630{
631 struct usb_serial *serial;
632
80b6ca48 633 serial = kzalloc(sizeof(*serial), GFP_KERNEL);
1da177e4 634 if (!serial) {
441b62c1 635 dev_err(&dev->dev, "%s - out of memory\n", __func__);
1da177e4
LT
636 return NULL;
637 }
1da177e4 638 serial->dev = usb_get_dev(dev);
ea65370d 639 serial->type = driver;
1da177e4
LT
640 serial->interface = interface;
641 kref_init(&serial->kref);
a1cd7e99 642 mutex_init(&serial->disc_mutex);
0282b7f2 643 serial->minor = SERIAL_TTY_NO_MINOR;
1da177e4
LT
644
645 return serial;
646}
647
93bacefc 648static const struct usb_device_id *match_dynamic_id(struct usb_interface *intf,
a8d6f0a9 649 struct usb_serial_driver *drv)
93bacefc
GKH
650{
651 struct usb_dynid *dynid;
652
653 spin_lock(&drv->dynids.lock);
654 list_for_each_entry(dynid, &drv->dynids.list, node) {
655 if (usb_match_one_id(intf, &dynid->id)) {
656 spin_unlock(&drv->dynids.lock);
657 return &dynid->id;
658 }
659 }
660 spin_unlock(&drv->dynids.lock);
661 return NULL;
662}
663
664static const struct usb_device_id *get_iface_id(struct usb_serial_driver *drv,
665 struct usb_interface *intf)
666{
667 const struct usb_device_id *id;
668
669 id = usb_match_id(intf, drv->id_table);
670 if (id) {
671 dbg("static descriptor matches");
672 goto exit;
673 }
674 id = match_dynamic_id(intf, drv);
675 if (id)
676 dbg("dynamic descriptor matches");
677exit:
678 return id;
679}
680
a8d6f0a9
AC
681static struct usb_serial_driver *search_serial_device(
682 struct usb_interface *iface)
1da177e4 683{
1da177e4 684 const struct usb_device_id *id;
063a2da8 685 struct usb_serial_driver *drv;
1da177e4 686
93b1fae4 687 /* Check if the usb id matches a known device */
063a2da8
AS
688 list_for_each_entry(drv, &usb_serial_driver_list, driver_list) {
689 id = get_iface_id(drv, iface);
93bacefc 690 if (id)
063a2da8 691 return drv;
1da177e4
LT
692 }
693
694 return NULL;
695}
696
335f8514
AC
697static int serial_carrier_raised(struct tty_port *port)
698{
699 struct usb_serial_port *p = container_of(port, struct usb_serial_port, port);
700 struct usb_serial_driver *drv = p->serial->type;
701 if (drv->carrier_raised)
702 return drv->carrier_raised(p);
703 /* No carrier control - don't block */
704 return 1;
705}
706
707static void serial_dtr_rts(struct tty_port *port, int on)
708{
709 struct usb_serial_port *p = container_of(port, struct usb_serial_port, port);
710 struct usb_serial_driver *drv = p->serial->type;
711 if (drv->dtr_rts)
712 drv->dtr_rts(p, on);
713}
714
715static const struct tty_port_operations serial_port_ops = {
716 .carrier_raised = serial_carrier_raised,
717 .dtr_rts = serial_dtr_rts,
64bc3979 718 .activate = serial_activate,
335f8514
AC
719};
720
1da177e4
LT
721int usb_serial_probe(struct usb_interface *interface,
722 const struct usb_device_id *id)
723{
a8d6f0a9 724 struct usb_device *dev = interface_to_usbdev(interface);
1da177e4
LT
725 struct usb_serial *serial = NULL;
726 struct usb_serial_port *port;
727 struct usb_host_interface *iface_desc;
728 struct usb_endpoint_descriptor *endpoint;
729 struct usb_endpoint_descriptor *interrupt_in_endpoint[MAX_NUM_PORTS];
730 struct usb_endpoint_descriptor *interrupt_out_endpoint[MAX_NUM_PORTS];
731 struct usb_endpoint_descriptor *bulk_in_endpoint[MAX_NUM_PORTS];
732 struct usb_endpoint_descriptor *bulk_out_endpoint[MAX_NUM_PORTS];
ea65370d 733 struct usb_serial_driver *type = NULL;
1da177e4 734 int retval;
dd9ca5d9 735 unsigned int minor;
1da177e4
LT
736 int buffer_size;
737 int i;
738 int num_interrupt_in = 0;
739 int num_interrupt_out = 0;
740 int num_bulk_in = 0;
741 int num_bulk_out = 0;
742 int num_ports = 0;
743 int max_endpoints;
744
4b10f0f3 745 lock_kernel(); /* guard against unloading a serial driver module */
1da177e4
LT
746 type = search_serial_device(interface);
747 if (!type) {
4b10f0f3 748 unlock_kernel();
1da177e4
LT
749 dbg("none matched");
750 return -ENODEV;
751 }
752
a8d6f0a9 753 serial = create_serial(dev, interface, type);
1da177e4 754 if (!serial) {
4b10f0f3 755 unlock_kernel();
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
18fcac35 764 if (!try_module_get(type->driver.owner)) {
4b10f0f3 765 unlock_kernel();
a8d6f0a9
AC
766 dev_err(&interface->dev,
767 "module get failed, exiting\n");
768 kfree(serial);
1da177e4
LT
769 return -EIO;
770 }
771
93bacefc 772 id = get_iface_id(type, interface);
1da177e4 773 retval = type->probe(serial, id);
18fcac35 774 module_put(type->driver.owner);
1da177e4
LT
775
776 if (retval) {
4b10f0f3 777 unlock_kernel();
a8d6f0a9
AC
778 dbg("sub driver rejected device");
779 kfree(serial);
1da177e4
LT
780 return retval;
781 }
782 }
783
784 /* descriptor matches, let's find the endpoints needed */
785 /* check out the endpoints */
786 iface_desc = interface->cur_altsetting;
787 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
788 endpoint = &iface_desc->endpoint[i].desc;
4fa1bbf5
LFC
789
790 if (usb_endpoint_is_bulk_in(endpoint)) {
1da177e4
LT
791 /* we found a bulk in endpoint */
792 dbg("found bulk in on endpoint %d", i);
793 bulk_in_endpoint[num_bulk_in] = endpoint;
794 ++num_bulk_in;
795 }
796
4fa1bbf5 797 if (usb_endpoint_is_bulk_out(endpoint)) {
1da177e4
LT
798 /* we found a bulk out endpoint */
799 dbg("found bulk out on endpoint %d", i);
800 bulk_out_endpoint[num_bulk_out] = endpoint;
801 ++num_bulk_out;
802 }
4fa1bbf5
LFC
803
804 if (usb_endpoint_is_int_in(endpoint)) {
1da177e4
LT
805 /* we found a interrupt in endpoint */
806 dbg("found interrupt in on endpoint %d", i);
807 interrupt_in_endpoint[num_interrupt_in] = endpoint;
808 ++num_interrupt_in;
809 }
810
4fa1bbf5 811 if (usb_endpoint_is_int_out(endpoint)) {
1da177e4
LT
812 /* we found an interrupt out endpoint */
813 dbg("found interrupt out on endpoint %d", i);
814 interrupt_out_endpoint[num_interrupt_out] = endpoint;
815 ++num_interrupt_out;
816 }
817 }
818
819#if defined(CONFIG_USB_SERIAL_PL2303) || defined(CONFIG_USB_SERIAL_PL2303_MODULE)
a8d6f0a9 820 /* BEGIN HORRIBLE HACK FOR PL2303 */
1da177e4
LT
821 /* this is needed due to the looney way its endpoints are set up */
822 if (((le16_to_cpu(dev->descriptor.idVendor) == PL2303_VENDOR_ID) &&
823 (le16_to_cpu(dev->descriptor.idProduct) == PL2303_PRODUCT_ID)) ||
824 ((le16_to_cpu(dev->descriptor.idVendor) == ATEN_VENDOR_ID) &&
8fd80133
JS
825 (le16_to_cpu(dev->descriptor.idProduct) == ATEN_PRODUCT_ID)) ||
826 ((le16_to_cpu(dev->descriptor.idVendor) == ALCOR_VENDOR_ID) &&
ce816cf9
AB
827 (le16_to_cpu(dev->descriptor.idProduct) == ALCOR_PRODUCT_ID)) ||
828 ((le16_to_cpu(dev->descriptor.idVendor) == SIEMENS_VENDOR_ID) &&
829 (le16_to_cpu(dev->descriptor.idProduct) == SIEMENS_PRODUCT_ID_EF81))) {
1da177e4
LT
830 if (interface != dev->actconfig->interface[0]) {
831 /* check out the endpoints of the other interface*/
832 iface_desc = dev->actconfig->interface[0]->cur_altsetting;
833 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
834 endpoint = &iface_desc->endpoint[i].desc;
4fa1bbf5 835 if (usb_endpoint_is_int_in(endpoint)) {
1da177e4
LT
836 /* we found a interrupt in endpoint */
837 dbg("found interrupt in for Prolific device on separate interface");
838 interrupt_in_endpoint[num_interrupt_in] = endpoint;
839 ++num_interrupt_in;
840 }
841 }
842 }
843
844 /* Now make sure the PL-2303 is configured correctly.
845 * If not, give up now and hope this hack will work
846 * properly during a later invocation of usb_serial_probe
847 */
848 if (num_bulk_in == 0 || num_bulk_out == 0) {
4b10f0f3 849 unlock_kernel();
1da177e4 850 dev_info(&interface->dev, "PL-2303 hack: descriptors matched but endpoints did not\n");
a8d6f0a9 851 kfree(serial);
1da177e4
LT
852 return -ENODEV;
853 }
854 }
855 /* END HORRIBLE HACK FOR PL2303 */
856#endif
857
1da177e4
LT
858#ifdef CONFIG_USB_SERIAL_GENERIC
859 if (type == &usb_serial_generic_device) {
860 num_ports = num_bulk_out;
861 if (num_ports == 0) {
4b10f0f3 862 unlock_kernel();
a8d6f0a9
AC
863 dev_err(&interface->dev,
864 "Generic device with no bulk out, not allowed.\n");
865 kfree(serial);
1da177e4
LT
866 return -EIO;
867 }
868 }
869#endif
870 if (!num_ports) {
871 /* if this device type has a calc_num_ports function, call it */
872 if (type->calc_num_ports) {
18fcac35 873 if (!try_module_get(type->driver.owner)) {
4b10f0f3 874 unlock_kernel();
a8d6f0a9
AC
875 dev_err(&interface->dev,
876 "module get failed, exiting\n");
877 kfree(serial);
1da177e4
LT
878 return -EIO;
879 }
a8d6f0a9 880 num_ports = type->calc_num_ports(serial);
18fcac35 881 module_put(type->driver.owner);
1da177e4
LT
882 }
883 if (!num_ports)
884 num_ports = type->num_ports;
885 }
886
1da177e4
LT
887 serial->num_ports = num_ports;
888 serial->num_bulk_in = num_bulk_in;
889 serial->num_bulk_out = num_bulk_out;
890 serial->num_interrupt_in = num_interrupt_in;
891 serial->num_interrupt_out = num_interrupt_out;
892
063a2da8
AS
893 /* found all that we need */
894 dev_info(&interface->dev, "%s converter detected\n",
895 type->description);
896
1da177e4 897 /* create our ports, we need as many as the max endpoints */
a8d6f0a9
AC
898 /* we don't use num_ports here because some devices have more
899 endpoint pairs than ports */
1da177e4
LT
900 max_endpoints = max(num_bulk_in, num_bulk_out);
901 max_endpoints = max(max_endpoints, num_interrupt_in);
902 max_endpoints = max(max_endpoints, num_interrupt_out);
903 max_endpoints = max(max_endpoints, (int)serial->num_ports);
904 serial->num_port_pointers = max_endpoints;
4b10f0f3
ON
905 unlock_kernel();
906
a8d6f0a9
AC
907 dbg("%s - setting up %d port structures for this device",
908 __func__, max_endpoints);
1da177e4 909 for (i = 0; i < max_endpoints; ++i) {
80b6ca48 910 port = kzalloc(sizeof(struct usb_serial_port), GFP_KERNEL);
1da177e4
LT
911 if (!port)
912 goto probe_error;
4a90f09b 913 tty_port_init(&port->port);
335f8514 914 port->port.ops = &serial_port_ops;
1da177e4 915 port->serial = serial;
507ca9bc 916 spin_lock_init(&port->lock);
1ce7dd26 917 mutex_init(&port->mutex);
c4028958 918 INIT_WORK(&port->work, usb_serial_port_work);
1da177e4 919 serial->port[i] = port;
41bd34dd
AS
920 port->dev.parent = &interface->dev;
921 port->dev.driver = NULL;
922 port->dev.bus = &usb_serial_bus_type;
923 port->dev.release = &port_release;
924 device_initialize(&port->dev);
1da177e4
LT
925 }
926
927 /* set up the endpoint information */
928 for (i = 0; i < num_bulk_in; ++i) {
929 endpoint = bulk_in_endpoint[i];
930 port = serial->port[i];
a8d6f0a9 931 port->read_urb = usb_alloc_urb(0, GFP_KERNEL);
1da177e4
LT
932 if (!port->read_urb) {
933 dev_err(&interface->dev, "No free urbs available\n");
934 goto probe_error;
935 }
936 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
937 port->bulk_in_size = buffer_size;
938 port->bulk_in_endpointAddress = endpoint->bEndpointAddress;
a8d6f0a9 939 port->bulk_in_buffer = kmalloc(buffer_size, GFP_KERNEL);
1da177e4 940 if (!port->bulk_in_buffer) {
a8d6f0a9
AC
941 dev_err(&interface->dev,
942 "Couldn't allocate bulk_in_buffer\n");
1da177e4
LT
943 goto probe_error;
944 }
a8d6f0a9
AC
945 usb_fill_bulk_urb(port->read_urb, dev,
946 usb_rcvbulkpipe(dev,
947 endpoint->bEndpointAddress),
948 port->bulk_in_buffer, buffer_size,
949 serial->type->read_bulk_callback, port);
1da177e4
LT
950 }
951
952 for (i = 0; i < num_bulk_out; ++i) {
953 endpoint = bulk_out_endpoint[i];
954 port = serial->port[i];
955 port->write_urb = usb_alloc_urb(0, GFP_KERNEL);
956 if (!port->write_urb) {
957 dev_err(&interface->dev, "No free urbs available\n");
958 goto probe_error;
959 }
8e8dce06
DV
960 port->write_fifo = kfifo_alloc(PAGE_SIZE, GFP_KERNEL,
961 &port->lock);
962 if (IS_ERR(port->write_fifo))
963 goto probe_error;
1da177e4
LT
964 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
965 port->bulk_out_size = buffer_size;
966 port->bulk_out_endpointAddress = endpoint->bEndpointAddress;
a8d6f0a9 967 port->bulk_out_buffer = kmalloc(buffer_size, GFP_KERNEL);
1da177e4 968 if (!port->bulk_out_buffer) {
a8d6f0a9
AC
969 dev_err(&interface->dev,
970 "Couldn't allocate bulk_out_buffer\n");
1da177e4
LT
971 goto probe_error;
972 }
a8d6f0a9
AC
973 usb_fill_bulk_urb(port->write_urb, dev,
974 usb_sndbulkpipe(dev,
975 endpoint->bEndpointAddress),
976 port->bulk_out_buffer, buffer_size,
977 serial->type->write_bulk_callback, port);
1da177e4
LT
978 }
979
980 if (serial->type->read_int_callback) {
981 for (i = 0; i < num_interrupt_in; ++i) {
982 endpoint = interrupt_in_endpoint[i];
983 port = serial->port[i];
984 port->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
985 if (!port->interrupt_in_urb) {
a8d6f0a9
AC
986 dev_err(&interface->dev,
987 "No free urbs available\n");
1da177e4
LT
988 goto probe_error;
989 }
990 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
a8d6f0a9
AC
991 port->interrupt_in_endpointAddress =
992 endpoint->bEndpointAddress;
993 port->interrupt_in_buffer = kmalloc(buffer_size,
994 GFP_KERNEL);
1da177e4 995 if (!port->interrupt_in_buffer) {
a8d6f0a9
AC
996 dev_err(&interface->dev,
997 "Couldn't allocate interrupt_in_buffer\n");
1da177e4
LT
998 goto probe_error;
999 }
a8d6f0a9
AC
1000 usb_fill_int_urb(port->interrupt_in_urb, dev,
1001 usb_rcvintpipe(dev,
1002 endpoint->bEndpointAddress),
1003 port->interrupt_in_buffer, buffer_size,
1004 serial->type->read_int_callback, port,
1005 endpoint->bInterval);
1da177e4
LT
1006 }
1007 } else if (num_interrupt_in) {
1008 dbg("the device claims to support interrupt in transfers, but read_int_callback is not defined");
1009 }
a8d6f0a9 1010
1da177e4
LT
1011 if (serial->type->write_int_callback) {
1012 for (i = 0; i < num_interrupt_out; ++i) {
1013 endpoint = interrupt_out_endpoint[i];
1014 port = serial->port[i];
1015 port->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
1016 if (!port->interrupt_out_urb) {
a8d6f0a9
AC
1017 dev_err(&interface->dev,
1018 "No free urbs available\n");
1da177e4
LT
1019 goto probe_error;
1020 }
1021 buffer_size = le16_to_cpu(endpoint->wMaxPacketSize);
1022 port->interrupt_out_size = buffer_size;
a8d6f0a9
AC
1023 port->interrupt_out_endpointAddress =
1024 endpoint->bEndpointAddress;
1025 port->interrupt_out_buffer = kmalloc(buffer_size,
1026 GFP_KERNEL);
1da177e4 1027 if (!port->interrupt_out_buffer) {
a8d6f0a9
AC
1028 dev_err(&interface->dev,
1029 "Couldn't allocate interrupt_out_buffer\n");
1da177e4
LT
1030 goto probe_error;
1031 }
a8d6f0a9
AC
1032 usb_fill_int_urb(port->interrupt_out_urb, dev,
1033 usb_sndintpipe(dev,
1034 endpoint->bEndpointAddress),
1035 port->interrupt_out_buffer, buffer_size,
1036 serial->type->write_int_callback, port,
1037 endpoint->bInterval);
1da177e4
LT
1038 }
1039 } else if (num_interrupt_out) {
1040 dbg("the device claims to support interrupt out transfers, but write_int_callback is not defined");
1041 }
a8d6f0a9 1042
1da177e4
LT
1043 /* if this device type has an attach function, call it */
1044 if (type->attach) {
18fcac35 1045 if (!try_module_get(type->driver.owner)) {
a8d6f0a9
AC
1046 dev_err(&interface->dev,
1047 "module get failed, exiting\n");
1da177e4
LT
1048 goto probe_error;
1049 }
a8d6f0a9 1050 retval = type->attach(serial);
18fcac35 1051 module_put(type->driver.owner);
1da177e4
LT
1052 if (retval < 0)
1053 goto probe_error;
a4720c65 1054 serial->attached = 1;
1da177e4 1055 if (retval > 0) {
a8d6f0a9
AC
1056 /* quietly accept this device, but don't bind to a
1057 serial port as it's about to disappear */
0a3c8549 1058 serial->num_ports = 0;
1da177e4
LT
1059 goto exit;
1060 }
a4720c65
AS
1061 } else {
1062 serial->attached = 1;
1da177e4
LT
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);
a5f6005d
ON
1162 if (r < 0) {
1163 serial->suspending = 0;
81e5b23c 1164 goto err_out;
a5f6005d 1165 }
81e5b23c
ON
1166 }
1167
e31c1880
ON
1168 for (i = 0; i < serial->num_ports; ++i) {
1169 port = serial->port[i];
1170 if (port)
1171 kill_traffic(port);
ec22559e
ON
1172 }
1173
81e5b23c 1174err_out:
ec22559e
ON
1175 return r;
1176}
1177EXPORT_SYMBOL(usb_serial_suspend);
1178
1179int usb_serial_resume(struct usb_interface *intf)
1180{
1181 struct usb_serial *serial = usb_get_intfdata(intf);
c49cfa91 1182 int rv;
ec22559e 1183
f8bece8d 1184 serial->suspending = 0;
8abaee23 1185 if (serial->type->resume)
c49cfa91
ON
1186 rv = serial->type->resume(serial);
1187 else
1188 rv = usb_serial_generic_resume(serial);
f8bece8d 1189
c49cfa91 1190 return rv;
ec22559e
ON
1191}
1192EXPORT_SYMBOL(usb_serial_resume);
1193
b68e31d0 1194static const struct tty_operations serial_ops = {
1da177e4
LT
1195 .open = serial_open,
1196 .close = serial_close,
1197 .write = serial_write,
335f8514 1198 .hangup = serial_hangup,
1da177e4
LT
1199 .write_room = serial_write_room,
1200 .ioctl = serial_ioctl,
1201 .set_termios = serial_set_termios,
1202 .throttle = serial_throttle,
1203 .unthrottle = serial_unthrottle,
1204 .break_ctl = serial_break,
1205 .chars_in_buffer = serial_chars_in_buffer,
1da177e4
LT
1206 .tiocmget = serial_tiocmget,
1207 .tiocmset = serial_tiocmset,
f278a2f7 1208 .cleanup = serial_cleanup,
fe1ae7fd 1209 .install = serial_install,
6fd69d3c 1210 .proc_fops = &serial_proc_fops,
1da177e4
LT
1211};
1212
335f8514 1213
1da177e4
LT
1214struct tty_driver *usb_serial_tty_driver;
1215
1216static int __init usb_serial_init(void)
1217{
1218 int i;
1219 int result;
1220
1221 usb_serial_tty_driver = alloc_tty_driver(SERIAL_TTY_MINORS);
1222 if (!usb_serial_tty_driver)
1223 return -ENOMEM;
1224
1225 /* Initialize our global data */
a8d6f0a9 1226 for (i = 0; i < SERIAL_TTY_MINORS; ++i)
1da177e4 1227 serial_table[i] = NULL;
1da177e4
LT
1228
1229 result = bus_register(&usb_serial_bus_type);
1230 if (result) {
194343d9
GKH
1231 printk(KERN_ERR "usb-serial: %s - registering bus driver "
1232 "failed\n", __func__);
1da177e4
LT
1233 goto exit_bus;
1234 }
1235
1da177e4
LT
1236 usb_serial_tty_driver->owner = THIS_MODULE;
1237 usb_serial_tty_driver->driver_name = "usbserial";
1da177e4
LT
1238 usb_serial_tty_driver->name = "ttyUSB";
1239 usb_serial_tty_driver->major = SERIAL_TTY_MAJOR;
1240 usb_serial_tty_driver->minor_start = 0;
1241 usb_serial_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
1242 usb_serial_tty_driver->subtype = SERIAL_TYPE_NORMAL;
a8d6f0a9
AC
1243 usb_serial_tty_driver->flags = TTY_DRIVER_REAL_RAW |
1244 TTY_DRIVER_DYNAMIC_DEV;
1da177e4 1245 usb_serial_tty_driver->init_termios = tty_std_termios;
a8d6f0a9
AC
1246 usb_serial_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD
1247 | HUPCL | CLOCAL;
a5b6f60c
AC
1248 usb_serial_tty_driver->init_termios.c_ispeed = 9600;
1249 usb_serial_tty_driver->init_termios.c_ospeed = 9600;
1da177e4
LT
1250 tty_set_operations(usb_serial_tty_driver, &serial_ops);
1251 result = tty_register_driver(usb_serial_tty_driver);
1252 if (result) {
194343d9
GKH
1253 printk(KERN_ERR "usb-serial: %s - tty_register_driver failed\n",
1254 __func__);
1da177e4
LT
1255 goto exit_reg_driver;
1256 }
1257
1258 /* register the USB driver */
1259 result = usb_register(&usb_serial_driver);
1260 if (result < 0) {
194343d9
GKH
1261 printk(KERN_ERR "usb-serial: %s - usb_register failed\n",
1262 __func__);
1da177e4
LT
1263 goto exit_tty;
1264 }
1265
06299db3
GKH
1266 /* register the generic driver, if we should */
1267 result = usb_serial_generic_register(debug);
1268 if (result < 0) {
194343d9
GKH
1269 printk(KERN_ERR "usb-serial: %s - registering generic "
1270 "driver failed\n", __func__);
06299db3
GKH
1271 goto exit_generic;
1272 }
1273
c197a8db 1274 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_DESC "\n");
1da177e4
LT
1275
1276 return result;
1277
06299db3
GKH
1278exit_generic:
1279 usb_deregister(&usb_serial_driver);
1280
1da177e4
LT
1281exit_tty:
1282 tty_unregister_driver(usb_serial_tty_driver);
1283
1284exit_reg_driver:
1da177e4
LT
1285 bus_unregister(&usb_serial_bus_type);
1286
1287exit_bus:
194343d9
GKH
1288 printk(KERN_ERR "usb-serial: %s - returning with error %d\n",
1289 __func__, result);
1da177e4
LT
1290 put_tty_driver(usb_serial_tty_driver);
1291 return result;
1292}
1293
1294
1295static void __exit usb_serial_exit(void)
1296{
1297 usb_serial_console_exit();
1298
1299 usb_serial_generic_deregister();
1300
1301 usb_deregister(&usb_serial_driver);
1302 tty_unregister_driver(usb_serial_tty_driver);
1303 put_tty_driver(usb_serial_tty_driver);
1304 bus_unregister(&usb_serial_bus_type);
1305}
1306
1307
1308module_init(usb_serial_init);
1309module_exit(usb_serial_exit);
1310
1311#define set_to_generic_if_null(type, function) \
1312 do { \
1313 if (!type->function) { \
1314 type->function = usb_serial_generic_##function; \
1315 dbg("Had to override the " #function \
a8d6f0a9 1316 " usb serial operation with the generic one.");\
1da177e4
LT
1317 } \
1318 } while (0)
1319
ea65370d 1320static void fixup_generic(struct usb_serial_driver *device)
1da177e4
LT
1321{
1322 set_to_generic_if_null(device, open);
1323 set_to_generic_if_null(device, write);
1324 set_to_generic_if_null(device, close);
1325 set_to_generic_if_null(device, write_room);
1326 set_to_generic_if_null(device, chars_in_buffer);
1327 set_to_generic_if_null(device, read_bulk_callback);
1328 set_to_generic_if_null(device, write_bulk_callback);
f9c99bb8
AS
1329 set_to_generic_if_null(device, disconnect);
1330 set_to_generic_if_null(device, release);
1da177e4
LT
1331}
1332
a8d6f0a9 1333int usb_serial_register(struct usb_serial_driver *driver)
1da177e4 1334{
a8d6f0a9 1335 /* must be called with BKL held */
1da177e4
LT
1336 int retval;
1337
e4abe665
DY
1338 if (usb_disabled())
1339 return -ENODEV;
1340
ea65370d 1341 fixup_generic(driver);
1da177e4 1342
269bda1c
GKH
1343 if (!driver->description)
1344 driver->description = driver->driver.name;
1345
1da177e4 1346 /* Add this device to our list of devices */
ea65370d 1347 list_add(&driver->driver_list, &usb_serial_driver_list);
1da177e4 1348
ea65370d 1349 retval = usb_serial_bus_register(driver);
1da177e4 1350 if (retval) {
194343d9
GKH
1351 printk(KERN_ERR "usb-serial: problem %d when registering "
1352 "driver %s\n", retval, driver->description);
ea65370d 1353 list_del(&driver->driver_list);
a8d6f0a9 1354 } else
c197a8db 1355 printk(KERN_INFO "USB Serial support registered for %s\n",
a8d6f0a9 1356 driver->description);
1da177e4
LT
1357
1358 return retval;
1359}
a8d6f0a9 1360EXPORT_SYMBOL_GPL(usb_serial_register);
1da177e4
LT
1361
1362
a8d6f0a9 1363void usb_serial_deregister(struct usb_serial_driver *device)
1da177e4 1364{
a8d6f0a9 1365 /* must be called with BKL held */
c197a8db
GKH
1366 printk(KERN_INFO "USB Serial deregistering driver %s\n",
1367 device->description);
1da177e4
LT
1368 list_del(&device->driver_list);
1369 usb_serial_bus_deregister(device);
1370}
1da177e4 1371EXPORT_SYMBOL_GPL(usb_serial_deregister);
1da177e4
LT
1372
1373/* Module information */
a8d6f0a9
AC
1374MODULE_AUTHOR(DRIVER_AUTHOR);
1375MODULE_DESCRIPTION(DRIVER_DESC);
1da177e4
LT
1376MODULE_LICENSE("GPL");
1377
1378module_param(debug, bool, S_IRUGO | S_IWUSR);
1379MODULE_PARM_DESC(debug, "Debug enabled or not");