Denna modul låter dig testa kommunikationsräckvidden mellan två Meshtastic-noder. Endast noder med modulen aktiverad kommer att visa räckviddstestmeddelanden på sina anslutna klienter.
-
Avsändare: En fast nod som skickar sekventiella paket med ett intervall på 30-60 sekunder (konfigurerat som "Avsändarmeddelandeintervall").
-
Mottagare: En mobil nod (vanligtvis du) som valfritt använder inbyggd GPS eller telefonens GPS. Noderna anses vara inom räckvidd så länge de sekventiella paketen kan tas emot framgångsrikt.
Den mottagande noden har möjlighet att spara meddelandena tillsammans med GPS-koordinaterna där de mottogs i en .csv-fil. Denna .csv-fil kan sedan integreras i Google Earth, Google Maps - My Maps eller något annat program som kan bearbeta .csv-filer, vilket gör att du kan visualisera ditt mesh. Se till att ställa in positionsnoggrannheten i standardkanalen till hög; annars kommer de insamlade uppgifterna inte att korrekt registrera din verkliga position.
OBS: Se till att stänga av modulen eller inaktivera sändning när den inte används, eftersom detta kommer att förbruka betydande tid i luften, sakta ner ditt mesh och stöka ner din kanal med onödiga meddelanden. Modulen stängs automatiskt av efter 8 timmar användning.
Konfigurationsalternativen för räckviddstestmodulen inkluderar: Aktiverad, Avsändare och Spara. Konfigurationen för Range Test Module använder ett administratörsmeddelande för att skicka en ModuleConfig.RangeTestConfig protobuf.
Konfigurationsvärden för Range Test-modul
-
Aktiverad: Aktiverar range test-modulen. Både Sändare och Mottagare måste ha modulen aktiverad. För att Apple- och Android-appar ska ta emot några range test-meddelanden måste modulen också vara aktiverad på dessa enheter. Observera att enhetens skärm fortfarande kan visa range test-paket från äldre firmwareversioner även om modulen är inaktiverad.
-
Sändarintervall
Tiden att vänta mellan att skicka sekventiella testpaket är konfigurerbar, med 0 som standardvärde, vilket inaktiverar sändning av meddelanden.
-
Rekommenderade sändarinställningar
| Radioinställning | range_test.sender |
| Långsamt Långsam | 60 |
| Lång Snabb | 30 |
| Medel | 15 |
| Kort Snabb | 15 |
-
Spara CSV Fil
Om aktiverat sparas alla mottagna meddelanden till enhetens flashminne i en fil med namnet rangetest.csv.
För att komma åt denna fil, aktivera WiFi på din enhet och anslut till ditt nätverk. När du är ansluten, navigera till meshtastic.local/rangetest.csv (eller din_enhets_ip/rangetest.csv), och filen laddas ner automatiskt. Denna fil skapas endast efter att enheten mottagit initiala meddelanden.
För att förhindra att lagringen fylls upp, slutar enheten skriva om det finns mindre än 50KB ledigt utrymme på filsystemet.
OBS: Lämna denna funktion inaktiverad när du använder Android- eller Apple-apparna. Den sparar data direkt till enhetens flashminne (utan att kräva en smartphone) och är endast tillgänglig på ESP32-baserade enheter.
Konfiguration för Range Test-modul Klient
Android
Android exporterar en rangetest.csv-fil från paket i Debug-loggen. För att rensa gammal paketdata:
Debugpanel > Rensa
Notera: Konfigurationsalternativ för räckviddstest finns tillgängliga på Android. Öppna Meshtastic-appen och gå till Inställningar > Räckviddstest.
Äpple
Apple-appar låter dig ladda ner loggade positionsdata som lagras på din iPhone, iPad eller Mac. För att komma åt det, öppna Fliken Noder, välj en nod och välj sedan Positionslogg och klicka på Spara. Denna fil kan sparas utan att räckviddstestmodulen är aktiv.
Notera: Alla konfigurationsalternativ för räckviddstestmodulen finns tillgängliga på iOS, iPadOS och macOS under Inställningar > Modulkonfiguration > Räckviddstest.
CLI
Konfigurationsalternativ för räckviddstestmodulen finns tillgängliga i python CLI. Exempel på kommandon finns nedan:
| Inställning | Acceptabla värden | Standard |
| range_test.enabled | sant, falskt | FALSKT |
| range_test.save | sant, falskt | FALSKT |
| range_test.sender | heltal (Sekunder) | 0 |
Eftersom enheten startar om efter varje kommando som skickas via CLI rekommenderas det att kedja ihop kommandon när flera värden ska ställas in i en konfigurationssektion. Till exempel:
meshtastic --set range_test.enabled true --set range_test.save false
Aktivera / inaktivera räckviddstestet
meshtastic --set range_test.enabled true meshtastic --set range_test.enabled false
Aktivera / inaktivera sparande av räckviddstest
meshtastic --set range_test.save true meshtastic --set range_test.save false
Aktivera räckviddstestavsändare (skicka var 60:e sekund)
meshtastic --set range_test.sender 60
Inaktivera räckviddstestavsändare
meshtastic --set range_test.sender 0
Webb
Alla konfigurationsalternativ för räckviddstestmodulen finns tillgängliga i webbgränssnittet.
Applikationsexempel
Google Earth-integration
Steg:
-
Ladda ner och öppna Google Earth.
-
Gå till Arkiv > Importera.
-
Välj CSV.
-
Välj Avgränsad, Komma.
-
Se till att alternativet “Denna dataset innehåller inte latitud/longitud-information, utan gatadresser” är avmarkerat.
-
Tilldela rx lat och rx long till latitud-/longitudfälten.
-
Klicka på Slutför.
-
När du uppmanas att skapa en stilmall, välj Ja.
-
Ställ in Namnfältet till vilken kolumn du vill visa på kartan (all data kommer fortfarande att visas när du klickar på en ikon).
-
Välj en färg, ikon, etc., och klicka sedan på OK.
Din dataset kommer att laddas in på kartan; markera rutan bredvid den i sidofältet för att göra den synlig.
My Maps
Du kan använda Google My Maps, som stödjer CSV-filer och erbjuder ett enklare gränssnitt. Google tillhandahåller instruktioner om hur du ställer in detta. Du kan också styla intervall baserat på värden—till exempel göra att nålar visas mörkare när SNR eller RSSI är högre.
OpenStreetMap - uMap
För ett öppen källkods-alternativ kan du använda uMap, en tjänst byggd på OpenStreetMap.
-
Besök uMap på ditt föredragna språk.
-
Klicka på Skapa en karta.
-
Välj ikonen Importera data eller tryck på CTRL + I.
-
Välj din rangetest.csv-fil och klicka på Importera.
-
Formatet kommer att kännas igen automatiskt och platserna kommer att läggas till på kartan.
