If the SD card is not recognized by your PC after starting SD-Over-USB, the cause is usually a wrong or missing USB driver on Windows, or simply not waiting long enough for the drive to appear.
First: wait up to 20 seconds
After pressing Run in the SD Over USB app, it can take up to 20 seconds for the drive to appear on the PC. Wait before assuming something is wrong.
Windows: wrong driver assigned
Windows sometimes assigns the HackRF's USB serial driver instead of the USB Mass Storage driver when the device switches modes. To fix this:
- Open Device Manager (right-click the Start button → Device Manager).
- Under Universal Serial Bus devices or Other devices, find the HackRF One entry.
- Right-click it and select Update driver.
- Select Browse my computer for drivers.
- Select Let me pick from a list of available drivers on my computer.
- Select USB Mass Storage Device from the list.
- Click Next and confirm.
The SD card should now appear as a removable drive in File Explorer.
Note
You may need to repeat this step after rebooting or reconnecting the device, as Windows may revert to the previous driver assignment.
Linux and macOS
On Linux and macOS, USB Mass Storage is handled natively by the kernel and no driver installation is needed. If the drive does not appear, check that the SD card is properly inserted in the PortaPack and is not corrupted. If the SD card has filesystem errors, the host OS may fail to mount it — try formatting the card as FAT32 and restoring the SD card contents from a fresh release package.
General checks
- Make sure the SD card is inserted in the PortaPack before starting the app.
- Use a USB cable that supports data transfer, not a charge-only cable.
- Try a different USB port, preferably directly on the PC rather than through a hub.
- If the drive appears but shows errors, the SD card filesystem may be corrupted — see How-to-Format-SDCard.
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.