linux/usb/serial.h

1 // SPDX-License-Identifier: GPL-2.0
5  *	Copyright (C) 1999 - 2012
6  *	    Greg Kroah-Hartman (greg@kroah.com)
22 /* The maximum number of ports one device can grab at once */
30  * usb_serial_port: structure for the specific ports of a device.
40  * @interrupt_out_buffer: pointer to the interrupt out buffer for this port.
42  * @interrupt_out_urb: pointer to the interrupt out struct urb for this port.
43  * @interrupt_out_endpointAddress: endpoint address for the interrupt out pipe
53  * @bulk_out_buffer: pointer to the bulk out buffer for this port.
55  * @write_urb: pointer to the bulk out struct urb for this port.
57  * @bulk_out_buffers: pointers to the bulk out buffers for this port
58  * @write_urbs: pointers to the bulk out urbs for this port
59  * @write_urbs_free: status bitmap the for bulk out urbs
62  * @bulk_out_endpointAddress: endpoint address for the bulk out pipe for this
69  * This structure is used by the usb-serial core and drivers for the specific
70  * ports of a device.
121 	return dev_get_drvdata(&port->dev);  in usb_get_serial_port_data()
127 	dev_set_drvdata(&port->dev, data);  in usb_set_serial_port_data()
131  * usb_serial - structure used by the usb-serial core for a device
135  * @num_ports: the number of ports this device has
137  * @num_interrupt_out: number of interrupt out endpoints we have
139  * @num_bulk_out: number of bulk out endpoints we have
140  * @port: array of struct usb_serial_port structures for the different ports.
142  *	usb-serial driver is required to manage this data, the usb-serial core
170 	return serial->private;  in usb_get_serial_data()
175 	serial->private = data;  in usb_set_serial_data()
190  * usb_serial_driver - describes a usb serial driver
195  * @num_ports: the number of different ports this device will have.
196  * @num_bulk_in: minimum number of bulk-in endpoints
197  * @num_bulk_out: minimum number of bulk-out endpoints
198  * @num_interrupt_in: minimum number of interrupt-in endpoints
199  * @num_interrupt_out: minimum number of interrupt-out endpoints
200  * @bulk_in_size: minimum number of bytes to allocate for bulk-in buffer
201  *	(0 = end-point size)
202  * @bulk_out_size: bytes to allocate for bulk-out buffer (0 = end-point size)
203  * @calc_num_ports: pointer to a function to determine how many ports this
205  *	endpoints or to modify the port-endpoint mapping. It will be called
389 	dev_dbg(dev, "%s - length = %d, data = %*ph\n",  in usb_serial_debug_data()
402 	if (!__port->port.console || !__print_once) {			\
404 		dev_err(&__port->dev, fmt, ##__VA_ARGS__);		\
409  * module_usb_serial_driver() - Helper macro for registering a USB Serial driver