Průvodce Meshtastic - Konfigurace modulu Meshtastic MQTT

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

  1. Otevřete Meshtastic aplikaci
  2. 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

  1. 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.

  1. 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.
  1. 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

  1. 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

Možnosti konfigurace MQTT jsou dostupné pro Android.
  1. otevřete aplikaci Meshtastic
  2. Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Konfigurace rádia > MQTT.

Apple

Všechny možnosti konfigurace MQTT jsou dostupné na iOS, iPadOS a macOS. Pro přístup přejděte na: 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 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
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í po každém příkazu odeslaném přes CLI restartuje, doporučuje se spojit příkazy 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 MQTT modulu jsou dostupné v webovém rozhraní.

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

Android

  1. Povolte MQTT modul
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > 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é povolte posuvník pro MQTT klientský proxy a přeskočte níže uvedený krok Konfigurace síťových nastavení.

  1. Povolte uplink a downlink kanálu
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Radio Configuration > Channels > LongFast: Zapněte posuvníky pro Uplink enabled a Downlink enabled, poté klepněte na Uložit a klepněte na Odeslat.

  1. Konfigurace síťových nastavení
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Radio Configuration > Network: Zapněte posuvník pro WiFi enabled, zadejte SSID a PSK pro vaši síť, poté klepněte na Odeslat.

Apple

  1. 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.
Volitelné: Pokud chcete používat internetové připojení svého telefonu k odesílání a přijímání paketů online, zapněte také přepínač MQTT Client Proxy a přeskočte krok Konfigurace síťových nastavení níže.

  1. 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.
  1. 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

  1. Povolte MQTT modul
meshtastic --set mqtt.enabled true
  1. Povolte 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
  1. Konfigurace síťových nastavení
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "vaše síť" meshtastic --set network.wifi_psk vašeheslo
nebo spojené dohromady:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "vaše síť" --set network.wifi_psk vašeheslo

Web

  1. 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.
Volitelné: Pokud chcete používat internetové připojení svého klienta pro odesílání a přijímání paketů online, zapněte také přepínač Proxy to Client Enabled a přeskočte krok Konfigurace síťových nastavení níže.
POZNÁMKA: Ačkoliv může být tato možnost viditelná ve vašem uživatelském rozhraní, Client Proxy momentálně nefunguje s Web Clientem.
  1. 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.
  1. 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.

Přihlaste se k odběru našeho newsletteru

Získejte nejnovější informace o našich produktech a speciálních nabídkách.

Website Feedback

Help us improve OpenELAB

Found a website issue or have an idea? Tell us what would make your experience better.