A cosa serve questa guida

MeshCore permette di creare una rete mesh basata su tecnologia LoRa, utile per la messaggistica e le comunicazioni tra dispositivi anche in assenza di infrastrutture tradizionali.

Prima di installare il firmware è importante capire quale ruolo dovrà avere il dispositivo:

• Companion BLE, per l’utilizzo con smartphone o tablet tramite Bluetooth;
• Companion USB Serial, per l’utilizzo da PC tramite collegamento USB;
• Repeater, per estendere la copertura radio della rete;
• Room Server, per creare una stanza con storico messaggi, simile a una piccola BBS.

La scelta corretta del firmware è fondamentale, perché determina il modo in cui il dispositivo verrà gestito dopo il flash.

Configuratore ufficiale MeshCore

Per eseguire il flash si utilizza il configuratore ufficiale MeshCore:

https://meshcore.co.uk/configurator/

Il configuratore consente di selezionare:

1. il modello esatto della board;
2. il ruolo del dispositivo;
3. la versione del firmware;
4. l’avvio della procedura di flash.

È consigliato utilizzare un browser compatibile come Google Chrome o Microsoft Edge da computer desktop, poiché alcune funzioni richiedono il supporto Web Serial.

Prima di iniziare: checklist minima

Prima di collegare e flashare la board, è bene verificare alcuni aspetti fondamentali:

• utilizzare una board supportata dal configuratore MeshCore;
• usare un cavo USB dati di buona qualità, non un semplice cavo di ricarica;
• installare eventuali driver USB richiesti dalla board;
• collegare sempre l’antenna LoRa prima di alimentare o trasmettere;
• verificare che la board sia nella banda corretta EU/UK Narrow (868 MHz per Europa/Italia);
• fare un backup dell’identità e delle chiavi se si sta aggiornando un nodo già in uso.

Attenzione: l’opzione full erase cancella i dati utente e può eliminare l’identità MeshCore del dispositivo. Va utilizzata solo quando realmente necessario.

Companion BLE o Companion USB?

Una delle prime scelte riguarda il tipo di Companion da installare.

Companion BLE

Il firmware Companion BLE è indicato quando si vuole usare il dispositivo con smartphone o tablet tramite Bluetooth.

È comodo per l’utilizzo sul campo, perché non richiede il collegamento fisico al telefono. Dopo il flash sarà necessario associare il dispositivo dall’app MeshCore.

Il PIN Bluetooth predefinito è generalmente: 123456

Questa modalità è consigliata per un nodo personale, mobile o portatile.

Companion USB Serial

Il firmware Companion USB Serial è indicato quando si vuole usare il dispositivo da PC o tramite web client con collegamento via cavo USB.

È una soluzione più stabile per prove, configurazioni rapide, laboratorio o postazioni fisse.

Questa modalità è consigliata quando si lavora spesso da computer oppure quando il Bluetooth non è necessario o risulta poco stabile.

Come scegliere il ruolo corretto

La scelta del ruolo dipende dall’utilizzo previsto.

Vuoi usare lo smartphone?

Scegli: Companion BLE

È la scelta più comoda per un dispositivo personale da portare con sé.

Vuoi usare il PC o il web client via cavo?

Scegli: USB Serial Companion

È ideale per test, configurazioni e utilizzo da postazione fissa.

Vuoi estendere la copertura radio?

Scegli: Repeater

Il repeater serve a rilanciare i messaggi e migliorare la copertura della rete MeshCore.

Vuoi creare una stanza con storico messaggi?

Scegli: Room Server

Il Room Server permette di gestire messaggi in una stanza, con una logica simile a una BBS.

Per una rete più stabile è preferibile separare i ruoli: un dispositivo dedicato come repeater e un altro dispositivo dedicato come Room Server.

Procedura rapida di flash

La procedura generale è la seguente:

1. Aprire il configuratore ufficiale MeshCore.
2. Collegare la board al PC tramite cavo USB dati.
3. Selezionare il modello esatto della board.
4. Selezionare il ruolo desiderato.
5. Scegliere la versione firmware.
6. Avviare il flash.
7. Non scollegare il dispositivo durante la procedura.

Alcune board possono richiedere l’ingresso manuale in modalità BOOT, DFU o flash mode. In certi casi può essere necessario premere il tasto BOOT/USER oppure effettuare un doppio reset.

Dopo il flash: prima configurazione

Dopo il flash, la configurazione cambia in base al ruolo installato.

Companion BLE

Aprire l’app MeshCore, associare il dispositivo via Bluetooth e configurare:

• nome del nodo;
• impostazioni radio;
• canale o preset;
• eventuale posizione;
• advert o condivisione del nodo.

Companion USB

Aprire il web client MeshCore da PC, collegare la seriale USB e verificare:

• connessione corretta;
• invio e ricezione messaggi;
• configurazione radio;
• nome nodo;
• eventuale posizione.

Repeater e Room Server

Per Repeater e Room Server si utilizza normalmente la configurazione via USB, tramite strumenti come Repeater Setup o Console.

Tra le impostazioni principali:

• nome del nodo;
• frequenza o preset radio;
• password amministrativa;
• posizione del nodo;
• test advert;
• verifica della raggiungibilità in rete.

Esempi di comandi utili:

password nuova_password_admin
set lat GPS_LAT
set lon GPS_LON
set path.hashmode 1

I comandi vanno sempre adattati alle indicazioni del proprio gruppo locale e alle regole radio applicabili.

Problemi comuni

Il dispositivo non compare

Possibili cause:

• cavo USB solo ricarica;
• driver USB mancanti;
• porta seriale occupata da un altro programma;
• browser non compatibile.

Soluzione consigliata: provare un altro cavo USB dati, una porta USB diretta del PC e un browser Chromium aggiornato.

Il flash fallisce

Possibili cause:

• modalità BOOT/DFU non attiva;
• board non correttamente riconosciuta;
• cavo instabile;
• browser non compatibile.

Soluzione consigliata: verificare la procedura specifica della board e riprovare entrando manualmente in modalità flash.

Il Bluetooth non è visibile

Possibili cause:

• è stato installato un firmware USB-only;
• il dispositivo è fuori portata;
• il telefono non ha completato correttamente l’abbinamento.

Soluzione consigliata: verificare di aver installato il firmware Companion BLE.

Il repeater non è gestibile

Possibili cause:

• frequenza o preset errato;
• password admin non nota;
• nodo fuori copertura;
• configurazione incompleta.

Soluzione consigliata: collegarsi via USB e controllare i parametri principali.

Il nodo non appare sulla mappa

Possibili cause:

• posizione non impostata;
• advert o share non eseguito;
• il nodo non è ancora stato osservato da un nodo osservatore;
• configurazione radio non coerente con la rete locale.