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