Questo modulo consente di testare la portata della comunicazione tra due nodi Meshtastic. Solo i nodi con il modulo abilitato visualizzeranno i messaggi di test della portata sui client connessi.
-
Mittente: un nodo fisso che invia pacchetti sequenziali a intervalli di 30-60 secondi (configurati come "Intervallo dei messaggi del mittente").
-
Ricevitore: un nodo mobile (in genere tu) che utilizza facoltativamente il GPS integrato o il GPS del telefono. I nodi sono considerati nel raggio d'azione finché i pacchetti sequenziali possono essere ricevuti correttamente.
Il nodo ricevente può salvare i messaggi insieme alle
coordinate GPS del punto in cui sono stati ricevuti in un
file .csv. Questo file .csv può quindi essere integrato in
Google Earth,
Google Maps - My Maps o qualsiasi altro programma in grado di elaborare file .csv, consentendo di visualizzare la tua mesh. Assicurati di impostare la
precisione della posizione del canale predefinito su
alta; in caso contrario, i dati raccolti non registreranno accuratamente la tua posizione reale.
NOTA: Assicurati di disattivare il modulo o di disabilitare l'invio quando non è in uso, poiché consumerà molto tempo di trasmissione, rallenterà la tua mesh e intaserà il canale con messaggi non necessari. Il modulo si disattiverà automaticamente dopo 8 ore di utilizzo.
Le opzioni di configurazione del modulo di test della portata includono: Abilitato, Mittente e Salva. La configurazione del modulo di test della portata utilizza un messaggio di amministrazione per inviare un protobuf ModuleConfig.RangeTestConfig.
Valori di configurazione del modulo di test della portata
-
Abilitato: Abilita il modulo di test della portata. Sia il mittente sia il ricevitore devono avere il modulo abilitato. Affinché le app Apple e Android ricevano messaggi di test della portata, il modulo deve essere abilitato anche su tali dispositivi. Tieni presente che lo schermo del dispositivo potrebbe comunque visualizzare pacchetti di test della portata provenienti da versioni precedenti del firmware, anche se il modulo è disabilitato.
-
Intervallo del mittente
Il tempo di attesa tra l'invio di pacchetti di test consecutivi è configurabile, con 0 come valore predefinito, che disabilita l'invio dei messaggi.
| Impostazione radio |
range_test.sender |
| Lungo lento |
60 |
| Lungo veloce |
30 |
| Medio |
15 |
| Breve veloce |
15 |
Se abilitata, tutti i messaggi ricevuti vengono salvati nella memoria flash del dispositivo in un file denominato rangetest.csv.
Per accedere a questo file, attiva il WiFi sul dispositivo e connettilo alla tua rete. Una volta connesso, vai a meshtastic.local/rangetest.csv (oppure a your_device_ip/rangetest.csv) e il file verrà scaricato automaticamente. Questo file verrà creato solo dopo che il dispositivo avrà ricevuto i messaggi iniziali.
Per evitare di riempire lo spazio di archiviazione, il dispositivo smetterà di scrivere se nel filesystem è disponibile meno di 50KB di spazio.
NOTA: lascia questa funzione disabilitata quando utilizzi le app Android o Apple. Salva i dati direttamente nella memoria flash del dispositivo (senza richiedere uno smartphone) ed è disponibile solo sui dispositivi basati su ESP32.
Client di configurazione del modulo Test di portata
Android
Android esporta un file rangetest.csv dai pacchetti presenti nel registro di debug. Per cancellare i dati della cronologia dei pacchetti precedenti: Pannello di debug > Cancella
Nota: le opzioni di configurazione del Test di portata sono disponibili su Android. Apri l'app Meshtastic e vai a Impostazioni > Test di portata.
Apple
Le app Apple consentono di scaricare i dati di posizione registrati memorizzati sul tuo iPhone, iPad o Mac. Per accedervi, apri la scheda Nodi, scegli un nodo, quindi seleziona Registro posizione e fai clic su Salva. Questo file può essere salvato senza che il modulo Test di portata sia attivo.
Nota: tutte le opzioni di configurazione del modulo Test di portata sono disponibili su iOS, iPadOS e macOS in Impostazioni > Configurazione modulo > Test di portata.
CLI
Le opzioni di configurazione del modulo Test di portata sono disponibili nella CLI Python. Di seguito sono riportati alcuni comandi di esempio:
| Impostazione |
Valori accettabili |
Predefinito |
| range_test.enabled |
vero, falso |
FALSO |
| range_test.save |
vero, falso |
FALSO |
| range_test.sender |
intero (secondi) |
0 |
Poiché il dispositivo si riavvia dopo ogni comando inviato tramite CLI, quando si impostano più valori in una sezione di configurazione è consigliabile concatenare i comandi in un'unica istruzione. Ad esempio:
meshtastic --set range_test.enabled true --set range_test.save false
Abilita / Disabilita il test di portata
meshtastic --set range_test.enabled true meshtastic --set range_test.enabled false
Abilita/disabilita il salvataggio del test della portata
meshtastic --set range_test.save true meshtastic --set range_test.save false
Abilita il mittente del test della portata (invio ogni 60 secondi)
meshtastic --set range_test.sender 60
Disabilita il mittente del test della portata
meshtastic --set range_test.sender 0
Web
Tutte le opzioni di configurazione del modulo di test della portata sono disponibili nell’interfaccia web.
Esempi di applicazione
Integrazione con Google Earth
Passaggi:
-
Scarica e apri Google Earth.
-
Vai a File > Importa.
-
Scegli CSV.
-
Seleziona Delimitato, virgola.
-
Assicurati che l’opzione “Questo set di dati non contiene informazioni di latitudine/longitudine, ma indirizzi stradali” sia deselezionata.
-
Assegna rx lat e rx long ai campi di latitudine/longitudine.
-
Fai clic su Fine.
-
Quando ti viene richiesto di creare un modello di stile, seleziona Sì.
-
Imposta il campo Nome su una colonna qualsiasi che vuoi visualizzare sulla mappa (facendo clic su un’icona verranno comunque visualizzati tutti i dati).
-
Scegli un colore, un’icona ecc., quindi fai clic su OK.
Il tuo set di dati verrà caricato sulla mappa; seleziona la casella accanto a esso nella barra laterale per renderlo visibile.
My Maps
Puoi usare Google My Maps, che supporta i
file CSV e offre un’
interfaccia più semplice. Google fornisce istruzioni su
come configurare il tutto. Puoi anche
assegnare stili alle portate in base ai valori, ad esempio facendo apparire i segnaposto
più scuri quando SNR o RSSI è più alto.
OpenStreetMap - uMap
Come alternativa open source, puoi usare uMap, un servizio basato su OpenStreetMap.
-
Visita
uMap nella lingua che preferisci.
-
Fai clic su Crea una mappa.
-
Seleziona l’icona Importa dati oppure premi CTRL + I.
-
Scegli il file rangetest.csv e fai clic su Importa.
-
Il formato verrà riconosciuto automaticamente e le posizioni verranno aggiunte alla mappa.