bladeRF/fx3_firmware
2015-09-08 11:33:34 -04:00
..
C4loader.cydsn fx3_firmware: update GPIF2 design files to match .h files 2013-10-13 16:53:39 -07:00
make fx3_firmware: Updated toolchain.mk.sample for FX3 SDK v1.3.3 2015-09-08 11:31:58 -04:00
RFlink.cydsn fx3_firmware: update GPIF2 design files to match .h files 2013-10-13 16:53:39 -07:00
.cproject FX3 Firmware: Refactored build 2013-07-06 14:14:09 -07:00
.project FX3 Firmware: Refactored build 2013-07-06 14:14:09 -07:00
bladeRF.c fx3_firmware: Added "device ready" query 2014-11-06 15:25:48 -05:00
bladeRF.h fx3_firmware: Clear DMA buffers when disabling an RX or TX module 2014-07-19 13:31:13 -04:00
CHANGELOG fx3_firmware: Updated version to 1.8.1 2015-09-08 11:33:34 -04:00
CMakeLists.txt fx3_firmware: Updated version to 1.8.1 2015-09-08 11:33:34 -04:00
cyfxbladeRF.h license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
cyfxbladeRFusbdscr.c license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
cyfxgpif_C4loader.h fx3_firmware: change GPIF loader to be a 16bit wide bus 2013-10-09 01:11:07 -07:00
cyfxgpif_RFlink.h FSK bridge example 2013-02-18 20:11:39 -08:00
flash.c fx3_firmware: Addressed build warnings 2015-09-08 11:32:06 -04:00
flash.h fx3_firmware: Addressed build warnings 2015-09-08 11:32:06 -04:00
fpga.c fx3_firmware: Addressed build warnings 2015-09-08 11:32:06 -04:00
fpga.h license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
gdbinit_sample fx3_firmware: Added sample .gdbinit file 2014-11-08 15:15:06 -05:00
gpif.c fx3_firmware: Consolidated and GPIF (re)configuration in gpif.c 2014-01-13 23:14:03 -05:00
gpif.h fx3_firmware: Consolidated and GPIF (re)configuration in gpif.c 2014-01-13 23:14:03 -05:00
makefile fx3/makefile: fixup building on Windows 2013-10-09 01:11:08 -07:00
README.md fx3_firmware: Updated README 2015-01-26 13:18:19 -05:00
rf.c fx3_firmware: Addressed build warnings 2015-09-08 11:32:06 -04:00
rf.h fx3_firmware: Added support for reading back FW loopback state 2014-07-19 13:31:13 -04:00
spi_flash_lib.c license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
spi_flash_lib.h license: License changes on various portions of the codebase 2013-10-27 00:17:35 -04:00
version.h.in Added FX3 Version String 2013-10-03 22:47:33 -04:00

bladeRF FX3 Firmware Source

The FX3 firmware source is compiled for the Cypress FX3 USB 3.0 Superspeed controller. This controller converts the USB connection to a 32-bit GPIF-II programmable interface via Cypress' GPIF-II designer software.

The FX3 currently has 3 interfaces associated with it:

  • Cyclone IV FPGA Loader
  • RF Link with the LMS6002D
  • Control Interface

The FPGA loader is responsible for loading, or reloading, the FPGA over the USB link.

The RF link ushers the baseband IQ samples between the FPGA and the host over the USB link.

The control interface uses the built in UART to talk to the FPGA in an out-of-band way for checking status and configuring the system in general. Some messages that go over this are general GPIO settings, LMS SPI messages, VTCXO trim DAC settings and the Si5338 clock generator programming.

Building

Building the FX3 firmware first requires the download of the Cypress FX3 SDK which may require registration on their website. The FX3 uses ThreadX as an RTOS for the ARM9 which is distributed with their SDK and linked to from our software.

This firmware is compatible with FX3 SDK version 1.3.1. SDK 1.3.3 has not yet been tested and may require some source and build script changes.

Once the SDK is downloaded, building the firmware requires a file defining the toolchain in make/toolchain.mk. A sample can be found in the make directory.

  1. Create your own toolchain.mk file from the example given: cp make/toolchain.mk.sample make/toolchain.mk
  2. Modify your make/toolchain.mk to declare an FX3_ROOT where the SDK was installed.
  3. Create and enter a build/ directory
  4. Run cmake ../
  5. Compile the firmware via make.
  6. The file bladeRF.img should have been produced with a note saying that 256 bytes of interrupt vector code have been removed. This warning is normal and you have just built the FX3 firmware successfully!

Eclipse

The FX3 SDK provides an Eclipse-based IDE. A project file for this tool is provided in this directory. To import this project, perform the following steps.

  1. Start the Eclipse IDE provided with the FX3 SDK, navigate to your workspace, and switch to the C/C++ perspective.
  2. From the C/C++ Projects view, select Import... --> General -> Existing Projects into Workspace. Click Next >."
  3. Under Select root directory, select this directory (bladeRF/fx3_firmware)
  4. You should see bladeRF listed under Projects. Ensure this is checked and click Finish.
  5. Linux users only -- (Windows users skip this step) -- From the C/C++ Projects view, right click bladeRF and select Properties. Under C/C++ Build --> Builder Settings, uncheck Use default build command and change cs-make to make. cs-make is provided with the Windows SDK. Linux users may simply use the make program provided by their distribution.
  6. Kick off the build! The results here should be the same as those obtained from the command-line build outlined in the previous section.

For more information about developing and debugging FX3 firmware, see the FX3 Programmer's Manual.

Pre-built Firmware Binaries

Pre-built binaries are available at: http://www.nuand.com/fx3

The latest image is pointed to by: http://www.nuand.com/fx3/latest.img