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