Meshtastic MQTT modul umožňuje LoRa mesh zařízením bezpečně přeposílat pakety na MQTT server přes Wi-Fi nebo Ethernet. To umožňuje lokálním Meshtastic vzdáleným uzlům komunikovat s uživateli připojenými k internetu. Pro použití této funkce musí být jeden nebo více kanálů povoleno jako uplink a/nebo downlink pro přenos paketů.
Konfigurace MQTT modulu zahrnuje možnosti jako: Povoleno, Adresa serveru, Uživatelské jméno, Heslo, Šifrování povoleno, JSON povolen, TLS povoleno, Kořenové téma, Klientský proxy povolen, Mapové reportování povoleno (s přesností polohy a intervalem publikování) a Okay to MQTT. Konfigurace se provádí pomocí ConfigModule.MQTT protobuf zpráv.
Konfigurační hodnoty MQTT modulu
- Povoleno: Aktivuje MQTT modul.
- Adresa serveru: Definuje MQTT server. Pokud není nastavena, používá se výchozí veřejný server.
- Uživatelské jméno: Uživatelské jméno pro MQTT server. Povinné pro vlastní servery; pro veřejné servery platí výchozí hodnoty.
- Heslo: Heslo pro MQTT server. Povinné pro vlastní servery; pro veřejné servery platí výchozí hodnoty.
- Šifrování povoleno: Určuje, zda jsou pakety odesílány šifrovaně nebo nešifrovaně. Nešifrované pakety jsou užitečné pro externí systémy zpracovávající Meshtastic pakety.
- JSON povolen: Umožňuje odesílání a příjem JSON paketů přes MQTT. Uživatelské pro integraci se systémy kompatibilními s JSON.
- TLS povoleno: Umožňuje zabezpečené připojení pomocí TLS.
- Kořenové téma: Definuje kořenové téma MQTT pro oddělení více Meshtastic LoRa sítí.
- Klientský proxy povolen: Pokud je pravda, používá síťové připojení klientského zařízení k připojení na MQTT server.
Mapové reportování povoleno
Od firmwaru 2.3.2+ povolení mapového reportování umožňuje uzlům odesílat periodické nešifrované mapové reporty na MQTT broker. Reporty obsahují:
- Dlouhý/krátký název uzlu a ID
- Poloha a nadmořská výška
- Model hardwaru a role
- Verze firmwaru
- LoRa region, přednastavení modemu a název primárního kanálu
- Dosažitelnost na výchozím kanálu s známým klíčem
- Počet lokálních online uzlů (poslední 2 hodiny, bez MQTT)
Přesnost polohy mapového reportu: Výchozí odchylka ~1459 m.
Interval publikování mapového reportu: Výchozí 900 sekund (15 minut).
Konfigurace MQTT modulu klienta
Android
- Otevřete Meshtastic aplikaci
- Navigace: Vertikální elipsa (3 tečky) > Konfigurace rádia > MQTT
Apple
Na iOS, iPadOS, macOS přejděte do: Nastavení > Konfigurace modulu > MQTT.
CLI
Pomocí Python CLI zahrnují možnosti konfigurace:
| Nastavení | Hodnoty | Výchozí |
|---|---|---|
| mqtt.enabled | pravda, nepravda | false |
| mqtt.address | řetězec | mqtt.meshtastic.org |
| mqtt.username | řetězec | meshdev |
| mqtt.password | řetězec | large4cats |
| mqtt.encryption_enabled | pravda, nepravda | false |
| mqtt.json_enabled | pravda, nepravda | false |
| mqtt.tls_enabled | pravda, nepravda | false |
| mqtt.root | řetězec | |
| mqtt.proxy_to_client_enabled | pravda, nepravda | false |
| mqtt.map_reporting_enabled | pravda, nepravda | false |
Příklady:
meshtastic --set mqtt.enabled true meshtastic --set mqtt.json_enabled true
Poznámka: Zařízení se po každém příkazu CLI restartují. Pro nastavení více hodnot řetězte příkazy dohromady.
Web
Všechny možnosti konfigurace MQTT modulu jsou dostupné přes Webové uživatelské rozhraní.
Přístup k výchozímu veřejnému serveru
Android
- Povolte MQTT modul: Přejděte do Konfigurace rádia > MQTT, přepněte Povoleno a klepněte na Odeslat.

Volitelné: Pro použití internetového připojení telefonu k odesílání a přijímání paketů přes web také povolte přepínač MQTT klientský proxy a přeskočte krok Nakonfigurovat nastavení sítě níže.

- Povolte uplink a downlink kanál: Přejděte do Konfigurace rádia > Kanály > LongFast, přepněte Uplink povolen a Downlink povolen, poté klepněte na Uložit a Odeslat.

- Nakonfigurujte nastavení sítě: Přejděte do Konfigurace rádia > Síť, povolte Wi-Fi, zadejte SSID a PSK, poté klepněte na Odeslat.

Apple
- Aktivujte MQTT modul: Přejděte do Nastavení > MQTT, přepněte Povoleno a klepněte na Uložit.


Konfigurace Meshtastic MQTT modulu poskytuje bezpečný a flexibilní způsob integrace LoRa mesh sítí s internetovými MQTT servery. Povolením funkcí jako TLS šifrování, JSON integrace a Map Reporting mohou správci rozšířit komunikaci Meshtastic Remote Node do cloudových služeb, IoT platforem a online dashboardů.
Tato konfigurace zajišťuje, že zařízení Meshtastic mohou fungovat jako brány mezi lokálními LoRa mesh sítěmi a globálními MQTT brokery, což umožňuje plynulou výměnu dat. S řádně nakonfigurovanými uplink a downlink kanály mohou uzly v reálném čase přenášet data ze senzorů, polohové informace a stavové aktualizace do externích systémů.
Klíčové výhody povolení Meshtastic MQTT modulu zahrnují:
- Bezpečná komunikace: Použijte TLS a šifrovací klíče k ochraně integrity dat.
- Flexibilní integrace: Podpora JSON paketů usnadňuje připojení k IoT dashboardům a aplikacím třetích stran.
- Škálovatelné sítě: Nakonfigurujte Kořenová témata pro oddělení více Meshtastic LoRa sítí na stejném serveru.
- Vzdálená správa uzlů: Povolit klientský proxy pro použití mobilních zařízení jako bran pro vzdálenou správu.
- Reportování na mapě: Sdílejte pozice uzlů, verze firmwaru a detaily LoRa regionu pro vizualizaci na online mapách.
Ať už používáte Android, Apple zařízení, CLI nástroje nebo webové rozhraní, správci mohou konfigurovat MQTT modul podle svých potřeb nasazení. To činí integraci MQTT v Meshtastic silným řešením pro rozšíření mesh komunikace za hranice lokálního rádiového pokrytí do globálního internetu.
Stručně řečeno, konfigurace MQTT modulu Meshtastic překlenutí propasti mezi LoRa mesh sítěmi a MQTT cloudovými službami, umožňující bezpečnou, škálovatelnou a flexibilní komunikaci pro IoT aplikace, chytrá města a projekty vzdáleného monitorování.
Konfigurace MQTT modulu klienta
Android
-
otevřete aplikaci Meshtastic
-
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Konfigurace rádia > MQTT.
Apple
CLI
| Nastavení | Přijatelné hodnoty | Výchozí |
| mqtt.enabled | pravda, nepravda | NEPRAVDA |
| mqtt.address | řetězec | mqtt.meshtastic.org |
| mqtt.username | řetězec | meshdev |
| mqtt.password | řetězec | large4cats |
| mqtt.encryption_enabled | pravda, nepravda | NEPRAVDA |
| mqtt.json_enabled | pravda, nepravda | NEPRAVDA |
| mqtt.tls_enabled | pravda, nepravda | NEPRAVDA |
| mqtt.root | řetězec | |
| mqtt.proxy_to_client_enabled | pravda, nepravda | NEPRAVDA |
| mqtt.map_reporting_enabled | pravda, nepravda | NEPRAVDA |
-
Povolit/zakázat MQTT modul
-
Povolit/zakázat MQTT JSON
Web
Přístup k výchozímu veřejnému serveru
Android
-
Povolte MQTT modul


-
Povolte uplink a downlink kanálu

-
Konfigurace síťových nastavení

Apple
-
Aktivujte MQTT modul Přejděte do Settings > MQTT: Přepněte přepínač MQTT enabled do polohy ZAPNUTO a poté klepněte na Uložit.



-
Aktivujte uplink a downlink kanálu Přejděte do Settings > Channels > Primary Channel: Přepněte přepínače Uplink enabled a Downlink enabled do polohy ZAPNUTO, poté klepněte na Uložit.

-
Nastavte síťová nastavení Přejděte do Settings > Network: Přepněte přepínač WiFi enabled do polohy ZAPNUTO, poté zadejte své SSID a PSK pro síť a klepněte na Uložit.

CLI
-
Povolte MQTT modul
-
Povolte uplink a downlink kanálu
-
Konfigurace síťových nastavení
Web
-
Aktivujte MQTT modul Přejděte do Config > Module Config > MQTT - Přepněte přepínač MQTT enabled do polohy ZAPNUTO - Klikněte na ikonu Uložit.


-
Aktivujte uplink a downlink kanálu Přejděte do Channels > Primary: Přepněte přepínače Uplink Enabled a Downlink Enabled do polohy ZAPNUTO - Klikněte na ikonu Uložit.

-
Nastavte síťová nastavení Přejděte do Radio Config > Device > Network: Přepněte přepínač Enabled do polohy ZAPNUTO, zadejte své SSID a PSK pro síť a klikněte na ikonu Uložit.

