Om din enhet är ansluten till Internet via Wi-Fi eller Ethernet kan du aktivera den för att vidarebefordra paket till en MQTT-server. Detta gör det möjligt för användare i det lokala nätverket att kommunicera med användare på Internet. En eller flera kanaler måste också vara aktiverade som uplink och/eller downlink för att paket ska kunna skickas från och/eller till ditt nätverk (se kanaler).
Konfigurationsalternativen för MQTT-modulen inkluderar: Aktiverad, Serveradress, Användarnamn, Lösenord, Kryptering aktiverad, JSON aktiverad, TLS aktiverad, Root Topic, Klientproxy aktiverad, Kartrapportering aktiverad (med positionsprecision och publiceringsintervall) och Okay to MQTT. MQTT-modulens konfiguration använder ett administratörsmeddelande som skickar en ConfigModule.MQTT protobuf.
Konfigurationsvärden för MQTT-modulen
-
Aktiverad: Aktiverar MQTT-modulen.
-
Serveradress: Servern som ska användas för MQTT. Om den inte är inställd kommer standardservern att användas.
-
Användarnamn: MQTT-serverns användarnamn som ska användas (mest användbart för en anpassad MQTT-server). Om du använder en anpassad server, kommer detta att respekteras även om det är tomt. Om du använder standardservern, kommer det endast att respekteras om det är inställt; annars kommer enheten att använda standardanvändarnamnet.
-
Lösenord: MQTT-lösenordet som ska användas (mest användbart för en anpassad MQTT-server). Om du använder en anpassad server, kommer detta att respekteras även om det är tomt. Om du använder standardservern, kommer det endast att respekteras om det är inställt; annars kommer enheten att använda standardlösenordet.
-
Kryptering aktiverad: Det går att konfigurera om krypterade eller okrypterade paket ska skickas till MQTT-servern. Okrypterade paket kan vara användbara för externa system som vill ta emot Meshtastic-paket. Observera: Alla meddelanden skickas till MQTT-brokern okrypterade om detta alternativ inte är aktiverat, även när dina uplink-kanaler har krypteringsnycklar inställda.
-
JSON aktiverat: JSON stöds inte på nRF52-plattformen. Du kan aktivera sändning och mottagning av JSON-paket på MQTT. Dessa paket är inte krypterade men ger ett enkelt sätt att integrera med system som kan läsa JSON.
-
TLS aktiverat: Om inställt på true kommer vi att försöka upprätta en säker anslutning med TLS.
-
Root Topic: Root topic som används för MQTT-meddelanden är viktigt. Detta är användbart om du vill använda en enda MQTT-server för flera Meshtastic-nätverk och separera dem via ACLs.
-
Klientproxy aktiverad: Om inställt på true kommer enheten att använda klientens (t.ex. din telefons) nätverksanslutning för att ansluta till MQTT servern. Om inställt på false kommer den att använda enhetens egen nätverksanslutning, som måste aktiveras via nätverksinställningarna.
Kartrapportering aktiverad
Tillgängligt från firmwareversion 2.3.2 och framåt, om inställt på true kommer din nod periodiskt att skicka en okrypterad kartrapport till MQTT servern för visning på onlinekartor som stöder detta paket. Denna rapport inkluderar följande information:
-
Nodens långa och korta namn samt ID
-
Nodens position (med konfigurerbar precision) och höjd
-
Nodens hårdvarumodell och roll
-
Nodens firmwareversion
-
Nodens LoRa region, modemförinställning och primära kanalnamn
-
Om noden kan nås på standardkanalen med en känd nyckel
-
Antal lokala online-noder (hörda under de senaste 2 timmarna, exklusive de som hörts via MQTT)
Precision för kartrapportens position avser precisionen som används för positionen i kartrapporten, med en standardmaxavvikelse på cirka 1459m.
Intervall för publicering av kartrapport anger hur ofta kartrapporten ska publiceras till MQTT servern i sekunder, med standardinställningen 900 sekunder (15 minuter).
MQTT Modulkonfigurationsklient
Android
MQTT Konfigurationsalternativ finns tillgängliga för Android.
-
öppna Meshtastic App
-
Navigera till: Vertikal ellipsis (3 prickar uppe till höger) > Radiokonfiguration > MQTT.
Äpple
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 | 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 |
-
Aktivera/avaktivera MQTT-modul
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
-
Aktivera/avaktivera 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 du ställer in flera värden i en konfigurationssektion. Till exempel:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true
Webb
Alla MQTT modulkonfigurationsalternativ finns tillgängliga för Webbgränssnittet.
Få tillgång till standard offentliga servern
Android
-
Aktivera MQTT-modulen
Navigera till: Vertikal ellipsis (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.
-
Aktivera kanalens uplink & downlink
Navigera till: Vertikal ellipsis (3 prickar uppe till höger) > Radiokonfiguration > Kanaler > LongFast: Slå på reglagen för Uplink aktiverad och Downlink aktiverad, tryck sedan på Spara och tryck på Skicka.
-
Konfigurera nätverksinställningar
Navigera till: Vertikal ellips (3 prickar uppe till höger) > Radio Configuration > Network: Slå på reglaget för WiFi enabled, ange SSID och PSK för ditt nätverk, tryck sedan på Send.
Äpple
-
Aktivera MQTT-modulen Gå till Settings > MQTT: Växla MQTT enabled-strömbrytaren 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 MQTT Client Proxy-reglaget och hoppa över steget Konfigurera nätverksinställningar nedan.
-
Aktivera kanalens uplink & downlink Gå till Settings > Channels > Primary Channel: Växla strömbrytarna Uplink enabled och Downlink enabled till PÅ-läge, tryck sedan på Spara.
-
Ställ in nätverksinställningar Gå till Settings > Network: Växla WiFi enabled-strömbrytaren till PÅ, ange sedan ditt SSID och PSK för nätverket och tryck på Spara.
CLI
-
Aktivera MQTT-modulen
meshtastic --set mqtt.enabled true
-
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
-
Konfigurera nätverksinställningar
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "your network" meshtastic --set network.wifi_psk yourpassword
eller kedjade tillsammans:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network" --set network.wifi_psk yourpassword
Webb
-
Aktivera MQTT-modulen Gå till Config > Module Config > MQTT - Växla strömbrytaren 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.
-
Aktivera kanalens uplink & downlink Gå till Channels > Primary: Växla strömbrytarna för Uplink Enabled och Downlink Enabled till PÅ-läge - Klicka på Spara-ikonen.
-
Ställ in nätverksinställningar Gå till Radio Config > Device > Network: Växla strömbrytaren Enabled till PÅ-läge, ange ditt SSID och PSK för nätverket och klicka på Spara-ikonen.
