EN

Häufige Fragen (FAQ)

Häufige Fragen (FAQ)

Eine Sammlung häufig gestellter Fragen und Antworten rund um MeshCore.

- 1.1. Was ist MeshCore? - 1.2. Was braucht man, um MeshCore zu nutzen? - 1.2.1. Hardware - 1.2.2. Firmware - 1.2.3. Companion-Radio-Firmware - 1.2.4. Repeater - 1.2.5. Room-Server - 2.1. Wie viele Geräte brauche ich, um MeshCore zu nutzen? - 2.2. Kostet MeshCore Geld? - 2.3. Welche Frequenzen werden von MeshCore unterstützt? - 2.4. Was ist ein „Advert" in MeshCore? - 2.5. Gibt es ein Hop-Limit? - 3.1. Wie konfiguriert man einen Repeater oder Room-Server? - 3.2. Muss ich den Standort für einen Repeater setzen? - 3.3. Wie lautet das Passwort zur Verwaltung eines Repeaters oder Room-Servers? - 3.4. Wie lautet das Passwort, um einem Room-Server beizutreten? - 3.5. Kann ich den privaten Schlüssel eines Repeaters auslesen oder setzen? - 3.6. Das erste Byte des öffentlichen Schlüssels meines Repeaters kollidiert mit einem bestehenden Repeater im Mesh. Wie bekomme ich einen neuen privaten Schlüssel mit einem passenden öffentlichen Schlüssel, dessen erstes Byte ich selbst wählen kann? - 3.7. Mein Repeater leidet möglicherweise unter „Taubheit" durch starke Störungen in der Nähe meiner Mesh-Frequenz und hört andere MeshCore-Radios in Reichweite nicht. Was kann ich tun? - 3.8. Wie mache ich meinen Repeater zu einem Observer im Mesh? - 3.9. Was ist Multibyte-Unterstützung? Was bedeuten 1-Byte-, 2-Byte-, 3-Byte-Adverts und -Nachrichten? - 3.9.1. Welche Path-Hash-Größen leitet mein Repeater weiter? - 3.9.2. Was bestimmt die Path-Hash-Größe eines Pakets? - 3.9.3. Wie ändere ich die Path-Hash-Größe meines Companions? - 3.9.4. Was bewirkt der CLI-Befehl path.hash.mode auf einem Repeater? - 3.9.5. Warum 2- oder 3-Byte-Path-Hash für Adverts verwenden? - 3.9.6. Wann können wir bei Kanal- und Direktnachrichten von 1-Byte-Path-Hash abrücken? - 4.1. Gibt es eine Bedienungsanleitung für T-Deck, T-Pager, T-Watch oder T-Display Pro? - 4.2. Wie bringt man ein T-Deck in den DFU-Modus (Device Firmware Update)? - 4.3. Warum bekommt mein T-Deck Plus keinen Satellitenfix? - 4.4. Warum bekommt mein OG-T-Deck (ohne Plus) keinen Satellitenfix? - 4.5. Welche SD-Karten-Größe unterstützt das T-Deck? - 4.6. Wie lautet der öffentliche Schlüssel für den Standard-Public-Channel? - 4.7. Wie bekomme ich Karten auf das T-Deck? - 4.8. Wohin kommen die Kartenkacheln? - 4.9. Wie schalte ich tiefere Kartenzoomstufen und Server-Verwaltungsfunktionen auf dem T-Deck frei? - 4.10. Wie liest man die Diagnoseansicht auf dem T-Deck? - 4.11. Der T-Deck-Sound ist zu laut? - 4.12. Kann man die Sounds anpassen? - 4.13. Was ist die Funktion „Import from Clipboard" auf dem T-Deck, und gibt es eine Möglichkeit, Nodes manuell hinzuzufügen, ohne Adverts empfangen zu müssen? - 4.14. Wie erstellt man einen Screenshot auf dem T-Deck? - 5.1. Was sind BW, SF und CR? - 5.2. Wiederholen MeshCore-Clients Pakete? - 5.3. Was passiert, wenn ein Node eine Route über einen mobilen Repeater gelernt hat und dieser Repeater dann weg ist? - 5.4. Wie entdeckt ein Node den Pfad zu seinem Ziel und nutzt ihn für zukünftige Nachrichten, anstatt jede Nachricht per Flooding zu senden wie Meshtastic? - 5.5. Flooden öffentliche Kanäle immer? Flooden private Kanäle immer? - 5.6. Wie lautet der öffentliche Schlüssel für den Standard-Public-Channel? - 5.7. Ist MeshCore Open Source? - 5.8. Wie kann ich MeshCore unterstützen? - 5.9. Wie baue ich die MeshCore-Firmware aus dem Quellcode? - 5.10. Gibt es weitere Open-Source-Projekte rund um MeshCore? - 5.11. Unterstützt MeshCore ATAK? - 5.12. Wie füge ich einen Node zur MeshCore-Karte hinzu? - 5.13. Kann ich einen Raspberry Pi verwenden, um ein MeshCore-Radio zu aktualisieren? - 5.14. Gibt es Projekte, die auf MeshCore aufbauen? - 5.15. Gibt es Client-Anwendungen für Windows oder Mac? - 5.16. Gibt es Ressourcen, die MeshCore mit anderen LoRa-Systemen vergleichen? - 6.1. Mein Client zeigt an, dass ein anderer Client, ein Repeater oder ein Room-Server vor sehr vielen Tagen zuletzt gesehen wurde. - 6.2. Ein Repeater, Client oder Room-Server, den ich in meiner Discover-Liste (T-Deck) oder Kontaktliste (Smartphone-Client) erwarte, wird nicht angezeigt. - 6.3. Wie verbinde ich mich per BLE (Bluetooth) mit einem Repeater? - 6.4. Mein Companion wird über Bluetooth nicht angezeigt? - 6.5. Ich kann mich nicht per Bluetooth verbinden – wie lautet der Bluetooth-Pairing-Code? - 6.6. Mein Heltec V3 trennt sich ständig vom Smartphone. Die Bluetooth-Verbindung ist nicht stabil. - 6.7. Mein RAK/T1000-E/xiao_nRF52-Gerät scheint beschädigt zu sein – wie setze ich es komplett zurück? - 6.8. Der WebFlasher schlägt unter Linux mit „failed to open" fehl - 7.1. Wie aktualisiere ich nRF-Geräte (RAK, T114, Seeed XIAO) – Companion, Repeater und Room-Server – drahtlos per OTA mit der neuen, einfacheren DFU-App? - 7.1.1 Kann ich den Seeed Studio Wio Tracker L1 Pro per OTA aktualisieren? - 7.2. Wie aktualisiere ich ESP32-basierte Geräte drahtlos? - 7.3. Gibt es eine Möglichkeit, die Fehlerquote bei einem OTA-Firmware-Update (DFU) zu senken? - 7.4. Sind das MeshCore-Logo und die Schriftart verfügbar? - 7.5. Wie ist das Format eines Kontakt- oder Kanal-QR-Codes? - 7.6. Wie verbinde ich mich per WLAN mit dem Companion, z. B. mit einem Heltec V3? - 7.7. Ich habe ein Station G2, ein Heltec V4, einen Ikoka Stick oder ein Radio mit EByte E22-900M30S- oder E22-900M33S-Modul – wie sollte die Sendeleistung eingestellt sein?

1. Einführung

1.1. F: Was ist MeshCore?

A: MeshCore ist ein plattformübergreifendes System für sichere, textbasierte Kommunikation auf Basis von LoRa-Funkhardware. Es eignet sich unter anderem für Off-Grid-Kommunikation (netzunabhängige Kommunikation), Katastrophenschutz und Notfallhilfe, Outdoor-Aktivitäten, taktische Sicherheitsanwendungen (etwa für Strafverfolgungsbehörden und private Sicherheitsdienste) sowie IoT-Sensornetzwerke (Internet of Things – Netzwerke aus vernetzten Sensoren). (Quelle)

MeshCore ist frei und quelloffen:

  • MeshCore umfasst das Routing, die Firmware usw. und ist auf GitHub unter der MIT-Lizenz verfügbar.
  • Es gibt von der Community entwickelte Clients, beispielsweise die Web-Clients – diese sind kostenlos nutzbar, und einige davon sind ebenfalls Open Source.
  • Die plattformübergreifende Mobile-App, die von Liam Cottle für Android/iOS/PC usw. entwickelt wird, ist kostenlos herunterladbar und nutzbar.
  • Die T-Deck-Firmware wird von Scott bei Ripple Radios, dem Erfinder von MeshCore, entwickelt und kann ebenfalls kostenlos auf unterstützte Geräte geflasht und verwendet werden.
Einige fortgeschrittenere, aber optionale Funktionen stehen auf dem T-Deck zur Verfügung, wenn man sein Gerät registriert und einen Freischaltschlüssel erhält. In den MeshCore-Smartphone-Clients für Android und iOS/iPadOS lässt sich die Wartezeit für die Repeater- und Room-Server-Fernverwaltung per Funk freischalten.

Diese Funktionen sind vollständig optional und für die grundlegende Nachrichtenfunktion nicht erforderlich. Sie sind sozusagen Bonus-Funktionen – um die Entwickler bei ihrer Arbeit an diesen großartigen Features zu unterstützen, kann für den Freischaltcode eine kleine Gebühr anfallen.

Grundsätzlich kann jeder auf Basis von MeshCore eigene Projekte entwickeln, ohne dafür etwas bezahlen zu müssen.

1.2. F: Was braucht man, um MeshCore zu nutzen?

A: Alles, was man für MeshCore braucht, findet sich hier: Man benötigt LoRa-Hardware-Geräte, um die MeshCore-Firmware als Client oder Server (Repeater und Room-Server) zu betreiben.

1.2.1. Hardware

MeshCore ist für eine Vielzahl von LoRa-Geräten in den Frequenzbereichen 433 MHz, 868 MHz und 915 MHz verfügbar. Beispiele sind: Lilygo T-Deck, T-Pager, RAK Wireless WisBlock RAK4631-Geräte (z. B. 19003, 19007, 19026), Heltec V3, Xiao S3 WIO, Xiao C3, Heltec T114, Station G2, Nano G2 Ultra und Seeed Studio T1000-E. Weitere Geräte werden laufend ergänzt.

Eine aktuelle Liste der unterstützten Geräte findet sich auf

Um MeshCore ohne Smartphone als Client-Oberfläche zu verwenden, kann man MeshCore auf einem LilyGo T-Deck, T-Deck Plus, T-Pager, T-Watch oder T-Display Pro betreiben. Die MeshCore-Ultra-Firmware auf diesen Geräten bietet eine vollständige, netzunabhängige und sichere Kommunikationslösung.

1.2.2. Firmware

MeshCore bietet vier Firmware-Typen, die es bei anderen LoRa-Systemen nicht gibt:

1.2.3. Companion-Radio-Firmware

Companion-Radios (Begleitgeräte) dienen zum Verbinden mit der Android-App oder Web-App als Messenger-Client. Es gibt zwei verschiedene Companion-Radio-Firmware-Versionen:
  1. BLE Companion
Die BLE-Companion-Firmware läuft auf einem unterstützten LoRa-Gerät und verbindet sich über BLE (Bluetooth Low Energy) mit einem Smartphone, auf dem der Android- oder iOS-MeshCore-Client läuft.
  1. USB Serial Companion
Die USB-Serial-Companion-Firmware läuft auf einem unterstützten LoRa-Gerät und verbindet sich über USB-Serial mit einem Smartphone, Computer oder ähnlichem Gerät, auf dem der MeshCore-Web-Client läuft.

1.2.4. Repeater

Repeater dienen zur Erweiterung der Reichweite eines MeshCore-Netzwerks. Die Repeater-Firmware läuft auf denselben Geräten wie die Client-Firmware. Die Aufgabe eines Repeaters ist es, MeshCore-Pakete an das Zielgerät weiterzuleiten. Er sendet dabei nicht jedes empfangene Paket weiter oder wiederholt es – anders als bei anderen LoRa-Mesh-Systemen.

Ein Repeater kann per Fernzugriff verwaltet werden: entweder mit einem T-Deck, auf dem die MeshCore-Firmware mit freigeschalteten Fernverwaltungsfunktionen läuft, oder über einen BLE-Companion-Client, der mit einem Smartphone verbunden ist, auf dem die MeshCore-App läuft.

1.2.5. Room-Server

Ein Room-Server ist ein einfacher BBS-Server (Bulletin Board System – ein schwarzes Brett) zum Teilen von Beiträgen. T-Deck-Geräte mit MeshCore-Firmware oder ein BLE-Companion-Client, der mit einem Smartphone mit der MeshCore-App verbunden ist, können sich mit einem Room-Server verbinden.

Room-Server speichern den Nachrichtenverlauf und übermitteln die gespeicherten Nachrichten an die Nutzer. Room-Server ermöglichen es mobilen Nutzern, später zurückzukehren und den Nachrichtenverlauf abzurufen. Bei Kanälen (Channels) werden Nachrichten entweder beim Senden empfangen – oder verpasst, wenn der Kanal-Nutzer außer Reichweite ist. Room-Server funktionieren anders: Sie ähneln eher E-Mail-Servern, bei denen man später zurückkehren und seine E-Mails vom Server abrufen kann.

Ein Room-Server kann per Fernzugriff verwaltet werden: entweder mit einem T-Deck, auf dem die MeshCore-Firmware mit freigeschalteten Fernverwaltungsfunktionen läuft, oder über einen BLE-Companion-Client, der mit einem Smartphone verbunden ist, auf dem die MeshCore-App läuft.

Wenn sich ein Client bei einem Room-Server anmeldet, erhält er die letzten 32 ungelesenen Nachrichten.

Obwohl man einem Room-Server mit dem Kommandozeilenbefehl set repeat on auch das Repeaten ermöglichen kann, wird davon abgeraten. Ein Room-Server mit aktiviertem Repeat verfügt nicht über den vollen Funktionsumfang der Repeater- und Fernverwaltungsfunktionen, die nur in der Repeater-Firmware enthalten sind.

Die Empfehlung lautet: Repeater und Room-Server auf getrennten Geräten betreiben, für die beste Erfahrung.

---

2. Ersteinrichtung

2.1. F: Wie viele Geräte brauche ich, um MeshCore zu nutzen?

A: Mit einem einzigen unterstützten Gerät kannst du die BLE-Companion-Firmware flashen und dein Gerät als Client verwenden. Über Bluetooth verbindest du es mit dem Android- oder iOS-Client und kannst sofort mit anderen MeshCore-Nutzern in deiner Nähe kommunizieren.

Wenn du zwei unterstützte Geräte hast und es noch nicht viele MeshCore-Nutzer in deiner Umgebung gibt, flashe beide mit der BLE-Companion-Firmware, damit du mit Freunden und Familie in der Nähe kommunizieren kannst.

Wenn du zwei unterstützte Geräte hast und es bereits andere MeshCore-Nutzer in der Nähe gibt, kannst du ein Gerät mit der BLE-Companion-Firmware und das andere mit der Repeater-Firmware flashen. Platziere den Repeater möglichst hoch, um die Reichweite deines MeshCore-Netzwerks zu vergrößern.

Nachdem du die neueste Firmware auf dein Repeater-Gerät geflasht hast, lass das Gerät per USB-Serial mit deinem Computer verbunden. Nutze die Konsolen-Funktion im Web-Flasher und stelle die Frequenz für deine Region bzw. dein Land ein, damit dein Client den Repeater oder Room-Server per Funk fernverwalten kann:

set freq {frequency}

Die CLI-Referenz (Kommandozeilenbefehl-Referenz) für Repeater und Room-Server findest du hier:

Wenn du weitere unterstützte Geräte hast, kannst du sie mit der Room-Server-Firmware betreiben.

2.2. F: Kostet MeshCore Geld?

A: Alle Radio-Firmware-Versionen (z. B. für Heltec V3, RAK, T-1000E usw.) sind kostenlos und Open Source – entwickelt von Scott bei Ripple Radios.

Der native Android- und iOS-Client nutzt das Freemium-Modell und wird von Liam Cottle entwickelt, dem Entwickler der Meshtastic-Karte auf meshtastic.liamcottle.net auf GitHub und von reticulum-meshchat auf GitHub.

Die T-Deck-Firmware kann kostenlos heruntergeladen werden und die meisten Funktionen stehen ohne Kosten zur Verfügung. Um den Firmware-Entwickler zu unterstützen, kann man einen Registrierungsschlüssel kaufen, der tiefere Kartenzoomstufen und die Fernverwaltung von Servern per Funk auf dem T-Deck freischaltet. Die Registrierung ist nicht erforderlich, um das T-Deck für Direktnachrichten und die Verbindung mit Repeatern und Room-Servern zu nutzen.

2.3. F: Welche Frequenzen werden von MeshCore unterstützt?

A: MeshCore unterstützt den 868-MHz-Bereich in der UK/EU und den 915-MHz-Bereich in Neuseeland, Australien und den USA. Länder und Regionen in diesen beiden Frequenzbereichen werden ebenfalls unterstützt.

Verwende den Smartphone-Client oder die Repeater-Setup-Funktion im Web-Flasher, um die Funkeinstellungen deiner Radios festzulegen, indem du das Preset für deine Region wählst.

Seit ca. Oktober 2025 sind viele Regionen auf die „Narrow"-Einstellung gewechselt, also BW62.5 und eine niedrigere SF-Nummer (statt des ursprünglichen SF11). Das USA/Kanada-Preset (empfohlen) ist beispielsweise 910,525 MHz, SF7, BW62.5, CR5.

Nach umfangreichen Tests sind viele Regionen auf BW62.5 und SF7, 8 oder 9 umgestiegen oder stehen kurz davor. Schmalere Bandbreite und niedrigere SF-Werte ermöglichen es den MeshCore-Funksignalen, sich besser zwischen Störungen im ISM-Band (lizenzfreies Frequenzband) einzufügen, bieten einen niedrigeren Grundrauschpegel (Noise Floor), bessere SNR-Werte (Signal-Rausch-Verhältnis) und schnellere Übertragungen.

Wenn in deiner Community ein Konsens besteht, die empfohlenen Presets deiner Region zu aktualisieren, poste deine Änderungsanfrage bitte im Kanal #meshcore-app auf dem MeshCore-Discord-Server, damit Liam Cottle davon erfährt.

2.4. F: Was ist ein „Advert" in MeshCore?

A: Ein Advert (von „advertise" – sich bekanntmachen) bedeutet, dass du dich im Netzwerk ankündigst. In Reticulum-Begriffen wäre das ein „Announce", in Meshtastic-Begriffen das Senden der Node-Info.

MeshCore ermöglicht es dir, deinen Namen, deine Position und deinen öffentlichen Verschlüsselungsschlüssel manuell zu senden – dieser ist zudem signiert, um Spoofing (Identitätsfälschung) zu verhindern. Wenn du auf den Advert-Button drückst, werden diese Daten per LoRa ausgestrahlt. MeshCore nennt das ein „Advert". Es gibt zwei Varianten: „Zero Hop" und „Flood".

* Zero Hop bedeutet: Dein Advert wird an alle gesendet, die es direkt empfangen können – und das war's. * Flood bedeutet: Es wird gesendet und dann von allen Repeatern, die es hören, weiterverbreitet.

MeshCore-Clients senden Adverts nur dann, wenn der Nutzer das manuell auslöst. Ein Repeater sendet standardmäßig alle 12 Stunden ein Flood-Advert. Dieses Intervall kann mit folgendem Befehl konfiguriert werden:

set flood.advert.interval {hours}

Der separate Befehl set advert.interval {minutes} steuert den Timer für das lokale Zero-Hop-Advert.

2.5. F: Gibt es ein Hop-Limit?

A: Intern hat die Firmware ein maximales Limit von 64 Hops (Weiterleitungsschritten). In der Praxis ist es schwierig, dieses Limit auch nur annähernd zu erreichen, da Umgebungsbedingungen und Laufzeiten die Pakete mit zunehmender Entfernung einschränken. Wir möchten gerne erfahren, wie weit eure MeshCore-Gespräche reichen!

---

3. Server-Verwaltung

3.1. F: Wie konfiguriert man einen Repeater oder Room-Server?

A: Wenn MeshCore zum ersten Mal auf ein LoRa-Gerät geflasht wird, muss die Frequenz des Server-Geräts eingestellt werden, damit es die in deinem Land oder deiner Region zulässige Frequenz verwendet.

Ein Repeater oder Room-Server kann mit einer der folgenden Optionen verwaltet werden:

  • Nachdem die Repeater- oder Room-Server-Firmware auf ein LoRa-Gerät geflasht wurde, öffne und verwende die Web-Oberfläche, um dich über USB-Serial mit dem LoRa-Gerät zu verbinden. Dort kannst du den Namen des Servers, seine Frequenz und weitere Einstellungen, den Standort, Passwörter usw. festlegen.
  • Verbinde das Server-Gerät per USB-Kabel mit einem Computer, öffne Chrome auf und nutze die Console-Funktion, um dich mit dem Gerät zu verbinden.
  • Verwende einen MeshCore-Smartphone-Client, um Server per LoRa aus der Ferne zu verwalten.
  • Ein T-Deck mit freigeschalteter/registrierter MeshCore-Firmware. Die Fernverwaltung von Servern wird durch die Registrierung deines T-Deck bei Ripple Radios ermöglicht. Das ist zugleich eine Möglichkeit, die MeshCore-Entwicklung zu unterstützen. Du kannst dein T-Deck hier registrieren:

3.2. F: Muss ich den Standort für einen Repeater setzen?

A: Es ist nicht zwingend erforderlich, aber mit gesetztem Standort wird der Repeater künftig auf der MeshCore-Karte angezeigt. Der Standort wird mit folgenden Befehlen gesetzt: set lat set lon

Breiten- und Längengrad können in Google Maps ermittelt werden, indem man mit der rechten Maustaste auf den gewünschten Standort klickt.

3.3. F: Wie lautet das Passwort zur Verwaltung eines Repeaters oder Room-Servers?

A: Das Standard-Admin-Passwort für Repeater und Room-Server lautet password. Mit folgendem Befehl kann das Admin-Passwort geändert werden: password {new-password}

3.4. F: Wie lautet das Passwort, um einem Room-Server beizutreten?

A: Das Standard-Gastpasswort für einen Room-Server lautet hello. Mit folgendem Befehl kann das Gastpasswort geändert werden: set guest.password {guest-password}

3.5. F: Kann ich den privaten Schlüssel eines Repeaters auslesen oder setzen?

A: Mit folgenden Befehlen kannst du den privaten Schlüssel eines Repeaters über eine USB-Serial-Verbindung auslesen oder setzen: get prv.key – gibt den privaten Schlüssel des Repeaters auf der seriellen Konsole aus. set prv.key – setzt den privaten Schlüssel des Repeaters über die serielle Konsole.

Starte den Repeater nach dem Befehl set prv.key neu, damit der neue private Schlüssel wirksam wird.

3.6. F: Das erste Byte des öffentlichen Schlüssels meines Repeaters kollidiert mit einem bestehenden Repeater im Mesh. Wie bekomme ich einen neuen privaten Schlüssel mit einem passenden öffentlichen Schlüssel, dessen erstes Byte ich selbst wählen kann?

A: Einen neuen privaten Schlüssel mit einem frei wählbaren ersten Byte des öffentlichen Schlüssels kannst du hier generieren:

Wenn mehrere Repeater dasselbe erste Byte in der ID haben, beeinträchtigt das das Mesh und seine Funktion nicht negativ. Flood- und pfadbasierte Pakete erreichen weiterhin ihr Ziel. Die Kollision des ersten Bytes macht jedoch Traceroute und Pfadanalyse schwieriger, weil diese Tools nicht genau wissen, welcher der zwei (oder mehr) kollidierenden Repeater sich im Pfad befindet.

Die Best Practice lautet: Wähle beim Einrichten eines neuen Repeaters einen öffentlichen Schlüssel, dessen erstes Byte noch nicht verwendet wird. Falls es nicht möglich ist, ein einzigartiges erstes Byte zu finden, wähle eines, das zumindest im Umkreis von ca. 16 km einzigartig ist, um Kollisionen mit nahegelegenen Repeatern zu minimieren.

3.7. F: Mein Repeater leidet möglicherweise unter „Taubheit" durch starke Störungen in der Nähe meiner Mesh-Frequenz und hört andere MeshCore-Radios in Reichweite nicht. Was kann ich tun?

A: Das kann an der automatischen Verstärkungsregelung (AGC – Auto Gain Control) des SX1262-Funkchips liegen. Mit folgendem Befehl kann die AGC periodisch zurückgesetzt werden: set agc.reset.interval

Die Einheit von ist Sekunden und wird in 4er-Schritten erhöht. set agc.reset.interval 4 funktioniert gut, um die „Taubheit" zu beheben.

Das ist ein sehr kostengünstiger Vorgang. Der AGC-Reset wird einfach durch Setzen von state = STATE_IDLE; in der Funktion RadioLibWrapper::resetAGC() in RadioLibWrappers.cpp durchgeführt.

3.8. F: Wie mache ich meinen Repeater zu einem Observer im Mesh?

A: Die Anleitung zum Einrichten als Observer (Beobachter-Knoten) findest du hier:

3.9. F: Was ist Multibyte-Unterstützung? Was bedeuten 1-Byte-, 2-Byte-, 3-Byte-Adverts und -Nachrichten?

A: Das ursprüngliche MeshCore-Protokolldesign verwendet das erste Byte des öffentlichen Schlüssels eines Repeaters, um den Repeater in einem Pfad zu identifizieren. Mit 1 Byte pro Repeater im Pfad können MeshCore-Pakete bis zu 64 Hops weit reisen.

Allerdings gibt es mit 1 Byte nur 254 eindeutige IDs (00 und FF sind reserviert). In vielen Mesh-Gruppen haben mehrere Repeater dasselbe erste Byte in ihren öffentlichen Schlüsseln. Die Pakete passieren die Repeater weiterhin ohne Probleme und das Mesh wird in keiner Weise beeinträchtigt. Es macht es aber für Analysetools schwieriger, Pfade mit doppelten Repeater-IDs auszuwerten.

Firmware-Version 1.14 und neuer führt die Möglichkeit ein, dass Repeater mit 1-, 2- oder 3-Byte-Adverts senden können. Companions können ebenfalls Kanal- und Direktnachrichten mit 1-, 2- oder 3-Byte-Pfad senden. Adverts und Nachrichten mit 1-Byte-Pfad sind kompatibel mit Repeater-Firmware älter oder neuer als 1.14. Sie reisen bis zu 64 Hops weit. 2-Byte-Adverts und -Nachrichten reisen bis zu 32 Hops weit. 3-Byte-Adverts und -Nachrichten reisen bis zu 21 Hops weit.

3.9.1. F: Welche Path-Hash-Größen leitet mein Repeater weiter?

Repeater mit Firmware 1.14+ leiten Pakete mit 1-, 2- und 3-Byte-Path-Hash weiter. Repeater mit Firmware älter als 1.14 leiten nur Pakete mit 1-Byte-Path-Hash weiter und verwerfen 2- und 3-Byte-Pakete stillschweigend.

3.9.2. F: Was bestimmt die Path-Hash-Größe eines Pakets?

Der ursprüngliche Sender des Pakets bestimmt die Path-Hash-Größe. Der häufigste ursprüngliche Sender ist eine Companion-App. Der andere häufige ursprüngliche Sender ist ein Repeater, wenn er sein Advert ausstrahlt.

3.9.3. F: Wie ändere ich die Path-Hash-Größe meines Companions?

Ab Firmware-Version 1.14 und MeshCore-App-Version 1.41.0 kannst du in der MeshCore-App die Path-Hash-Größe für Nachrichten deines Companions unter Einstellungen (Zahnrad-Symbol)Experimentelle Einstellungen festlegen.

Solange in deinem regionalen Mesh nicht die überwiegende Mehrheit der Repeater auf Firmware 1.14+ aktualisiert ist, empfiehlt es sich, beim Standard von 1 Byte zu bleiben, da Repeater vor Version 1.14 Nachrichten mit größeren Path-Hashes stillschweigend verwerfen.

3.9.4. F: Was bewirkt der CLI-Befehl path.hash.mode auf einem Repeater?

Der CLI-Befehl path.hash.mode steuert *ausschließlich* die Path-Hash-Größe, die in den eigenen Advert-Aussendungen des Repeaters verwendet wird. Er hat keinen Einfluss darauf, welche Pakete der Repeater weiterleitet. Ein Repeater mit Firmware 1.14+ leitet immer 1-, 2- und 3-Byte-Pakete weiter, unabhängig von dieser Einstellung.

Verwendung: set path.hash.mode {0|1|2}:

CLI
┌────────────────┬───────────────────────────┐
│ path.hash.mode │ Advert-Path-Hash-Größe    │
├────────────────┼───────────────────────────┤
│ 0              │ 1 Byte (Standard)         │
├────────────────┼───────────────────────────┤
│ 1              │ 2 Bytes                   │
├────────────────┼───────────────────────────┤
│ 2              │ 3 Bytes                   │
└────────────────┴───────────────────────────┘

Es ist unbedenklich, deine 1.14+-Repeater auf Modus 1 oder 2 zu setzen.

3.9.5. F: Warum 2- oder 3-Byte-Path-Hash für Adverts verwenden?

Ein längerer Path-Hash hilft Tools wie dem LetsMesh.net Analyzer und MeshMapper, Repeater zuverlässiger voneinander zu unterscheiden. Mit nur 1 Byte ist die Wahrscheinlichkeit hoch, dass verschiedene Repeater dasselbe erste Byte in ihren öffentlichen Schlüsseln haben, was die Unterscheidung in der Mesh-Netzwerkanalyse erschwert. Da dies nur Adverts betrifft, gibt es keinen Nachteil. 2- und 3-Byte-Adverts reisen zwar nicht so weit wie 1-Byte-Adverts, aber es ist für MeshCore-Nodes nicht wichtig, das Advert eines Repeaters zu hören, der 21 oder 32 Hops entfernt ist.

3.9.6. F: Wann können wir bei Kanal- und Direktnachrichten von 1-Byte-Path-Hash abrücken?

Du solltest erst dann auf 2-Byte- oder 3-Byte-Kanal- und Direktnachrichten wechseln, wenn die überwiegende Mehrheit der Repeater in deinem regionalen Mesh auf Firmware-Version 1.14 oder neuer aktualisiert ist. Wenn du den path.hash.mode deines Repeaters jetzt schon auf 1 (für 2-Byte-Path-Hash) oder 2 (für 3-Byte-Path-Hash) setzt, hilft das der Community einzuschätzen, wie viele Repeater bereits auf 1.14+ aktualisiert sind. Bitte stimme dich mit deiner MeshCore-Community ab, um gemeinsam zu entscheiden, wann auf 2-Byte- oder 3-Byte-Pfad für Kanal- und Direktnachrichten gewechselt wird.

---

4.1. F: Gibt es eine Bedienungsanleitung für T-Deck, T-Pager, T-Watch oder T-Display Pro?

A: Ja, sie ist hier verfügbar:

4.2. F: Wie bringt man ein T-Deck in den DFU-Modus (Device Firmware Update)?

A:
  1. Gerät ausschalten
  2. USB-Kabel mit dem Gerät verbinden
  3. Trackball gedrückt halten (weiter gedrückt halten)
  4. Gerät einschalten
  5. Den USB-Verbindungston abwarten
  6. Trackball loslassen
  7. Das T-Deck befindet sich jetzt im DFU-Modus
  8. Jetzt kann mit dem Flashen über begonnen werden

4.3. F: Warum bekommt mein T-Deck Plus keinen Satellitenfix?

A: Beim T-Deck Plus sollte die GPS-Baudrate auf 38400 eingestellt sein. Außerdem wurde bei einigen T-Deck-Plus-Geräten festgestellt, dass das GPS-Modul verkehrt herum eingebaut war – mit der GPS-Antenne nach unten statt nach oben. Falls dein T-Deck Plus nach dem Einstellen der Baudrate auf 38400 immer noch keinen Satellitenfix bekommt, musst du eventuell das Gerät öffnen und die GPS-Ausrichtung überprüfen.

GPS ist auf dem T-Deck immer aktiviert. Du kannst die „GPS clock sync" überspringen, und das T-Deck wird weiterhin versuchen, einen GPS-Fix zu erhalten. Im Bildschirm GPS Info sollte der Zähler bei Sentences: stetig ansteigen, sofern die Baudrate korrekt eingestellt ist.

Quelle

4.4. F: Warum bekommt mein OG-T-Deck (ohne Plus) keinen Satellitenfix?

A: Das OG-T-Deck (die Originalversion ohne Plus) wird ohne GPS ausgeliefert. Wenn du ein GPS-Modul nachgerüstet hast, schau in der Anleitung deines GPS-Moduls nach der benötigten Baudrate. Alternativ kannst du die Baudraten von 9600, 19200 usw. bis 115200 durchprobieren, um herauszufinden, welche funktioniert.

4.5. F: Welche SD-Karten-Größe unterstützt das T-Deck?

A: Nutzer haben problemlos 16-GB- und 32-GB-SD-Karten verwendet. Die SD-Karte muss auf FAT32 formatiert sein.

4.6. F: Wie lautet der öffentliche Schlüssel für den Standard-Public-Channel?

A: Das T-Deck verwendet denselben Schlüssel wie die Smartphone-Apps, aber im Base64-Format: izOH6cXN6mrJ5e26oRXNcg==

Auf der Hardware-Tastatur des T-Deck gibt es keine =-Taste. Du kannst die Bildschirmtastatur verwenden, um = einzugeben. Tippe auf das Textfeld, um die Bildschirmtastatur zu aktivieren. Das dritte Zeichen ist der Großbuchstabe O (Oh), nicht die Zahl 0 (Null).

Der Schlüssel in der Smartphone-App ist im Hex-Format: 8b3387e9c5cdea6ac9e5edbaa115cd72

Quelle

4.7. F: Wie bekomme ich Karten auf das T-Deck?

A: Du benötigst Kartenkacheln (Map Tiles). Vorheruntergeladene Kartenkacheln sind hier erhältlich (eine gute Möglichkeit, die Entwicklung zu unterstützen):
  • (Europa)
  • (USA)
Alternativ kannst du mit diesem Python-Skript Kartenkacheln für die gewünschten Gebiete herunterladen:

Es gibt auch ein erweitertes Skript mit zusätzlicher Fehlerbehandlung und parallelen Downloads:

4.8. F: Wohin kommen die Kartenkacheln?

Sobald die Kacheln heruntergeladen sind, kopiere den Ordner \tiles in das Stammverzeichnis der SD-Karte deines T-Deck.

4.9. F: Wie schalte ich tiefere Kartenzoomstufen und Server-Verwaltungsfunktionen auf dem T-Deck frei?

A: Du kannst die T-Deck-Firmware kostenlos herunterladen, installieren und nutzen. Einige Funktionen (Kartenzoom, Server-Verwaltung) werden jedoch erst freigeschaltet, wenn du einen Freischaltcode für 10 $ pro T-Deck-Gerät erwirbst. Freischaltseite:

4.10. F: Wie liest man die Diagnoseansicht auf dem T-Deck?

A: Der Platz auf dem T-Deck-Bildschirm ist begrenzt, daher sind die Informationen etwas kryptisch. Das Format lautet: {hops} l:{packet-length}({payload-len}) t:{packet-type} snr:{n} rssi:{n}

Die Pakettypen (packet-type) sind hier definiert:

CLI
#define PAYLOAD_TYPE_REQ 0x00 // request (prefixed with dest/src hashes, MAC) (enc data: timestamp, blob)
#define PAYLOAD_TYPE_RESPONSE 0x01 // response to REQ or ANON_REQ (prefixed with dest/src hashes, MAC) (enc data: timestamp, blob)
#define PAYLOAD_TYPE_TXT_MSG 0x02 // a plain text message (prefixed with dest/src hashes, MAC) (enc data: timestamp, text)
#define PAYLOAD_TYPE_ACK 0x03 // a simple ack #define PAYLOAD_TYPE_ADVERT 0x04 // a node advertising its Identity
#define PAYLOAD_TYPE_GRP_TXT 0x05 // an (unverified) group text message (prefixed with channel hash, MAC) (enc data: timestamp, "name: msg")
#define PAYLOAD_TYPE_GRP_DATA 0x06 // an (unverified) group datagram (prefixed with channel hash, MAC) (enc data: data_type, data_len, blob)
#define PAYLOAD_TYPE_ANON_REQ 0x07 // generic request (prefixed with dest_hash, ephemeral pub_key, MAC) (enc data: ...)
#define PAYLOAD_TYPE_PATH 0x08 // returned path (prefixed with dest/src hashes, MAC) (enc data: path, extra)
Quelle

4.11. F: Der T-Deck-Sound ist zu laut?

4.12. F: Kann man die Sounds anpassen?

A: Du kannst die Sounds auf dem T-Deck anpassen, indem du .mp3-Dateien in das Stammverzeichnis (root) der SD-Karte legst. Die Dateien sind:

* startup.mp3 * error.mp3 * alert.mp3 * new-advert.mp3 * existing-advert.mp3

4.13. F: Was ist die Funktion „Import from Clipboard" auf dem T-Deck, und gibt es eine Möglichkeit, Nodes manuell hinzuzufügen, ohne Adverts empfangen zu müssen?

A: „Import from Clipboard" dient zum Importieren eines Kontakts über eine Datei namens clipboard.txt auf der SD-Karte. Das Gegenstück befindet sich im Identity-Bildschirm unter dem Menüpunkt „Card to Clipboard", der die eigenen Daten in clipboard.txt schreibt, damit man sie teilen kann (diese werden „Biz Cards" genannt und beginnen mit „meshcore://…").

4.14. F: Wie erstellt man einen Screenshot auf dem T-Deck?

A: Um einen Screenshot auf dem T-Deck aufzunehmen, drücke lange auf die obere linke Ecke des Bildschirms. Der Screenshot wird auf der microSD-Karte gespeichert, sofern eine im Gerät eingesteckt ist.

---

5. Allgemeines

5.1. F: Was sind BW, SF und CR?

A: BW ist die Bandbreite (Bandwidth) – die Breite des Frequenzspektrums, das für die Übertragung verwendet wird. SF ist der Spreizfaktor (Spreading Factor) – wie stark die Kommunikation zeitlich gespreizt wird. CR ist die Codierungsrate (Coding Rate) – Quelle:

Kurzfassung: Setze CR standardmäßig auf 5 für gute, stabile Verbindungen. Wenn die Verbindung nicht stabil ist und aussetzt, ändere CR auf 7 oder 8.

Forward Error Correction (FEC, Vorwärtsfehlerkorrektur) ist ein Verfahren, bei dem redundante Bits zu den zu übertragenden Daten hinzugefügt werden. Während der Übertragung können Daten durch Störungen verfälscht werden (Änderung von 0 zu 1 bzw. 1 zu 0). Diese Fehlerkorrekturbits werden beim Empfänger verwendet, um verfälschte Bits wiederherzustellen.

Die Codierungsrate einer Vorwärtsfehlerkorrektur gibt das Verhältnis der tatsächlich nutzbaren Informationsbits in einem Datenstrom an.

In LoRaWAN werden vier Codierungsraten verwendet:

4/5 4/6 5/7 4/8

Wenn die Codierungsrate beispielsweise 5/7 beträgt, erzeugt der Codierer für je 5 Bits Nutzinformation insgesamt 7 Datenbits, wovon 2 Bits redundant sind.

Eine Verdopplung der Bandbreite (z. B. von BW125 auf BW250) ermöglicht es, in derselben Zeit doppelt so viele Bytes zu senden. Eine Verringerung des Spreizfaktors um eine Stufe (z. B. von SF10 auf SF9) ermöglicht es ebenfalls, in derselben Zeit doppelt so viele Bytes zu senden.

Ein niedrigerer Spreizfaktor macht es für den Empfänger schwieriger, eine Übertragung zu empfangen, da er empfindlicher auf Rauschen reagiert. Man kann das mit zwei Personen vergleichen, die sich an einem lauten Ort (z. B. in einem Lokal) unterhalten. Wenn man weit voneinander entfernt steht, muss man langsam sprechen (SF10), aber wenn man nahe beieinander steht, kann man schneller sprechen (SF7).

Es ist also ein Balanceakt zwischen Übertragungsgeschwindigkeit und Rauschbeständigkeit. The Things Network konzentriert sich hauptsächlich auf LoRaWAN, aber die zugrunde liegenden LoRa-Grundlagen gelten für jedes LoRa-Projekt.

5.2. F: Wiederholen MeshCore-Clients Pakete?

A: Nein, MeshCore-Clients wiederholen keine Pakete. Das ist der Kern von MeshCores Messaging-first-Design (Nachrichten stehen an erster Stelle). Dadurch wird vermieden, dass Geräte den Äther fluten und endlose Kollisionen verursachen, durch die gesendete Nachrichten nicht ankommen. In MeshCore wiederholen nur Repeater und Room-Server (mit set repeat on) Pakete.

5.3. F: Was passiert, wenn ein Node eine Route über einen mobilen Repeater gelernt hat und dieser Repeater dann weg ist?

A: Wenn du einen anderen Node früher über einen bestimmten Repeater erreicht hast und dieser Repeater jetzt nicht mehr erreichbar ist, sendet der Client die Nachricht zunächst über den bestehenden (aber nun unterbrochenen) bekannten Pfad. Nach 3 fehlgeschlagenen Versuchen setzt die App den Pfad zurück und sendet die Nachricht beim letzten Versuch standardmäßig als Flood (Flutung). Dieses Verhalten kann in den Einstellungen deaktiviert werden. Wenn das Ziel direkt oder über einen anderen Repeater erreichbar ist, wird der neue Pfad künftig verwendet. Alternativ kannst du den Pfad manuell setzen, wenn du einen bestimmten Repeater kennst, über den das Ziel erreichbar ist.

Falls sich Nutzer häufig bewegen und Pfade dadurch immer wieder unterbrochen werden, sehen sie in der Smartphone-App einfach die Wiederholungsversuche – und der Client fällt automatisch auf Flooding zurück, um einen neuen Pfad herzustellen.

5.4. F: Wie entdeckt ein Node den Pfad zu seinem Ziel und nutzt ihn für zukünftige Nachrichten, anstatt jede Nachricht per Flooding zu senden wie Meshtastic?

A: Routen werden in der Kontaktliste des Senders gespeichert. Wenn du zum ersten Mal eine Nachricht sendest, erreicht sie das Ziel zunächst per Flood-Routing (Flutungsrouting). Wenn der Ziel-Node die Nachricht empfängt, sendet er eine Empfangsbestätigung (Delivery Report) an den Sender zurück, die alle Repeater enthält, durch die die ursprüngliche Nachricht gelaufen ist. Dieser Delivery Report wird per Flood-Routing an dich als Sender zurückgeschickt und bildet die Basis für den zukünftigen direkten Pfad. Bei der nächsten Nachricht wird der Pfad in das Paket eingebettet und von den Repeatern ausgewertet. Wenn Hop-Nummer und Adresse des Repeaters übereinstimmen, leitet er die Nachricht weiter – andernfalls nicht. So wird die Netzwerkauslastung minimiert. Quelle

5.5. F: Flooden öffentliche Kanäle immer? Flooden private Kanäle immer?

A: Ja, Gruppenkanäle funktionieren von A nach B, es gibt also keinen definierten Pfad. Sie müssen per Flooding gesendet werden. Repeater können allerdings Flood-Verkehr bis zu einem bestimmten Hop-Limit beschränken, und zwar mit dem CLI-Befehl set flood.max. Administratoren von Repeatern bestimmen die Regeln für ihre Repeater. Quelle

5.6. F: Wie lautet der öffentliche Schlüssel für den Standard-Public-Channel?

A: Der Schlüssel in der Smartphone-App ist im Hex-Format: 8b3387e9c5cdea6ac9e5edbaa115cd72

Das T-Deck verwendet denselben Schlüssel, aber im Base64-Format:

izOH6cXN6mrJ5e26oRXNcg==

Das dritte Zeichen ist der Großbuchstabe O (Oh), nicht die Zahl 0 (Null).

Quelle

5.7. F: Ist MeshCore Open Source?

A: Der Großteil der Firmware ist frei verfügbar. Alles ist Open Source, mit Ausnahme der T-Deck-Firmware und Liams nativer Mobile-Apps.

Firmware-Repository:

5.8. F: Wie kann ich MeshCore unterstützen?

A: Gib ehrliches Feedback auf GitHub und auf dem MeshCore-Discord-Server. Verbreite MeshCore in deinem Freundeskreis und deinen Communities und hilf ihnen beim Einstieg. Unterstütze Scotts MeshCore-Entwicklung auf .

Unterstütze Liam Cottles Smartphone-Client-Entwicklung, indem du die Wartezeit für die Server-Verwaltung per In-App-Kauf freischaltest.

Unterstütze Rastislav Vysoky (recrof) bei der Entwicklung der Flasher-Website und der Karten-Website über PayPal oder Revolut.

5.9. F: Wie baue ich die MeshCore-Firmware aus dem Quellcode?

A: Anleitung hier:

Build-Anleitung für MeshCore:

Für Windows zunächst WSL und Python+pip installieren über:

(Linux, Windows+WSL) Im Terminal/Shell:

CLI
sudo apt update
sudo apt install libpython3-dev
sudo apt install python3-venv
Mac: python3 sollte bereits installiert sein.

Danach ist es auf allen Plattformen gleich:

CLI
python3 -m venv meshcore
cd meshcore && source bin/activate
pip install -U platformio
git clone https://github.com/ripplebiz/MeshCore.git
cd MeshCore
Öffne platformio.ini und bearbeite in [arduino_base] den Eintrag LORA_FREQ=867.5. Speichern und dann ausführen:
CLI
pio run -e RAK_4631_Repeater
Anschließend findest du firmware.zip in .pio/build/RAK_4631_Repeater

A: Liam Cottles MeshCore-Web-Client und die MeshCore-JavaScript-Bibliothek sind Open Source unter der MIT-Lizenz.

Web-Client: JavaScript:

5.11. F: Unterstützt MeshCore ATAK?

A: ATAK (Android Team Awareness Kit) steht derzeit nicht auf der MeshCore-Roadmap.

MeshCore wäre aus folgenden Gründen nicht optimal für ATAK geeignet:

  • MeshCore-Clients wiederholen keine Pakete, daher wäre ein bestehendes Repeater-Netzwerk erforderlich.
  • Es gibt keinen stabilen Pfad, wenn sich alle Clients ständig zwischen Repeatern bewegen.
MeshCore-Clients müssten den Pfad ständig zurücksetzen und Flood-Verkehr über das Netzwerk senden, was bei etwas so „geschwätzigem" wie ATAK zu vielen Kollisionen führen könnte.

Dies könnte sich in Zukunft ändern, falls MeshCore eine Client-Firmware entwickelt, die auch Pakete weiterleitet.

Quelle

5.12. F: Wie füge ich einen Node zur MeshCore-Karte hinzu?

A:

Um ein BLE-Companion-Radio hinzuzufügen, verbinde dich über die MeshCore-Smartphone-App mit dem BLE-Companion-Radio. Tippe in der App auf das 3-Punkt-Menü-Symbol oben rechts und dann auf Internet Map. Tippe erneut auf das 3-Punkt-Menü-Symbol und wähle Add me to the Map.

Um einen Repeater oder Room-Server zur Karte hinzuzufügen, gehe zur Kontaktliste und tippe auf die 3 Punkte neben dem Repeater oder Room-Server, den du zur Internet-Karte hinzufügen möchtest. Tippe auf Share und dann auf Upload to Internet Map.

Du kannst denselben Companion (mit demselben öffentlichen Schlüssel), den du zum Hinzufügen deiner Repeater oder Room-Server verwendet hast, auch nutzen, um sie wieder von der Internet-Karte zu entfernen.

5.13. F: Kann ich einen Raspberry Pi verwenden, um ein MeshCore-Radio zu aktualisieren?

A: Ja. Nachfolgend findest du die Anleitung, um Firmware über USB-Serial mit einem Raspberry Pi auf ein unterstütztes LoRa-Gerät zu flashen.
Die Anleitung für nRF-Geräte wie RAK, T1000-E und T114 folgt direkt nach der ESP-Anleitung.

Für ESP-basierte Geräte (z. B. Heltec V3) brauchst du:

  1. Die Firmware-Datei von herunterladen.
- Öffne die Webseite im Browser und suche den Abschnitt mit der benötigten Firmware. - Klicke auf den Download-Button und mache einen Rechtsklick auf die benötigte Datei, z. B.: - Heltec_V3_companion_radio_ble-v1.7.1-165fb33.bin - Nicht-zusammengeführte Bin-Datei – behält die bestehende Bluetooth-Pairing-Datenbank. - Heltec_v3_companion_radio_usb-v1.7.1-165fb33-merged.bin - Zusammengeführte (merged) Bin-Datei – überschreibt alles einschließlich Bootloader und bestehender Bluetooth-Pairing-Datenbank, behält aber Konfigurationen. - Rechtsklicke auf den Dateinamen und kopiere den Link. Beispiel: https://flasher.meshcore.io/releases/download/companion-v1.7.1/Heltec_v3_companion_radio_ble-v1.7.1-165fb33.bin - Ausführen: - wget https://flasher.meshcore.io/releases/download/companion-v1.7.1/Heltec_v3_companion_radio_ble-v1.7.1-165fb33.bin um die Firmware-Datei für deinen Gerätetyp oder die gewünschte Version herunterzuladen: USB, BLE, Repeater, Room Server, merged oder non-merged Bin. - Falls der obige wget-Befehl nur eine sehr kleine Datei herunterlädt (10 KB statt mehr als 100 KB), verwende stattdessen diesen Befehl: - wget --user-agent="Mozilla/5.0" --content-disposition "https://flasher.meshcore.io/releases/download/companion-v1.7.1/Heltec_v3_companion_radio_usb-v1.7.1-165fb33.bin"
  1. Den ttyXXXX-Gerätepfad auf deinem Raspberry Pi ermitteln.
- Wechsle in das Verzeichnis /dev und führe den Befehl ls aus, um den Gerätepfad zu finden. - Bei ESP-Geräten ist es üblicherweise /dev/ttyUSB0.
  1. esptool über die Shell installieren.
- pip install esptool --break-system-packages
  1. Firmware flashen.
- Für nicht-zusammengeführte (non-merged) Bin: - esptool.py -p /dev/ttyUSB0 --chip esp32-s3 write_flash 0x10000 .bin - Für zusammengeführte (merged) Bin: - esptool.py -p /dev/ttyUSB0 --chip esp32-s3 write_flash 0x00000 .bin Anleitung für nRF-Geräte:

Für nRF-Geräte (z. B. RAK, Heltec T114) brauchst du Folgendes:

  1. Die Firmware-Datei von herunterladen.
- Öffne die Webseite im Browser und suche den Abschnitt mit der benötigten Firmware. - Du benötigst die ZIP-Version für das Adafruit-Flash-Tool weiter unten. - Klicke auf den Download-Button und mache einen Rechtsklick auf die ZIP-Datei, z. B.: - RAK_4631_companion_radio_ble-v1.7.1-165fb33.zip - Rechtsklicke auf den Dateinamen und kopiere den Link. Beispiel: https://flasher.meshcore.io/releases/download/companion-v1.7.1/RAK_4631_companion_radio_ble-v1.7.1-165fb33.zip - Ausführen: - wget https://flasher.meshcore.io/releases/download/companion-v1.7.1/RAK_4631_companion_radio_ble-v1.7.1-165fb33.zip um die Firmware-Datei für deinen Gerätetyp oder die gewünschte Version herunterzuladen: USB, BLE, Repeater, Room Server, nur ZIP-Datei.
  1. Den ttyXXXX-Gerätepfad auf deinem Raspberry Pi ermitteln.
- Wechsle in das Verzeichnis /dev und führe den Befehl ls aus, um den Gerätepfad zu finden. - Bei nRF-Geräten ist es üblicherweise /dev/ttyACM0.
  1. adafruit-nrfutil installieren.
- pip install adafruit-nrfutil --break-system-packages
  1. Das nRF-Gerät flashen.
- adafruit-nrfutil --verbose dfu serial --package RAK_4631_companion_radio_usb-v1.7.1-165fb33.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200

Um einen Repeater oder Room-Server, der über USB-Serial mit einem Pi verbunden ist, per Shell-Befehlen zu verwalten, muss picocom installiert werden. Zur Installation von picocom folgenden Befehl ausführen:

  • sudo apt install picocom
Um das über USB-Serial verbundene Gerät mit picocom zu verwalten, folgenden Befehl verwenden:
  • picocom -b 115200 /dev/ttyUSB0 --imap lfcrlf
Von hier aus kannst du die Kommandozeilenbefehle für Repeater und Room-Server in der MeshCore-Dokumentation nachschlagen:

5.14. F: Gibt es Projekte, die auf MeshCore aufbauen?

A: Ja, es gibt viele. Das MeshCore-Protokoll ist Open Source unter der MIT-Lizenz. Die MIT-Lizenz und das offene Protokoll machen es der MeshCore-Community sehr leicht, neue Firmware für Radios, Anwendungen für mobile Geräte, Karten-Tools, Analyse-Tools und Integrationen mit anderen Projekten wie Home Assistant zu entwickeln.

Da wöchentlich neue MeshCore-Community-Projekte entstehen, pflegen wir die Liste hier in den FAQ nicht mehr. samuk pflegt eine sehr umfassende Liste von MeshCore-Community-Projekten auf . samuk nimmt Pull Requests entgegen und mergt sie regelmäßig.

5.15. F: Gibt es Client-Anwendungen für Windows oder Mac?

A: Ja, derselbe Client wie für iOS und Android ist auch für Windows und Mac verfügbar. Du findest sie zusammen mit der Android-APK hier:

Sowohl die Windows- als auch die Mac-Version der Client-App sind vollständig freigeschaltet und kostenlos nutzbar.

5.16. F: Gibt es Ressourcen, die MeshCore mit anderen LoRa-Systemen vergleichen?

A: Hier ist eine Liste von MeshCore-Vergleichsressourcen:
  • The Comms Channel auf YouTube:
  • MeshCore Advantages von MCarper:
  • MeshCore vs Meshtastic von austinmesh.org:
---

6. Fehlerbehebung

6.1. F: Mein Client zeigt an, dass ein anderer Client, ein Repeater oder ein Room-Server vor sehr vielen Tagen zuletzt gesehen wurde.

6.2. F: Ein Repeater, Client oder Room-Server, den ich in meiner Discover-Liste (T-Deck) oder Kontaktliste (Smartphone-Client) erwarte, wird nicht angezeigt.

A:
  • Wenn dein Client ein T-Deck ist, hat es möglicherweise keine korrekte Uhrzeit gesetzt (kein GPS eingebaut, kein GPS-Fix oder falsche GPS-Baudrate).
  • Wenn du den Android- oder iOS-Client verwendest, hat möglicherweise der andere Client, Repeater oder Room-Server die falsche Uhrzeit.
Die Epoch-Zeit (Unix-Zeitstempel) kannst du auf ermitteln und damit die Uhr deines T-Deck setzen. Bei einem Repeater oder Room-Server kann der Administrator die Uhr per T-Deck aus der Ferne setzen (Clock Sync / Zeitsynchronisation) oder den Befehl time in der USB-Serial-Konsole verwenden, wenn das Server-Gerät angeschlossen ist.

6.3. F: Wie verbinde ich mich per BLE (Bluetooth) mit einem Repeater?

A: Man kann sich nicht per Bluetooth mit einem Gerät verbinden, auf dem die Repeater-Firmware läuft. Per Bluetooth kannst du dich nur mit Geräten verbinden, auf denen die BLE-Companion-Firmware läuft – und zwar über die Android-App.

6.4. F: Mein Companion wird über Bluetooth nicht angezeigt?

A: Stelle sicher, dass du die Bluetooth-Companion-Firmware geflasht hast und nicht die reine USB-Companion-Firmware.

6.5. F: Ich kann mich nicht per Bluetooth verbinden – wie lautet der Bluetooth-Pairing-Code?

A: Der Standard-Bluetooth-Pairing-Code lautet 123456

6.6. F: Mein Heltec V3 trennt sich ständig vom Smartphone. Die Bluetooth-Verbindung ist nicht stabil.

A: Der Heltec V3 hat eine sehr kleine Spulenantenne auf der Platine für WLAN und Bluetooth. Die Reichweite ist daher sehr gering – nur wenige Zentimeter bis Meter. Es ist möglich, die Spulenantenne zu entfernen und durch einen 31 mm langen Draht zu ersetzen. Mit dieser Modifikation verbessert sich die Bluetooth-Reichweite deutlich.

6.7. F: Mein RAK/T1000-E/xiao_nRF52-Gerät scheint beschädigt zu sein – wie setze ich es komplett zurück?

A:
  1. USB-C-Kabel mit dem Gerät verbinden und das Gerät laut Geräteanleitung in den Flash-Modus versetzen:
- Bei RAK: Reset-Taste zweimal schnell drücken - Bei T1000-E: Die magnetische Seite des Kabels zweimal schnell vom Gerät trennen und wieder verbinden - Bei Heltec T114: Reset-Taste zweimal drücken (die untere Taste) - Bei Xiao nRF52: Reset-Taste einmal drücken. Falls das nicht funktioniert, die Reset-Taste schnell doppelt drücken. Falls auch das nicht funktioniert, die Platine vom PC trennen und wieder anschließen (Seeed Studio Wiki)
  1. Ein neuer Ordner erscheint auf dem Desktop deines Computers.
  2. Die Datei flash_erase*.uf2 für dein Gerät von herunterladen:
- RAK WisBlock und Heltec T114: Flash_erase-nRF32_softdevice_v6.uf2 - Seeed Studio Xiao nRF52 WIO: Flash_erase-nRF52_softdevice_v7.uf2
  1. Die UF2-Datei für dein Gerät in das Stammverzeichnis des neuen Ordners ziehen und ablegen.
  2. Warten, bis der Kopiervorgang abgeschlossen ist. Es kann ein Fehlerdialog erscheinen – diesen kannst du ignorieren.
  3. Gehe zu , klicke auf Console und wähle den seriellen Port deines angeschlossenen Geräts aus.
  4. Drücke in der Konsole Enter. Der Flash-Speicher sollte jetzt gelöscht sein.
  5. Jetzt kannst du die neueste MeshCore-Firmware auf dein Gerät flashen.
Separat dazu: Ab Firmware-Version 1.7.0 gibt es einen CLI-Rettungsmodus (Rescue Mode). Wenn dein Gerät einen User-Button hat (z. B. einige RAK, T114), kannst du den Rettungsmodus aktivieren, indem du den User-Button innerhalb von 8 Sekunden nach dem Booten gedrückt hältst. Danach kannst du die ‚Console' auf verwenden.

6.8. F: Der WebFlasher schlägt unter Linux mit „failed to open" fehl

A: Wenn der USB-Port nicht die richtigen Berechtigungen für diesen Vorgang hat, schlägt der Prozess mit folgendem Fehler fehl: NetworkError: Failed to execute 'open' on 'SerialPort': Failed to open serial port.

Dem Browser-Benutzer die nötigen Rechte geben:

# setfacl -m u:DEIN_BENUTZERNAME_HIER:rw /dev/ttyUSB0

---

7. Weitere Fragen

7.1. F: Wie aktualisiere ich nRF-Geräte (RAK, T114, Seeed XIAO) – Companion, Repeater und Room-Server – drahtlos per OTA mit der neuen, einfacheren DFU-App?

A: Die folgenden Schritte funktionieren sowohl auf Android als auch auf iOS, da nRF die Benutzeroberfläche beider Apps vereinheitlicht hat:
  1. Lade die DFU-App von nRF aus dem iOS App Store oder dem Android Play Store herunter. Du findest die App unter dem Suchbegriff nrf dfu – der vollständige Name lautet nRF Device Firmware Update.
  2. Lade auf die ZIP-Version der Firmware für dein nRF-Gerät herunter (z. B. RAK, Heltec T114 oder Seeed Studios Xiao).
  3. Melde dich über die MeshCore-App aus der Ferne mit Admin-Rechten beim Repeater an, den du aktualisieren möchtest.
  4. Wechsle zum Tab „Command Line" (Kommandozeile), tippe start ota ein und drücke Enter.
  5. Du solltest OK sehen – das bestätigt, dass das Repeater-Gerät jetzt im OTA-Modus ist.
  6. Öffne die DFU-App und tippe dann oben rechts auf Settings.
  7. Aktiviere Packet receipt notifications und ändere Number of Packets auf 10 für RAK bzw. 8 für T114. Der Wert 8 funktioniert auch für RAK.
  8. Wähle die heruntergeladene Firmware-ZIP-Datei aus.
  9. Wähle das Gerät aus, das du aktualisieren möchtest. Falls das gewünschte Gerät nicht in der Liste erscheint, versuche OTA auf dem Gerät erneut zu aktivieren.
  10. Falls das Gerät nicht gefunden wird, aktiviere Force Scanning in der DFU-App.
  11. Tippe auf Upload, um das OTA-Update zu starten.
  12. Bei einem Fehlschlag: Versuche, Bluetooth an deinem Handy ein- und auszuschalten. Falls das nicht hilft, starte dein Handy neu. Wenn die Aktualisierung immer wieder beim Schritt „Enabling Bootloader" fehlschlägt, vergiss das nRF-Board in den Bluetooth-Einstellungen deines iOS- oder Android-Geräts und koppele es erneut über die DFU-App.
  13. Warte, bis das Update abgeschlossen ist. Das kann einige Minuten dauern.
  14. Es wird dringend empfohlen, den OTAFIX-Bootloader zu installieren und zu verwenden: .
  15. Um einen Companion-Node per OTA zu aktualisieren, muss darauf mindestens Companion-Firmware v1.15 oder neuer laufen.
  16. Weitere Informationen zum OTA-Firmware-Flashen findest du im MeshCore-Blog:
- -

7.1.1 F: Kann ich den Seeed Studio Wio Tracker L1 Pro per OTA aktualisieren?

A: Du kannst diesen sichereren Bootloader auf den Wio Tracker L1 Pro flashen:

Sobald dieser Bootloader auf dem Gerät installiert ist, kannst du ein Over-the-Air-Update per Bluetooth auslösen, indem du den Knopf neben dem D-Pad gedrückt hältst und dann die Reset-Taste drückst. Folge danach derselben OTA-Update-Anleitung wie oben beschrieben. Den Schritt start ota kannst du überspringen und das Update direkt mit der DFU-App starten.

7.2. F: Wie aktualisiere ich ESP32-basierte Geräte drahtlos?

A: Für ESP32-basierte Geräte (z. B. Heltec V3):
  1. Lade auf die nicht-zusammengeführte (non-merged) Version der Firmware für dein ESP32-Gerät herunter (z. B. Heltec_v3_repeater-v1.6.2-4449fd3.bin – kein "merged" im Dateinamen).
  2. Melde dich über die MeshCore-App aus der Ferne mit Admin-Rechten beim Repeater an, den du aktualisieren möchtest.
  3. Wechsle zum Tab „Command Line", tippe start ota ein und drücke Enter.
  4. Du solltest OK sehen – das bestätigt, dass das Repeater-Gerät jetzt im OTA-Modus ist.
  5. Der Befehl start ota startet auf einem ESP32-basierten Gerät einen WLAN-Hotspot namens MeshCore OTA.
  6. Verbinde dich mit deinem Handy oder Computer mit dem Hotspot „MeshCore OTA".
  7. Öffne im Browser die Adresse und lade die non-merged Bin-Datei vom Flasher hoch.

7.3. F: Gibt es eine Möglichkeit, die Fehlerquote bei einem OTA-Firmware-Update (DFU) zu senken?

A: Ja, der Entwickler che aporeps hat einen verbesserten OTA-DFU-Bootloader für nRF52-basierte Geräte erstellt. Wenn dieser Bootloader erkennt, dass die Anwendungsfirmware ungültig ist, fällt er automatisch in den OTA-DFU-Modus zurück, sodass ein erneuter Flash-Versuch zur Wiederherstellung möglich ist. Der Bootloader enthält weitere Änderungen, die den OTA-DFU-Prozess fehlertoleranter machen.

Aktuelle Informationen findest du unter:

Derzeit werden folgende Boards unterstützt:

  • Heltec Automation Mesh Node T114 / HT-nRF5262
  • Nologo ProMicro NRF52840 (auch bekannt als SuperMini NRF52840)
  • Seeed Studio SenseCAP Card Tracker T1000-E
  • Seeed Studio Wio Tracker L1
  • Seeed Studio XIAO nRF52840 BLE
  • Seeed Studio XIAO nRF52840 BLE SENSE
  • RAK 4631
  • RAK WisMesh Tag (neu seit 28.11.2025)

7.4. F: Sind das MeshCore-Logo und die Schriftart verfügbar?

A: Ja, sie befinden sich im MeshCore-GitHub-Repository hier:

7.5. F: Wie ist das Format eines Kontakt- oder Kanal-QR-Codes?

A:

Kanal: meshcore://channel/add?name=&secret=

Kontakt: meshcore://contact/add?name=&public_key=&type=

Wobei &type folgende Werte haben kann:

  • chat = 1
  • repeater = 2
  • room = 3
  • sensor = 4

7.6. F: Wie verbinde ich mich per WLAN mit dem Companion, z. B. mit einem Heltec V3?

A: Die WLAN-Firmware muss selbst kompiliert werden, da die WLAN-SSID und das Passwort gesetzt werden müssen. Bearbeite WIFI_SSID und WIFI_PWD in ./variants/heltec_v3/platformio.ini und flashe die Firmware anschließend auf dein Gerät.

7.7. F: Ich habe ein Station G2, ein Heltec V4, einen Ikoka Stick oder ein Radio mit EByte E22-900M30S- oder E22-900M33S-Modul – wie sollte die Sendeleistung eingestellt sein?

A: Bei Companion-Radios kann die Sendeleistung in der Smartphone-App eingestellt werden. Bei Repeater- und Room-Server-Radios kann die Sendeleistung mit dem Kommandozeilenbefehl set tx gesetzt werden. Den aktuellen Wert erhält man mit dem Befehl get tx.

⚠️ WARNUNG: Diese Werte werden auf eigene Gefahr gesetzt. Falsche Leistungseinstellungen können die Funkhardware dauerhaft beschädigen.

Gerät / ModellRegion / BeschreibungIn-App-Einstellung (dBm)Ziel-FunkausgangsleistungAnmerkungen
Station G2
Referenz
US915 Max. Ausgangsleistung19 dBm36,5 dBm (4,46 W)
US915 Max. am 1-dB-Kompressionspunkt16 dBm35 dBm (3,16 W)1-dB-Kompressionspunkt
EU868 Max. am 1-dB-Kompressionspunkt15 dBm34,5 dBm (2,82 W)1-dB-Kompressionspunkt
US915 1-W-Ausgangsleistung10 dBm1 WBitte die örtlichen behördlichen Vorschriften beachten
EU868 1-W-Ausgangsleistung9 dBm1 WBitte die örtlichen behördlichen Vorschriften beachten
Ikoka Stick E22-900M30S1-W-Modell19 dBm1 WNICHT ÜBERSCHREITEN (Gefahr des Durchbrennens) Datenblatt
Ikoka Stick E22-900M33S2-W-Modell9 dBm2 WNICHT ÜBERSCHREITEN (Gefahr des Durchbrennens) Datenblatt Bitte die örtlichen behördlichen Vorschriften beachten
Heltec V4Standard-Ausgangsleistung10 dBm22 dBm (~0,15 W)
Hohe Ausgangsleistung22 dBm28 dBm (~0,5 W bis 0,6 W)

Quelle: docs.meshcore.io