308 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			308 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
For detailed information about the changes below, please see the git log or
 | 
						|
visit: http://log.libusb.info
 | 
						|
 | 
						|
2020-12-09: v1.0.24
 | 
						|
* Add new platform abstraction (#252)
 | 
						|
* Add Null POSIX backend
 | 
						|
* Add support for eventfd
 | 
						|
* Add support for thread IDs on Haiku, NetBSD and Solaris
 | 
						|
* New API libusb_hotplug_get_user_data()
 | 
						|
* Darwin (macOS): Fix race condition that results in segmentation fault (#701)
 | 
						|
* Darwin (macOS): Fix stale descriptor information post reset (#733)
 | 
						|
* Darwin (macOS): use IOUSBDevice as darwin_device_class explicitly (#693)
 | 
						|
* Linux: Drop support for kernel older than 2.6.32
 | 
						|
* Linux: Provide an event thread name (#689)
 | 
						|
* Linux: Wait until all USBs have been reaped before freeing them (#607)
 | 
						|
* NetBSD: Recognize device timeouts (#710)
 | 
						|
* OpenBSD: Allow opening ugen devices multiple times (#763)
 | 
						|
* OpenBSD: Support libusb_get_port_number() (#764)
 | 
						|
* SunOS: Fix a memory leak (#756)
 | 
						|
* SunOS: Various fixes (#627, #628, #629)
 | 
						|
* Windows: Add Visual Studio 2019 support
 | 
						|
* Windows: Drop support for WinCE and Visual Studio older than 2013
 | 
						|
* Windows: Drop support for Windows XP
 | 
						|
* Windows: Support building all examples using Visual Studio (#151)
 | 
						|
* Documentation fixes and improvements
 | 
						|
* Various other bug fixes and improvements
 | 
						|
 | 
						|
2019-08-28: v1.0.23
 | 
						|
* Add German translation (#446)
 | 
						|
* Add Hungarian translation (#493)
 | 
						|
* Android: Improved support for Android
 | 
						|
* BSD: Remove infinite recursion in OpenBSD backend
 | 
						|
* configure.ac: Fix detection of clock_gettime library (#439)
 | 
						|
* Core: abandon synchronous transfers when device closure is detected.
 | 
						|
* Core: fix error in handling the removal of file descriptors while handling
 | 
						|
  events.
 | 
						|
* Darwin(macOS): Switch from using ResetDevice to USBDeviceReEnumerate (#455)
 | 
						|
* Darwin(macOS): Remove code that changed the device class used (#428)
 | 
						|
* Darwin(macOS): Reduce hotplug timeout to 1ms (from 5s)
 | 
						|
* New API libusb_set_log_cb() to redirect global and per context log
 | 
						|
  messages to the provided log handling function
 | 
						|
* New API libusb_wrap_sys_device to allow the user to specify the
 | 
						|
  usb device to use.
 | 
						|
* Solaris: Break infinite recursion in backend clock_gettime
 | 
						|
* Solaris: Enable timerfd on sunos when available
 | 
						|
* Windows: Add support for isochronous transfers with WinUSB
 | 
						|
* Various other bug fixes and improvements
 | 
						|
 | 
						|
2018-03-24: v1.0.22
 | 
						|
* New libusb_set_option() API
 | 
						|
* Fix transfer timeout not being cleared upon resubmission
 | 
						|
* Report super speed plus devices on modern Linux and macOS
 | 
						|
* Darwin: Improve support for macOS Sierra and High Sierra
 | 
						|
* Darwin: SDK fixes and improvements
 | 
						|
* Linux: Let initialization succeed when no devices are present
 | 
						|
* Linux: Mark internal file descriptors with CLOEXEC flag
 | 
						|
* Solaris: Add support for attach/detach kernel driver
 | 
						|
* Windows: Add dynamic UsbDk backend selection
 | 
						|
* Windows: Add isochronous transfer support via libusbK
 | 
						|
* Windows: Add Visual Studio 2017 support
 | 
						|
* Windows: Fix enumeration problems on Windows 8 and later
 | 
						|
* Windows: Major rework of poll() emulation
 | 
						|
* Windows: Numerous HID API fixes
 | 
						|
* Windows: Support cancelation of individual transfers (Vista and later)
 | 
						|
* Various other bug fixes and improvements
 | 
						|
 | 
						|
2016-10-01: v1.0.21
 | 
						|
* Core: Refactor code related to transfer flags and timeout handling
 | 
						|
* Darwin: Ignore root hub simulation devices
 | 
						|
* Darwin: Improved support for OS X El Capitan
 | 
						|
* Darwin: Work around devices with buggy endpoint descriptors
 | 
						|
* Darwin: Do not use objc_registerThreadWithCollector after its deprecation
 | 
						|
* Darwin: Use C11 atomics on 10.12+ as the OS atomics are now deprecated
 | 
						|
* Linux: Support preallocating kernel memory for zerocopy USB
 | 
						|
* Linux: Deal with receiving POLLERR before all transfers have completed
 | 
						|
* Solaris: Add solaris backend
 | 
						|
* Windows: Add Visual Studio 2015 support
 | 
						|
* Windows: Add usbdk backend
 | 
						|
* Prevent attempts to recursively handle events
 | 
						|
* Fix race condition in handle_timeout()
 | 
						|
* Allow transferred argument to be optional in bulk APIs
 | 
						|
* Various other bug fixes and improvements
 | 
						|
 | 
						|
2015-09-13: v1.0.20
 | 
						|
* Add Haiku support
 | 
						|
* Fix multiple memory and resource leaks (#16, #52, #76, #81)
 | 
						|
* Fix possible deadlock when executing transfer callback
 | 
						|
* New libusb_free_pollfds() API
 | 
						|
* Darwin: Fix devices not being detected on OS X 10.8 (#48)
 | 
						|
* Linux: Allow larger isochronous transfer submission (#23)
 | 
						|
* Windows: Fix broken builds Cygwin/MinGW builds and compiler warnings
 | 
						|
* Windows: Fix broken bus number lookup
 | 
						|
* Windows: Improve submission of control requests for composite devices
 | 
						|
* Examples: Add two-stage load support to fxload (#12)
 | 
						|
* Correctly report cancellations due to timeouts
 | 
						|
* Improve efficiency of event handling
 | 
						|
* Improve speed of transfer submission in multi-threaded environments
 | 
						|
* Various other bug fixes and improvements
 | 
						|
The (#xx) numbers are libusb issue numbers, see ie:
 | 
						|
https://github.com/libusb/libusb/issues/16
 | 
						|
 | 
						|
2014-05-30: v1.0.19
 | 
						|
* Add support for USB bulk streams on Linux and Mac OS X (#11)
 | 
						|
* Windows: Add AMD and Intel USB-3.0 root hub support
 | 
						|
* Windows: Fix USB 3.0 speed detection on Windows 8 or later (#10)
 | 
						|
* Added Russian translation for libusb_strerror strings
 | 
						|
* All: Various small fixes and cleanups
 | 
						|
 | 
						|
2014-01-25: v1.0.18
 | 
						|
* Fix multiple memory leaks
 | 
						|
* Fix a crash when HID transfers return no data on Windows
 | 
						|
* Ensure all pending events are consumed
 | 
						|
* Improve Android and ucLinux support
 | 
						|
* Multiple Windows improvements (error logging, VS2013, VIA xHCI support)
 | 
						|
* Multiple OS X improvements (broken compilation, SIGFPE, 64bit support)
 | 
						|
 | 
						|
2013-09-06: v1.0.17
 | 
						|
* Hotplug callbacks now always get passed a libusb_context, even if it is
 | 
						|
  the default context. Previously NULL would be passed for the default context,
 | 
						|
  but since the first context created is the default context, and most apps
 | 
						|
  use only 1 context, this meant that apps explicitly creating a context would
 | 
						|
  still get passed NULL
 | 
						|
* Android: Add .mk files to build with the Android NDK
 | 
						|
* Darwin: Add Xcode project
 | 
						|
* Darwin: Fix crash on unplug (#121)
 | 
						|
* Linux: Fix hang (deadlock) on libusb_exit
 | 
						|
* Linux: Fix libusb build failure with --disable-udev (#124)
 | 
						|
* Linux: Fix libusb_get_device_list() hang with --disable-udev (#130)
 | 
						|
* OpenBSD: Update OpenBSD backend with support for control transfers to
 | 
						|
  non-ugen(4) devices and make get_configuration() no longer generate I/O.
 | 
						|
  Note that using this libusb version on OpenBSD requires using
 | 
						|
  OpenBSD 5.3-current or later. Users of older OpenBSD versions are advised
 | 
						|
  to stay with the libusb shipped with OpenBSD (mpi)
 | 
						|
* Windows: fix libusb_dll_2010.vcxproj link errors (#129)
 | 
						|
* Various other bug fixes and improvements
 | 
						|
 | 
						|
2013-07-11: v1.0.16
 | 
						|
* Add hotplug support for Darwin and Linux (#9)
 | 
						|
* Add superspeed endpoint companion descriptor support (#15)
 | 
						|
* Add BOS descriptor support (#15)
 | 
						|
* Make descriptor parsing code more robust
 | 
						|
* New libusb_get_port_numbers API, this is libusb_get_port_path without
 | 
						|
  the unnecessary context parameter, libusb_get_port_path is now deprecated
 | 
						|
* New libusb_strerror API (#14)
 | 
						|
* New libusb_set_auto_detach_kernel_driver API (#17)
 | 
						|
* Improve topology API docs (#95)
 | 
						|
* Logging now use a single write call per log-message, avoiding log-message
 | 
						|
  "interlacing" when using multiple threads.
 | 
						|
* Android: use Android logging when building on Android (#101)
 | 
						|
* Darwin: make libusb_reset reenumerate device on descriptors change (#89)
 | 
						|
* Darwin: add support for the LIBUSB_TRANSFER_ADD_ZERO_PACKET flag (#91)
 | 
						|
* Darwin: add a device cache (#112, #114)
 | 
						|
* Examples: Add sam3u_benchmark isochronous example by Harald Welte (#109)
 | 
						|
* Many other bug fixes and improvements
 | 
						|
The (#xx) numbers are libusbx issue numbers, see ie:
 | 
						|
https://github.com/libusbx/libusbx/issues/9
 | 
						|
 | 
						|
2013-04-15: v1.0.15
 | 
						|
* Improve transfer cancellation and avoid short read failures on broken descriptors
 | 
						|
* Filter out 8-bit characters in libusb_get_string_descriptor_ascii()
 | 
						|
* Add WinCE support
 | 
						|
* Add library stress tests
 | 
						|
* Add Cypress FX3 firmware upload support for fxload sample
 | 
						|
* Add HID and kernel driver detach support capabilities detection
 | 
						|
* Add SuperSpeed detection on OS X
 | 
						|
* Fix bInterval value interpretation on OS X
 | 
						|
* Fix issues with autoclaim, composite HID devices, interface autoclaim and
 | 
						|
  early abort in libusb_close() on Windows. Also add VS2012 solution files.
 | 
						|
* Improve fd event handling on Linux
 | 
						|
* Other bug fixes and improvements
 | 
						|
 | 
						|
2012-09-26: v1.0.14
 | 
						|
* Reverts the previous API change with regards to bMaxPower.
 | 
						|
  If this doesn't matter to you, you are encouraged to keep using v1.0.13,
 | 
						|
  as it will use the same attribute as v2.0, to be released soon.
 | 
						|
* Note that LIBUSB_API_VERSION is *decreased* to 0x010000FF and the previous
 | 
						|
  guidelines with regards to concurrent use of MaxPower/bMaxPower still apply.
 | 
						|
 | 
						|
2012-09-20: v1.0.13
 | 
						|
* [MAJOR] Fix a typo in the API with struct libusb_config_descriptor where
 | 
						|
  MaxPower was used instead of bMaxPower, as defined in the specs. If your 
 | 
						|
  application was accessing the MaxPower attribute, and you need to maintain
 | 
						|
  compatibility with libusb or older versions, see APPENDIX A below.
 | 
						|
* Fix broken support for the 0.1 -> 1.0 libusb-compat layer
 | 
						|
* Fix unwanted cancellation of pending timeouts as well as major timeout related bugs
 | 
						|
* Fix handling of HID and composite devices on Windows
 | 
						|
* Introduce LIBUSB_API_VERSION macro
 | 
						|
* Add Cypress FX/FX2 firmware upload sample, based on fxload from
 | 
						|
  http://linux-hotplug.sourceforge.net
 | 
						|
* Add libusb0 (libusb-win32) and libusbK driver support on Windows. Note that while
 | 
						|
  the drivers allow it, isochronous transfers are not supported yet in libusb. Also
 | 
						|
  not supported yet is the use of libusb-win32 filter drivers on composite interfaces
 | 
						|
* Add support for the new get_capabilities ioctl on Linux and avoid unnecessary
 | 
						|
  splitting of bulk transfers
 | 
						|
* Improve support for newer Intel and Renesas USB 3.0 controllers on Windows
 | 
						|
* Harmonize the device number for root hubs across platforms
 | 
						|
* Other bug fixes and improvements
 | 
						|
 | 
						|
2012-06-15: v1.0.12
 | 
						|
* Fix a potential major regression with pthread on Linux
 | 
						|
* Fix missing thread ID from debug log output on cygwin
 | 
						|
* Fix possible crash when using longjmp and MinGW's gcc 4.6
 | 
						|
* Add topology calls: libusb_get_port_number(), libusb_get_parent() & libusb_get_port_path()
 | 
						|
* Add toggleable debug, using libusb_set_debug() or the LIBUSB_DEBUG environment variable
 | 
						|
* Define log levels in libusb.h and set timestamp origin to first libusb_init() call
 | 
						|
* All logging is now sent to to stderr (info was sent to stdout previously)
 | 
						|
* Update log messages severity and avoid polluting log output on OS-X
 | 
						|
* Add HID driver support on Windows
 | 
						|
* Enable interchangeability of MSVC and MinGW DLLs
 | 
						|
* Additional bug fixes and improvements
 | 
						|
 | 
						|
2012-05-08: v1.0.11
 | 
						|
* Revert removal of critical Windows event handling that was introduced in 1.0.10
 | 
						|
* Fix a possible deadlock in Windows when submitting transfers
 | 
						|
* Add timestamped logging
 | 
						|
* Add NetBSD support (experimental) and BSD libusb_get_device_speed() data
 | 
						|
* Add bootstrap.sh alongside autogen.sh (bootstrap.sh doesn't invoke configure)
 | 
						|
* Search for device nodes in /dev for Android support
 | 
						|
* Other bug fixes
 | 
						|
 | 
						|
2012-04-17: v1.0.10
 | 
						|
* Public release
 | 
						|
* Add libusb_get_version
 | 
						|
* Add Visual Studio 2010 project files
 | 
						|
* Some Windows code cleanup
 | 
						|
* Fix xusb sample warnings 
 | 
						|
 | 
						|
2012-04-02: v1.0.9
 | 
						|
* First libusbx release
 | 
						|
* Add libusb_get_device_speed (all, except BSD) and libusb_error_name
 | 
						|
* Add Windows support (WinUSB driver only)
 | 
						|
* Add OpenBSD support
 | 
						|
* Add xusb sample
 | 
						|
* Tons of bug fixes
 | 
						|
 | 
						|
2010-05-07: v1.0.8
 | 
						|
* Bug fixes
 | 
						|
 | 
						|
2010-04-19: v1.0.7
 | 
						|
* Bug fixes and documentation tweaks
 | 
						|
* Add more interface class definitions
 | 
						|
 | 
						|
2009-11-22: v1.0.6
 | 
						|
* Bug fixes
 | 
						|
* Increase libusb_handle_events() timeout to 60s for powersaving
 | 
						|
 | 
						|
2009-11-15: v1.0.5
 | 
						|
 * Use timerfd when available for timer management
 | 
						|
 * Small fixes/updates
 | 
						|
 | 
						|
2009-11-06: v1.0.4 release
 | 
						|
 * Bug fixes including transfer locking to fix some potential threading races
 | 
						|
 * More flexibility with clock types on Linux
 | 
						|
 * Use new bulk continuation tracking in Linux 2.6.32 for improved handling
 | 
						|
   of short/failed transfers
 | 
						|
 | 
						|
2009-08-27: v1.0.3 release
 | 
						|
 * Bug fixes
 | 
						|
 * Add libusb_get_max_iso_packet_size()
 | 
						|
 | 
						|
2009-06-13: v1.0.2 release
 | 
						|
 * Bug fixes
 | 
						|
 | 
						|
2009-05-12: v1.0.1 release
 | 
						|
 * Bug fixes
 | 
						|
 * Darwin backend
 | 
						|
 | 
						|
2008-12-13: v1.0.0 release
 | 
						|
 * Bug fixes
 | 
						|
 | 
						|
2008-11-21: v0.9.4 release
 | 
						|
 * Bug fixes
 | 
						|
 * Add libusb_attach_kernel_driver()
 | 
						|
 | 
						|
2008-08-23: v0.9.3 release
 | 
						|
 * Bug fixes
 | 
						|
 | 
						|
2008-07-19: v0.9.2 release
 | 
						|
 * Bug fixes
 | 
						|
 | 
						|
2008-06-28: v0.9.1 release
 | 
						|
 * Bug fixes
 | 
						|
 * Introduce contexts to the API
 | 
						|
 * Compatibility with new Linux kernel features
 | 
						|
 | 
						|
2008-05-25: v0.9.0 release
 | 
						|
 * First libusb-1.0 beta release
 | 
						|
 | 
						|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 | 
						|
 | 
						|
APPENDIX A - How to maintain code compatibility with versions of libusb and
 | 
						|
libusb that use MaxPower:
 | 
						|
 | 
						|
If you must to maintain compatibility with versions of the library that aren't
 | 
						|
using the bMaxPower attribute in struct libusb_config_descriptor, the 
 | 
						|
recommended way is to use the new LIBUSB_API_VERSION macro with an #ifdef.
 | 
						|
For instance, if your code was written as follows:
 | 
						|
 | 
						|
  if (dev->config[0].MaxPower < 250)
 | 
						|
 | 
						|
Then you should modify it to have:
 | 
						|
 | 
						|
#if defined(LIBUSB_API_VERSION) && (LIBUSB_API_VERSION >= 0x01000100)
 | 
						|
  if (dev->config[0].bMaxPower < 250)
 | 
						|
#else
 | 
						|
  if (dev->config[0].MaxPower < 250)
 | 
						|
#endif
 |