usb_sg_wait – synchronously execute scatter/gather request Synopsis void usb_sg_wait(struct usb_sg_request *io); Arguments io request block handle, as initialized with usb_sg_init. some fields become accessible when this call returns. Context !in_interrupt () Description This function blocks until the specified I/O operation completes. It leverages the grouping of the related I/O requests to get good transfer rates,…
usb_sg_init – initializes scatterlist-based bulk/interrupt I/O request Synopsis int usb_sg_init(struct usb_sg_request *io, struct usb_device *dev, unsigned pipe, unsigned period, struct scatterlist *sg, int nents, size_t length, gfp_t mem_flags); Arguments io request block being initialized. until usb_sg_wait returns, treat this as a pointer to an opaque block of memory, dev the usb device that will send…
usb_sg_cancel – stop scatter/gather i/o issued by usb_sg_wait Synopsis void usb_sg_cancel(struct usb_sg_request *io); Arguments io request block, initialized with usb_sg_init Description This stops a request after it has been started by usb_sg_wait. It can also prevents one initialized by usb_sg_init from starting, so that call just frees resources allocated to the request. Copyright
usb_set_interface – Makes a particular alternate setting be current Synopsis int usb_set_interface(struct usb_device *dev, int interface, int alternate); Arguments dev the device whose interface is being updated interface the interface being updated alternate the setting being chosen. Context !in_interrupt () Description This is used to enable data transfers on interfaces that may not be enabled…
usb_set_device_state – change a device’s current state (usbcore, hcds) Synopsis void usb_set_device_state(struct usb_device *udev, enum usb_device_state new_state); Arguments udev pointer to device whose state should be changed new_state new state value to be stored Description udev->state is _not_ fully protected by the device lock. Although most transitions are made only while holding the lock, the…
usb_scuttle_anchored_urbs – unanchor all an anchor’s urbs Synopsis void usb_scuttle_anchored_urbs(struct usb_anchor *anchor); Arguments anchor the anchor whose urbs you want to unanchor Description use this to get rid of all an anchor’s urbs Copyright
usb_root_hub_lost_power – called by HCD if the root hub lost Vbus power Synopsis void usb_root_hub_lost_power(struct usb_device *rhdev); Arguments rhdev struct usb_device for the root hub Description The USB host controller driver calls this function when its root hub is resumed and Vbus power has been interrupted or the controller has been reset. The routine marks…
usb_reset_endpoint – Reset an endpoint’s state. Synopsis void usb_reset_endpoint(struct usb_device *dev, unsigned int epaddr); Arguments dev the device whose endpoint is to be reset epaddr the endpoint’s address. Endpoint number for output, endpoint number + USB_DIR_IN for input Description Resets any host-side endpoint state such as the toggle bit, sequence number or current window. Copyright
usb_reset_device – warn interface drivers and perform a USB port reset Synopsis int usb_reset_device(struct usb_device *udev); Arguments udev device to reset (not in SUSPENDED or NOTATTACHED state) Description Warns all drivers bound to registered interfaces (using their pre_reset method), performs the port reset, and then lets the drivers know that the reset is over (using…
usb_reset_configuration – lightweight device reset Synopsis int usb_reset_configuration(struct usb_device *dev); Arguments dev the device whose configuration is being reset Description This issues a standard SET_CONFIGURATION request to the device using the current configuration. The effect is to reset most USB-related state in the device, including interface altsettings (reset to zero), endpoint halts (cleared), and endpoint…
usb_remove_hcd – shutdown processing for generic HCDs Synopsis void usb_remove_hcd(struct usb_hcd *hcd); Arguments hcd the usb_hcd structure to remove Context !in_interrupt Description Disconnects the root hub, then reverses the effects of usb_add_hcd, invoking the HCD’s stop method. Copyright
usb_register_driver – register a USB interface driver Synopsis int usb_register_driver(struct usb_driver *new_driver, struct module *owner, const char *mod_name); Arguments new_driver USB operations for the interface driver owner module owner of this driver. mod_name module name string Description Registers a USB interface driver with the USB core. The list of unattached interfaces will be rescanned whenever…
usb_register_device_driver – register a USB device (not interface) driver Synopsis int usb_register_device_driver(struct usb_device_driver *new_udriver, struct module *owner); Arguments new_udriver USB operations for the device driver owner module owner of this driver. Description Registers a USB device driver with the USB core. The list of unattached devices will be rescanned whenever a new driver is added,…
usb_register_dev – register a USB device, and ask for a minor number Synopsis int usb_register_dev(struct usb_interface *intf, struct usb_class_driver *class_driver); Arguments intf pointer to the usb_interface that is being registered class_driver pointer to the usb_class_driver for this device Description This should be called by all USB drivers that use the USB major number. If CONFIG_USB_DYNAMIC_MINORS…
usb_queue_reset_device – Reset a USB device from an atomic context Synopsis void usb_queue_reset_device(struct usb_interface *iface); Arguments iface USB interface belonging to the device to reset Description This function can be used to reset a USB device from an atomic context, where usb_reset_device won’t work (as it blocks). Doing a reset via this method is functionally…
usb_put_intf – release a use of the usb interface structure Synopsis void usb_put_intf(struct usb_interface *intf); Arguments intf interface that’s been decremented Description Must be called when a user of an interface is finished with it. When the last user of the interface calls this function, the memory of the interface is freed. Copyright
usb_put_dev – release a use of the usb device structure Synopsis void usb_put_dev(struct usb_device *dev); Arguments dev device that’s been disconnected Description Must be called when a user of a device is finished with it. When the last user of the device calls this function, the memory of the device is freed. Copyright
usb_poison_urb – reliably kill a transfer and prevent further use of an URB Synopsis void usb_poison_urb(struct urb *urb); Arguments urb pointer to URB describing a previously submitted request, may be NULL Description This routine cancels an in-progress request. It is guaranteed that upon return all completion handlers will have finished and the URB will be…
usb_poison_anchored_urbs – cease all traffic from an anchor Synopsis void usb_poison_anchored_urbs(struct usb_anchor *anchor); Arguments anchor anchor the requests are bound to Description this allows all outstanding URBs to be poisoned starting from the back of the queue. Newly added URBs will also be poisoned This routine should not be called by a driver after its…
usb_match_id – find first usb_device_id matching device or interface Synopsis const struct usb_device_id *usb_match_id(struct usb_interface *interface, const struct usb_device_id *id); Arguments interface the interface of interest id array of usb_device_id structures, terminated by zero entry Description usb_match_id searches an array of usb_device_id’s and returns the first one matching the device or interface, or null. This…