1 For detailed information about the changes below, please see the git log or
2 visit: http://log.libusb.info
5 * New libusb_set_option() API
6 * Fix transfer timeout not being cleared upon resubmission
7 * Report super speed plus devices on modern Linux and macOS
8 * Darwin: Improve support for macOS Sierra and High Sierra
9 * Darwin: SDK fixes and improvements
10 * Linux: Let initialization succeed when no devices are present
11 * Linux: Mark internal file descriptors with CLOEXEC flag
12 * Solaris: Add support for attach/detach kernel driver
13 * Windows: Add dynamic UsbDk backend selection
14 * Windows: Add isochronous transfer support via libusbK
15 * Windows: Add Visual Studio 2017 support
16 * Windows: Fix enumeration problems on Windows 8 and later
17 * Windows: Major rework of poll() emulation
18 * Windows: Numerous HID API fixes
19 * Windows: Support cancelation of individual transfers (Vista and later)
20 * Various other bug fixes and improvements
23 * Core: Refactor code related to transfer flags and timeout handling
24 * Darwin: Ignore root hub simulation devices
25 * Darwin: Improved support for OS X El Capitan
26 * Darwin: Work around devices with buggy endpoint descriptors
27 * Darwin: Do not use objc_registerThreadWithCollector after its deprecation
28 * Darwin: Use C11 atomics on 10.12+ as the OS atomics are now deprecated
29 * Linux: Support preallocating kernel memory for zerocopy USB
30 * Linux: Deal with receiving POLLERR before all transfers have completed
31 * Solaris: Add solaris backend
32 * Windows: Add Visual Studio 2015 support
33 * Windows: Add usbdk backend
34 * Prevent attempts to recursively handle events
35 * Fix race condition in handle_timeout()
36 * Allow transferred argument to be optional in bulk APIs
37 * Various other bug fixes and improvements
41 * Fix multiple memory and resource leaks (#16, #52, #76, #81)
42 * Fix possible deadlock when executing transfer callback
43 * New libusb_free_pollfds() API
44 * Darwin: Fix devices not being detected on OS X 10.8 (#48)
45 * Linux: Allow larger isochronous transfer submission (#23)
46 * Windows: Fix broken builds Cygwin/MinGW builds and compiler warnings
47 * Windows: Fix broken bus number lookup
48 * Windows: Improve submission of control requests for composite devices
49 * Examples: Add two-stage load support to fxload (#12)
50 * Correctly report cancellations due to timeouts
51 * Improve efficiency of event handling
52 * Improve speed of transfer submission in multi-threaded environments
53 * Various other bug fixes and improvements
54 The (#xx) numbers are libusb issue numbers, see ie:
55 https://github.com/libusb/libusb/issues/16
58 * Add support for USB bulk streams on Linux and Mac OS X (#11)
59 * Windows: Add AMD and Intel USB-3.0 root hub support
60 * Windows: Fix USB 3.0 speed detection on Windows 8 or later (#10)
61 * Added Russian translation for libusb_strerror strings
62 * All: Various small fixes and cleanups
65 * Fix multiple memory leaks
66 * Fix a crash when HID transfers return no data on Windows
67 * Ensure all pending events are consumed
68 * Improve Android and ucLinux support
69 * Multiple Windows improvements (error logging, VS2013, VIA xHCI support)
70 * Multiple OS X improvements (broken compilation, SIGFPE, 64bit support)
73 * Hotplug callbacks now always get passed a libusb_context, even if it is
74 the default context. Previously NULL would be passed for the default context,
75 but since the first context created is the default context, and most apps
76 use only 1 context, this meant that apps explicitly creating a context would
78 * Android: Add .mk files to build with the Android NDK
79 * Darwin: Add Xcode project
80 * Darwin: Fix crash on unplug (#121)
81 * Linux: Fix hang (deadlock) on libusb_exit
82 * Linux: Fix libusb build failure with --disable-udev (#124)
83 * Linux: Fix libusb_get_device_list() hang with --disable-udev (#130)
84 * OpenBSD: Update OpenBSD backend with support for control transfers to
85 non-ugen(4) devices and make get_configuration() no longer generate I/O.
86 Note that using this libusb version on OpenBSD requires using
87 OpenBSD 5.3-current or later. Users of older OpenBSD versions are advised
88 to stay with the libusb shipped with OpenBSD (mpi)
89 * Windows: fix libusb_dll_2010.vcxproj link errors (#129)
90 * Various other bug fixes and improvements
93 * Add hotplug support for Darwin and Linux (#9)
94 * Add superspeed endpoint companion descriptor support (#15)
95 * Add BOS descriptor support (#15)
96 * Make descriptor parsing code more robust
97 * New libusb_get_port_numbers API, this is libusb_get_port_path without
98 the unnecessary context parameter, libusb_get_port_path is now deprecated
99 * New libusb_strerror API (#14)
100 * New libusb_set_auto_detach_kernel_driver API (#17)
101 * Improve topology API docs (#95)
102 * Logging now use a single write call per log-message, avoiding log-message
103 "interlacing" when using multiple threads.
104 * Android: use Android logging when building on Android (#101)
105 * Darwin: make libusb_reset reenumerate device on descriptors change (#89)
106 * Darwin: add support for the LIBUSB_TRANSFER_ADD_ZERO_PACKET flag (#91)
107 * Darwin: add a device cache (#112, #114)
108 * Examples: Add sam3u_benchmark isochronous example by Harald Welte (#109)
109 * Many other bug fixes and improvements
110 The (#xx) numbers are libusbx issue numbers, see ie:
111 https://github.com/libusbx/libusbx/issues/9
114 * Improve transfer cancellation and avoid short read failures on broken descriptors
115 * Filter out 8-bit characters in libusb_get_string_descriptor_ascii()
117 * Add library stress tests
118 * Add Cypress FX3 firmware upload support for fxload sample
119 * Add HID and kernel driver detach support capabilities detection
120 * Add SuperSpeed detection on OS X
121 * Fix bInterval value interpretation on OS X
122 * Fix issues with autoclaim, composite HID devices, interface autoclaim and
123 early abort in libusb_close() on Windows. Also add VS2012 solution files.
124 * Improve fd event handling on Linux
125 * Other bug fixes and improvements
128 * Reverts the previous API change with regards to bMaxPower.
129 If this doesn't matter to you, you are encouraged to keep using v1.0.13,
130 as it will use the same attribute as v2.0, to be released soon.
131 * Note that LIBUSB_API_VERSION is *decreased* to 0x010000FF and the previous
132 guidelines with regards to concurrent use of MaxPower/bMaxPower still apply.
135 * [MAJOR] Fix a typo in the API with struct libusb_config_descriptor where
136 MaxPower was used instead of bMaxPower, as defined in the specs. If your
137 application was accessing the MaxPower attribute, and you need to maintain
138 compatibility with libusb or older versions, see APPENDIX A below.
139 * Fix broken support for the 0.1 -> 1.0 libusb-compat layer
140 * Fix unwanted cancellation of pending timeouts as well as major timeout related bugs
141 * Fix handling of HID and composite devices on Windows
142 * Introduce LIBUSB_API_VERSION macro
143 * Add Cypress FX/FX2 firmware upload sample, based on fxload from
144 http://linux-hotplug.sourceforge.net
145 * Add libusb0 (libusb-win32) and libusbK driver support on Windows. Note that while
146 the drivers allow it, isochronous transfers are not supported yet in libusb. Also
147 not supported yet is the use of libusb-win32 filter drivers on composite interfaces
148 * Add support for the new get_capabilities ioctl on Linux and avoid unnecessary
149 splitting of bulk transfers
150 * Improve support for newer Intel and Renesas USB 3.0 controllers on Windows
151 * Harmonize the device number for root hubs across platforms
152 * Other bug fixes and improvements
155 * Fix a potential major regression with pthread on Linux
156 * Fix missing thread ID from debug log output on cygwin
157 * Fix possible crash when using longjmp and MinGW's gcc 4.6
158 * Add topology calls: libusb_get_port_number(), libusb_get_parent() & libusb_get_port_path()
159 * Add toggleable debug, using libusb_set_debug() or the LIBUSB_DEBUG environment variable
160 * Define log levels in libusb.h and set timestamp origin to first libusb_init() call
161 * All logging is now sent to to stderr (info was sent to stdout previously)
162 * Update log messages severity and avoid polluting log output on OS-X
163 * Add HID driver support on Windows
164 * Enable interchangeability of MSVC and MinGW DLLs
165 * Additional bug fixes and improvements
168 * Revert removal of critical Windows event handling that was introduced in 1.0.10
169 * Fix a possible deadlock in Windows when submitting transfers
170 * Add timestamped logging
171 * Add NetBSD support (experimental) and BSD libusb_get_device_speed() data
172 * Add bootstrap.sh alongside autogen.sh (bootstrap.sh doesn't invoke configure)
173 * Search for device nodes in /dev for Android support
178 * Add libusb_get_version
179 * Add Visual Studio 2010 project files
180 * Some Windows code cleanup
181 * Fix xusb sample warnings
184 * First libusbx release
185 * Add libusb_get_device_speed (all, except BSD) and libusb_error_name
186 * Add Windows support (WinUSB driver only)
187 * Add OpenBSD support
195 * Bug fixes and documentation tweaks
196 * Add more interface class definitions
200 * Increase libusb_handle_events() timeout to 60s for powersaving
203 * Use timerfd when available for timer management
204 * Small fixes/updates
206 2009-11-06: v1.0.4 release
207 * Bug fixes including transfer locking to fix some potential threading races
208 * More flexibility with clock types on Linux
209 * Use new bulk continuation tracking in Linux 2.6.32 for improved handling
210 of short/failed transfers
212 2009-08-27: v1.0.3 release
214 * Add libusb_get_max_iso_packet_size()
216 2009-06-13: v1.0.2 release
219 2009-05-12: v1.0.1 release
223 2008-12-13: v1.0.0 release
226 2008-11-21: v0.9.4 release
228 * Add libusb_attach_kernel_driver()
230 2008-08-23: v0.9.3 release
233 2008-07-19: v0.9.2 release
236 2008-06-28: v0.9.1 release
238 * Introduce contexts to the API
239 * Compatibility with new Linux kernel features
241 2008-05-25: v0.9.0 release
242 * First libusb-1.0 beta release
244 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
246 APPENDIX A - How to maintain code compatibility with versions of libusb and
247 libusb that use MaxPower:
249 If you must to maintain compatibility with versions of the library that aren't
250 using the bMaxPower attribute in struct libusb_config_descriptor, the
251 recommended way is to use the new LIBUSB_API_VERSION macro with an #ifdef.
252 For instance, if your code was written as follows:
254 if (dev->config[0].MaxPower < 250)
256 Then you should modify it to have:
258 #if defined(LIBUSB_API_VERSION) && (LIBUSB_API_VERSION >= 0x01000100)
259 if (dev->config[0].bMaxPower < 250)
261 if (dev->config[0].MaxPower < 250)