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
Ryan Thompson e53a0516d6 build: add low-latency GPIF buffer size build options
Add build options for low-latency GPIF buffer configuration to support
latency-sensitive applications. When enabled, both FX3 firmware and FPGA
report legacy versions (< 2.5.0 / 0.16.0) to trigger libbladeRF's
automatic buffer size detection.

FX3 Firmware (cmake -DLOW_LATENCY_GPIF_BUFFERS=ON):
- Set version to 2.4.0 (triggers legacy mode in libbladeRF)
- Configure GPIF DMA: size*2, count=22 buffers
- Generate VERSION string with correct 2.4.0 display

FPGA (build_bladerf.sh -L):
- Set version to 0.15.3 (includes critical metadata/timestamp fixes)
- Swap fx3_gpif_p.vhd with fx3_gpif_p_lowlatency.vhd during build
- Create fx3_gpif_p_lowlatency.vhd package: HS=256, SS=512 samples

Low-latency buffer sizes (pre-2.5.0/0.16.0 behavior):
- FPGA: HS=256, SS=512 samples (vs HS=1024, SS=2048)
- FX3:  size*2, count=22 DMA buffers (vs size*8, count=11)
- Host: USB_MSG_SIZE_*_LEGACY used by libbladeRF

libbladeRF 2.6.0+ automatically detects FW < 2.5.0 AND FPGA < 0.16.0
and uses legacy buffer sizes for backward compatibility.
2025-12-22 19:07:10 -06:00
debian debian: update control 2025-05-20 00:30:22 -07:00
doc doc: update development documentation 2018-12-21 16:42:46 -05:00
firmware_common firmware_common: add shared flash routines 2018-12-21 01:28:17 -08:00
fpga_common libladeRF: LTO fix 2025-05-19 23:58:10 -07:00
fx3_firmware build: add low-latency GPIF buffer size build options 2025-12-22 19:07:10 -06:00
hdl build: add low-latency GPIF buffer size build options 2025-12-22 19:07:10 -06:00
host Bump pillow 2025-10-06 16:06:05 -07:00
legal updated the year 2018-10-22 11:08:03 -04:00
thirdparty/analogdevicesinc libladeRF: LTO fix 2025-05-19 23:58:10 -07:00
.clang-format clang-format: minor tweak for brackets on lists 2017-12-21 12:55:09 -05:00
.gitignore host: improve txrx_hwloop test 2025-07-03 01:29:26 -07:00
.gitmodules bladeRF-fsk: add git submodule for bladeRF-fsk repo 2025-05-11 04:17:01 -07:00
CHANGELOG CHANGELOG 2023.02 update 2023-02-13 03:48:56 -08:00
CMakeLists.txt host: update CMake minimum required version format 2025-04-24 04:36:36 -07: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: update git clone instructions 2019-08-27 03:56:37 -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 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