================================================================================
bladeRF Project Change Log Summary

For more detailed information, please see the git change log and issue tracker
hosted on GitHub: https://github.com/nuand/bladeRF
================================================================================

--------------------------------------------------------------------------------
 2015.02 (2015-02-28)
--------------------------------------------------------------------------------

This release introduces build fixes. It consists the following versions:
    * FPGA bitstream v0.1.2
    * FX3 firmware v1.8.0
    * libbladeRF v1.2.1
    * bladeRF-cli v1.1.2

The following tracker items have been closed since the 2015.01-rc2 release:
    * Pull Requests:
        - #376: Code-generator for bladeRF-CLI made more robust

    * Bugs:
        - #375: Build error - missing defines
        - #374: Several issues when cross compiling host tools and libs for
                windows on a linux system via MinGW
        - #369: Interactive documentation fails to compile

    * Other:
        - #377: Timeout trying to update from firmware 1.5.3 (invalid)


Outstanding issue tracker items:

    * Pull Requests:
        - #358: bladeRF-cli: Can now specify multiple commands separated by
                semicolon
        - #313: merge dev-quartus14 branch
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #373: "trap divide error" while generating calibration table in
                CLI: cal table dc rx
        - #372: Calibration table generation hangs, performance issues
        - #360: [hdl] Older FPGA revisions no longer build
        - #354: [hdl] failure to include STP file due to talkback req ought to
                be fatal
        - #352: [libbladeRF] Intermittent out-of-order transfer callbacks with
                Windows & libusb 1.0.19
        - #342: [Installer] Windows installer doesn't ship 32-bit MATLAB support
        - #301: Direct sampling with XB-200 needs additional improvements

    * Enhancement Requests:
        - #378: [libbladeRF] Support zero-padding within a timestamped burst
        - #353: [bladeRF-cli, libbladeRF] Improve jump_to_boot docs and
                implementation
        - #345: [bladeRF-cli] Accept semi-colon command delimeters
        - #344: [fx3] Investigate/fix field checksums
        - #328: [libbladeRF] Review and evaluate use of stream lock WRT libusb
        - #321: How about a switch for bladeRF-cli to emit calibration in a
                format bladeRF-cli can later read?
        - #319: [bladeRF-cli] Add libedit and libreadline support
        - #282: [libbladeRF] Move get/set_lms_correction() and
                 get/set_fpga_correction() logic
        - #240: [libbladeRF] Prefer static assertion over assert() when
                possible
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using
                MiniExpansion Header
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #174: Task: Migrate FX3 build to CMake-generated Makefile

--------------------------------------------------------------------------------
 2015.01-rc2 (2015-01-31)
--------------------------------------------------------------------------------

This release candidate introduces a number of libbladeRF fixes and
improvements, as well as some minor bladeRF-cli fixes. See the CHANGELOG files
associated with these items for more details.

This release consists of the following versions:
    * FPGA bitstream v0.1.2
    * FX3 firmware v1.8.0
    * libbladeRF v1.2.0
    * bladeRF-cli v1.1.1

Major changes include:
    * libbladeRF fix for issue #95, in which device required power-on reset
      after an application crashed without properly closing the device handle.
    * libbladeRF changes to initial LMS state address signal quality issues
    * BLADERF_LOG_LEVEL environment variable and optional syslog support have
      been added to libbladeRF.
    * Documentation build fix for bladeRF-cli.

The following tracker items have been closed since the 2014.12-rc1 release:
    * Pull Requests:
        - #371: NixOS distro build fixes
        - #340: On non-Windows systems, send logs to syslog & stderr.

    * Bugs:
        - #372: [libbladeRF] Signal attenuation with XB-200
        - #370: [libbladeRF] LMS DC calibration settings stored in calibration
                tables only gets loaded once
        - #366: [libbladeRF] Power down DC calibration comparators to improve
                signal quality
        - #365: host: Don't redefine inline unless __cplusplus is defined
        - #364: libbladeRF: Can't probe for already opened device when using
                CyUSB backend
        - #95: linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancement Requests:
        - #343: [libbladeRF] Name worker threads (wontfix)

    * Other:
        - #368: Make BLADERF_ERR_* a enum type (wontfix)
        - #367: Make FPGA Autoloading fault tolerant (invalid)
        - #363: FPGA bitstream autoload fails occasionally (invalid)

Outstanding pull requests, tasks, enhancement requests, and known issues are
listed below. Please see the issue tracker for up-to-date information on
these and their associated schedules.

    * Pull Requests:
        - #358: bladeRF-cli: Can now specify multiple commands separated by
                semicolon
        - #313: merge dev-quartus14 branch
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #360: [hdl] Older FPGA revisions no longer build
        - #354: [hdl] failure to include STP file due to talkback req ought to
                be fatal
        - #352: [libbladeRF] Intermittent out-of-order transfer callbacks with
                Windows & libusb 1.0.19
        - #342: [Installer] Windows installer doesn't ship 32-bit MATLAB support
        - #301: Direct sampling with XB-200 needs additional improvements

    * Enhancement Requests:
        - #353: [bladeRF-cli, libbladeRF] Improve jump_to_boot docs and
                implementation
        - #345: [bladeRF-cli] Accept semi-colon command delimeters
        - #344: [fx3] Investigate/fix field checksums
        - #328: [libbladeRF] Review and evaluate use of stream lock WRT libusb
        - #321: How about a switch for bladeRF-cli to emit calibration in a
                format bladeRF-cli can later read?
        - #319: [bladeRF-cli] Add libedit and libreadline support
        - #282: [libbladeRF] Move get/set_lms_correction() and
                 get/set_fpga_correction() logic
        - #240: [libbladeRF] Prefer static assertion over assert() when
                possible
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using
                MiniExpansion Header
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #174: Task: Migrate FX3 build to CMake-generated Makefile

--------------------------------------------------------------------------------
 2014.12-rc1 (2014-12-23)
--------------------------------------------------------------------------------

This release candidate introduces some minor additions to libbladeRF and the
bladeRF-cli program. See the CHANGELOG items associated with these items for
more details.

This release consists of the following versions:
    * FPGA bitstream v0.1.2
    * FX3 firmware v1.8.0
    * libbladeRF v1.1.0
    * bladeRF-cli v1.1.0

Major changes include:
    * Introduction of libbladeRF support for bootloader detection and recovery.
      With this change, the Cypress backend should now be fully-functional.
    * Added libbladeRF file search path options (e.g., for host-based FPGA
      autoloading).
    * Moved message about detecting devices in bootloader mode to bladeRF-cli.
      This was original printed by some lower-level libbladeRF code, and deemed
      more appropriately located in the bladeRF-cli program.

The following tracker items have been closed since the 2014.11 release:

    * Enhancement requests:
        - #361: Make bladeRF-cli --probe vary its exit status based on whether
                a device was found or not
        - #359: [libbladeRF] Migrate bootloader recovery support to libbladeRF
        - #349: [libbladeRF] Add current directory and env vars to file search
                path


Outstanding pull requests, tasks, enhancement requests, and known issues are
listed below. Please see the issue tracker for up-to-date information on
these and their associated schedules.

    * Pull Requests:
        - #358: bladeRF-cli: Can now specify multiple commands separated by
                semicolon
        - #340: On non-Windows systems, send logs to syslog & stderr.
        - #313: merge dev-quartus14 branch
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #360: [hdl] Older FPGA revisions no longer build
        - #354: [hdl] failure to include STP file due to talkback req ought to
                be fatal
        - #352: [libbladeRF] Intermittent out-of-order transfer callbacks
                with Windows & libusb 1.0.19
        - #342: [Installer] Windows installer doesn't ship 32-bit MATLAB
                support
        - #301: Direct sampling with XB-200 needs additional improvements
        - #95:  linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancement Requests:
        - #353: [bladeRF-cli, libbladeRF] Improve jump_to_boot docs and
                implementation
        - #345: [bladeRF-cli] Accept semi-colon command delimeters
        - #344: [fx3] Investigate/fix field checksums
        - #343: [libbladeRF] Name worker threads
        - #328: [libbladeRF] Review and evaluate use of stream lock WRT libusb
        - #321: How about a switch for bladeRF-cli to emit calibration in a
                format bladeRF-cli can later read?
        - #319: [bladeRF-cli] Add libedit and libreadline support
        - #282: [libbladeRF] Move get/set_lms_correction() and
                 get/set_fpga_correction() logic
        - #240: [libbladeRF] Prefer static assertion over assert() when
                possible
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using
                MiniExpansion Header
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #174: Task: Migrate FX3 build to CMake-generated Makefile



--------------------------------------------------------------------------------
 2014.11 (2014-11-30)
--------------------------------------------------------------------------------

This release introduces a stable libbladeRF API and various fixes.

No further reverse-incompatible API changes are currently scheduled. Should such
changes be required in the future, they will be denoted through a major version
number increment.

This release consists of the following versions:
    * FPGA bitstream v0.1.2
    * FX3 firmware v1.8.0
    * libbladeRF v1.0.0
    * bladeRF-cli v1.0.0


Major fixes include:
    * libbladeRF now waits for SPI flash autoloading to complete when
      opening a device. This requires FX3 Firmware v1.8.0.
    * FPGA v0.1.2 includes fixes in timestamp functionality.
    * An issue causing SPI flash corruption when using libusb with the WinUSB
      driver has been addressed.


The following issue tracker items have been closed since the 2014.11-rc3
release:

    * Pull requests:
        - #357: debian: split udev rule into its own package
        - #356: debian package updates for libbladerf1
        - #350: debian: fw 1.8.0, fpga 0.1.2, HTTPS
        - #338: debian: allow libtecla-dev to satisfy build deps

    * Bugs:
        - #355: [libbladeRF] Windows firmware flashing fails with WinUSB
        - #351: [libbladeRF] Device locks up when simultaneously tuning freq
                and RX'ing
        - #348: [Windows] Cypress backend causes build failures in VS2010
        - #347: [libbladeRF] Header issue in Windows
        - #341: LMS Failures persist after FPGA v0.1.1
        - #339: [libbladeRF] file_ops.c should use $HOME before getpwuid()
        - #337: host: Windows builds should copy license files into output
                directory
        - #336: [libbladeRF] Loading calibration tables does not set LMS DC cal
                registers
        - #335: [hdl] Initial bursts with TX_NOW corrupted
        - #334: [hdl] Bursts corrupted when switching between TX_NOW and
                scheduled bursts
        - #333: [Cygwin] libusb and libc version checks fail to compile
        - #332: Build fails in Cygwin
        - #325: Calibration issue: "cal: Invalid module provided (lms)"
                [Invalid]
        - #320: BladeRF USB crashes on Beaglebone Black, Ubuntu 14.04
                [Invalid]
        - #318: Board occasionally fails to boot on computer power up [Invalid]
        - #317: FPGA autoload fails when USB device is open before FPGA is
                fully configured
        - #307: [hdl] RX and TX timestamp offset variation
        - #304: [bladeRF-cli] TX DC autocalibration/correction fails
        - #291: Missing RX Samples
        - #265: [hdl] Incorect metadata position in the RX Stream

    * Enhancement Requests:
        - #105: Develop testing guidelines on new releases

Outstanding pull requests, tasks, enhancement requests, and known issues are
listed below. Please see the issue tracker for up-to-date information on
these and their associated schedules.


    * Pull Requests:
        - #358: bladeRF-cli: Can now specify multiple commands separated by
                semicolon
        - #340: On non-Windows systems, send logs to syslog & stderr.
        - #313: merge dev-quartus14 branch
        - #257: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #354: [hdl] failure to include STP file due to talkback req ought to
                be fatal
        - #352: [libbladeRF] Intermittent out-of-order transfer callbacks with
                Windows & libusb 1.0.19
        - #342: [Installer] Windows installer doesn't ship 32-bit MATLAB support
        - #301: Direct sampling with XB-200 needs additional improvements
        - #95: linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancement Requests:
        - #353: [bladeRF-cli, libbladeRF] Improve jump_to_boot docs and
                implementation
        - #349: [libbladeRF] Add current directory and env vars to file search
                path
        - #345: [bladeRF-cli] Accept semi-colon command delimeters
        - #343: [libbladeRF] Name worker thread
        - #328: [libbladeRF] Review and evaluate use of stream lock WRT libusb
        - #321: How about a switch for bladeRF-cli to emit calibration in a
                format bladeRF-cli can later read?
        - #319: [bladeRF-cli] Add libedit and libreadline support
        - #282: [libbladeRF] Move get/set_lms_correction() and
                get/set_fpga_correction() logic
        - #240: [libbladeRF] Prefer static assertion over assert() when possible
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using Mini
                Expansion Header
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #174: Task: Migrate FX3 build to CMake-generated Makefile

--------------------------------------------------------------------------------
 2014.11-rc3 (2014-10-30)
--------------------------------------------------------------------------------

This 2014.11-rc3 release candidate introduces the remaining functionality
originally intended for a 2014.09 release, as well as a number of improvements
and bug fixes. As denoted by the name, the release has been rescheduled for
November 2014.

This release candidate consists of the following versions:
    * FPGA bitstream v0.1.1
    * FX3 firmware v1.7.1
    * libbladeRF v0.17.0
    * bladeRF-cli v0.12.0

Major changes and additions include:
    * Timestamp metadata support for the libbladeRF synchronous interface
        - Example code is included in the API documentation and available
          in the libbladeRF/doc/examples directory.
        - This is tightly-coupled with functionality and fixes introduced
          by FPGA v0.1.1.

    * A majority of libbladeRF functions have been made thread-safe.

    * libbladeRF support for a Cypress CyUSB3/CyAPI-based backend
        - This backend has been found to be a useful alternative on some
          systems with USB3 controllers that exhibit issues with the libusb
          backend implementation.

    * Fixes for LMS DC calibration issues
        - FPGA fixes in v0.1.1 have addressed a timing issue that corrupted
          LMS register readbacks. This fixes issue #269, in which LMS DC
          calibration registers would become corrupted and read back as 31's.
        - A bladeRF-cli change in v0.12.0 fixed issue #304, where TX DC
          calibration would fail, reporting that invalid values were
          encountered.

The remaining window of time up to the first official release is intended for
documentation improvements and bug fixes. New features or major changes will be
held off until the following cycle; they may be staged in a master-next branch
if needed.

The following issue tracker items have been closed since 2014.09-rc2. Issues
are listed first, with associated pull request items second, if relevant.

    * Pull requests:
        - #326: only use the relative path for logging .c filenames; enable it
                by default
        - #308: Allow #-style comments in bladeRF-cli
        - #303: libbladeRF: update README cmake options
        - #293: debian: update changelog w/ 2014.09-rc{1,2}

    * Bugs:
        - #336: [libbladeRF] Loading calibration tables does not set LMS DC cal
                registers
        - #333: [Cygwin] libusb and libc version checks fail to compil
        - #332: Build fails in Cygwin
        - #331: [libbladeRF] Enforce exclusive device access in Cypress backend
        - #330: [libbladeRF] Cannot open multiple devices via 'open any' request
        - #329: [cmake] 34151f6 breaks configuration for some CMake versions
        - #327: [libbladeRF] It is possible to get "stuck" with an FPGA < v0.0.1
        - #325: Calibration issue: "cal: Invalid module provided (lms)"[Invalid]
        - #324: [libbladeRF] Deadlock in bladerf_sync_tx on Windows
        - #323: [libbladeRF] bladerf_sync_config() does not set
                dev->transfer_timeout[module]
        - #322: [libbladeRF] libusb.c doesn't check for timeout_ms = 0 in buffer
                submission
        - #320: BladeRF USB crashes on Beaglebone Black, Ubuntu 14.04 [Invalid]
        - #318: Board occasionally fails to boot on computer power
                up [Invalid]
        - #309: [libbladeRF] XB-100 attach shouldn't succeed
        - #305/#306,#315: mingwbuild of libbladeRF fails on file_ops.c(ShlObj.h)
        - #304: [bladeRF-cli] TX DC autocalibration/correction fails
        - #295/#296: Update references to bladeRF-flash in top-level README.md
                     and man page(s)
        - #292/#296: cmake ignores user input
        - #291: Missing RX Samples
        - #290/#294: [bladeRF-cli] TX help typo
        - #285/#298: [libbladeRF] Update CMake options in README.md
        - #283: "bladeRF-cli --version" hangs and segfaults on Debian 7 in
                Virtualbox
        - #279: [libbladeRF] MACOSX_RPATH is not specified
        - #278: cmd_help.h generator breaks osx build
        - #277: bladeRF-cli: Make 'print <parameter>' output more consistent
        - #269: [libbladeRF] RXVGA2 DC autocalibration intermittently returns 31
                for all values
        - #260: [hdl] RX I Samples value 0
        - #255: Avoid obsolete samples in the RX Stream

    * Enhancement Requests:
        - #314: "make uninstall" cannot find install manifest
        - #312: [libbladeRF] Regression in USB 2.0 operation
        - #311/316: [bladeRF-cli] Move FPGA and device handle checks to common
                    code in cmd.c
        - #310: [libbladeRF] Add suport for disabling an XB [Won't Fix]
        - #299: Task: Provide .md5 and .sha256sum files with pre-built binaries
        - #289: libusb/windows. (Version compatibity)
        - #288/#302: [bladeRF-cli] XB-200 Filterbank Control
        - #252: [bladeRF-cli] Migrate rx/tx command implementations to
                libbladeRF's sync i/f
        - #250: [libbladeRF] Implement Cypress API-based backend

Outstanding pull requests, tasks, enhancement requests, and known issues as
of RC3 listed below. Please see the issue tracker for up-to-date information on
these and their associated schedules.

    * Pull requests:
        - #313: merge dev-quartus14 branch
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #335: [hdl] Initial bursts with TX_NOW corrupted
        - #334: [hdl] Bursts corrupted when switching between TX_NOW and
                      scheduled bursts
        - #317: FPGA autoload fails when USB device is open before FPGA is
                fully configured
        - #307: [hdl] RX and TX timestamp offset variation
        - #301: Direct sampling with XB-200 needs additional improvements
        - #265: [hdl] Incorect metadata position in the RX Stream
        - #95:  Linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancement Requests:
        - #328: [libbladeRF] Review and evaluate use of stream lock WRT libusb
        - #321: How about a switch for bladeRF-cli to emit calibration in a
                format bladeRF-cli can later read?
        - #319: [bladeRF-cli] Add libedit and libreadline support
        - #282: [libbladeRF] Move get/set_lms_correction() and
                get/set_fpga_correction() logic
        - #240: [libbladeRF] Prefer static assertion over assert() when possible
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using Mini
                Expansion Header
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #174: Task: Migrate FX3 build to CMake-generated Makefile
        - #105: Develop testing guidelines on new releases

--------------------------------------------------------------------------------
 2014.09-rc2 (2014-07-24)
--------------------------------------------------------------------------------

Since 2014.09-rc1, there have been a number of bug fixes.  We wanted to ensure
these fixes were provided at a relatively stable "snapshot" in the codebase,
prior to introducing a slightly large of set of internal changes required
to provide the timestamp support and thread-safety.

As such, these changes are have been marked `2014.09-rc2`, and the late-August
milestone has been been renamed to `2014.09-rc3`. The objectives for the
late-August and September and milestones remain.

This release candidate consists of the following versions:
    * FPGA bitstream v0.0.6
    * FX3 firmware v1.7.1
    * libbladeRF v0.16.2
    * bladeRF-cli v0.11.1

In addition to continued fixes and minor improvements, the remaining
major functionality, now scheduled for RC3 is:
    * Metadata/timestamp support for the libbladeRF synchronous interface
    * Experimental Cypress driver-based libbladeRF backend for Windows

The above items will add additional items to the libbladeRF API, but will not
introduce any reverse-incompatible changes.

The items scheduled for deprecation are largely the same since 2014.09-rc1
    * bladeRF-flash has been removed as of 2014.09-rc2
    * libbladeRF's BLADERF_FORMAT_SC16Q11 will be removed prior to 2014.09-rc3

Outstanding tasks and known issues, as of RC2, are listed below. Note that not
all of these are scheduled for resolution by 2014.09. Please see the milestone
and tracker information GitHub for more information.

    * Pull requests:
        - #277: [bladeRF-cli] Make 'print <parameter>' output more consistent
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #290: [bladeRF-cli] TX help typo
        - #285: [libbladeRF] Update CMake options in README.md
        - #260: [hdl] RX I Samples value 0
        - #224: Report error code for incompatible version sets
        - #95:  Linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancements:
        - #282: [libbladeRF] Move get/set_lms_correctiion() and
                get/set_fpga_correction() logic
        - #252: [bladeRF-cli] Migrate rx/tx command implementations to
                libbladeRF's sync i/f
        - #250: [libbladeRF] Implement Cypress API-based backend
        - #240: [libbladeRF] Prefer static assertion over assert() when possible
        - #238: [libbladeRF] Integrate timestamp/metadata support
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using Mini
                Expansion Header
        - #219: libbladeRF: bladerf_init_stream parameter order is inconsistent
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #199: Remove magic numbers for GPIO addresses from
                lms_spi_controller.c
        - #190: [libbladeRF] Refactor bladerf_priv.c
        - #174: Task: Migrate FX3 build to CMake-generated Makefile
        - #166: debian: Auto-download appropriate firmware/FPGA images from
                nuand.com during install
        - #105: Develop testing guidelines on new releases



--------------------------------------------------------------------------------
 2014.09-rc1 (2014-07-05)
--------------------------------------------------------------------------------

This is the first of two release candidates for a 2014-09 release. RC1 consists
of the following component versions:

    FPGA bitstream  v0.0.5
    FX3 Firmware    v1.7.0
    libbladeRF      v0.16.0
    bladeRF-cli     v0.11.0

This release candidate provides a majority of the functionality scheduled for
the 2014.09 release. The remaining functionality, scheduled for RC2 is:

    * Metadata/timestamp support for the libbladeRF synchronous interface
    * Detection and reporting of incompatible firmware/FPGA versions
    * Experimental Cypress driver-based libbladeRF backend for Windows

The above items will add additional items to the libbladeRF API, but will not
introduce any reverse-incompatible changes.


The following items are schedule for deprecation and removal prior to the
2014.09-rc2 release:

    * bladeRF-flash utility
        - A majority of the functionality provided in this program now overlaps
          with bladeRF-cli. This program was used to ease the burden associated
          with some very early firmware upgrades.

          However, for firmware upgrade issues, the well-documented bootloader
          approach is now preferred. This, combined with efforts to have
          libbladeRF be more explicit about version mismatches, should eliminate
          any remaining need for this program.

    * libbladeRF's BLADERF_FORMAT SC16_Q12 reverse compatibility macro
        - The format is now more appropriately named BLADERF_FORMAT_SC16_Q11.
          Ensure you've replaced references to the old enumeration value.


Outstanding tasks and known issues, as of RC1, are listed below. Note that not
all of these are scheduled for resolution by 2014.09. Please see the milestone
and tracker information GitHub for more information.

    * Pull requests:
        - #270: Markdown-ify the bladeRF-cli interactive help
        - #267: Adjust nios simulation component so it matches the synthesis
                version

    * Bugs:
        - #265: [hdl] Incorect metadata position in the RX Stream
        - #260: [hdl] RX I Samples value 0
        - #255: Avoid obsolete samples in the RX stream
        - #224: Report error code for incompatible version sets
        - #95:  Linux kernel/FX3: Not enough bandwidth for altsetting

    * Enhancements:
        - #252: [bladeRF-cli] Migrate rx/tx command implementations to
                libbladeRF's sync i/f
        - #250: [libbladeRF] Implement Cypress API-based backend
        - #240: [libbladeRF] Prefer static assertion over assert() when possible
        - #238: [libbladeRF] Integrate timestamp/metadata support
        - #236: [libbladeRF] API calls for XB-100 required
        - #221: Synchronized Tx/Rx of multiple bladeRFs for MIMO using Mini
                Expansion Header
        - #219: libbladeRF: bladerf_init_stream parameter order is inconsistent
        - #213: CLI should show sample file information for TX
        - #205: [FX3 Firmware] Code cleanup and potential improvements
        - #200: Reserved addresses for firmware customization
        - #199: Remove magic numbers for GPIO addresses from
                lms_spi_controller.c
        - #190: [libbladeRF] Refactor bladerf_priv.c
        - #174: Task: Migrate FX3 build to CMake-generated Makefile
        - #166: debian: Auto-download appropriate firmware/FPGA images from
                nuand.com during install
        - #105: Develop testing guidelines on new releases
