mirror of
https://github.com/greatscottgadgets/hackrf.git
synced 2026-03-06 15:30:18 +01:00
7124b7192b
During shutdown of TX or RX, the host may stop supplying or retrieving sample data some time before a stop request causes the M0 to be set back to idle mode. This makes it common for a spurious shortfall to occur during shutdown, giving the misleading impression that there has been a throughput problem. In fact, the final shortfall is simply an artifact. This commit detects when this happens, and excludes the spurious shortfall from the stats. To implement this, we back up the shortfall stats whenever a new shortfall begins. If the new shortfall later turns out to be spurious, as indicated by a transition to IDLE while it is ongoing, then we roll back the stats to their previous values. We actually only need to back up previous longest shortfall length. To get a previous shortfall count, can simply to subtract one from the current shortfall count. This change adds four cycles to the two shortfall paths - a load and store to back up the previous longest shortfall length.
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: https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads Required dependency: https://github.com/mossmann/libopencm3 If you are using git, the preferred way to install libopencm3 is to use the submodule: $ 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: http://dfu-util.sourceforge.net/ 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 with: $ dfu-util --device 1fc9:000c --alt 0 --download hackrf_usb.dfu