Meshtastic Anleitung - Meshtastic MQTT Modul Konfiguration

Wenn Ihr Gerät über Wi-Fi oder Ethernet mit dem Internet verbunden ist, können Sie es aktivieren, Pakete an einen MQTT-Server weiterzuleiten. Dies ermöglicht es Benutzern im lokalen Mesh, mit Benutzern im Internet zu kommunizieren. Ein oder mehrere Kanäle müssen auch als Uplink und/oder Downlink aktiviert sein, damit Pakete von und/oder zu Ihrem Mesh übertragen werden können (siehe Kanäle).

Die Konfigurationsoptionen des MQTT-Moduls umfassen: Aktiviert, Serveradresse, Benutzername, Passwort, Verschlüsselung aktiviert, JSON aktiviert, TLS aktiviert, Root-Thema, Client-Proxy aktiviert, Kartenberichterstattung aktiviert (mit Positionsgenauigkeit und Veröffentlichungsintervall) und Okay zu MQTT. Die MQTT-Modulkonfiguration verwendet eine Admin-Nachricht, die ein ConfigModule.MQTT Protobuf sendet.

MQTT-Modul-Konfigurationswerte

Aktiviert: Aktiviert das MQTT-Modul.
Serveradresse: Der Server, der für MQTT verwendet werden soll. Wenn nicht gesetzt, wird der öffentliche Standardserver verwendet.
Benutzername: Der MQTT Server-Benutzername, der verwendet werden soll (am nützlichsten für einen benutzerdefinierten MQTT-Server). Wenn ein benutzerdefinierter Server verwendet wird, wird dies auch dann akzeptiert, wenn es leer ist. Wenn der öffentliche Standardserver verwendet wird, wird es nur akzeptiert, wenn es gesetzt ist; andernfalls verwendet das Gerät den Standardbenutzernamen.
Passwort: Das MQTT-Passwort, das verwendet werden soll (am nützlichsten für einen benutzerdefinierten MQTT-Server). Wenn ein benutzerdefinierter Server verwendet wird, wird dies auch dann akzeptiert, wenn es leer ist. Wenn der Standardserver verwendet wird, wird es nur akzeptiert, wenn es gesetzt ist; andernfalls verwendet das Gerät das Standardpasswort.
Verschlüsselung aktiviert: Ob verschlüsselte oder unverschlüsselte Pakete an den MQTT-Server gesendet werden, ist konfigurierbar. Unverschlüsselte Pakete können für externe Systeme nützlich sein, die Meshtastic-Pakete konsumieren möchten. Hinweis: Alle Nachrichten werden an den MQTT-Broker unverschlüsselt gesendet, wenn diese Option nicht aktiviert ist, selbst wenn Ihre Uplink-Kanäle Verschlüsselungsschlüssel eingestellt haben.
JSON aktiviert: JSON wird auf der nRF52-Plattform nicht unterstützt. Sie können das Senden und Empfangen von JSON-Paketen über MQTT aktivieren. Diese Pakete sind nicht verschlüsselt, bieten aber eine einfache Möglichkeit zur Integration mit Systemen, die JSON lesen können.
TLS aktiviert: Wenn auf true gesetzt, versuchen wir, eine sichere Verbindung mit TLS herzustellen.
Root-Thema: Das Root-Thema für MQTT-Nachrichten ist wichtig. Dies ist nützlich, wenn Sie einen einzelnen MQTT-Server für mehrere Meshtastic-Netzwerke nutzen und diese über ACLs trennen möchten.
Client-Proxy aktiviert: Wenn auf true gesetzt, verwendet das Gerät die Netzwerkverbindung des Clients (z. B. Ihres Telefons), um eine Verbindung zum MQTT Server herzustellen. Wenn auf false gesetzt, wird die eigene Netzwerkverbindung des Geräts verwendet, die über die Netzwerkeinstellungen aktiviert sein muss.

Kartenberichterstattung aktiviert

Verfügbar ab Firmware-Version 2.3.2 und höher: Wenn auf true gesetzt, sendet Ihr Knoten periodisch einen unverschlüsselten Kartenbericht an den MQTT Server zur Anzeige auf Online-Karten, die dieses Paket unterstützen. Dieser Bericht enthält folgende Informationen:

Der lange und kurze Name sowie die ID des Knotens
Die Position des Knotens (mit konfigurierbarer Genauigkeit) und Höhe
Das Hardwaremodell und die Rolle des Knotens
Die Firmware-Version des Knotens
Die LoRa Region, Modem-Voreinstellung und der primäre Kanalname des Knotens
Ob der Knoten auf dem Standardkanal mit einem bekannten Schlüssel erreichbar ist
Anzahl der lokalen Online-Knoten (in den letzten 2 Stunden gehört, ausgenommen solche, die über MQTT gehört wurden)

Kartenbericht Positionsgenauigkeit bezieht sich auf die Genauigkeit der Position im Kartenbericht, mit einer standardmäßigen maximalen Abweichung von etwa 1459m.

Intervall für Kartenbericht-Veröffentlichung gibt an, wie oft der Kartenbericht in Sekunden an den MQTT Server gesendet werden soll, mit einer Standardeinstellung von 900 Sekunden (15 Minuten).

MQTT Modul Konfigurationsclient

Android

MQTT Konfigurationsoptionen sind für Android verfügbar.

Öffnen Sie die Meshtastic App
Navigieren Sie zu: Vertikaler Ellipsenpunkt (3 Punkte oben rechts) > Funkkonfiguration > MQTT.

Apfel

Alle MQTT Konfigurationsoptionen sind auf iOS, iPadOS und macOS verfügbar. Um darauf zuzugreifen, gehen Sie zu: Einstellungen > Modulkonfiguration > MQTT.

CLI

Die folgenden Konfigurationsoptionen sind in der Python CLI verfügbar:

Einstellung	Akzeptable Werte	Standard
mqtt.enabled	true, false	FALSE
mqtt.address	string	mqtt.meshtastic.org
mqtt.username	string	meshdev
mqtt.password	string	large4cats
mqtt.encryption_enabled	true, false	FALSE
mqtt.json_enabled	true, false	FALSE
mqtt.tls_enabled	true, false	FALSE
mqtt.root	string
mqtt.proxy_to_client_enabled	true, false	FALSE
mqtt.map_reporting_enabled	true, false	FALSE

MQTT-Modul aktivieren/deaktivieren

meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false

MQTT JSON aktivieren/deaktivieren

meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false

HINWEIS: Da das Gerät nach jedem über die CLI gesendeten Befehl neu startet, wird empfohlen, Befehle beim Einstellen mehrerer Werte in einem Konfigurationsabschnitt als eine Kette zusammenzufassen. Zum Beispiel:

meshtastic --set mqtt.enabled true --set mqtt.json_enabled true

Web

Alle MQTT Modulkonfigurationsoptionen sind für die Web-Benutzeroberfläche verfügbar.

Zugriff auf den Standard-Öffentlichen Server

Android

MQTT-Modul aktivieren

Navigieren Sie zu: Vertikale Ellipse (3 Punkte oben rechts) > Funkkonfiguration > MQTT: Schalten Sie den Schieberegler für MQTT aktiviert ein und tippen Sie auf Senden.

Optional: Um die Internetverbindung Ihres Telefons zu verwenden, um Pakete über das Web zu senden und zu empfangen, aktivieren Sie auch den Schieberegler für MQTT Client Proxy und überspringen Sie den Schritt Netzwerkeinstellungen konfigurieren unten.

Kanal-Uplink & Downlink aktivieren

Navigieren Sie zu: Vertikale Ellipse (3 Punkte oben rechts) > Funkkonfiguration > Kanäle > LongFast: Schalten Sie die Schieberegler für Uplink aktiviert und Downlink aktiviert ein, tippen Sie dann auf Speichern und anschließend auf Senden.

Netzwerkeinstellungen konfigurieren

Navigieren Sie zu: Vertikale Ellipse (3 Punkte oben rechts) > Funkkonfiguration > Netzwerk: Schalten Sie den Schieberegler für WiFi aktiviert ein, geben Sie die SSID und das PSK für Ihr Netzwerk ein und tippen Sie dann auf Senden.

Apfel

Aktivieren Sie das MQTT-Modul Gehen Sie zu Einstellungen > MQTT: Schalten Sie den Schalter "MQTT enabled" auf EIN und tippen Sie dann auf Speichern.

Optional: Wenn Sie die Internetverbindung Ihres Telefons zum Senden und Empfangen von Paketen online nutzen möchten, aktivieren Sie auch den Schalter MQTT Client Proxy und überspringen Sie den untenstehenden Schritt "Netzwerkeinstellungen konfigurieren".

Aktivieren Sie den Kanal-Uplink & Downlink Gehen Sie zu Einstellungen > Kanäle > Primärkanal: Schalten Sie die Schalter "Uplink enabled" und "Downlink enabled" auf EIN, und tippen Sie dann auf Speichern.

Netzwerkeinstellungen einrichten Gehen Sie zu Einstellungen > Netzwerk: Schalten Sie den Schalter "WiFi enabled" auf EIN, geben Sie dann Ihre SSID und PSK für das Netzwerk ein und tippen Sie auf Speichern.

CLI

MQTT-Modul aktivieren

meshtastic --set mqtt.enabled true

Kanal-Uplink & Downlink aktivieren

meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0

oder zusammengefügt:

meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0

Netzwerkeinstellungen konfigurieren

meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "Ihr Netzwerk" meshtastic --set network.wifi_psk IhrPasswort

oder zusammengefügt:

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "Ihr Netzwerk" --set network.wifi_psk IhrPasswort

Web

Aktivieren Sie das MQTT-Modul Gehen Sie zu Config > Module Config > MQTT - Schalten Sie den Schalter "MQTT enabled" auf EIN - Klicken Sie auf das Speichern-Symbol.

Optional: Wenn Sie die Internetverbindung Ihres Clients zum Senden und Empfangen von Paketen online nutzen möchten, aktivieren Sie auch den Schieberegler "Proxy to Client Enabled" und überspringen Sie den untenstehenden Schritt "Netzwerkeinstellungen konfigurieren".

HINWEIS: Obwohl diese Option in Ihrer Benutzeroberfläche sichtbar sein könnte, ist der Client Proxy derzeit mit dem Web Client nicht funktionsfähig.

Aktivieren Sie den Kanal-Uplink & Downlink Gehen Sie zu Channels > Primary: Schalten Sie die Schalter für "Uplink Enabled" und "Downlink Enabled" auf EIN - Klicken Sie auf das Speichern-Symbol.

Netzwerkeinstellungen einrichten Gehen Sie zu Radio Config > Device > Network: Schalten Sie den Schalter "Enabled" auf EIN, geben Sie Ihre SSID und PSK für das Netzwerk ein und klicken Sie auf das Speichern-Symbol.