Als uw apparaat via Wi-Fi of Ethernet met het internet is verbonden, kunt u het inschakelen om pakketten door te sturen naar een MQTT server. Dit stelt gebruikers op het lokale mesh-netwerk in staat te communiceren met gebruikers op het internet. Eén of meer kanalen moeten ook worden ingeschakeld als uplink en/of downlink om pakketten van en/of naar uw mesh te verzenden (zie kanalen).
De configuratieopties van de MQTT-module omvatten: Ingeschakeld, Serveradres, Gebruikersnaam, Wachtwoord, Encryptie ingeschakeld, JSON ingeschakeld, TLS ingeschakeld, Root Topic, Client Proxy ingeschakeld, Map Reporting ingeschakeld (met Positieprecisie en Publicatie-interval), en Okay to MQTT. De MQTT-moduleconfiguratie gebruikt een admin-bericht dat een ConfigModule.MQTT protobuf verzendt.
Configuratiewaarden voor de MQTT-module
-
Ingeschakeld: Schakelt de MQTT-module in.
-
Serveradres: De server die voor MQTT wordt gebruikt. Als deze niet is ingesteld, wordt de standaard openbare server gebruikt.
-
Gebruikersnaam: De MQTT servergebruikersnaam om te gebruiken (meest nuttig voor een aangepaste MQTT-server). Als u een aangepaste server gebruikt, wordt dit gerespecteerd, zelfs als het leeg is. Als u de standaard openbare server gebruikt, wordt het alleen gerespecteerd als het is ingesteld; anders gebruikt het apparaat de standaardgebruikersnaam.
-
Wachtwoord: Het MQTT wachtwoord om te gebruiken (meest nuttig voor een aangepaste MQTT-server). Als u een aangepaste server gebruikt, wordt dit gerespecteerd, zelfs als het leeg is. Als u de standaardserver gebruikt, wordt het alleen gerespecteerd als het is ingesteld; anders gebruikt het apparaat het standaardwachtwoord.
-
Encryptie ingeschakeld: Of er versleutelde of onversleutelde pakketten naar de MQTT-server worden gestuurd, is configureerbaar. Onversleutelde pakketten kunnen nuttig zijn voor externe systemen die Meshtastic-pakketten willen gebruiken. Opmerking: Alle berichten worden onversleuteld naar de MQTT-broker gestuurd als deze optie niet is ingeschakeld, zelfs wanneer uw uplink-kanalen encryptiesleutels hebben ingesteld.
-
JSON Ingeschakeld: JSON wordt niet ondersteund op het nRF52-platform. Je kunt het verzenden en ontvangen van JSON-pakketten op MQTT inschakelen. Deze pakketten zijn niet versleuteld maar bieden een gemakkelijke manier om te integreren met systemen die JSON kunnen lezen.
-
TLS Ingeschakeld: Als ingesteld op true, zullen we proberen een beveiligde verbinding tot stand te brengen met TLS.
-
Root Topic: Het root topic dat wordt gebruikt voor MQTT-berichten is belangrijk. Dit is handig als je één MQTT server wilt gebruiken voor meerdere Meshtastic netwerken en deze wilt scheiden via ACLs.
-
Client Proxy Ingeschakeld: Als ingesteld op true, zal het apparaat de netwerkverbinding van de client (bijv. je telefoon) gebruiken om verbinding te maken met de MQTT server. Als ingesteld op false, zal het de eigen netwerkverbinding van het apparaat gebruiken, die moet worden ingeschakeld via de netwerkinstellingen.
Kaartrapportage ingeschakeld
Beschikbaar vanaf firmwareversie 2.3.2 en verder, als ingesteld op true, zal je knooppunt periodiek een onversleuteld kaartrapport naar de MQTT server sturen voor weergave op online kaarten die dit pakket ondersteunen. Dit rapport bevat de volgende informatie:
-
De lange en korte naam en ID van het knooppunt
-
De positie van het knooppunt (met configureerbare precisie) en hoogte
-
Het hardwaremodel en de rol van het knooppunt
-
De firmwareversie van het knooppunt
-
De LoRa regio, modem preset en primaire kanaalnaam van het knooppunt
-
Of het knooppunt bereikbaar is op het standaardkanaal met een bekende key
-
Aantal lokale online knooppunten (gehoord in de laatste 2 uur, exclusief die via MQTT)
Precisie van de positie in het kaartrapport verwijst naar de precisie die wordt gebruikt voor de positie in het kaartrapport, met een standaard maximale afwijking van ongeveer 1459m.
Interval voor het publiceren van kaartrapporten geeft aan hoe vaak het kaartrapport naar de MQTT server moet worden gepubliceerd in seconden, met een standaardinstelling van 900 seconden (15 minuten).
MQTT Module Configuratie Client
Android
MQTT Configuratie opties zijn beschikbaar voor Android.
-
open de Meshtastic App
-
Navigeer naar: Verticale Ellipsis (3 puntjes rechtsboven) > Radio Configuratie > MQTT.
Appel
Alle MQTT configuratie opties zijn beschikbaar op iOS, iPadOS en macOS. Om ze te openen, ga naar: Instellingen > Moduleconfiguratie > MQTT.
CLI
De volgende configuratieopties zijn beschikbaar in de Python CLI:
| Instelling | Acceptabele waarden | Standaard |
| 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 Module In-/Uitschakelen
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
-
MQTT JSON In-/Uitschakelen
meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false
OPMERKING: Omdat het apparaat zal herstarten na elke opdracht die via de CLI wordt verzonden, wordt aanbevolen om opdrachten samen te voegen als één wanneer je meerdere waarden instelt in een configuratiesectie. Bijvoorbeeld:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true
Web
Alle MQTT moduleconfiguratie opties zijn beschikbaar voor de Web UI.
Toegang tot de Standaard Openbare Server
Android
-
Activeer de MQTT-module
Navigeer naar: Verticale Ellipsis (3 puntjes rechtsboven) > Radio Configuratie > MQTT: Zet de schuifregelaar aan voor MQTT ingeschakeld en tik op Verzenden.
Optioneel: Om de internetverbinding van je telefoon te gebruiken om pakketten via het web te verzenden en ontvangen, zet ook de schuifregelaar aan voor MQTT Client Proxy en sla de stap Netwerkinstellingen configureren hieronder over.
-
Kanaal Uplink & Downlink inschakelen
Navigeer naar: Verticale Ellipsis (3 puntjes rechtsboven) > Radio Configuratie > Kanalen > LongFast: Zet de schuifregelaars aan voor Uplink ingeschakeld en Downlink ingeschakeld, tik dan op Opslaan en tik op Verzenden.
-
Netwerkinstellingen configureren
Navigeer naar: Verticale Ellipsis (3 puntjes rechtsboven) > Radio Configuratie > Netwerk: Zet de schuifregelaar aan voor WiFi ingeschakeld, voer de SSID en PSK van je netwerk in, en tik dan op Verzenden.
Appel
-
Activeer de MQTT-module Ga naar Instellingen > MQTT: Zet de MQTT ingeschakeld schakelaar op AAN en tik vervolgens op Opslaan.
Optioneel: Als u de internetverbinding van uw telefoon wilt gebruiken om pakketten online te verzenden en ontvangen, zet dan ook de MQTT Client Proxy schakelaar aan en sla de stap Netwerkinstellingen configureren hieronder over.
-
Kanaal Uplink & Downlink activeren Ga naar Instellingen > Kanalen > Primair kanaal: Zet de schakelaars Uplink ingeschakeld en Downlink ingeschakeld op AAN, tik vervolgens op Opslaan.
-
Netwerkinstellingen configureren Ga naar Instellingen > Netwerk: Zet de WiFi ingeschakeld schakelaar op AAN, voer vervolgens uw SSID en PSK voor het netwerk in en tik op Opslaan.
CLI
-
Activeer de MQTT-module
meshtastic --set mqtt.enabled true
-
Kanaal Uplink & Downlink inschakelen
meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0
of aan elkaar gekoppeld:
meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0
-
Netwerkinstellingen configureren
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "uw netwerk" meshtastic --set network.wifi_psk uwwachtwoord
of aan elkaar gekoppeld:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "uw netwerk" --set network.wifi_psk uwwachtwoord
Web
-
Activeer de MQTT-module Ga naar Config > Module Config > MQTT - Zet de MQTT ingeschakeld schakelaar op AAN - Klik op het Opslaan-pictogram.
Optioneel: Als u de internetverbinding van uw client wilt gebruiken om pakketten online te verzenden en ontvangen, zet dan ook de Proxy naar Client Ingeschakeld schuifregelaar aan en sla de stap Netwerkinstellingen configureren hieronder over.
OPMERKING: Hoewel deze optie mogelijk zichtbaar is in uw UI, is de Client Proxy momenteel niet operationeel met de Web Client.
-
Kanaal Uplink & Downlink activeren Ga naar Kanalen > Primair: Zet de schakelaars voor Uplink Ingeschakeld en Downlink Ingeschakeld op AAN - Klik op het Opslaan-pictogram.
-
Netwerkinstellingen configureren Ga naar Radio Config > Apparaat > Netwerk: Zet de schakelaar Ingeschakeld op AAN, voer uw SSID en PSK voor het netwerk in en klik op het Opslaan-pictogram.
