Meshtastic Anleitung - Wie man die Meshtastic Firmware aufspielt

⚡ ESP32-Geräte mit Meshtastic-Firmware flashen

🔧 Das Flashen von ESP32-Geräten mit Meshtastic-Firmware kann auf verschiedene Arten erfolgen. Die empfohlene Methode ist der 🌐 Web Flasher, der mit Chrome- oder Edge-Browsern funktioniert. Er ist 👌 benutzerfreundlich und ideal für Anfänger, die ihre ESP32-Boards schnell flashen möchten. Das 💻 CLI-Skript ist eine manuelle Methode zum Flashen der Firmware und besser geeignet für fortgeschrittene Benutzer, die mit Kommandozeilen-Tools vertraut sind. Wenn sowohl der Web Flasher als auch das CLI-Skript fehlschlagen, ist die Verwendung eines 🔌 externen seriellen Adapters eine Option, sollte aber nur als letzter Ausweg ⚠️ wegen seiner Komplexität versucht werden.

📡 Bevor Sie Ihr ESP32-basiertes Meshtastic-Radio einschalten, befestigen Sie immer die Antenne. Der Betrieb ohne Antenne kann den Radiochip beschädigen. Um den Meshtastic-Webclient unter meshtastic.local zu aktualisieren, ist ein vollständiges Löschen und Neuinstallieren des Geräts erforderlich. Dies stellt sicher, dass Sie die neueste gebündelte Weboberfläche erhalten. Wenn Sie Ihre Einstellungen behalten möchten, 💾 exportieren Sie Ihre Konfiguration vor der Neuinstallation und importieren Sie sie danach.

⚙️ Das Flashen der ESP32-Firmware ist ein wichtiger Schritt bei der Einrichtung Ihres Meshtastic-Geräts. Egal, ob Sie den 🌐 Web Flasher, das 💻 CLI-Skript oder den 🔌 seriellen Adapter verwenden, stellen Sie sicher, dass Sie Sicherheitsvorkehrungen beachten und die Methode wählen, die am besten zu Ihrem Erfahrungsniveau passt.

🚀 Gerät flashen

  1. 🔗 Schließen Sie Ihr Gerät an
  2. 🌍 Besuchen Sie flasher.meshtastic.org *erfordert Chrome- oder Edge-Browser
  3. 📖 Befolgen Sie die Anweisungen

🔧 Gerät anschließen und einrichten

✅ Sobald du die Meshtastic-Firmware auf das Gerät geflasht hast, kannst du mit der Erstkonfiguration fortfahren.

💻 Firmware über CLI flashen

🔍 Verbindungsüberprüfung

📡 Bevor Sie Ihr ESP32-Gerät flashen, überprüfen Sie die Verbindung mit dem Gerät, das Sie flashen möchten. Folgen Sie den unten aufgeführten Schritten, um die Geräteverbindung zu prüfen und gegebenenfalls die passenden USB-Treiber für Ihr ESP32 Board zu installieren. Wenn Sie Treiber installieren müssen, denken Sie daran, anschließend 🔄 Ihren Computer neu zu starten, um sicherzustellen, dass die Treiberinstallation abgeschlossen ist.

⚠️ HINWEIS: Das T-Beam 0.7 Board ist eine frühere Version des T-Beam ESP32 Boards. Aufgrund von Designänderungen in späteren Versionen benötigt dieses Board eine spezifische Firmware-Datei, die sich von denen anderer T-Beam Board-Versionen unterscheidet. Stellen Sie sicher, dass Sie die richtige Firmware auswählen, wenn Sie Ihr ESP32 T-Beam 0.7 flashen, um eine ordnungsgemäße Funktion zu gewährleisten.

  • 📂 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.
📖 Für alle anderen T-Beam Boards überprüfen Sie bitte den Ressourcenbereich, um die richtige Firmware auszuwählen.

📜 Befehlszeilenanweisungen

🛠 Installieren Sie die erforderliche Software
🐧 Linux
🔎 Überprüfen Sie, ob Sie python3 und pip installiert mit folgendem Befehl

🐍 python3 --version

📦 pip3 --version

⚙️ Wenn python3 ist nicht installiert, Sie können es mit

🔄 sudo apt-get update

⬇️ sudo apt-get install python3

⚙️ Wenn pip ist nicht installiert, Sie können es mit
⬇️ sudo apt-get install python3-pip
⚙️ Installation esptool
⬇️ pip3 install --upgrade esptool
🍏 MacOS
💻 OS X wird mitgeliefert mit Python2.7 vorinstalliert, aber es enthält nicht pip. Die folgenden Anweisungen verwenden 🍺 Homebrew zur Installation Python3, das beinhaltet pip3. Auf macOS verwenden Sie pip3 anstatt pip.
ℹ️ HINWEIS: Überprüfen Sie, ob Homebrew mit folgendem Befehl installiert ist. Falls nicht, folgen Sie den Anweisungen auf der Homebrew-Website, bevor Sie fortfahren.
🔎 brew -v
🔎 Überprüfen Sie, ob Sie python3 und pip installiert mit folgendem Befehl

🐍 python3 --version

📦 pip3 --version

⚙️ Wenn python3 nicht installiert ist, können Sie es mit dem Befehl installieren
⬇️ brew install python3
✅ Überprüfen Sie, dass pip3 wurde zusammen mit python3
📦 pip3 -v
⚙️ Installation esptool
⬇️ 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.
🔎 Überprüfen Sie, ob Sie python3 und pip installiert mit folgendem Befehl

🐍 py --version

📦 pip --version

⚙️ Installation esptool
⬇️ pip3 install --upgrade esptool
🔗 Verbindung mit dem Chip überprüfen
  • 🐧 Unter Linux und macOS müssen Sie es möglicherweise explizit als esptool deklarieren .py Skript. Verwenden Sie den Befehl esptool.py chip_id je nach Ihrer Umgebung zu tun.
  • 🪟 Unter Windows müssen Sie es explizit als esptool deklarieren .py Skript mit dem Befehl ausführen esptool.py chip_id um eine ordnungsgemäße Funktion sicherzustellen.
🔌 Verbinden Sie das Funkgerät mit einem Daten-USB-Kabel mit Ihrem Computer. Verwenden Sie den folgenden Befehl, um zu überprüfen, ob Ihr Gerät mit Ihrem Computer kommuniziert:
💻 Befehl
📝 esptool chip_id
📤 Erwartete Ausgabe

✅ # Sie sollten ein ähnliches Ergebnis sehen wie dieses:

💻 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. Wird gelesen

🔑 Stattdessen MAC. MAC: 24:6f:28:b5:36:71

🔄 Hard-Reset über RTS-Pin...

⬇️ Firmware herunterladen
  • 🌐 Navigieren Sie zur Meshtastic Downloads Page, 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:
  1. Stable herunterladen: Für stabile, gut getestete Releases.
  1. 🧪 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 merken Sie sich den Speicherort auf Ihrem System, der sich typischerweise in Ihrem ~/Downloads Ordners.
📂 Zugriff auf das Firmware-Verzeichnis
💻 Öffnen Sie ein Terminal und wechseln Sie in das Verzeichnis, in das Ihre Firmware heruntergeladen wurde (unter Verwendung des cd Befehl). Der Ordnername entspricht normalerweise der Architektur und der Firmware-Version, die in der Zip-Datei angegeben sind. Zum Beispiel:
📂 cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
⚠️ HINWEIS: Stellen Sie sicher, dass Sie esp32s3 und die Versionsnummer durch die Werte ersetzen, die der von Ihnen heruntergeladenen Datei entsprechen.
⚡ Firmware installieren oder aktualisieren
🛠 Folgen Sie nun den Anweisungen unten für Ihr Betriebssystem, um die Firmware für Ihr spezifisches Board zu installieren oder zu aktualisieren:
📌 Bitte beachten Sie vor Beginn:

⚠️ Seien Sie äußerst vorsichtig, die richtige Firmware-Datei für Ihr ESP32 Board zu installieren. Insbesondere wird das weit verbreitete T-BEAM Radio von TTGO nicht als TTGO-Lora bezeichnet, welches ein anderes ESP32 Board ist. Flashen Sie daher nicht die TTGO-Lora Firmware auf ein T-BEAM, da es nicht richtig funktionieren wird und Probleme mit Ihrem ESP32 Gerät verursachen kann.

❌ Wenn Sie die für Ihr ESP32 Board installieren, kann der Flash-Vorgang zwar erfolgreich abgeschlossen erscheinen, aber das Gerät kann nicht reagieren und bei Vorhandensein eines Bildschirms einen leeren Bildschirm anzeigen. Stellen Sie immer sicher, dass Sie die richtige Firmware-Version für Ihre spezifische ESP32-Hardware flashen.

⚡ Bitte beachten Sie, dass diese ESP32-basierten Geräte zwar im Allgemeinen robust sind und Schäden nicht garantiert sind, es jedoch ein Risiko für Schäden am onboard Funkmodul und den Peripheriegeräten gibt, wenn die GPIO-Pin-Richtungen während des Firmware-Flashens falsch konfiguriert werden. Die richtige Firmware-Auswahl ist entscheidend, um die Funktionalität und Sicherheit Ihres ESP32 Meshtastic Geräts zu gewährleisten.

🐧 Linux & 🍏 macOS
⬇️ Installieren
💻 ./device-install.sh -f firmware-BOARD-VERSION.bin
⬇️ Firmware herunterladen
  • 🌐 Navigieren Sie zur Meshtastic Downloads Page, um die neueste Firmware zu erhalten.
  • 📂 Scrollen Sie nach unten zum Abschnitt Firmware und wählen Sie eine der folgenden Optionen:
  1. Stable herunterladen: Für stabile, gut getestete Releases.
  2. 🧪 Alpha herunterladen: Für experimentelle Releases mit den neuesten Funktionen.
  • 📄 Auf der GitHub Release-Seite nach unten zu Assets scrollen und diese erweitern.
  • 🔎 Identifizieren Sie die richtige Firmware für Ihr Gerät (z.B. firmware-esp32s3 für ESP32-S3 Boards).
  • 💾 Laden Sie die Datei herunter und merken Sie sich den Speicherort (normalerweise ~/Downloads).
📂 Zugriff auf das Firmware-Verzeichnis
💻 Öffnen Sie ein Terminal und wechseln Sie in das Verzeichnis, in das Ihre Firmware heruntergeladen wurde:
📂 cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
⚠️ HINWEIS: Ersetzen Sie esp32s3 und die Version durch Ihre tatsächliche Datei.
⚡ Firmware installieren oder aktualisieren
🛠 Befolgen Sie die Anweisungen unten für Ihr Betriebssystem:
📌 Wichtig:

⚠️ Installieren Sie immer die richtige Firmware für Ihr ESP32-Board. Verwechseln Sie T-BEAM nicht mit TTGO-Lora.

❌ Falsche Firmware kann zwar geflasht werden, aber das Gerät reagiert nicht (leerer Bildschirm).

⚡ Falsche GPIO-Konfigurationen während des Flashens können das Funkmodul beschädigen. Wählen Sie sorgfältig.

🐧 Linux & 🍏 macOS
⬇️ Installieren
💻 ./device-install.sh -f firmware-BOARD-VERSION.bin
🔄 Aktualisieren
💻 ./device-update.sh -f firmware-BOARD-VERSION-update.bin
🌐 Verwenden --web um den eingebetteten Web Client einzuschließen.
🪟 Windows
⬇️ Installieren
💻 esptool.exe --chip esp32 write_flash -z 0x1000 firmware-BOARD-VERSION.bin
🔄 Aktualisieren
💻 esptool.exe --chip esp32 write_flash -z 0x1000 firmware-BOARD-VERSION-update.bin
💻 device-install.bat -f firmware-BOARD-VERSION.bin
🔄 Aktualisieren
💻 device-update.bat -f firmware-BOARD-VERSION-update.bin
🌐 Verwenden Sie das --web Option, den eingebetteten Web-Client bei der Installation der Firmware einzubinden.

🔌 Gerät anschließen und einrichten

✅ Sobald Sie die Meshtastic-Firmware erfolgreich auf das Gerät geflasht haben, können Sie mit der Erstkonfiguration fortfahren.

🔧 Flashen mit einem externen Seriell-Adapter

ℹ️ HINWEIS: Diese Information ist wahrscheinlich nur hilfreich, wenn Sie bereits versucht haben, die Voraussetzungen und Abläufe im manuelles Flashen durchzugehen.

⚙️ Flash-Vorgang

📌 Situationen, die den Einsatz eines externen USB-zu-Seriell-Adapters erforderlich machen können:
  • ⚠️ 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

🛠 Es gibt zahlreiche ESP32-Adapter auf dem Markt, aber es ist ratsam, einen Adapter zu wählen, der den Silicon Labs CP2102-Chip verwendet, der für seine Zuverlässigkeit und seinen Status als Industrie-Standard für das ESP32 Flashen bekannt ist. Der auf CP2102 basierende Adapter gewährleistet eine stabile USB-zu-Seriell-Kommunikation, die für ein erfolgreiches Firmware-Flashen unerlässlich ist.

🔌 Beginnen Sie damit, den CP2102-Adapter an Ihren Computer anzuschließen, ohne zu diesem Zeitpunkt ESP32-Geräte zu verbinden. Stellen Sie sicher, dass die notwendigen USB-Treiber für den Adapter auf Ihrem Computer installiert sind. Für Windows-Benutzer sollten die korrekten CP2102-Treiber normalerweise automatisch installiert werden, was eine reibungslose ESP32-Geräteerkennung und zuverlässiges Firmware-Upload ermöglicht.

Adapter mit dem Gerät verbinden
ℹ️ HINWEIS: Es gibt mehrere Methoden, die Adapter-Pins mit dem Zielgerät zu verbinden, einschließlich des Andrückens von Jumpers gegen Kontakte oder der Verwendung von Pogo-Pin-Vorrichtungen. Dieses Tutorial hebt die Verwendung von versetzten Dupont-Steckern hervor, die auf die entsprechenden GPIO-Pins gelötet und mit Jumpern verbunden sind.
⚠️ Trennen Sie Ihren USB-zu-Seriell-Adapter vom Computer, bevor Sie diesen Vorgang starten.
  1. 🔄 Verbinden Sie den RX-Pin des Adapters mit dem TX-Pin des Geräts.
  2. 🔄 Verbinden Sie den TX-Pin des Adapters mit dem RX-Pin des Geräts.
  3. ⚡ Verbinden Sie einen GND-Pin des Adapters mit dem GND-Pin des Geräts.
  4. 🔋 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.
  5. 🟢 Überbrücken Sie GPIO 0 mit GND am Gerät mit einem Jumper. (Dies versetzt das Gerät beim Einschalten in den Flash-Modus.) Beispielverdrahtung mit einem T-Beam.
  1. 🔌 Verbinden Sie das Gerät mit einem USB-Anschluss des Computers.
  2. ❎ Entfernen Sie die Brücke (Jumper) zwischen GPIO 0 und GND.
💾 Flashen des Geräts
Nach Abschluss der obigen Schritte sollte sich Ihr Gerät im Flash-Modus befinden. Sie können nun die manuelle Methode verwenden, um Ihr Gerät zu flashen.
🔄 Sobald der Flash-Vorgang abgeschlossen ist, setzen Sie Ihr Gerät zurück (verwenden Sie die RST-Taste, falls vorhanden). Wenn Sie die Meshtastic Python CLI installiert haben, können Sie meshtastic --noproto ausführen, um die Verbindung zum Gerät über den Adapter wiederherzustellen und die serielle Ausgabe zu überprüfen, um sicherzustellen, dass Meshtastic korrekt installiert wurde.
🛠 Fehlerbehebung beim Flash-Vorgang
⚠️ Beim Ausführen der manuellen Geräte-Installationsskripte kann ein COM-Port-Berechtigungsfehler auftreten, der durch verschiedene Probleme verursacht werden kann.
💡 Um dies zu beheben, müssen Sie den Vorgang möglicherweise als Administrator ausführen, sicherstellen, dass keine andere Software, wie Cura, die COM-Ports blockiert, oder versuchen, Ihr System neu zu starten.

🔌 Gerät anschließen und einrichten

✅ Sobald Sie die Meshtastic-Firmware auf das Gerät geflasht haben, können Sie mit der Erstkonfiguration fortfahren.

📡 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.
  • 🧹 Factory Erase: Bevor Sie neue Firmware installieren, sollten Sie eine Factory Erase in Betracht ziehen, um vorhandene Daten zu löschen, die sich zwischen den Versionen im 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.

  • 🛠 Raspberry Pi als SWDIO-Flash-Tool verwenden: Wenn Ihr Gerät nicht über USB oder Bluetooth geflasht werden kann, ist eine Alternative 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 nutzen, um Firmware auf Ihre nRF52 oder RP2040-basierten Geräte herunterzuladen und zu übertragen. Alternativ können Sie die untenstehenden Anweisungen zum Herunterladen und Installieren der Firmware befolgen.
  • 🧹 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 passende Firmware..." für Ihr spezifisches Gerät unten fortfahren:
🔵 nRF52
  1. ⬇️ Laden Sie die neueste Firmware von den Meshtastic Downloads herunter und entpacken Sie sie.
  2. 🔌 Verbinden Sie Ihr Gerät mit einem USB-Datenkabel mit Ihrem Computer.
  3. 🔁 Drücken Sie zweimal die Reset-Taste an Ihrem Gerät (dadurch wird der Bootloader-Modus aktiviert).
  4. 💻 Ein neues Laufwerk wird an Ihrem Computer eingebunden (kompatibel mit Windows, Mac, Linux oder Android).
  5. 📂 Öffnen Sie dieses Laufwerk, wo Sie drei Dateien finden sollten: CURRENT.UF2, INDEX.HTM und INFO_UF2.TXT.
  6. 📥 Kopieren Sie die passende Firmware-Datei (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) aus dem Release-Ordner auf dieses Laufwerk.
  7. ✅ Nachdem die Datei kopiert wurde, wird das Gerät neu starten und die Meshtastic-Firmware installieren.
🟣 RP2040
  1. ⬇️ Laden Sie die neueste Firmware von den Meshtastic Downloads herunter und entpacken Sie sie.
  2. 🔘 Drücken und halten Sie die BOOTSEL-Taste, dann verbinden Sie das Gerät mit einem USB-Kabel mit Ihrem Computer.
  3. 💻 Ein neues Laufwerk wird an Ihrem Computer eingebunden (kompatibel mit Windows, Mac, Linux oder Android).
  4. 📂 Öffnen Sie dieses Laufwerk, wo Sie zwei Dateien finden sollten: INDEX.HTM und INFO_UF2.TXT.
  5. 📥 Kopiere die passende Firmware-Datei (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) aus dem Release-Ordner auf dieses Laufwerk.
  6. ✅ Nachdem die Datei kopiert wurde, wird das Gerät neu starten und die Meshtastic-Firmware installieren.
⚠️ Mögliche Sonderfälle beim Flashen
  1. 🔎 Vor dem Flashen stelle sicher, dass du das RAK4631 und nicht das RAK4631-R hast. Falls nicht, musst du den Bootloader ändern. Anleitungen findest du hier.
  2. ⚠️ Ältere Firmware-Versionen können veraltete Daten behalten, was zu Absturzschleifen führt. Wenn du Probleme beim Upgrade hast, führe vor dem Zurücksetzen auf Werkseinstellungen und dem Flashen durch.

🔌 Gerät anschließen und einrichten

✅ Sobald du die Meshtastic-Firmware auf das Gerät geflasht hast, kannst du mit der Erstkonfiguration fortfahren.

📡 Over-the-Air (OTA) Firmware-Updates für nRF52

📶 nRF52-Geräte von RAK können OTA-Firmware-Updates über Bluetooth akzeptieren. ⚠️ Ältere T-Echo-Bootloader unterstützen kein OTA.
⚠️ Achtung: OTA-Updates bergen ein höheres Risiko eines Fehlers. Wenn sie fehlschlagen, kann dein Gerät nicht funktionsfähig werden und eine physische Wiederherstellung erfordern.

🤖 Android

⚠️ Die neueste nRF DFU App (v2.3.0) ist nicht kompatibel. Verwende nRF Connect App v4.24.3 von Nordic GitHub.
  1. ⬇️ Lade die Firmware von Meshtastic Downloads oder GitHub herunter.
  2. 📂 Entpacken Sie den Firmware-Ordner.
  3. 📱 Öffne die nRF Connect App → SCANNER-Tab → Gerät verbinden.
  4. 🔗 Wenn DISCONNECT angezeigt wird, fortfahren; wenn CONNECT, darauf tippen.
  5. ⚙️ Tippe auf das DFU-Symbol (oben rechts).
  6. 📦 Wähle "Distribution Packet (ZIP)" → OK.
  7. 📥 Wähle die Firmware-Datei mit der Endung -ota.zip.
  8. ⏳ Update startet automatisch (kann langsam sein).
  9. ✅ Gerät startet nach dem Update neu.

🍎 Apple

📲 OTA-Updates sind über die nRF Device Firmware Update App auf iOS/iPadOS verfügbar.
  1. ⬇️ Laden Sie die Firmware von Meshtastic Downloads, GitHub oder direkt über die App herunter.
  2. 📂 Entpacken Sie den Firmware-Ordner.
  3. 📱 Öffnen Sie die nRF DFU App und wählen Sie die richtige Firmware-Datei für das Gerät aus (endet auf -ota.zip).
  4. 🔗 Verbinden Sie sich mit Ihrem Gerät.
  5. ⬆️ Laden Sie die Firmware hoch.
⚠️ Wichtiger Hinweis: Die Auto-Lock-Funktion des iPhones kann den Bluetooth-Firmware-Upload unterbrechen. Um dies zu verhindern, tippen Sie während des Uploads regelmäßig auf den Bildschirm oder stellen Sie vorübergehend die Auto-Lock-Einstellung auf "Niemals", damit das Telefon wach bleibt und der Upload ohne Unterbrechungen abgeschlossen wird.
❌ Wenn das Update fehlschlägt, können Sie den Erfolg verbessern, indem Sie die Paket-Einstellungen anpassen:
  1. ⚙️ Gehen Sie zu den Einstellungen und aktivieren Sie "Paketeingangsbenachrichtigung".
  2. 🔽 Ändern Sie "Anzahl der Pakete" auf einen niedrigeren Wert; einige Benutzer hatten Erfolg mit "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. Das Aktualisieren der Firmware löscht diese Daten nicht, was zu Problemen führen kann, wenn sich die Formate zwischen den Versionen ändern.
  • 🌐 Sie können den Meshtastic Web Flasher verwenden, um Ihre Geräte auf Werkseinstellungen zu löschen. Wählen Sie Ihr Board aus und klicken Sie auf das 🗑️-Symbol, um zu löschen. Alternativ folgen Sie den untenstehenden Anweisungen.

🔵 nRF52

Um den Flash-Speicher auf Ihrem nRF52-Board zurückzusetzen:
  1. ⬇️ Laden Sie die neueste Firmware von der Meshtastic-Downloadseite herunter und entpacken Sie sie.
  2. 🔌 Verbinden Sie Ihr Gerät über USB.
  3. 🔁 Doppelklicken Sie auf die Reset-Taste, um in den Bootloader-Modus zu wechseln.
  4. 💻 Ein neues Laufwerk wird eingebunden (Windows/Mac/Linux).
  5. 📂 Laufwerk enthält: CURRENT.UF2, INDEX.HTM, INFO_UF2.TXT.
  6. 📝 Öffne INFO_UF2.TXT und notiere den Wert von SoftDevice.
  7. 📥 Kopiere die korrekte Factory-Erase-UF2-Datei (Meshtastic_nRF52_factory_erase...) auf das Laufwerk. Das Gerät startet neu.
  8. 💻 Ausführen meshtastic --noproto im Terminal.
  9. ✅ Du solltest sehen: Formatierung... Fertig.
Sobald gelöscht, installiere die neueste Firmware auf einem sauberen Dateisystem.

🟣 RP2040

Um den Flash-Speicher auf deinem RP2040-Board zurückzusetzen:
  1. ⬇️ Herunterladen flash_nuke.uf2.
  2. 🔘 Halte BOOTSEL gedrückt und verbinde dich per USB.
  3. 💻 Das Board wird als RPI-RP2 eingebunden.
  4. 📥 Kopieren flash_nuke.uf2 auf das Laufwerk.
  5. ✅ Das Board startet neu und der Flash-Speicher ist gelöscht.
Nach dem Löschen installiere die neueste Firmware auf einem sauberen Dateisystem.

🔄 Umwandlung von RAK4631-R zu RAK4631

ℹ️ Der einzige Unterschied zwischen RAK4631-R (RUI3) und RAK4631 (Arduino) ist der Bootloader; die Hardware ist identisch.
📌 Meshtastic benötigt den Arduino-Bootloader. Die Umwandlung ist ein einmaliger Vorgang.
Hier sind zwei Methoden, um den Bootloader zu flashen:

💻 USB Device Firmware Update (DFU)

  1. ⬇️ Installiere Python.
  2. ⬇️ Installiere adafruit-nrfutil.
📦 pip3 install adafruit-nrfutil
  • 🧹 Du kannst jetzt den Meshtastic Web Flasher verwenden, um deine nRF52- oder RP2040-basierten Geräte auf Werkseinstellungen zu löschen. Besuche den Flasher, wähle dein Board aus und klicke auf das 🗑️ Mülleimer-Symbol rechts neben dem Flash-Button. Dadurch wird ein Dialog geöffnet, um das Löschverfahren zu starten. Alternativ kannst du den untenstehenden Anweisungen folgen.

🔵 nRF52

Um den Flash-Speicher auf Ihrem nRF52-Board zurückzusetzen, folgen Sie diesen Schritten:
  1. ⬇️ Laden Sie die neueste Firmware von der Meshtastic Downloads-Seite herunter und entpacken Sie sie.
  2. 🔌 Verbinden Sie Ihr Gerät mit Ihrem Computer über ein USB-Datenkabel.
  3. 🔁 Doppelklicken Sie auf die Reset-Taste Ihres Geräts, um in den Bootloader-Modus zu wechseln.
  4. 💻 Ein neues Laufwerk wird auf Ihrem Computer (Windows, Mac oder Linux) eingebunden.
  5. 📂 Öffnen Sie dieses Laufwerk, und Sie sollten drei Dateien sehen: CURRENT.UF2, INDEX.HTM und INFO_UF2.TXT.
  6. 📝 Öffnen Sie die Datei INFO_UF2.TXT in einem Texteditor und notieren Sie den Wert SoftDevice.
  7. 📥 Finden Sie die Datei in der heruntergeladenen Firmware, die zu Ihrer SoftDevice-Version (7.x.x oder 6.x.x) passt. 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 sie auf das Laufwerk. Das Gerät wird neu starten.
  8. 💻 Mit installiertem Meshtastic CLI öffnen Sie Terminal/Konsole und geben ein: meshtastic --noproto.
  9. ✅ Sie sollten die Meldung sehen: Formatierung... Fertig.
Sobald gelöscht, können Sie die neueste Meshtastic-Firmware auf einem sauberen Dateisystem installieren, indem Sie auf den untenstehenden Link klicken.

🟣 RP2040

Um den Flash-Speicher auf Ihrem RP2040-Board zurückzusetzen, folgen Sie diesen Schritten:
  1. ⬇️ Lade die flash_nuke.uf2 Datei auf Ihren Computer.
  2. 🔘 Halten Sie die BOOTSEL-Taste gedrückt und verbinden Sie dann das Board mit Ihrem Computer über ein USB-Kabel.
  3. 💻 Das Board sollte nun als Massenspeichergerät auf Ihrem Computer erscheinen, beschriftet als RPI-RP2.
  4. 📥 Kopiere die flash_nuke.uf2 Datei auf dieses Gerät.
  5. ✅ Das Board startet automatisch neu und der Flash-Speicher wird gelöscht.
Nach dem Löschen können Sie die neueste Meshtastic-Firmware auf einem sauberen Dateisystem installieren, indem Sie auf den untenstehenden Link klicken.

🔄 Umwandlung von RAK4631-R zu RAK4631

ℹ️ Der einzige Unterschied zwischen dem RAK4631-R (RUI3) und dem RAK4631 (Arduino) liegt im Bootloader; die Hardware ist identisch.
📌 Meshtastic benötigt den Arduino-Bootloader für RAK WisBlock nRF52-basierte Boards. Dieser Umwandlungsprozess muss nur einmal durchgeführt werden.
Hier sind zwei Methoden, um den Bootloader zu flashen:

💻 USB Device Firmware Update (DFU)

  1. ⬇️ Installieren Sie Python
  2. ⬇️ Installieren Sie adafruit-nrfutil
📦 pip3 install adafruit-nrfutil

 

👉 Sie müssen den ersten Teil der Anweisungen für die Umwandlung des RAK4631-R in den RAK4631 abschließen, insbesondere den Abschnitt mit dem AT+BOOT-Befehl.

🛠 Debugger

🔧 Für diese Umwandlung ist die Verwendung eines DAPLink oder J-Link erforderlich. Die günstigste und am leichtesten verfügbare Option ist der RAKDAP1.
  1. ⬇️ Installieren Sie Python
  2. ⬇️ Installieren Sie pyOCD
📦 pip3 install pyocd
  1. ⬇️ Laden Sie den notwendigen Bootloader herunter: WisCore_RAK4631_Board_Bootloader.hex
  2. 🔗 Verbinden Sie den RAKDAP wie unten beschrieben:
  1. ⚡ Bootloader flashen
💻 pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex
  1. ➡️ Fahren Sie mit den standardmäßigen Flashing-Anweisungen fort.
📖 Alternative Flash-Methoden sind hier ausführlich beschrieben.

🔄 Aktualisierung oder Wiederherstellung des Bootloaders auf nRF52-Geräten

⚠️ Wenn Sie Schwierigkeiten beim Aktualisieren oder Flashen neuerer Versionen der Meshtastic-Firmware haben und Ihr nRF52-Gerät nicht mit der neuesten Bootloader-Version läuft, kann ein Update des Bootloaders helfen, diese Probleme zu beheben.
🔎 Um die Version des aktuell auf Ihrem Gerät installierten Bootloaders zu überprüfen, aktivieren Sie den DFU-Modus. Öffnen Sie anschließend das auf Ihrem Computer angezeigte Laufwerk und prüfen Sie die Datei INFO_UF2.TXT.
📌 Hier sind die Schritte zum Aktualisieren Ihres Bootloaders.

✅ Methode 1: Aktualisierung mit der UF2-Datei (Empfohlen)

📦 Je nach Ihrem Gerät müssen Sie das passende Bootloader-Paket auswählen. Unten finden Sie die Links zu den Bootloader-Paketen:
  1. ⬇️ Laden Sie die korrekte UF2-Bootloader-Datei herunter.
  2. 🔌 Verbinde dein Gerät mit deinem Computer über ein USB-Kabel.
  3. 🔁 Aktivieren Sie den Bootloader-Modus, indem Sie die RESET-Taste schnell zweimal drücken. Für den 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 erscheinen.
  4. 📂 Ziehen Sie die heruntergeladene UF2-Datei per Drag & Drop auf das Wechsellaufwerk. Das Gerät aktualisiert automatisch den Bootloader und startet neu.
  5. ✅ Sobald das Gerät neu startet, ist das Update abgeschlossen. Ihr Gerät verwendet jetzt die neueste Bootloader-Version und Sie können mit dem Flashen der Firmware fortfahren.

⚠️ Methode 2: Verwendung von adafruit-nrfutil

⚠️ Vorsicht: Im Gegensatz zu UF2-Uploads überprüft adafruit-nrfutil nicht, ob du das richtige Bootloader-Paket für dein Gerät hast. Das Flashen des falschen Bootloaders könnte dein Gerät unbrauchbar machen. Überprüfe immer die SHA256-Prüfsumme, bevor du fortfährst.
📌 Diese Anweisungen setzen voraus, dass Python und pip bereits installiert sind. Falls nicht, lade die neueste Version von Python (mit pip) von Python.org herunter und installiere sie.
📦 Wähle basierend auf deinem Gerät das passende Bootloader-Paket. Unten findest du die Links:
  1. 💻 Öffne ein Terminal oder eine Eingabeaufforderung und installiere adafruit-nrfutil, indem du den folgenden Befehl ausführst:
🐚 bash
📦 pip install adafruit-nrfutil
  1. ⬇️ Besorge das richtige ZIP-Paket.
  2. 🔌 Verbinde dein Gerät mit deinem Computer über ein USB-Kabel.
  3. 💻 Navigiere im Terminal oder in der Eingabeaufforderung zu dem Verzeichnis, in dem du das Bootloader-ZIP-Paket heruntergeladen hast, und führe den folgenden Befehl aus. Ersetze /dev/ttyACM0 durch den richtigen Port (Windows-Nutzer können COMx verwenden):
⚡ adafruit-nrfutil --singlebank --touch 1200 --verbose dfu serial --package <heruntergeladene Datei>.zip -p /dev/ttyACM0 -b 115200
  1. ✅ Sobald der Vorgang abgeschlossen ist, ist das Update beendet. Ihr Gerät läuft jetzt mit der neuesten Bootloader-Version, sodass Sie mit dem Flashen der Firmware fortfahren können.

🛠 Methode 3: Verwendung eines Debuggers

🔧 Wenn die oben genannten Methoden nicht funktionieren und Ihre Hardware dies unterstützt (d. h. die notwendigen SWD-Pins vorhanden sind), können Sie einen Debugger wie einen DAPLink oder J-Link verwenden, um den Bootloader direkt zu flashen. Bitte beachten Sie die Debugger-Anleitung für ein Beispiel mit dem RAK4631.

🍓 Verwendung von SWDIO zum Flashen mit einem Raspberry Pi

💡 Die meisten Meshtastic-Geräte können einfach über USB geflasht werden. Einige Geräte (z. B. Seeed WM1110 Dev Kit) benötigen jedoch ein externes Gerät, das über "SWDIO" verbunden werden kann. Es gibt spezialisierte Geräte wie das RAKDAP1, die für diesen Zweck entwickelt wurden. Viele Nutzer finden auch einen Raspberry Pi als praktische Option.
📖 Dieser Artikel bietet Anweisungen, wie man einen Raspberry Pi als SWDIO Flash Tool verwendet.

🔌 Verkabelung einrichten

🔗 Der erste Schritt ist, zwei Drähte zwischen Ihrem Raspberry Pi und den SWDIO-Anschlüssen an Ihrem NRF52-basierten Gerät zu verbinden.
⚡ Verbinden Sie GPIO Pin 11 an Ihrem Raspberry Pi mit dem CLK Pin am Meshtastic-Gerät und verbinden Sie GPIO Pin 8 an Ihrem Raspberry Pi mit dem DIO Pin am Meshtastic-Gerät.
✅ Stellen Sie sicher, dass die GPIO-Nummern korrekt sind.
🔋 Versorgen Sie Ihren Raspberry Pi mit Strom, indem Sie ihn an eine USB-Stromquelle anschließen, und versorgen Sie auch das Meshtastic-Gerät mit Strom.

⚙️ OpenOCD-Software installieren

💻 Sie können OpenOCD verwenden, um die SWDIO-Verbindung mit dem Meshtastic-Gerät zu verwalten. Installieren Sie es auf Ihrem Raspberry Pi.

🔄 $ 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

Bevor wir mit der Firmware arbeiten, versuchen wir, eine Verbindung zum NRF52-basierten Gerät über SWDIO herzustellen. Alle notwendigen Konfigurationen finden Sie im OpenOCD-Repository.
💻 $ openocd -f ./openocd/tcl/interface/raspberrypi-native.cfg -c "transport select swd" -f openocd/tcl/target/nrf52.cfg -s tcl
ℹ️ Die erste Flagge kennzeichnet den Raspberry Pi als Ihren Host-Rechner, der Transport ist auf SWDIO eingestellt, und die letzte Flagge zeigt an, dass Sie sich mit einem nRF52-basierten Chip verbinden. Sie sollten eine ähnliche Ausgabe sehen:

🖥️ 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

⚡ 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] Prüfung 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

⚠️ Wenn die Meldung „Error connecting DP: cannot read IDR“ erscheint, bedeutet dies wahrscheinlich, dass die Kabel an den falschen Stellen angeschlossen sind.

⬇️ Firmware herunterladen

Beachten Sie die Anweisungen für Ihre Hardware, um die passende Firmware für Ihr Gerät zu finden. Die meisten Geräte, die dieser Anleitung folgen, benötigen eine .hex-Datei. Kopieren Sie danach die Firmware-Datei auf Ihren Raspberry Pi.

⚡ Firmware flashen

Nach dem Start von OpenOCD können Sie sich über Telnet mit Ihrem Meshtastic-Gerät verbinden. Das Flashen des Geräts ist einfach; führen Sie einfach einige Befehle innerhalb der Telnet-Sitzung aus:

💻 $ 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

🔌 Trennen Sie die Stromversorgung und schließen Sie sie nach dem Flashen wieder an.

📶 Verbindung herstellen

🎉 Herzlichen Glückwunsch! Sie sollten sich jetzt über Bluetooth in der Meshtastic-App mit Ihrem Gerät verbinden können.

Seitenleiste

Neuester Beitrag

Dieser Abschnitt enthält derzeit keine Inhalte. Fügen Sie Inhalte zu diesem Abschnitt über die Seitenleiste hinzu.

Melden Sie sich für unseren Newsletter an

Erhalten Sie die neuesten Informationen über unsere Produkte und Sonderangebote.