bladeRF/host
Jon Szymaniak 14f515e467 libbladeRF: Version bumped to v0.16.0
Changes include:

- Added XB-200 support
- Added experimental DC calibration and DC calibration table support
- Added "software autoload" of FPGAs and DC cal tables from config directories
- Added "File not found" (BLADERF_ERR_NO_FILE) return code
- Allow tuning up to 3.8GHz
- Fixed incorrect version checks
    + This resolves issue where VCTCXO value isn't loaded when using FPGA v0.0.3
- Fixed intermittent FPGA load failures
2014-07-04 11:40:17 -04:00
..
cmake host: Added additional configuration-time libusb function checks 2014-05-13 00:09:53 -04:00
common bladeRF-cli: Handle unterminated quote as a non-fatal error condition 2014-06-30 01:34:00 -04:00
drivers/linux linux driver: fix RX routines 2014-04-29 05:57:27 -04:00
libraries libbladeRF: Version bumped to v0.16.0 2014-07-04 11:40:17 -04:00
misc host: Added UDEV_RULES_PATH CMake option 2014-07-04 11:11:06 -04:00
utilities bladeRF-cli: Removed TODO comment, no action needed 2014-07-04 11:26:10 -04:00
CMakeLists.txt libbladeRF: Include required OSX common/ directory items in build 2014-03-08 19:55:22 -05:00
README.md host: Updated README.md to include CMake TREAT_WARNINGS_AS_ERRORS option 2013-11-24 17:08:13 -05:00

bladeRF Host Source

This directory contains the items outlined in the following table. Note that this structure includes some items planned for future development.

Directory Description
cmake CMake scripts and modules
drivers Device drivers for supported operating systems
libraries The main bladeRF support library and supplemental libraries
misc Miscellaneous files
utilities Applications and tools

Dependencies

libUSB

libusb-1.0 and its development headers are required. >= v1.0.12 is recommended for Linux, and >= v1.0.13 is recommended for Windows. Ideally, the latest released version is always recommended. Please see the libusb ChangeLog for more information.

CMake

CMake is used to build the items in this directory. >= v2.8.3 is required.

Ubuntu/Debian:

sudo apt-get install libusb-1.0.0 libusb-1.0.0-dev cmake

Build

From this directory, create a 'build' directory. This is personal preference, of course. It allows for all build files to be cleaned up via a single rm -r build/ command. Next, run cmake to configure the build, followed by make and sudo make install to build and install libraries and applications.

mkdir -p build
cd build
cmake [options] ../
make
sudo make install

Below is a list of useful and project-specific CMake options. Please see the CMake variable list in CMake's documentation for more information.

Option Description
-DENABLE_HOST_BUILD=<ON/OFF> Enables building of the Host components overall. Default is ON.
-DCMAKE_BUILD_TYPE=<type> Set to "Debug" to enable a debug build. "Release" is the default.
-DBUILD_DOCUMENTATION=<ON/OFF> Build libbladeRF API documentation and manpages for utilities. OFF by default.
-DCMAKE_C_COMPILER=<compiler> Specify the compiler to use. Otherwise, CMake will determine a default.
-DENABLE_GDB_EXTENSIONS=<ON/OFF> GCC & GDB users may want to set this to use -ggdb3 instead of -g. Disabled by default.
-DENABLE_BACKEND_LIBUSB=<ON/OFF> Enables libusb backend in libbladeRF. Enabled by default.
-DENABLE_BACKEND_LINUX_DRIVER=<ON/OFF> Enables Linux driver in libbladeRF. Disabled by default.
-DENABLE_LIBTECLA=<ON/OFF> Enable libtecla support in the bladeRF-cli program. Default: ON if libtecla is detected, OFF otherwise.
-DINSTALL_UDEV_RULES=<ON/OFF> Install udev rules to /etc/udev/rules.d/. Default: ON for Linux, OFF default otherwise.
-DBLADERF_GROUP=<group> Sets the group associated with the bladeRF in the installed udev rules. The default is plugdev.
-DTREAT_WARNINGS_AS_ERRORS=<Yes/No> Treat compiler warnings as errors, defaults to Yes. Contributors should keep this enabled.