Przewodnik Meshtastic - Konfiguracja modułu Meshtastic MQTT

Jeśli Twoje urządzenie jest podłączone do Internetu przez Wi-Fi lub Ethernet, możesz włączyć przekazywanie pakietów do serwera MQTT. Pozwala to użytkownikom lokalnej sieci mesh komunikować się z użytkownikami w Internecie. Jeden lub więcej kanałów musi być również włączony jako uplink i/lub downlink, aby pakiety mogły być przesyłane z i/lub do Twojej sieci mesh (zobacz kanały).

Opcje konfiguracji modułu MQTT obejmują: Włączone, Adres serwera, Nazwa użytkownika, Hasło, Włączone szyfrowanie, Włączone JSON, Włączone TLS, Główny temat, Włączony klient proxy, Włączone raportowanie mapy (z precyzją pozycji i interwałem publikacji) oraz Okay to MQTT. Konfiguracja modułu MQTT używa wiadomości administracyjnej, która wysyła protobuf ConfigModule.MQTT.

Wartości konfiguracji modułu MQTT

Włączone: Włącza moduł MQTT.
Adres serwera: Serwer do użycia dla MQTT. Jeśli nie jest ustawiony, zostanie wykorzystany domyślny publiczny serwer.
Nazwa użytkownika: Nazwa użytkownika serwera MQTT do użycia (najbardziej przydatne dla niestandardowego serwera MQTT). Jeśli używasz niestandardowego serwera, będzie ona respektowana nawet jeśli jest pusta. Jeśli używasz domyślnego publicznego serwera, będzie respektowana tylko jeśli jest ustawiona; w przeciwnym razie urządzenie użyje domyślnej nazwy użytkownika.
Hasło: Hasło MQTT do użycia (najbardziej przydatne dla niestandardowego serwera MQTT). Jeśli używasz niestandardowego serwera, będzie ono respektowane nawet jeśli jest puste. Jeśli używasz domyślnego serwera, będzie respektowane tylko jeśli jest ustawione; w przeciwnym razie urządzenie użyje domyślnego hasła.
Włączone szyfrowanie: Czy wysyłać zaszyfrowane czy niezaszyfrowane pakiety do serwera MQTT jest konfigurowalne. Niezaszyfrowane pakiety mogą być przydatne dla systemów zewnętrznych, które chcą odbierać pakiety Meshtastic. Uwaga: Wszystkie wiadomości są wysyłane do brokera MQTT niezaszyfrowane, jeśli ta opcja nie jest włączona, nawet gdy Twoje kanały uplink mają ustawione klucze szyfrowania.
JSON Enabled: JSON nie jest obsługiwany na platformie nRF52. Możesz włączyć wysyłanie i odbiór JSON packets na MQTT. Te pakiety nie są szyfrowane, ale zapewniają łatwy sposób integracji z systemami, które potrafią czytać JSON.
TLS Enabled: Jeśli ustawione na true, spróbujemy nawiązać bezpieczne połączenie używając TLS.
Root Topic: root topic do użycia dla wiadomości MQTT jest ważny. Jest to przydatne, jeśli chcesz wykorzystać jeden MQTT serwer dla wielu sieci Meshtastic i oddzielić je za pomocą ACL.
Client Proxy Enabled: Jeśli ustawione na true, urządzenie będzie używać połączenia sieciowego klienta (np. twojego telefonu) do połączenia z MQTT serwerem. Jeśli ustawione na false, będzie używać własnego połączenia sieciowego urządzenia, które musi być włączone przez ustawienia sieci.

Raportowanie mapy włączone

Dostępne od wersji firmware 2.3.2 i dalej, jeśli ustawione na true, twój węzeł będzie okresowo wysyłał niezaszyfrowany raport mapy do MQTT serwera do wyświetlania na mapach online, które obsługują ten pakiet. Raport ten zawiera następujące informacje:

Długa i krótka nazwa węzła oraz ID
Pozycja węzła (z konfigurowalną precyzją) i wysokość
Model sprzętu węzła i rola
Wersja firmware węzła
LoRa region węzła, preset modemu i nazwa głównego kanału
Czy węzeł jest dostępny na domyślnym kanale z znanym kluczem
Liczba lokalnych węzłów online (słyszanych w ciągu ostatnich 2 godzin, z wyłączeniem tych słyszanych przez MQTT)

Map Report Position Precision odnosi się do precyzji użytej dla pozycji w raporcie mapy, z domyślnym maksymalnym odchyleniem około 1459m.

Map Report Publish Interval określa, jak często raport mapy powinien być publikowany na MQTT serwerze w sekundach, z domyślnym ustawieniem 900 sekund (15 minut).

Konfiguracja modułu MQTT Klient

Android

MQTT Config opcje są dostępne dla Android.

otwórz Meshtastic App
Przejdź do: Pionowa wielokropka (3 kropki w prawym górnym rogu) > Konfiguracja radia > MQTT.

Jabłko

Wszystkie opcje konfiguracji MQTT są dostępne na iOS, iPadOS i macOS. Aby uzyskać do nich dostęp, przejdź do: Ustawienia > Konfiguracja modułu > MQTT.

CLI

Następujące opcje konfiguracji są dostępne w Python CLI:

Ustawienie	Akceptowalne wartości	Domyślne
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

Włącz/Wyłącz moduł MQTT

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

Włącz/Wyłącz MQTT JSON

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

UWAGA: Ponieważ urządzenie będzie się restartować po każdym poleceniu wysłanym przez CLI, zaleca się łączenie poleceń w jedno podczas ustawiania wielu wartości w sekcji konfiguracji. Na przykład:

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

Przeglądanie internetu

Wszystkie opcje konfiguracji modułu MQTT są dostępne w Web UI.

Uzyskaj dostęp do domyślnego serwera publicznego

Android

Włącz moduł MQTT

Przejdź do: Pionowa wielokropka (3 kropki w prawym górnym rogu) > Konfiguracja radia > MQTT: Włącz przesuwak dla MQTT enabled i stuknij Wyślij.

Opcjonalnie: Aby użyć połączenia internetowego telefonu do wysyłania i odbierania pakietów przez sieć, włącz także przesuwak dla MQTT Client Proxy i pomiń poniższy krok Konfiguracja ustawień sieci.

Włącz Uplink i Downlink kanału

Przejdź do: Pionowa wielokropka (3 kropki w prawym górnym rogu) > Konfiguracja radia > Kanały > LongFast: Włącz przesuwaki dla Uplink enabled i Downlink enabled, następnie stuknij Zapisz i stuknij Wyślij.

Skonfiguruj ustawienia sieci

Przejdź do: Vertical Ellipsis (3 kropki w prawym górnym rogu) > Radio Configuration > Network: Włącz slider dla WiFi enabled, wpisz SSID i PSK swojej sieci, a następnie stuknij Send.

Jabłko

Aktywuj moduł MQTT Przejdź do Settings > MQTT: Przełącz przełącznik MQTT enabled na pozycję ON, a następnie stuknij Zapisz.

Opcjonalnie: Jeśli chcesz używać połączenia internetowego swojego telefonu do wysyłania i odbierania pakietów online, włącz także przełącznik MQTT Client Proxy i pomiń krok Konfiguracji ustawień sieci poniżej.

Aktywuj Uplink i Downlink kanału Przejdź do Settings > Channels > Primary Channel: Przełącz przełączniki Uplink enabled i Downlink enabled na pozycję ON, następnie stuknij Zapisz.

Skonfiguruj ustawienia sieci Przejdź do Settings > Network: Przełącz przełącznik WiFi enabled na ON, następnie wpisz swój SSID i PSK dla sieci i stuknij Zapisz.

CLI

Włącz moduł MQTT

meshtastic --set mqtt.enabled true

Włącz Uplink i Downlink kanału

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

lub połączone razem:

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

Skonfiguruj ustawienia sieci

meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "twoja sieć" meshtastic --set network.wifi_psk twojehaslo

lub połączone razem:

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "twoja sieć" --set network.wifi_psk twojehaslo

Przeglądanie internetu

Aktywuj moduł MQTT Przejdź do Config > Module Config > MQTT - Przełącz przełącznik MQTT enabled na ON - Kliknij ikonę Zapisz.

Opcjonalnie: Jeśli chcesz używać połączenia internetowego swojego klienta do wysyłania i odbierania pakietów online, włącz także suwak Proxy to Client Enabled i pomiń krok Konfiguracji ustawień sieci poniżej.

UWAGA: Chociaż ta opcja może być widoczna w Twoim interfejsie, Client Proxy nie jest obecnie operacyjny z Web Client.

Aktywuj Uplink i Downlink kanału Przejdź do Channels > Primary: Przełącz przełączniki Uplink Enabled i Downlink Enabled na pozycję ON - Kliknij ikonę Zapisz.

Skonfiguruj ustawienia sieci Przejdź do Radio Config > Device > Network: Przełącz przełącznik Enabled na pozycję ON, wpisz swój SSID i PSK dla sieci, a następnie kliknij ikonę Zapisz.