Tento modul umožňuje otestovat dosah komunikace mezi dvěma uzly Meshtastic. Zprávy testování dosahu se v připojených klientech zobrazí pouze u uzlů, které mají modul povolen.
-
Odesílatel: Pevný uzel, který odesílá sekvenční pakety v intervalu 30–60 sekund (nastavuje se jako „Interval zpráv odesílatele“).
-
Přijímač: Mobilní uzel (obvykle vy), který volitelně používá integrovanou GPS nebo GPS telefonu. Uzel je považován za uzel v dosahu, dokud lze úspěšně přijímat pakety v pořadí.
Přijímající uzel může ukládat zprávy spolu s
GPS souřadnicemi, na kterých byly přijaty, do souboru
.csv . Tento soubor .csv lze následně integrovat do
Google Earth,
Google Maps - Moje mapy nebo jiného programu, který dokáže zpracovávat soubory .csv, což vám umožní vizualizovat vaši mesh síť. V výchozím kanálu nastavte
přesnost polohy na
vysokou; jinak zaznamenaná data nebudou přesně odpovídat vaší skutečné poloze.
POZNÁMKA: Pokud modul nepoužíváte, nezapomeňte jej vypnout nebo zakázat odesílání, protože to výrazně zvýší dobu vysílání, zpomalí vaši mesh síť a zahltí kanál zbytečnými zprávami. Modul se po 8 hodinách používání automaticky vypne.
Možnosti konfigurace modulu testování dosahu zahrnují: Povoleno, Odesílatel a Uložit. Konfigurace modulu testování dosahu používá zprávu správce k odeslání protokolu protobuf ModuleConfig.RangeTestConfig.
Hodnoty konfigurace modulu testování dosahu
-
Povoleno: Povolí modul testování dosahu. Modul musí být povolen u zařízení Odesílatel i Přijímač. Aby aplikace Apple a Android mohly přijímat zprávy testování dosahu, musí být modul povolen také na těchto zařízeních. Upozorňujeme, že displej zařízení může stále zobrazovat pakety testování dosahu ze starších verzí firmwaru, i když je modul zakázán.
-
Interval odesílatele
Dobu čekání mezi odesíláním po sobě jdoucích testovacích paketů lze nakonfigurovat pomocí 0 jako výchozí hodnota, která zakazuje odesílání zpráv.
| Nastavení rádia |
range_test.sender |
| Dlouhý pomalý |
60 |
| Dlouhý rychlý |
30 |
| Střední |
15 |
| Krátký rychlý |
15 |
Pokud je funkce povolena, všechny přijaté zprávy se ukládají do flash paměti zařízení v souboru s názvem rangetest.csv.
Chcete-li k tomuto souboru získat přístup, aktivujte v zařízení WiFi a připojte se k síti. Po připojení přejděte na adresu meshtastic.local/rangetest.csv (nebo your_device_ip/rangetest.csv) a soubor se automaticky stáhne. Tento soubor bude vytvořen až poté, co zařízení přijme první zprávy.
Aby nedošlo k zaplnění úložiště, zařízení přestane zapisovat, pokud je v souborovém systému k dispozici méně než 50KB volného místa.
POZNÁMKA: Tuto funkci ponechte vypnutou při používání aplikací Android nebo Apple. Ukládá data přímo do flash paměti zařízení (bez nutnosti použití chytrého telefonu) a je dostupná pouze na zařízeních založených na ESP32.
Klient konfigurace modulu testu dosahu
Android
Android exportuje soubor rangetest.csv z paketů v protokolu ladění. Chcete-li vymazat stará data historie paketů: Panel ladění > Vymazat
Poznámka: Možnosti konfigurace testu dosahu jsou dostupné v systému Android. Otevřete aplikaci Meshtastic a přejděte do Nastavení > Test dosahu.
Apple
Apple aplikace umožňují stáhnout zaznamenaná data o poloze uložená v zařízení iPhone, iPad nebo Mac. Chcete-li k nim získat přístup, otevřete kartu Uzly, vyberte uzel, poté zvolte Protokol polohy Log a klikněte na Uložit. Tento soubor lze uložit, aniž by byl aktivní modul testu dosahu.
Poznámka: Všechny možnosti konfigurace modulu testu dosahu jsou dostupné v systémech iOS, iPadOS a macOS v části Nastavení > Konfigurace modulu > Test dosahu.
CLI
Možnosti konfigurace modulu testu dosahu jsou dostupné v Python CLI. Příklad příkazů je uveden níže:
| Nastavení |
Povolené hodnoty |
Výchozí |
| range_test.enabled |
true, false |
NEPRAVDA |
| range_test.save |
true, false |
NEPRAVDA |
| range_test.sender |
celé číslo (sekundy) |
0 |
Protože se zařízení po odeslání každého příkazu prostřednictvím CLI restartuje, doporučuje se při nastavování více hodnot v konfigurační části spojit příkazy 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 možnosti konfigurace modulu testu dosahu jsou dostupné ve webovém rozhraní.
Příklady použití
Integrace s Google Earth
Postup:
-
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 „Tato datová sada neobsahuje informace o zeměpisné šířce/délce, ale obsahuje adresy ulic“ není zaškrtnutá.
-
Přiřaďte rx lat a rx long k polím zeměpisné šířky a délky.
-
Klikněte na Dokončit.
-
Až budete vyzváni k vytvoření šablony stylu, vyberte Ano.
-
Nastavte pole Název na libovolný sloupec, který chcete zobrazit na mapě (po kliknutí na ikonu se stále zobrazí všechna data).
-
Vyberte barvu, ikonu atd. a klikněte na OK.
Datová sada se načte do mapy; aby byla viditelná, zaškrtněte políčko vedle ní v postranním panelu.
Moje mapy
Můžete použít Google Moje mapy, které podporují
CSV soubory a nabízejí
jednodušší rozhraní. Google poskytuje pokyny,
jak tuto funkci nastavit. Rozsahy můžete také
stylovat podle hodnot – například nastavit, aby špendlíky byly
tmavší, když je SNR nebo RSSI vyšší.
OpenStreetMap – uMap
Jako open-source možnost můžete použít uMap, službu vytvořenou na platformě OpenStreetMap.
-
Navštivte
uMap ve vámi preferovaném jazyce.
-
Klikněte na Vytvořit mapu.
-
Vyberte ikonu Importovat data nebo stiskněte CTRL + I.
-
Vyberte soubor rangetest.csv a klikněte na Importovat.
-
Formát bude rozpoznán automaticky a umístění budou přidána do mapy.