Come Iniziare con MeshCore

Un nodo Companion è il dispositivo personale con cui accedi alla rete MeshCore: si abbina via Bluetooth allo smartphone e ti permette di inviare e ricevere messaggi sulla mesh. Questa guida copre il flash del firmware, la configurazione regionale e il join alla rete LoRaSardegna.

Prima di iniziare

Per un'esperienza ottimale avrai bisogno di:

• Hardware: un dispositivo LoRa compatibile (es. Heltec V3, T-Beam).
• Connessione: un cavo USB-C dati (molti cavi inclusi con i caricabatterie caricano solo).
• Software: un computer con browser Chromium (Chrome, Edge o Brave) per il flash.

1. Flash del Firmware

Il firmware è il "sistema operativo" del tuo nodo. Utilizziamo il flasher web ufficiale.

1. Collega il dispositivo al computer via USB. Se non viene rilevato, vedi Risoluzione problemi.
2. Vai su flasher.meshcore.io.
3. Seleziona il tuo modello (es. Heltec V3).
4. Scegli la variante Companion (la variante per uso personale, abbinata allo smartphone via Bluetooth ).
5. Clicca su Flash e autorizza il browser ad accedere alla porta seriale.

2. Scarica l'App

L'app MeshCore ti permette di interagire con il nodo, leggere messaggi e configurare i parametri.

3. Configurazione Regionale

Prima di trasmettere, devi impostare la regione corretta per l'Italia. Senza questo passaggio il dispositivo potrebbe operare su frequenze non consentite.

1. Apri l'app MeshCore e connetti il dispositivo via Bluetooth (PIN mostrato sul display).
2. Vai in Settings (icona ingranaggio).
3. Seleziona Radio Settings.
4. Imposta Region su EU_868.
5. Assicurati che il preset sia su Narrow (default per MeshCore).
6. Salva: il dispositivo si riavvierà per applicare le impostazioni.

4. Unisciti al Canale Sardegna

Ora che il nodo è pronto, entra nella piazza virtuale della community sarda.

Metodo rapido: Scan QR

1. Apri l'app MeshCore.
2. Vai su Channels.
3. Tocca il menu e scegli + Add Channel.
4. Seleziona Scan a QR Code e inquadra il codice qui sotto:

Metodo manuale: Hashtag

Se non puoi usare la fotocamera, inserisci manualmente l'identificativo del canale:

1. In Channels, tocca + Add Channel.
2. Scegli Join a Hashtag Channel.
3. Copia e incolla questo codice: 26cc2dfcdb7daa82d8563df60100b5ce

Risoluzione problemi

Il dispositivo non viene rilevato dal flasher

La causa più comune è il cavo USB. Molti cavi inclusi con i caricabatterie supportano solo la ricarica: prova con un cavo diverso prima di procedere.

Se il cavo non è il problema:

• Browser: il flasher funziona solo con Chromium (Chrome, Edge, Brave). Firefox e Safari non supportano Web Serial API.
• Driver su Windows: alcuni dispositivi richiedono i driver CP210x o CH340. Scaricali dal sito del produttore del modulo e riavvia il PC.
• Porta USB: prova un'altra porta, preferibilmente USB 3.0.

Il dispositivo non si avvia dopo il flash

Se il dispositivo non risponde dopo il flash, verifica di aver selezionato il modello corretto nel flasher: installare il firmware per un hardware diverso è l'errore più comune. Puoi sempre ripetere il flash senza conseguenze permanenti.

Se il dispositivo è completamente irresponsivo, forza la modalità bootloader tenendo premuto il pulsante BOOT mentre colleghi il cavo USB, poi avvia il flash normalmente.

Il pairing Bluetooth fallisce

1. Apri le impostazioni Bluetooth del telefono.
2. Trova il dispositivo nell'elenco e seleziona "Dimentica" o "Dissocia".
3. Spegni e riaccendi il nodo.
4. Riprova il pairing dall'app MeshCore.

Non ricevo messaggi in rete

Spesso è normale, almeno all'inizio. I nodi si annunciano tramite messaggi di Advert e la scoperta può richiedere qualche minuto. Prova a inviare un messaggio nel canale Public e osserva la risposta:

• "Sent": il nodo ha trasmesso, ma nessun ripetitore ha risposto. Potresti essere fuori dalla copertura locale.
• "Heard 1 repeat": almeno un ripetitore ha ricevuto il tuo segnale. Sei in rete.

Domande frequenti

Come faccio a sapere se il flash è andato a buon fine? Il dispositivo si riavvia automaticamente al termine. Se è dotato di schermo, mostrerà il nome del nodo (es. MeshCore-A1B2). Se riesci ad abbinarlo all'app via Bluetooth e vedi lo stato del nodo nella schermata principale, il firmware è installato correttamente.

Tutti i nodi della rete devono avere la stessa versione firmware? No, MeshCore è generalmente retrocompatibile all'interno della stessa versione principale. Restare entro una versione di distanza evita problemi pratici, ma un nodo leggermente indietro non rompe la rete.

Dove trovo gli aggiornamenti e le note di rilascio? Sul repository GitHub di MeshCore sono pubblicate le release notes di ogni versione. Il blog ufficiale blog.meshcore.io annuncia le versioni più importanti.

Cosa succede alle impostazioni durante un aggiornamento? Di norma vengono mantenute. Aggiornamenti che saltano più versioni principali possono azzerare la configurazione: prima di aggiornare un ripetitore remoto inaccessibile fisicamente, è prudente aspettare che la versione si stabilizzi.

Posso usare lo stesso dispositivo con Meshtastic e MeshCore? Sì. Entrambi i firmware girano sullo stesso hardware. Puoi passare da uno all'altro eseguendo il flash del firmware corrispondente; le impostazioni del protocollo precedente vengono sovrascritte.

Prossimi passi