Guida
Tutti i passaggi, in italiano, per configurare il tuo primo nodo MeshCore e agganciarlo alla mesh italiana.
Prima di iniziare
Per configurare il primo nodo MeshCore servono tre cose: una board LoRa compatibile, un cavo USB dati funzionante (non solo di ricarica) e uno smartphone o un computer con un browser aggiornato. Non serve installare nessuna toolchain: il flash del firmware si fa interamente dal browser tramite il web flasher ufficiale. Questa guida copre l'intero percorso, dalla scelta della board al primo scambio di messaggi sulla mesh italiana. In circa mezz'ora, dal primo collegamento USB al primo messaggio ricevuto, puoi avere un nodo companion funzionante e allineato alla mesh italiana; se scegli di configurare anche un repeater o un room server, i passaggi iniziali di flash e accoppiamento restano gli stessi.
Passo passo
Otto passaggi, in ordine, per portare un nodo nuovo sulla mesh italiana.
01
Procurati una board LoRa supportata. Per una panoramica completa dei modelli e delle differenze tra chip ESP32 e nRF52 consulta la guida hardware alle board LoRa compatibili con MeshCore; l'elenco sempre aggiornato delle board supportate è comunque sul web flasher.
02
Collega la board al computer via USB e apri flasher.meshcore.io↗ da un browser basato su Chromium (richiede WebSerial). Seleziona la board dall'elenco e installa il firmware Companion. Su Linux, se il flasher non vede la porta seriale, è quasi sempre un problema di permessi: dai i permessi con sudo setfacl -m u:$USER:rw /dev/ttyUSB0 (adatta il device path al tuo caso, ad esempio /dev/ttyACM0) e ricarica la pagina. Se il problema persiste, consulta la pagina soluzioni ai problemi più comuni di MeshCore.
03
Su Android o iOS installa l'app MeshCore dallo store del tuo dispositivo. In alternativa, senza installare nulla, puoi usare il client web su app.meshcore.nz↗, che funziona anche da computer collegando il nodo via USB.
04
Dall'app cerca il nodo via Bluetooth (companion BLE) e accoppialo inserendo il PIN di default 123456. Se preferisci non usare il Bluetooth, o se il firmware installato è la variante "USB-only", collega il nodo via cavo USB: sia l'app mobile sia il client web supportano la connessione seriale.
05
Dal client, entra nelle impostazioni radio e scegli il preset EU/UK (Narrow), che corrisponde a 869.618 MHz · BW 62.5 kHz · SF8 · CR8. Da riga di comando, via seriale o da un client admin, lo stesso risultato si ottiene con set radio 869.618,62.5,8,8 seguito da reboot. Tutti i dettagli, incluso perché il vecchio preset è deprecato, sono nella pagina dedicata al preset radio italiano per MeshCore.
06
Assegna un nome riconoscibile: la convenzione usata dalla community italiana è IT-<citta>-NN per un companion, IT-<citta>-RPT-NN per un repeater e IT-<citta>-ROOM-NN per un room server (esempio: IT-TORINO-RPT-01). Da riga di comando si imposta con set name <nome>; l'elenco completo dei comandi disponibili è nella pagina comandi CLI per amministrare un nodo MeshCore.
07
Dopo aver riavviato il nodo con il nuovo preset, invia un advert (dal client, o via CLI con il comando advert) e chiedi a un altro membro della community di verificare che il tuo nodo compaia tra i suoi contatti. Se non succede, il problema quasi sempre è un preset radio non allineato: la pagina soluzioni ai problemi più comuni di MeshCore copre anche questo caso.
08
Unisciti al gruppo Telegram MeshCore ITA↗, pubblico e senza bisogno di invito, e presenta il tuo nodo nel topic dedicato ai nuovi membri o in quello della tua regione. Per dubbi non coperti da questa guida, la pagina domande frequenti su MeshCore in italiano raccoglie le domande più comuni della community.
Dopo il primo nodo
Il ruolo di un nodo dipende solo da come lo configuri, non dall'hardware.
01
Il client collegato via BLE o USB tramite app mobile o interfaccia web, quello configurato in questa guida. Non ripete i pacchetti degli altri nodi: serve per leggere e inviare messaggi, ed è il ruolo giusto per iniziare finché non hai familiarità con la mesh e con il preset radio condiviso.
02
Un repeater estende la copertura della mesh inoltrando i pacchetti sui percorsi appresi dal routing ibrido; un room server conserva fino a 32 messaggi non letti per utente, come una bacheca in stile BBS. Entrambi i ruoli danno il meglio se restano sempre accesi e raggiungibili, con lo stesso preset radio e lo stesso firmware aggiornato del resto della mesh.
