Skip to content
Branch: master
Find file History
Type Name Latest commit message Commit time
Failed to load latest commit information.
blinky Add Windows build art(e|i)facts (#561) Dec 6, 2018
common Merge pull request #601 from jboone/hygiene Mar 7, 2019
hackrf_usb Merge branch 'master' into cpld_sram_load Mar 4, 2019
libopencm3 @ c9f40aa Add flash status read Sep 12, 2017
README PortaPack: Remove conditional PortaPack code. Mar 2, 2019
dfu-util.cmake Firmware: no longer require dfu-prefix Mar 22, 2018 Firmware: no longer require dfu-prefix Mar 22, 2018
toolchain-arm-cortex-m.cmake Add Windows build art(e|i)facts (#561) Dec 6, 2018


The primary firmware source code for USB HackRF devices is hackrf_usb.  Most of
the other directories contain firmware source code for test and development.
The common directory contains source code shared by multiple HackRF firmware
projects.  The cpld directory contains HDL source for the CPLD.

The firmware is set up for compilation with the GCC toolchain available here:

Required dependency:

If you are using git, the preferred way to install libopencm3 is to use the

$ cd ..
$ git submodule init
$ git submodule update

To build and install a standard firmware image for HackRF One:

$ cd hackrf_usb
$ mkdir build
$ cd build
$ cmake ..
$ make
$ hackrf_spiflash -w hackrf_usb.bin

If you have a Jawbreaker, add -DBOARD=JAWBREAKER to the cmake command.
If you have a rad1o, use -DBOARD=RAD1O instead.

It is possible to use a USB Device Firmware Upgrade (DFU) method to load
firmware into RAM.  This is normally only required to recover a device that has
had faulty firmware loaded, but it can also be useful for firmware developers.

For loading firmware into RAM with DFU you will need:

To start up HackRF One in DFU mode, hold down the DFU button while powering it
on or while pressing and releasing the RESET button.  Release the DFU button
after the 3V3 LED illuminates.

A .dfu file is built by default when building firmware.  Alternatively you can
use a known good .dfu file from a release package.  Load the firmware into RAM

$ dfu-util --device 1fc9:000c --alt 0 --download hackrf_usb.dfu

It is important to update the CPLD whenever you are updating firmware and a new
CPLD image is available.  See cpld/README for instructions.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.