meshtastic/docs/getting-started/flashing-firmware/nrf52/drag-n-drop.mdx

34 lines
2.6 KiB
Plaintext
Raw Normal View History

---
2022-10-31 21:26:19 -07:00
id: drag-n-drop
title: Drag & Drop NRF52 Firmware Updates
sidebar_label: Drag & Drop (recommended)
sidebar_position: 1
---
2021-12-07 20:50:23 -08:00
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2022-09-21 02:33:44 -07:00
:::info
Before flashing confirm that you have [RAK4631](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631/) and not a [RAK4631-R](https://docs.rakwireless.com/Product-Categories/WisBlock/RAK4631-R/) If this is not the case, fear not. The hardware is identical but requires changing the bootloader. Instructions on how to do this are located [here](/docs/getting-started/flashing-firmware/nrf52/#convert-rak4631-r-to-rak4631).
2022-09-21 02:33:44 -07:00
:::
2022-06-29 17:36:49 -07:00
2022-11-02 11:46:54 -07:00
Download and unzip the latest firmware from [Meshtastic Downloads](https://meshtastic.org/downloads).
2022-04-29 14:39:06 -07:00
2022-10-31 10:27:04 -07:00
1. Connect your device to your computer with a data USB cable.
2. Double click the reset button on your device (this will put it into bootloader mode)
3. Notice a new drive will be mounted on your computer (Windows, Mac, or Linux)
4. Open this drive and you should see three files: `CURRENT.UF2`, `INDEX.HTM`, and `INFO_UF2.TXT`
5. Drop the appropriate appropriate `firmware-DEVICE_NAME-vx.x.x-xxxxxxx.uf2` file from the release you want to install onto this drive
2021-07-15 02:29:21 -07:00
Once the file has finished copying onto the drive, the device will reboot and install the Meshtastic firmware.
:::caution
If you're upgrading your NRF52 device from a previous version of Meshtastic rather than starting from scratch, you may need to do a full factory reset of the internal flash memory. Stale data saved by previous versions of the Meshtastic firmware can cause devices to get stuck in a crash loop at startup.
:::
Meshtastic uses the [littlefs](https://github.com/littlefs-project/littlefs) library to store configuration, logs, and other data in the internal flash of NRF52 devices. Updating the firmware does _not_ erase this additional data, which can cause issues when the format and location of data changes between releases.
2022-11-02 01:49:06 -07:00
To reset the flash storage on your NRF52 board, first follow steps 1-4 above. At step 5, copy the included file named `Meshtastic_nRF52_factory_erase.uf2` onto the virtual disk device instead of a `firmware-DEVICE_NAME...` binary. After the device resets, connect to it via serial console using the [Meshtastic CLI `--noproto`](/docs/software/python/cli/#--noproto) mode or a standalone serial client like `minicom`. When you connect to the serial console, press any key; you should see the message `Formating ... Done`.
Once the flash is erased you can use steps 2-5 above to re-install the latest Meshtastic firmware on a clean storage filesystem.