2017-11-03 10:28:30 +00:00
|
|
|
// SPDX-License-Identifier: GPL-2.0
|
2005-04-16 22:20:36 +00:00
|
|
|
/*
|
2006-07-12 04:22:58 +00:00
|
|
|
* USB Serial Converter stuff
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
2012-05-15 22:40:00 +00:00
|
|
|
* Copyright (C) 1999 - 2012
|
2005-04-16 22:20:36 +00:00
|
|
|
* Greg Kroah-Hartman (greg@kroah.com)
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
2006-07-12 04:22:58 +00:00
|
|
|
* the Free Software Foundation; version 2 of the License.
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __LINUX_USB_SERIAL_H
|
|
|
|
#define __LINUX_USB_SERIAL_H
|
|
|
|
|
|
|
|
#include <linux/kref.h>
|
2006-03-24 20:12:31 +00:00
|
|
|
#include <linux/mutex.h>
|
2013-03-21 11:36:52 +00:00
|
|
|
#include <linux/serial.h>
|
2009-05-11 20:24:09 +00:00
|
|
|
#include <linux/sysrq.h>
|
2009-12-23 08:10:48 +00:00
|
|
|
#include <linux/kfifo.h>
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
/* The maximum number of ports one device can grab at once */
|
2017-03-02 11:51:17 +00:00
|
|
|
#define MAX_NUM_PORTS 16
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
/* parity check flag */
|
|
|
|
#define RELEVANT_IFLAG(iflag) (iflag & (IGNBRK|BRKINT|IGNPAR|PARMRK|INPCK))
|
|
|
|
|
2010-05-05 21:57:37 +00:00
|
|
|
/* USB serial flags */
|
|
|
|
#define USB_SERIAL_WRITE_BUSY 0
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/**
|
|
|
|
* usb_serial_port: structure for the specific ports of a device.
|
|
|
|
* @serial: pointer back to the struct usb_serial owner of this port.
|
2009-04-14 13:59:51 +00:00
|
|
|
* @port: pointer to the corresponding tty_port for this port.
|
2005-04-23 19:49:16 +00:00
|
|
|
* @lock: spinlock to grab when updating portions of this structure.
|
2013-06-06 17:32:00 +00:00
|
|
|
* @minor: the minor number of the port
|
|
|
|
* @port_number: the struct usb_serial port number of this port (starts at 0)
|
2005-04-16 22:20:36 +00:00
|
|
|
* @interrupt_in_buffer: pointer to the interrupt in buffer for this port.
|
|
|
|
* @interrupt_in_urb: pointer to the interrupt in struct urb for this port.
|
|
|
|
* @interrupt_in_endpointAddress: endpoint address for the interrupt in pipe
|
|
|
|
* for this port.
|
|
|
|
* @interrupt_out_buffer: pointer to the interrupt out buffer for this port.
|
|
|
|
* @interrupt_out_size: the size of the interrupt_out_buffer, in bytes.
|
|
|
|
* @interrupt_out_urb: pointer to the interrupt out struct urb for this port.
|
|
|
|
* @interrupt_out_endpointAddress: endpoint address for the interrupt out pipe
|
2010-05-17 17:58:12 +00:00
|
|
|
* for this port.
|
2005-04-16 22:20:36 +00:00
|
|
|
* @bulk_in_buffer: pointer to the bulk in buffer for this port.
|
2009-04-14 13:59:51 +00:00
|
|
|
* @bulk_in_size: the size of the bulk_in_buffer, in bytes.
|
2005-04-16 22:20:36 +00:00
|
|
|
* @read_urb: pointer to the bulk in struct urb for this port.
|
|
|
|
* @bulk_in_endpointAddress: endpoint address for the bulk in pipe for this
|
|
|
|
* port.
|
2011-11-06 18:06:37 +00:00
|
|
|
* @bulk_in_buffers: pointers to the bulk in buffers for this port
|
|
|
|
* @read_urbs: pointers to the bulk in urbs for this port
|
|
|
|
* @read_urbs_free: status bitmap the for bulk in urbs
|
2005-04-16 22:20:36 +00:00
|
|
|
* @bulk_out_buffer: pointer to the bulk out buffer for this port.
|
|
|
|
* @bulk_out_size: the size of the bulk_out_buffer, in bytes.
|
|
|
|
* @write_urb: pointer to the bulk out struct urb for this port.
|
2009-08-28 19:54:27 +00:00
|
|
|
* @write_fifo: kfifo used to buffer outgoing data
|
2010-05-05 21:57:37 +00:00
|
|
|
* @bulk_out_buffers: pointers to the bulk out buffers for this port
|
|
|
|
* @write_urbs: pointers to the bulk out urbs for this port
|
|
|
|
* @write_urbs_free: status bitmap the for bulk out urbs
|
2013-03-21 11:36:52 +00:00
|
|
|
* @icount: interrupt counters
|
2010-03-17 22:06:07 +00:00
|
|
|
* @tx_bytes: number of bytes currently in host stack queues
|
2005-04-16 22:20:36 +00:00
|
|
|
* @bulk_out_endpointAddress: endpoint address for the bulk out pipe for this
|
|
|
|
* port.
|
2010-05-05 21:57:37 +00:00
|
|
|
* @flags: usb serial port flags
|
2005-04-16 22:20:36 +00:00
|
|
|
* @write_wait: a wait_queue_head_t used by the port.
|
|
|
|
* @work: work queue entry for the line discipline waking up.
|
2007-02-01 19:08:18 +00:00
|
|
|
* @throttled: nonzero if the read urb is inactive to throttle the device
|
|
|
|
* @throttle_req: nonzero if the tty wants to throttle us
|
2009-04-14 13:59:51 +00:00
|
|
|
* @dev: pointer to the serial device
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
|
|
|
* This structure is used by the usb-serial core and drivers for the specific
|
|
|
|
* ports of a device.
|
|
|
|
*/
|
|
|
|
struct usb_serial_port {
|
2008-01-30 23:21:33 +00:00
|
|
|
struct usb_serial *serial;
|
2008-07-22 10:09:07 +00:00
|
|
|
struct tty_port port;
|
2005-04-23 19:49:16 +00:00
|
|
|
spinlock_t lock;
|
2013-06-06 17:32:00 +00:00
|
|
|
u32 minor;
|
|
|
|
u8 port_number;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned char *interrupt_in_buffer;
|
|
|
|
struct urb *interrupt_in_urb;
|
2005-04-16 22:20:36 +00:00
|
|
|
__u8 interrupt_in_endpointAddress;
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned char *interrupt_out_buffer;
|
2005-04-16 22:20:36 +00:00
|
|
|
int interrupt_out_size;
|
2008-01-30 23:21:33 +00:00
|
|
|
struct urb *interrupt_out_urb;
|
2005-04-16 22:20:36 +00:00
|
|
|
__u8 interrupt_out_endpointAddress;
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned char *bulk_in_buffer;
|
2005-04-16 22:20:36 +00:00
|
|
|
int bulk_in_size;
|
2008-01-30 23:21:33 +00:00
|
|
|
struct urb *read_urb;
|
2005-04-16 22:20:36 +00:00
|
|
|
__u8 bulk_in_endpointAddress;
|
|
|
|
|
2011-11-06 18:06:37 +00:00
|
|
|
unsigned char *bulk_in_buffers[2];
|
|
|
|
struct urb *read_urbs[2];
|
|
|
|
unsigned long read_urbs_free;
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned char *bulk_out_buffer;
|
2005-04-16 22:20:36 +00:00
|
|
|
int bulk_out_size;
|
2008-01-30 23:21:33 +00:00
|
|
|
struct urb *write_urb;
|
2009-12-23 08:10:48 +00:00
|
|
|
struct kfifo write_fifo;
|
2010-05-05 21:57:37 +00:00
|
|
|
|
|
|
|
unsigned char *bulk_out_buffers[2];
|
|
|
|
struct urb *write_urbs[2];
|
|
|
|
unsigned long write_urbs_free;
|
2005-04-16 22:20:36 +00:00
|
|
|
__u8 bulk_out_endpointAddress;
|
|
|
|
|
2013-03-21 11:36:52 +00:00
|
|
|
struct async_icount icount;
|
2010-03-17 22:06:07 +00:00
|
|
|
int tx_bytes;
|
2009-05-11 20:24:07 +00:00
|
|
|
|
2010-05-05 21:57:37 +00:00
|
|
|
unsigned long flags;
|
2005-04-16 22:20:36 +00:00
|
|
|
wait_queue_head_t write_wait;
|
|
|
|
struct work_struct work;
|
2007-02-01 19:08:18 +00:00
|
|
|
char throttled;
|
|
|
|
char throttle_req;
|
2009-05-11 20:24:09 +00:00
|
|
|
unsigned long sysrq; /* sysrq timeout */
|
2005-04-16 22:20:36 +00:00
|
|
|
struct device dev;
|
|
|
|
};
|
|
|
|
#define to_usb_serial_port(d) container_of(d, struct usb_serial_port, dev)
|
|
|
|
|
|
|
|
/* get and set the port private data pointer helper functions */
|
2008-01-30 23:21:33 +00:00
|
|
|
static inline void *usb_get_serial_port_data(struct usb_serial_port *port)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
|
|
|
return dev_get_drvdata(&port->dev);
|
|
|
|
}
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
static inline void usb_set_serial_port_data(struct usb_serial_port *port,
|
|
|
|
void *data)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
|
|
|
dev_set_drvdata(&port->dev, data);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* usb_serial - structure used by the usb-serial core for a device
|
|
|
|
* @dev: pointer to the struct usb_device for this device
|
2005-06-21 04:15:16 +00:00
|
|
|
* @type: pointer to the struct usb_serial_driver for this device
|
2005-04-16 22:20:36 +00:00
|
|
|
* @interface: pointer to the struct usb_interface for this device
|
|
|
|
* @num_ports: the number of ports this device has
|
|
|
|
* @num_interrupt_in: number of interrupt in endpoints we have
|
|
|
|
* @num_interrupt_out: number of interrupt out endpoints we have
|
|
|
|
* @num_bulk_in: number of bulk in endpoints we have
|
|
|
|
* @num_bulk_out: number of bulk out endpoints we have
|
|
|
|
* @port: array of struct usb_serial_port structures for the different ports.
|
|
|
|
* @private: place to put any driver specific information that is needed. The
|
|
|
|
* usb-serial driver is required to manage this data, the usb-serial core
|
|
|
|
* will not touch this. Use usb_get_serial_data() and
|
|
|
|
* usb_set_serial_data() to access this.
|
|
|
|
*/
|
|
|
|
struct usb_serial {
|
2008-01-30 23:21:33 +00:00
|
|
|
struct usb_device *dev;
|
|
|
|
struct usb_serial_driver *type;
|
|
|
|
struct usb_interface *interface;
|
2009-02-05 15:54:25 +00:00
|
|
|
unsigned char disconnected:1;
|
|
|
|
unsigned char suspending:1;
|
2009-10-09 16:43:12 +00:00
|
|
|
unsigned char attached:1;
|
2013-06-07 18:04:28 +00:00
|
|
|
unsigned char minors_reserved:1;
|
2005-04-16 22:20:36 +00:00
|
|
|
unsigned char num_ports;
|
|
|
|
unsigned char num_port_pointers;
|
2017-03-02 11:51:15 +00:00
|
|
|
unsigned char num_interrupt_in;
|
|
|
|
unsigned char num_interrupt_out;
|
|
|
|
unsigned char num_bulk_in;
|
|
|
|
unsigned char num_bulk_out;
|
2008-01-30 23:21:33 +00:00
|
|
|
struct usb_serial_port *port[MAX_NUM_PORTS];
|
2005-04-16 22:20:36 +00:00
|
|
|
struct kref kref;
|
2008-01-16 16:18:52 +00:00
|
|
|
struct mutex disc_mutex;
|
2008-01-30 23:21:33 +00:00
|
|
|
void *private;
|
2005-04-16 22:20:36 +00:00
|
|
|
};
|
|
|
|
#define to_usb_serial(d) container_of(d, struct usb_serial, kref)
|
|
|
|
|
|
|
|
/* get and set the serial private data pointer helper functions */
|
2008-01-30 23:21:33 +00:00
|
|
|
static inline void *usb_get_serial_data(struct usb_serial *serial)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
|
|
|
return serial->private;
|
|
|
|
}
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
static inline void usb_set_serial_data(struct usb_serial *serial, void *data)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
|
|
|
serial->private = data;
|
|
|
|
}
|
|
|
|
|
2017-03-16 16:13:30 +00:00
|
|
|
struct usb_serial_endpoints {
|
|
|
|
unsigned char num_bulk_in;
|
|
|
|
unsigned char num_bulk_out;
|
|
|
|
unsigned char num_interrupt_in;
|
|
|
|
unsigned char num_interrupt_out;
|
|
|
|
struct usb_endpoint_descriptor *bulk_in[MAX_NUM_PORTS];
|
|
|
|
struct usb_endpoint_descriptor *bulk_out[MAX_NUM_PORTS];
|
|
|
|
struct usb_endpoint_descriptor *interrupt_in[MAX_NUM_PORTS];
|
|
|
|
struct usb_endpoint_descriptor *interrupt_out[MAX_NUM_PORTS];
|
|
|
|
};
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/**
|
2005-06-21 04:15:16 +00:00
|
|
|
* usb_serial_driver - describes a usb serial driver
|
2008-01-30 23:21:33 +00:00
|
|
|
* @description: pointer to a string that describes this driver. This string
|
|
|
|
* used in the syslog messages when a device is inserted or removed.
|
2005-04-16 22:20:36 +00:00
|
|
|
* @id_table: pointer to a list of usb_device_id structures that define all
|
|
|
|
* of the devices this structure can support.
|
|
|
|
* @num_ports: the number of different ports this device will have.
|
2017-03-02 11:51:19 +00:00
|
|
|
* @num_bulk_in: minimum number of bulk-in endpoints
|
|
|
|
* @num_bulk_out: minimum number of bulk-out endpoints
|
|
|
|
* @num_interrupt_in: minimum number of interrupt-in endpoints
|
|
|
|
* @num_interrupt_out: minimum number of interrupt-out endpoints
|
2011-02-23 20:28:18 +00:00
|
|
|
* @bulk_in_size: minimum number of bytes to allocate for bulk-in buffer
|
|
|
|
* (0 = end-point size)
|
2015-02-15 04:57:53 +00:00
|
|
|
* @bulk_out_size: bytes to allocate for bulk-out buffer (0 = end-point size)
|
2005-04-16 22:20:36 +00:00
|
|
|
* @calc_num_ports: pointer to a function to determine how many ports this
|
2017-03-16 16:13:30 +00:00
|
|
|
* device has dynamically. It can also be used to verify the number of
|
|
|
|
* endpoints or to modify the port-endpoint mapping. It will be called
|
|
|
|
* after the probe() callback is called, but before attach().
|
2005-04-16 22:20:36 +00:00
|
|
|
* @probe: pointer to the driver's probe function.
|
|
|
|
* This will be called when the device is inserted into the system,
|
|
|
|
* but before the device has been fully initialized by the usb_serial
|
|
|
|
* subsystem. Use this function to download any firmware to the device,
|
|
|
|
* or any other early initialization that might be needed.
|
2006-07-12 04:22:58 +00:00
|
|
|
* Return 0 to continue on with the initialization sequence. Anything
|
2005-04-16 22:20:36 +00:00
|
|
|
* else will abort it.
|
|
|
|
* @attach: pointer to the driver's attach function.
|
|
|
|
* This will be called when the struct usb_serial structure is fully set
|
|
|
|
* set up. Do any local initialization of the device, or any private
|
|
|
|
* memory structure allocation at this point in time.
|
2009-06-02 15:53:55 +00:00
|
|
|
* @disconnect: pointer to the driver's disconnect function. This will be
|
|
|
|
* called when the device is unplugged or unbound from the driver.
|
|
|
|
* @release: pointer to the driver's release function. This will be called
|
|
|
|
* when the usb_serial data structure is about to be destroyed.
|
2006-12-17 20:50:23 +00:00
|
|
|
* @usb_driver: pointer to the struct usb_driver that controls this
|
|
|
|
* device. This is necessary to allow dynamic ids to be added to
|
|
|
|
* the driver from sysfs.
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
2005-06-21 04:15:16 +00:00
|
|
|
* This structure is defines a USB Serial driver. It provides all of
|
2005-04-16 22:20:36 +00:00
|
|
|
* the information that the USB serial core code needs. If the function
|
|
|
|
* pointers are defined, then the USB serial core code will call them when
|
|
|
|
* the corresponding tty port functions are called. If they are not
|
|
|
|
* called, the generic serial function will be used instead.
|
2005-06-21 04:15:16 +00:00
|
|
|
*
|
|
|
|
* The driver.owner field should be set to the module owner of this driver.
|
2005-06-21 04:15:16 +00:00
|
|
|
* The driver.name field should be set to the name of this driver (remember
|
|
|
|
* it will show up in sysfs, so it needs to be short and to the point.
|
2008-09-20 21:41:47 +00:00
|
|
|
* Using the module name is a good idea.)
|
2005-04-16 22:20:36 +00:00
|
|
|
*/
|
2005-06-21 04:15:16 +00:00
|
|
|
struct usb_serial_driver {
|
2005-06-21 04:15:16 +00:00
|
|
|
const char *description;
|
2005-04-16 22:20:36 +00:00
|
|
|
const struct usb_device_id *id_table;
|
|
|
|
|
|
|
|
struct list_head driver_list;
|
|
|
|
struct device_driver driver;
|
2006-12-17 20:50:23 +00:00
|
|
|
struct usb_driver *usb_driver;
|
|
|
|
struct usb_dynids dynids;
|
2010-03-17 22:06:07 +00:00
|
|
|
|
2017-03-02 11:51:15 +00:00
|
|
|
unsigned char num_ports;
|
|
|
|
|
2017-03-02 11:51:19 +00:00
|
|
|
unsigned char num_bulk_in;
|
|
|
|
unsigned char num_bulk_out;
|
|
|
|
unsigned char num_interrupt_in;
|
|
|
|
unsigned char num_interrupt_out;
|
|
|
|
|
2010-03-17 22:00:37 +00:00
|
|
|
size_t bulk_in_size;
|
|
|
|
size_t bulk_out_size;
|
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
int (*probe)(struct usb_serial *serial, const struct usb_device_id *id);
|
|
|
|
int (*attach)(struct usb_serial *serial);
|
2017-03-16 16:13:30 +00:00
|
|
|
int (*calc_num_ports)(struct usb_serial *serial,
|
|
|
|
struct usb_serial_endpoints *epds);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-06-02 15:53:55 +00:00
|
|
|
void (*disconnect)(struct usb_serial *serial);
|
|
|
|
void (*release)(struct usb_serial *serial);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
int (*port_probe)(struct usb_serial_port *port);
|
|
|
|
int (*port_remove)(struct usb_serial_port *port);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
int (*suspend)(struct usb_serial *serial, pm_message_t message);
|
|
|
|
int (*resume)(struct usb_serial *serial);
|
2012-05-15 22:40:00 +00:00
|
|
|
int (*reset_resume)(struct usb_serial *serial);
|
2007-04-27 18:54:57 +00:00
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/* serial function calls */
|
2009-09-19 20:13:26 +00:00
|
|
|
/* Called by console and by the tty layer */
|
|
|
|
int (*open)(struct tty_struct *tty, struct usb_serial_port *port);
|
2009-06-11 11:26:29 +00:00
|
|
|
void (*close)(struct usb_serial_port *port);
|
2008-07-22 10:09:07 +00:00
|
|
|
int (*write)(struct tty_struct *tty, struct usb_serial_port *port,
|
|
|
|
const unsigned char *buf, int count);
|
|
|
|
/* Called only by the tty layer */
|
|
|
|
int (*write_room)(struct tty_struct *tty);
|
2011-02-14 16:27:06 +00:00
|
|
|
int (*ioctl)(struct tty_struct *tty,
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned int cmd, unsigned long arg);
|
2008-07-22 10:09:07 +00:00
|
|
|
void (*set_termios)(struct tty_struct *tty,
|
|
|
|
struct usb_serial_port *port, struct ktermios *old);
|
|
|
|
void (*break_ctl)(struct tty_struct *tty, int break_state);
|
|
|
|
int (*chars_in_buffer)(struct tty_struct *tty);
|
2013-05-05 18:32:27 +00:00
|
|
|
void (*wait_until_sent)(struct tty_struct *tty, long timeout);
|
2013-05-08 15:51:43 +00:00
|
|
|
bool (*tx_empty)(struct usb_serial_port *port);
|
2008-07-22 10:09:07 +00:00
|
|
|
void (*throttle)(struct tty_struct *tty);
|
|
|
|
void (*unthrottle)(struct tty_struct *tty);
|
2011-02-14 16:26:14 +00:00
|
|
|
int (*tiocmget)(struct tty_struct *tty);
|
2011-02-14 16:26:50 +00:00
|
|
|
int (*tiocmset)(struct tty_struct *tty,
|
2008-01-30 23:21:33 +00:00
|
|
|
unsigned int set, unsigned int clear);
|
2013-03-21 11:36:51 +00:00
|
|
|
int (*tiocmiwait)(struct tty_struct *tty, unsigned long arg);
|
2010-09-16 17:21:24 +00:00
|
|
|
int (*get_icount)(struct tty_struct *tty,
|
|
|
|
struct serial_icounter_struct *icount);
|
2009-06-11 11:26:29 +00:00
|
|
|
/* Called by the tty layer for port level work. There may or may not
|
|
|
|
be an attached tty at this point */
|
|
|
|
void (*dtr_rts)(struct usb_serial_port *port, int on);
|
|
|
|
int (*carrier_raised)(struct usb_serial_port *port);
|
2009-09-19 20:13:33 +00:00
|
|
|
/* Called by the usb serial hooks to allow the user to rework the
|
|
|
|
termios state */
|
|
|
|
void (*init_termios)(struct tty_struct *tty);
|
2008-07-22 10:09:07 +00:00
|
|
|
/* USB events */
|
IRQ: Maintain regs pointer globally rather than passing to IRQ handlers
Maintain a per-CPU global "struct pt_regs *" variable which can be used instead
of passing regs around manually through all ~1800 interrupt handlers in the
Linux kernel.
The regs pointer is used in few places, but it potentially costs both stack
space and code to pass it around. On the FRV arch, removing the regs parameter
from all the genirq function results in a 20% speed up of the IRQ exit path
(ie: from leaving timer_interrupt() to leaving do_IRQ()).
Where appropriate, an arch may override the generic storage facility and do
something different with the variable. On FRV, for instance, the address is
maintained in GR28 at all times inside the kernel as part of general exception
handling.
Having looked over the code, it appears that the parameter may be handed down
through up to twenty or so layers of functions. Consider a USB character
device attached to a USB hub, attached to a USB controller that posts its
interrupts through a cascaded auxiliary interrupt controller. A character
device driver may want to pass regs to the sysrq handler through the input
layer which adds another few layers of parameter passing.
I've build this code with allyesconfig for x86_64 and i386. I've runtested the
main part of the code on FRV and i386, though I can't test most of the drivers.
I've also done partial conversion for powerpc and MIPS - these at least compile
with minimal configurations.
This will affect all archs. Mostly the changes should be relatively easy.
Take do_IRQ(), store the regs pointer at the beginning, saving the old one:
struct pt_regs *old_regs = set_irq_regs(regs);
And put the old one back at the end:
set_irq_regs(old_regs);
Don't pass regs through to generic_handle_irq() or __do_IRQ().
In timer_interrupt(), this sort of change will be necessary:
- update_process_times(user_mode(regs));
- profile_tick(CPU_PROFILING, regs);
+ update_process_times(user_mode(get_irq_regs()));
+ profile_tick(CPU_PROFILING);
I'd like to move update_process_times()'s use of get_irq_regs() into itself,
except that i386, alone of the archs, uses something other than user_mode().
Some notes on the interrupt handling in the drivers:
(*) input_dev() is now gone entirely. The regs pointer is no longer stored in
the input_dev struct.
(*) finish_unlinks() in drivers/usb/host/ohci-q.c needs checking. It does
something different depending on whether it's been supplied with a regs
pointer or not.
(*) Various IRQ handler function pointers have been moved to type
irq_handler_t.
Signed-Off-By: David Howells <dhowells@redhat.com>
(cherry picked from 1b16e7ac850969f38b375e511e3fa2f474a33867 commit)
2006-10-05 13:55:46 +00:00
|
|
|
void (*read_int_callback)(struct urb *urb);
|
|
|
|
void (*write_int_callback)(struct urb *urb);
|
|
|
|
void (*read_bulk_callback)(struct urb *urb);
|
|
|
|
void (*write_bulk_callback)(struct urb *urb);
|
2010-03-17 22:05:57 +00:00
|
|
|
/* Called by the generic read bulk callback */
|
|
|
|
void (*process_read_urb)(struct urb *urb);
|
2010-03-17 22:06:08 +00:00
|
|
|
/* Called by the generic write implementation */
|
|
|
|
int (*prepare_write_buffer)(struct usb_serial_port *port,
|
2010-05-05 21:58:13 +00:00
|
|
|
void *dest, size_t size);
|
2005-04-16 22:20:36 +00:00
|
|
|
};
|
2008-01-30 23:21:33 +00:00
|
|
|
#define to_usb_serial_driver(d) \
|
|
|
|
container_of(d, struct usb_serial_driver, driver)
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2012-05-08 22:46:14 +00:00
|
|
|
extern int usb_serial_register_drivers(struct usb_serial_driver *const serial_drivers[],
|
|
|
|
const char *name, const struct usb_device_id *id_table);
|
|
|
|
extern void usb_serial_deregister_drivers(struct usb_serial_driver *const serial_drivers[]);
|
2006-05-23 04:58:49 +00:00
|
|
|
extern void usb_serial_port_softint(struct usb_serial_port *port);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2007-04-27 18:54:57 +00:00
|
|
|
extern int usb_serial_suspend(struct usb_interface *intf, pm_message_t message);
|
|
|
|
extern int usb_serial_resume(struct usb_interface *intf);
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/* USB Serial console functions */
|
|
|
|
#ifdef CONFIG_USB_SERIAL_CONSOLE
|
2012-09-18 15:05:17 +00:00
|
|
|
extern void usb_serial_console_init(int minor);
|
2008-01-30 23:21:33 +00:00
|
|
|
extern void usb_serial_console_exit(void);
|
2006-04-25 05:46:17 +00:00
|
|
|
extern void usb_serial_console_disconnect(struct usb_serial *serial);
|
2005-04-16 22:20:36 +00:00
|
|
|
#else
|
2012-09-18 15:05:17 +00:00
|
|
|
static inline void usb_serial_console_init(int minor) { }
|
2008-01-30 23:21:33 +00:00
|
|
|
static inline void usb_serial_console_exit(void) { }
|
2006-04-25 05:46:17 +00:00
|
|
|
static inline void usb_serial_console_disconnect(struct usb_serial *serial) {}
|
2005-04-16 22:20:36 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Functions needed by other parts of the usbserial core */
|
2013-06-07 18:04:28 +00:00
|
|
|
extern struct usb_serial_port *usb_serial_port_get_by_minor(unsigned int minor);
|
2006-04-25 05:46:17 +00:00
|
|
|
extern void usb_serial_put(struct usb_serial *serial);
|
2008-07-22 10:09:07 +00:00
|
|
|
extern int usb_serial_generic_open(struct tty_struct *tty,
|
2009-09-19 20:13:26 +00:00
|
|
|
struct usb_serial_port *port);
|
2013-10-09 15:01:12 +00:00
|
|
|
extern int usb_serial_generic_write_start(struct usb_serial_port *port,
|
|
|
|
gfp_t mem_flags);
|
2008-07-22 10:09:07 +00:00
|
|
|
extern int usb_serial_generic_write(struct tty_struct *tty,
|
|
|
|
struct usb_serial_port *port, const unsigned char *buf, int count);
|
2009-06-11 11:26:29 +00:00
|
|
|
extern void usb_serial_generic_close(struct usb_serial_port *port);
|
2008-01-30 23:21:33 +00:00
|
|
|
extern int usb_serial_generic_resume(struct usb_serial *serial);
|
2008-07-22 10:09:07 +00:00
|
|
|
extern int usb_serial_generic_write_room(struct tty_struct *tty);
|
|
|
|
extern int usb_serial_generic_chars_in_buffer(struct tty_struct *tty);
|
2013-05-08 15:51:43 +00:00
|
|
|
extern void usb_serial_generic_wait_until_sent(struct tty_struct *tty,
|
|
|
|
long timeout);
|
2008-01-30 23:21:33 +00:00
|
|
|
extern void usb_serial_generic_read_bulk_callback(struct urb *urb);
|
|
|
|
extern void usb_serial_generic_write_bulk_callback(struct urb *urb);
|
2008-07-22 10:09:07 +00:00
|
|
|
extern void usb_serial_generic_throttle(struct tty_struct *tty);
|
|
|
|
extern void usb_serial_generic_unthrottle(struct tty_struct *tty);
|
2013-03-21 11:36:52 +00:00
|
|
|
extern int usb_serial_generic_tiocmiwait(struct tty_struct *tty,
|
|
|
|
unsigned long arg);
|
2013-03-21 11:36:54 +00:00
|
|
|
extern int usb_serial_generic_get_icount(struct tty_struct *tty,
|
|
|
|
struct serial_icounter_struct *icount);
|
2012-09-18 15:05:17 +00:00
|
|
|
extern int usb_serial_generic_register(void);
|
2008-01-30 23:21:33 +00:00
|
|
|
extern void usb_serial_generic_deregister(void);
|
2011-11-06 18:06:37 +00:00
|
|
|
extern int usb_serial_generic_submit_read_urbs(struct usb_serial_port *port,
|
2009-05-11 20:24:09 +00:00
|
|
|
gfp_t mem_flags);
|
2010-03-17 22:05:57 +00:00
|
|
|
extern void usb_serial_generic_process_read_urb(struct urb *urb);
|
2010-03-17 22:06:08 +00:00
|
|
|
extern int usb_serial_generic_prepare_write_buffer(struct usb_serial_port *port,
|
2010-05-05 21:58:13 +00:00
|
|
|
void *dest, size_t size);
|
2010-08-18 04:15:47 +00:00
|
|
|
extern int usb_serial_handle_sysrq_char(struct usb_serial_port *port,
|
2009-05-11 20:24:09 +00:00
|
|
|
unsigned int ch);
|
|
|
|
extern int usb_serial_handle_break(struct usb_serial_port *port);
|
2011-01-14 13:30:21 +00:00
|
|
|
extern void usb_serial_handle_dcd_change(struct usb_serial_port *usb_port,
|
|
|
|
struct tty_struct *tty,
|
|
|
|
unsigned int status);
|
2009-05-11 20:24:09 +00:00
|
|
|
|
2008-01-30 23:21:33 +00:00
|
|
|
|
|
|
|
extern int usb_serial_bus_register(struct usb_serial_driver *device);
|
|
|
|
extern void usb_serial_bus_deregister(struct usb_serial_driver *device);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
extern struct bus_type usb_serial_bus_type;
|
|
|
|
extern struct tty_driver *usb_serial_tty_driver;
|
|
|
|
|
2012-09-18 08:58:57 +00:00
|
|
|
static inline void usb_serial_debug_data(struct device *dev,
|
2005-04-16 22:20:36 +00:00
|
|
|
const char *function, int size,
|
|
|
|
const unsigned char *data)
|
|
|
|
{
|
2012-09-18 08:58:57 +00:00
|
|
|
dev_dbg(dev, "%s - length = %d, data = %*ph\n",
|
|
|
|
function, size, size, data);
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2012-02-06 18:22:19 +00:00
|
|
|
/*
|
|
|
|
* Macro for reporting errors in write path to avoid inifinite loop
|
|
|
|
* when port is used as a console.
|
|
|
|
*/
|
|
|
|
#define dev_err_console(usport, fmt, ...) \
|
|
|
|
do { \
|
|
|
|
static bool __print_once; \
|
|
|
|
struct usb_serial_port *__port = (usport); \
|
|
|
|
\
|
|
|
|
if (!__port->port.console || !__print_once) { \
|
|
|
|
__print_once = true; \
|
|
|
|
dev_err(&__port->dev, fmt, ##__VA_ARGS__); \
|
|
|
|
} \
|
|
|
|
} while (0)
|
|
|
|
|
2012-02-24 23:38:14 +00:00
|
|
|
/*
|
|
|
|
* module_usb_serial_driver() - Helper macro for registering a USB Serial driver
|
|
|
|
* @__serial_drivers: list of usb_serial drivers to register
|
2012-05-08 22:46:14 +00:00
|
|
|
* @__ids: all device ids that @__serial_drivers bind to
|
2012-02-24 23:38:14 +00:00
|
|
|
*
|
|
|
|
* Helper macro for USB serial drivers which do not do anything special
|
|
|
|
* in module init/exit. This eliminates a lot of boilerplate. Each
|
|
|
|
* module may only use this macro once, and calling it replaces
|
|
|
|
* module_init() and module_exit()
|
|
|
|
*
|
|
|
|
*/
|
2012-05-08 22:46:14 +00:00
|
|
|
#define usb_serial_module_driver(__name, __serial_drivers, __ids) \
|
|
|
|
static int __init usb_serial_module_init(void) \
|
|
|
|
{ \
|
|
|
|
return usb_serial_register_drivers(__serial_drivers, \
|
|
|
|
__name, __ids); \
|
|
|
|
} \
|
|
|
|
module_init(usb_serial_module_init); \
|
|
|
|
static void __exit usb_serial_module_exit(void) \
|
|
|
|
{ \
|
|
|
|
usb_serial_deregister_drivers(__serial_drivers); \
|
|
|
|
} \
|
|
|
|
module_exit(usb_serial_module_exit);
|
|
|
|
|
|
|
|
#define module_usb_serial_driver(__serial_drivers, __ids) \
|
|
|
|
usb_serial_module_driver(KBUILD_MODNAME, __serial_drivers, __ids)
|
2012-02-24 23:38:14 +00:00
|
|
|
|
2008-03-07 18:45:32 +00:00
|
|
|
#endif /* __LINUX_USB_SERIAL_H */
|
2005-04-16 22:20:36 +00:00
|
|
|
|