Firmware flashen van ESP32-apparaten
Gebruik van de Meshtastic Web Flasher
Apparaat flashen
-
Sluit uw apparaat aan
-
Bezoek flasher.meshtastic.org *vereist Chrome of Edge browser
-
Volg de instructies

Apparaat verbinden en instellen
Firmware flashen via CLI
Connectiviteitscontrole
-
Gebruik firmware-tbeam0.7-X.X.X.xxxxxxx.bin voor de T-Beam 0.7.
-
firmware-tbeam-X.X.X.xxxxxxx.bin is niet compatibel.
Command Line Interface instructies
Installeer vereiste software
Linux
python3 --version pip3 --version
|
sudo apt-get update sudo apt-get install python3
|
sudo apt-get install python3-pip
|
pip3 install --upgrade esptool
|
MacOS
brew -v
|
python3 --version pip3 --version
|
brew install python3
|
pip3 -v
|
pip3 install --upgrade esptool
|
Windows
-
Download en installeer Python. Zorg er tijdens het installatieproces voor dat u de optie Python X.Y aan PATH toevoegen selecteert.
-
Download en installeer Git Bash (of een andere geschikte shell), en voer alle volgende commando's vanuit die shell uit.
py --version pip --version
|
pip3 install --upgrade esptool
|
Controleer de connectiviteit met de chip
-
Op Linux en macOS moet u mogelijk esptool expliciet als een .py script. Gebruik het commando esptool.py chip_id doen, afhankelijk van je omgeving.
-
Op Windows moet je esptool expliciet als een .py script met het commando gebruiken esptool.py chip_id om correcte functionaliteit te garanderen.
Commando
esptool chip_id
|
Verwachte uitvoer
# Je zou een resultaat moeten zien zoals dit: mydir$ esptool chip_id esptool.py v2.6 2 seriële poorten gevonden Seriële poort /dev/ttyUSB0 Verbinden.... Chiptype detecteren... ESP32 Chip is ESP32D0WDQ6 (revisie 1) Kenmerken: WiFi, BT, Dual Core, 240MHz, VRef kalibratie in efuse, Coding Scheme None MAC: 24:6f:28:b5:36:71 Stub uploaden... Stub wordt uitgevoerd... Stub wordt uitgevoerd... Waarschuwing: ESP32 heeft geen Chip ID. Lezen MAC in plaats daarvan. MAC: 24:6f:28:b5:36:71 Hard resetten via RTS-pin...
|
Firmware downloaden
-
Navigeer naar de Meshtastic Downloads-pagina om de nieuwste firmware te verkrijgen.
-
Scroll naar beneden naar de Firmware-sectie en kies een van de volgende opties op basis van je voorkeuren:
-
Download Stable: Voor stabiele, goed geteste releases.
-
Download Alpha: Voor nieuwere, experimentele releases die de nieuwste functies bevatten.
-
Zodra je wordt doorgestuurd naar de GitHub releasepagina, scroll naar beneden naar de sectie Assets en vouw deze uit.
-
Identificeer de juiste firmware voor je apparaat op basis van de architectuur (bijv., firmware-esp32s3 voor ESP32-S3-gebaseerde apparaten zoals de Heltec V3).
-
Download het bestand en noteer de locatie op je systeem, die meestal in je ~/Downloads map.
Toegang tot de Firmwaremap
cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
|
Firmware installeren of bijwerken
Let op voordat je begint:
Linux & macOS
./device-install.sh -f firmware-BOARD-VERSION.bin
|
./device-update.sh -f firmware-BOARD-VERSION-update.bin
|
Windows
device-install.bat -f firmware-BOARD-VERSION.bin
|
device-update.bat -f firmware-BOARD-VERSION-update.bin
|
Apparaat verbinden en instellen
Flashen met een externe seriële adapter
Flashproces
-
Vanwege het aanhoudende chiptekort kunnen recent aangeschafte apparaten zoals de TTGO T-Beam zijn uitgerust met legacy of niet-standaard USB naar seriële adapterchips, die in bepaalde situaties onbetrouwbaar kunnen zijn.
-
Sommige apparaten kunnen defecte USB naar seriële chips bevatten, wat kan leiden tot communicatieproblemen.
-
Specifieke apparaten, zoals de Hydra (Meshtastic-DIY doel)
USB-seriële adapters

Adapter aansluiten op het apparaat
-
Verbind de RX-pin van de adapter met de TX-pin van het apparaat.
-
Verbind de TX-pin van de adapter met de RX-pin van het apparaat.
-
Verbind een GND-pin van de adapter met de GND-pin van het apparaat.
-
Verbind ofwel de 5V-pin van de adapter met de 5V-pin van het apparaat (zoals geïllustreerd) of de 3,3V-pin van de adapter met de 3,3V-pin van het apparaat.
-
Verbind GPIO 0 met GND op het apparaat met een jumper. (Dit zet het apparaat in flash-modus bij het inschakelen.) Voorbeeldbedrading met een T-Beam.

-
Sluit het apparaat aan op een USB-poort van de computer.
-
Verwijder de jumper die GPIO 0 met GND verbindt.

Het apparaat flashen

Problemen oplossen bij het flashen
Apparaat verbinden en instellen
nRF52 & RP2040-apparaten flashen
-
Firmware-upgradeproces voor nRF52 en RP2040-apparaten: Apparaten gebaseerd op nRF52 en RP2040 architecturen bieden een eenvoudig firmware-upgradeproces dat geen driver- of software-installatie op welk platform dan ook vereist.
-
Drag & Drop: Deze apparaten gebruiken de Drag & Drop installatiemethode voor het installeren van firmware-releases. Sleep simpelweg het firmwarebestand naar het apparaat in je bestandsverkenner.
-
Over-The-Air (OTA) Updates: nRF52-apparaten kunnen OTA firmware-updates ontvangen van een mobiel apparaat via Bluetooth, wat naadloze updates mogelijk maakt zonder fysieke verbindingen.
-
Fabriekswis: Voordat je nieuwe firmware installeert, kun je overwegen een Fabriekswis uit te voeren om bestaande data te wissen die van formaat of locatie kan veranderen tussen releases.
-
Converteer RAK4631-R naar RAK4631: Als je apparaat niet wordt geleverd met de Arduino bootloader, moet je een conversie uitvoeren om compatibiliteit te garanderen.
-
Gebruik van Raspberry Pi als SWDIO Flash Tool: Als je apparaat niet via USB of Bluetooth geflasht kan worden, is een alternatief om een directe SWDIO-verbinding te gebruiken met een Raspberry Pi als flashing tool.
Drag-en-Drop Firmware-updates voor nRF52 & RP2040
Apparaat flashen
-
Je kunt nu de Meshtastic Web Flasher gebruiken om firmware te downloaden en over te zetten naar je nRF52 of RP2040-gebaseerde apparaten. Als alternatief kun je de onderstaande instructies volgen om de firmware te downloaden en te installeren.
-
Als u onlangs een Factory Erase hebt uitgevoerd, kan uw apparaat automatisch opstarten in bootloader-modus. U kunt dan direct doorgaan naar "Kopieer het juiste firmwarebestand..." voor uw specifieke apparaat hieronder:
nRF52
-
Download en pak de nieuwste firmware uit van de Meshtastic Downloads.
-
Sluit uw apparaat met een USB-datakabel aan op uw computer.
-
Druk twee keer op de resetknop van uw apparaat (dit brengt het in bootloader-modus).
-
Er wordt een nieuwe schijf gemount op uw computer (compatibel met Windows, Mac, Linux of Android).
-
Open deze schijf, waar u drie bestanden zou moeten vinden: CURRENT.UF2, INDEX.HTM, en INFO_UF2.TXT.
-
Kopieer het juiste firmwarebestand (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) van de release-map naar deze schijf.
-
Nadat het bestand is gekopieerd, zal het apparaat herstarten en de Meshtastic-firmware installeren.
RP2040
-
Download en pak de nieuwste firmware uit van de Meshtastic Downloads.
-
Houd de BOOTSEL-knop ingedrukt en sluit vervolgens het apparaat met een USB-kabel aan op uw computer.
-
Er wordt een nieuwe schijf gemount op uw computer (compatibel met Windows, Mac, Linux of Android).
-
Open deze schijf, waar u twee bestanden zou moeten vinden: INDEX.HTM en INFO_UF2.TXT.
-
Kopieer het juiste firmwarebestand (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) van de release-map naar deze schijf.
-
Nadat het bestand is gekopieerd, zal het apparaat herstarten en de Meshtastic-firmware installeren.
Mogelijke uitzonderingen bij het flashen
-
Oudere versies van de Meshtastic firmware kunnen verouderde gegevens bevatten, wat ertoe kan leiden dat apparaten vast komen te zitten in een crashloop tijdens het opstarten. Als u problemen ondervindt bij het upgraden van uw nRF52 apparaat vanaf een eerdere versie van Meshtastic, moet u mogelijk een volledige fabrieksreset van het interne flashgeheugen uitvoeren. Volg de handleiding om uw nRF52 te wissen voordat u doorgaat met het flashen van de firmware.
Apparaat verbinden en instellen
Over-the-Air (OTA) Firmware-updates voor nRF52
Android
-
Download de firmwareversie die u wilt installeren van de Meshtastic Download Page of Meshtastic GitHub.
-
Pak de firmwaremap uit.
-
Open de nRF Connect App en selecteer CONNECT op uw apparaat vanuit het SCANNER-tabblad.
-
Als de interface DISCONNECT weergeeft in de rechterbovenhoek, ga dan verder met stap 5. Als er CONNECT staat, selecteer dan CONNECT.
-
Tik op het DFU-pictogram in de rechterbovenhoek van het scherm.
-
Controleer of "Distribution Packet (ZIP)" is geselecteerd en klik vervolgens op OK.
-
Kies het juiste apparaatfirmwarebestand (dat zal eindigen op -ota.zip).
-
De update start automatisch (houd er rekening mee dat dit proces traag kan zijn).
-
Zodra de update is voltooid, zal het apparaat automatisch opnieuw opstarten.
Apple
-
Download de firmwareversie die u wilt installeren van de Meshtastic Download Page, Meshtastic GitHub, of direct via de iOS/iPadOS-app.
-
Pak de firmwaremap uit.
-
Open de nRF DFU App en selecteer het juiste apparaatfirmwarebestand (eindigend op -ota.zip).
-
Verbind met uw apparaat.
-
Upload de firmware.
-
Ga naar instellingen en schakel "Packets Receipt Notification" in.
-
Verander "Aantal pakketten" naar een lagere waarde; sommige gebruikers hebben succes gevonden met een instelling van "5".
Fabrieksreset voor nRF52/RP2040-apparaten
-
Meshtastic maakt gebruik van de littlefs-bibliotheek om configuratie, logs en andere gegevens op te slaan in het interne flashgeheugen van nRF52- en RP2040-apparaten. Het is belangrijk op te merken dat het bijwerken van de firmware deze extra gegevens niet wist, wat problemen kan veroorzaken als het formaat en de locatie van de gegevens tussen releases veranderen.
-
U kunt nu de Meshtastic Web Flasher gebruiken om uw nRF52- of RP2040-gebaseerde apparaten fabrieksmatig te wissen. Bezoek de flasher, selecteer uw board en klik op het prullenbakpictogram rechts van de Flash-knop. Dit opent een dialoog om de wisprocedure te starten. U kunt ook de instructies hieronder volgen.
nRF52
-
Download en pak de nieuwste firmware uit op de Meshtastic Downloads-pagina.
-
Sluit uw apparaat aan op uw computer met een USB-datakabel.
-
Dubbelklik op de resetknop op uw apparaat om de bootloader-modus te activeren.
-
Er wordt een nieuwe schijf op uw computer gemount (dit geldt voor Windows, Mac of Linux).
-
Open deze schijf, en u zou drie bestanden moeten zien: CURRENT.UF2, INDEX.HTM, en INFO_UF2.TXT.
-
Open de INFO_UF2.TXT bestand in een teksteditor en noteer de SoftDevice waarde.
-
Zoek het bestand dat is opgenomen in de gedownloade firmware en dat overeenkomt met uw SoftDevice hoofdversienummer (ofwel 7.x.x of 6.x.x). Gebruik ofwel Meshtastic_nRF52_factory_erase_v3_S140_7.3.0.uf2 of Meshtastic_nRF52_factory_erase_v3_S140_6.1.0.uf2, en kopieer het naar de nieuwe schijf. Het apparaat zou dan opnieuw moeten opstarten.
-
Met de Meshtastic CLI geïnstalleerd, opent u uw Terminal of Console en voert u de opdracht in: meshtastic --noproto.
-
U zou het bericht moeten zien: Formatteren... Klaar.
RP2040
-
Download de flash_nuke.uf2 bestand naar uw computer.
-
Houd de BOOTSEL-knop ingedrukt en sluit vervolgens de board met een USB-kabel aan op uw computer.
-
De board zou nu als een mass storage-apparaat op uw computer moeten verschijnen, gelabeld als RPI-RP2.
-
Kopieer het flash_nuke.uf2-bestand naar dit apparaat.
-
De board zal automatisch opnieuw opstarten en het flashgeheugen wordt gewist.
RAK4631-R converteren naar RAK4631
USB Device Firmware Update (DFU)
-
Installeer Python
-
Installeer adafruit-nrfutil
pip3 install adafruit-nrfutil
|
-
Download de benodigde bootloader: WisCore_RAK4631_Board_Bootloader.zip.
-
Verbind je RAK-apparaat via USB met je computer.
-
Flash de bootloader.
adafruit-nrfutil --verbose dfu serial --package ./WisCore_RAK4631_Board_Bootloader.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
-
Daarna verdergaan met de reguliere flashinstructies.
Aanvullende RUI3 stappen
Seriële poort COM11 aangeraakt Seriële poort COM11 geopend Starten van DFU upgrade van type 2, SoftDevice grootte: 0, bootloader grootte: 39000, applicatie grootte: 0 Verzenden van DFU startpakket Time-out bij het wachten op bevestiging van het apparaat. Upgrade van het doelapparaat mislukt. Fout is: Geen data ontvangen op de seriële poort. Kan niet doorgaan.
|
Debugger
pip3 install pyocd
|
-
Download de benodigde bootloader: WisCore_RAK4631_Board_Bootloader.hex.
-
Sluit de RAKDAP aan zoals hieronder aangegeven:

-
Flash de bootloader
pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex |
-
Ga verder met de standaard flashinstructies.
Bootloader bijwerken of herstellen op nRF52-apparaten
Methode 1: Bijwerken met het UF2-bestand (Aanbevolen)
-
Download het juiste UF2 Bootloader-bestand.
-
Sluit uw apparaat met een USB-kabel aan op uw computer.
-
Activeer de bootloadermodus door snel de RESET-knop op uw apparaat tweemaal achter elkaar in te drukken. Voor de Seeed Tracker 1000-E houdt u de gebruikersknop ingedrukt en sluit u vervolgens snel de USB-kabel twee keer aan op de MagSafe-poort. Het apparaat zou als een verwijderbare schijf op uw computer moeten verschijnen.
-
Sleep het UF2-bestand dat u hebt gedownload naar de verwijderbare schijf. Het apparaat zal automatisch de bootloader bijwerken en opnieuw opstarten.
-
Zodra het apparaat opnieuw opstart, is de update voltooid. Uw apparaat werkt nu met de laatste bootloaderversie en u kunt doorgaan met het flashen van de firmware.
Methode 2: Gebruik van adafruit-nrfutil
-
Lilygo T-Echo SHA256: 85d8a334bbf82802d712e183f29ec5215f06786ca88914687c437aceab75d9cf
-
RAK4631 SHA256: 4a216ad2be8be23b80371a11753677c850c5711d3b85129390a416fc47ea0910
-
Seeed Tracker 1000-E SHA256: 8c69f0d43a7aac925055451d7262682d6926d4cfb7ea8240b466dc8f16a692ba
-
Generic Meshtastic 6.1.1 for DIY SHA256: ecebecea849ab79d09517dd4f6ff98de5647fe275b0b4d525501e6c29cb5a586
-
Generic Meshtastic 7.3.0 for DIY SHA256: 9a38edf4e974a6f705c41b296499a4fc57682ec9bb686eecd9f3d8d02fc6ffcf
-
Open een terminal of opdrachtprompt en installeer adafruit-nrfutil door het volgende commando uit te voeren:
pip install adafruit-nrfutil |
-
Verkrijg het juiste ZIP-pakket.
-
Sluit uw apparaat met een USB-kabel aan op uw computer.
-
Navigeer in de terminal of opdrachtprompt naar de map waar u het bootloader ZIP-pakket hebt gedownload en voer het volgende commando uit. Zorg ervoor dat u /dev/ttyACM0 vervangt door de juiste poort voor uw apparaat (Windows-gebruikers kunnen COMx gebruiken):
adafruit-nrfutil --singlebank --touch 1200 --verbose dfu serial --package
|
-
Zodra het proces is voltooid, is de update afgerond. Uw apparaat werkt nu met de nieuwste bootloader-versie, waardoor u kunt doorgaan met het flashen van de firmware.
Methode 3: Gebruik van een Debugger
SWDIO gebruiken voor flashen met een Raspberry Pi
Bedrading instellen
Installeer OpenOCD-software
$ sudo apt update $ sudo apt install libtool autoconf automake texinfo telnet gdb-multiarch git $ git clone git://repo.or.cz/openocd.git $ cd openocd/ $ ./bootstrap $ ./configure --enable-bcm2835gpio $ make -j4 $ sudo make install
|
Verbinding controleren
$ openocd -f ./openocd/tcl/interface/raspberrypi-native.cfg -c "transport select swd" -f openocd/tcl/target/nrf52.cfg -s tcl
|
Open On-Chip Debugger 0.12.0+dev-00633-gad87fbd1c Gelicenseerd onder GNU GPL v2 Voor bugrapporten, lees http://openocd.org/doc/doxygen/bugs.html srst_only separate srst_gates_jtag srst_push_pull connect_deassert_srst swd Info : Luistert op poort 6666 voor tcl-verbindingen Info : Luistert op poort 4444 voor telnet-verbindingen Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : kloksnelheid 100 kHz Info : SWD DPIDR 0x2ba01477 Info : [nrf52.cpu] Cortex-M4 r0p1 processor gedetecteerd Info : [nrf52.cpu] doel heeft 6 breakpoints, 4 watchpoints Info : [nrf52.cpu] Onderzoek geslaagd Info : [nrf52.cpu] start gdb-server op 3333 Info : Luistert op poort 3333 voor gdb-verbindingen Info : accepteert 'telnet' verbinding op tcp/4444
|
Firmware downloaden
Firmware flashen
$ telnet 127.0.0.1 4444 Bezig met verbinden met 127.0.0.1... Verbonden met 127.0.0.1. Escape-teken is '^]'. Open On-Chip Debugger > init > reset init > halt > nrf5 mass_erase > program firmware.hex verify > reset > exit 0
|
Verbinding maken