Steps
-
Backup your importance files in your sdcard to a computer or somewhere safe.
-
Download the latest Nightly release from GitHub.
-
Take out your sdcard, take out your coin battery (button battery) and put them in somewhere safe and make sure they don't touch each other.
-
Following one of these ways to enter DFU mode (You may need to try one or more for success):
- holding the RESET and DFU buttons at the same time, while doing this, release RESET, and then release DFU. The LEDs should be ON, and the screen won't show anything.
- Press and holding DFU button, then plug the USB cable, then release the DFU button.
- Press and holding DFU button, then single press the knob, then release the DFU button, then plug the USB cable.
- Plug in USB. Press and hold DFU button and unplug USB. Release DFU button and plug USB back in.
-
Flash the hackrf firmware with DFU tool:
-
windows: From the release package you downloaded in step 2, double click
dfu_hackrf_one.bat
and follow the instructions. Do not disconnect or reset your PortaPack after that procedure. -
Linux/ macOS:
- Use your package manager to install
dfu-util
package, the command could besudo apt install dfu-util
orbrew install dfu-util
orpacman -Sy dfu-util
or others depnding on your distro. - Unarchive the release package you downloaded in step 2, open a terminal,
cd
into the dir you unarchived, inputdfu-util --device 1fc9:000c --download hackrf_one_usb.dfu --reset
and check if it succeed. - Do not disconnect or reset your PortaPack after that procedure.
- Use your package manager to install
-
-
Note that at this point, you had never unplugged or reboot your PortaPack. Now flash latest Mayhem firmware (which is different thing from the one we did above):
-
windows: From the release package you downloaded in step 2, double click
flash_portapack_mayhem.bat
and follow the instructions. -
Linux/ macOS:
- Use your package manager to install
hackrf
package, the command could besudo apt install hackrf
orbrew install hackrf
orpacman -Sy hackrf
or others depending on your distro. - Unarchive the latest firmware package you downloaded.
cd
to the dir which you unarchived the firmware package.- Excute
hackrf_spiflash -w ./firmware/portapack-h1_h2-mayhem.bin
- Use your package manager to install
-
-
Download the latest Nightly SDCARD contents from GitHub.
-
Unarchive the latest Nightly SDCARD contents you downloaded.
-
Format your sdcard to FAT32 format.
-
Put everything you unarchived in step 8 into your sdcard, but don't insert your sdcard yet.
-
Try Won't Boot steps if needed.
-
If everything goes well, you can power off, wait at least 1 minute, insert your sdcard, and then put the coin batter back into portapack.
-
Power on, go into
Settings
->P .Memory Mgmt
->Reset P.Mem to defaults
->YES
, Then Power off, wait at least 1 minute. -
Try Won't Boot steps again if needed (because without both sdcard and coin battery, the boot config won't be saved).
-
Boot the device, finished.
Notes
-
If your device cannot be recognized no matter whatever you do:
- Try on a Linux machine.
- Try at least 5 different cables.
-
If you are a Ubuntu or Ubuntu based user:
- Ubuntu doesn't update their
hackrf
packages in their stable repo (till 2024.Jan.02, they're still keeping 2021 version), so you might have a bunch of issues. Just don't use Ubuntu or Ubuntu based distro, or if you have to, compile the hackrf host software (not firmware) yourself.
- Ubuntu doesn't update their
-
You can try to update the Xilinx cpld on Hackrf, following this: https://github.com/portapack-mayhem/mayhem-firmware/wiki/Updating-the-Xilinx-CPLD-on-hackrf-board
-
Submit a GitHub issue if the problem you are trying to resolve still exist.
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.
How to collaborate
How to ask questions correctly
User manual
- 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
- 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
- Applications
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)
- 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
Hardware Hacks
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.