Shofel2_T124_python/venv/lib/python3.10/site-packages/usb1/_libusb1.py

1367 lines
53 KiB
Python
Raw Normal View History

2024-05-25 16:45:07 +00:00
# Copyright (C) 2010-2021 Vincent Pelletier <plr.vincent@gmail.com>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
# pylint: disable=invalid-name, too-few-public-methods, too-many-arguments
# pylint: disable=missing-docstring
"""
Python ctypes bindings for libusb-1.0.
You should not need to import this if you use usb1 module.
Declares all constants, data structures and exported symbols.
Some are only available after calling loadLibrary.
"""
from ctypes import (
Structure, LittleEndianStructure,
CFUNCTYPE, POINTER, addressof, sizeof, cast,
c_short, c_int, c_uint, c_long,
c_uint8, c_uint16, c_uint32,
c_void_p, c_char_p, py_object, pointer, c_char,
c_ssize_t, CDLL
)
import ctypes.util
import os.path
import platform
import sys
from threading import Lock
class Enum:
def __init__(self, member_dict, scope_dict=None):
if scope_dict is None:
# Affect caller's locals, not this module's.
# pylint: disable=protected-access
scope_dict = sys._getframe(1).f_locals
# pylint: enable=protected-access
forward_dict = {}
reverse_dict = {}
next_value = 0
for name, value in member_dict.items():
if value is None:
value = next_value
next_value += 1
forward_dict[name] = value
if value in reverse_dict:
raise ValueError('Multiple names for value %r: %r, %r' % (
value, reverse_dict[value], name
))
reverse_dict[value] = name
scope_dict[name] = value
self.forward_dict = forward_dict
self.reverse_dict = reverse_dict
def __call__(self, value):
return self.reverse_dict[value]
def get(self, value, default=None):
return self.reverse_dict.get(value, default)
def buffer_at(address, length):
"""
Simular to ctypes.string_at, but zero-copy and requires an integer address.
"""
return bytearray((c_char * length).from_address(address))
_desc_type_dict = {
'b': c_uint8,
'bcd': c_uint16,
'bm': c_uint8,
'dw': c_uint32,
'i': c_uint8,
'id': c_uint16,
'w': c_uint16,
}
def newStruct(field_name_list):
"""
Create a ctype structure class based on USB standard field naming
(type-prefixed).
"""
field_list = []
append = field_list.append
for field in field_name_list:
type_prefix = ''
for char in field:
if not char.islower():
break
type_prefix += char
append((field, _desc_type_dict[type_prefix]))
result = type('some_descriptor', (LittleEndianStructure, ), {})
# Not using type()'s 3rd param to initialise class, as per ctypes
# documentation:
# _pack_ must already be defined when _fields_ is assigned, otherwise it
# will have no effect.
# pylint: disable=protected-access
result._pack_ = 1
result._fields_ = field_list
# pylint: enable=protected-access
return result
def newDescriptor(field_name_list):
"""
Create a USB descriptor ctype structure, ie starting with bLength and
bDescriptorType fields.
See newStruct().
"""
return newStruct(['bLength', 'bDescriptorType'] + list(field_name_list))
class USBError(Exception):
value = None
def __init__(self, value=None):
Exception.__init__(self)
if value is not None:
self.value = value
def __str__(self):
return '%s [%s]' % (libusb_error.get(self.value, 'Unknown error'),
self.value)
c_uchar = c_uint8
c_int_p = POINTER(c_int)
LITTLE_ENDIAN = sys.byteorder == 'little'
class timeval(Structure):
_fields_ = [('tv_sec', c_long),
('tv_usec', c_long)]
timeval_p = POINTER(timeval)
def __getLibrary():
system = platform.system()
if system == 'Windows':
dll_loader = ctypes.WinDLL
suffix = '.dll'
else:
dll_loader = ctypes.CDLL
suffix = '.dylib' if system == 'Darwin' else '.so'
filename = 'libusb-1.0' + suffix
# If this is a binary wheel, use the integrated libusb unconditionally.
# To use the libusb from the Python installation or the OS, install from sdist:
# > pip install --no-binary :all: libusb1
if os.path.exists(os.path.join(os.path.dirname(__file__), filename)):
filename = os.path.join(os.path.dirname(__file__), filename)
try:
return dll_loader(filename, use_errno=True, use_last_error=True)
except OSError:
libusb_path = None
base_name = 'usb-1.0'
if 'FreeBSD' in system:
# libusb.so.2 on FreeBSD: load('libusb.so') would work fine, but...
# libusb.so.2debian on Debian GNU/kFreeBSD: here it wouldn't work.
# So use find_library instead.
base_name = 'usb'
elif system == 'Darwin':
for libusb_path in (
# macport standard path
'/opt/local/lib/libusb-1.0.dylib',
# fink standard path
'/sw/lib/libusb-1.0.dylib',
# homebrew standard path for symlink (Apple M1 Silicon)
'/opt/homebrew/opt/libusb/lib/libusb-1.0.dylib',
):
if os.path.exists(libusb_path):
break
else:
libusb_path = None
if libusb_path is None:
libusb_path = ctypes.util.find_library(base_name)
if libusb_path is None:
raise
return dll_loader(libusb_path, use_errno=True, use_last_error=True)
__load_lock = Lock()
__loaded = False
def loadLibrary(libusb=None):
"""
Load C library.
libusb (ctypes.CDLL, ctypes.WinDLL, None)
If None, the C library will be searched for in several platform-
dependent paths.
Otherwise, this is the C library to use as libusb. This is to allow
customising library lookup logic.
Only the first call actually loads the library.
Returns True if any of the following is true:
- the library was loaded by this call
- libusb argument is None
- libusb argument is the same object that was initially loaded.
"""
global __loaded # pylint: disable=global-statement
if not __loaded: # avoid touching the lock if we are already loaded
with __load_lock:
if not __loaded: # we were not loaded, check again under lock
__loadLibrary(libusb)
__loaded = True
return True
return libusb is None or globals()['libusb'] is libusb
def __loadLibrary(libusb): # pylint: disable=too-many-locals,too-many-branches,too-many-statements
# WARNING: every local in this function will be stored in
# globals . Treat this namespace the same as the module's.
if libusb is None:
libusb = __getLibrary()
_libusb_transfer_fields = [
('dev_handle', libusb_device_handle_p),
('flags', c_uint8),
('endpoint', c_uchar),
('type', c_uchar),
('timeout', c_uint),
('status', c_int), # enum libusb_transfer_status
('length', c_int),
('actual_length', c_int),
('callback', libusb_transfer_cb_fn_p),
('user_data', c_void_p),
('buffer', c_void_p),
('num_iso_packets', c_int),
('iso_packet_desc', libusb_iso_packet_descriptor)
]
if 'FreeBSD' in platform.system() and getattr(
libusb, 'libusb_get_string_descriptor', None
) is None:
# Old FreeBSD version has a slight ABI incompatibility.
# Work around it unless libusb_get_string_descriptor is available, as it
# is only available on fixed versions.
assert _libusb_transfer_fields[2][0] == 'endpoint'
_libusb_transfer_fields[2] = ('endpoint', c_uint32)
assert _libusb_transfer_fields[11][0] == 'num_iso_packets'
_libusb_transfer_fields.insert(11, ('os_priv', c_void_p))
# pylint: disable=protected-access
libusb_transfer._fields_ = _libusb_transfer_fields
# pylint: enable=protected-access
#int libusb_init(libusb_context **ctx);
libusb_init = libusb.libusb_init
libusb_init.argtypes = [libusb_context_p_p]
#void libusb_exit(libusb_context *ctx);
libusb_exit = libusb.libusb_exit
libusb_exit.argtypes = [libusb_context_p]
libusb_exit.restype = None
#void libusb_set_debug(libusb_context *ctx, int level);
libusb_set_debug = libusb.libusb_set_debug
libusb_set_debug.argtypes = [libusb_context_p, c_int]
libusb_set_debug.restype = None
#const struct libusb_version * libusb_get_version(void);
try:
libusb_get_version = libusb.libusb_get_version
except AttributeError:
_dummy_version = libusb_version(0, 0, 0, 0, b'', b'')
_dummy_version_p = pointer(_dummy_version)
def libusb_get_version():
return _dummy_version_p
else:
libusb_get_version.argtypes = []
libusb_get_version.restype = POINTER(libusb_version)
#int libusb_has_capability(uint32_t capability);
try:
libusb_has_capability = libusb.libusb_has_capability
except AttributeError:
def libusb_has_capability(_):
return 0
else:
libusb_has_capability.argtypes = [c_uint32]
libusb_has_capability.restype = c_int
try:
# Note: Should be equivalent to libusb_error.get (except libusb_error.get
# one raises on unknown values).
#char *libusb_error_name(int errcode);
libusb_error_name = libusb.libusb_error_name
except AttributeError:
# pylint: disable=unused-argument
def libusb_error_name(errcode):
return None
# pylint: enable=unused-argument
else:
libusb_error_name.argtypes = [c_int]
libusb_error_name.restype = c_char_p
#ssize_t libusb_get_device_list(libusb_context *ctx,
# libusb_device ***list);
libusb_get_device_list = libusb.libusb_get_device_list
libusb_get_device_list.argtypes = [libusb_context_p, libusb_device_p_p_p]
libusb_get_device_list.restype = c_ssize_t
#void libusb_free_device_list(libusb_device **list, int unref_devices);
libusb_free_device_list = libusb.libusb_free_device_list
libusb_free_device_list.argtypes = [libusb_device_p_p, c_int]
libusb_free_device_list.restype = None
#libusb_device *libusb_ref_device(libusb_device *dev);
libusb_ref_device = libusb.libusb_ref_device
libusb_ref_device.argtypes = [libusb_device_p]
libusb_ref_device.restype = libusb_device_p
#void libusb_unref_device(libusb_device *dev);
libusb_unref_device = libusb.libusb_unref_device
libusb_unref_device.argtypes = [libusb_device_p]
libusb_unref_device.restype = None
#int libusb_get_configuration(libusb_device_handle *dev, int *config);
libusb_get_configuration = libusb.libusb_get_configuration
libusb_get_configuration.argtypes = [libusb_device_handle_p, c_int_p]
#int libusb_get_device_descriptor(libusb_device *dev,
# struct libusb_device_descriptor *desc);
libusb_get_device_descriptor = libusb.libusb_get_device_descriptor
libusb_get_device_descriptor.argtypes = [
libusb_device_p, libusb_device_descriptor_p]
#int libusb_get_active_config_descriptor(libusb_device *dev,
# struct libusb_config_descriptor **config);
libusb_get_active_config_descriptor = libusb.libusb_get_active_config_descriptor
libusb_get_active_config_descriptor.argtypes = [
libusb_device_p, libusb_config_descriptor_p_p]
#int libusb_get_config_descriptor(libusb_device *dev, uint8_t config_index,
# struct libusb_config_descriptor **config);
libusb_get_config_descriptor = libusb.libusb_get_config_descriptor
libusb_get_config_descriptor.argtypes = [
libusb_device_p, c_uint8, libusb_config_descriptor_p_p]
#int libusb_get_config_descriptor_by_value(libusb_device *dev,
# uint8_t bConfigurationValue, struct libusb_config_descriptor **config);
libusb_get_config_descriptor_by_value = \
libusb.libusb_get_config_descriptor_by_value
libusb_get_config_descriptor_by_value.argtypes = [
libusb_device_p, c_uint8, libusb_config_descriptor_p_p]
#void libusb_free_config_descriptor(struct libusb_config_descriptor *config);
libusb_free_config_descriptor = libusb.libusb_free_config_descriptor
libusb_free_config_descriptor.argtypes = [libusb_config_descriptor_p]
libusb_free_config_descriptor.restype = None
#uint8_t libusb_get_bus_number(libusb_device *dev);
libusb_get_bus_number = libusb.libusb_get_bus_number
libusb_get_bus_number.argtypes = [libusb_device_p]
libusb_get_bus_number.restype = c_uint8
try:
#uint8_t libusb_get_port_number(libusb_device *dev);
libusb_get_port_number = libusb.libusb_get_port_number
except AttributeError:
pass
else:
libusb_get_port_number.argtypes = [libusb_device_p]
libusb_get_port_number.restype = c_uint8
try:
#int libusb_get_port_numbers(libusb_device *dev,
# uint8_t* port_numbers, int port_numbers_len);
libusb_get_port_numbers = libusb.libusb_get_port_numbers
except AttributeError:
pass
else:
libusb_get_port_numbers.argtypes = [
libusb_device_p, POINTER(c_uint8), c_int]
libusb_get_port_numbers.restype = c_int
# Missing: libusb_get_port_path (deprecated since 1.0.16)
try:
#libusb_device * LIBUSB_CALL libusb_get_parent(libusb_device *dev);
libusb_get_parent = libusb.libusb_get_parent
except AttributeError:
pass
else:
libusb_get_parent.argtypes = [libusb_device_p]
libusb_get_parent.restype = libusb_device_p
#uint8_t libusb_get_device_address(libusb_device *dev);
libusb_get_device_address = libusb.libusb_get_device_address
libusb_get_device_address.argtypes = [libusb_device_p]
libusb_get_device_address.restype = c_uint8
try:
#int libusb_get_device_speed(libusb_device *dev);
libusb_get_device_speed = libusb.libusb_get_device_speed
except AttributeError:
# Place holder
def libusb_get_device_speed(_):
# pylint: disable=undefined-variable
return LIBUSB_SPEED_UNKNOWN
# pylint: enable=undefined-variable
else:
libusb_get_device_speed.argtypes = [libusb_device_p]
#int libusb_get_max_packet_size(libusb_device *dev, unsigned char endpoint);
libusb_get_max_packet_size = libusb.libusb_get_max_packet_size
libusb_get_max_packet_size.argtypes = [libusb_device_p, c_uchar]
#int libusb_get_max_iso_packet_size(libusb_device *dev, unsigned char endpoint);
try:
libusb_get_max_iso_packet_size = libusb.libusb_get_max_iso_packet_size
except AttributeError:
# FreeBSD's reimplementation of the API [used to ]lack[s] this function.
# It has been added in r234193, but is lacking in default 9.x install as
# of this change. Provide a fallback to error-out only if actually used.
# pylint: disable=unused-argument
def libusb_get_max_iso_packet_size(_, __):
raise NotImplementedError
# pylint: enable=unused-argument
else:
libusb_get_max_iso_packet_size.argtypes = [libusb_device_p, c_uchar]
#int libusb_open(libusb_device *dev, libusb_device_handle **handle);
libusb_open = libusb.libusb_open
libusb_open.argtypes = [libusb_device_p, libusb_device_handle_p_p]
#void libusb_close(libusb_device_handle *dev_handle);
libusb_close = libusb.libusb_close
libusb_close.argtypes = [libusb_device_handle_p]
libusb_close.restype = None
#libusb_device *libusb_get_device(libusb_device_handle *dev_handle);
libusb_get_device = libusb.libusb_get_device
libusb_get_device.argtypes = [libusb_device_handle_p]
libusb_get_device.restype = libusb_device_p
#int libusb_set_configuration(libusb_device_handle *dev, int configuration);
libusb_set_configuration = libusb.libusb_set_configuration
libusb_set_configuration.argtypes = [libusb_device_handle_p, c_int]
#int libusb_claim_interface(libusb_device_handle *dev, int iface);
libusb_claim_interface = libusb.libusb_claim_interface
libusb_claim_interface.argtypes = [libusb_device_handle_p, c_int]
#int libusb_release_interface(libusb_device_handle *dev, int iface);
libusb_release_interface = libusb.libusb_release_interface
libusb_release_interface.argtypes = [libusb_device_handle_p, c_int]
#libusb_device_handle *libusb_open_device_with_vid_pid(libusb_context *ctx,
# uint16_t vendor_id, uint16_t product_id);
libusb_open_device_with_vid_pid = libusb.libusb_open_device_with_vid_pid
libusb_open_device_with_vid_pid.argtypes = [
libusb_context_p, c_uint16, c_uint16]
libusb_open_device_with_vid_pid.restype = libusb_device_handle_p
#int libusb_set_interface_alt_setting(libusb_device_handle *dev,
# int interface_number, int alternate_setting);
libusb_set_interface_alt_setting = libusb.libusb_set_interface_alt_setting
libusb_set_interface_alt_setting.argtypes = [
libusb_device_handle_p, c_int, c_int]
#int libusb_clear_halt(libusb_device_handle *dev, unsigned char endpoint);
libusb_clear_halt = libusb.libusb_clear_halt
libusb_clear_halt.argtypes = [libusb_device_handle_p, c_uchar]
#int libusb_reset_device(libusb_device_handle *dev);
libusb_reset_device = libusb.libusb_reset_device
libusb_reset_device.argtypes = [libusb_device_handle_p]
#int libusb_kernel_driver_active(libusb_device_handle *dev, int interface);
libusb_kernel_driver_active = libusb.libusb_kernel_driver_active
libusb_kernel_driver_active.argtypes = [libusb_device_handle_p, c_int]
#int libusb_detach_kernel_driver(libusb_device_handle *dev, int interface);
libusb_detach_kernel_driver = libusb.libusb_detach_kernel_driver
libusb_detach_kernel_driver.argtypes = [libusb_device_handle_p, c_int]
#int libusb_attach_kernel_driver(libusb_device_handle *dev, int interface);
libusb_attach_kernel_driver = libusb.libusb_attach_kernel_driver
libusb_attach_kernel_driver.argtypes = [libusb_device_handle_p, c_int]
try:
#int libusb_set_auto_detach_kernel_driver(
# libusb_device_handle *dev, int enable);
libusb_set_auto_detach_kernel_driver = \
libusb.libusb_set_auto_detach_kernel_driver
except AttributeError:
pass
else:
libusb_set_auto_detach_kernel_driver.argtypes = [
libusb_device_handle_p, c_int]
libusb_set_auto_detach_kernel_driver.restype = c_int
#struct libusb_transfer *libusb_alloc_transfer(int iso_packets);
libusb_alloc_transfer = libusb.libusb_alloc_transfer
libusb_alloc_transfer.argtypes = [c_int]
libusb_alloc_transfer.restype = libusb_transfer_p
#int libusb_submit_transfer(struct libusb_transfer *transfer);
libusb_submit_transfer = libusb.libusb_submit_transfer
libusb_submit_transfer.argtypes = [libusb_transfer_p]
#int libusb_cancel_transfer(struct libusb_transfer *transfer);
libusb_cancel_transfer = libusb.libusb_cancel_transfer
libusb_cancel_transfer.argtypes = [libusb_transfer_p]
#void libusb_free_transfer(struct libusb_transfer *transfer);
libusb_free_transfer = libusb.libusb_free_transfer
libusb_free_transfer.argtypes = [libusb_transfer_p]
libusb_free_transfer.restype = None
# sync I/O
#int libusb_control_transfer(libusb_device_handle *dev_handle,
# uint8_t request_type, uint8_t request, uint16_t value, uint16_t index,
# unsigned char *data, uint16_t length, unsigned int timeout);
libusb_control_transfer = libusb.libusb_control_transfer
libusb_control_transfer.argtypes = [libusb_device_handle_p, c_uint8, c_uint8,
c_uint16, c_uint16, c_void_p, c_uint16,
c_uint]
#int libusb_bulk_transfer(libusb_device_handle *dev_handle,
# unsigned char endpoint, unsigned char *data, int length,
# int *actual_length, unsigned int timeout);
libusb_bulk_transfer = libusb.libusb_bulk_transfer
libusb_bulk_transfer.argtypes = [libusb_device_handle_p, c_uchar, c_void_p,
c_int, c_int_p, c_uint]
#int libusb_interrupt_transfer(libusb_device_handle *dev_handle,
# unsigned char endpoint, unsigned char *data, int length,
# int *actual_length, unsigned int timeout);
libusb_interrupt_transfer = libusb.libusb_interrupt_transfer
libusb_interrupt_transfer.argtypes = [libusb_device_handle_p, c_uchar,
c_void_p, c_int, c_int_p, c_uint]
#int libusb_get_string_descriptor_ascii(libusb_device_handle *dev,
# uint8_t index, unsigned char *data, int length);
libusb_get_string_descriptor_ascii = libusb.libusb_get_string_descriptor_ascii
libusb_get_string_descriptor_ascii.argtypes = [libusb_device_handle_p,
c_uint8, c_void_p, c_int]
# polling and timeouts
#int libusb_try_lock_events(libusb_context *ctx);
libusb_try_lock_events = libusb.libusb_try_lock_events
libusb_try_lock_events.argtypes = [libusb_context_p]
#void libusb_lock_events(libusb_context *ctx);
libusb_lock_events = libusb.libusb_lock_events
libusb_lock_events.argtypes = [libusb_context_p]
#void libusb_unlock_events(libusb_context *ctx);
libusb_unlock_events = libusb.libusb_unlock_events
libusb_unlock_events.argtypes = [libusb_context_p]
libusb_unlock_events.restype = None
#int libusb_event_handling_ok(libusb_context *ctx);
libusb_event_handling_ok = libusb.libusb_event_handling_ok
libusb_event_handling_ok.argtypes = [libusb_context_p]
#int libusb_event_handler_active(libusb_context *ctx);
libusb_event_handler_active = libusb.libusb_event_handler_active
libusb_event_handler_active.argtypes = [libusb_context_p]
#void libusb_lock_event_waiters(libusb_context *ctx);
libusb_lock_event_waiters = libusb.libusb_lock_event_waiters
libusb_lock_event_waiters.argtypes = [libusb_context_p]
libusb_lock_event_waiters.restype = None
#void libusb_unlock_event_waiters(libusb_context *ctx);
libusb_unlock_event_waiters = libusb.libusb_unlock_event_waiters
libusb_unlock_event_waiters.argtypes = []
libusb_unlock_event_waiters.restype = None
#int libusb_wait_for_event(libusb_context *ctx, struct timeval *tv);
libusb_wait_for_event = libusb.libusb_wait_for_event
libusb_wait_for_event.argtypes = [libusb_context_p, timeval_p]
#int libusb_handle_events_timeout(libusb_context *ctx, struct timeval *tv);
libusb_handle_events_timeout = libusb.libusb_handle_events_timeout
libusb_handle_events_timeout.argtypes = [libusb_context_p, timeval_p]
#int libusb_handle_events_timeout_completed(libusb_context *ctx,
# struct timeval *tv, int *completed);
try:
libusb_handle_events_timeout_completed = libusb.\
libusb_handle_events_timeout_completed
except AttributeError:
# No safe replacement possible.
pass
else:
libusb_handle_events_timeout_completed.argtypes = [
libusb_context_p, timeval_p, c_int_p]
#int libusb_handle_events(libusb_context *ctx);
libusb_handle_events = libusb.libusb_handle_events
libusb_handle_events.argtypes = [libusb_context_p]
#int libusb_handle_events_completed(libusb_context *ctx, int *completed);
try:
libusb_handle_events_completed = libusb.libusb_handle_events_completed
except AttributeError:
# No safe replacement possible.
pass
else:
libusb_handle_events_completed.argtypes = [libusb_context_p, c_int_p]
#int libusb_handle_events_locked(libusb_context *ctx, struct timeval *tv);
libusb_handle_events_locked = libusb.libusb_handle_events_locked
libusb_handle_events_locked.argtypes = [libusb_context_p, timeval_p]
#int libusb_get_next_timeout(libusb_context *ctx, struct timeval *tv);
libusb_get_next_timeout = libusb.libusb_get_next_timeout
libusb_get_next_timeout.argtypes = [libusb_context_p, timeval_p]
#const struct libusb_pollfd **libusb_get_pollfds(libusb_context *ctx);
libusb_get_pollfds = libusb.libusb_get_pollfds
libusb_get_pollfds.argtypes = [libusb_context_p]
libusb_get_pollfds.restype = libusb_pollfd_p_p
#void libusb_set_pollfd_notifiers(libusb_context *ctx,
# libusb_pollfd_added_cb added_cb, libusb_pollfd_removed_cb removed_cb,
# void *user_data);
libusb_set_pollfd_notifiers = libusb.libusb_set_pollfd_notifiers
libusb_set_pollfd_notifiers.argtypes = [libusb_context_p,
libusb_pollfd_added_cb_p,
libusb_pollfd_removed_cb_p, py_object]
libusb_set_pollfd_notifiers.restype = None
try:
#void libusb_get_pollfds(const struct libusb_pollfd **);
libusb_free_pollfds = libusb.libusb_free_pollfds
libusb_free_pollfds.argtypes = [libusb_pollfd_p_p]
libusb_free_pollfds.restype = None
except AttributeError:
# Not a safe replacement in general, but the versions of libusb that lack
# libusb_free_pollfds() only provide that function on *nix, where
# Python's free() and libusb's free() are ~always the same anyways.
libusb_free_pollfds = CDLL(None).free
#int libusb_hotplug_register_callback(libusb_context *ctx,
# libusb_hotplug_event events, libusb_hotplug_flag flags,
# int vendor_id, int product_id, int dev_class,
# libusb_hotplug_callback_fn cb_fn, void *user_data,
# libusb_hotplug_callback_handle *handle);
try:
libusb_hotplug_register_callback = libusb.libusb_hotplug_register_callback
except AttributeError:
pass
else:
libusb_hotplug_register_callback.argtypes = [
libusb_context_p,
c_int, c_int,
c_int, c_int, c_int,
libusb_hotplug_callback_fn_p, c_void_p,
POINTER(libusb_hotplug_callback_handle),
]
libusb_hotplug_register_callback.restype = c_int
#void libusb_hotplug_deregister_callback(libusb_context *ctx,
# libusb_hotplug_callback_handle handle);
try:
libusb_hotplug_deregister_callback = \
libusb.libusb_hotplug_deregister_callback
except AttributeError:
pass
else:
libusb_hotplug_deregister_callback.argtypes = [
libusb_context_p,
libusb_hotplug_callback_handle,
]
libusb_hotplug_deregister_callback.restype = None
globals().update(locals())
# libusb.h
def bswap16(x):
return ((x & 0xff) << 8) | (x >> 8)
if LITTLE_ENDIAN:
def libusb_cpu_to_le16(x):
return x
def libusb_le16_to_cpu(x):
return x
else:
libusb_cpu_to_le16 = bswap16
libusb_le16_to_cpu = bswap16
# standard USB stuff
# Device and/or Interface Class codes
libusb_class_code = Enum({
# In the context of a device descriptor,
# this bDeviceClass value indicates that each interface specifies its
# own class information and all interfaces operate independently.
'LIBUSB_CLASS_PER_INTERFACE': 0,
# Audio class
'LIBUSB_CLASS_AUDIO': 1,
# Communications class
'LIBUSB_CLASS_COMM': 2,
# Human Interface Device class
'LIBUSB_CLASS_HID': 3,
# Physical
'LIBUSB_CLASS_PHYSICAL': 5,
# Printer class
'LIBUSB_CLASS_PRINTER': 7,
# Picture transfer protocol class
'LIBUSB_CLASS_PTP': 6,
# Mass storage class
'LIBUSB_CLASS_MASS_STORAGE': 8,
# Hub class
'LIBUSB_CLASS_HUB': 9,
# Data class
'LIBUSB_CLASS_DATA': 10,
# Smart Card
'LIBUSB_CLASS_SMART_CARD': 0x0b,
# Content Security
'LIBUSB_CLASS_CONTENT_SECURITY': 0x0d,
# Video
'LIBUSB_CLASS_VIDEO': 0x0e,
# Personal Healthcare
'LIBUSB_CLASS_PERSONAL_HEALTHCARE': 0x0f,
# Diagnostic Device
'LIBUSB_CLASS_DIAGNOSTIC_DEVICE': 0xdc,
# Wireless class
'LIBUSB_CLASS_WIRELESS': 0xe0,
# Application class
'LIBUSB_CLASS_APPLICATION': 0xfe,
# Class is vendor-specific
'LIBUSB_CLASS_VENDOR_SPEC': 0xff
})
# pylint: disable=undefined-variable
LIBUSB_CLASS_IMAGE = LIBUSB_CLASS_PTP
# pylint: enable=undefined-variable
# Descriptor types as defined by the USB specification.
libusb_descriptor_type = Enum({
# Device descriptor. See libusb_device_descriptor.
'LIBUSB_DT_DEVICE': 0x01,
# Configuration descriptor. See libusb_config_descriptor.
'LIBUSB_DT_CONFIG': 0x02,
# String descriptor
'LIBUSB_DT_STRING': 0x03,
# Interface descriptor. See libusb_interface_descriptor.
'LIBUSB_DT_INTERFACE': 0x04,
# Endpoint descriptor. See libusb_endpoint_descriptor.
'LIBUSB_DT_ENDPOINT': 0x05,
# HID descriptor
'LIBUSB_DT_HID': 0x21,
# HID report descriptor
'LIBUSB_DT_REPORT': 0x22,
# Physical descriptor
'LIBUSB_DT_PHYSICAL': 0x23,
# Hub descriptor
'LIBUSB_DT_HUB': 0x29,
})
# Descriptor sizes per descriptor type
LIBUSB_DT_DEVICE_SIZE = 18
LIBUSB_DT_CONFIG_SIZE = 9
LIBUSB_DT_INTERFACE_SIZE = 9
LIBUSB_DT_ENDPOINT_SIZE = 7
LIBUSB_DT_ENDPOINT_AUDIO_SIZE = 9 # Audio extension
LIBUSB_DT_HUB_NONVAR_SIZE = 7
LIBUSB_ENDPOINT_ADDRESS_MASK = 0x0f # in bEndpointAddress
LIBUSB_ENDPOINT_DIR_MASK = 0x80
# BBB
USB_ENDPOINT_ADDRESS_MASK = LIBUSB_ENDPOINT_ADDRESS_MASK
USB_ENDPOINT_DIR_MASK = LIBUSB_ENDPOINT_DIR_MASK
# Endpoint direction. Values for bit 7 of the endpoint address scheme.
libusb_endpoint_direction = Enum({
# In: device-to-host
'LIBUSB_ENDPOINT_IN': 0x80,
# Out: host-to-device
'LIBUSB_ENDPOINT_OUT': 0x00
})
LIBUSB_TRANSFER_TYPE_MASK = 0x03 # in bmAttributes
# Endpoint transfer type. Values for bits 0:1 of the endpoint attributes field.
libusb_transfer_type = Enum({
# Control endpoint
'LIBUSB_TRANSFER_TYPE_CONTROL': 0,
# Isochronous endpoint
'LIBUSB_TRANSFER_TYPE_ISOCHRONOUS': 1,
# Bulk endpoint
'LIBUSB_TRANSFER_TYPE_BULK': 2,
# Interrupt endpoint
'LIBUSB_TRANSFER_TYPE_INTERRUPT': 3,
})
# Standard requests, as defined in table 9-3 of the USB2 specifications
libusb_standard_request = Enum({
# Request status of the specific recipient
'LIBUSB_REQUEST_GET_STATUS': 0x00,
# Clear or disable a specific feature
'LIBUSB_REQUEST_CLEAR_FEATURE': 0x01,
# 0x02 is reserved
# Set or enable a specific feature
'LIBUSB_REQUEST_SET_FEATURE': 0x03,
# 0x04 is reserved
# Set device address for all future accesses
'LIBUSB_REQUEST_SET_ADDRESS': 0x05,
# Get the specified descriptor
'LIBUSB_REQUEST_GET_DESCRIPTOR': 0x06,
# Used to update existing descriptors or add new descriptors
'LIBUSB_REQUEST_SET_DESCRIPTOR': 0x07,
# Get the current device configuration value
'LIBUSB_REQUEST_GET_CONFIGURATION': 0x08,
# Set device configuration
'LIBUSB_REQUEST_SET_CONFIGURATION': 0x09,
# Return the selected alternate setting for the specified interface
'LIBUSB_REQUEST_GET_INTERFACE': 0x0a,
# Select an alternate interface for the specified interface
'LIBUSB_REQUEST_SET_INTERFACE': 0x0b,
# Set then report an endpoint's synchronization frame
'LIBUSB_REQUEST_SYNCH_FRAME': 0x0c,
})
# Request type bits of the bmRequestType field in control transfers.
libusb_request_type = Enum({
# Standard
'LIBUSB_REQUEST_TYPE_STANDARD': (0x00 << 5),
# Class
'LIBUSB_REQUEST_TYPE_CLASS': (0x01 << 5),
# Vendor
'LIBUSB_REQUEST_TYPE_VENDOR': (0x02 << 5),
# Reserved
'LIBUSB_REQUEST_TYPE_RESERVED': (0x03 << 5),
})
# BBB
# pylint: disable=undefined-variable
LIBUSB_TYPE_STANDARD = LIBUSB_REQUEST_TYPE_STANDARD
LIBUSB_TYPE_CLASS = LIBUSB_REQUEST_TYPE_CLASS
LIBUSB_TYPE_VENDOR = LIBUSB_REQUEST_TYPE_VENDOR
LIBUSB_TYPE_RESERVED = LIBUSB_REQUEST_TYPE_RESERVED
# pylint: enable=undefined-variable
# Recipient bits of the bmRequestType field in control transfers. Values 4
# through 31 are reserved.
libusb_request_recipient = Enum({
# Device
'LIBUSB_RECIPIENT_DEVICE': 0x00,
# Interface
'LIBUSB_RECIPIENT_INTERFACE': 0x01,
# Endpoint
'LIBUSB_RECIPIENT_ENDPOINT': 0x02,
# Other
'LIBUSB_RECIPIENT_OTHER': 0x03,
})
LIBUSB_ISO_SYNC_TYPE_MASK = 0x0c
# Synchronization type for isochronous endpoints. Values for bits 2:3 of the
# bmAttributes field in libusb_endpoint_descriptor.
libusb_iso_sync_type = Enum({
# No synchronization
'LIBUSB_ISO_SYNC_TYPE_NONE': 0,
# Asynchronous
'LIBUSB_ISO_SYNC_TYPE_ASYNC': 1,
# Adaptive
'LIBUSB_ISO_SYNC_TYPE_ADAPTIVE': 2,
# Synchronous
'LIBUSB_ISO_SYNC_TYPE_SYNC': 3,
})
LIBUSB_ISO_USAGE_TYPE_MASK = 0x30
# Usage type for isochronous endpoints. Values for bits 4:5 of the
# bmAttributes field in libusb_endpoint_descriptor.
libusb_iso_usage_type = Enum({
# Data endpoint
'LIBUSB_ISO_USAGE_TYPE_DATA': 0,
# Feedback endpoint
'LIBUSB_ISO_USAGE_TYPE_FEEDBACK': 1,
# Implicit feedback Data endpoint
'LIBUSB_ISO_USAGE_TYPE_IMPLICIT': 2,
})
# A structure representing the standard USB device descriptor. This
# descriptor is documented in section 9.6.1 of the USB 2.0 specification.
# All multiple-byte fields are represented in host-endian format.
class libusb_device_descriptor(Structure):
_fields_ = [
# Size of this descriptor (in bytes)
('bLength', c_uint8),
# Descriptor type. Will have value LIBUSB_DT_DEVICE in this
# context.
('bDescriptorType', c_uint8),
# USB specification release number in binary-coded decimal. A
# value of 0x0200 indicates USB 2.0, 0x0110 indicates USB 1.1,
# etc.
('bcdUSB', c_uint16),
# USB-IF class code for the device. See libusb_class_code.
('bDeviceClass', c_uint8),
# USB-IF subclass code for the device, qualified by the
# bDeviceClass value
('bDeviceSubClass', c_uint8),
# USB-IF protocol code for the device, qualified by the
# bDeviceClass and bDeviceSubClass values
('bDeviceProtocol', c_uint8),
# Maximum packet size for endpoint 0
('bMaxPacketSize0', c_uint8),
# USB-IF vendor ID
('idVendor', c_uint16),
# USB-IF product ID
('idProduct', c_uint16),
# Device release number in binary-coded decimal
('bcdDevice', c_uint16),
# Index of string descriptor describing manufacturer
('iManufacturer', c_uint8),
# Index of string descriptor describing product
('iProduct', c_uint8),
# Index of string descriptor containing device serial number
('iSerialNumber', c_uint8),
# Number of possible configurations
('bNumConfigurations', c_uint8)]
libusb_device_descriptor_p = POINTER(libusb_device_descriptor)
class libusb_endpoint_descriptor(Structure):
_fields_ = [
('bLength', c_uint8),
('bDescriptorType', c_uint8),
('bEndpointAddress', c_uint8),
('bmAttributes', c_uint8),
('wMaxPacketSize', c_uint16),
('bInterval', c_uint8),
('bRefresh', c_uint8),
('bSynchAddress', c_uint8),
('extra', c_void_p),
('extra_length', c_int)]
libusb_endpoint_descriptor_p = POINTER(libusb_endpoint_descriptor)
class libusb_interface_descriptor(Structure):
_fields_ = [
('bLength', c_uint8),
('bDescriptorType', c_uint8),
('bInterfaceNumber', c_uint8),
('bAlternateSetting', c_uint8),
('bNumEndpoints', c_uint8),
('bInterfaceClass', c_uint8),
('bInterfaceSubClass', c_uint8),
('bInterfaceProtocol', c_uint8),
('iInterface', c_uint8),
('endpoint', libusb_endpoint_descriptor_p),
('extra', c_void_p),
('extra_length', c_int)]
libusb_interface_descriptor_p = POINTER(libusb_interface_descriptor)
class libusb_interface(Structure):
_fields_ = [('altsetting', libusb_interface_descriptor_p),
('num_altsetting', c_int)]
libusb_interface_p = POINTER(libusb_interface)
class libusb_config_descriptor(Structure):
_fields_ = [
('bLength', c_uint8),
('bDescriptorType', c_uint8),
('wTotalLength', c_uint16),
('bNumInterfaces', c_uint8),
('bConfigurationValue', c_uint8),
('iConfiguration', c_uint8),
('bmAttributes', c_uint8),
('MaxPower', c_uint8),
('interface', libusb_interface_p),
('extra', c_void_p),
('extra_length', c_int)]
libusb_config_descriptor_p = POINTER(libusb_config_descriptor)
libusb_config_descriptor_p_p = POINTER(libusb_config_descriptor_p)
class libusb_control_setup(Structure):
_fields_ = [
('bmRequestType', c_uint8),
('bRequest', c_uint8),
('wValue', c_uint16),
('wIndex', c_uint16),
('wLength', c_uint16)]
libusb_control_setup_p = POINTER(libusb_control_setup)
LIBUSB_CONTROL_SETUP_SIZE = sizeof(libusb_control_setup)
# Structure representing a libusb session. The concept of individual libusb
# sessions allows for your program to use two libraries (or dynamically
# load two modules) which both independently use libusb. This will prevent
# interference between the individual libusb users - for example
# libusb_set_debug() will not affect the other user of the library, and
# libusb_exit() will not destroy resources that the other user is still
# using.
#
# Sessions are created by libusb_init() and destroyed through libusb_exit().
# If your application is guaranteed to only ever include a single libusb
# user (i.e. you), you do not have to worry about contexts: pass NULL in
# every function call where a context is required. The default context
# will be used.
#
# For more information, see \ref contexts.
#class libusb_context(Structure):
# pass
#libusb_context_p = POINTER(libusb_context)
libusb_context_p = c_void_p # Any pointer is fine
libusb_context_p_p = POINTER(libusb_context_p)
# Structure representing a USB device detected on the system. This is an
# opaque type for which you are only ever provided with a pointer, usually
# originating from libusb_get_device_list().
#
# Certain operations can be performed on a device, but in order to do any
# I/O you will have to first obtain a device handle using libusb_open().
#
# Devices are reference counted with libusb_device_ref() and
# libusb_device_unref(), and are freed when the reference count reaches 0.
# New devices presented by libusb_get_device_list() have a reference count of
# 1, and libusb_free_device_list() can optionally decrease the reference count
# on all devices in the list. libusb_open() adds another reference which is
# later destroyed by libusb_close().
#class libusb_device(Structure):
# pass
#libusb_device_p = POINTER(libusb_device)
libusb_device_p = c_void_p # Any pointer is fine
libusb_device_p_p = POINTER(libusb_device_p)
libusb_device_p_p_p = POINTER(libusb_device_p_p)
# Structure representing a handle on a USB device. This is an opaque type for
# which you are only ever provided with a pointer, usually originating from
# libusb_open().
#
# A device handle is used to perform I/O and other operations. When finished
# with a device handle, you should call libusb_close().
class libusb_device_handle(Structure):
pass
libusb_device_handle_p = POINTER(libusb_device_handle)
libusb_device_handle_p_p = POINTER(libusb_device_handle_p)
class libusb_version(Structure):
_fields_ = [
('major', c_uint16),
('minor', c_uint16),
('micro', c_uint16),
('nano', c_uint16),
('rc', c_char_p),
('describe', c_char_p),
]
libusb_speed = Enum({
# The OS doesn't report or know the device speed.
'LIBUSB_SPEED_UNKNOWN': 0,
# The device is operating at low speed (1.5MBit/s).
'LIBUSB_SPEED_LOW': 1,
# The device is operating at full speed (12MBit/s).
'LIBUSB_SPEED_FULL': 2,
# The device is operating at high speed (480MBit/s).
'LIBUSB_SPEED_HIGH': 3,
# The device is operating at super speed (5000MBit/s).
'LIBUSB_SPEED_SUPER': 4,
# The device is operating at super speed plus (10000MBit/s)
'LIBUSB_SPEED_SUPER_PLUS': 5,
})
libusb_supported_speed = Enum({
# Low speed operation supported (1.5MBit/s).
'LIBUSB_LOW_SPEED_OPERATION': 1,
# Full speed operation supported (12MBit/s).
'LIBUSB_FULL_SPEED_OPERATION': 2,
# High speed operation supported (480MBit/s).
'LIBUSB_HIGH_SPEED_OPERATION': 4,
# Superspeed operation supported (5000MBit/s).
'LIBUSB_5GBPS_OPERATION': 8,
})
# Error codes. Most libusb functions return 0 on success or one of these
# codes on failure.
libusb_error = Enum({
# Success (no error)
'LIBUSB_SUCCESS': 0,
# Input/output error
'LIBUSB_ERROR_IO': -1,
# Invalid parameter
'LIBUSB_ERROR_INVALID_PARAM': -2,
# Access denied (insufficient permissions)
'LIBUSB_ERROR_ACCESS': -3,
# No such device (it may have been disconnected)
'LIBUSB_ERROR_NO_DEVICE': -4,
# Entity not found
'LIBUSB_ERROR_NOT_FOUND': -5,
# Resource busy
'LIBUSB_ERROR_BUSY': -6,
# Operation timed out
'LIBUSB_ERROR_TIMEOUT': -7,
# Overflow
'LIBUSB_ERROR_OVERFLOW': -8,
# Pipe error
'LIBUSB_ERROR_PIPE': -9,
# System call interrupted (perhaps due to signal)
'LIBUSB_ERROR_INTERRUPTED': -10,
# Insufficient memory
'LIBUSB_ERROR_NO_MEM': -11,
# Operation not supported or unimplemented on this platform
'LIBUSB_ERROR_NOT_SUPPORTED': -12,
# Other error
'LIBUSB_ERROR_OTHER': -99,
})
# Transfer status codes
libusb_transfer_status = Enum({
# Transfer completed without error. Note that this does not indicate
# that the entire amount of requested data was transferred.
'LIBUSB_TRANSFER_COMPLETED': 0,
# Transfer failed
'LIBUSB_TRANSFER_ERROR': 1,
# Transfer timed out
'LIBUSB_TRANSFER_TIMED_OUT': 2,
# Transfer was cancelled
'LIBUSB_TRANSFER_CANCELLED': 3,
# For bulk/interrupt endpoints: halt condition detected (endpoint
# stalled). For control endpoints: control request not supported.
'LIBUSB_TRANSFER_STALL': 4,
# Device was disconnected
'LIBUSB_TRANSFER_NO_DEVICE': 5,
# Device sent more data than requested
'LIBUSB_TRANSFER_OVERFLOW': 6,
})
# libusb_transfer.flags values
libusb_transfer_flags = Enum({
# Report short frames as errors
'LIBUSB_TRANSFER_SHORT_NOT_OK': 1 << 0,
# Automatically free() transfer buffer during libusb_free_transfer()
'LIBUSB_TRANSFER_FREE_BUFFER': 1 << 1,
# Automatically call libusb_free_transfer() after callback returns.
# If this flag is set, it is illegal to call libusb_free_transfer()
# from your transfer callback, as this will result in a double-free
# when this flag is acted upon.
'LIBUSB_TRANSFER_FREE_TRANSFER': 1 << 2,
# Terminate transfers that are a multiple of the endpoint's
# wMaxPacketSize with an extra zero length packet.
'LIBUSB_TRANSFER_ADD_ZERO_PACKET': 1 << 3,
})
# Isochronous packet descriptor.
class libusb_iso_packet_descriptor(Structure):
_fields_ = [('length', c_uint),
('actual_length', c_uint),
('status', c_int)] # enum libusb_transfer_status
libusb_iso_packet_descriptor_p = POINTER(libusb_iso_packet_descriptor)
class libusb_transfer(Structure):
pass
libusb_transfer_p = POINTER(libusb_transfer)
libusb_transfer_cb_fn_p = CFUNCTYPE(None, libusb_transfer_p)
libusb_capability = Enum({
# The libusb_has_capability() API is available.
'LIBUSB_CAP_HAS_CAPABILITY': 0x0000,
# Hotplug support is available.
'LIBUSB_CAP_HAS_HOTPLUG': 0x0001,
# The library can access HID devices without requiring user intervention.
'LIBUSB_CAP_HAS_HID_ACCESS': 0x0100,
# The library supports detaching of the default USB driver.
'LIBUSB_CAP_SUPPORTS_DETACH_KERNEL_DRIVER': 0x0101,
})
libusb_log_level = Enum({
'LIBUSB_LOG_LEVEL_NONE': 0,
'LIBUSB_LOG_LEVEL_ERROR': 1,
'LIBUSB_LOG_LEVEL_WARNING': 2,
'LIBUSB_LOG_LEVEL_INFO': 3,
'LIBUSB_LOG_LEVEL_DEBUG': 4,
})
# Note on libusb_strerror, libusb_setlocale and future functions in the
# same spirit:
# I do not think end-user-facing messages belong to a technical library.
# Such features bring a new, non essential set of problems, and is a luxury
# I do not want to spend time supporting considering limited resources and
# more important stuff to work on.
# For backward compatibility, expose libusb_strerror placeholder.
# pylint: disable=unused-argument
def libusb_strerror(errcode):
return None
# pylint: enable=unused-argument
# Get the data section of a control transfer. This convenience function is here
# to remind you that the data does not start until 8 bytes into the actual
# buffer, as the setup packet comes first.
#
# Calling this function only makes sense from a transfer callback function,
# or situations where you have already allocated a suitably sized buffer at
# transfer->buffer.
#
# \param transfer a transfer
# \returns pointer to the first byte of the data section
def libusb_control_transfer_get_data(transfer_p):
transfer = transfer_p.contents
return buffer_at(transfer.buffer, transfer.length)[
LIBUSB_CONTROL_SETUP_SIZE:]
def libusb_control_transfer_get_setup(transfer_p):
return cast(transfer_p.contents.buffer, libusb_control_setup_p)
def libusb_fill_control_setup(
setup_p, bmRequestType, bRequest, wValue, wIndex, wLength):
setup = cast(setup_p, libusb_control_setup_p).contents
setup.bmRequestType = bmRequestType
setup.bRequest = bRequest
setup.wValue = libusb_cpu_to_le16(wValue)
setup.wIndex = libusb_cpu_to_le16(wIndex)
setup.wLength = libusb_cpu_to_le16(wLength)
# pylint: disable=redefined-builtin
def libusb_fill_control_transfer(
transfer_p, dev_handle, buffer, callback, user_data, timeout):
transfer = transfer_p.contents
transfer.dev_handle = dev_handle
transfer.endpoint = 0
# pylint: disable=undefined-variable
transfer.type = LIBUSB_TRANSFER_TYPE_CONTROL
# pylint: enable=undefined-variable
transfer.timeout = timeout
transfer.buffer = cast(buffer, c_void_p)
if buffer is not None:
setup = cast(buffer, libusb_control_setup_p).contents
# pylint: disable=undefined-variable
transfer.length = LIBUSB_CONTROL_SETUP_SIZE + \
libusb_le16_to_cpu(setup.wLength)
# pylint: enable=undefined-variable
transfer.user_data = user_data
transfer.callback = callback
# pylint: enable=redefined-builtin
# pylint: disable=redefined-builtin
def libusb_fill_bulk_transfer(
transfer_p, dev_handle, endpoint, buffer, length,
callback, user_data, timeout):
transfer = transfer_p.contents
transfer.dev_handle = dev_handle
transfer.endpoint = endpoint
# pylint: disable=undefined-variable
transfer.type = LIBUSB_TRANSFER_TYPE_BULK
# pylint: enable=undefined-variable
transfer.timeout = timeout
transfer.buffer = cast(buffer, c_void_p)
transfer.length = length
transfer.user_data = user_data
transfer.callback = callback
# pylint: enable=redefined-builtin
# pylint: disable=redefined-builtin
def libusb_fill_interrupt_transfer(
transfer_p, dev_handle, endpoint, buffer,
length, callback, user_data, timeout):
transfer = transfer_p.contents
transfer.dev_handle = dev_handle
transfer.endpoint = endpoint
# pylint: disable=undefined-variable
transfer.type = LIBUSB_TRANSFER_TYPE_INTERRUPT
# pylint: enable=undefined-variable
transfer.timeout = timeout
transfer.buffer = cast(buffer, c_void_p)
transfer.length = length
transfer.user_data = user_data
transfer.callback = callback
# pylint: enable=redefined-builtin
# pylint: disable=redefined-builtin
def libusb_fill_iso_transfer(
transfer_p, dev_handle, endpoint, buffer, length,
num_iso_packets, callback, user_data, timeout):
transfer = transfer_p.contents
transfer.dev_handle = dev_handle
transfer.endpoint = endpoint
# pylint: disable=undefined-variable
transfer.type = LIBUSB_TRANSFER_TYPE_ISOCHRONOUS
# pylint: enable=undefined-variable
transfer.timeout = timeout
transfer.buffer = cast(buffer, c_void_p)
transfer.length = length
transfer.num_iso_packets = num_iso_packets
transfer.user_data = user_data
transfer.callback = callback
# pylint: enable=redefined-builtin
def _get_iso_packet_list(transfer):
list_type = libusb_iso_packet_descriptor * transfer.num_iso_packets
return list_type.from_address(addressof(transfer.iso_packet_desc))
def get_iso_packet_list(transfer_p):
"""
Python-specific helper extracting a list of iso packet descriptors,
because it's not as straight-forward as in C.
"""
return _get_iso_packet_list(transfer_p.contents)
def _get_iso_packet_buffer(transfer, offset, length):
return buffer_at(transfer.buffer + offset, length)
def get_iso_packet_buffer_list(transfer_p):
"""
Python-specific helper extracting a list of iso packet buffers.
"""
transfer = transfer_p.contents
offset = 0
result = []
append = result.append
for iso_transfer in _get_iso_packet_list(transfer):
length = iso_transfer.length
append(_get_iso_packet_buffer(transfer, offset, length))
offset += length
return result
def get_extra(descriptor):
"""
Python-specific helper to access "extra" field of descriptors,
because it's not as straight-forward as in C.
Returns a list, where each entry is an individual extra descriptor.
"""
result = []
extra_length = descriptor.extra_length
if extra_length:
extra = buffer_at(descriptor.extra, extra_length)
append = result.append
while extra:
length = extra[0]
if not 0 < length <= len(extra):
raise ValueError(
'Extra descriptor %i is incomplete/invalid' % (
len(result),
),
)
append(extra[:length])
extra = extra[length:]
return result
def libusb_set_iso_packet_lengths(transfer_p, length):
transfer = transfer_p.contents
for iso_packet_desc in _get_iso_packet_list(transfer):
iso_packet_desc.length = length
def libusb_get_iso_packet_buffer(transfer_p, packet):
transfer = transfer_p.contents
offset = 0
if packet >= transfer.num_iso_packets:
return None
iso_packet_desc_list = _get_iso_packet_list(transfer)
for i in range(packet):
offset += iso_packet_desc_list[i].length
return _get_iso_packet_buffer(
transfer, offset, iso_packet_desc_list[packet].length)
def libusb_get_iso_packet_buffer_simple(transfer_p, packet):
transfer = transfer_p.contents
if packet >= transfer.num_iso_packets:
return None
iso_length = transfer.iso_packet_desc.length
return _get_iso_packet_buffer(transfer, iso_length * packet, iso_length)
# sync I/O
# pylint: disable=undefined-variable
def libusb_get_descriptor(dev, desc_type, desc_index, data, length):
return libusb_control_transfer(dev, LIBUSB_ENDPOINT_IN,
LIBUSB_REQUEST_GET_DESCRIPTOR,
(desc_type << 8) | desc_index, 0, data,
length, 1000)
# pylint: enable=undefined-variable
# pylint: disable=undefined-variable
def libusb_get_string_descriptor(dev, desc_index, langid, data, length):
return libusb_control_transfer(dev, LIBUSB_ENDPOINT_IN,
LIBUSB_REQUEST_GET_DESCRIPTOR,
(LIBUSB_DT_STRING << 8) | desc_index,
langid, data, length, 1000)
# pylint: enable=undefined-variable
# polling and timeouts
class libusb_pollfd(Structure):
_fields_ = [
('fd', c_int),
('events', c_short),
]
libusb_pollfd_p = POINTER(libusb_pollfd)
libusb_pollfd_p_p = POINTER(libusb_pollfd_p)
libusb_pollfd_added_cb_p = CFUNCTYPE(None, c_int, c_short, py_object)
libusb_pollfd_removed_cb_p = CFUNCTYPE(None, c_int, py_object)
#typedef int libusb_hotplug_callback_handle;
libusb_hotplug_callback_handle = c_int
libusb_hotplug_flag = Enum({
'LIBUSB_HOTPLUG_ENUMERATE': 1,
})
libusb_hotplug_event = Enum({
'LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED': 0x01,
'LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT': 0x02,
})
LIBUSB_HOTPLUG_MATCH_ANY = -1
#typedef int (*libusb_hotplug_callback_fn)(libusb_context *ctx,
# libusb_device *device, libusb_hotplug_event event, void *user_data);
libusb_hotplug_callback_fn_p = CFUNCTYPE(
c_int, libusb_context_p, libusb_device_p, c_int, c_void_p)
# /libusb.h