A USB backend based atop of the Cypress CyAPI (which is based atop the
Cypress CyUSB3 driver) has been introduced. This is intended to provide
Windows users with an additional driver to use if they encounter issues
with their USB host controller and libusb.
To build and use this backend, the Cypress FX3 SDK must be installed and
the following CMake flags should be provided:
-DENABLE_BACKEND_CYAPI=Yes -DFX3_SDK_PATH=<path to SDK>
A modified cyusb3.inf is provided in host/drivers/windows/cyusb3. Upon
performing a build this inf file and the associated driver files from
the FX3 SDK will be copied into the "output" directory along with the
bladeRF.dll and bladeRF-cli.exe. To install the driver, point the
Windows driver update to this location and accept the warning about the
driver being unsigned; this occurs because the Cypress driver wasn't
signed with bladeRF VID/PID values.
The libbladeRF device string for this backend is: "cypress"
Many thanks go out to LazyDodo for all his efforts in spearheading the
development of this backend -- much of this code is either his doing or
is directly based upon his efforts.
Where possible (and with contributor permission), items have been
changed to LGPLv2.1 or MIT licenses to avoid issues with any proprietary
libraries from vendors (HDL and FW), allow static linking (with headless
mode operation in mind), and to generally present users with more
permissive licenses.
File headers and the COPYING have been updated accordingly. Third party
sources have been either removed, replaced, or relocated in the source
tree, in accordance with the licenses decided upon for each part of the tree.
Contributor Assignment Agreements have been added, and it is required
that these be submitted before significant patches and pull requests
are accepted.
This commit correctly changes the bladeRF's behavior by using mutually exclusive
alternate interface settings. Interfaces are not guaranteed to be exist one at a
time, thus they are unfit for use as an operating mode index.
This merge introduces libusb-1.0 support into libbladeRF. This is now
preferred over the Linux driver backend for the time being, as it will
allow quicker ports to Windows and OSX. The Linux driver will be
significantly refactored and improved at a later time; it is not
recommended for use with this set of changes.
As of this commit, Windows and OSX builds are still works in progress.
Linux builds have been tested and verified.
** Important **
This branch also introduces CMake support, code base reorganization, and
significant API changes. Please review the updated API header (best viewed
via the Doxygen-generated html files.)
If you've been working out of the bladerf branch, it is recommended that
you clean up the following:
1. Uninstall Linux kernel module, if you have it loading at boot
2. Remove installed libbladeRF files (libbladeRF.h, pkg-config, files, .so's)
3. Remove installed CLI program
4. Remove udev rules
Please review the new "Getting started" text and the instructions in the
README.md and host/README.md files for the new build procedure.
Manually resolved Conflicts:
README.md
host/drivers/linux/bladeRF.c
host/utilities/bladeRF-cli/src/interactive/interactive.h
linux/lib/src/bladerf.c
*Warning:* This is a broken nightly commit.
If not obvious, quite a bit of rearranging has been done.
The build script(s) for libbladeRF is mostly complete. This still
requires further configuration of debug builds and version info being
used to populate a version header.
Some cleanup has been done in the (formerly apps, now) utilities
directory. There's no CMake support in here yet...that's comming in the
next commit.