Table of Contents

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.

Troubleshooting articles

SolveBoard

Problem	Solution
Does not boot / white screen / black screen	Check Won't boot and Config Menu.
Only turn on once after flashing	Flashing with DFU only make the firmware go to RAM. You need to flash to the SPI flash once again(with regular flash methods)
Crash / Guru Meditation.	Try Full reset. If still does not work, try Updating the Xilinx CPLD on hackrf board. If nothing works, report an issue on GitHub.
Freeze when launch specific app (but no crash or Guru Meditation)	It's mostly from power part. Try: -Full charge -Change battery -Plug into a reliable power source -Change battery -Change at least 5 cables -Remove addon board if plugged in
No splash screen / No time & date / Touchscreen does not work / Status bar icon disappeared / Backlight timeout abnormal / Encoder dial abnormal	Check settings.
It says xxx missing / can't find xxx / xxx read error / xxx is outdated / xxx empty or you can't see xxx.	Make sure sdcard contents matches your firmware version.
Apps are missing or greyed out after upgrading.	Make sure sdcard contents matches your firmware version, particularly the external APPS folder, and make sure you correctly put the sdcard contents.
`hackrf_info` says `Hardware does not appear to have been manufactured by Great Scott Gadgets`	It's because you have a Hackrf clone instead of original from GSG. If you believe it's a mistake, contact the seller or GSG official support.
Unexpected spike on my waterfall / IQ / spectrum.	It's either a DC offset or noise from power. For reducing the noise, try using the internal battery. For DC offset, there's nothing you can do, however it’s normal on SDR.
My computer can't see my HackRF	Try at least 5 different cables. If you are on Windows, try to install drivers in release package. Also try your luck with Zadig. If not working, try on a Linux machine (exclude Ubuntu)
My sound board app can't see the files i putted in, but my fileman app can	folow Soundboard to make correct file
Screen went black when transmit / replay	Check Stealth Mode
Fail / freeze when recording / Can't see files even if I correctly put sdcard content	Make sure your sdcard is FAT32 format, and make sure it’s a branded one with acceptable quality
My GPS-Simulation Doesn't work. / My bluetooth doesn't work.	Most modern devices use cellular to verify GPS. Make sure your devicce is vuln to gps-sim. Go to Settings - Radio, and make sure the "Reference Source" says "External" or “portapack”. If not, then check the last checkbox and see if it's getting better.
Charging is very slow	Check the following things: - Try at least 5 cables. - Use a good adapter, for example a 5V1A branded adapter - Don't use computer or laptop or similar thing to charge.
How to turn on/off	One of these may turn on and another may turn off: - Single press the knob - Double press the knob - Long press the knob - Plug in USB cable - Unplug USB cable
Replay app show empty list	You didn't press correct button. Check wiki
Issues related to sdcard	- use BRANDED sdcard from reliable seller. - Use FAT32 format - correctly put sdcard content which matches your firmware versions
DFU suffix CRC doesn’t match / Cannot open DFU device	If you are on Windows, try to install drivers in release package. Also try your luck with Zadig. If not working, try on a Linux machine (exclude Ubuntu)
Screen backlight never turned off automatically even I correctly set the timeout count	Auto set threshold, follow this: https://github.com/portapack-mayhem/mayhem-firmware/wiki/Settings#touchscreen-threshold
Issue that related to dial/knob/encoder	Go to setting, try all the dial sensitivity and rate multiplier
”FLASH ERR” on my screen	It means you didn’t correct flash the firmware, for example you unplugged your device when it’s still flashing the firmware. If you are sure you did all thing correct but it still says that, then your SPI flash on your hacked board maybe broken.
Something else	Check more Troubleshooting topics on the sidebar

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

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 Connector replacement or removal
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

Hardware Hacks

Repairs
- Replace AMP
Mods
- Add GPIO TO H2
- USB‐C charging modification for older HackRF boards

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.