mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-09 23:24:10 -08:00
Merge branch 'master' into reduce-text-and-image-spacing
This commit is contained in:
pdxlocations
GitHub
commit
d37537f099
|
|
@ -11,7 +11,7 @@ import Link from "@docusaurus/Link";
|
|||
Meshtastic uses the [littlefs](https://github.com/littlefs-project/littlefs) library to store configuration, logs, and other data in the internal flash of nRF52 & RP2040 devices. Updating the firmware does _not_ erase this additional data, which can cause issues when the format and location of data changes between releases.
|
||||
|
||||
:::info
|
||||
You may now use the [Meshtastic Web Flasher](https://flasher.meshtastic.org) to Factory Erase your nRF52 or RP2040-based devices. Visit the flasher, select your board, and click the trash can icon to the right of the Flash button. This will open a dialogue to begin the erase procedure.
|
||||
You may now use the [Meshtastic Web Flasher](https://flasher.meshtastic.org) to Factory Erase your nRF52 or RP2040-based devices. Visit the flasher, select your board, and click the trash can icon to the right of the Flash button. This will open a dialogue to begin the erase procedure.
|
||||
|
||||
Alternatively, follow the instructions below.
|
||||
:::
|
||||
|
|
@ -25,9 +25,10 @@ To reset the flash storage on your nRF52 board:
|
|||
3. Double click the reset button on your device (this will put it into bootloader mode)
|
||||
4. Notice a new drive will be mounted on your computer (Windows, Mac, or Linux)
|
||||
5. Open this drive and you should see three files: `CURRENT.UF2`, `INDEX.HTM`, and `INFO_UF2.TXT`
|
||||
6. Find the file included in the downloaded firmware named `Meshtastic_nRF52_factory_erase.uf2` and copy it onto the new drive. The device should reboot.
|
||||
7. With the [Meshtastic CLI](/docs/software/python/cli/) installed, open your Terminal/Console and enter the command: `meshtastic --noproto`.
|
||||
8. Press any key, you should see the message: `Formatting... Done`.
|
||||
6. Open the `INFO_UF2.TXT` file with a text editor and note the `SoftDevice` value.
|
||||
7. Find the file included in the downloaded firmware matching your softdevice major version number (7.x.x or 6.x.x). Either use `Meshtastic_nRF52_factory_erase_v3_S140_7.3.0.uf2` or `Meshtastic_nRF52_factory_erase_v3_S140_6.3.0.uf2` and copy it onto the new drive. The device should reboot.
|
||||
8. With the [Meshtastic CLI](/docs/software/python/cli/) installed, open your Terminal/Console and enter the command: `meshtastic --noproto`.
|
||||
9. You should see the message: `Formatting... Done`.
|
||||
|
||||
Once the device has been erased, you can proceed to install the latest Meshtastic firmware on a clean storage filesystem by clicking the link below.
|
||||
|
||||
|
|
@ -41,7 +42,6 @@ To reset the flash storage on your RP2040 board:
|
|||
4. Copy the flash_nuke.uf2 file to the device.
|
||||
5. The board will now restart and the flash memory will be erased.
|
||||
|
||||
|
||||
Once the device has been erased, you can proceed to install the latest Meshtastic firmware on a clean storage filesystem by clicking the link below.
|
||||
|
||||
<div className="indexCtasBody">
|
||||
|
|
|
|||
|
|
@ -0,0 +1,69 @@
|
|||
---
|
||||
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)
|
||||
- [Generic Meshtastic 6.1.1 for DIY](https://github.com/meshtastic/firmware/raw/master/bin/generic/Meshtastic_6.1.0_bootloader-0.9.2_s140_6.1.1.zip)
|
||||
- [Generic Meshtastic 7.3.0 for DIY](https://github.com/meshtastic/firmware/raw/master/bin/generic/Meshtastic_7.3.0_bootloader-0.9.2_s140_7.3.0.zip)
|
||||
|
||||
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
|
||||
- [Generic Meshtastic 6.1.1 for DIY](https://github.com/meshtastic/firmware/raw/master/bin/generic/update-Meshtastic_6.1.0_bootloader-0.9.2_nosd.uf2) SHA256: 069791053d21e73115d917110aaa09605945f4130d8febc038c902ed40b0822a
|
||||
- [Generic Meshtastic 7.3.0 for DIY](https://github.com/meshtastic/firmware/raw/master/bin/generic/update-Meshtastic_7.3.0_bootloader-0.9.2_nosd.uf2) SHA256: a3bea38a522e3707b90b387449b4d051abfd80bd43a69fc4db75002c0fe57268
|
||||
|
||||
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