130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* 230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Copyright (C) 2010 The Android Open Source Project 330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * 430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Licensed under the Apache License, Version 2.0 (the "License"); 530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * you may not use this file except in compliance with the License. 630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * You may obtain a copy of the License at 730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * 830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * http://www.apache.org/licenses/LICENSE-2.0 930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * 1030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Unless required by applicable law or agreed to in writing, software 1130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * distributed under the License is distributed on an "AS IS" BASIS, 1230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * See the License for the specific language governing permissions and 1430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * limitations under the License. 1530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 1630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 1730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#ifndef __USB_HOST_H 1830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#define __USB_HOST_H 1930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 2030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#ifdef __cplusplus 2130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodextern "C" { 2230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#endif 2330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 2430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#include <stdint.h> 2530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 263af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#include <linux/version.h> 273af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#if LINUX_VERSION_CODE > KERNEL_VERSION(2, 6, 20) 283af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#include <linux/usb/ch9.h> 293af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#else 303af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#include <linux/usb_ch9.h> 313af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling#endif 323af05b09eb116e48997a2d4611b0a1e033737d2eErik Gilling 337a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodstruct usb_host_context; 3430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodstruct usb_endpoint_descriptor; 3530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 3630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodstruct usb_descriptor_iter { 3730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood unsigned char* config; 3830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood unsigned char* config_end; 3930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood unsigned char* curr_desc; 4030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood}; 4130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 42e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwoodstruct usb_request 43e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood{ 44e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood struct usb_device *dev; 45e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood void* buffer; 46e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood int buffer_length; 47e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood int actual_length; 48e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood int max_packet_size; 49e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood void *private_data; /* struct usbdevfs_urb* */ 50b5d68a3c28d0b7a947373344cbda2a2369d0b67dMike Lockwood int endpoint; 51e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood void *client_data; /* free for use by client */ 52e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood}; 53e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood 547a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood/* Callback for notification when new USB devices are attached. 557a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood * Return true to exit from usb_host_run. 567a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood */ 577a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodtypedef int (* usb_device_added_cb)(const char *dev_name, void *client_data); 587a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood 597a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood/* Callback for notification when USB devices are removed. 607a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood * Return true to exit from usb_host_run. 617a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood */ 627a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodtypedef int (* usb_device_removed_cb)(const char *dev_name, void *client_data); 637a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood 64a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood/* Callback indicating that initial device discovery is done. 65a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood * Return true to exit from usb_host_run. 66a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood */ 67a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwoodtypedef int (* usb_discovery_done_cb)(void *client_data); 68a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood 697a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood/* Call this to initialize the USB host library. */ 707a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodstruct usb_host_context *usb_host_init(void); 7130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 727a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood/* Call this to cleanup the USB host library. */ 737a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodvoid usb_host_cleanup(struct usb_host_context *context); 7430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 75dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet/* Call this to get the inotify file descriptor. */ 76dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquetint usb_host_get_fd(struct usb_host_context *context); 77dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet 78dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet/* Call this to initialize the usb host context. */ 79dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquetint usb_host_load(struct usb_host_context *context, 80dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet usb_device_added_cb added_cb, 81dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet usb_device_removed_cb removed_cb, 82dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet usb_discovery_done_cb discovery_done_cb, 83dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet void *client_data); 84dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet 85dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet/* Call this to read and handle occuring usb event. */ 86dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquetint usb_host_read_event(struct usb_host_context *context); 87dea46b6657845a366d13f57c720eab28c9062ab7Guillaume Ranquet 887a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood/* Call this to monitor the USB bus for new and removed devices. 897a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood * This is intended to be called from a dedicated thread, 907a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood * as it will not return until one of the callbacks returns true. 9130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * added_cb will be called immediately for each existing USB device, 9230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * and subsequently each time a new device is added. 9330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * removed_cb is called when USB devices are removed from the bus. 94a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood * discovery_done_cb is called after the initial discovery of already 95a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood * connected devices is complete. 9630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 977a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwoodvoid usb_host_run(struct usb_host_context *context, 987a96ba436c9a2bacc64e712bdb53bd7accc5c3a9Mike Lockwood usb_device_added_cb added_cb, 996ac3aa157493ef24bc837b679dd8292fad8961e0Mike Lockwood usb_device_removed_cb removed_cb, 100a805519ceedc53afa5453a6d8a7d80038d885d9fMike Lockwood usb_discovery_done_cb discovery_done_cb, 1016ac3aa157493ef24bc837b679dd8292fad8961e0Mike Lockwood void *client_data); 10230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 10330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Creates a usb_device object for a USB device */ 10430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodstruct usb_device *usb_device_open(const char *dev_name); 10530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 10630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Releases all resources associated with the USB device */ 10730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodvoid usb_device_close(struct usb_device *device); 10830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 109be1def8d43d75e280cdd75d432ddcadeaff580b1Mike Lockwood/* Creates a usb_device object for already open USB device */ 110cd185f23cc6f062b252d1d19bca55e721290ee62Mike Lockwoodstruct usb_device *usb_device_new(const char *dev_name, int fd); 111cd185f23cc6f062b252d1d19bca55e721290ee62Mike Lockwood 112be1def8d43d75e280cdd75d432ddcadeaff580b1Mike Lockwood/* Returns the file descriptor for the usb_device */ 113cd185f23cc6f062b252d1d19bca55e721290ee62Mike Lockwoodint usb_device_get_fd(struct usb_device *device); 114cd185f23cc6f062b252d1d19bca55e721290ee62Mike Lockwood 11530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the name for the USB device, which is the same as 11630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * the dev_name passed to usb_device_open() 11730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 11830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodconst char* usb_device_get_name(struct usb_device *device); 11930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 1207d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood/* Returns a unique ID for the device. 1217d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood *Currently this is generated from the dev_name path. 122203f102028c4df33c191d8cd610775eba8d5366dMike Lockwood */ 123203f102028c4df33c191d8cd610775eba8d5366dMike Lockwoodint usb_device_get_unique_id(struct usb_device *device); 124203f102028c4df33c191d8cd610775eba8d5366dMike Lockwood 1257d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood/* Returns a unique ID for the device name. 1267d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood * Currently this is generated from the device path. 1277d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood */ 12807eb4af174f31c449a86dd459e2c81702f74acf1Mike Lockwoodint usb_device_get_unique_id_from_name(const char* name); 12907eb4af174f31c449a86dd459e2c81702f74acf1Mike Lockwood 1307d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood/* Returns the device name for the unique ID. 1317d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood * Call free() to deallocate the returned string */ 1327d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwoodchar* usb_device_get_name_from_unique_id(int id); 1337d700f8bdce747a26e3ee4737683194d77286ba3Mike Lockwood 13430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the USB vendor ID from the device descriptor for the USB device */ 13530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwooduint16_t usb_device_get_vendor_id(struct usb_device *device); 13630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 13730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the USB product ID from the device descriptor for the USB device */ 13830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwooduint16_t usb_device_get_product_id(struct usb_device *device); 13930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 14050372073d2919480fb32d56cb3b91663b9fca0f1Mike Lockwoodconst struct usb_device_descriptor* usb_device_get_device_descriptor(struct usb_device *device); 14150372073d2919480fb32d56cb3b91663b9fca0f1Mike Lockwood 14230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns a USB descriptor string for the given string ID. 14330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Used to implement usb_device_get_manufacturer_name, 14430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * usb_device_get_product_name and usb_device_get_serial. 14530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Call free() to free the result when you are done with it. 14630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 147dfd21b89f28bd8a6d4acdc05b74fbd03bb844f48Vitalii Tomkivchar* usb_device_get_string(struct usb_device *device, int id, int timeout); 14830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 14930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the manufacturer name for the USB device. 15030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Call free() to free the result when you are done with it. 15130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 152dfd21b89f28bd8a6d4acdc05b74fbd03bb844f48Vitalii Tomkivchar* usb_device_get_manufacturer_name(struct usb_device *device, int timeout); 15330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 15430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the product name for the USB device. 15530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Call free() to free the result when you are done with it. 15630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 157dfd21b89f28bd8a6d4acdc05b74fbd03bb844f48Vitalii Tomkivchar* usb_device_get_product_name(struct usb_device *device, int timeout); 15830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 159f68600abfc7f1e2d64a4737630feea43bdaa85dcMike Lockwood/* Returns the version number for the USB device. 160f68600abfc7f1e2d64a4737630feea43bdaa85dcMike Lockwood */ 161f68600abfc7f1e2d64a4737630feea43bdaa85dcMike Lockwoodint usb_device_get_version(struct usb_device *device); 162f68600abfc7f1e2d64a4737630feea43bdaa85dcMike Lockwood 16330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the USB serial number for the USB device. 16430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * Call free() to free the result when you are done with it. 16530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 166dfd21b89f28bd8a6d4acdc05b74fbd03bb844f48Vitalii Tomkivchar* usb_device_get_serial(struct usb_device *device, int timeout); 16730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 16830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns true if we have write access to the USB device, 16930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * and false if we only have access to the USB device configuration. 17030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 17130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodint usb_device_is_writeable(struct usb_device *device); 17230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 17330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Initializes a usb_descriptor_iter, which can be used to iterate through all 17430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * the USB descriptors for a USB device. 17530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 17630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodvoid usb_descriptor_iter_init(struct usb_device *device, struct usb_descriptor_iter *iter); 17730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 17830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Returns the next USB descriptor for a device, or NULL if we have reached the 17930ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood * end of the list. 18030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 18130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodstruct usb_descriptor_header *usb_descriptor_iter_next(struct usb_descriptor_iter *iter); 18230ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 18330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Claims the specified interface of a USB device */ 18430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodint usb_device_claim_interface(struct usb_device *device, unsigned int interface); 18530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 18630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood/* Releases the specified interface of a USB device */ 18730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwoodint usb_device_release_interface(struct usb_device *device, unsigned int interface); 18830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 189ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood/* Requests the kernel to connect or disconnect its driver for the specified interface. 190ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood * This can be used to ask the kernel to disconnect its driver for a device 191ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood * so usb_device_claim_interface can claim it instead. 192ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood */ 193ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwoodint usb_device_connect_kernel_driver(struct usb_device *device, 194ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood unsigned int interface, int connect); 195ec9e7b1c1844e66c39a4f63ded8208c1717380f8Mike Lockwood 196d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwood/* Sets the current configuration for the device to the specified configuration */ 197d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwoodint usb_device_set_configuration(struct usb_device *device, int configuration); 198d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwood 199d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwood/* Sets the specified interface of a USB device */ 200d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwoodint usb_device_set_interface(struct usb_device *device, unsigned int interface, 201d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwood unsigned int alt_setting); 202d2e798b53039f35967705acd5f6c399742f97e72Mike Lockwood 203120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood/* Sends a control message to the specified device on endpoint zero */ 204120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwoodint usb_device_control_transfer(struct usb_device *device, 205120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int requestType, 206120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int request, 207120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int value, 208120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int index, 209120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood void* buffer, 210120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int length, 211120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood unsigned int timeout); 212120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood 213b5d68a3c28d0b7a947373344cbda2a2369d0b67dMike Lockwood/* Reads or writes on a bulk endpoint. 214b5d68a3c28d0b7a947373344cbda2a2369d0b67dMike Lockwood * Returns number of bytes transferred, or negative value for error. 215b5d68a3c28d0b7a947373344cbda2a2369d0b67dMike Lockwood */ 216120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwoodint usb_device_bulk_transfer(struct usb_device *device, 217120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood int endpoint, 218120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood void* buffer, 2199879bb2ba28891cb2a4231c39ea2d5d2da730be7Philip P. Moltmann unsigned int length, 220120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood unsigned int timeout); 221120b57a3d9703bccba534af335aa94dd3a41be2fMike Lockwood 222f6411fa1ecf3a87ce78800660752f57ba9b67836Keun-young Park/** Reset USB bus for the device */ 223f6411fa1ecf3a87ce78800660752f57ba9b67836Keun-young Parkint usb_device_reset(struct usb_device *device); 224f6411fa1ecf3a87ce78800660752f57ba9b67836Keun-young Park 225e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood/* Creates a new usb_request. */ 226e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwoodstruct usb_request *usb_request_new(struct usb_device *dev, 227e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood const struct usb_endpoint_descriptor *ep_desc); 22830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 229e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood/* Releases all resources associated with the request */ 230e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwoodvoid usb_request_free(struct usb_request *req); 23130ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 232e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood/* Submits a read or write request on the specified device */ 233e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwoodint usb_request_queue(struct usb_request *req); 23430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 2353695285d5d743190ed88f982b0c531066e68b686Philip P. Moltmann /* Waits for the results of a previous usb_request_queue operation. timeoutMillis == -1 requests 2363695285d5d743190ed88f982b0c531066e68b686Philip P. Moltmann * to wait forever. 237e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood * Returns a usb_request, or NULL for error. 23830ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood */ 2393695285d5d743190ed88f982b0c531066e68b686Philip P. Moltmannstruct usb_request *usb_request_wait(struct usb_device *dev, int timeoutMillis); 24030ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 241e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwood/* Cancels a pending usb_request_queue() operation. */ 242e533c5f1005e8913f577d2aeac5a26f88f55a249Mike Lockwoodint usb_request_cancel(struct usb_request *req); 24330ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood 24430ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#ifdef __cplusplus 24530ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood} 24630ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#endif 24730ff2c70ce05d761e8cb0ab7ee02b39a681fe0cbMike Lockwood#endif /* __USB_HOST_H */ 248