Meshtastic-guide – Konfiguration af Meshtastic MQTT-modulet

Meshtastic MQTT-modulet gør det muligt for LoRa-mesh-enheder at videresende pakker sikkert til en MQTT-server via Wi-Fi eller Ethernet. Det giver lokale Meshtastic-fjernknudepunkter mulighed for at kommunikere med internetforbundne brugere. For at bruge denne funktion skal en eller flere kanaler aktiveres som uplink og/eller downlink til pakkeoverførsel.

MQTT-modulkonfigurationen omfatter indstillinger som: Aktiveret, Serveradresse, Brugernavn, Adgangskode, Kryptering aktiveret, JSON aktiveret, TLS aktiveret, Rodemne, Klientproxy aktiveret, Kortpublicering aktiveret (med positionspræcision og publiceringsinterval) samt Tillad MQTT. Konfigurationen håndteres via meddelelser af typen ConfigModule.MQTT protobuf.

Konfigurationsværdier for MQTT-modulet

• Aktiveret: Aktiverer MQTT-modulet.
• Serveradresse: Definerer MQTT-serveren. Hvis den ikke er angivet, bruges den offentlige standardserver.
• Brugernavn: MQTT-serverens brugernavn. Påkrævet for brugerdefinerede servere; standardværdier gælder for offentlige servere.
• Adgangskode: MQTT-serverens adgangskode. Påkrævet for brugerdefinerede servere; standardværdier gælder for offentlige servere.
• Kryptering aktiveret: Afgør, om pakker sendes krypteret eller ukrypteret. Ukrypterede pakker er nyttige for eksterne systemer, der modtager Meshtastic-pakker.
• JSON aktiveret: Tillader afsendelse og modtagelse af JSON-pakker via MQTT. Nyttigt til integration med JSON-kompatible systemer.
• TLS aktiveret: Aktiverer en sikker forbindelse ved hjælp af TLS.
• Rodemne: Definerer MQTT-rodemnet til adskillelse af flere Meshtastic-LoRa-netværk.
• Klientproxy aktiveret: Hvis den er aktiveret, bruges klientenhedens netværksforbindelse til at oprette forbindelse til MQTT-serveren.

Kortpublicering aktiveret

Fra firmware 2.3.2+ gør aktivering af kortpublicering det muligt for knudepunkter at sende periodiske ukrypterede kortdata til MQTT-brokeren. Rapporterne indeholder:

• Knudepunktets lange/korte navn og id
• Position og højde
• Hardwaremodel og rolle
• Firmwareversion
• LoRa-region, modemforudindstilling og primærkanalens navn
• Tilgængelighed på standardkanalen med kendt nøgle
• Antal lokale onlineknudepunkter (seneste 2 timer, eksklusive MQTT)

Positionspræcision for kortdata: Standardafvigelse ~1459 m.
Publiceringsinterval for kortdata: Standard er 900 sekunder (15 minutter).

Klient til MQTT-modulkonfiguration

Android

1. Åbn Meshtastic-appen
2. Naviger: lodret ellipse (3 prikker) > Radiokonfiguration > MQTT

Apple

På iOS, iPadOS, macOS skal du gå til: Indstillinger > Modulkonfiguration > MQTT.

CLI

Ved hjælp af Python-CLI omfatter konfigurationsmulighederne:

Eksempler:

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

Bemærk: Enheder genstarter efter hver CLI-kommando. Kæd kommandoer sammen, når du indstiller flere værdier.

Web

Alle indstillinger for MQTT-modulkonfiguration er tilgængelige via webbrugerfladen.

Få adgang til den offentlige standardserver

Android

1. Aktivér MQTT-modulet: Gå til Radioindstillinger > MQTT, slå Aktiveret til, og tryk på Send.

Valgfrit: Hvis du vil bruge din telefons internetforbindelse til at sende og modtage pakker over internettet, skal du også aktivere skyderen MQTT-klientproxy og springe trinnet Konfigurer netværksindstillinger nedenfor over.

2. Aktivér kanal-uplink og -downlink: Gå til Radioindstillinger > Kanaler > LongFast, slå Uplink aktiveret og Downlink aktiveret til, og tryk derefter på Gem og Send.

3. Konfigurer netværksindstillinger: Gå til Radioindstillinger > Netværk, aktivér Wi-Fi, indtast SSID og PSK, og tryk derefter på Send.

Apple

1. Aktivér MQTT-modulet: Gå til Indstillinger > MQTT, slå Aktiveret til, og tryk på Gem.

Konfiguration af Meshtastic MQTT-modulet giver en sikker og fleksibel måde at integrere LoRa-meshnetværk med internetbaserede MQTT-servere. Ved at aktivere funktioner som TLS-kryptering, JSON-integration og kortrapportering kan administratorer udvide kommunikationen fra Meshtastic-fjernnoder til cloudtjenester, IoT-platforme og online-dashboards.

Denne konfiguration sikrer, at Meshtastic-enheder kan fungere som gateways mellem lokale LoRa-meshnetværk og globale MQTT-brokere, så data kan udveksles problemfrit. Når uplink- og downlink-kanaler er konfigureret korrekt, kan noder sende sensordata, positionsoplysninger og statusopdateringer til eksterne systemer i realtid.

De vigtigste fordele ved at aktivere Meshtastic MQTT-modulet omfatter:

• Sikker kommunikation: Brug TLS og krypteringsnøgler til at beskytte dataintegriteten.
• Fleksibel integration: Understøttelse af JSON-pakker gør det nemt at oprette forbindelse til IoT-dashboards og tredjepartsprogrammer.
• Skalerbare netværk: Konfigurer rodemner for at adskille flere Meshtastic LoRa-netværk på den samme server.
• Administration af fjernenheder: Aktivér Client Proxy for at bruge mobilenheder som gateways til fjernadministration.
• Kortindberetning: Del nodernes positioner, firmwareversioner og oplysninger om LoRa-region til visning på onlinekort.

Uanset om der bruges Android, Apple-enheder, CLI-værktøjer eller webbrugerfladen, kan administratorer konfigurere MQTT-modulet, så det passer til deres implementeringsbehov. Det gør Meshtastic MQTT-integration til en effektiv løsning til at udvide meshkommunikation ud over lokal radiodækning til det globale internet.

Sammenfattet bygger Meshtastic MQTT-modulkonfiguration bro mellem LoRa-meshnetværk og MQTT-cloudtjenester og muliggør sikker, skalerbar og fleksibel kommunikation til IoT-applikationer, intelligente byer og projekter til fjernovervågning.

Klient til MQTT-modulkonfiguration

Android

1. åbn Meshtastic-appen
2. Gå til: lodret ellipse (3 prikker øverst til højre) > Radiokonfiguration > MQTT.

Apple

CLI

• Aktivér/deaktivér MQTT-modul

• Aktivér/deaktivér MQTT JSON

Web

Få adgang til den offentlige standardserver

Android

1. Aktivér MQTT-modulet

2. Aktivér kanalens uplink og downlink

3. Konfigurer netværksindstillinger

Apple

1. Aktivér MQTT-modulet Gå til Settings > MQTT: Skift kontakten MQTT enabled til positionen ON, og tryk derefter på Save.

2. Aktivér kanalens uplink og downlink Gå til Settings > Channels > Primary Channel: Skift kontakterne Uplink enabled og Downlink enabled til positionen ON, og tryk derefter på Save.

3. Konfigurer netværksindstillinger Gå til Settings > Network: Skift kontakten WiFi enabled til ON, indtast derefter dit netværks SSID og PSK, og tryk på Save.

CLI

1. Aktivér MQTT-modulet

2. Aktivér kanalens uplink og downlink

3. Konfigurer netværksindstillinger

Web

1. Aktivér MQTT-modulet Gå til Config > Module Config > MQTT – skift kontakten MQTT enabled til ON – klik på ikonet Save.

2. Aktivér kanalens uplink og downlink Gå til Channels > Primary: Skift kontakterne for Uplink Enabled og Downlink Enabled til positionen ON – klik på ikonet Save.

3. Konfigurer netværksindstillinger Gå til Radio Configuration > Device > Network: Skift kontakten Enabled til positionen ON, indtast dit netværks SSID og PSK, og klik på ikonet Save.