Meshtastic Guide - Meshtastic MQTT-modulkonfiguration

Meshtastic MQTT-modul gör det möjligt för LoRa-mesh-enheter att vidarebefordra paket säkert till en MQTT-server via Wi-Fi eller Ethernet. Detta tillåter lokala Meshtastic Remote Nodes att kommunicera med internetanslutna användare. För att använda denna funktion måste en eller flera kanaler aktiveras som uplink och/eller downlink för paketöverföring.

MQTT-modulens konfiguration inkluderar alternativ som: Aktiverad, Serveradress, Användarnamn, Lösenord, Kryptering aktiverad, JSON aktiverat, TLS aktiverat, Rotämne, Klientproxy aktiverad, Kartrapportering aktiverad (med positionsprecision och publiceringsintervall) samt Okay to MQTT. Konfiguration hanteras via ConfigModule.MQTT protobuf-meddelanden.

Konfigurationsvärden för MQTT-modulen

  • Aktiverad: Aktiverar MQTT-modulen.
  • Serveradress: Definierar MQTT-servern. Om ej angiven används standard offentlig server.
  • Användarnamn: Användarnamn för MQTT-servern. Krävs för egna servrar; standardvärden gäller för offentliga servrar.
  • Lösenord: Lösenord för MQTT-servern. Krävs för egna servrar; standardvärden gäller för offentliga servrar.
  • Kryptering aktiverad: Bestämmer om paket skickas krypterade eller okrypterade. Okrypterade paket är användbara för externa system som tar emot Meshtastic-paket.
  • JSON aktiverat: Tillåter att skicka och ta emot JSON-paket via MQTT. Användbart för integration med JSON-kompatibla system.
  • TLS aktiverat: Aktiverar säker anslutning med TLS.
  • Rotämne: Definierar MQTT-rotämnet för att separera flera Meshtastic LoRa-nätverk.
  • Klientproxy aktiverad: Om sant används klientenhetens nätverksanslutning för att ansluta till MQTT-servern.

Kartrapportering aktiverad

Från firmware 2.3.2+ tillåter aktivering av kartrapportering att noder skickar periodiska okrypterade kartrapporter till MQTT-brokern. Rapporter inkluderar:

  • Nodens långa/korta namn och ID
  • Position och höjd
  • Hårdvarumodell och roll
  • Firmware-version
  • LoRa-region, modemförinställning och primärt kanalnamn
  • Räckvidd på standardkanal med känd nyckel
  • Antal lokala online-noder (senaste 2 timmarna, exklusive MQTT)

Precision för kartrapportens position: Standardavvikelse ~1459 m.
Intervall för publicering av kartrapport: Standard 900 sekunder (15 minuter).

MQTT-modulkonfiguration Klient

Android

  1. Öppna Meshtastic-appen
  2. Navigera: Vertikal Ellips (3 prickar) > Radiokonfiguration > MQTT

Apple

iOS, iPadOS, macOS, gå till: Inställningar > Modulkonfiguration > MQTT.

CLI

Med Python CLI inkluderar konfigurationsalternativ:

Inställning Värden Standard
mqtt.enabled sant, falskt false
mqtt.address sträng mqtt.meshtastic.org
mqtt.username sträng meshdev
mqtt.password sträng large4cats
mqtt.encryption_enabled sant, falskt false
mqtt.json_enabled sant, falskt false
mqtt.tls_enabled sant, falskt false
mqtt.root sträng
mqtt.proxy_to_client_enabled sant, falskt false
mqtt.map_reporting_enabled sant, falskt false

Exempel:

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

Observera: Enheter startar om efter varje CLI-kommando. Kedja ihop kommandon när du ställer in flera värden.

Webb

Alla MQTT-modulens konfigurationsalternativ finns tillgängliga via Webbgränssnittet.

Åtkomst till standard offentlig server

Android

  1. Aktivera MQTT-modulen: Navigera till Radio Configuration > MQTT, slå på Aktiverad och tryck på Skicka.

Valfritt: För att använda din telefons internetanslutning för att skicka och ta emot paket över webben, aktivera även reglaget för MQTT Client Proxy och hoppa över steget Konfigurera nätverksinställningar nedan.

  1. Aktivera kanal Uplink & Downlink: Navigera till Radio Configuration > Channels > LongFast, slå på Uplink aktiverad och Downlink aktiverad, tryck sedan på Spara och Skicka.
  1. Konfigurera nätverksinställningar: Navigera till Radio Configuration > Network, aktivera Wi-Fi, ange SSID och PSK, tryck sedan på Skicka.

Apple

  1. Aktivera MQTT-modulen: Gå till Inställningar > MQTT, slå på Aktiverad och tryck på Spara.

Meshtastic MQTT-modulkonfiguration erbjuder ett säkert och flexibelt sätt att integrera LoRa-meshnätverk med internetbaserade MQTT-servrar. Genom att aktivera funktioner som TLS-kryptering, JSON-integration och Kartrapportering kan administratörer utöka kommunikationen för Meshtastic Remote Node till molntjänster, IoT-plattformar och online-instrumentpaneler.

Denna konfiguration säkerställer att Meshtastic-enheter kan fungera som gateways mellan lokala LoRa-meshnätverk och globala MQTT-brokers, vilket möjliggör sömlös datautbyte. Med uplink- och downlink-kanaler korrekt konfigurerade kan noder överföra sensordata, positionsinformation och statusuppdateringar till externa system i realtid.

Nyckelfördelar med att aktivera Meshtastic MQTT-modul inkluderar:

  • Säker kommunikation: Använd TLS och krypteringsnycklar för att skydda dataintegriteten.
  • Flexibel integration: Stöd för JSON-paket gör det enkelt att ansluta till IoT-instrumentpaneler och tredjepartsapplikationer.
  • Skalbara nätverk: Konfigurera Root Topics för att separera flera Meshtastic LoRa-nätverk på samma server.
  • Fjärrhantering av noder: Aktivera Client Proxy för att använda mobila enheter som gateways för fjärradministration.
  • Kartrapportering: Dela nodpositioner, firmwareversioner och LoRa-region detaljer för visualisering på onlinekartor.

Oavsett om du använder Android, Apple-enheter, CLI-verktyg eller Webbgränssnittet, kan administratörer konfigurera MQTT-modulen för att passa deras distributionsbehov. Detta gör Meshtastic MQTT-integration till en kraftfull lösning för att utöka meshkommunikation bortom lokal radiotäckning till det globala internet.

Sammanfattningsvis bygger Meshtastic MQTT-modulkonfiguration en bro mellan LoRa-meshnätverk och MQTT molntjänster, vilket möjliggör säker, skalbar och flexibel kommunikation för IoT-applikationer, smarta städer och fjärrövervakningsprojekt.

MQTT-modulkonfiguration Klient

Android

MQTT konfigurationsalternativ finns tillgängliga för Android.
  1. öppna Meshtastic-appen
  2. Navigera till: Vertikal ellips (3 prickar uppe till höger) > Radiokonfiguration > MQTT.

Apple

Alla MQTT konfigurationsalternativ finns tillgängliga på iOS, iPadOS och macOS. För att komma åt dem, gå till: Inställningar > Modulkonfiguration > MQTT.

CLI

Följande konfigurationsalternativ finns tillgängliga i Python CLI:
Inställning Acceptabla värden Standard
mqtt.enabled sant, falskt FALSKT
mqtt.address sträng mqtt.meshtastic.org
mqtt.username sträng meshdev
mqtt.password sträng large4cats
mqtt.encryption_enabled sant, falskt FALSKT
mqtt.json_enabled sant, falskt FALSKT
mqtt.tls_enabled sant, falskt FALSKT
mqtt.root sträng
mqtt.proxy_to_client_enabled sant, falskt FALSKT
mqtt.map_reporting_enabled sant, falskt FALSKT
  • Aktivera/Inaktivera MQTT-modul
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
  • Aktivera/Inaktivera MQTT JSON
meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false
OBS: Eftersom enheten kommer att starta om efter varje kommando som skickas via CLI, rekommenderas det att kedja ihop kommandon som ett när flera värden ska ställas in i en konfigurationssektion. Till exempel:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true

Webb

Alla MQTT modulkonfigurationsalternativ är tillgängliga för Webbgränssnittet.

Åtkomst till standard offentlig server

Android

  1. Aktivera MQTT-modulen
Navigera till: Vertikal ellips (3 prickar uppe till höger) > Radiokonfiguration > MQTT: Slå på reglaget för MQTT aktiverad och tryck på Skicka.

Valfritt: För att använda din telefons internetanslutning för att skicka och ta emot paket över webben, aktivera även reglaget för MQTT Client Proxy och hoppa över steget Konfigurera nätverksinställningar nedan.

  1. Aktivera kanalens uplink & downlink
Navigera till: Vertikal ellips (3 prickar uppe till höger) > Radio Configuration > Channels > LongFast: Slå på reglagen för Uplink aktiverat och Downlink aktiverat, tryck sedan på Spara och tryck på Skicka.

  1. Konfigurera nätverksinställningar
Navigera till: Vertikal ellips (3 prickar uppe till höger) > Radio Configuration > Network: Slå på reglaget för WiFi aktiverat, ange SSID och PSK för ditt nätverk, tryck sedan på Skicka.

Apple

  1. Aktivera MQTT-modulen Gå till Inställningar > MQTT: Växla MQTT aktiverat-reglaget till PÅ och tryck sedan på Spara.
Valfritt: Om du vill använda din telefons internetanslutning för att skicka och ta emot paket online, aktivera även reglaget MQTT Client Proxy och hoppa över steget Konfigurera nätverksinställningar nedan.

  1. Aktivera kanalens uplink & downlink Gå till Inställningar > Kanaler > Primär kanal: Växla reglagen Uplink enabled och Downlink enabled till PÅ, tryck sedan på Spara.
  1. Ställ in nätverksinställningar Gå till Inställningar > Nätverk: Växla WiFi aktiverat-reglaget till PÅ, ange sedan ditt SSID och PSK för nätverket och tryck på Spara.

CLI

  1. Aktivera MQTT-modulen
meshtastic --set mqtt.enabled true
  1. Aktivera kanalens uplink & downlink
meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0
eller kedjade tillsammans:
meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0
  1. Konfigurera nätverksinställningar
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "ditt nätverk" meshtastic --set network.wifi_psk dittlösenord
eller kedjade tillsammans:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "ditt nätverk" --set network.wifi_psk dittlösenord

Webb

  1. Aktivera MQTT-modulen Gå till Config > Module Config > MQTT - Växla reglaget MQTT enabled till PÅ - Klicka på Spara-ikonen.
Valfritt: Om du vill använda din klients internetanslutning för att skicka och ta emot paket online, aktivera även reglaget Proxy to Client Enabled och hoppa över steget Konfigurera nätverksinställningar nedan.
OBS: Även om detta alternativ kan vara synligt i ditt gränssnitt är Client Proxy för närvarande inte operativ med Web Client.
  1. Aktivera kanalens uplink & downlink Gå till Channels > Primary: Växla reglagen för Uplink Enabled och Downlink Enabled till PÅ - Klicka på Spara-ikonen.
  1. Ställ in nätverksinställningar Gå till Radio Config > Device > Network: Växla reglaget Aktiverad till PÅ, ange ditt SSID och PSK för nätverket och klicka på Spara-ikonen.

Anmäl dig till vårt nyhetsbrev

Få den senaste informationen om våra produkter och specialerbjudanden.

Website Feedback

Help us improve OpenELAB

Found a website issue or have an idea? Tell us what would make your experience better.