Guida a Meshtastic - Configurazione del Modulo di Prova della Portata

Questo modulo ti permette di testare la portata di comunicazione tra due nodi Meshtastic. Solo i nodi con il modulo abilitato mostreranno i messaggi di test di portata sui loro client connessi.

Mittente: Un nodo fisso che invia pacchetti sequenziali a intervalli di 30-60 secondi (configurato come "Intervallo messaggi mittente").
Ricevitore: Un nodo mobile (tipicamente tu) che opzionalmente utilizza il GPS integrato o il GPS del telefono. I nodi sono considerati in portata finché i pacchetti sequenziali possono essere ricevuti con successo.

Il nodo ricevente ha la capacità di salvare i messaggi insieme alle coordinate GPS in cui sono stati ricevuti in un file .csv. Questo file .csv può poi essere integrato in Google Earth, Google Maps - My Maps o qualsiasi altro programma che possa elaborare file .csv, permettendoti di visualizzare la tua mesh. Assicurati di impostare la precisione della posizione nel canale predefinito su alta; altrimenti, i dati raccolti non registreranno accuratamente la tua posizione reale.

NOTA: Assicurati di spegnere il modulo o disabilitare l'invio quando non in uso, poiché questo consumerà molto tempo in aria, rallenterà la tua mesh e intaserà il tuo canale con messaggi non necessari. Il modulo si spegnerà automaticamente dopo 8 ore di utilizzo.

Le opzioni di configurazione del modulo di test di portata includono: Abilitato, Mittente e Salva. La configurazione del Modulo di Test di Portata utilizza un messaggio admin per inviare un protobuf ModuleConfig.RangeTestConfig.

Valori di Configurazione del Modulo di Test di Portata

Abilitato: Abilita il modulo range test. Sia il Mittente che il Ricevitore devono avere il modulo abilitato. Per le app Apple e Android per ricevere qualsiasi messaggio di range test, il modulo deve essere abilitato anche su quei dispositivi. Nota che lo schermo del dispositivo può comunque mostrare pacchetti di range test di versioni firmware più vecchie anche se il modulo è disabilitato.
Intervallo Mittente

Il tempo di attesa tra l'invio di pacchetti di test sequenziali è configurabile, con 0 come valore predefinito, che disabilita l'invio dei messaggi.

Impostazioni Consigliate per il Mittente

Impostazione Radio	range_test.sender
Lungo Lento	60
Lungo Veloce	30
Medio	15
Breve Veloce	15

Salva CSV File

Se abilitato, tutti i messaggi ricevuti vengono salvati nella memoria flash del dispositivo in un file chiamato rangetest.csv.

Per accedere a questo file, attiva il WiFi sul tuo dispositivo e connettiti alla tua rete. Una volta connesso, vai su meshtastic.local/rangetest.csv (o tuo_indirizzo_ip_dispositivo/rangetest.csv), e il file verrà scaricato automaticamente. Questo file sarà creato solo dopo che il dispositivo riceve i messaggi iniziali.

Per evitare di riempire lo spazio di archiviazione, il dispositivo smetterà di scrivere se c'è meno di 50KB di spazio disponibile nel filesystem.

NOTA: Lascia questa funzione disabilitata quando usi le app Android o Apple. Salva i dati direttamente nella memoria flash del dispositivo (senza richiedere uno smartphone) ed è disponibile solo su dispositivi basati su ESP32.

Client di Configurazione del Modulo Range Test

Android

Android esporta un file rangetest.csv dai pacchetti nel Log di Debug. Per cancellare i dati della cronologia dei pacchetti vecchi: Pannello di Debug > Cancella

Nota: Le opzioni di configurazione del Range Test sono disponibili su Android. Apri l'app Meshtastic e vai su Impostazioni > Range Test.

Mela

Le app Apple ti permettono 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 clicca 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. Esempi di comandi sono riportati di seguito:

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 riavvierà dopo ogni comando inviato tramite CLI, si consiglia, quando si impostano più valori in una sezione di configurazione, di concatenare i comandi in uno solo. Per 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 di portata

meshtastic --set range_test.save true meshtastic --set range_test.save false

Abilita il mittente del test di portata (invia ogni 60 secondi)

meshtastic --set range_test.sender 60

Disabilita il mittente del test di portata

meshtastic --set range_test.sender 0

Web

Tutte le opzioni di configurazione del modulo test di portata sono disponibili nell'interfaccia Web.

Esempi di applicazione

Integrazione Google Earth

Passaggi:

Scarica e apri Google Earth.
Vai su File > Importa.
Scegli CSV.
Seleziona Delimitato, Virgola.
Assicurati che l'opzione “Questo dataset non contiene informazioni di latitudine/longitudine, ma indirizzi stradali” sia deselezionata.
Assegna rx lat e rx long ai campi latitudine/longitudine.
Clicca su Fine.
Quando ti viene chiesto di creare un modello di stile, seleziona Sì.
Imposta il campo Nome su qualsiasi colonna tu voglia visualizzare sulla mappa (tutti i dati appariranno comunque cliccando su un'icona).
Scegli un colore, icona, ecc., quindi clicca su OK.

Il tuo dataset verrà caricato sulla mappa; seleziona la casella accanto ad 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 configurarlo. Puoi anche stilizzare gli intervalli in base ai valori—ad esempio, far apparire i pin più scuri quando SNR o RSSI sono più alti.

OpenStreetMap - uMap

Per un'opzione open-source, puoi usare uMap, un servizio basato su OpenStreetMap.

Visita uMap nella tua lingua preferita.
Clicca su Crea una mappa.
Seleziona l'icona Importa dati o premi CTRL + I.
Scegli il tuo file rangetest.csv e clicca su Importa.
Il formato verrà riconosciuto automaticamente e le posizioni saranno aggiunte alla mappa.