blob: 84a4c44c208b78a7eb9602091bc5a1401afdab8d [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Greg Kroah-Hartmana9698882006-07-11 21:22:58 -07002 * USB Serial Converter stuff
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 *
Greg Kroah-Hartman502b95c2005-06-20 21:15:16 -07004 * Copyright (C) 1999 - 2005
Linus Torvalds1da177e2005-04-16 15:20:36 -07005 * Greg Kroah-Hartman (greg@kroah.com)
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
Greg Kroah-Hartmana9698882006-07-11 21:22:58 -07009 * the Free Software Foundation; version 2 of the License.
Linus Torvalds1da177e2005-04-16 15:20:36 -070010 *
Linus Torvalds1da177e2005-04-16 15:20:36 -070011 */
12
Linus Torvalds1da177e2005-04-16 15:20:36 -070013#ifndef __LINUX_USB_SERIAL_H
14#define __LINUX_USB_SERIAL_H
15
Linus Torvalds1da177e2005-04-16 15:20:36 -070016#include <linux/kref.h>
Luiz Fernando Capitulino1ce7dd22006-03-24 17:12:31 -030017#include <linux/mutex.h>
Jason Wessel98fcb5f2009-05-11 15:24:09 -050018#include <linux/sysrq.h>
Stefani Seibold119eecc2009-12-23 09:10:48 +010019#include <linux/kfifo.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070020
21#define SERIAL_TTY_MAJOR 188 /* Nice legal number now */
Alan Stern0282b7f2008-07-29 12:01:04 -040022#define SERIAL_TTY_MINORS 254 /* loads of devices :) */
23#define SERIAL_TTY_NO_MINOR 255 /* No minor was assigned */
Linus Torvalds1da177e2005-04-16 15:20:36 -070024
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080025/* The maximum number of ports one device can grab at once */
26#define MAX_NUM_PORTS 8
Linus Torvalds1da177e2005-04-16 15:20:36 -070027
28/* parity check flag */
29#define RELEVANT_IFLAG(iflag) (iflag & (IGNBRK|BRKINT|IGNPAR|PARMRK|INPCK))
30
Alan Sternc706ebd2009-06-02 11:54:11 -040031enum port_dev_state {
32 PORT_UNREGISTERED,
33 PORT_REGISTERING,
34 PORT_REGISTERED,
35 PORT_UNREGISTERING,
36};
37
Johan Hovold27c7acf2010-05-05 23:57:37 +020038/* USB serial flags */
39#define USB_SERIAL_WRITE_BUSY 0
40
Linus Torvalds1da177e2005-04-16 15:20:36 -070041/**
42 * usb_serial_port: structure for the specific ports of a device.
43 * @serial: pointer back to the struct usb_serial owner of this port.
Leandro Dorileo78c5b822009-04-14 14:59:51 +010044 * @port: pointer to the corresponding tty_port for this port.
Greg Kroah-Hartman507ca9b2005-04-23 12:49:16 -070045 * @lock: spinlock to grab when updating portions of this structure.
Linus Torvalds1da177e2005-04-16 15:20:36 -070046 * @number: the number of the port (the minor number).
47 * @interrupt_in_buffer: pointer to the interrupt in buffer for this port.
48 * @interrupt_in_urb: pointer to the interrupt in struct urb for this port.
49 * @interrupt_in_endpointAddress: endpoint address for the interrupt in pipe
50 * for this port.
51 * @interrupt_out_buffer: pointer to the interrupt out buffer for this port.
52 * @interrupt_out_size: the size of the interrupt_out_buffer, in bytes.
53 * @interrupt_out_urb: pointer to the interrupt out struct urb for this port.
54 * @interrupt_out_endpointAddress: endpoint address for the interrupt out pipe
Greg Kroah-Hartman0858a3a2010-05-17 10:58:12 -070055 * for this port.
Linus Torvalds1da177e2005-04-16 15:20:36 -070056 * @bulk_in_buffer: pointer to the bulk in buffer for this port.
Leandro Dorileo78c5b822009-04-14 14:59:51 +010057 * @bulk_in_size: the size of the bulk_in_buffer, in bytes.
Linus Torvalds1da177e2005-04-16 15:20:36 -070058 * @read_urb: pointer to the bulk in struct urb for this port.
59 * @bulk_in_endpointAddress: endpoint address for the bulk in pipe for this
60 * port.
61 * @bulk_out_buffer: pointer to the bulk out buffer for this port.
62 * @bulk_out_size: the size of the bulk_out_buffer, in bytes.
63 * @write_urb: pointer to the bulk out struct urb for this port.
David VomLehn8e8dce02009-08-28 12:54:27 -070064 * @write_fifo: kfifo used to buffer outgoing data
Leandro Dorileo78c5b822009-04-14 14:59:51 +010065 * @write_urb_busy: port`s writing status
Johan Hovold27c7acf2010-05-05 23:57:37 +020066 * @bulk_out_buffers: pointers to the bulk out buffers for this port
67 * @write_urbs: pointers to the bulk out urbs for this port
68 * @write_urbs_free: status bitmap the for bulk out urbs
Johan Hovold25d514c2010-03-17 23:06:07 +010069 * @tx_bytes: number of bytes currently in host stack queues
Linus Torvalds1da177e2005-04-16 15:20:36 -070070 * @bulk_out_endpointAddress: endpoint address for the bulk out pipe for this
71 * port.
Johan Hovold27c7acf2010-05-05 23:57:37 +020072 * @flags: usb serial port flags
Linus Torvalds1da177e2005-04-16 15:20:36 -070073 * @write_wait: a wait_queue_head_t used by the port.
74 * @work: work queue entry for the line discipline waking up.
Joris van Rantwijk253ca922007-02-01 20:08:18 +010075 * @throttled: nonzero if the read urb is inactive to throttle the device
76 * @throttle_req: nonzero if the tty wants to throttle us
Leandro Dorileo78c5b822009-04-14 14:59:51 +010077 * @dev: pointer to the serial device
Linus Torvalds1da177e2005-04-16 15:20:36 -070078 *
79 * This structure is used by the usb-serial core and drivers for the specific
80 * ports of a device.
81 */
82struct usb_serial_port {
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080083 struct usb_serial *serial;
Alan Cox95da3102008-07-22 11:09:07 +010084 struct tty_port port;
Greg Kroah-Hartman507ca9b2005-04-23 12:49:16 -070085 spinlock_t lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -070086 unsigned char number;
87
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080088 unsigned char *interrupt_in_buffer;
89 struct urb *interrupt_in_urb;
Linus Torvalds1da177e2005-04-16 15:20:36 -070090 __u8 interrupt_in_endpointAddress;
91
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080092 unsigned char *interrupt_out_buffer;
Linus Torvalds1da177e2005-04-16 15:20:36 -070093 int interrupt_out_size;
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080094 struct urb *interrupt_out_urb;
Linus Torvalds1da177e2005-04-16 15:20:36 -070095 __u8 interrupt_out_endpointAddress;
96
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080097 unsigned char *bulk_in_buffer;
Linus Torvalds1da177e2005-04-16 15:20:36 -070098 int bulk_in_size;
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -080099 struct urb *read_urb;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700100 __u8 bulk_in_endpointAddress;
101
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800102 unsigned char *bulk_out_buffer;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103 int bulk_out_size;
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800104 struct urb *write_urb;
Stefani Seibold119eecc2009-12-23 09:10:48 +0100105 struct kfifo write_fifo;
Greg Kroah-Hartman507ca9b2005-04-23 12:49:16 -0700106 int write_urb_busy;
Johan Hovold27c7acf2010-05-05 23:57:37 +0200107
108 unsigned char *bulk_out_buffers[2];
109 struct urb *write_urbs[2];
110 unsigned long write_urbs_free;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700111 __u8 bulk_out_endpointAddress;
112
Johan Hovold25d514c2010-03-17 23:06:07 +0100113 int tx_bytes;
Jason Wessel715b1dc2009-05-11 15:24:07 -0500114
Johan Hovold27c7acf2010-05-05 23:57:37 +0200115 unsigned long flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700116 wait_queue_head_t write_wait;
117 struct work_struct work;
Joris van Rantwijk253ca922007-02-01 20:08:18 +0100118 char throttled;
119 char throttle_req;
Jason Wessel98fcb5f2009-05-11 15:24:09 -0500120 unsigned long sysrq; /* sysrq timeout */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121 struct device dev;
Alan Sternc706ebd2009-06-02 11:54:11 -0400122 enum port_dev_state dev_state;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700123};
124#define to_usb_serial_port(d) container_of(d, struct usb_serial_port, dev)
125
126/* get and set the port private data pointer helper functions */
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800127static inline void *usb_get_serial_port_data(struct usb_serial_port *port)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128{
129 return dev_get_drvdata(&port->dev);
130}
131
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800132static inline void usb_set_serial_port_data(struct usb_serial_port *port,
133 void *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134{
135 dev_set_drvdata(&port->dev, data);
136}
137
138/**
139 * usb_serial - structure used by the usb-serial core for a device
140 * @dev: pointer to the struct usb_device for this device
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700141 * @type: pointer to the struct usb_serial_driver for this device
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142 * @interface: pointer to the struct usb_interface for this device
143 * @minor: the starting minor number for this device
144 * @num_ports: the number of ports this device has
145 * @num_interrupt_in: number of interrupt in endpoints we have
146 * @num_interrupt_out: number of interrupt out endpoints we have
147 * @num_bulk_in: number of bulk in endpoints we have
148 * @num_bulk_out: number of bulk out endpoints we have
149 * @port: array of struct usb_serial_port structures for the different ports.
150 * @private: place to put any driver specific information that is needed. The
151 * usb-serial driver is required to manage this data, the usb-serial core
152 * will not touch this. Use usb_get_serial_data() and
153 * usb_set_serial_data() to access this.
154 */
155struct usb_serial {
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800156 struct usb_device *dev;
157 struct usb_serial_driver *type;
158 struct usb_interface *interface;
Oliver Neukumf8bece82009-02-05 16:54:25 +0100159 unsigned char disconnected:1;
160 unsigned char suspending:1;
Alan Sterna4720c62009-10-09 12:43:12 -0400161 unsigned char attached:1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700162 unsigned char minor;
163 unsigned char num_ports;
164 unsigned char num_port_pointers;
165 char num_interrupt_in;
166 char num_interrupt_out;
167 char num_bulk_in;
168 char num_bulk_out;
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800169 struct usb_serial_port *port[MAX_NUM_PORTS];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700170 struct kref kref;
Oliver Neukuma1cd7e92008-01-16 17:18:52 +0100171 struct mutex disc_mutex;
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800172 void *private;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700173};
174#define to_usb_serial(d) container_of(d, struct usb_serial, kref)
175
Linus Torvalds1da177e2005-04-16 15:20:36 -0700176/* get and set the serial private data pointer helper functions */
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800177static inline void *usb_get_serial_data(struct usb_serial *serial)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700178{
179 return serial->private;
180}
181
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800182static inline void usb_set_serial_data(struct usb_serial *serial, void *data)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700183{
184 serial->private = data;
185}
186
187/**
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700188 * usb_serial_driver - describes a usb serial driver
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800189 * @description: pointer to a string that describes this driver. This string
190 * used in the syslog messages when a device is inserted or removed.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700191 * @id_table: pointer to a list of usb_device_id structures that define all
192 * of the devices this structure can support.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700193 * @num_ports: the number of different ports this device will have.
Johan Hovoldbbcb2b92010-03-17 23:00:37 +0100194 * @bulk_in_size: bytes to allocate for bulk-in buffer (0 = end-point size)
195 * @bulk_out_size: bytes to allocate for bulk-out buffer (0 = end-point size)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700196 * @calc_num_ports: pointer to a function to determine how many ports this
197 * device has dynamically. It will be called after the probe()
198 * callback is called, but before attach()
199 * @probe: pointer to the driver's probe function.
200 * This will be called when the device is inserted into the system,
201 * but before the device has been fully initialized by the usb_serial
202 * subsystem. Use this function to download any firmware to the device,
203 * or any other early initialization that might be needed.
Greg Kroah-Hartmana9698882006-07-11 21:22:58 -0700204 * Return 0 to continue on with the initialization sequence. Anything
Linus Torvalds1da177e2005-04-16 15:20:36 -0700205 * else will abort it.
206 * @attach: pointer to the driver's attach function.
207 * This will be called when the struct usb_serial structure is fully set
208 * set up. Do any local initialization of the device, or any private
209 * memory structure allocation at this point in time.
Alan Sternf9c99bb2009-06-02 11:53:55 -0400210 * @disconnect: pointer to the driver's disconnect function. This will be
211 * called when the device is unplugged or unbound from the driver.
212 * @release: pointer to the driver's release function. This will be called
213 * when the usb_serial data structure is about to be destroyed.
Greg Kroah-Hartman93bacef2006-12-17 21:50:23 +0100214 * @usb_driver: pointer to the struct usb_driver that controls this
215 * device. This is necessary to allow dynamic ids to be added to
216 * the driver from sysfs.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700217 *
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700218 * This structure is defines a USB Serial driver. It provides all of
Linus Torvalds1da177e2005-04-16 15:20:36 -0700219 * the information that the USB serial core code needs. If the function
220 * pointers are defined, then the USB serial core code will call them when
221 * the corresponding tty port functions are called. If they are not
222 * called, the generic serial function will be used instead.
Greg Kroah-Hartman18fcac32005-06-20 21:15:16 -0700223 *
224 * The driver.owner field should be set to the module owner of this driver.
Greg Kroah-Hartman269bda12005-06-20 21:15:16 -0700225 * The driver.name field should be set to the name of this driver (remember
226 * it will show up in sysfs, so it needs to be short and to the point.
Geoff Levand0b14c382008-09-20 14:41:47 -0700227 * Using the module name is a good idea.)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228 */
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700229struct usb_serial_driver {
Greg Kroah-Hartman269bda12005-06-20 21:15:16 -0700230 const char *description;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231 const struct usb_device_id *id_table;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700232 char num_ports;
233
234 struct list_head driver_list;
235 struct device_driver driver;
Greg Kroah-Hartman93bacef2006-12-17 21:50:23 +0100236 struct usb_driver *usb_driver;
237 struct usb_dynids dynids;
Johan Hovold25d514c2010-03-17 23:06:07 +0100238
Johan Hovoldbbcb2b92010-03-17 23:00:37 +0100239 size_t bulk_in_size;
240 size_t bulk_out_size;
241
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800242 int (*probe)(struct usb_serial *serial, const struct usb_device_id *id);
243 int (*attach)(struct usb_serial *serial);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700244 int (*calc_num_ports) (struct usb_serial *serial);
245
Alan Sternf9c99bb2009-06-02 11:53:55 -0400246 void (*disconnect)(struct usb_serial *serial);
247 void (*release)(struct usb_serial *serial);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700248
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800249 int (*port_probe)(struct usb_serial_port *port);
250 int (*port_remove)(struct usb_serial_port *port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700251
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800252 int (*suspend)(struct usb_serial *serial, pm_message_t message);
253 int (*resume)(struct usb_serial *serial);
Oliver Neukumec225592007-04-27 20:54:57 +0200254
Linus Torvalds1da177e2005-04-16 15:20:36 -0700255 /* serial function calls */
Alan Coxa509a7e2009-09-19 13:13:26 -0700256 /* Called by console and by the tty layer */
257 int (*open)(struct tty_struct *tty, struct usb_serial_port *port);
Alan Cox335f8512009-06-11 12:26:29 +0100258 void (*close)(struct usb_serial_port *port);
Alan Cox95da3102008-07-22 11:09:07 +0100259 int (*write)(struct tty_struct *tty, struct usb_serial_port *port,
260 const unsigned char *buf, int count);
261 /* Called only by the tty layer */
262 int (*write_room)(struct tty_struct *tty);
263 int (*ioctl)(struct tty_struct *tty, struct file *file,
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800264 unsigned int cmd, unsigned long arg);
Alan Cox95da3102008-07-22 11:09:07 +0100265 void (*set_termios)(struct tty_struct *tty,
266 struct usb_serial_port *port, struct ktermios *old);
267 void (*break_ctl)(struct tty_struct *tty, int break_state);
268 int (*chars_in_buffer)(struct tty_struct *tty);
269 void (*throttle)(struct tty_struct *tty);
270 void (*unthrottle)(struct tty_struct *tty);
271 int (*tiocmget)(struct tty_struct *tty, struct file *file);
272 int (*tiocmset)(struct tty_struct *tty, struct file *file,
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800273 unsigned int set, unsigned int clear);
Alan Cox335f8512009-06-11 12:26:29 +0100274 /* Called by the tty layer for port level work. There may or may not
275 be an attached tty at this point */
276 void (*dtr_rts)(struct usb_serial_port *port, int on);
277 int (*carrier_raised)(struct usb_serial_port *port);
Alan Coxfe1ae7f2009-09-19 13:13:33 -0700278 /* Called by the usb serial hooks to allow the user to rework the
279 termios state */
280 void (*init_termios)(struct tty_struct *tty);
Alan Cox95da3102008-07-22 11:09:07 +0100281 /* USB events */
David Howells7d12e782006-10-05 14:55:46 +0100282 void (*read_int_callback)(struct urb *urb);
283 void (*write_int_callback)(struct urb *urb);
284 void (*read_bulk_callback)(struct urb *urb);
285 void (*write_bulk_callback)(struct urb *urb);
Johan Hovold23154322010-03-17 23:05:57 +0100286 /* Called by the generic read bulk callback */
287 void (*process_read_urb)(struct urb *urb);
Johan Hovoldeaa3bcb2010-03-17 23:06:08 +0100288 /* Called by the generic write implementation */
289 int (*prepare_write_buffer)(struct usb_serial_port *port,
Johan Hovoldc23e5fc2010-05-05 23:58:13 +0200290 void *dest, size_t size);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700291};
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800292#define to_usb_serial_driver(d) \
293 container_of(d, struct usb_serial_driver, driver)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700294
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700295extern int usb_serial_register(struct usb_serial_driver *driver);
296extern void usb_serial_deregister(struct usb_serial_driver *driver);
Pete Zaitcevcf2c7482006-05-22 21:58:49 -0700297extern void usb_serial_port_softint(struct usb_serial_port *port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700298
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800299extern int usb_serial_probe(struct usb_interface *iface,
300 const struct usb_device_id *id);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301extern void usb_serial_disconnect(struct usb_interface *iface);
302
Oliver Neukumec225592007-04-27 20:54:57 +0200303extern int usb_serial_suspend(struct usb_interface *intf, pm_message_t message);
304extern int usb_serial_resume(struct usb_interface *intf);
305
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800306extern int ezusb_writememory(struct usb_serial *serial, int address,
307 unsigned char *data, int length, __u8 bRequest);
308extern int ezusb_set_reset(struct usb_serial *serial, unsigned char reset_bit);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700309
310/* USB Serial console functions */
311#ifdef CONFIG_USB_SERIAL_CONSOLE
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800312extern void usb_serial_console_init(int debug, int minor);
313extern void usb_serial_console_exit(void);
Guennadi Liakhovetski73e487f2006-04-25 07:46:17 +0200314extern void usb_serial_console_disconnect(struct usb_serial *serial);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700315#else
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800316static inline void usb_serial_console_init(int debug, int minor) { }
317static inline void usb_serial_console_exit(void) { }
Guennadi Liakhovetski73e487f2006-04-25 07:46:17 +0200318static inline void usb_serial_console_disconnect(struct usb_serial *serial) {}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700319#endif
320
321/* Functions needed by other parts of the usbserial core */
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800322extern struct usb_serial *usb_serial_get_by_index(unsigned int minor);
Guennadi Liakhovetski73e487f2006-04-25 07:46:17 +0200323extern void usb_serial_put(struct usb_serial *serial);
Alan Cox95da3102008-07-22 11:09:07 +0100324extern int usb_serial_generic_open(struct tty_struct *tty,
Alan Coxa509a7e2009-09-19 13:13:26 -0700325 struct usb_serial_port *port);
Alan Cox95da3102008-07-22 11:09:07 +0100326extern int usb_serial_generic_write(struct tty_struct *tty,
327 struct usb_serial_port *port, const unsigned char *buf, int count);
Alan Cox335f8512009-06-11 12:26:29 +0100328extern void usb_serial_generic_close(struct usb_serial_port *port);
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800329extern int usb_serial_generic_resume(struct usb_serial *serial);
Alan Cox95da3102008-07-22 11:09:07 +0100330extern int usb_serial_generic_write_room(struct tty_struct *tty);
331extern int usb_serial_generic_chars_in_buffer(struct tty_struct *tty);
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800332extern void usb_serial_generic_read_bulk_callback(struct urb *urb);
333extern void usb_serial_generic_write_bulk_callback(struct urb *urb);
Alan Cox95da3102008-07-22 11:09:07 +0100334extern void usb_serial_generic_throttle(struct tty_struct *tty);
335extern void usb_serial_generic_unthrottle(struct tty_struct *tty);
Alan Sternf9c99bb2009-06-02 11:53:55 -0400336extern void usb_serial_generic_disconnect(struct usb_serial *serial);
337extern void usb_serial_generic_release(struct usb_serial *serial);
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800338extern int usb_serial_generic_register(int debug);
339extern void usb_serial_generic_deregister(void);
Johan Hovold41bd72f2010-03-17 23:05:53 +0100340extern int usb_serial_generic_submit_read_urb(struct usb_serial_port *port,
Jason Wessel98fcb5f2009-05-11 15:24:09 -0500341 gfp_t mem_flags);
Johan Hovold23154322010-03-17 23:05:57 +0100342extern void usb_serial_generic_process_read_urb(struct urb *urb);
Johan Hovoldeaa3bcb2010-03-17 23:06:08 +0100343extern int usb_serial_generic_prepare_write_buffer(struct usb_serial_port *port,
Johan Hovoldc23e5fc2010-05-05 23:58:13 +0200344 void *dest, size_t size);
Alan Cox24a15a62009-07-09 13:36:22 +0100345extern int usb_serial_handle_sysrq_char(struct tty_struct *tty,
346 struct usb_serial_port *port,
Jason Wessel98fcb5f2009-05-11 15:24:09 -0500347 unsigned int ch);
348extern int usb_serial_handle_break(struct usb_serial_port *port);
349
Linus Torvalds1da177e2005-04-16 15:20:36 -0700350
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800351extern int usb_serial_bus_register(struct usb_serial_driver *device);
352extern void usb_serial_bus_deregister(struct usb_serial_driver *device);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700353
Greg Kroah-Hartmanea653702005-06-20 21:15:16 -0700354extern struct usb_serial_driver usb_serial_generic_device;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700355extern struct bus_type usb_serial_bus_type;
356extern struct tty_driver *usb_serial_tty_driver;
357
358static inline void usb_serial_debug_data(int debug,
359 struct device *dev,
360 const char *function, int size,
361 const unsigned char *data)
362{
363 int i;
364
365 if (debug) {
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800366 dev_printk(KERN_DEBUG, dev, "%s - length = %d, data = ",
367 function, size);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700368 for (i = 0; i < size; ++i)
Greg Kroah-Hartman41dceed2008-01-30 15:21:33 -0800369 printk("%.2x ", data[i]);
370 printk("\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700371 }
372}
373
374/* Use our own dbg macro */
375#undef dbg
Joe Perchesefcbd3d2010-02-05 18:09:49 -0800376#define dbg(format, arg...) \
377do { \
378 if (debug) \
379 printk(KERN_DEBUG "%s: " format "\n", __FILE__, ##arg); \
380} while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700381
Robert P. J. Daydda43a02008-03-07 13:45:32 -0500382#endif /* __LINUX_USB_SERIAL_H */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700383