 |
libusb
1.0.25
A cross-platform user library to access USB devices
|
30 #if !defined(__cplusplus)
31 #define inline __inline
34 #ifndef _SSIZE_T_DEFINED
35 #define _SSIZE_T_DEFINED
37 typedef SSIZE_T ssize_t;
43 #include <sys/types.h>
44 #if !defined(_MSC_VER)
49 #if defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L)
50 #define ZERO_SIZED_ARRAY
52 #define ZERO_SIZED_ARRAY 0
60 #if defined(_WIN32) || defined(__CYGWIN__)
62 #if defined(interface)
65 #if !defined(__CYGWIN__)
70 #if defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5))
71 #define LIBUSB_DEPRECATED_FOR(f) __attribute__ ((deprecated ("Use " #f " instead")))
72 #elif defined(__GNUC__) && (__GNUC__ >= 3)
73 #define LIBUSB_DEPRECATED_FOR(f) __attribute__ ((deprecated))
75 #define LIBUSB_DEPRECATED_FOR(f)
79 #define LIBUSB_PACKED __attribute__ ((packed))
116 #if defined(_WIN32) || defined(__CYGWIN__)
117 #define LIBUSB_CALL WINAPI
142 #define LIBUSB_API_VERSION 0x01000109
145 #define LIBUSBX_API_VERSION LIBUSB_API_VERSION
147 #if defined(__cplusplus)
165 _tmp.b8[1] = (uint8_t) (x >> 8);
166 _tmp.b8[0] = (uint8_t) (x & 0xff);
178 #define libusb_le16_to_cpu libusb_cpu_to_le16
205 LIBUSB_CLASS_PTP = 0x06,
291 #define LIBUSB_DT_DEVICE_SIZE 18
292 #define LIBUSB_DT_CONFIG_SIZE 9
293 #define LIBUSB_DT_INTERFACE_SIZE 9
294 #define LIBUSB_DT_ENDPOINT_SIZE 7
295 #define LIBUSB_DT_ENDPOINT_AUDIO_SIZE 9
296 #define LIBUSB_DT_HUB_NONVAR_SIZE 7
297 #define LIBUSB_DT_SS_ENDPOINT_COMPANION_SIZE 6
298 #define LIBUSB_DT_BOS_SIZE 5
299 #define LIBUSB_DT_DEVICE_CAPABILITY_SIZE 3
302 #define LIBUSB_BT_USB_2_0_EXTENSION_SIZE 7
303 #define LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE 10
304 #define LIBUSB_BT_CONTAINER_ID_SIZE 20
307 #define LIBUSB_DT_BOS_MAX_SIZE \
308 (LIBUSB_DT_BOS_SIZE + \
309 LIBUSB_BT_USB_2_0_EXTENSION_SIZE + \
310 LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE + \
311 LIBUSB_BT_CONTAINER_ID_SIZE)
313 #define LIBUSB_ENDPOINT_ADDRESS_MASK 0x0f
314 #define LIBUSB_ENDPOINT_DIR_MASK 0x80
328 #define LIBUSB_TRANSFER_TYPE_MASK 0x03
432 #define LIBUSB_ISO_SYNC_TYPE_MASK 0x0c
453 #define LIBUSB_ISO_USAGE_TYPE_MASK 0x30
910 #if defined(_MSC_VER) || defined(__WATCOMC__)
911 #pragma pack(push, 1)
938 #if defined(_MSC_VER) || defined(__WATCOMC__)
942 #define LIBUSB_CONTROL_SETUP_SIZE (sizeof(struct libusb_control_setup))
1099 #define LIBUSB_ERROR_COUNT 14
1424 unsigned char endpoint);
1426 unsigned char endpoint);
1436 int interface_number);
1438 int interface_number);
1444 int interface_number,
int alternate_setting);
1446 unsigned char endpoint);
1450 uint32_t num_streams,
unsigned char *endpoints,
int num_endpoints);
1452 unsigned char *endpoints,
int num_endpoints);
1457 unsigned char *buffer,
size_t length);
1460 int interface_number);
1462 int interface_number);
1464 int interface_number);
1485 return transfer->
buffer + LIBUSB_CONTROL_SETUP_SIZE;
1588 transfer->
buffer = buffer;
1590 transfer->
length = (int) (LIBUSB_CONTROL_SETUP_SIZE
1612 void *user_data,
unsigned int timeout)
1618 transfer->
buffer = buffer;
1619 transfer->
length = length;
1642 unsigned char endpoint, uint32_t stream_id,
1644 void *user_data,
unsigned int timeout)
1647 length, callback, user_data, timeout);
1667 unsigned char endpoint,
unsigned char *buffer,
int length,
1674 transfer->
buffer = buffer;
1675 transfer->
length = length;
1696 unsigned char *buffer,
int length,
int num_iso_packets,
1703 transfer->
buffer = buffer;
1704 transfer->
length = length;
1753 if (packet > INT_MAX)
1755 _packet = (int) packet;
1760 for (i = 0; i < _packet; i++)
1763 return transfer->
buffer + offset;
1793 if (packet > INT_MAX)
1795 _packet = (int) packet;
1807 unsigned char *data, uint16_t
wLength,
unsigned int timeout);
1810 unsigned char endpoint,
unsigned char *data,
int length,
1811 int *actual_length,
unsigned int timeout);
1814 unsigned char endpoint,
unsigned char *data,
int length,
1815 int *actual_length,
unsigned int timeout);
1830 uint8_t desc_type, uint8_t desc_index,
unsigned char *data,
int length)
1834 0, data, (uint16_t) length, 1000);
1852 uint8_t desc_index, uint16_t langid,
unsigned char *data,
int length)
1856 langid, data, (uint16_t) length, 1000);
1860 uint8_t desc_index,
unsigned char *data,
int length);
1875 struct timeval *tv);
1877 struct timeval *tv,
int *completed);
1881 struct timeval *tv);
1884 struct timeval *tv);
1972 #define LIBUSB_HOTPLUG_NO_FLAGS 0
1976 #define LIBUSB_HOTPLUG_MATCH_ANY -1
2040 int vendor_id,
int product_id,
int dev_class,
2124 #define LIBUSB_OPTION_WEAK_AUTHORITY LIBUSB_OPTION_NO_DEVICE_DISCOVERY
2126 LIBUSB_OPTION_MAX = 3
2131 #if defined(__cplusplus)
int libusb_get_port_path(libusb_context *ctx, libusb_device *dev, uint8_t *path, uint8_t path_length)
Definition: core.c:967
libusb_endpoint_direction
Definition: libusb.h:320
int libusb_init(libusb_context **ctx)
Definition: core.c:2284
uint8_t bRequest
Request.
Definition: libusb.h:926
@ LIBUSB_FULL_SPEED_OPERATION
Full speed operation supported (12MBit/s).
Definition: libusb.h:480
@ LIBUSB_CLASS_DATA
Data class.
Definition: libusb.h:217
int libusb_set_configuration(libusb_device_handle *dev_handle, int configuration)
Definition: core.c:1630
uint8_t bDeviceSubClass
USB-IF subclass code for the device, qualified by the bDeviceClass value.
Definition: libusb.h:549
@ LIBUSB_SPEED_UNKNOWN
The OS doesn't report or know the device speed.
Definition: libusb.h:1026
int num_altsetting
The number of alternate settings that belong to this interface.
Definition: libusb.h:688
@ LIBUSB_BT_USB_2_0_EXTENSION
USB 2.0 extensions.
Definition: libusb.h:517
libusb_capability
Definition: libusb.h:1292
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:746
uint16_t wBytesPerInterval
The total number of bytes this EP will transfer every service interval.
Definition: libusb.h:765
@ LIBUSB_TRANSFER_CANCELLED
Transfer was cancelled.
Definition: libusb.h:1134
uint8_t bDeviceProtocol
USB-IF protocol code for the device, qualified by the bDeviceClass and bDeviceSubClass values.
Definition: libusb.h:553
uint8_t bRefresh
For audio devices only: the rate at which synchronization feedback is provided.
Definition: libusb.h:615
Definition: libusb.h:1889
const char * libusb_strerror(int errcode)
Definition: strerror.c:213
@ LIBUSB_ENDPOINT_OUT
Out: host-to-device.
Definition: libusb.h:322
void libusb_set_debug(libusb_context *ctx, int level)
Definition: core.c:2106
@ LIBUSB_ERROR_NO_DEVICE
No such device (it may have been disconnected)
Definition: libusb.h:1065
@ LIBUSB_REQUEST_SET_FEATURE
Set or enable a specific feature.
Definition: libusb.h:360
libusb_request_recipient
Definition: libusb.h:418
@ LIBUSB_ISO_SYNC_TYPE_ASYNC
Asynchronous.
Definition: libusb.h:444
int libusb_clear_halt(libusb_device_handle *dev_handle, unsigned char endpoint)
Definition: core.c:1798
@ LIBUSB_LOG_LEVEL_NONE
(0) : No messages ever emitted by the library (default)
Definition: libusb.h:1315
int libusb_bulk_transfer(libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *data, int length, int *actual_length, unsigned int timeout)
Definition: sync.c:274
void libusb_free_container_id_descriptor(struct libusb_container_id_descriptor *container_id)
Definition: descriptor.c:1067
int libusb_get_device_descriptor(libusb_device *dev, struct libusb_device_descriptor *desc)
Definition: descriptor.c:531
@ LIBUSB_ERROR_OVERFLOW
Overflow.
Definition: libusb.h:1077
@ LIBUSB_ISO_USAGE_TYPE_DATA
Data endpoint.
Definition: libusb.h:462
uint8_t bSynchAddress
For audio devices only: the address if the synch endpoint.
Definition: libusb.h:618
libusb_hotplug_event
Definition: libusb.h:1950
uint8_t bmAttributes
In bulk EP: bits 4:0 represents the maximum number of streams the EP supports.
Definition: libusb.h:761
int libusb_wrap_sys_device(libusb_context *ctx, intptr_t sys_dev, libusb_device_handle **dev_handle)
Definition: core.c:1241
uint8_t bmAttributes
Attributes which apply to the endpoint when it is configured using the bConfigurationValue.
Definition: libusb.h:605
@ LIBUSB_LOG_CB_GLOBAL
Callback function handling all log messages.
Definition: libusb.h:1339
@ LIBUSB_ISO_SYNC_TYPE_SYNC
Synchronous.
Definition: libusb.h:450
static unsigned char * libusb_control_transfer_get_data(struct libusb_transfer *transfer)
Definition: libusb.h:1482
int libusb_event_handler_active(libusb_context *ctx)
Definition: io.c:1901
void libusb_free_ss_usb_device_capability_descriptor(struct libusb_ss_usb_device_capability_descriptor *ss_usb_device_cap)
Definition: descriptor.c:1013
@ LIBUSB_ISO_SYNC_TYPE_NONE
No synchronization.
Definition: libusb.h:441
@ LIBUSB_DT_CONFIG
Configuration descriptor.
Definition: libusb.h:254
@ LIBUSB_OPTION_LOG_LEVEL
Set the log message verbosity.
Definition: libusb.h:2094
struct libusb_context libusb_context
Definition: libusb.h:991
@ LIBUSB_REQUEST_GET_STATUS
Request status of the specific recipient.
Definition: libusb.h:352
int libusb_interrupt_transfer(libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *data, int length, int *actual_length, unsigned int timeout)
Definition: sync.c:328
@ LIBUSB_TRANSFER_OVERFLOW
Device sent more data than requested.
Definition: libusb.h:1144
uint8_t MaxPower
Maximum power consumption of the USB device from this bus in this configuration when the device is fu...
Definition: libusb.h:724
uint8_t bNumDeviceCaps
The number of separate device capability descriptors in the BOS.
Definition: libusb.h:808
static unsigned char * libusb_get_iso_packet_buffer_simple(struct libusb_transfer *transfer, unsigned int packet)
Definition: libusb.h:1785
unsigned char type
Type of the transfer from libusb_transfer_type.
Definition: libusb.h:1237
void(* libusb_log_cb)(libusb_context *ctx, enum libusb_log_level level, const char *str)
Definition: libusb.h:1356
int libusb_handle_events(libusb_context *ctx)
Definition: io.c:2423
@ LIBUSB_TRANSFER_TYPE_CONTROL
Control transfer.
Definition: libusb.h:1105
int libusb_cancel_transfer(struct libusb_transfer *transfer)
Definition: io.c:1599
@ LIBUSB_CLASS_CONTENT_SECURITY
Content Security.
Definition: libusb.h:223
uint16_t wTotalLength
Length of this descriptor and all of its sub descriptors.
Definition: libusb.h:804
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:592
libusb_transfer_type
Definition: libusb.h:1103
const char * describe
For ABI compatibility only.
Definition: libusb.h:970
@ LIBUSB_CLASS_COMM
Communications class.
Definition: libusb.h:195
libusb_transfer_status
Definition: libusb.h:1122
@ LIBUSB_REQUEST_SET_INTERFACE
Select an alternate interface for the specified interface.
Definition: libusb.h:383
@ LIBUSB_REQUEST_SET_ADDRESS
Set device address for all future accesses.
Definition: libusb.h:365
uint8_t bInterval
Interval for polling endpoint for data transfers.
Definition: libusb.h:611
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:751
uint8_t bDevCapabilityType
Capability type.
Definition: libusb.h:899
@ LIBUSB_REQUEST_CLEAR_FEATURE
Clear or disable a specific feature.
Definition: libusb.h:355
@ LIBUSB_ERROR_BUSY
Resource busy.
Definition: libusb.h:1071
uint8_t bNumInterfaces
Number of interfaces supported by this configuration.
Definition: libusb.h:709
void libusb_set_pollfd_notifiers(libusb_context *ctx, libusb_pollfd_added_cb added_cb, libusb_pollfd_removed_cb removed_cb, void *user_data)
Definition: io.c:2627
libusb_endpoint_transfer_type
Definition: libusb.h:334
uint8_t bAlternateSetting
Value used to select this alternate setting for this interface.
Definition: libusb.h:646
uint8_t iConfiguration
Index of string descriptor describing this configuration.
Definition: libusb.h:715
@ LIBUSB_RECIPIENT_ENDPOINT
Endpoint.
Definition: libusb.h:426
int extra_length
Length of the extra descriptors, in bytes.
Definition: libusb.h:625
int libusb_detach_kernel_driver(libusb_device_handle *dev_handle, int interface_number)
Definition: core.c:2017
uint8_t bmAttributes
Configuration characteristics.
Definition: libusb.h:718
unsigned int timeout
Timeout for this transfer in milliseconds.
Definition: libusb.h:1241
@ LIBUSB_DT_HID
HID descriptor.
Definition: libusb.h:272
@ LIBUSB_LOG_LEVEL_WARNING
(2) : Warning and error messages are emitted
Definition: libusb.h:1321
uint8_t bFunctionalitySupport
The lowest speed at which all the functionality supported by the device is available to the user.
Definition: libusb.h:873
libusb_supported_speed
Definition: libusb.h:475
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:698
@ LIBUSB_ERROR_IO
Input/output error.
Definition: libusb.h:1056
@ LIBUSB_CAP_HAS_CAPABILITY
The libusb_has_capability() API is available.
Definition: libusb.h:1294
uint16_t wMaxPacketSize
Maximum packet size this endpoint is capable of sending/receiving.
Definition: libusb.h:608
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:635
@ LIBUSB_ERROR_NOT_FOUND
Entity not found.
Definition: libusb.h:1068
uint8_t bDevCapabilityType
Capability type.
Definition: libusb.h:857
@ LIBUSB_CLASS_DIAGNOSTIC_DEVICE
Diagnostic Device.
Definition: libusb.h:232
const unsigned char * extra
Extra descriptors.
Definition: libusb.h:672
@ LIBUSB_REQUEST_TYPE_STANDARD
Standard.
Definition: libusb.h:402
int libusb_release_interface(libusb_device_handle *dev_handle, int interface_number)
Definition: core.c:1711
@ LIBUSB_TRANSFER_SHORT_NOT_OK
Report short frames as errors.
Definition: libusb.h:1154
@ LIBUSB_RECIPIENT_OTHER
Other.
Definition: libusb.h:429
@ LIBUSB_SPEED_FULL
The device is operating at full speed (12MBit/s).
Definition: libusb.h:1032
struct libusb_bos_dev_capability_descriptor * dev_capability[ZERO_SIZED_ARRAY]
bNumDeviceCap Device Capability Descriptors
Definition: libusb.h:811
const unsigned char * extra
Extra descriptors.
Definition: libusb.h:732
uint8_t iProduct
Index of string descriptor describing product.
Definition: libusb.h:571
uint8_t bU1DevExitLat
U1 Device Exit Latency.
Definition: libusb.h:876
libusb_device * libusb_ref_device(libusb_device *dev)
Definition: core.c:1164
libusb_usb_2_0_extension_attributes
Definition: libusb.h:494
int libusb_get_container_id_descriptor(libusb_context *ctx, struct libusb_bos_dev_capability_descriptor *dev_cap, struct libusb_container_id_descriptor **container_id)
Definition: descriptor.c:1032
unsigned int actual_length
Amount of data that was actually transferred.
Definition: libusb.h:1201
const char * libusb_error_name(int errcode)
Definition: core.c:2686
int extra_length
Length of the extra descriptors, in bytes.
Definition: libusb.h:735
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:780
@ LIBUSB_RECIPIENT_DEVICE
Device.
Definition: libusb.h:420
@ LIBUSB_SPEED_SUPER
The device is operating at super speed (5000MBit/s).
Definition: libusb.h:1038
void libusb_free_bos_descriptor(struct libusb_bos_descriptor *bos)
Definition: descriptor.c:896
const struct libusb_endpoint_descriptor * endpoint
Array of endpoint descriptors.
Definition: libusb.h:668
@ LIBUSB_REQUEST_SET_SEL
Sets both the U1 and U2 Exit Latency.
Definition: libusb.h:389
int libusb_get_max_packet_size(libusb_device *dev, unsigned char endpoint)
Definition: core.c:1054
uint16_t bU2DevExitLat
U2 Device Exit Latency.
Definition: libusb.h:879
#define libusb_le16_to_cpu
Definition: libusb.h:178
@ LIBUSB_REQUEST_SET_DESCRIPTOR
Used to update existing descriptors or add new descriptors.
Definition: libusb.h:371
struct libusb_iso_packet_descriptor iso_packet_desc[ZERO_SIZED_ARRAY]
Isochronous packet descriptors, for isochronous transfers only.
Definition: libusb.h:1284
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:826
@ LIBUSB_CLASS_APPLICATION
Application class.
Definition: libusb.h:241
ssize_t libusb_get_device_list(libusb_context *ctx, libusb_device ***list)
Definition: core.c:815
void libusb_transfer_set_stream_id(struct libusb_transfer *transfer, uint32_t stream_id)
Definition: io.c:1643
unsigned char * buffer
Data buffer.
Definition: libusb.h:1277
uint8_t bDevCapabilityType
Device Capability type.
Definition: libusb.h:783
int libusb_get_configuration(libusb_device_handle *dev, int *config)
Definition: core.c:1543
int libusb_set_auto_detach_kernel_driver(libusb_device_handle *dev_handle, int enable)
Definition: core.c:2092
uint8_t bReserved
Reserved field.
Definition: libusb.h:902
@ LIBUSB_CAP_HAS_HOTPLUG
Hotplug support is available on this platform.
Definition: libusb.h:1297
void libusb_exit(libusb_context *ctx)
Definition: core.c:2400
#define LIBUSB_CALL
Definition: libusb.h:119
uint8_t flags
A bitwise OR combination of libusb_transfer_flags.
Definition: libusb.h:1231
static void libusb_fill_control_setup(unsigned char *buffer, uint8_t bmRequestType, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, uint16_t wLength)
Definition: libusb.h:1529
const unsigned char * extra
Extra descriptors.
Definition: libusb.h:622
uint16_t wTotalLength
Total length of data returned for this configuration.
Definition: libusb.h:706
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:847
struct libusb_device libusb_device
Definition: libusb.h:1008
int libusb_dev_mem_free(libusb_device_handle *dev_handle, unsigned char *buffer, size_t length)
Definition: core.c:1953
static void libusb_fill_bulk_stream_transfer(struct libusb_transfer *transfer, libusb_device_handle *dev_handle, unsigned char endpoint, uint32_t stream_id, unsigned char *buffer, int length, libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout)
Definition: libusb.h:1640
void libusb_unlock_events(libusb_context *ctx)
Definition: io.c:1837
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:587
uint8_t bmRequestType
Request type.
Definition: libusb.h:919
@ LIBUSB_TRANSFER_COMPLETED
Transfer completed without error.
Definition: libusb.h:1125
int libusb_reset_device(libusb_device_handle *dev_handle)
Definition: core.c:1827
@ LIBUSB_ERROR_INVALID_PARAM
Invalid parameter.
Definition: libusb.h:1059
int libusb_get_bos_descriptor(libusb_device_handle *dev_handle, struct libusb_bos_descriptor **bos)
Definition: descriptor.c:846
void libusb_free_transfer(struct libusb_transfer *transfer)
Definition: io.c:1334
libusb_class_code
Definition: libusb.h:184
@ LIBUSB_CLASS_IMAGE
Image class.
Definition: libusb.h:204
struct libusb_transfer * libusb_alloc_transfer(int iso_packets)
Definition: io.c:1285
@ LIBUSB_CLASS_PHYSICAL
Physical.
Definition: libusb.h:201
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:821
int libusb_setlocale(const char *locale)
Definition: strerror.c:178
void(* libusb_pollfd_removed_cb)(int fd, void *user_data)
Definition: libusb.h:1922
static int libusb_get_string_descriptor(libusb_device_handle *dev_handle, uint8_t desc_index, uint16_t langid, unsigned char *data, int length)
Definition: libusb.h:1851
int libusb_attach_kernel_driver(libusb_device_handle *dev_handle, int interface_number)
Definition: core.c:2053
@ LIBUSB_ERROR_OTHER
Other error.
Definition: libusb.h:1095
@ LIBUSB_DT_STRING
String descriptor.
Definition: libusb.h:257
uint32_t bmAttributes
Bitmap encoding of supported device level features.
Definition: libusb.h:837
uint8_t iSerialNumber
Index of string descriptor containing device serial number.
Definition: libusb.h:574
const struct libusb_pollfd ** libusb_get_pollfds(libusb_context *ctx)
Definition: io.c:2735
libusb_option
Definition: libusb.h:2072
@ LIBUSB_BT_WIRELESS_USB_DEVICE_CAPABILITY
Wireless USB device capability.
Definition: libusb.h:514
@ LIBUSB_ERROR_PIPE
Pipe error.
Definition: libusb.h:1080
@ LIBUSB_DT_DEVICE
Device descriptor.
Definition: libusb.h:251
@ LIBUSB_TRANSFER_ERROR
Transfer failed.
Definition: libusb.h:1128
@ LIBUSB_OPTION_USE_USBDK
Use the UsbDk backend for a specific context, if available.
Definition: libusb.h:2103
@ LIBUSB_DT_ENDPOINT
Endpoint descriptor.
Definition: libusb.h:263
int libusb_get_port_numbers(libusb_device *dev, uint8_t *port_numbers, int port_numbers_len)
Definition: core.c:941
void(* libusb_transfer_cb_fn)(struct libusb_transfer *transfer)
Definition: libusb.h:1218
int libusb_handle_events_completed(libusb_context *ctx, int *completed)
Definition: io.c:2445
uint16_t idProduct
USB-IF product ID.
Definition: libusb.h:562
@ LIBUSB_HIGH_SPEED_OPERATION
High speed operation supported (480MBit/s).
Definition: libusb.h:483
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:852
void libusb_free_usb_2_0_extension_descriptor(struct libusb_usb_2_0_extension_descriptor *usb_2_0_extension)
Definition: descriptor.c:957
uint16_t bcdDevice
Device release number in binary-coded decimal.
Definition: libusb.h:565
uint8_t bmAttributes
Bitmap encoding of supported device level features.
Definition: libusb.h:863
int libusb_hotplug_register_callback(libusb_context *ctx, int events, int flags, int vendor_id, int product_id, int dev_class, libusb_hotplug_callback_fn cb_fn, void *user_data, libusb_hotplug_callback_handle *callback_handle)
Definition: hotplug.c:323
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:775
void libusb_unlock_event_waiters(libusb_context *ctx)
Definition: io.c:1977
int libusb_hotplug_callback_handle
Definition: libusb.h:1943
@ LIBUSB_ENDPOINT_TRANSFER_TYPE_INTERRUPT
Interrupt endpoint.
Definition: libusb.h:345
uint8_t bEndpointAddress
The address of the endpoint described by this descriptor.
Definition: libusb.h:597
libusb_device * libusb_get_parent(libusb_device *dev)
Definition: core.c:987
libusb_ss_usb_device_capability_attributes
Definition: libusb.h:504
@ LIBUSB_ENDPOINT_IN
In: device-to-host.
Definition: libusb.h:325
@ LIBUSB_DT_SS_ENDPOINT_COMPANION
SuperSpeed Endpoint Companion descriptor.
Definition: libusb.h:287
@ LIBUSB_TRANSFER_TYPE_BULK_STREAM
Bulk stream transfer.
Definition: libusb.h:1117
int libusb_get_usb_2_0_extension_descriptor(libusb_context *ctx, struct libusb_bos_dev_capability_descriptor *dev_cap, struct libusb_usb_2_0_extension_descriptor **usb_2_0_extension)
Definition: descriptor.c:921
@ LIBUSB_ISO_SYNC_TYPE_ADAPTIVE
Adaptive.
Definition: libusb.h:447
int libusb_get_next_timeout(libusb_context *ctx, struct timeval *tv)
Definition: io.c:2555
@ LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT
A device has left and is no longer available.
Definition: libusb.h:1957
libusb_descriptor_type
Definition: libusb.h:249
const uint16_t major
Library major version.
Definition: libusb.h:955
uint8_t bDevCapabilityType
Capability type.
Definition: libusb.h:831
libusb_device_handle * dev_handle
Handle of the device that this transfer will be submitted to.
Definition: libusb.h:1228
int libusb_set_option(libusb_context *ctx, enum libusb_option option,...)
Definition: core.c:2189
@ LIBUSB_BT_CONTAINER_ID
Container ID type.
Definition: libusb.h:523
uint8_t bInterfaceClass
USB-IF class code for this interface.
Definition: libusb.h:653
uint8_t bDeviceClass
USB-IF class code for the device.
Definition: libusb.h:545
static void libusb_fill_interrupt_transfer(struct libusb_transfer *transfer, libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *buffer, int length, libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout)
Definition: libusb.h:1665
int libusb_submit_transfer(struct libusb_transfer *transfer)
Definition: io.c:1504
@ LIBUSB_SPEED_HIGH
The device is operating at high speed (480MBit/s).
Definition: libusb.h:1035
@ LIBUSB_TRANSFER_STALL
For bulk/interrupt endpoints: halt condition detected (endpoint stalled).
Definition: libusb.h:1138
uint8_t libusb_get_device_address(libusb_device *dev)
Definition: core.c:997
@ LIBUSB_DT_REPORT
HID report descriptor.
Definition: libusb.h:275
void libusb_lock_event_waiters(libusb_context *ctx)
Definition: io.c:1966
libusb_transfer_cb_fn callback
Callback function.
Definition: libusb.h:1262
@ LIBUSB_CLASS_PER_INTERFACE
In the context of a device descriptor, this bDeviceClass value indicates that each interface specifie...
Definition: libusb.h:189
libusb_standard_request
Definition: libusb.h:350
@ LIBUSB_ISO_USAGE_TYPE_IMPLICIT
Implicit feedback Data endpoint.
Definition: libusb.h:468
uint8_t bNumEndpoints
Number of endpoints used by this interface (excluding the control endpoint).
Definition: libusb.h:650
@ LIBUSB_REQUEST_GET_CONFIGURATION
Get the current device configuration value.
Definition: libusb.h:374
const struct libusb_interface_descriptor * altsetting
Array of interface descriptors.
Definition: libusb.h:684
@ LIBUSB_TRANSFER_FREE_BUFFER
Automatically free() transfer buffer during libusb_free_transfer().
Definition: libusb.h:1160
@ LIBUSB_CLASS_MASS_STORAGE
Mass storage class.
Definition: libusb.h:211
@ LIBUSB_CLASS_HUB
Hub class.
Definition: libusb.h:214
@ LIBUSB_SPEED_LOW
The device is operating at low speed (1.5MBit/s).
Definition: libusb.h:1029
int(* libusb_hotplug_callback_fn)(libusb_context *ctx, libusb_device *device, libusb_hotplug_event event, void *user_data)
Definition: libusb.h:2000
@ LIBUSB_SUCCESS
Success (no error)
Definition: libusb.h:1053
@ LIBUSB_ENDPOINT_TRANSFER_TYPE_BULK
Bulk endpoint.
Definition: libusb.h:342
uint8_t libusb_get_bus_number(libusb_device *dev)
Definition: core.c:906
@ LIBUSB_TRANSFER_TYPE_ISOCHRONOUS
Isochronous transfer.
Definition: libusb.h:1108
int libusb_alloc_streams(libusb_device_handle *dev_handle, uint32_t num_streams, unsigned char *endpoints, int num_endpoints)
Definition: core.c:1860
@ LIBUSB_DT_SUPERSPEED_HUB
SuperSpeed Hub descriptor.
Definition: libusb.h:284
libusb_device_handle * libusb_open_device_with_vid_pid(libusb_context *ctx, uint16_t vendor_id, uint16_t product_id)
Definition: core.c:1351
@ LIBUSB_TRANSFER_FREE_TRANSFER
Automatically call libusb_free_transfer() after callback returns.
Definition: libusb.h:1166
uint16_t idVendor
USB-IF vendor ID.
Definition: libusb.h:559
void libusb_lock_events(libusb_context *ctx)
Definition: io.c:1822
@ LIBUSB_ERROR_NOT_SUPPORTED
Operation not supported or unimplemented on this platform.
Definition: libusb.h:1089
int libusb_get_max_iso_packet_size(libusb_device *dev, unsigned char endpoint)
Definition: core.c:1109
@ LIBUSB_RECIPIENT_INTERFACE
Interface.
Definition: libusb.h:423
short events
Event flags to poll for from <poll.h>.
Definition: libusb.h:1897
const uint16_t micro
Library micro version.
Definition: libusb.h:961
@ LIBUSB_SUPER_SPEED_OPERATION
Superspeed operation supported (5000MBit/s).
Definition: libusb.h:486
int libusb_open(libusb_device *dev, libusb_device_handle **dev_handle)
Definition: core.c:1296
void libusb_free_ss_endpoint_companion_descriptor(struct libusb_ss_endpoint_companion_descriptor *ep_comp)
Definition: descriptor.c:754
int fd
Numeric file descriptor.
Definition: libusb.h:1891
const uint16_t minor
Library minor version.
Definition: libusb.h:958
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:889
@ LIBUSB_CAP_SUPPORTS_DETACH_KERNEL_DRIVER
The library supports detaching of the default USB driver, using libusb_detach_kernel_driver(),...
Definition: libusb.h:1307
int libusb_kernel_driver_active(libusb_device_handle *dev_handle, int interface_number)
Definition: core.c:1979
uint16_t wLength
Number of bytes to transfer.
Definition: libusb.h:936
int num_iso_packets
Number of isochronous packets.
Definition: libusb.h:1281
uint8_t bInterfaceSubClass
USB-IF subclass code for this interface, qualified by the bInterfaceClass value.
Definition: libusb.h:657
static void libusb_set_iso_packet_lengths(struct libusb_transfer *transfer, unsigned int length)
Definition: libusb.h:1718
uint16_t wSpeedSupported
Bitmap encoding of the speed supported by this device when operating in SuperSpeed mode.
Definition: libusb.h:867
@ LIBUSB_ERROR_TIMEOUT
Operation timed out.
Definition: libusb.h:1074
uint16_t wValue
Value.
Definition: libusb.h:929
int libusb_set_interface_alt_setting(libusb_device_handle *dev_handle, int interface_number, int alternate_setting)
Definition: core.c:1756
int libusb_pollfds_handle_timeouts(libusb_context *ctx)
Definition: io.c:2521
uint32_t libusb_transfer_get_stream_id(struct libusb_transfer *transfer)
Definition: io.c:1660
@ LIBUSB_ISO_USAGE_TYPE_FEEDBACK
Feedback endpoint.
Definition: libusb.h:465
@ LIBUSB_REQUEST_TYPE_RESERVED
Reserved.
Definition: libusb.h:411
@ LIBUSB_BM_LTM_SUPPORT
Supports Latency Tolerance Messages (LTM)
Definition: libusb.h:506
@ LIBUSB_TRANSFER_NO_DEVICE
Device was disconnected.
Definition: libusb.h:1141
int libusb_event_handling_ok(libusb_context *ctx)
Definition: io.c:1872
int libusb_handle_events_timeout(libusb_context *ctx, struct timeval *tv)
Definition: io.c:2403
int libusb_has_capability(uint32_t capability)
Definition: core.c:2470
libusb_error
Definition: libusb.h:1051
@ LIBUSB_LOW_SPEED_OPERATION
Low speed operation supported (1.5MBit/s).
Definition: libusb.h:477
libusb_log_cb_mode
Definition: libusb.h:1337
uint8_t ContainerID[16]
128 bit UUID
Definition: libusb.h:905
@ LIBUSB_ENDPOINT_TRANSFER_TYPE_CONTROL
Control endpoint.
Definition: libusb.h:336
int libusb_wait_for_event(libusb_context *ctx, struct timeval *tv)
Definition: io.c:2009
@ LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED
A device has been plugged in and is ready to use.
Definition: libusb.h:1952
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:801
int libusb_get_ss_endpoint_companion_descriptor(libusb_context *ctx, const struct libusb_endpoint_descriptor *endpoint, struct libusb_ss_endpoint_companion_descriptor **ep_comp)
Definition: descriptor.c:705
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:703
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:533
unsigned char * libusb_dev_mem_alloc(libusb_device_handle *dev_handle, size_t length)
Definition: core.c:1933
void libusb_free_pollfds(const struct libusb_pollfd **pollfds)
Definition: io.c:2783
uint8_t bLength
Size of this descriptor (in bytes)
Definition: libusb.h:796
const uint16_t nano
Library nano version.
Definition: libusb.h:964
@ LIBUSB_REQUEST_SYNCH_FRAME
Set then report an endpoint's synchronization frame.
Definition: libusb.h:386
@ LIBUSB_DT_BOS
BOS descriptor.
Definition: libusb.h:266
unsigned char endpoint
Address of the endpoint where this transfer will be sent.
Definition: libusb.h:1234
uint8_t dev_capability_data[ZERO_SIZED_ARRAY]
Device Capability data (bLength - 3 bytes)
Definition: libusb.h:786
uint16_t bcdUSB
USB specification release number in binary-coded decimal.
Definition: libusb.h:542
@ LIBUSB_TRANSFER_TYPE_BULK
Bulk transfer.
Definition: libusb.h:1111
@ LIBUSB_CLASS_MISCELLANEOUS
Miscellaneous class.
Definition: libusb.h:238
@ LIBUSB_ERROR_NO_MEM
Insufficient memory.
Definition: libusb.h:1086
Definition: libusb.h:1226
int length
Length of the data buffer.
Definition: libusb.h:1253
@ LIBUSB_CLASS_PRINTER
Printer class.
Definition: libusb.h:208
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:640
@ LIBUSB_CLASS_WIRELESS
Wireless class.
Definition: libusb.h:235
int libusb_get_config_descriptor_by_value(libusb_device *dev, uint8_t bConfigurationValue, struct libusb_config_descriptor **config)
Definition: descriptor.c:642
@ LIBUSB_BM_LPM_SUPPORT
Supports Link Power Management (LPM)
Definition: libusb.h:496
void * user_data
User context data.
Definition: libusb.h:1274
static void libusb_fill_iso_transfer(struct libusb_transfer *transfer, libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *buffer, int length, int num_iso_packets, libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout)
Definition: libusb.h:1694
@ LIBUSB_ENDPOINT_TRANSFER_TYPE_ISOCHRONOUS
Isochronous endpoint.
Definition: libusb.h:339
uint16_t wIndex
Index.
Definition: libusb.h:933
static void libusb_fill_bulk_transfer(struct libusb_transfer *transfer, libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *buffer, int length, libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout)
Definition: libusb.h:1609
int libusb_get_string_descriptor_ascii(libusb_device_handle *dev_handle, uint8_t desc_index, unsigned char *data, int length)
Definition: descriptor.c:1085
@ LIBUSB_TRANSFER_TIMED_OUT
Transfer timed out.
Definition: libusb.h:1131
libusb_log_level
Definition: libusb.h:1313
libusb_transfer_flags
Definition: libusb.h:1152
@ LIBUSB_ERROR_ACCESS
Access denied (insufficient permissions)
Definition: libusb.h:1062
libusb_iso_sync_type
Definition: libusb.h:439
@ LIBUSB_CLASS_SMART_CARD
Smart Card.
Definition: libusb.h:220
libusb_device * libusb_get_device(libusb_device_handle *dev_handle)
Definition: core.c:1518
libusb_bos_type
Definition: libusb.h:512
uint8_t bMaxPacketSize0
Maximum packet size for endpoint 0.
Definition: libusb.h:556
@ LIBUSB_LOG_LEVEL_INFO
(3) : Informational, warning and error messages are emitted
Definition: libusb.h:1324
const struct libusb_interface * interface
Array of interfaces supported by this configuration.
Definition: libusb.h:728
uint8_t bConfigurationValue
Identifier value for this configuration.
Definition: libusb.h:712
uint8_t bNumConfigurations
Number of possible configurations.
Definition: libusb.h:577
int libusb_handle_events_locked(libusb_context *ctx, struct timeval *tv)
Definition: io.c:2473
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:894
libusb_hotplug_flag
Definition: libusb.h:1965
@ LIBUSB_REQUEST_TYPE_VENDOR
Vendor.
Definition: libusb.h:408
const struct libusb_version * libusb_get_version(void)
Definition: core.c:2741
int libusb_get_active_config_descriptor(libusb_device *dev, struct libusb_config_descriptor **config)
Definition: descriptor.c:555
@ LIBUSB_BT_SS_USB_DEVICE_CAPABILITY
SuperSpeed USB device capability.
Definition: libusb.h:520
void libusb_free_config_descriptor(struct libusb_config_descriptor *config)
Definition: descriptor.c:682
void * libusb_hotplug_get_user_data(libusb_context *ctx, libusb_hotplug_callback_handle callback_handle)
Definition: hotplug.c:445
uint8_t bInterfaceProtocol
USB-IF protocol code for this interface, qualified by the bInterfaceClass and bInterfaceSubClass valu...
Definition: libusb.h:661
libusb_request_type
Definition: libusb.h:400
int extra_length
Length of the extra descriptors, in bytes.
Definition: libusb.h:675
@ LIBUSB_LOG_CB_CONTEXT
Callback function handling context related log messages.
Definition: libusb.h:1342
void libusb_set_log_cb(libusb_context *ctx, libusb_log_cb cb, int mode)
Definition: core.c:2143
@ LIBUSB_CAP_HAS_HID_ACCESS
The library can access HID devices without requiring user intervention.
Definition: libusb.h:1303
void libusb_hotplug_deregister_callback(libusb_context *ctx, libusb_hotplug_callback_handle callback_handle)
Definition: hotplug.c:407
void libusb_close(libusb_device_handle *dev_handle)
Definition: core.c:1456
@ LIBUSB_REQUEST_SET_CONFIGURATION
Set device configuration.
Definition: libusb.h:377
unsigned int length
Length of data to request in this packet.
Definition: libusb.h:1198
int libusb_try_lock_events(libusb_context *ctx)
Definition: io.c:1779
int actual_length
Actual length of data that was transferred.
Definition: libusb.h:1258
enum libusb_transfer_status status
Status code for this packet.
Definition: libusb.h:1204
static struct libusb_control_setup * libusb_control_transfer_get_setup(struct libusb_transfer *transfer)
Definition: libusb.h:1500
libusb_iso_usage_type
Definition: libusb.h:460
void libusb_free_device_list(libusb_device **list, int unref_devices)
Definition: core.c:885
@ LIBUSB_REQUEST_GET_DESCRIPTOR
Get the specified descriptor.
Definition: libusb.h:368
@ LIBUSB_DT_DEVICE_CAPABILITY
Device Capability descriptor.
Definition: libusb.h:269
uint8_t libusb_get_port_number(libusb_device *dev)
Definition: core.c:925
int libusb_control_transfer(libusb_device_handle *dev_handle, uint8_t request_type, uint8_t bRequest, uint16_t wValue, uint16_t wIndex, unsigned char *data, uint16_t wLength, unsigned int timeout)
Definition: sync.c:97
@ LIBUSB_SPEED_SUPER_PLUS
The device is operating at super speed plus (10000MBit/s).
Definition: libusb.h:1041
int libusb_claim_interface(libusb_device_handle *dev_handle, int interface_number)
Definition: core.c:1667
void libusb_unref_device(libusb_device *dev)
Definition: core.c:1179
Definition: libusb.h:1196
@ LIBUSB_ERROR_INTERRUPTED
System call interrupted (perhaps due to signal)
Definition: libusb.h:1083
uint8_t bMaxBurst
The maximum number of packets the endpoint can send or receive as part of a burst.
Definition: libusb.h:755
int libusb_get_device_speed(libusb_device *dev)
Definition: core.c:1008
@ LIBUSB_DT_PHYSICAL
Physical descriptor.
Definition: libusb.h:278
static int libusb_get_descriptor(libusb_device_handle *dev_handle, uint8_t desc_type, uint8_t desc_index, unsigned char *data, int length)
Definition: libusb.h:1829
@ LIBUSB_HOTPLUG_ENUMERATE
Arm the callback and fire it for all matching currently attached devices.
Definition: libusb.h:1967
@ LIBUSB_SET_ISOCH_DELAY
Delay from the time a host transmits a packet to the time it is received by the device.
Definition: libusb.h:393
uint8_t iManufacturer
Index of string descriptor describing manufacturer.
Definition: libusb.h:568
@ LIBUSB_REQUEST_TYPE_CLASS
Class.
Definition: libusb.h:405
@ LIBUSB_TRANSFER_ADD_ZERO_PACKET
Terminate transfers that are a multiple of the endpoint's wMaxPacketSize with an extra zero length pa...
Definition: libusb.h:1191
static unsigned char * libusb_get_iso_packet_buffer(struct libusb_transfer *transfer, unsigned int packet)
Definition: libusb.h:1743
@ LIBUSB_CLASS_PERSONAL_HEALTHCARE
Personal Healthcare.
Definition: libusb.h:229
void libusb_interrupt_event_handler(libusb_context *ctx)
Definition: io.c:1930
int libusb_handle_events_timeout_completed(libusb_context *ctx, struct timeval *tv, int *completed)
Definition: io.c:2331
@ LIBUSB_CLASS_AUDIO
Audio class.
Definition: libusb.h:192
uint8_t iInterface
Index of string descriptor describing this interface.
Definition: libusb.h:664
@ LIBUSB_CLASS_HID
Human Interface Device class.
Definition: libusb.h:198
@ LIBUSB_OPTION_NO_DEVICE_DISCOVERY
Do not scan for devices.
Definition: libusb.h:2122
uint8_t bDescriptorType
Descriptor type.
Definition: libusb.h:538
@ LIBUSB_CLASS_VENDOR_SPEC
Class is vendor-specific.
Definition: libusb.h:244
const char * rc
Library release candidate suffix string, e.g.
Definition: libusb.h:967
int libusb_get_ss_usb_device_capability_descriptor(libusb_context *ctx, struct libusb_bos_dev_capability_descriptor *dev_cap, struct libusb_ss_usb_device_capability_descriptor **ss_usb_device_cap)
Definition: descriptor.c:976
libusb_speed
Definition: libusb.h:1024
@ LIBUSB_LOG_LEVEL_DEBUG
(4) : All messages are emitted
Definition: libusb.h:1327
struct libusb_device_handle libusb_device_handle
Definition: libusb.h:1019
void(* libusb_pollfd_added_cb)(int fd, short events, void *user_data)
Definition: libusb.h:1910
@ LIBUSB_DT_HUB
Hub descriptor.
Definition: libusb.h:281
uint8_t bInterfaceNumber
Number of this interface.
Definition: libusb.h:643
@ LIBUSB_CLASS_VIDEO
Video.
Definition: libusb.h:226
static uint16_t libusb_cpu_to_le16(const uint16_t x)
Definition: libusb.h:159
int libusb_get_config_descriptor(libusb_device *dev, uint8_t config_index, struct libusb_config_descriptor **config)
Definition: descriptor.c:596
static void libusb_fill_control_transfer(struct libusb_transfer *transfer, libusb_device_handle *dev_handle, unsigned char *buffer, libusb_transfer_cb_fn callback, void *user_data, unsigned int timeout)
Definition: libusb.h:1578
enum libusb_transfer_status status
The status of the transfer.
Definition: libusb.h:1250
@ LIBUSB_LOG_LEVEL_ERROR
(1) : Error messages are emitted
Definition: libusb.h:1318
@ LIBUSB_TRANSFER_TYPE_INTERRUPT
Interrupt transfer.
Definition: libusb.h:1114
@ LIBUSB_DT_INTERFACE
Interface descriptor.
Definition: libusb.h:260
int libusb_free_streams(libusb_device_handle *dev_handle, unsigned char *endpoints, int num_endpoints)
Definition: core.c:1890
@ LIBUSB_REQUEST_GET_INTERFACE
Return the selected alternate setting for the specified interface.
Definition: libusb.h:380