mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-09 23:24:10 -08:00
Generalize the instructions for updating or unbricking UF2 devices
This commit is contained in:
Thomas Göttgens
parent
f41937cde9
commit
20631a7497
|
|
@ -0,0 +1,67 @@
|
|||
---
|
||||
id: update-nrf52-bootloader
|
||||
title: How to Update or Recover the Bootloader on nRF52 Devices to the Latest Version
|
||||
sidebar_label: Update nRF52 Bootloader
|
||||
sidebar_position: 5
|
||||
description: Instructions for updating or recovering the bootloader on nRF52 devices.
|
||||
---
|
||||
|
||||
If you're experiencing issues with updating or flashing newer versions of the Meshtastic firmware, and your nRF52 device is not running the latest bootloader version, updating the bootloader may resolve these problems.
|
||||
|
||||
To check which version of the bootloader your device is running, place the device into DFU mode. Then, open the mounted drive that appears on your computer and check the `INFO_UF2.TXT` file.
|
||||
|
||||
## Updating bootloader
|
||||
|
||||
Below are the steps to update your bootloader.
|
||||
|
||||
### Method 1: Using the UF2 File (Recommended)
|
||||
|
||||
Depending on your device, you need to select the correct bootloader package. Below are the links to the bootloader packages:
|
||||
|
||||
- [Lilygo T-Echo](https://github.com/meshtastic/firmware/raw/master/bin/update-lilygo_techo_bootloader-0.6.1_nosd.uf2)
|
||||
- [RAK4631](https://github.com/RAKWireless/WisBlock/raw/master/bootloader/RAK4630/Latest/wiscore_rak4631_board_bootloader-0.4.3_s140_6.1.1.uf2)
|
||||
- [Seeed Tracker 1000-E](https://github.com/adafruit/Adafruit_nRF52_Bootloader/releases/download/0.9.2/update-t1000_e_bootloader-0.9.2_nosd.uf2)
|
||||
- TBD: Generic Meshtastic for DIY
|
||||
|
||||
1. Download the correct UF2 Bootloader File.
|
||||
2. Connect your device to your computer via USB.
|
||||
3. Activate bootloader mode by quickly double pressing the RESET button on your device. For The Seeed Tracker 1000-E, you need to press-and-hold the user button and quickly connect the USB cable to the magsafe port twice. The device should appear as a removable drive on your computer.
|
||||
4. Drag and drop the UF2 file you downloaded into the removable drive. The device will automatically update the bootloader and reset.
|
||||
5. Once the device resets, the update is complete. Your device is now running the latest bootloader version and you can proceed with [flashing the firmware](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop/).
|
||||
|
||||
### Method 2: Using adafruit-nrfutil
|
||||
|
||||
:::caution
|
||||
|
||||
unlike uf2 uploads, adafruit-nrfutil does not check if you have the correct bootloader package for your device. If you flash the wrong bootloader, you may brick your device. Please also verify the SHA256 checksum before flashing.
|
||||
|
||||
:::
|
||||
|
||||
:::info
|
||||
|
||||
These instructions assume you have python and pip already installed. If you do not, please install the latest verion of python (which includes pip) from [Python.org](https://www.python.org/downloads/).
|
||||
|
||||
:::
|
||||
|
||||
Depending on your device, you need to select the correct bootloader package. Below are the links to the bootloader packages:
|
||||
|
||||
- [Lilygo T-Echo](https://github.com/meshtastic/firmware/raw/master/bin/lilygo_techo_bootloader-0.6.1.zip) SHA256: 85d8a334bbf82802d712e183f29ec5215f06786ca88914687c437aceab75d9cf
|
||||
- [RAK4631](https://github.com/RAKWireless/WisBlock/raw/master/bootloader/RAK4630/Latest/wiscore_rak4631_board_bootloader-0.4.3_s140_6.1.1.zip) SHA256: 4a216ad2be8be23b80371a11753677c850c5711d3b85129390a416fc47ea0910
|
||||
- [Seeed Tracker 1000-E](https://github.com/adafruit/Adafruit_nRF52_Bootloader/releases/download/0.9.2/t1000_e_bootloader-0.9.2_s140_7.3.0.zip) SHA256: 8c69f0d43a7aac925055451d7262682d6926d4cfb7ea8240b466dc8f16a692ba
|
||||
- TBD: Generic Meshtastic for DIY
|
||||
|
||||
1. Open a terminal or command prompt and install adafruit-nrfutil by running:
|
||||
|
||||
```bash
|
||||
pip install adafruit-nrfutil
|
||||
```
|
||||
|
||||
2. Obtain the correct zip package.
|
||||
3. Connect your device to your computer via USB.
|
||||
4. In the terminal or command prompt, navigate to the directory where you downloaded the bootloader zip package and execute the following command, replacing /dev/ttyACM0 with the correct port for your device (Windows users might use COMx):
|
||||
|
||||
```bash
|
||||
adafruit-nrfutil --verbose dfu serial --package <downloaded file>.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
||||
```
|
||||
|
||||
5. Once the process finishes, the update is complete. Your device is now running the latest bootloader version and you can proceed with [flashing the firmware](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop/).
|
||||
|
|
@ -1,49 +0,0 @@
|
|||
---
|
||||
id: update-techo-bootloader
|
||||
title: How to Update the LilyGo T-Echo Bootloader to the Latest Version
|
||||
sidebar_label: Update T-Echo Bootloader
|
||||
sidebar_position: 5
|
||||
description: Instructions for updating the T-Echo bootloader to the latest version for use with Meshtastic.
|
||||
---
|
||||
|
||||
If you're experiencing issues with updating or flashing newer versions of the Meshtastic firmware, and your LilyGo T-Echo is not running the latest bootloader version (0.6.1), updating the bootloader may resolve these problems.
|
||||
|
||||
To check which version of the bootloader your device is running, place the device into DFU mode by double-pressing the reset button. Then, open the mounted drive that appears on your computer and check the INFO_UF2.TXT file.
|
||||
|
||||
## Updating bootloader
|
||||
|
||||
Below are the steps to update your bootloader.
|
||||
|
||||
### Method 1: Using the UF2 File (Recommended)
|
||||
|
||||
1. Download the Latest UF2 Bootloader File for the T-Echo from [Github](https://github.com/meshtastic/firmware/blob/master/bin/update-lilygo_techo_bootloader-0.6.1_nosd.uf2).
|
||||
2. Connect your LilyGo T-Echo to your computer via USB.
|
||||
3. Activate bootloader mode by quickly double pressing the RESET button on your T-Echo. The device should appear as a removable drive on your computer.
|
||||
4. Drag and drop the .uf2 file you downloaded into the T-Echo's drive. The device will automatically update the bootloader and reset.
|
||||
5. Once the device resets, the update is complete. Your T-Echo is now running the latest bootloader version and you can proceed with [flashing the firmware](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop/).
|
||||
|
||||
### Method 2: Using adafruit-nrfutil
|
||||
|
||||
Should flashing the UF2 file to update your bootloader fail, you can use adafruit-nrfutil.
|
||||
|
||||
:::info
|
||||
|
||||
These instructions assume you have python and pip already installed. If you do not, please install the latest verion of python (which includes pip) from [Python.org](https://www.python.org/downloads/).
|
||||
|
||||
:::
|
||||
|
||||
1. Open a terminal or command prompt and install adafruit-nrfutil by running:
|
||||
|
||||
```bash
|
||||
pip install adafruit-nrfutil
|
||||
```
|
||||
|
||||
2. Obtain the lilygo_techo_bootloader-0.6.1.zip package from [Github](https://github.com/meshtastic/firmware/blob/master/bin/lilygo_techo_bootloader-0.6.1.zip).
|
||||
3. Connect your LilyGo T-Echo to your computer via USB.
|
||||
4. In the terminal or command prompt, navigate to the directory where you downloaded the bootloader zip package and execute the following command, replacing /dev/ttyACM0 with the correct port for your device (Windows users might use COMx):
|
||||
|
||||
```bash
|
||||
adafruit-nrfutil --verbose dfu serial --package lilygo_techo_bootloader-0.6.1.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
||||
```
|
||||
|
||||
5. Once the process finishes, the update is complete. Your T-Echo is now running the latest bootloader version and you can proceed with [flashing the firmware](/docs/getting-started/flashing-firmware/nrf52/drag-n-drop/).
|
||||
Loading…
Reference in a new issue