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
Rey Tucker 48ec0a40a6
Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689)
This PR creates a git submodule for the analogdevicesinc/no-OS code, moving it from host/libraries/libbladeRF/src/driver/thirdparty/adi/ to thirdparty/analogdevicesinc/no-OS and adjusting the build process accordingly.

The build process will handle the git submodule init / git submodule update as required, or it may be done manually before the build. It will then copy the necessary files to the build tree, apply a series of patches for local modifications, and then build it as libad936x.

There are no changes to the build steps, although the build will fail if git submodule init/update needs to happen but can't (e.g. if github is not reachable).

* thirdparty: add no-OS library submodule

Adds a submodule for https://github.com/analogdevicesinc/no-OS/, pinned
at commit 0bba46e.

* thirdparty: patch and build libad936x

Add cmake file for libad936x

Move our local mods into patch files

* host: libbladeRF: transition to libad936x

Transitions libbladeRF (particularly bladerf2.c) to use the libad936x
package, compiled separately.

This also adds ad936x.h, a driver header file that contains the
necessary things from libad936x.  This is cleaner than just importing
ad9361_api.h, due to the significant dependency/include challenges that
ensue...

* host: fix up libad936x build

Don't use ExternalProject, instead just add it as a subdirectory

Create a FindPatcher.cmake for the patch-or-git selector

Clean up and streamline the ad936x cmakelists

Clean up libbladeRF cmakelist formatting

* thirdparty: fix no-OS patch 0003

* host: ad936x: fixup build errors/warnings on macOS

* thirdparty/adi: patch to chop out ad9361_parse_fir

ad9361_parse_fir refers to sscanf, which is not readily available in the
Nios II library. We don't use this function, so it can go.

* libbladeRF: remove vestigial adi files

* debian: rm thirdparty ADI tree from license file

* host: thirdparty: fix git package handling

* host: thirdparty/ad936x: specify patches in order

It turns out that there's no guarantee that file(GLOB)
will output the patch files in the alphabetical order.

* Revert "debian: rm thirdparty ADI tree from license file"

This reverts commit 36cf335c0e.

* debian: update path in ADI copyright
2018-11-12 18:13:58 -05: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 fx3: add BLADE_USB_CMD_QUERY_FPGA_SOURCE command 2018-09-26 14:50:23 -04:00
fpga_common fpga_common: lms.h: check return val in lms_set_frequency (fixes #691) 2018-11-12 17:20:33 -05:00
fx3_firmware fx3: update changelog for v2.3.1 2018-09-26 15:17:45 -04:00
hdl hdl: build: Fix escaping for Windows 2018-11-11 16:18:09 -05:00
host Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689) 2018-11-12 18:13:58 -05:00
legal updated the year 2018-10-22 11:08:03 -04:00
thirdparty/analogdevicesinc Move vendor library code for ad936x RFIC to /thirdparty; use git submodule (#689) 2018-11-12 18:13:58 -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 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