usb_copy_descriptors – copy a vector of USB descriptors Synopsis struct usb_descriptor_header **usb_copy_descriptors(struct usb_descriptor_header **src); Arguments src null-terminated vector to copy Context initialization code, which may sleep Description This makes a copy of a vector of USB descriptors. Its primary use is to support usb_function objects which can have multiple copies, each needing different descriptors. Functions…
usb_control_msg – Builds a control urb, sends it off and waits for completion Synopsis int usb_control_msg(struct usb_device *dev, unsigned int pipe, __u8 request, __u8 requesttype, __u16 value, __u16 index, void *data, __u16 size, int timeout); Arguments dev pointer to the usb device to send the message to pipe endpoint “pipe” to send the message to…
usb_composite_unregister – unregister a composite driver Synopsis void usb_composite_unregister(struct usb_composite_driver *driver); Arguments driver the driver to unregister Description This function is used to unregister drivers using the composite driver framework. Author David Brownell <dbrownell [at] users.sourceforge.net> Author. Copyright
usb_composite_setup_continue – Continue with the control transfer Synopsis void usb_composite_setup_continue(struct usb_composite_dev *cdev); Arguments cdev the composite device who’s control transfer was kept waiting Description This function must be called by the USB function driver to continue with the control transfer’s data/status stage in case it had requested to delay the data/status stages. A USB function’s…
usb_composite_probe – register a composite driver Synopsis int usb_composite_probe(struct usb_composite_driver *driver); Arguments driver the driver to register Context single threaded during gadget setup Description This function is used to register drivers using the composite driver framework. The return value is zero, or a negative errno value. Those values normally come from the driver’s bind method,…
usb_clear_halt – tells device to clear endpoint halt/stall condition Synopsis int usb_clear_halt(struct usb_device *dev, int pipe); Arguments dev device whose endpoint is halted pipe endpoint “pipe” being cleared Context !in_interrupt () Description This is used to clear halt conditions for bulk and interrupt endpoints, as reported by URB completion status. Endpoints that are halted are…
usb_calc_bus_time – approximate periodic transaction time in nanoseconds Synopsis long usb_calc_bus_time(int speed, int is_input, int isoc, int bytecount); Arguments speed from dev->speed; USB_SPEED_{LOW,FULL,HIGH} is_input true iff the transaction sends data to the host isoc true for isochronous transactions, false for interrupt ones bytecount how many bytes in the transaction. Return Approximate bus time in nanoseconds…
usb_bus_start_enum – start immediate enumeration (for OTG) Synopsis int usb_bus_start_enum(struct usb_bus *bus, unsigned port_num); Arguments bus the bus (must use hcd framework) port_num 1-based number of port; usually bus->otg_port Context in_interrupt Description Starts enumeration, with an immediate reset followed later by hub_wq identifying and possibly configuring the device. This is needed by OTG controller drivers,…
usb_bulk_msg – Builds a bulk urb, sends it off and waits for completion Synopsis int usb_bulk_msg(struct usb_device *usb_dev, unsigned int pipe, void *data, int len, int *actual_length, int timeout); Arguments usb_dev pointer to the usb device to send the message to pipe endpoint “pipe” to send the message to data pointer to the data to…
usb_buffer_unmap_sg – free DMA mapping(s) for a scatterlist Synopsis void usb_buffer_unmap_sg(const struct usb_device *dev, int is_in, struct scatterlist *sg, int n_hw_ents); Arguments dev device to which the scatterlist will be mapped is_in mapping transfer direction sg the scatterlist to unmap n_hw_ents the positive return value from usb_buffer_map_sg Description Reverses the effect of usb_buffer_map_sg. Copyright
usb_buffer_unmap – free DMA mapping(s) for an urb Synopsis void usb_buffer_unmap(struct urb *urb); Arguments urb urb whose transfer_buffer will be unmapped Description Reverses the effect of usb_buffer_map. Copyright
usb_buffer_map_sg – create scatterlist DMA mapping(s) for an endpoint Synopsis int usb_buffer_map_sg(const struct usb_device *dev, int is_in, struct scatterlist *sg, int nents); Arguments dev device to which the scatterlist will be mapped is_in mapping transfer direction sg the scatterlist to map nents the number of entries in the scatterlist Return Either < 0 (indicating no…
usb_buffer_map – create DMA mapping(s) for an urb Synopsis struct urb *usb_buffer_map(struct urb *urb); Arguments urb urb whose transfer_buffer/setup_packet will be mapped Description URB_NO_TRANSFER_DMA_MAP is added to urb->transfer_flags if the operation succeeds. If the device is connected to this system through a non-DMA controller, this operation always succeeds. This call would normally be used for…
usb_buffer_dmasync_sg – synchronize DMA and CPU view of scatterlist buffer(s) Synopsis void usb_buffer_dmasync_sg(const struct usb_device *dev, int is_in, struct scatterlist *sg, int n_hw_ents); Arguments dev device to which the scatterlist will be mapped is_in mapping transfer direction sg the scatterlist to synchronize n_hw_ents the positive return value from usb_buffer_map_sg Description Use this when you are…
usb_buffer_dmasync – synchronize DMA and CPU view of buffer(s) Synopsis void usb_buffer_dmasync(struct urb *urb); Arguments urb urb whose transfer_buffer/setup_packet will be synchronized Copyright
usb_block_urb – reliably prevent further use of an URB Synopsis void usb_block_urb(struct urb *urb); Arguments urb pointer to URB to be blocked, may be NULL Description After the routine has run, attempts to resubmit the URB will fail with error -EPERM. Thus even if the URB’s completion handler always tries to resubmit, it will not…
usb_autopm_put_interface_no_suspend – decrement a USB interface’s PM-usage counter Synopsis void usb_autopm_put_interface_no_suspend(struct usb_interface *intf); Arguments intf the usb_interface whose counter should be decremented Description This routine decrements intf‘s usage counter but does not carry out an autosuspend. This routine can run in atomic context. Copyright
usb_autopm_put_interface_async – decrement a USB interface’s PM-usage counter Synopsis void usb_autopm_put_interface_async(struct usb_interface *intf); Arguments intf the usb_interface whose counter should be decremented Description This routine does much the same thing as usb_autopm_put_interface: It decrements intf‘s usage counter and schedules a delayed autosuspend request if the counter is <= 0. The difference is that it does…
usb_autopm_put_interface – decrement a USB interface’s PM-usage counter Synopsis void usb_autopm_put_interface(struct usb_interface *intf); Arguments intf the usb_interface whose counter should be decremented Description This routine should be called by an interface driver when it is finished using intf and wants to allow it to autosuspend. A typical example would be a character-device driver when its…
usb_autopm_get_interface_no_resume – increment a USB interface’s PM-usage counter Synopsis void usb_autopm_get_interface_no_resume(struct usb_interface *intf); Arguments intf the usb_interface whose counter should be incremented Description This routine increments intf‘s usage counter but does not carry out an autoresume. This routine can run in atomic context. Copyright