ESP32-Geräte flashen
Verwendung des Meshtastic Web Flashers
Gerät flashen
-
Schließen Sie Ihr Gerät an
-
Besuchen Sie flasher.meshtastic.org *erfordert Chrome- oder Edge-Browser
-
Folgen Sie den Anweisungen

Gerät verbinden und einrichten
Firmware über CLI flashen
Verbindungsüberprüfung
-
Verwenden Sie firmware-tbeam0.7-X.X.X.xxxxxxx.bin für das T-Beam 0.7.
-
firmware-tbeam-X.X.X.xxxxxxx.bin ist nicht kompatibel.
Anweisungen für die Befehlszeilenschnittstelle
Installieren Sie erforderliche 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
-
Laden Sie Python herunter und installieren Sie es. Stellen Sie während der Installation sicher, dass Sie die Option Python X.Y zum PATH hinzufügen auswählen.
-
Laden Sie Git Bash (oder eine andere geeignete Shell) herunter und installieren Sie es, und führen Sie alle nachfolgenden Befehle von dieser Shell aus.
py --version pip --version
|
pip3 install --upgrade esptool
|
Überprüfen Sie die Konnektivität mit dem Chip
-
Unter Linux und macOS müssen Sie möglicherweise esptool explizit als .py Skript. Verwenden Sie den Befehl esptool.py chip_id abhängig von Ihrer Umgebung tun.
-
Unter Windows müssen Sie esptool ausdrücklich als .py Skript mit dem Befehl verwenden esptool.py chip_id um eine ordnungsgemäße Funktion sicherzustellen.
Befehl
esptool chip_id
|
Erwartete Ausgabe
# Sie sollten ein ähnliches Ergebnis sehen: mydir$ esptool chip_id esptool.py v2.6 2 serielle Ports gefunden Serieller Port /dev/ttyUSB0 Verbindung wird hergestellt.... Chip-Typ wird erkannt... ESP32 Chip ist ESP32D0WDQ6 (Revision 1) Funktionen: WiFi, BT, Dual Core, 240MHz, VRef-Kalibrierung im efuse, Codierungsschema Keine MAC: 24:6f:28:b5:36:71 Stub wird hochgeladen... Stub wird ausgeführt... Stub läuft... Warnung: ESP32 hat keine Chip-ID. Lesen Stattdessen MAC. MAC: 24:6f:28:b5:36:71 Hard-Reset über RTS-Pin...
|
Firmware herunterladen
-
Navigieren Sie zur Meshtastic Downloads-Seite, um die neueste Firmware zu erhalten.
-
Scrollen Sie nach unten zum Abschnitt Firmware und wählen Sie eine der folgenden Optionen basierend auf Ihren Präferenzen:
-
Stabile Version herunterladen: Für stabile, gut getestete Versionen.
-
Alpha herunterladen: Für neuere, experimentelle Versionen, die die neuesten Funktionen enthalten.
-
Sobald Sie zur GitHub Release-Seite weitergeleitet werden, scrollen Sie nach unten zum Abschnitt Assets und klappen Sie ihn aus.
-
Identifizieren Sie die passende Firmware für Ihr Gerät entsprechend seiner Architektur (z. B. firmware-esp32s3 für ESP32-S3-basierte Geräte wie das Heltec V3).
-
Laden Sie die Datei herunter und notieren Sie sich den Speicherort auf Ihrem System, der sich typischerweise in Ihrem ~/Downloads Ordners.
Zugriff auf das Firmware-Verzeichnis
cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
|
Firmware installieren oder aktualisieren
Bitte beachten Sie vor Beginn:
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
|
Gerät verbinden und einrichten
Flashen mit einem externen seriellen Adapter
Flash-Vorgang
-
Aufgrund des anhaltenden Chipmangels können kürzlich erworbene Geräte wie das TTGO T-Beam mit veralteten oder nicht standardmäßigen USB-zu-Seriell-Adapterchips ausgestattet sein, die in bestimmten Situationen unzuverlässig sein können.
-
Einige Geräte können defekte USB-zu-Seriell-Chips aufweisen, was zu Kommunikationsproblemen führt.
-
Spezifische Geräte, wie das Hydra (Meshtastic-DIY-Ziel)
USB-Seriell-Adapter

Adapter mit dem Gerät verbinden
-
Verbinden Sie den RX-Pin des Adapters mit dem TX-Pin des Geräts.
-
Verbinden Sie den TX-Pin des Adapters mit dem RX-Pin des Geräts.
-
Verbinden Sie einen GND-Pin des Adapters mit dem GND-Pin des Geräts.
-
Verbinden Sie entweder den 5V-Pin des Adapters mit dem 5V-Pin des Geräts (wie dargestellt) oder den 3,3V-Pin des Adapters mit dem 3,3V-Pin des Geräts.
-
Verbinden Sie GPIO 0 mit GND am Gerät mit einem Jumper. (Dies versetzt das Gerät beim Einschalten in den Flash-Modus.) Beispielverkabelung mit einem T-Beam.

-
Verbinden Sie das Gerät mit einem USB-Anschluss am Computer.
-
Entfernen Sie den Jumper, der GPIO 0 mit GND verbindet.

Gerät flashen

Fehlerbehebung beim Flash-Vorgang
Gerät verbinden und einrichten
Flashen von nRF52 & RP2040 Geräten
-
Firmware-Upgrade-Prozess für nRF52- und RP2040-Geräte: Geräte basierend auf nRF52 und RP2040 Architekturen bieten einen einfachen Firmware-Upgrade-Prozess, der keine Treiber- oder Softwareinstallation auf irgendeiner Plattform erfordert.
-
Drag & Drop: Diese Geräte verwenden die Drag & Drop-Installationsmethode zur Installation von Firmware-Releases. Ziehen Sie einfach die Firmware-Datei im Dateiexplorer auf das Gerät.
-
Over-The-Air (OTA) Updates: nRF52-Geräte können OTA-Firmware-Updates von einem mobilen Gerät über Bluetooth empfangen, was nahtlose Updates ohne physische Verbindungen ermöglicht.
-
Werkslöschung: Vor der Installation neuer Firmware sollten Sie eine Werkslöschung in Betracht ziehen, um vorhandene Daten zu löschen, die sich zwischen den Versionen in Format oder Speicherort ändern können.
-
Umwandlung von RAK4631-R zu RAK4631: Wenn Ihr Gerät nicht mit dem Arduino-Bootloader geliefert wird, müssen Sie eine Umwandlung durchführen, um die Kompatibilität sicherzustellen.
-
Verwendung eines Raspberry Pi als SWDIO-Flash-Tool: Wenn Ihr Gerät nicht über USB oder Bluetooth geflasht werden kann, ist eine alternative Möglichkeit die direkte SWDIO-Verbindung mit einem Raspberry Pi als Flash-Tool.
Drag-and-Drop Firmware-Updates für nRF52 & RP2040
Gerät flashen
-
Sie können jetzt den Meshtastic Web Flasher verwenden, um Firmware auf Ihre nRF52 oder RP2040-basierten Geräte herunterzuladen und zu übertragen. Alternativ können Sie den untenstehenden Anweisungen folgen, um die Firmware herunterzuladen und zu installieren.
-
Wenn Sie kürzlich eine Factory Erase durchgeführt haben, startet Ihr Gerät möglicherweise automatisch im Bootloader-Modus. Sie können dann direkt mit "Kopieren Sie die entsprechende Firmware..." für Ihr spezifisches Gerät unten fortfahren:
nRF52
-
Laden Sie die neueste Firmware von den Meshtastic Downloads herunter und entpacken Sie sie.
-
Verbinden Sie Ihr Gerät mit Ihrem Computer über ein USB-Datenkabel.
-
Drücken Sie zweimal die Reset-Taste an Ihrem Gerät (dadurch wird der Bootloader-Modus aktiviert).
-
Ein neues Laufwerk wird auf Ihrem Computer eingebunden (kompatibel mit Windows, Mac, Linux oder Android).
-
Öffnen Sie dieses Laufwerk, wo Sie drei Dateien finden sollten: CURRENT.UF2, INDEX.HTM, und INFO_UF2.TXT.
-
Kopieren Sie die entsprechende Firmware-Datei (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) aus dem Release-Ordner auf dieses Laufwerk.
-
Nachdem die Datei kopiert wurde, wird das Gerät neu starten und die Meshtastic-Firmware installieren.
RP2040
-
Laden Sie die neueste Firmware von den Meshtastic Downloads herunter und entpacken Sie sie.
-
Drücken und halten Sie die BOOTSEL-Taste, verbinden Sie dann das Gerät mit Ihrem Computer über ein USB-Kabel.
-
Ein neues Laufwerk wird auf Ihrem Computer eingebunden (kompatibel mit Windows, Mac, Linux oder Android).
-
Öffnen Sie dieses Laufwerk, wo Sie zwei Dateien finden sollten: INDEX.HTM und INFO_UF2.TXT.
-
Kopieren Sie die entsprechende Firmware-Datei (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) aus dem Release-Ordner auf dieses Laufwerk.
-
Nachdem die Datei kopiert wurde, wird das Gerät neu starten und die Meshtastic-Firmware installieren.
Mögliche Flashing-Sonderfälle
-
Ältere Versionen der Meshtastic firmware können veraltete Daten enthalten, die dazu führen können, dass Geräte beim Start in einer Absturzschleife gefangen sind. Wenn Sie Probleme beim Upgrade Ihres nRF52-Geräts von einer früheren Version von Meshtastic haben, müssen Sie möglicherweise einen vollständigen Werksreset des internen Flash-Speichers durchführen. Bitte folgen Sie der Anleitung zum Zurücksetzen Ihres nRF52 auf Werkseinstellungen, bevor Sie mit dem Flashen der Firmware fortfahren.
Gerät verbinden und einrichten
Over-the-Air (OTA) Firmware-Updates für nRF52
Android
-
Laden Sie die Firmware-Version, die Sie installieren möchten, von der Meshtastic Download Page oder Meshtastic GitHub herunter.
-
Entpacken Sie den Firmware-Ordner.
-
Öffnen Sie die nRF Connect App und wählen Sie CONNECT für Ihr Gerät im SCANNER-Tab.
-
Wenn in der Schnittstelle oben rechts DISCONNECT angezeigt wird, fahren Sie mit Schritt 5 fort. Wenn CONNECT angezeigt wird, wählen Sie CONNECT.
-
Tippen Sie auf das DFU-Symbol oben rechts auf dem Bildschirm.
-
Vergewissern Sie sich, dass "Distribution Packet (ZIP)" ausgewählt ist, und bestätigen Sie mit OK.
-
Wählen Sie die passende Geräte-Firmware-Datei aus (endet mit -ota.zip).
-
Das Update startet automatisch (beachten Sie, dass dieser Vorgang langsam sein kann).
-
Sobald das Update abgeschlossen ist, startet das Gerät automatisch neu.
Apple
-
Laden Sie die Firmware-Version, die Sie installieren möchten, von der Meshtastic Download Page, Meshtastic GitHub oder direkt über die iOS/iPadOS-App herunter.
-
Entpacken Sie den Firmware-Ordner.
-
Öffnen Sie die nRF DFU App und wählen Sie die richtige Geräte-Firmware-Datei aus (endet mit -ota.zip).
-
Verbinden Sie sich mit Ihrem Gerät.
-
Laden Sie die Firmware hoch.
-
Gehen Sie zu den Einstellungen und aktivieren Sie "Packets Receipt Notification."
-
Ändern Sie "Anzahl der Pakete" auf einen niedrigeren Wert; einige Benutzer hatten Erfolg mit der Einstellung "5".
Werkseinstellung für nRF52/RP2040-Geräte
-
Meshtastic verwendet die littlefs-Bibliothek, um Konfigurationen, Protokolle und andere Daten im internen Flash-Speicher von nRF52- und RP2040-Geräten zu speichern. Es ist wichtig zu beachten, dass ein Firmware-Update diese zusätzlichen Daten nicht löscht, was zu Problemen führen kann, wenn sich das Format und der Speicherort der Daten zwischen den Versionen ändern.
-
Sie können jetzt den Meshtastic Web Flasher verwenden, um Ihre nRF52- oder RP2040-basierten Geräte auf Werkseinstellungen zurückzusetzen. Besuchen Sie den Flasher, wählen Sie Ihr Board aus und klicken Sie auf das Mülleimer-Symbol rechts neben der Flash-Schaltfläche. Dadurch wird ein Dialog geöffnet, um das Löschverfahren zu starten. Alternativ können Sie den untenstehenden Anweisungen folgen.
nRF52
-
Laden Sie die neueste Firmware von der Meshtastic Downloads page herunter und entpacken Sie sie.
-
Verbinden Sie Ihr Gerät mit einem USB-Datenkabel mit Ihrem Computer.
-
Doppelklicken Sie auf die Reset-Taste an Ihrem Gerät, um den Bootloader-Modus zu starten.
-
Ein neues Laufwerk wird auf Ihrem Computer eingebunden (dies gilt für Windows, Mac oder Linux).
-
Öffnen Sie dieses Laufwerk, und Sie sollten drei Dateien sehen: CURRENT.UF2, INDEX.HTM, und INFO_UF2.TXT.
-
Öffnen Sie die INFO_UF2.TXT Datei in einem Texteditor und notieren Sie die SoftDevice Wert.
-
Suchen Sie die Datei in der heruntergeladenen Firmware, die mit Ihrer SoftDevice-Hauptversionsnummer übereinstimmt (entweder 7.x.x oder 6.x.x). Verwenden Sie entweder Meshtastic_nRF52_factory_erase_v3_S140_7.3.0.uf2 oder Meshtastic_nRF52_factory_erase_v3_S140_6.1.0.uf2, und kopieren Sie es auf das neue Laufwerk. Das Gerät sollte dann neu starten.
-
Mit dem installierten Meshtastic CLI öffnen Sie Ihr Terminal oder Ihre Konsole und geben den Befehl ein: meshtastic --noproto.
-
Sie sollten die Meldung sehen: Formatierung... Fertig.
RP2040
-
Herunterladen flash_nuke.uf2 Datei auf Ihren Computer.
-
Drücken und halten Sie die BOOTSEL-Taste, und verbinden Sie dann das Board mit einem USB-Kabel mit Ihrem Computer.
-
Das Board sollte nun als Massenspeichergerät auf Ihrem Computer erscheinen, mit der Bezeichnung RPI-RP2.
-
Kopieren Sie die flash_nuke.uf2-Datei auf dieses Gerät.
-
Das Board startet automatisch neu und der Flash-Speicher wird gelöscht.
Konvertierung von RAK4631-R zu RAK4631
USB Device Firmware Update (DFU)
-
Installieren Sie Python
-
Installieren Sie adafruit-nrfutil
pip3 install adafruit-nrfutil
|
-
Laden Sie den notwendigen Bootloader herunter: WisCore_RAK4631_Board_Bootloader.zip.
-
Verbinden Sie Ihr RAK-Gerät über USB mit Ihrem Computer.
-
Bootloader flashen.
adafruit-nrfutil --verbose dfu serial --package ./WisCore_RAK4631_Board_Bootloader.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
-
Danach mit den regulären flashing instructions fortfahren.
Zusätzliche RUI3-Schritte
Serieller Anschluss COM11 berührt Serieller Anschluss COM11 geöffnet Starte DFU-Upgrade vom Typ 2, SoftDevice-Größe: 0, Bootloader-Größe: 39000, Anwendungsgröße: 0 Sende DFU-Startpaket Zeitüberschreitung beim Warten auf Bestätigung vom Gerät. Upgrade des Ziels fehlgeschlagen. Fehler: Keine Daten am seriellen Anschluss empfangen. Fortfahren nicht möglich.
|
Debugger
pip3 install pyocd
|
-
Laden Sie den notwendigen Bootloader herunter: WisCore_RAK4631_Board_Bootloader.hex.
-
Verbinden Sie den RAKDAP wie unten beschrieben:

-
Bootloader flashen
pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex |
-
Fahren Sie mit den standardmäßigen Flash-Anweisungen fort.
Aktualisierung oder Wiederherstellung des Bootloaders auf nRF52-Geräten
Methode 1: Aktualisierung mit der UF2-Datei (empfohlen)
-
Laden Sie die korrekte UF2-Bootloader-Datei herunter.
-
Verbinden Sie Ihr Gerät mit einem USB-Kabel mit Ihrem Computer.
-
Aktivieren Sie den Bootloader-Modus, indem Sie die RESET-Taste Ihres Geräts schnell zweimal drücken. Beim Seeed Tracker 1000-E halten Sie die Benutzertaste gedrückt und verbinden dann schnell zweimal das USB-Kabel mit dem MagSafe-Anschluss. Das Gerät sollte als Wechsellaufwerk auf Ihrem Computer erscheinen.
-
Ziehen Sie die heruntergeladene UF2-Datei per Drag & Drop in das Wechsellaufwerk. Das Gerät aktualisiert automatisch den Bootloader und startet neu.
-
Sobald das Gerät neu startet, ist das Update abgeschlossen. Ihr Gerät läuft nun mit der neuesten Bootloader-Version und Sie können mit dem Flashen der Firmware fortfahren.
Methode 2: Verwendung von 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
-
Öffnen Sie ein Terminal oder eine Eingabeaufforderung und installieren Sie adafruit-nrfutil, indem Sie den folgenden Befehl ausführen:
pip install adafruit-nrfutil |
-
Beschaffen Sie das richtige ZIP-Paket.
-
Verbinden Sie Ihr Gerät mit einem USB-Kabel mit Ihrem Computer.
-
Navigieren Sie im Terminal oder in der Eingabeaufforderung zu dem Verzeichnis, in das Sie das Bootloader-ZIP-Paket heruntergeladen haben, und führen Sie den folgenden Befehl aus. Ersetzen Sie dabei /dev/ttyACM0 durch den korrekten Port Ihres Geräts (Windows-Benutzer können COMx verwenden):
adafruit-nrfutil --singlebank --touch 1200 --verbose dfu serial --package
|
-
Sobald der Vorgang abgeschlossen ist, ist das Update beendet. Ihr Gerät läuft nun mit der neuesten Bootloader-Version, sodass Sie mit dem Flashen der Firmware fortfahren können.
Methode 3: Verwendung eines Debuggers
Verwendung von SWDIO zum Flashen mit einem Raspberry Pi
Verdrahtungsaufbau
OpenOCD-Software installieren
$ 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
|
Verbindung überprüfen
$ 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 Lizenziert unter GNU GPL v2 Für Fehlerberichte lesen Sie http://openocd.org/doc/doxygen/bugs.html srst_only separate srst_gates_jtag srst_push_pull connect_deassert_srst swd Info : Lausche auf Port 6666 für Tcl-Verbindungen Info : Lausche auf Port 4444 für Telnet-Verbindungen Info : BCM2835 GPIO JTAG/SWD Bitbang-Treiber Info : Taktfrequenz 100 kHz Info : SWD DPIDR 0x2ba01477 Info : [nrf52.cpu] Cortex-M4 r0p1 Prozessor erkannt Info : [nrf52.cpu] Ziel hat 6 Breakpoints, 4 Watchpoints Info : [nrf52.cpu] Untersuchung erfolgreich Info : [nrf52.cpu] starte gdb-Server auf 3333 Info : Lausche auf Port 3333 für gdb-Verbindungen Info : akzeptiere 'telnet' Verbindung auf tcp/4444
|
Firmware herunterladen
Firmware flashen
$ telnet 127.0.0.1 4444 Versuche 127.0.0.1... Verbunden mit 127.0.0.1. Escape-Zeichen ist '^]'. Open On-Chip Debugger öffnen > init > reset init > halt > nrf5 mass_erase > program firmware.hex verify > reset > exit 0
|
Verbindung herstellen