Update firmware - portapack-mayhem/mayhem-firmware GitHub Wiki

Common workflow

  1. Update your SD card content
  2. Connect USB cable
  3. Use one of the following methods:
    • Enter HackRF mode, flash with hackrf_spiflash
    • Stay in Mayhem mode, use hackrf.app website (this automatically update external sdcard apps corresponding to the firmware version)
    • Copy firmware all in one tar package into SD card, and offline update with Flash Utility app in portapack (this automatically update external sdcard apps corresponding to the firmware version)

Detailed video guide

If you prefer watching a video guide, check this.

Detailed Firmware Update procedures

Using firmware file from github release page and the Flash Utility

  • Get the latest firmware from the GitHub release (latest by date) page

  • Copy it to your SDCARD, put it back in your PortaPack

  • Flash it via the Flash Utility in "Utilities" menu on your PortaPack

[!Note]

  • If you don't see the Flash Utility app, try using other methods to update to latest version
  • The Flash Utility can also be used to program new firmware from a bin file stored on a MicroSD card

Using firmware file from github release page and the classic hackrf_spiflash tool

[!Note] :warning: Using that method, you NEED to update the SDCARD content accordingly to the release you choose, else the external apps will not work !

Windows

  1. Connect the device via USB.
  2. Switch to HackRF mode via the on-screen option. (In the PortaPack)
  3. Double click flash_portapack_mayhem.bat and follow the instructions.
  4. Reboot the device.

Linux

  1. Connect the device via USB
  2. Switch to HackRF mode via the on-screen option. (In the PortaPack)
  3. Upload the firmware with hackrf_spiflash -w new_firmware_file.bin (eg. portapack-h1_h2-mayhem.bin for mayhem firmware or hackrf_one_usb.bin for stock HackRF firmware)
  4. Reboot the device

[!NOTE]

  • To Ubuntu and Mint user: Ubuntu based distro never maintains their repo for HackRF host (cli client) package. You’ll face a lot of weird problems if your HackRF is R9. To resolve these, please compile the HackRF package yourself, or use another distro.

MacOS

  1. If necessary, install the HackRF tools: brew install hackrf
  2. Connect the device via USB
  3. Switch to HackRF mode via the on-screen option (in the PortaPack)
  4. Upload the firmware with hackrf_spiflash -w new_firmware_file.bin
  5. Reboot the device

Update SDCARD files

You need to provide a MicroSD with enough space (16GB is recommended, over 32GB will be omitted due the limits of the FAT32). This is necessary for certain functionality, like the world map, GPS simulator, external apps, and others.

Get the latest files from the GitHub release (latest by date) page. You need to uncompress (using 7-zip) the files from mayhem_vX.Y.Z_COPY_TO_SDCARD.7z to a FAT32 formatted MicroSD card.

[!NOTE] How to put into SD card?
Extract the root directory of the 7z archive into the root directory of your SD card.

  • Don't put the 7z archive file directly into your SD card.
  • Don't extract into any sub-folder of SD card.
  • Don't use unbranded SD card.
    Screenshot_20240121_101958

Using the hackrf.app website

  • You need to use a browser compatible with Web USB Serial
  • The update using the website is only updating the firmware and external apps on the sdcard. If you want/need a full sdcard content update, please follow first the Update SDCARD files article, then update using the website

Procedure

  • Connect portapack using an USB cable with DATA enabled
  • Navigate to https://hackrf.app/
  • If never done, click on "Connect Device"

image

  • On the little pop up, select your Portapack, click 'Connect'

IMG_20241118_103143

  • You should see "HackRF Connected" on top of the page, and the Live Screen will load the first screenshot
  • Scroll down to "Manage Firmware", and click it

image

  • Choose the firmware version to install (stable, nightly, or from a custom ppfw file)

image

  • Wait for the file to be uploaded, and for your device to automatically reboot
  • Done !

Troubleshooting

  • Please check this guide
  • External apps (.ppma files in the APPS folder) will only function if their version matches the firmware version
  • Please check the FAQ
  • If your fimware version is lower or equal to v2.0.0 or nightly n_240114, you can only update firmware in HackRF mode with classic procedure
  • Updating using the hackrf.app website is only working for stable version bigger or equal to v2.0.1, nightly version newer than n_240114
  • When downgrading, please make sure SD card content versions match.
  • Mayhem firmware contains HackRF firmware. You DO NOT need to flash HackRF firmware.
  • In theory, it is impossible to brick the device, since you can always try the DFU recovery procedure. However, the updating might become fiddly in certain conditions. So you probably need basic computer usage knowledge (running/installing software, read documents, knowing USB ports, adjust system settings, reading English, etc.) if you don't, you probably should ask your friends or someone who knows these things to do it for you.