Troubleshooting - portapack-mayhem/mayhem-firmware GitHub Wiki
Troubleshooting
Something not working? Start with the FAQ and the SolveBoard quick problem → solution table — they cover most common issues. If that doesn't help, pick the matching topic below.
🔌 Boot & power
- Won't boot — blank, white or black screen, or the device won't start
- Config Menu — reach the low-level config / recovery menu
- Dead Coin Cell Battery — clock and date keep resetting: replacing the RTC coin cell
- H2+ RESET and DFU fix — repairing the reset / DFU push-buttons on H2+ boards
💾 Firmware & recovery
- Firmware upgrade — problems while updating the firmware
- Diagnose firmware update in Windows — Windows-specific update diagnosis
- DFU overlay — recover the device using the DFU overlay
- Factory Defaults — restore the default settings
- Full reset — wipe everything back to a clean state
📡 Receive & transmit
- Receive Quality Issues — weak or no reception: gain and antenna advice
- No TX/RX — no transmit or receive at all
- TX Carrier Only — only an unmodulated carrier is transmitted
💳 SD card
- How to format the SD card — correct FAT32 formatting
- SD card not recognized by PC — SD-over-USB not showing up on the computer
🔗 USB connectivity
- WebUSB serial not working (Linux) — Linux permissions / udev rules for the serial console
- USB-C port intermittent connection — connection drops when the cable moves
🧩 Apps
- What if I don't like some of the apps — hide or blacklist apps you don't want
❓ Still stuck?
Check the FAQ or report an issue on GitHub.