Guida a MeshCore
MeshCore è un firmware open source per radio LoRa che crea una rete di messaggistica senza internet e senza rete cellulare. I messaggi passano da una radio all'altra attraverso ripetitori, sono cifrati e possono coprire decine di chilometri.
01 · Cos'è MeshCore
Ogni nodo è una piccola scheda LoRa (Heltec, RAK, LilyGO, Seeed e molte altre) con un'antenna. I nodi si parlano direttamente via radio sulle bande libere: 868 MHz in Europa, 915 MHz in America e Oceania. Quando due persone sono troppo lontane, i ripetitori inoltrano i pacchetti fino a destinazione.
Rispetto a Meshtastic la differenza principale è che i nodi personali non ripetono: solo i ripetitori (e, se abilitati, i room server) inoltrano il traffico. Così l'etere resta libero, ci sono meno collisioni e i percorsi restano stabili.
02 · Come viaggiano i messaggi
Advert: farsi conoscere
Un advert è l'annuncio con cui un nodo trasmette nome, posizione e chiave pubblica (firmato, per evitare falsificazioni). Può essere zero hop (lo sente solo chi è in portata diretta) oppure flood (ripetuto da tutti i ripetitori). I Companion fanno advert solo quando lo chiedi tu; un ripetitore manda un advert flood ogni 12 ore di default.
Prima flood, poi percorso diretto
Il primo messaggio verso un contatto viaggia in flood: ogni ripetitore che lo sente lo ritrasmette. Quando arriva, il destinatario risponde con una conferma che contiene l'elenco dei ripetitori attraversati. Da quel momento il mittente usa quel percorso diretto: il percorso è scritto nel pacchetto e lo ritrasmettono solo i ripetitori indicati.
Il percorso viene appreso dalla conferma di consegna e riusato finché funziona.
Se un ripetitore del percorso sparisce, il messaggio fallisce dopo 3 tentativi; l'app azzera il percorso e riprova in flood, imparandone uno nuovo.
Canali
I messaggi nei canali (il canale pubblico e quelli privati, protetti da una chiave condivisa) non hanno un destinatario preciso, quindi viaggiano sempre in flood. Chi gestisce un ripetitore può limitare quanti salti fa il traffico flood con il comando set flood.max.
Quanti salti
Il firmware accetta al massimo 64 salti. Nella pratica ogni salto aggiunge ritardo e possibilità di collisione, quindi conviene avere pochi ripetitori ben piazzati piuttosto che molti ripetitori bassi.
03 · I tre ruoli
Lo stesso hardware può diventare Companion, Repeater o Room Server: dipende dal firmware che scegli nel flasher. Esiste anche un firmware Sensor per nodi di telemetria.
Companion
È il nodo che porti con te. Non ha un'interfaccia propria: lo usi da un'app. Ci sono due varianti di firmware:
- BLE Companion: si collega via Bluetooth all'app MeshCore per Android o iOS. Per le schede senza schermo il PIN di abbinamento predefinito è
123456. - USB Serial Companion: si collega via cavo a un PC o telefono e si usa dal client web app.meshcore.nz. Alcune schede hanno anche una variante Wi-Fi.
Dall'app scrivi ai contatti, usi i canali, condividi la posizione, invii il tuo advert e gestisci da remoto ripetitori e room server. Il Companion non ritrasmette i messaggi degli altri: per estendere la rete serve un Repeater.
Repeater
Il ripetitore estende la portata della rete: riceve i pacchetti e li ritrasmette verso la destinazione. Non ritrasmette tutto: in modalità diretta inoltra solo i pacchetti il cui percorso lo indica.
- Dove: il più in alto possibile (tetto, traliccio, collina), con antenna esterna e, se serve, alimentazione solare. L'altezza conta più della potenza.
- Come si gestisce: via USB dallo strumento web config.meshcore.io, oppure da remoto via LoRa con la funzione Remote Management dell'app (serve il login come amministratore).
- Password: quella di amministrazione predefinita è
password. Cambiala subito con il comandopassword <nuova>. - Posizione: non è obbligatoria, ma impostando latitudine e longitudine il ripetitore compare sulla mappa pubblica (e quindi in questi strumenti).
Room Server
Un room server è una piccola bacheca (BBS) condivisa. Chi ci entra con la password vede i messaggi pubblicati; il server conserva la cronologia e, al login, invia gli ultimi 32 messaggi non ancora letti. È la differenza principale rispetto ai canali, dove un messaggio o lo ricevi quando viene inviato oppure lo perdi.
- Password ospite predefinita:
hello, si cambia conset guest.password <password>. La password di amministrazione predefinita èpassword, come per i ripetitori. - Si gestisce come un ripetitore: via USB da config.meshcore.io o da remoto dall'app.
- Può anche ripetere (
set repeat on), ma è sconsigliato: un room server che ripete non ha tutte le funzioni di un vero ripetitore. Meglio usare due schede separate.
04 · Primi passi
- Procurati una scheda supportata e un'antenna per la banda della tua zona (868 MHz in Europa, 915 MHz in America e Oceania). L'elenco aggiornato è nel flasher.
- Carica il firmware da meshcore.io/flasher: scegli la scheda e il ruolo (Companion, Repeater o Room Server) e collegala via USB dal browser (Chrome o Edge).
- Collega il Companion all'app MeshCore (Android/iOS via Bluetooth) o al client web (USB).
- Imposta il preset radio della tua zona: in Europa (Italia compresa) si usa EU/UK (Narrow), cioè 869,618 MHz · BW 62,5 kHz · SF8 · CR8; negli USA e in Canada USA/Canada (Recommended), cioè 910,525 MHz · BW 62,5 kHz · SF7 · CR5. Tutti i nodi che devono parlarsi devono avere gli stessi parametri.
- Dai un nome al nodo e invia un advert, così gli altri ti vedono. Gli advert degli altri compaiono tra i contatti.
- Scrivi nel canale pubblico o a un contatto. Se non arriva niente, probabilmente non c'è un ripetitore in portata: controlla la mappa e valuta di installarne uno.
05 · Configurare un ripetitore
Dopo aver caricato il firmware Repeater, collega la scheda via USB e apri config.meshcore.io (o la console del flasher). Le stesse impostazioni si danno dalla riga di comando:
set name RPT-Montesacro # nome visibile sulla rete
set radio 869.618,62.5,8,8 # frequenza, banda, SF, CR (preset EU/UK Narrow)
set tx 22 # potenza in dBm
set lat 41.94120 # posizione: il nodo compare sulla mappa
set lon 12.53810
password una-password-robusta # cambia la password di amministrazione
advert # annuncia subito il ripetitore (flood)
Altri comandi utili: neighbors mostra i ripetitori sentiti direttamente, set flood.advert.interval <ore> cambia la frequenza degli advert, set flood.max <n> limita i salti del traffico flood, reboot riavvia. L'elenco completo è nel riferimento CLI.
Una volta installato, lo gestisci dall'app: apri il ripetitore tra i contatti, fai login con la password di amministrazione e usa Remote Management per vedere statistiche, vicini e cambiare le impostazioni via radio.
06 · Pianificare la rete
- Altezza prima di tutto. Pochi metri in più sopra i tetti valgono più di qualunque aumento di potenza: il segnale LoRa soffre molto ostacoli e colline.
- Riusa la rete che c'è. Nel mondo ci sono già decine di migliaia di ripetitori pubblicati sulla mappa. Prima di installarne uno nuovo, verifica se puoi agganciarti a uno esistente.
- Lascia margine. Un collegamento al limite funziona un giorno sì e uno no: punta ad almeno 10 dB oltre la sensibilità.
Gli strumenti di questo sito aiutano proprio in questo:
07 · Il modello di propagazione
Entrambi gli strumenti usano lo stesso modello. Per ogni collegamento si costruisce il profilo tra trasmettitore e ricevitore usando l'altimetria (tile Terrarium, circa 30 m di precisione all'origine) più gli edifici di OpenStreetMap (altezza dal tag height, da building:levels oppure un valore predefinito), con la curvatura terrestre corretta dal fattore k (1,33 in atmosfera standard).
La perdita è lo spazio libero più il minimo tra due percorsi possibili:
- diffrazione sopra tetti e terreno, con il metodo Deygout a spigoli multipli (ITU-R P.526);
- attraversamento diretto degli edifici: una perdita fissa per ogni edificio più un'attenuazione per metro all'interno.
La sensibilità del ricevitore si calcola da banda, spreading factor e cifra di rumore. Il margine è la differenza tra segnale ricevuto e sensibilità.
Nel pianificatore i punti candidati per i nuovi ripetitori sono i punti più alti (terreno più edificio) di ogni blocco del corridoio tra A e B, ordinati per quanto sporgono rispetto alla zona circostante. I ripetitori esistenti usati sono quelli attivi (aggiornati sulla mappa negli ultimi 30 giorni) e con lo stesso preset radio. La ricerca cerca prima il percorso con meno ripetitori nuovi, poi quello con meno salti, poi quello con i margini più ampi.
neighbors sul ripetitore o leggendo l'SNR nell'app.08 · Link utili
| Flasher firmware | meshcore.io/flasher |
| Configurazione via USB | config.meshcore.io |
| Client web | app.meshcore.nz |
| App Android | Google Play |
| App iOS | App Store |
| Mappa dei nodi | map.meshcore.io |
| Documentazione e FAQ | docs.meshcore.io · FAQ |
| Codice sorgente | github.com/meshcore-dev/MeshCore |