TheArchive/mayhem-firmware
1
0
Fork 0
mirror of https://github.com/portapack-mayhem/mayhem-firmware.git synced 2024-11-23 18:15:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated Update firmware (markdown)

rio.whoreo 2024-08-11 10:04:34 -04:00
parent 11c477d99d
commit da6b2a5f27
1 changed files with 20 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Update-firmware.md

@ -2,17 +2,17 @@
The basic procedure:
1. Update your sdcard content.
1. Update your SD card content.
2. Update firmware, choose one method:
* Enter HackRF mode, flash with a usb cable.
* Enter HackRF mode, flash with a USB cable.
* Use [hackrf.app](https://hackrf.app/) website.
* Copy firmware all in one tar package into sdcard, and offline update with Flash Utility app in portapack.
* Copy firmware all in one tar package into SD card, and offline update with Flash Utility app in portapack.
> [!Note]
>- UNDER v2.0.0 or nightly n_240114, you can only update with hackrf mode with normal procedure
>- When downgrading, please make sure sdcard content versions match.
>- Mayhem firmware contains hackrf firmware. You DO NOT need to flash hackrf firmware.
>- In theory, it is impossible to brick the device, since you can always try the DFU recovery procedure. However, the updating might become fiddly in certain conditions. So you probably need basic computer usage knowledge (running/installing software, read documents, knowing USB ports, adjust system settings, reading English, etc.) if you don't, you probably should ask your friends or someone who knows these to do for you.
>- UNDER v2.0.0 or nightly n_240114, you can only update with HackRF mode with normal procedure
>- When downgrading, please make sure SD card content versions match.
>- Mayhem firmware contains HackRF firmware. You DO NOT need to flash HackRF firmware.
>- In theory, it is impossible to brick the device, since you can always try the DFU recovery procedure. However, the updating might become fiddly in certain conditions. So you probably need basic computer usage knowledge (running/installing software, read documents, knowing USB ports, adjust system settings, reading English, etc.) if you don't, you probably should ask your friends or someone who knows these things to do it for you.
# Detailed guide
@ -31,20 +31,20 @@ The [Flash Utility](https://github.com/portapack-mayhem/mayhem-firmware/wiki/Fla
### Windows
1. Connect the device via USB
2. Switch to HackRF mode via the on-screen option (in the PortaPack)
3. Double click `flash_portapack_mayhem.bat` and follow the instructions
4. Reboot the device
1. Connect the device via USB.
2. Switch to HackRF mode via the on-screen option. (In the PortaPack)
3. Double click `flash_portapack_mayhem.bat` and follow the instructions.
4. Reboot the device.
### Linux
> [!NOTE]
> To Ubuntu and Mint user: Ubuntu based distro never maintains their repo for hackrf host (cli client) package. You’ll face a lot of weird problems if your hackrf is R9.
> To resolve these, please compile hackrf package yourself, or use other distro.
> To Ubuntu and Mint user: Ubuntu based distro never maintains their repo for HackRF host (cli client) package. You’ll face a lot of weird problems if your HackRF is R9.
> To resolve these, please compile the HackRF package yourself, or use another distro.
1. Connect the device via USB
2. Switch to HackRF mode via the on-screen option (in the PortaPack)
3. Upload the firmware with `hackrf_spiflash -w new_firmware_file.bin` (eg. portapack-h1_h2-mayhem.bin for mayhem firmware or hackrf_one_usb.bin for stock hackrf firmware)
2. Switch to HackRF mode via the on-screen option. (In the PortaPack)
3. Upload the firmware with `hackrf_spiflash -w new_firmware_file.bin` (eg. portapack-h1_h2-mayhem.bin for mayhem firmware or hackrf_one_usb.bin for stock HackRF firmware)
4. Reboot the device
### MacOS
@ -63,11 +63,11 @@ You need to provide a MicroSD with enough space (16GB is recommended, over 32GB
Get the latest files from the [![GitHub release (latest by date)](https://img.shields.io/github/v/release/portapack-mayhem/mayhem-firmware?label=Releases&style=social)](https://github.com/portapack-mayhem/mayhem-firmware/releases/latest) page. You need to uncompress (using [7-zip](https://www.7-zip.org/download.html)) the files from `mayhem_vX.Y.Z_COPY_TO_SDCARD.7z` to a FAT32 formatted MicroSD card.
> [!NOTE]
> How to put into sdcard?
> Extract the root directory of the 7z archive into the root directory of your sdcard.
> - Don't put the 7z archive file directly into your sdcard
> - Don't extract into any sub-folder of sdcard
> - Don't use unbranded sdcard.
> How to put into SD card?
> Extract the root directory of the 7z archive into the root directory of your SD card.
> - Don't put the 7z archive file directly into your SD card.
> - Don't extract into any sub-folder of SD card.
> - Don't use unbranded SD card.
> ![Screenshot_20240121_101958](https://github.com/portapack-mayhem/mayhem-firmware/assets/24917424/e14a2ef7-37bd-4a00-b19f-101235093e01)