-
-
Notifications
You must be signed in to change notification settings - Fork 537
Troubleshooting
zxkmm edited this page Aug 21, 2024
·
28 revisions
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 |
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 | 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". 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) |
Something else | Check more Troubleshooting topics on the sidebar |
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.
How to collaborate
How to ask questions correctly
- First steps
- Usage cautions
- Intended use and Legality
- Features
- PortaPack Versions (which one to buy)
- HackRF Versions
- Firmware update procedure
- Description of the hardware
- User interface
- Powering the PortaPack
- Troubleshooting
- Applications
-
Compilation of the firmware
- 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)
- Dev build versions
- 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