Updated Update firmware (markdown)

rio.whoreo 2024-08-11 10:04:34 -04:00
parent 11c477d99d
commit da6b2a5f27

@ -2,17 +2,17 @@
The basic procedure: The basic procedure:
1. Update your sdcard content. 1. Update your SD card content.
2. Update firmware, choose one method: 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. * 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] > [!Note]
>- UNDER v2.0.0 or nightly n_240114, you can only update with hackrf mode with normal procedure >- 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. >- When downgrading, please make sure SD card content versions match.
>- Mayhem firmware contains hackrf firmware. You DO NOT need to flash hackrf firmware. >- 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. >- 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 # Detailed guide
@ -31,20 +31,20 @@ The [Flash Utility](https://github.com/portapack-mayhem/mayhem-firmware/wiki/Fla
### Windows ### Windows
1. Connect the device via USB 1. Connect the device via USB.
2. Switch to HackRF mode via the on-screen option (in the PortaPack) 2. Switch to HackRF mode via the on-screen option. (In the PortaPack)
3. Double click `flash_portapack_mayhem.bat` and follow the instructions 3. Double click `flash_portapack_mayhem.bat` and follow the instructions.
4. Reboot the device 4. Reboot the device.
### Linux ### Linux
> [!NOTE] > [!NOTE]
> To Ubuntu and Mint user: Ubuntu based distro never maintains their repo for hackrf host (cli client) package. Youll face a lot of weird problems if your hackrf is R9. > To Ubuntu and Mint user: Ubuntu based distro never maintains their repo for HackRF host (cli client) package. Youll face a lot of weird problems if your HackRF is R9.
> To resolve these, please compile hackrf package yourself, or use other distro. > To resolve these, please compile the HackRF package yourself, or use another distro.
1. Connect the device via USB 1. Connect the device via USB
2. Switch to HackRF mode via the on-screen option (in the PortaPack) 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) 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 4. Reboot the device
### MacOS ### 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. 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] > [!NOTE]
> How to put into sdcard? > How to put into SD card?
> Extract the root directory of the 7z archive into the root directory of your sdcard. > 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 sdcard > - Don't put the 7z archive file directly into your SD card.
> - Don't extract into any sub-folder of sdcard > - Don't extract into any sub-folder of SD card.
> - Don't use unbranded sdcard. > - Don't use unbranded SD card.
> ![Screenshot_20240121_101958](https://github.com/portapack-mayhem/mayhem-firmware/assets/24917424/e14a2ef7-37bd-4a00-b19f-101235093e01) > ![Screenshot_20240121_101958](https://github.com/portapack-mayhem/mayhem-firmware/assets/24917424/e14a2ef7-37bd-4a00-b19f-101235093e01)