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
Brian Glod 048678df98 host: libbladeRF: API changes, BLADERF_FLASH_EB_SIZE usage
API change:
  - bladerf_image_write(): new parameter: bladeRF device handle
      Change is inspired by the pending removal of BLADERF_FLASH_EB_SIZE
      macro. This macro really shouldn't be exposed to the world, nor
      should it be constant as it may change depending on the flash
      used on the board.

API new function:
  - bladerf_erase_flash_bytes(): new function
      Similar to the existing bladerf_erase_flash() function, but
      handles the conversion from bytes to flash erase block pages
      internally. This function is recommended for new designs because
      the erase block size may change depending on the board. This
      function also checks for proper alignment along erase block
      boundaries.

General changes:
  Although the macro still exists (for now), all uses of
  BLADERF_FLASH_EB_SIZE have been replaced with equivalent
  dev->flash_arch->ebsize_bytes because the value may change depending
  on the flash used on the board.
2018-12-21 01:28:17 -08:00
debian Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689) 2018-11-12 18:13:58 -05:00
doc doc: version change checklist: debian changelog hint 2018-08-24 16:26:08 -04:00
firmware_common firmware_common: add shared flash routines 2018-12-21 01:28:17 -08:00
fpga_common fpga_common: ad936x.h: sync with adi's structs 2018-12-17 20:28:07 -05:00
fx3_firmware firmware_common: add shared flash routines 2018-12-21 01:28:17 -08:00
hdl hdl: update CHANGELOG 2018-12-21 01:28:17 -08:00
host host: libbladeRF: API changes, BLADERF_FLASH_EB_SIZE usage 2018-12-21 01:28:17 -08:00
legal updated the year 2018-10-22 11:08:03 -04:00
thirdparty/analogdevicesinc thirdparty: adi: define ALTERA_PLATFORM for headless platform 2018-12-17 20:28:07 -05:00
.clang-format clang-format: minor tweak for brackets on lists 2017-12-21 12:55:09 -05:00
.gitignore add more FPGA build artifact dirs to .gitignore 2018-09-06 17:00:38 -04:00
.gitmodules Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689) 2018-11-12 18:13:58 -05:00
CHANGELOG bladeRF 2018.10-rc1 2018-10-30 17:12:29 -04:00
CMakeLists.txt Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689) 2018-11-12 18:13:58 -05:00
CONTRIBUTORS CONTRIBUTORS: self-updating 2017-08-02 18:06:21 -04:00
COPYING legal: add AGPLv3, mention FPGA IP licenses (#38) 2018-05-23 12:15:00 -04:00
README.md README.md: Add '--recursive' to git clone 2018-12-11 17:19:24 -05: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 --recursive 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