Hvis din enhed er forbundet til internettet via Wi-Fi eller Ethernet, kan du aktivere den til at videresende pakker til en MQTT server. Dette gør det muligt for brugere på det lokale mesh at kommunikere med brugere på internettet. En eller flere kanaler skal også aktiveres som uplink og/eller downlink for at pakker kan transmitteres fra og/eller til dit mesh (se kanaler).
Konfigurationsmulighederne for MQTT-modulet inkluderer: Aktiveret, Serveradresse, Brugernavn, Adgangskode, Kryptering aktiveret, JSON aktiveret, TLS aktiveret, Rodemne, Klientproxy aktiveret, Kortrapportering aktiveret (med positionsnøjagtighed og udgivelsesinterval) og Okay til MQTT. MQTT-modulkonfigurationen bruger en adminbesked, der sender en ConfigModule.MQTT protobuf.
Konfigurationsværdier for MQTT-modulet
-
Aktiveret: Aktiverer MQTT-modulet.
-
Serveradresse: Serveren der skal bruges til MQTT. Hvis ikke sat, vil standard offentlig server blive anvendt.
-
Brugernavn: MQTT serverbrugernavnet der skal bruges (mest nyttig for en brugerdefineret MQTT-server). Hvis der bruges en brugerdefineret server, vil denne blive respekteret, selv hvis den er tom. Hvis der bruges standard offentlig server, vil den kun blive respekteret, hvis den er sat; ellers vil enheden bruge standardbrugernavnet.
-
Adgangskode: MQTT adgangskoden der skal bruges (mest nyttig for en brugerdefineret MQTT-server). Hvis der bruges en brugerdefineret server, vil denne blive respekteret, selv hvis den er tom. Hvis der bruges standardserveren, vil den kun blive respekteret, hvis den er sat; ellers vil enheden bruge standardadgangskoden.
-
Kryptering aktiveret: Det er konfigurerbart, om der skal sendes krypterede eller ukrypterede pakker til MQTT-serveren. Ukrypterede pakker kan være nyttige for eksterne systemer, der ønsker at modtage Meshtastic-pakker. Bemærk: Alle beskeder sendes til MQTT-brokeren ukrypteret, hvis denne mulighed ikke er aktiveret, selv når dine uplink-kanaler har krypteringsnøgler indstillet.
-
JSON Aktiveret: JSON understøttes ikke på nRF52-platformen. Du kan aktivere afsendelse og modtagelse af JSON-pakker på MQTT. Disse pakker er ikke krypterede, men giver en nem måde at integrere med systemer, der kan læse JSON.
-
TLS Aktiveret: Hvis sat til true, vil vi forsøge at etablere en sikker forbindelse ved hjælp af TLS.
-
Rodemne: Rodemnet til brug for MQTT-beskeder er vigtigt. Dette er nyttigt, hvis du vil bruge en enkelt MQTT-server til flere Meshtastic netværk og adskille dem via ACL'er.
-
Klientproxy Aktiveret: Hvis sat til true, vil enheden bruge klientens (f.eks. din telefons) netværksforbindelse til at forbinde til MQTT serveren. Hvis sat til false, vil den bruge enhedens egen netværksforbindelse, som skal aktiveres via netværksindstillingerne.
Kortrapportering Aktiveret
Tilgængelig fra firmwareversion 2.3.2 og frem, hvis sat til true, vil din node periodisk sende en ukrypteret kortrapport til MQTT serveren til visning på online kort, der understøtter denne pakke. Denne rapport inkluderer følgende information:
-
Nodens lange og korte navn og ID
-
Nodens position (med konfigurerbar præcision) og højde
-
Nodens hardwaremodel og rolle
-
Nodens firmwareversion
-
Nodens LoRa region, modemforindstilling og primære kanalnavn
-
Om noden kan nås på standardkanalen med en kendt nøgle
-
Antal lokale online noder (hørt inden for de sidste 2 timer, ekskl. dem hørt via MQTT)
Præcision af Kortrapportposition refererer til den præcision, der bruges for positionen i kortrapporten, med en standard maksimal afvigelse på omkring 1459m.
Interval for Udgivelse af Kortrapport angiver, hvor ofte kortrapporten skal udgives til MQTT serveren i sekunder, med en standardindstilling på 900 sekunder (15 minutter).
MQTT Modul Konfigurationsklient
Android
MQTT Konfigurationsmuligheder er tilgængelige for Android.
-
åbn Meshtastic App
-
Naviger til: Vertikal Ellipse (3 prikker øverst til højre) > Radio Konfiguration > MQTT.
Æble
Alle MQTT konfig muligheder er tilgængelige på iOS, iPadOS og macOS. For at få adgang til dem, gå til: Indstillinger > Modul Konfiguration > MQTT.
CLI
Følgende konfigurationsmuligheder er tilgængelige i Python CLI:
| Indstilling | Acceptable Værdier | Standard |
| mqtt.enabled | true, false | FALSK |
| mqtt.address | string | mqtt.meshtastic.org |
| mqtt.username | string | meshdev |
| mqtt.password | string | large4cats |
| mqtt.encryption_enabled | true, false | FALSK |
| mqtt.json_enabled | true, false | FALSK |
| mqtt.tls_enabled | true, false | FALSK |
| mqtt.root | string | |
| mqtt.proxy_to_client_enabled | true, false | FALSK |
| mqtt.map_reporting_enabled | true, false | FALSK |
-
Aktiver/Deaktiver MQTT Modul
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
-
Aktiver/Deaktiver MQTT JSON
meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false
BEMÆRK: Da enheden vil genstarte efter hver kommando, der sendes via CLI, anbefales det at kæde kommandoer sammen som én, når flere værdier sættes i en konfigurationssektion. For eksempel:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true
Web
Alle MQTT modul konfig muligheder er tilgængelige for Web UI.
Få adgang til Standard Offentlig Server
Android
-
Aktivér MQTT-modulet
Naviger til: Vertikal Ellipse (3 prikker øverst til højre) > Radio Konfiguration > MQTT: Tænd for slideren for MQTT aktiveret og tryk på Send.
Valgfrit: For at bruge din telefons internetforbindelse til at sende og modtage pakker over nettet, aktiver også slideren for MQTT Client Proxy og spring Konfigurer Netværksindstillinger trin over nedenfor.
-
Aktivér kanal uplink & downlink
Naviger til: Vertikal Ellipse (3 prikker øverst til højre) > Radio Konfiguration > Kanaler > LongFast: Tænd for sliderne for Uplink aktiveret og Downlink aktiveret, tryk derefter på Gem og tryk på Send.
-
Konfigurer netværksindstillinger
Naviger til: Vertikal Ellipse (3 prikker øverst til højre) > Radio Konfiguration > Netværk: Tænd for slideren for WiFi aktiveret, indtast SSID og PSK for dit netværk, og tryk derefter på Send.
Æble
-
Aktivér MQTT-modulet Gå til Settings > MQTT: Skift "MQTT enabled"-knappen til ON og tryk derefter på Gem.
Valgfrit: Hvis du vil bruge din telefons internetforbindelse til at sende og modtage pakker online, skal du også aktivere MQTT Client Proxy-knappen og springe trin for Konfigurer netværksindstillinger over nedenfor.
-
Aktivér kanal uplink & downlink Gå til Settings > Channels > Primary Channel: Skift "Uplink enabled" og "Downlink enabled" knapperne til ON, og tryk derefter på Gem.
-
Konfigurer netværksindstillinger Gå til Settings > Network: Skift "WiFi enabled"-knappen til ON, indtast derefter dit SSID og PSK for netværket, og tryk på Gem.
CLI
-
Aktivér MQTT-modulet
meshtastic --set mqtt.enabled true
-
Aktivér kanal uplink & downlink
meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0
eller kædet sammen:
meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0
-
Konfigurer netværksindstillinger
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "dit netværk" meshtastic --set network.wifi_psk ditkodeord
eller kædet sammen:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "dit netværk" --set network.wifi_psk ditkodeord
Web
-
Aktivér MQTT-modulet Gå til Config > Module Config > MQTT - Skift "MQTT enabled"-knappen til ON - Klik på gem-ikonet.
Valgfrit: Hvis du vil bruge din klients internetforbindelse til at sende og modtage pakker online, skal du også aktivere "Proxy to Client Enabled"-skyderen og springe trin for Konfigurer netværksindstillinger over nedenfor.
NOTE: Selvom denne mulighed kan være synlig i din UI, er Client Proxy ikke i øjeblikket operationel med Web Client.
-
Aktivér kanal uplink & downlink Gå til Channels > Primary: Skift knapperne for "Uplink Enabled" og "Downlink Enabled" til ON-position - Klik på gem-ikonet.
-
Konfigurer netværksindstillinger Gå til Radio Config > Device > Network: Skift "Enabled"-knappen til ON-position, indtast dit SSID og PSK for netværket, og klik på gem-ikonet.
