Tento modul vám umožňuje testovat dosah komunikace mezi dvěma Meshtastic uzly. Pouze uzly s povoleným modulem budou zobrazovat zprávy testu dosahu na svých připojených klientech.
-
Odesílatel: Pevný uzel, který odesílá sekvenční pakety v intervalu 30-60 sekund (nastaveno jako "Interval zprávy odesílatele").
-
Přijímač: Mobilní uzel (obvykle vy), který volitelně používá vestavěné GPS nebo GPS telefonu. Uzel je považován za v dosahu, pokud lze úspěšně přijímat sekvenční pakety.
Přijímací uzel má možnost uložit zprávy spolu s GPS souřadnicemi, na kterých byly přijaty, do .csv souboru. Tento .csv soubor lze poté integrovat do Google Earth, Google Maps - My Maps nebo jakéhokoli jiného programu, který dokáže zpracovat .csv soubory, což vám umožní vizualizovat vaši síť mesh. Ujistěte se, že v výchozím kanálu nastavíte přesnost polohy na vysokou; jinak shromážděná data nebudou přesně zaznamenávat vaši skutečnou polohu.
POZNÁMKA: Nezapomeňte modul vypnout nebo zakázat odesílání, když není používán, protože to spotřebuje značné množství času na vzduchu, zpomalí vaši síť mesh a zaplní váš kanál zbytečnými zprávami. Modul se automaticky vypne po 8 hodinách používání.
Možnosti konfigurace modulu testu dosahu zahrnují: Povoleno, Odesílatel a Uložit. Konfigurace modulu testu dosahu používá administrátorskou zprávu k odeslání ModuleConfig.RangeTestConfig protobufu.
Konfigurační hodnoty modulu testu dosahu
-
Povoleno: Aktivuje modul range testu. Modul musí být povolen jak na odesílateli, tak na přijímači. Aby aplikace Apple a Android přijímaly jakékoli zprávy z range testu, musí být modul povolen i na těchto zařízeních. Upozorňujeme, že obrazovka zařízení může stále zobrazovat pakety range testu ze starších verzí firmwaru i v případě, že je modul vypnutý.
-
Interval odesílatele
Čas čekání mezi odesíláním po sobě jdoucích testovacích paketů je konfigurovatelný, s 0 jako výchozí hodnota, která zakazuje odesílání zpráv.
-
Doporučená nastavení odesílatele
| Nastavení rádia | range_test.sender |
| Dlouhý Pomalý | 60 |
| Dlouhý Rychlý | 30 |
| Střední | 15 |
| Krátký Rychlý | 15 |
-
Uložit CSV Soubor
Pokud je povoleno, všechny přijaté zprávy jsou uloženy do flash paměti zařízení v souboru pojmenovaném rangetest.csv.
Pro přístup k tomuto souboru aktivujte na zařízení WiFi a připojte se k vaší síti. Po připojení přejděte na meshtastic.local/rangetest.csv (nebo ip_adresa_vaseho_zarizeni/rangetest.csv) a soubor se automaticky stáhne. Tento soubor bude vytvořen až po přijetí prvních zpráv zařízením.
Aby se zabránilo zaplnění úložiště, zařízení přestane zapisovat, pokud je na souborovém systému méně než 50KB volného místa.
POZNÁMKA: Nechte tuto funkci vypnutou při používání aplikací Android nebo Apple. Ukládá data přímo do flash paměti zařízení (bez nutnosti smartphonu) a je dostupná pouze na zařízeních založených na ESP32.
Konfigurace modulu Range Test Klient
Android
Android exportuje soubor rangetest.csv z paketů v Debug Logu. Pro vymazání starých dat historie paketů:
Debug Panel > Vymazat
Poznámka: Možnosti konfigurace Range Test jsou dostupné na Androidu. Otevřete aplikaci Meshtastic a přejděte do Nastavení > Range Test.
Jablko
Apple aplikace vám umožňují stáhnout zaznamenaná data o poloze uložená na vašem iPhonu, iPadu nebo Macu. Pro přístup otevřete záložku Nodes, vyberte uzel a poté zvolte Position Log a klikněte na Uložit. Tento soubor lze uložit bez aktivního modulu Test dosahu.
Poznámka: Všechny konfigurační možnosti modulu testu dosahu jsou dostupné na iOS, iPadOS a macOS v Nastavení > Konfigurace modulu > Test dosahu.
CLI
Konfigurační možnosti modulu testu dosahu jsou dostupné v python CLI. Níže jsou příkladové příkazy:
| Nastavení | Přijatelné hodnoty | Výchozí |
| range_test.enabled | pravda, nepravda | NEPRAVDA |
| range_test.save | pravda, nepravda | NEPRAVDA |
| range_test.sender | integer (Sekundy) | 0 |
Protože se zařízení po každém příkazu zaslaném přes CLI restartuje, doporučuje se při nastavování více hodnot v jedné konfigurační sekci příkazy spojit do jednoho. Například:
meshtastic --set range_test.enabled true --set range_test.save false
Povolit / Zakázat test dosahu
meshtastic --set range_test.enabled true meshtastic --set range_test.enabled false
Povolit / Zakázat ukládání testu dosahu
meshtastic --set range_test.save true meshtastic --set range_test.save false
Povolit odesílatele testu dosahu (odesílat každých 60 sekund)
meshtastic --set range_test.sender 60
Zakázat odesílatele testu dosahu
meshtastic --set range_test.sender 0
Web
Všechny konfigurační možnosti modulu testu dosahu jsou dostupné v Web UI.
Příklady použití
Integrace Google Earth
Kroky:
-
Stáhněte a otevřete Google Earth.
-
Přejděte na Soubor > Importovat.
-
Vyberte CSV.
-
Vyberte Oddělené, Čárka.
-
Ujistěte se, že možnost „Tento dataset neobsahuje informace o zeměpisnéšířce/délce, ale o ulicích“ je odškrtnutá.
-
Přiřaďte rx lat a rx long k polím zeměpisné šířky/délky.
-
Klikněte na Dokončit.
-
Když budete vyzváni k vytvoření šablony stylu, vyberte Ano.
-
Nastavte pole Název na libovolný sloupec, který chcete zobrazit na mapě (všechna data se stále zobrazí po kliknutí na ikonu).
-
Vyberte barvu, ikonu atd., poté klikněte na OK.
Váš dataset se načte na mapu; zaškrtněte políčko vedle něj v postranním panelu, aby byl viditelný.
My Maps
Můžete použít Google My Maps, která podporuje CSV soubory a nabízí jednodušší rozhraní. Google poskytuje instrukce, jak to nastavit. Můžete také stylovat rozsahy podle hodnot—například nechat značky vypadat tmavší, když je SNR nebo RSSI vyšší.
OpenStreetMap - uMap
Pro open-source možnost můžete použít uMap, službu postavenou na OpenStreetMap.
-
Navštivte uMap ve svém preferovaném jazyce.
-
Klikněte na Vytvořit mapu.
-
Vyberte ikonu Importovat data nebo stiskněte CTRL + I.
-
Vyberte svůj soubor rangetest.csv a klikněte na Importovat.
-
Formát bude rozpoznán automaticky a lokace budou přidány na mapu.
