Table of Contents

Steps

Backup your importance files in your sdcard to a computer or somewhere safe.
Download the latest Nightly release from GitHub.
Take out your sdcard, take out your coin battery (button battery) and put them in somewhere safe and make sure they don't touch each other.
Following one of these ways to enter DFU mode (You may need to try one or more for success):
- holding the RESET and DFU buttons at the same time, while doing this, release RESET, and then release DFU. The LEDs should be ON, and the screen won't show anything.
- Press and holding DFU button, then plug the USB cable, then release the DFU button.
- Press and holding DFU button, then single press the knob, then release the DFU button, then plug the USB cable.
- Plug in USB. Press and hold DFU button and unplug USB. Release DFU button and plug USB back in.
Flash the hackrf firmware with DFU tool:
- windows: From the release package you downloaded in step 2, double click dfu_hackrf_one.bat and follow the instructions. Do not disconnect or reset your PortaPack after that procedure.
- Linux/ macOS:
  1. Use your package manager to install dfu-utilpackage, the command could be sudo apt install dfu-util or brew install dfu-util or pacman -Sy dfu-util or others depnding on your distro.
  2. Unarchive the release package you downloaded in step 2, open a terminal, cd into the dir you unarchived, input dfu-util --device 1fc9:000c --download hackrf_one_usb.dfu --reset and check if it succeed.
  3. Do not disconnect or reset your PortaPack after that procedure.
Note that at this point, you had never unplugged or reboot your PortaPack. Now flash latest Mayhem firmware (which is different thing from the one we did above):
- windows: From the release package you downloaded in step 2, double click flash_portapack_mayhem.bat and follow the instructions.
- Linux/ macOS:
  1. Use your package manager to install hackrfpackage, the command could be sudo apt install hackrf or brew install hackrf or pacman -Sy hackrf or others depending on your distro.
  2. Unarchive the latest firmware package you downloaded.
  3. cdto the dir which you unarchived the firmware package.
  4. Excute hackrf_spiflash -w ./firmware/portapack-h1_h2-mayhem.bin
Download the latest Nightly SDCARD contents from GitHub.
Unarchive the latest Nightly SDCARD contents you downloaded.
Format your sdcard to FAT32 format.
Put everything you unarchived in step 8 into your sdcard, but don't insert your sdcard yet.
Try Won't Boot steps if needed.
If everything goes well, you can power off, wait at least 1 minute, insert your sdcard, and then put the coin batter back into portapack.
Power on, go into Settings -> P .Memory Mgmt -> Reset P.Mem to defaults -> YES, Then Power off, wait at least 1 minute.
Try Won't Boot steps again if needed (because without both sdcard and coin battery, the boot config won't be saved).
Boot the device, finished.

Notes

If your device cannot be recognized no matter whatever you do:
- Try on a Linux machine.
- Try at least 5 different cables.
If you are a Ubuntu or Ubuntu based user:
- Ubuntu doesn't update their hackrfpackages in their stable repo (till 2024.Jan.02, they're still keeping 2021 version), so you might have a bunch of issues. Just don't use Ubuntu or Ubuntu based distro, or if you have to, compile the hackrf host software (not firmware) yourself.
You can try to update the Xilinx cpld on Hackrf, following this: https://github.com/portapack-mayhem/mayhem-firmware/wiki/Updating-the-Xilinx-CPLD-on-hackrf-board
Submit a GitHub issue if the problem you are trying to resolve still exist.

Start here

How to collaborate
How to ask questions correctly

User manual

First steps
- About firmwares
- Redirections on this manual/project
Usage cautions
Intended use and Legality
Features
PortaPack Versions (which one to buy)
HackRF Versions
- Original GSG HackRF One
- Clifford's-version
Firmware update procedure
- Updating the Xilinx CPLD on hackrf board
Description of the hardware
- Enclosure/cases
  - 3d printed enclosure
- Internal speaker
- SMD buttons and caps
- Encoder knob
- SMA Antenna connector
User interface
Powering the PortaPack
Troubleshooting
Applications
- Receivers
  - ADS-B
  - AFSK
  - AIS Boats
  - Analog TV
  - APRS
  - Audio
  - BLE RX
  - ERT Meter
  - Level
  - NRF
  - POCSAG
  - Radiosonde
  - Recon
  - Search
  - TPMS Cars
  - Weather/SubGhzD
  - Fox-Hunt
  - ProtoView
- Transmitters
  - ADS-B(S)
  - APRS
  - BHT Xy/EP
  - BLE TX
  - Burger Pager
  - GPS Sim
  - Jammer
  - LGE Tool
  - Morse
  - OOK
  - OOK Editor
  - POCSAG
  - RDS
  - Soundboard
  - Spectrum Painter
  - SSTV
  - TEDI/LCR
  - TouchTunes
  - BLESpam
- Capture
  - C16 Format
- Replay
- Remote
- Scanner
- Microphone Transceiver
- Looking Glass
- Utilities
- Settings
  - App Settings
  - Audio
  - Blacklist
  - Calibration
  - Touchscreen Threshold
  - Config Mode
  - Converter
  - Date/time
  - Encoder Dial
  - Freq. Correct
  - P.Mem Mgmt
  - QR code
  - Radio
  - User Interface
  - Brightness
  - Menu Color
- Debug
- HackRF Mode
- USB Serial Console

Developer Manual

Compilation of the firmware
Create a custom map
Code formatting
PR process
Description of the Structure
Software Dev Guides
- Code contribution rules
- Create a Simple App
- Building External Apps
- Widgets
- SD Card
- Access Radio Hardware
- Interpret Guru meditation crashes
- Create a Complex App
- Theme-system
- Debug via SWD & JTAG
- Debug with serial
- I2C drivers
Tools
Research
- Dissecting the Temperature Logger
- Differences between H1 and H2
UI Screenshots
Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
Development States Notes

Note

The wiki is incomplete. Please add content and collaborate.

Important

This is a public wiki. Everything is visible to everyone. Don't use it for personal notes.

Avoid linking to external tutorials/articles; they may become outdated or contain false information.