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