bladeRF USB 3.0 Superspeed Software Defined Radio Source Code http://nuand.com
  • C 45.8%
  • VHDL 21%
  • Verilog 15.8%
  • Tcl 3.8%
  • MATLAB 3.2%
  • Other 10.3%
Find a file
Jon Szymaniak 34151f6e71 host: Added a config-time libusb version check and errors/warnings
FindLibUSB.cmake now fetches the libusb version via libusb_get_version()
so that we can warn (or error out) about the system containing an
outdated libusb version.

The following policies have been based upon support experiences and the
libusb changelog:

    Windows: Error out for libusb < 1.0.19
        v1.0.19 provides Windows 8 SuperSpeed detection support,
        and appears to address a number of issues bladeRF users
        have reported with v1.0.18 and earlier.

        We force users to update here, given that some of the failures
        on earlier versions were yielding corrupted samples.

    OSX: Warn for libusb < 1.0.18:
        v1.0.16 - v1.0.18 introduced SuperSpeed and 64-bit support,
        as well as fixes for compile-time and run-time issues.

    Linux: Warn for libusb < 1.0.16:
        This is largely based upon feedback from bladeRF users. While
        older versions may work, a number of users reported that issues
        appeared to be resolved after updating libusb to >= 1.0.16.
        (It isn't always clear if the reported update included Linux
         distro upgrades that included kernel updates.)

The version check may be skipped via LIBUSB_SKIP_VERSION_CHECK=Yes.
This is intentionally not noted in the warnings/errors, as it's
preferred that users update libusb rather than just skip the check.
2014-10-15 20:06:53 -04:00
debian debian: update changelog w/ 2014.09-rc{1,2} 2014-07-26 11:34:38 -04:00
firmware_common fx3_firmware: Added support for reading back FW loopback state 2014-07-19 13:31:13 -04:00
fx3_firmware fx3_firmware: Bumped patch revision (v1.7.1) 2014-07-19 13:31:53 -04:00
hdl hdl/libbladeRF/debian: Bumping FPGA v.0.0.6. 2014-07-20 16:34:55 -04:00
host host: Added a config-time libusb version check and errors/warnings 2014-10-15 20:06:53 -04:00
legal license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
.gitignore host/misc: Added a Windows build script 2014-07-22 02:10:04 -04:00
CHANGELOG Updated CHANGELOG for bladeRF-2014.09-rc2 2014-07-24 22:59:24 -04:00
CMakeLists.txt cmake: FX3 firmware build is disabled by default 2013-12-21 17:36:06 -05:00
CONTRIBUTORS Updated CONTRIBUTORS 2013-09-27 21:21:12 -04:00
COPYING COPYING: Typo fix 2014-02-14 22:54:52 -05:00
README.md Update CMake options in READMEs (#285) 2014-07-27 13:32:49 -04:00

bladeRF Source

This repository contains all the source code required to program and interact with a bladeRF platform, including firmware for the Cypress FX3 USB controller, HDL for the Altera Cyclone IV FPGA, and C code for the host side libraries, drivers, and utilities. The source is organized as follows:

Directory Description
firmware_common Source and header files common between firmware and host software
fx3_firmware Firmware for the Cypress FX3 USB controller
hdl All HDL code associated with the Cyclone IV FPGA
host Host-side libraries, drivers, utilities and samples

Quick Start

  1. Clone this repository via: git clone https://github.com/Nuand/bladeRF.git
  2. Fetch the latest pre-built bladeRF FPGA image. See the README.md in the hdl directory for more information.
  3. Fetch the latest pre-built bladeRF firmware image. See the README.md in the fx3_firmware directory for more information.
  4. Follow the instructions in the host directory to build and install libbladeRF and the bladeRF-cli utility.
  5. Attach the bladeRF board to your fastest USB port.
  6. You should now be able to see your device in the list output via bladeRF-cli -p
  7. You can view additional information about the device via bladeRF-cli -e info -e version.
  8. If any warnings indicate that a firmware update is needed, run:bladeRF-cli -f <firmware_file>.
  • If you ever find the device booting into the FX3 bootloader (e.g., if you unplug the device in the middle of a firmware upgrade), see the recovery command in bladeRF-cli for additional details.
  1. See the overview of the bladeRF-cli for more information about loading the FPGA and using the command line interface tool

For more information, see the bladeRF wiki.

Build Variables

Below are global options to choose which parts of the bladeRF project should be built from the top level. Please see the fx3_firmware and host subdirectories for more specific options.

Option Description
-DENABLE_FX3_BUILD=<ON/OFF> Enables building the FX3 firmware. Default: OFF
-DENABLE_HOST_BUILD=<ON/OFF> Enables building the host library and utilities overall. Default: ON