MCPcopy Index your code
hub / github.com/Nuand/bladeRF

github.com/Nuand/bladeRF @2025.10

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2025.10 ↗ · + Follow
3,584 symbols 9,935 edges 385 files 392 documented · 11%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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>.
  9. 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.
  10. 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

Core symbols most depended-on inside this repo

bladerf_strerror
called by 480
host/libraries/libbladeRF/src/bladerf.c
cli_err
called by 137
host/utilities/bladeRF-cli/src/common.c
bladerf_enable_module
called by 104
host/libraries/libbladeRF/src/bladerf.c
_check_error
called by 71
host/libraries/libbladeRF_bindings/python/bladerf/_bladerf.py
str2uint
called by 59
host/common/src/conversions.c
CyFxAppErrorHandler
called by 50
fx3_firmware/src/bladeRF.c
bladerf_close
called by 49
host/libraries/libbladeRF_test/test_config_file/src/main.c
cli_err_nnl
called by 45
host/utilities/bladeRF-cli/src/common.c

Shape

Function 2,265
Class 1,002
Method 264
Enum 53

Languages

C78%
C++12%
Python10%

Modules by API surface

host/libraries/libbladeRF_bindings/python/bladerf/_bladerf.py185 symbols
host/libraries/libbladeRF/src/board/bladerf1/bladerf1.c156 symbols
host/libraries/libbladeRF/src/bladerf.c154 symbols
host/libraries/libbladeRF/src/board/bladerf2/bladerf2.c139 symbols
fpga_common/src/lms.c90 symbols
host/libraries/libbladeRF/src/backend/dummy/dummy.c75 symbols
host/examples/gnuradio/loopback/bladeRF_loopback.py74 symbols
host/libraries/libbladeRF/src/backend/usb/nios_access.c62 symbols
host/utilities/bladeRF-cli/src/cmd/printset_impl.c60 symbols
host/libraries/libbladeRF/src/backend/usb/usb.c59 symbols
host/common/src/dc_calibration.c55 symbols
host/libraries/libbladeRF/src/backend/usb/libusb.c54 symbols

For agents

$ claude mcp add bladeRF \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact