Airspy-Utils is a small software collection to help with firmware related operations on Airspy HF+ devices.

Airspy-Utils

Airspy-Utils is a small software collection to help with firmware related operations on Airspy HF+ devices on Linux (and other free systems).

Currently Supported Devices

• Airspy HF+ Discovery

This is the only Airspy device I have. Hint: Sponsorships can change this ;)

Software Requirements

• Python 3.x

• A modern Linux distribution (Ubuntu >= 20.4 is recommended)

Setup

sudo apt install bossa-cli python3-pip airspy -y

git clone https://github.com/kholia/airspy-utils.git

cd airspy-utils

pip3 install -r requirements.txt

Usage

See firmware version:

$ python3 hfplus_fw.py
R3.0.6-CD

$ python3 hfplus_fw.py  # after firmware upgrade
R3.0.7-CD

Backup calibration:

$ python3 hfplus_ppb.py -d > file

$ hexdump file
0000000 71b0 a5ca 0000 0000 0000 0000 0000 0000
0000010 0000 0000 0000 0000 0000 0000 0000 0000
*
0000100

Read calibration (ppb) value:

$ python3 hfplus_ppb.py -r
0

Write calibration (ppb) value:

python3 hfplus_ppb.py -w -p 0

Reboot device in bootloader (programming) mode:

python3 hfplus_reboot.py -b

Reboot device in normal mode:

python3 hfplus_reboot.py -n -p /dev/ttyACM0

Write the firmware (and restore the calibration):

python3 hfplus_reboot.py -b

bossac -e -b -v -p /dev/ttyACMO -w firmware.bin

python3 hfplus_reboot.py -n -p /dev/ttyACMO

python3 hfplus_ppb.py -w -p 0

References

• https://gist.github.com/jj1bdx/ce9eb3bd7320eed76396669a25f27e29

• https://airspy.com/downloads/SDRSharp_The_Guide_v3.0_ENG.pdf

• https://airspy.com/downloads/airspy-hf-flash-20200604.zip

• https://github.com/airspy/airspyhf/issues/18 ("funny" thread)

My consulting services

💚 Are you looking for commercial support with this or similar stuff? I am available over email / phone for a chat. Note: Project sponsors get access to direct support.

• Reverse-engineering, and re-implementation of custom and/or proprietary software routines.

  e.g. https://github.com/openwall/john/blob/bleeding-jumbo/src/adxcrypt_fmt_plug.c

  https://github.com/kholia/4690-OS - such is life ;)

• Solid documentation work

  I provide customers with solid documentation. Example: https://github.com/kholia/OSX-KVM

Testimonials

• https://www.whitehatsec.com/blog/cracking-aes-256-dmgs-and-epic-self-pwnage/

• https://github.com/openwall/john/graphs/contributors