1 // SPDX-License-Identifier: GPL-2.0
3  * USB Serial Converter stuff
5  *	Copyright (C) 1999 - 2012
6  *	    Greg Kroah-Hartman (greg@kroah.com)
19 #include <linux/serial.h>
22 /* The maximum number of ports one device can grab at once */
25 /* USB serial flags */
31  * @serial: pointer back to the struct usb_serial owner of this port.
34  * @minor: the minor number of the port
35  * @port_number: the struct usb_serial port number of this port (starts at 0)
61  * @tx_bytes: number of bytes currently in host stack queues
64  * @flags: usb serial port flags
66  * @dev: pointer to the serial device
68  * This structure is used by the usb-serial core and drivers for the specific
72 	struct usb_serial	*serial;  member
119 	return dev_get_drvdata(&port->dev);  in usb_get_serial_port_data()
125 	dev_set_drvdata(&port->dev, data);  in usb_set_serial_port_data()
129  * usb_serial - structure used by the usb-serial core for a device
134  * @suspend_count: number of suspended (sibling) interfaces
135  * @num_ports: the number of ports this device has
136  * @num_interrupt_in: number of interrupt in endpoints we have
137  * @num_interrupt_out: number of interrupt out endpoints we have
138  * @num_bulk_in: number of bulk in endpoints we have
139  * @num_bulk_out: number of bulk out endpoints we have
142  *	usb-serial driver is required to manage this data, the usb-serial core
168 /* get and set the serial private data pointer helper functions */
169 static inline void *usb_get_serial_data(struct usb_serial *serial)  in usb_get_serial_data()  argument
171 	return serial->private;  in usb_get_serial_data()
174 static inline void usb_set_serial_data(struct usb_serial *serial, void *data)  in usb_set_serial_data()  argument
176 	serial->private = data;  in usb_set_serial_data()
191  * usb_serial_driver - describes a usb serial driver
196  * @num_ports: the number of different ports this device will have.
197  * @num_bulk_in: minimum number of bulk-in endpoints
198  * @num_bulk_out: minimum number of bulk-out endpoints
199  * @num_interrupt_in: minimum number of interrupt-in endpoints
200  * @num_interrupt_out: minimum number of interrupt-out endpoints
201  * @bulk_in_size: minimum number of bytes to allocate for bulk-in buffer
202  *	(0 = end-point size)
203  * @bulk_out_size: bytes to allocate for bulk-out buffer (0 = end-point size)
205  *	device has dynamically. It can also be used to verify the number of
206  *	endpoints or to modify the port-endpoint mapping. It will be called
227  * This structure is defines a USB Serial driver.  It provides all of
228  * the information that the USB serial core code needs.  If the function
229  * pointers are defined, then the USB serial core code will call them when
231  * called, the generic serial function will be used instead.
257 	int (*probe)(struct usb_serial *serial, const struct usb_device_id *id);
258 	int (*attach)(struct usb_serial *serial);
259 	int (*calc_num_ports)(struct usb_serial *serial,
262 	void (*disconnect)(struct usb_serial *serial);
263 	void (*release)(struct usb_serial *serial);
268 	int (*suspend)(struct usb_serial *serial, pm_message_t message);
269 	int (*resume)(struct usb_serial *serial);
270 	int (*reset_resume)(struct usb_serial *serial);
272 	/* serial function calls */
302 	/* Called by the usb serial hooks to allow the user to rework the
327 /* USB Serial console functions */
331 void usb_serial_console_disconnect(struct usb_serial *serial);
335 static inline void usb_serial_console_disconnect(struct usb_serial *serial) {}  in usb_serial_console_disconnect()  argument
340 void usb_serial_put(struct usb_serial *serial);
342 int usb_serial_claim_interface(struct usb_serial *serial, struct usb_interface *intf);
349 int usb_serial_generic_resume(struct usb_serial *serial);
393 	dev_dbg(dev, "%s - length = %d, data = %*ph\n",  in usb_serial_debug_data()
406 	if (!__port->port.console || !__print_once) {			\
408 		dev_err(&__port->dev, fmt, ##__VA_ARGS__);		\
413  * module_usb_serial_driver() - Helper macro for registering a USB Serial driver
417  * Helper macro for USB serial drivers which do not do anything special