Tutorial Meshtastic
Configurazione di base
- Installare l’antenna.
- Attenzione: se si accende la scheda prima che l’antenna sia montata, potrebbe bruciarsi.
- Collegarla alla porta USB.
Flashing del firmware
- Andare su https://flasher.meshtastic.org/
- Selezionare la propria scheda.
- Selezionare il firmware.
- Premere Flash.
- Selezionare la porta USB.
- Eseguire il flash del firmware.
Configurare il client
Client Web
- Andare su https://client.meshtastic.org/messages/broadcast/0 o clonare il repository ed eseguire il client localmente https://github.com/meshtastic/web
Mobile
- Per Android, andare su https://meshtastic.org/docs/software/android/installation/ e installare l’app.
- Per iOS, andare su https://meshtastic.org/docs/software/apple/installation/
CLI Python
pip install meshtastic
Per l’utilizzo, vedere: https://meshtastic.org/docs/software/python/cli/
Impostazioni
LoRa
| Impostazione | Valore |
|---|---|
| Regione | European Union 868MHz |
| Preset | Medium Range - Fast |
| Ignora MQTT | Attivo |
Dispositivo
| Impostazione | Valore |
|---|---|
| Intervallo di invio info nodo | 10800 secondi (3 ore) |
Posizione
| Impostazione | Valore |
|---|---|
| Intervallo di invio posizione | 21600 secondi (6 ore) |
Telemetria
| Impostazione | Valore |
|---|---|
| Intervallo metriche dispositivo | 259200 secondi (72h) |
Impostare il preset del canale tramite CLI Python
meshtastic --ch-medfast
meshtastic --host 192.168.1.xxx --ch-set lora.use_preset true --ch-index 0
meshtastic --host 192.168.1.xxx --ch-set lora.modem_preset MEDIUM_FAST --ch-index 0
meshtastic --reboot
meshtastic info
meshtastic --info | grep -i modem
Altri link
- https://mesh-schweiz.ch (informazioni in tedesco)
- https://drive.google.com/file/d/14Wd3UXRfnrliED6sUjJXb7UYsQ3iZCbp/edit
Raccomandazioni per le impostazioni svizzere
| Categoria | Sottocategoria | Impostazione | Valore raccomandato | Motivo / Note |
|---|---|---|---|---|
| Config Radio | Dispositivo | Ruolo | Client o Client_Mute | Client_Mute se dipendi da un nodo vicino in cima a una montagna; Client se altri dipendono dal tuo nodo. Evita router non necessari. |
| Config Radio | Dispositivo | Ruolo | Router / Repeater -> Solo in posizioni topograficamente significative | es. cime montuose con vista libera; non per nodi domestici/interni. |
| Config Radio | Dispositivo | Intervallo invio NodeInfo | 10800s (3 ore) | Gli smartphone memorizzano queste info; non serve inviarle più spesso. Il default è corretto. |
| Config Radio | Dispositivo | Modalità ridiffusione | ALL, opzionale: Local Only | ALL raccomandato. Usa Local Only solo se il tuo tempo d’antenne si avvicina al limite legale del 10%. |
| Config Radio | Posizione | Intervallo invio posizione | 21600s (6 ore) | I nodi fissi necessitano di aggiornamenti solo ogni 6 ore. Aumenta solo durante escursioni o spostamenti. |
| Config Radio | Posizione | Smart Position | Disabilitato | Causa invii frequenti dai nodi e può intasare il mesh. Disabilitare, specialmente se il GPS è tramite smartphone. |
| Config Radio | Posizione | Opzioni payload posizione | Opzionale (altitudine, satelliti, ecc.) | Includere solo se necessario; ogni campo aggiunto aumenta il carico del tempo d’antenna. |
| Config Radio | LoRa | Limite salti (Hop Limit) | 3-5 | Il mesh è grande; il limite di salti non dovrebbe superare 5. |
| Config Radio | LoRa | Ignora Duty Cycle | Disabilitato | Requisito legale UE/CH: 10% di tempo d’antenna all’ora. Non ignorare. |
| Config Radio | LoRa | Ignora MQTT | Abilitato | Usa MQTT solo per applicazioni specifiche; disabilita l’invio verso MediumFast. |
| Config Modulo | Telemetria | Intervallo metriche dispositivo | 259200s (72h) | Intervallo più lungo; previene lo spam di telemetria. |
| Config Modulo | Telemetria | Intervallo metriche sensore | Off (se non ci sono sensori) | Spegnere i sensori se non presenti. Se presenti, usare un intervallo lungo (3600s). |
| Config Modulo | Telemetria | Intervallo metriche potenza | Off | Solo per sensori di potenza esterni, non per il livello batteria. |
| Firmware | Aggiornamenti firmware | Aggiornare regolarmente | I nuovi firmware migliorano l’efficienza; Web-Flasher raccomandato. | |
| Generale | Nodi multipli in casa | Solo uno deve essere Client; gli altri Client_Mute | Evita tempo d’antenna inutile e relè duplicati. | |
| Generale | Nodo auto a casa | Client_Mute | Evita di intasare il mesh con nodi ridondanti. |
Riepilogo impostazioni
| Impostazione / Modulo | Cosa fa | Sempre attivo? | Note |
|---|---|---|---|
| Ruolo dispositivo: Router | Mantiene il nodo sveglio, ridiffonde tutti i pacchetti | Sì | Essenziale per i nodi backbone |
| Ruolo dispositivo: Client | Modalità utente standard | Sì | Comportamento predefinito |
| Ruolo dispositivo: Client Mute | Non invia beacon, invia solo messaggi utente | Situazionale | Usato per nodi mobili in reti dense |
| Canale primario | Canale centrale per il mesh | Sì | Tutti i nodi devono corrispondere |
| Canali secondari (Fast/MedFast/LongFast) | Canali di modulazione extra | Situazionale | Usare solo deliberatamente; può dividere il mesh |
| Invio posizione | Invia il GPS periodicamente | Situazionale | Aggiornamenti troppo frequenti consumano tempo d’antenna |
| Invio Smart Position | Invia solo in caso di movimento | Sì | Ideale per la salute della rete |
| Store and Forward | Memorizza i messaggi e li riproduce più tardi | Sì (nodo singolo) | Abilitare su un solo nodo fisso |
| Modulo test di portata | Invia pacchetti di test costanti | Solo test | Elevato consumo di tempo d’antenna |
| Telemetria base | Invia batteria/temp/ecc. del nodo | Sì | Impatto minimo sulla rete |
| Telemetria rapida / Debug | Telemetria ad alta frequenza | Solo test | Intasa la rete |
| Info vicini (Passivo) | Traccia i vicini diretti | Sì | Nessun impatto sul tempo d’antenna |
| Beaconing vicini | Annuncia la presenza del nodo | Sì | Critico per il routing |
| Modulo seriale (Dati su LoRa) | Invia byte seriali grezzi via mesh | Situazionale | Solo se hai davvero bisogno di UART-over-LoRa |
| Modulo notifiche esterne | Allarmi LED/buzzer | Sì | Nessun impatto sul mesh |
| Uplink MQTT | Pubblica i pacchetti sul broker | Sì (un gateway) | Abilitare solo sul nodo gateway designato |
| Downlink MQTT | Riceve i messaggi dal broker | Sì (un gateway) | Evitare nodi downlink multipli |
| Bluetooth | Accoppiamento app | Sì | Nessun impatto sulla rete |
| Wi-Fi (AP / Web UI) | Interfaccia di configurazione locale | Sì | Nessun impatto sulla rete |
| Modulo sensore rilevamento | Rapporto eventi PIR/sensore | Situazionale | Solo per installazioni con sensori |
| Modulo Luce ambientale / LED | Controllo comportamento LED | Sì | Nessun effetto sul mesh |
| Messaggi predefiniti | Pulsanti messaggi predefiniti | Sì | Sicuro |
| Uscita debug seriale | Stampa i log su USB | Solo test | Molto prolisso |
| Sincronizzazione NodeDB | Sincronizza i nodi noti per il routing | Sì | Aiuta tutti i nodi del mesh |
| Metriche di routing | Riporta SNR/RSSI dei salti | Sì | Cruciale per un routing stabile |
| Limite salti (Hop Limit) | Numero massimo di salti consentiti | Sì | Il default è ottimale |
| PAX Counter | Conta i dispositivi Wi-Fi/BLE | Situazionale | Opzionale |
| Trickle Rate / Heartbeats | Mantiene le tabelle di routing | Sì | Richiesto per la salute multi-salto |
| Impostazione regione LoRa | Conformità RF regionale | Sì | Deve corrispondere alla regione fisica |
| Modulazione LoRa (BW/SF/CR) | Velocità link e portata | Sì | Deve corrispondere ai default del mesh |
| LongFast / RouterFast Sperimentale | Modalità veloci sperimentali | Solo test | Rompe la compatibilità |
| Compressione messaggi di testo | Comprime i payload | Sì | Riduce il tempo d’antenna |
| Limitazione salti broadcast | Limita l’intasamento del mesh | Sì | Protegge la stabilità della rete |
| Uscita JSON MQTT | Invia JSON strutturato | Sì | Necessario per le dashboard |
| Topic MQTT crittografati (e/) | Payload crittografati grezzi | Sì | Meccanismo di base del protocollo |
| Flag posizione annunciata | Informa gli altri che invii il GPS | Sì | Necessario per la topologia |