blob: fc5fc2ad5f517d4174da8c6fae443dc8b28bc552 [file] [log] [blame]
Pete Batardf17d1902012-09-25 00:35:32 +01001For detailed information about the changes below, please see the git log or
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +00002visit: http://log.libusb.info
Pete Batardf17d1902012-09-25 00:35:32 +01003
Chris Dickensb5991a92015-09-13 17:37:12 -070042015-09-13: v1.0.20
Chris Dickensd73bc722015-07-29 01:06:37 -07005* Add Haiku support
6* Fix multiple memory and resource leaks (#16, #52, #76, #81)
7* Fix possible deadlock when executing transfer callback
8* New libusb_free_pollfds() API
9* Darwin: Fix devices not being detected on OS X 10.8 (#48)
10* Linux: Allow larger isochronous transfer submission (#23)
11* Windows: Fix broken builds Cygwin/MinGW builds and compiler warnings
12* Windows: Fix broken bus number lookup
13* Windows: Improve submission of control requests for composite devices
Chris Dickens8f2d5bb2015-09-02 19:54:44 -070014* Examples: Add two-stage load support to fxload (#12)
15* Correctly report cancellations due to timeouts
Chris Dickensd73bc722015-07-29 01:06:37 -070016* Improve efficiency of event handling
17* Improve speed of transfer submission in multi-threaded environments
18* Various other bug fixes and improvements
19The (#xx) numbers are libusb issue numbers, see ie:
20https://github.com/libusb/libusb/issues/16
21
Hans de Goedef3587bb2014-05-30 14:48:28 +0200222014-05-30: v1.0.19
Hans de Goedeedaa1af2014-05-02 15:25:26 +020023* Add support for USB bulk streams on Linux and Mac OS X (#11)
24* Windows: Add AMD and Intel USB-3.0 root hub support
25* Windows: Fix USB 3.0 speed detection on Windows 8 or later (#10)
Hans de Goede5e77b882014-05-19 11:33:03 +020026* Added Russian translation for libusb_strerror strings
Hans de Goedeedaa1af2014-05-02 15:25:26 +020027* All: Various small fixes and cleanups
Hans de Goedeedaa1af2014-05-02 15:25:26 +020028
Pete Batarda2f2c312014-01-25 22:43:39 +0000292014-01-25: v1.0.18
Pete Batard9a34bb72014-01-08 23:51:38 +000030* Fix multiple memory leaks
31* Fix a crash when HID transfers return no data on Windows
32* Ensure all pending events are consumed
33* Improve Android and ucLinux support
34* Multiple Windows improvements (error logging, VS2013, VIA xHCI support)
35* Multiple OS X improvements (broken compilation, SIGFPE, 64bit support)
36
Hans de Goede0c3d17c2013-09-06 11:20:53 +0200372013-09-06: v1.0.17
Hans de Goede65129432013-08-28 10:17:53 +020038* Hotplug callbacks now always get passed a libusb_context, even if it is
39 the default context. Previously NULL would be passed for the default context,
40 but since the first context created is the default context, and most apps
41 use only 1 context, this meant that apps explicitly creating a context would
42 still get passed NULL
43* Android: Add .mk files to build with the Android NDK
44* Darwin: Add Xcode project
45* Darwin: Fix crash on unplug (#121)
46* Linux: Fix hang (deadlock) on libusb_exit
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +000047* Linux: Fix libusb build failure with --disable-udev (#124)
Hans de Goede65129432013-08-28 10:17:53 +020048* Linux: Fix libusb_get_device_list() hang with --disable-udev (#130)
49* OpenBSD: Update OpenBSD backend with support for control transfers to
50 non-ugen(4) devices and make get_configuration() no longer generate I/O.
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +000051 Note that using this libusb version on OpenBSD requires using
Hans de Goede65129432013-08-28 10:17:53 +020052 OpenBSD 5.3-current or later. Users of older OpenBSD versions are advised
53 to stay with the libusb shipped with OpenBSD (mpi)
54* Windows: fix libusb_dll_2010.vcxproj link errors (#129)
55* Various other bug fixes and improvements
Hans de Goede65129432013-08-28 10:17:53 +020056
Hans de Goeded1ed6c42013-07-11 11:04:02 +0200572013-07-11: v1.0.16
Hans de Goedee2fe75e2013-06-20 15:18:10 +020058* Add hotplug support for Darwin and Linux (#9)
59* Add superspeed endpoint companion descriptor support (#15)
60* Add BOS descriptor support (#15)
61* Make descriptor parsing code more robust
62* New libusb_get_port_numbers API, this is libusb_get_port_path without
63 the unnecessary context parameter, libusb_get_port_path is now deprecated
64* New libusb_strerror API (#14)
65* New libusb_set_auto_detach_kernel_driver API (#17)
Hans de Goedefaa62412013-07-06 09:09:25 +020066* Improve topology API docs (#95)
Hans de Goedeea39a142013-07-01 13:00:43 +020067* Logging now use a single write call per log-message, avoiding log-message
68 "interlacing" when using multiple threads.
Hans de Goedee2fe75e2013-06-20 15:18:10 +020069* Android: use Android logging when building on Android (#101)
70* Darwin: make libusb_reset reenumerate device on descriptors change (#89)
71* Darwin: add support for the LIBUSB_TRANSFER_ADD_ZERO_PACKET flag (#91)
72* Darwin: add a device cache (#112, #114)
73* Examples: Add sam3u_benchmark isochronous example by Harald Welte (#109)
74* Many other bug fixes and improvements
75The (#xx) numbers are libusbx issue numbers, see ie:
76https://github.com/libusbx/libusbx/issues/9
77
Pete Batard85f1bed2013-04-15 23:15:10 +0100782013-04-15: v1.0.15
Pete Batardad3e3d42013-04-04 19:03:15 +010079* Improve transfer cancellation and avoid short read failures on broken descriptors
Pete Batard196acee2013-04-02 19:52:16 +010080* Filter out 8-bit characters in libusb_get_string_descriptor_ascii()
81* Add WinCE support
82* Add library stress tests
Pete Batardad3e3d42013-04-04 19:03:15 +010083* Add Cypress FX3 firmware upload support for fxload sample
Pete Batard196acee2013-04-02 19:52:16 +010084* Add HID and kernel driver detach support capabilities detection
85* Add SuperSpeed detection on OS X
Pete Batard85f1bed2013-04-15 23:15:10 +010086* Fix bInterval value interpretation on OS X
Pete Batard196acee2013-04-02 19:52:16 +010087* Fix issues with autoclaim, composite HID devices, interface autoclaim and
Pete Batardad3e3d42013-04-04 19:03:15 +010088 early abort in libusb_close() on Windows. Also add VS2012 solution files.
Pete Batard196acee2013-04-02 19:52:16 +010089* Improve fd event handling on Linux
90* Other bug fixes and improvements
91
Pete Batardf17d1902012-09-25 00:35:32 +0100922012-09-26: v1.0.14
93* Reverts the previous API change with regards to bMaxPower.
94 If this doesn't matter to you, you are encouraged to keep using v1.0.13,
95 as it will use the same attribute as v2.0, to be released soon.
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +000096* Note that LIBUSB_API_VERSION is *decreased* to 0x010000FF and the previous
Pete Batard85f1bed2013-04-15 23:15:10 +010097 guidelines with regards to concurrent use of MaxPower/bMaxPower still apply.
Pete Batardf17d1902012-09-25 00:35:32 +010098
992012-09-20: v1.0.13
100* [MAJOR] Fix a typo in the API with struct libusb_config_descriptor where
101 MaxPower was used instead of bMaxPower, as defined in the specs. If your
102 application was accessing the MaxPower attribute, and you need to maintain
103 compatibility with libusb or older versions, see APPENDIX A below.
104* Fix broken support for the 0.1 -> 1.0 libusb-compat layer
105* Fix unwanted cancellation of pending timeouts as well as major timeout related bugs
106* Fix handling of HID and composite devices on Windows
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +0000107* Introduce LIBUSB_API_VERSION macro
Pete Batardf17d1902012-09-25 00:35:32 +0100108* Add Cypress FX/FX2 firmware upload sample, based on fxload from
109 http://linux-hotplug.sourceforge.net
110* Add libusb0 (libusb-win32) and libusbK driver support on Windows. Note that while
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +0000111 the drivers allow it, isochronous transfers are not supported yet in libusb. Also
Pete Batardf17d1902012-09-25 00:35:32 +0100112 not supported yet is the use of libusb-win32 filter drivers on composite interfaces
113* Add support for the new get_capabilities ioctl on Linux and avoid unnecessary
114 splitting of bulk transfers
115* Improve support for newer Intel and Renesas USB 3.0 controllers on Windows
116* Harmonize the device number for root hubs across platforms
117* Other bug fixes and improvements
118
1192012-06-15: v1.0.12
120* Fix a potential major regression with pthread on Linux
121* Fix missing thread ID from debug log output on cygwin
122* Fix possible crash when using longjmp and MinGW's gcc 4.6
123* Add topology calls: libusb_get_port_number(), libusb_get_parent() & libusb_get_port_path()
124* Add toggleable debug, using libusb_set_debug() or the LIBUSB_DEBUG environment variable
125* Define log levels in libusb.h and set timestamp origin to first libusb_init() call
126* All logging is now sent to to stderr (info was sent to stdout previously)
127* Update log messages severity and avoid polluting log output on OS-X
128* Add HID driver support on Windows
129* Enable interchangeability of MSVC and MinGW DLLs
130* Additional bug fixes and improvements
131
1322012-05-08: v1.0.11
133* Revert removal of critical Windows event handling that was introduced in 1.0.10
134* Fix a possible deadlock in Windows when submitting transfers
135* Add timestamped logging
136* Add NetBSD support (experimental) and BSD libusb_get_device_speed() data
137* Add bootstrap.sh alongside autogen.sh (bootstrap.sh doesn't invoke configure)
138* Search for device nodes in /dev for Android support
139* Other bug fixes
140
1412012-04-17: v1.0.10
142* Public release
143* Add libusb_get_version
144* Add Visual Studio 2010 project files
145* Some Windows code cleanup
146* Fix xusb sample warnings
147
1482012-04-02: v1.0.9
149* First libusbx release
150* Add libusb_get_device_speed (all, except BSD) and libusb_error_name
151* Add Windows support (WinUSB driver only)
152* Add OpenBSD support
153* Add xusb sample
154* Tons of bug fixes
155
1562010-05-07: v1.0.8
157* Bug fixes
158
1592010-04-19: v1.0.7
160* Bug fixes and documentation tweaks
161* Add more interface class definitions
162
1632009-11-22: v1.0.6
164* Bug fixes
165* Increase libusb_handle_events() timeout to 60s for powersaving
166
1672009-11-15: v1.0.5
168 * Use timerfd when available for timer management
169 * Small fixes/updates
170
1712009-11-06: v1.0.4 release
172 * Bug fixes including transfer locking to fix some potential threading races
173 * More flexibility with clock types on Linux
174 * Use new bulk continuation tracking in Linux 2.6.32 for improved handling
175 of short/failed transfers
176
1772009-08-27: v1.0.3 release
178 * Bug fixes
179 * Add libusb_get_max_iso_packet_size()
180
1812009-06-13: v1.0.2 release
182 * Bug fixes
183
1842009-05-12: v1.0.1 release
185 * Bug fixes
186 * Darwin backend
187
1882008-12-13: v1.0.0 release
189 * Bug fixes
190
1912008-11-21: v0.9.4 release
192 * Bug fixes
193 * Add libusb_attach_kernel_driver()
194
1952008-08-23: v0.9.3 release
196 * Bug fixes
197
1982008-07-19: v0.9.2 release
199 * Bug fixes
200
2012008-06-28: v0.9.1 release
202 * Bug fixes
203 * Introduce contexts to the API
204 * Compatibility with new Linux kernel features
205
2062008-05-25: v0.9.0 release
207 * First libusb-1.0 beta release
208
209~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
210
211APPENDIX A - How to maintain code compatibility with versions of libusb and
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +0000212libusb that use MaxPower:
Pete Batardf17d1902012-09-25 00:35:32 +0100213
214If you must to maintain compatibility with versions of the library that aren't
215using the bMaxPower attribute in struct libusb_config_descriptor, the
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +0000216recommended way is to use the new LIBUSB_API_VERSION macro with an #ifdef.
Pete Batardf17d1902012-09-25 00:35:32 +0100217For instance, if your code was written as follows:
218
219 if (dev->config[0].MaxPower < 250)
220
221Then you should modify it to have:
222
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +0000223#if defined(LIBUSB_API_VERSION) && (LIBUSB_API_VERSION >= 0x01000100)
Pete Batardf17d1902012-09-25 00:35:32 +0100224 if (dev->config[0].bMaxPower < 250)
225#else
226 if (dev->config[0].MaxPower < 250)
227#endif