1For detailed information about the changes below, please see the git log or 2visit: http://log.libusb.info 3 42022-04-10: v1.0.26 5* Fix regression with transfer free's after closing device 6* Fix regression with destroyed context if API is misused 7* Workaround for applications using missing default context 8* Fix hotplog enumeration regression 9* Fix Windows isochronous transfer regression since 1.0.24 10* Fix macOS exit crash in some multi-context cases 11* Build fixes for various platforms and configurations 12* Fix Windows HID multi-interface product string retrieval 13* Update isochronous OUT packet actual lengths on Windows 14* Add interface bound checking for broken devices 15* Add umockdev tests on Linux 16 172022-01-31: v1.0.25 18* Linux: Fix regression with some particular devices 19* Linux: Fix regression with libusb_handle_events_timeout_completed() 20* Linux: Fix regression with cpu usage in libusb_bulk_transfer 21* Darwin (macOS): Add support for detaching kernel drivers with authorization. 22* Darwin (macOS): Do not drop partial data on timeout. 23* Darwin (macOS): Silence pipe error in set_interface_alt_setting(). 24* Windows: Fix HID backend missing byte 25* Windows: Fix segfault with libusbk driver 26* Windows: Fix regression when using libusb0 driver 27* Windows: Support LIBUSB_TRANSFER_ADD_ZERO_PACKET on winusb 28* New NO_DEVICE_DISCOVERY option replaces WEAK_AUTHORITY option 29* Various other bug fixes and improvements 30 312020-12-09: v1.0.24 32* Add new platform abstraction (#252) 33* Add Null POSIX backend 34* Add support for eventfd 35* Add support for thread IDs on Haiku, NetBSD and Solaris 36* New API libusb_hotplug_get_user_data() 37* Darwin (macOS): Fix race condition that results in segmentation fault (#701) 38* Darwin (macOS): Fix stale descriptor information post reset (#733) 39* Darwin (macOS): use IOUSBDevice as darwin_device_class explicitly (#693) 40* Linux: Drop support for kernel older than 2.6.32 41* Linux: Provide an event thread name (#689) 42* Linux: Wait until all URBs have been reaped before freeing them (#607) 43* NetBSD: Recognize device timeouts (#710) 44* OpenBSD: Allow opening ugen devices multiple times (#763) 45* OpenBSD: Support libusb_get_port_number() (#764) 46* SunOS: Fix a memory leak (#756) 47* SunOS: Various fixes (#627, #628, #629) 48* Windows: Add Visual Studio 2019 support 49* Windows: Drop support for WinCE and Visual Studio older than 2013 50* Windows: Drop support for Windows XP 51* Windows: Support building all examples using Visual Studio (#151) 52* Documentation fixes and improvements 53* Various other bug fixes and improvements 54 552019-08-28: v1.0.23 56* Add German translation (#446) 57* Add Hungarian translation (#493) 58* Android: Improved support for Android 59* BSD: Remove infinite recursion in OpenBSD backend 60* configure.ac: Fix detection of clock_gettime library (#439) 61* Core: abandon synchronous transfers when device closure is detected. 62* Core: fix error in handling the removal of file descriptors while handling 63 events. 64* Darwin(macOS): Switch from using ResetDevice to USBDeviceReEnumerate (#455) 65* Darwin(macOS): Remove code that changed the device class used (#428) 66* Darwin(macOS): Reduce hotplug timeout to 1ms (from 5s) 67* New API libusb_set_log_cb() to redirect global and per context log 68 messages to the provided log handling function 69* New API libusb_wrap_sys_device to allow the user to specify the 70 usb device to use. 71* Solaris: Break infinite recursion in backend clock_gettime 72* Solaris: Enable timerfd on sunos when available 73* Windows: Add support for isochronous transfers with WinUSB 74* Various other bug fixes and improvements 75 762018-03-24: v1.0.22 77* New libusb_set_option() API 78* Fix transfer timeout not being cleared upon resubmission 79* Report super speed plus devices on modern Linux and macOS 80* Darwin: Improve support for macOS Sierra and High Sierra 81* Darwin: SDK fixes and improvements 82* Linux: Let initialization succeed when no devices are present 83* Linux: Mark internal file descriptors with CLOEXEC flag 84* Solaris: Add support for attach/detach kernel driver 85* Windows: Add dynamic UsbDk backend selection 86* Windows: Add isochronous transfer support via libusbK 87* Windows: Add Visual Studio 2017 support 88* Windows: Fix enumeration problems on Windows 8 and later 89* Windows: Major rework of poll() emulation 90* Windows: Numerous HID API fixes 91* Windows: Support cancellation of individual transfers (Vista and later) 92* Various other bug fixes and improvements 93 942016-10-01: v1.0.21 95* Core: Refactor code related to transfer flags and timeout handling 96* Darwin: Ignore root hub simulation devices 97* Darwin: Improved support for OS X El Capitan 98* Darwin: Work around devices with buggy endpoint descriptors 99* Darwin: Do not use objc_registerThreadWithCollector after its deprecation 100* Darwin: Use C11 atomics on 10.12+ as the OS atomics are now deprecated 101* Linux: Support preallocating kernel memory for zerocopy USB 102* Linux: Deal with receiving POLLERR before all transfers have completed 103* Solaris: Add solaris backend 104* Windows: Add Visual Studio 2015 support 105* Windows: Add usbdk backend 106* Prevent attempts to recursively handle events 107* Fix race condition in handle_timeout() 108* Allow transferred argument to be optional in bulk APIs 109* Various other bug fixes and improvements 110 1112015-09-13: v1.0.20 112* Add Haiku support 113* Fix multiple memory and resource leaks (#16, #52, #76, #81) 114* Fix possible deadlock when executing transfer callback 115* New libusb_free_pollfds() API 116* Darwin: Fix devices not being detected on OS X 10.8 (#48) 117* Linux: Allow larger isochronous transfer submission (#23) 118* Windows: Fix broken builds Cygwin/MinGW builds and compiler warnings 119* Windows: Fix broken bus number lookup 120* Windows: Improve submission of control requests for composite devices 121* Examples: Add two-stage load support to fxload (#12) 122* Correctly report cancellations due to timeouts 123* Improve efficiency of event handling 124* Improve speed of transfer submission in multi-threaded environments 125* Various other bug fixes and improvements 126The (#xx) numbers are libusb issue numbers, see ie: 127https://github.com/libusb/libusb/issues/16 128 1292014-05-30: v1.0.19 130* Add support for USB bulk streams on Linux and Mac OS X (#11) 131* Windows: Add AMD and Intel USB-3.0 root hub support 132* Windows: Fix USB 3.0 speed detection on Windows 8 or later (#10) 133* Added Russian translation for libusb_strerror strings 134* All: Various small fixes and cleanups 135 1362014-01-25: v1.0.18 137* Fix multiple memory leaks 138* Fix a crash when HID transfers return no data on Windows 139* Ensure all pending events are consumed 140* Improve Android and ucLinux support 141* Multiple Windows improvements (error logging, VS2013, VIA xHCI support) 142* Multiple OS X improvements (broken compilation, SIGFPE, 64bit support) 143 1442013-09-06: v1.0.17 145* Hotplug callbacks now always get passed a libusb_context, even if it is 146 the default context. Previously NULL would be passed for the default context, 147 but since the first context created is the default context, and most apps 148 use only 1 context, this meant that apps explicitly creating a context would 149 still get passed NULL 150* Android: Add .mk files to build with the Android NDK 151* Darwin: Add Xcode project 152* Darwin: Fix crash on unplug (#121) 153* Linux: Fix hang (deadlock) on libusb_exit 154* Linux: Fix libusb build failure with --disable-udev (#124) 155* Linux: Fix libusb_get_device_list() hang with --disable-udev (#130) 156* OpenBSD: Update OpenBSD backend with support for control transfers to 157 non-ugen(4) devices and make get_configuration() no longer generate I/O. 158 Note that using this libusb version on OpenBSD requires using 159 OpenBSD 5.3-current or later. Users of older OpenBSD versions are advised 160 to stay with the libusb shipped with OpenBSD (mpi) 161* Windows: fix libusb_dll_2010.vcxproj link errors (#129) 162* Various other bug fixes and improvements 163 1642013-07-11: v1.0.16 165* Add hotplug support for Darwin and Linux (#9) 166* Add superspeed endpoint companion descriptor support (#15) 167* Add BOS descriptor support (#15) 168* Make descriptor parsing code more robust 169* New libusb_get_port_numbers API, this is libusb_get_port_path without 170 the unnecessary context parameter, libusb_get_port_path is now deprecated 171* New libusb_strerror API (#14) 172* New libusb_set_auto_detach_kernel_driver API (#17) 173* Improve topology API docs (#95) 174* Logging now use a single write call per log-message, avoiding log-message 175 "interlacing" when using multiple threads. 176* Android: use Android logging when building on Android (#101) 177* Darwin: make libusb_reset reenumerate device on descriptors change (#89) 178* Darwin: add support for the LIBUSB_TRANSFER_ADD_ZERO_PACKET flag (#91) 179* Darwin: add a device cache (#112, #114) 180* Examples: Add sam3u_benchmark isochronous example by Harald Welte (#109) 181* Many other bug fixes and improvements 182The (#xx) numbers are libusbx issue numbers, see ie: 183https://github.com/libusbx/libusbx/issues/9 184 1852013-04-15: v1.0.15 186* Improve transfer cancellation and avoid short read failures on broken descriptors 187* Filter out 8-bit characters in libusb_get_string_descriptor_ascii() 188* Add WinCE support 189* Add library stress tests 190* Add Cypress FX3 firmware upload support for fxload sample 191* Add HID and kernel driver detach support capabilities detection 192* Add SuperSpeed detection on OS X 193* Fix bInterval value interpretation on OS X 194* Fix issues with autoclaim, composite HID devices, interface autoclaim and 195 early abort in libusb_close() on Windows. Also add VS2012 solution files. 196* Improve fd event handling on Linux 197* Other bug fixes and improvements 198 1992012-09-26: v1.0.14 200* Reverts the previous API change with regards to bMaxPower. 201 If this doesn't matter to you, you are encouraged to keep using v1.0.13, 202 as it will use the same attribute as v2.0, to be released soon. 203* Note that LIBUSB_API_VERSION is *decreased* to 0x010000FF and the previous 204 guidelines with regards to concurrent use of MaxPower/bMaxPower still apply. 205 2062012-09-20: v1.0.13 207* [MAJOR] Fix a typo in the API with struct libusb_config_descriptor where 208 MaxPower was used instead of bMaxPower, as defined in the specs. If your 209 application was accessing the MaxPower attribute, and you need to maintain 210 compatibility with libusb or older versions, see APPENDIX A below. 211* Fix broken support for the 0.1 -> 1.0 libusb-compat layer 212* Fix unwanted cancellation of pending timeouts as well as major timeout related bugs 213* Fix handling of HID and composite devices on Windows 214* Introduce LIBUSB_API_VERSION macro 215* Add Cypress FX/FX2 firmware upload sample, based on fxload from 216 http://linux-hotplug.sourceforge.net 217* Add libusb0 (libusb-win32) and libusbK driver support on Windows. Note that while 218 the drivers allow it, isochronous transfers are not supported yet in libusb. Also 219 not supported yet is the use of libusb-win32 filter drivers on composite interfaces 220* Add support for the new get_capabilities ioctl on Linux and avoid unnecessary 221 splitting of bulk transfers 222* Improve support for newer Intel and Renesas USB 3.0 controllers on Windows 223* Harmonize the device number for root hubs across platforms 224* Other bug fixes and improvements 225 2262012-06-15: v1.0.12 227* Fix a potential major regression with pthread on Linux 228* Fix missing thread ID from debug log output on cygwin 229* Fix possible crash when using longjmp and MinGW's gcc 4.6 230* Add topology calls: libusb_get_port_number(), libusb_get_parent() & libusb_get_port_path() 231* Add toggleable debug, using libusb_set_debug() or the LIBUSB_DEBUG environment variable 232* Define log levels in libusb.h and set timestamp origin to first libusb_init() call 233* All logging is now sent to to stderr (info was sent to stdout previously) 234* Update log messages severity and avoid polluting log output on OS-X 235* Add HID driver support on Windows 236* Enable interchangeability of MSVC and MinGW DLLs 237* Additional bug fixes and improvements 238 2392012-05-08: v1.0.11 240* Revert removal of critical Windows event handling that was introduced in 1.0.10 241* Fix a possible deadlock in Windows when submitting transfers 242* Add timestamped logging 243* Add NetBSD support (experimental) and BSD libusb_get_device_speed() data 244* Add bootstrap.sh alongside autogen.sh (bootstrap.sh doesn't invoke configure) 245* Search for device nodes in /dev for Android support 246* Other bug fixes 247 2482012-04-17: v1.0.10 249* Public release 250* Add libusb_get_version 251* Add Visual Studio 2010 project files 252* Some Windows code cleanup 253* Fix xusb sample warnings 254 2552012-04-02: v1.0.9 256* First libusbx release 257* Add libusb_get_device_speed (all, except BSD) and libusb_error_name 258* Add Windows support (WinUSB driver only) 259* Add OpenBSD support 260* Add xusb sample 261* Tons of bug fixes 262 2632010-05-07: v1.0.8 264* Bug fixes 265 2662010-04-19: v1.0.7 267* Bug fixes and documentation tweaks 268* Add more interface class definitions 269 2702009-11-22: v1.0.6 271* Bug fixes 272* Increase libusb_handle_events() timeout to 60s for powersaving 273 2742009-11-15: v1.0.5 275 * Use timerfd when available for timer management 276 * Small fixes/updates 277 2782009-11-06: v1.0.4 release 279 * Bug fixes including transfer locking to fix some potential threading races 280 * More flexibility with clock types on Linux 281 * Use new bulk continuation tracking in Linux 2.6.32 for improved handling 282 of short/failed transfers 283 2842009-08-27: v1.0.3 release 285 * Bug fixes 286 * Add libusb_get_max_iso_packet_size() 287 2882009-06-13: v1.0.2 release 289 * Bug fixes 290 2912009-05-12: v1.0.1 release 292 * Bug fixes 293 * Darwin backend 294 2952008-12-13: v1.0.0 release 296 * Bug fixes 297 2982008-11-21: v0.9.4 release 299 * Bug fixes 300 * Add libusb_attach_kernel_driver() 301 3022008-08-23: v0.9.3 release 303 * Bug fixes 304 3052008-07-19: v0.9.2 release 306 * Bug fixes 307 3082008-06-28: v0.9.1 release 309 * Bug fixes 310 * Introduce contexts to the API 311 * Compatibility with new Linux kernel features 312 3132008-05-25: v0.9.0 release 314 * First libusb-1.0 beta release 315 316~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 317 318APPENDIX A - How to maintain code compatibility with versions of libusb and 319libusb that use MaxPower: 320 321If you must to maintain compatibility with versions of the library that aren't 322using the bMaxPower attribute in struct libusb_config_descriptor, the 323recommended way is to use the new LIBUSB_API_VERSION macro with an #ifdef. 324For instance, if your code was written as follows: 325 326 if (dev->config[0].MaxPower < 250) 327 328Then you should modify it to have: 329 330#if defined(LIBUSB_API_VERSION) && (LIBUSB_API_VERSION >= 0x01000100) 331 if (dev->config[0].bMaxPower < 250) 332#else 333 if (dev->config[0].MaxPower < 250) 334#endif 335