The HackRF entry in the main menu switches the device from Mayhem firmware into standard HackRF mode. In this mode the PortaPack operates as a plain HackRF One, fully compatible with GNU Radio, GQRX, SDR#, and any other software that supports the HackRF via USB — without any additional flashing or modification.
Switching to HackRF mode
Select HackRF from the main menu. A confirmation dialog appears:
"This mode enables HackRF functionality. To return, press the reset button."
Select Yes to confirm. The Mayhem UI shuts down and the HackRF firmware takes over.
Note
All PortaPack inputs — the encoder dial, buttons, and touchscreen — are inactive in HackRF mode. The display shows a static block diagram at startup, and adds live values once an SDR application connects via USB.
Firmware version in HackRF mode
When in HackRF mode, hackrf_info still reports the Mayhem firmware version, for example:
─$ hackrf_info
hackrf_info version: 2024.02.1
libhackrf version: 2024.02.1 (0.9)
Found HackRF
Index: 0
Serial number: 00000000000000009xxxxxxxxxxxxxx3
Board ID Number: 2 (HackRF One)
Firmware Version: n_250606 (API:1.08)
Part ID Number: 0xa000cb3c 0x0066476c
Hardware Revision: r10
Hardware does not appear to have been manufactured by Great Scott Gadgets.
Hardware supported by installed firmware:
HackRF One
This is expected — the HackRF USB interface is provided by the Mayhem firmware image, so the version string reflects Mayhem, not the original HackRF firmware.
Driver requirements
Linux / macOS: The HackRF is supported natively by the libhackrf package. Install it via your package manager (e.g. sudo apt install hackrf, brew install hackrf) and the device will be recognized automatically.
Windows: Windows does not include a HackRF driver by default. You need to install the WinUSB driver using Zadig:
- Download and run Zadig from https://zadig.akeo.ie
- Select Options → List All Devices.
- Select HackRF One from the dropdown.
- Select WinUSB as the driver and click Install Driver or Replace Driver.
Once installed, the HackRF will be recognized by GQRX (via GNU Radio), SDR#, and hackrf_transfer.
Note
If you previously used the PortaPack with the SD-Over-USB app on Windows, a different driver may already be assigned to the device. Zadig will let you replace it.
Returning to Mayhem
To return to Mayhem firmware, press the RESET button — it is on the top of the PortaPack, the outer (right) one. See Hardware-overview for its exact location.
Note
There is no software way to exit HackRF mode. Only the RESET button will return the device to Mayhem.
Use cases
HackRF mode is useful when you need to use the HackRF with PC-based SDR software directly — for example to use GQRX or SDR# for wideband monitoring, run GNU Radio flowgraphs, or use hackrf_transfer for raw capture and replay from the command line.
To leave this mode, press the reset button. It is on the top of the PortaPack the outer (right) one.
| PortaPack in HackRF Mode | HackRF Mode connected to gqrx |
|---|---|
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Start here
Contributors
How to collaborate
Contributing Guidelines
How to ask questions correctly
Hardware
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
- Description of the hardware
- Enclosure/cases
- Repairs
- Mods
User manual
Intended use and Legality
- Usage cautions
- First steps
- Firmware update procedure
- User interface
- Powering the PortaPack
- Troubleshooting
- Won't boot
- Config Menu
- Firmware upgrade
- Diagnose firmware update in Windows
- Receive Quality Issues
- No TX/RX
- TX Carrier Only
- H2+ speaker modifications
- Dead Coin Cell Battery
- Factory Defaults
- SD card not recognized by PC with the SD-card over USB selected
- DFU overlay
- Full reset
- SolveBoard
- How to Format SDCard
- What if I don't like some of the apps
Applications
- 📥 Receivers
- 📤 Transmitters
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB
- FlipperTX
- GPS Sim
- Hopper
- Jammer
- KeeLoq TX
- Key fob TX
- LGE Tool
- MDC-1200 TX
- Morse TX
- OOK
- OOK Brute
- OOK Editor
- P25 TX
- POCSAG TX
- RDS
- RTTY TX
- SAME TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
- ▶️ Replay
- 🖲️ Remote
- 🔍 Looking Glass
- 🛠️ Utilities
- 🎮 Games
- ⚙️ Settings
- 💻 HackRF Mode
Misc
Developer Manual
- Compilation of the firmware
- Compile on WSL with ninja
- How to compile on Windows faster with WSL 2
- Using Docker and Kitematic
- Docker command-line reference
- Using Buddyworks and other CI platforms
- Notes for Buddy.Works (and other CI platforms)
- Using ARM on Debian host
- All in one script for ARM on Debian host
- Compile on Arch based distro (exclude Asahi), or other weird distros
- Dev build versions
- Notes About ccache
- Create a custom map
- Code formatting
- PR process
- Description of the Structure
- Software Dev Guides
- Tools
- Research
- UI Screenshots
- Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
- Development States Notes
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.