Průvodce Meshtastic - Konfigurace modulu Meshtastic MQTT

Pokud je vaše zařízení připojeno k internetu přes Wi-Fi nebo Ethernet, můžete povolit přeposílání paketů na MQTT server. To umožňuje uživatelům v lokální síti komunikovat s uživateli na internetu. Jeden nebo více kanálů musí být také povoleno jako uplink a/nebo downlink, aby mohly být pakety přenášeny z a/nebo do vaší sítě (viz kanály).

Konfigurační možnosti MQTT modulu zahrnují: Povoleno, Adresa serveru, Uživatelské jméno, Heslo, Šifrování povoleno, JSON povoleno, TLS povoleno, Kořenové téma, Proxy klienta povoleno, Mapové hlášení povoleno (s přesností polohy a intervalem publikování) a Okay to MQTT. Konfigurace MQTT modulu používá administrátorskou zprávu, která odesílá ConfigModule.MQTT protobuf.

Konfigurační hodnoty MQTT modulu

Povoleno: Aktivuje MQTT modul.
Adresa serveru: server, který bude použit pro MQTT. Pokud není nastaven, bude využit výchozí veřejný server.
Uživatelské jméno: MQTT uživatelské jméno serveru k použití (nejvíce užitečné pro vlastní MQTT server). Pokud používáte vlastní server, bude toto respektováno i pokud je prázdné. Pokud používáte výchozí veřejný server, bude respektováno pouze pokud je nastaveno; jinak zařízení použije výchozí uživatelské jméno.
Heslo: MQTT heslo k použití (nejvíce užitečné pro vlastní MQTT server). Pokud používáte vlastní server, bude toto respektováno i pokud je prázdné. Pokud používáte výchozí server, bude respektováno pouze pokud je nastaveno; jinak zařízení použije výchozí heslo.
Šifrování povoleno: Zda odesílat zašifrované nebo nezašifrované pakety na MQTT server je konfigurovatelné. Nezašifrované pakety mohou být užitečné pro externí systémy, které chtějí přijímat pakety Meshtastic. Poznámka: Všechny zprávy jsou odesílány na MQTT broker nezašifrovaně, pokud tato možnost není povolena, i když vaše uplink kanály mají nastavené šifrovací klíče.
JSON povoleno: JSON není podporováno na platformě nRF52. Můžete povolit odesílání a příjem JSON paketů přes MQTT. Tyto pakety nejsou šifrované, ale poskytují snadný způsob integrace se systémy, které umí číst JSON.
TLS povoleno: Pokud je nastaveno na true, pokusíme se navázat zabezpečené připojení pomocí TLS.
Root Topic: Důležitý je root topic pro MQTT zprávy. To je užitečné, pokud chcete využít jeden MQTT server pro více Meshtastic sítí a oddělit je pomocí ACL.
Klientský proxy povolen: Pokud je nastaveno na true, zařízení použije síťové připojení klienta (např. vašeho telefonu) k připojení na MQTT server. Pokud je nastaveno na false, použije vlastní síťové připojení zařízení, které musí být povoleno v nastavení sítě.

Mapové reportování povoleno

Dostupné od verze firmwaru 2.3.2 a výše, pokud je nastaveno na true, váš uzel bude periodicky odesílat nešifrovaný mapový report na MQTT server pro zobrazení na online mapách, které tento paket podporují. Tento report obsahuje následující informace:

Dlouhé a krátké jméno uzlu a ID
Pozice uzlu (s konfigurovatelnou přesností) a nadmořská výška
Hardwarový model uzlu a jeho role
verze firmwaru uzlu
LoRa region uzlu, přednastavení modemu a název primárního kanálu
Zda je uzel dosažitelný na výchozím kanálu s známým klíčem
Počet lokálních online uzlů (slyšených za poslední 2 hodiny, s výjimkou těch slyšených přes MQTT)

Přesnost pozice mapového reportu označuje přesnost použité pro pozici v mapovém reportu, s výchozí maximální odchylkou kolem 1459m.

Interval publikování mapového reportu určuje, jak často by měl být mapový report publikován na MQTT server v sekundách, s výchozím nastavením 900 sekund (15 minut).

Konfigurace MQTT modulu Klient

Android

MQTT konfigurační možnosti jsou dostupné pro Android.

otevřete Meshtastic App
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Konfigurace rádia > MQTT.

Apple

Všechny MQTT konfigurační možnosti jsou dostupné na iOS, iPadOS a macOS. Pro přístup k nim přejděte do: Nastavení > Konfigurace modulu > MQTT.

CLI

Následující konfigurační možnosti jsou dostupné v Python CLI:

Nastavení	Přijatelné hodnoty	Výchozí
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

Povolit/zakázat MQTT modul

meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false

Povolit/zakázat MQTT JSON

meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false

POZNÁMKA: Protože se zařízení restartuje po každém příkazu odeslaném přes CLI, doporučuje se spojit příkazy dohromady do jednoho při nastavování více hodnot v konfigurační sekci. Například:

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

Web

Všechny možnosti konfigurace modulu MQTT jsou dostupné pro Webové uživatelské rozhraní.

Přístup k výchozímu veřejnému serveru

Android

Povolit MQTT modul

Přejděte na: Vertikální elipsa (3 tečky v pravém horním rohu) > Konfigurace rádia > MQTT: Zapněte posuvník pro MQTT povoleno a klepněte na Odeslat.

Volitelné: Pro použití internetového připojení vašeho telefonu k odesílání a přijímání paketů přes web také zapněte posuvník pro MQTT Client Proxy a přeskočte níže uvedený krok Konfigurace síťových nastavení.

Povolit uplink a downlink kanálu

Přejděte na: Vertikální elipsa (3 tečky v pravém horním rohu) > Konfigurace rádia > Kanály > LongFast: Zapněte posuvníky pro Uplink povolen a Downlink povolen, poté klepněte na Uložit a klepněte na Odeslat.

Nastavit síťové parametry

Přejděte na: Vertikální elipsa (3 tečky v pravém horním rohu) > Konfigurace rádia > Síť: Zapněte posuvník pro WiFi povoleno, zadejte SSID a PSK pro vaši síť, poté klepněte na Odeslat.

Apple

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

Volitelné: Pokud chcete používat internetové připojení svého telefonu pro odesílání a přijímání paketů online, povolte také přepínač MQTT Client Proxy a přeskočte krok Nastavení sítě níže.

Aktivace uplinku a downlinku kanálu Přejděte do Settings > Channels > Primary Channel: Přepněte přepínače Uplink enabled a Downlink enabled do polohy ON, poté klepněte na Uložit.

Nastavení síťových parametrů Přejděte do Settings > Network: Přepněte přepínač WiFi enabled do polohy ON, poté zadejte své SSID a PSK pro síť a klepněte na Uložit.

CLI

Povolit MQTT modul

meshtastic --set mqtt.enabled true

Povolit uplink a downlink kanálu

meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0

nebo spojené dohromady:

meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0

Nastavit síťové parametry

meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "your network" meshtastic --set network.wifi_psk yourpassword

nebo spojené dohromady:

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network" --set network.wifi_psk yourpassword

Web

Aktivujte MQTT modul Přejděte do Config > Module Config > MQTT - Přepněte přepínač MQTT enabled do polohy ON - Klikněte na ikonu Uložit.

Volitelné: Pokud chcete používat internetové připojení svého klienta pro odesílání a přijímání paketů online, povolte také posuvník Proxy to Client Enabled a přeskočte krok Nastavení sítě níže.

POZNÁMKA: Ačkoliv může být tato možnost ve vašem UI viditelná, Client Proxy momentálně nefunguje s Web Clientem.

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

Nastavení síťových parametrů Přejděte do Radio Config > Device > Network: Přepněte přepínač Enabled do polohy ON, zadejte své SSID a PSK pro síť a klikněte na ikonu Uložit.