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