USB_DRIVER_SET_CONFI(9) USB Core APIs USB_DRIVER_SET_CONFI(9)NAME
usb_driver_set_configuration - Provide a way for drivers to change device configurations
SYNOPSIS
int usb_driver_set_configuration(struct usb_device * udev, int config);
ARGUMENTS
udev
the device whose configuration is being updated
config
the configuration being chosen.
CONTEXT
In process context, must be able to sleep
DESCRIPTION
Device interface drivers are not allowed to change device configurations. This is because changing configurations will destroy the
interface the driver is bound to and create new ones; it would be like a floppy-disk driver telling the computer to replace the floppy-disk
drive with a tape drive!
Still, in certain specialized circumstances the need may arise. This routine gets around the normal restrictions by using a work thread to
submit the change-config request.
Returns 0 if the request was successfully queued, error code otherwise. The caller has no way to know whether the queued request will
eventually succeed.
COPYRIGHT Kernel Hackers Manual 2.6. July 2010 USB_DRIVER_SET_CONFI(9)
Check Out this Related Man Page
STRUCT USB_HOST_CONF(9) Host-Side Data Types and Macro STRUCT USB_HOST_CONF(9)NAME
struct_usb_host_config - representation of a device's configuration
SYNOPSIS
struct usb_host_config {
struct usb_config_descriptor desc;
char * string;
struct usb_interface_assoc_descriptor * intf_assoc[USB_MAXIADS];
struct usb_interface * interface[USB_MAXINTERFACES];
struct usb_interface_cache * intf_cache[USB_MAXINTERFACES];
unsigned char * extra;
int extralen;
};
MEMBERS
desc
the device's configuration descriptor.
string
pointer to the cached version of the iConfiguration string, if present for this configuration.
intf_assoc[USB_MAXIADS]
list of any interface association descriptors in this config
interface[USB_MAXINTERFACES]
array of pointers to usb_interface structures, one for each interface in the configuration. The number of interfaces is stored in
desc.bNumInterfaces. These pointers are valid only while the the configuration is active.
intf_cache[USB_MAXINTERFACES]
array of pointers to usb_interface_cache structures, one for each interface in the configuration. These structures exist for the entire
life of the device.
extra
pointer to buffer containing all extra descriptors associated with this configuration (those preceding the first interface descriptor).
extralen
length of the extra descriptors buffer.
DESCRIPTION
USB devices may have multiple configurations, but only one can be active at any time. Each encapsulates a different operational
environment; for example, a dual-speed device would have separate configurations for full-speed and high-speed operation. The number of
configurations available is stored in the device descriptor as bNumConfigurations.
A configuration can contain multiple interfaces. Each corresponds to a different function of the USB device, and all are available whenever
the configuration is active. The USB standard says that interfaces are supposed to be numbered from 0 to desc.bNumInterfaces-1, but a lot
of devices get this wrong. In addition, the interface array is not guaranteed to be sorted in numerical order. Use usb_ifnum_to_if to look
up an interface entry based on its number.
Device drivers should not attempt to activate configurations. The choice of which configuration to install is a policy decision based on
such considerations as available power, functionality provided, and the user's desires (expressed through userspace tools). However,
drivers can call usb_reset_configuration to reinitialize the current configuration and all its interfaces.
COPYRIGHT Kernel Hackers Manual 2.6. July 2010 STRUCT USB_HOST_CONF(9)