linux/usb/composite.h

2  * composite.h -- framework for usb gadgets which are composite devices
4  * Copyright (C) 2006-2008 David Brownell
6  * SPDX-License-Identifier:	GPL-2.0+
15  * functions within any single configuration, and (b) Multi-configuration
42  * struct usb_function - describes one function of a configuration
46  * @descriptors: Table of full (or low) speed descriptors, using interface and
48  *	the function will not be available at full speed (or at low speed).
49  * @hs_descriptors: Table of high speed descriptors, using interface and
51  *	the function will not be available at high speed.
52  * @ss_descriptors: Table of super speed descriptors, using interface and
54  *	the function will not be available at super speed.
70  * @setup: Used for interface-specific control requests.
75  * cases support operation at both full and high speeds.  Each function is
81  * To support dual speed operation, a function driver provides descriptors
82  * for both high and full speed operation.  Except in rare cases that don't
83  * involve bulk endpoints, each speed needs different endpoint descriptors.
88  * than one configuration at a given speed, it needs to support multiple
92  * a driver-specific instance structure to allows multiple activations.  An
143  * ep_choose - select descriptor endpoint at current device speed
144  * @g: gadget, connected and running at some speed
145  * @hs: descriptor to use for high speed operation
146  * @fs: descriptor to use for full or low speed operation
152 	if (gadget_is_dualspeed(g) && g->speed == USB_SPEED_HIGH)  in ep_choose()
160  * struct usb_configuration - represents one gadget configuration
165  *	Examples include OTG and vendor-specific descriptors.
181  * configuration, and handle dual-speed hardware by always providing the same
183  * single-function configuration at a given speed; or have configurations
184  * that only work at one speed.
241  * struct usb_composite_driver - groups configurations into a gadget
295  * struct usb_composite_device - represents one composite usb gadget
296  * @gadget: read-only, abstracts the gadget's usb peripheral controller
297  * @req: used for control responses; buffer is pre-allocated
298  * @bufsiz: size of buffer pre-allocated in @req
316  *     wireless-specific parameters like maxburst and maxsequence;