Configurazione di un Repeater MeshCore

I Repeater sono la spina dorsale della rete mesh. A differenza dei Companion (dispositivi personali), i repeater non inviano messaggi personali ma si limitano a ritrasmettere il traffico degli altri, estendendo la copertura della rete. Per maggiori dettagli sui ruoli dei nodi, consulta la guida I Ruoli dei Nodi.

1. Flash del Firmware Repeater

Il primo passo è installare il firmware specifico per repeater sul tuo dispositivo.

1. Collega il dispositivo al computer via USB.
2. Vai su meshcore.io/flasher con Chrome o Edge.
3. Seleziona il tuo modello (es. Heltec V3, RAK4631, Station G2).
4. Scegli la variante Repeater (non Companion).
5. Clicca su Flash e attendi il completamento.

Per i dispositivi consigliati, consulta la guida Hardware.

2. Configurazione Iniziale via USB

Dopo il flash, configura il repeater tramite la console web.

Accesso alla configurazione

1. Collega il dispositivo via USB al computer.
2. Apri config.meshcore.io in Chrome o Edge.
3. Il browser si connetterà automaticamente al dispositivo.

Impostazioni Base

Nella schermata di configurazione imposta:

• Region: EU_868
• Preset: EU/UK Narrow (869.618 MHz, SF8, BW 62.5 kHz, CR 4/8)
• Nome repeater: scegli un nome univoco (es. SAR-CAG-Montagna)
• Posizione: imposta latitudine e longitudione (necessario per la mappa)
• Orario: la sincronizzazione avviene automaticamente quando ti connetti. In alternativa, imposta l'ora via CLI con clock sync (se GPS attivo) o set time <epoch>
• Password admin: imposta una password sicura per proteggere la configurazione
• TX Power: consigliato 17-22 dBm (max consentito: 27 dBm ERP = 500 mW)

Clicca Save per salvare le impostazioni. Il dispositivo si riavvierà.

3. Configurazione Avanzata via CLI

Alcune impostazioni avanzate non sono disponibili nella UI web e richiedono la CLI. Puoi accedere alla CLI in due modi:

• Via USB: meshcore.io/flasher → clicca su Console
• Via app Companion: usa la funzione Remote Admin per connetterti al repeater sulla rete mesh

Path Hash Mode a 2 Byte

Imposta il path hash mode a 2 byte per una migliore gestione dei pacchetti nella rete:

set path.hash.mode 1

Valori disponibili:

• 0: 1 byte (256 unique ids, 64 max flood), default
• 1: 2 byte (65.536 unique ids, 32 max flood), consigliato
• 2: 3 byte (16.777.216 unique ids, 21 max flood)

Configurazione Region Scope

Per limitare la propagazione geografica dei messaggi, configura le regioni Italia e Sardegna (firmware v1.12.0+):

region put it
region put it-sar it
region allowf it
region allowf it-sar
region save

Questa configurazione:

• Crea la regione it (Italia)
• Crea la sotto-region it-sar (Sardegna) sotto it
• Abilita il flood per entrambe le regioni
• Salva la configurazione in modo permanente

Verifica con:

region

Dovresti vedere:

  *^ F
  it F
  it-sar F

Region Default (facoltativo, firmware v1.15.0+)

Il Default Scope è un meccanismo distinto dal Region Scope: invece di filtrare i pacchetti in transito, marca con una regione geografica i pacchetti che originano dal dispositivo.

Su un repeater, il Default Scope si applica solo agli advert generati dal repeater stesso. Non modifica in alcun modo il traffico inoltrato. Serve a confinare gli annunci di presenza del ripetitore entro una regione specifica, senza interferire con il relay dei messaggi.

L'effetto più significativo sul contenimento del traffico cross-regione si ottiene attivando il Default Scope sul Companion (app MeshCore v1.43.0+, menu Experimental Settings → Default Scope Region). In questo caso tutti i flood packet originati dal Companion — advert, messaggi diretti, richieste di login a percorsi sconosciuti — vengono marcati con la regione specificata. Lo scope impostato su un canale sovrascrive il default per quel canale.

Per abilitarlo sul repeater:

region default it

Per rimuoverlo e ripristinare il comportamento wildcard:

region default

4. Finalizzazione via App Companion

Dopo la configurazione CLI, completa l'installazione tramite l'app MeshCore :

1. Apri l'app MeshCore sul tuo smartphone.
2. Connettiti al tuo Companion via Bluetooth .
3. Cerca il repeater nella lista dei nodi.
4. Seleziona Remote Admin e inserisci la password admin impostata al punto 2.
5. Verifica le impostazioni: Advert interval, TX Power, flood max hops.
6. Per apparire sulla mappa pubblica, seleziona il repeater nei contatti, vai sul menu e scegli Upload to internet map.

5. Posizionamento e Installazione

La posizione del repeater è il fattore più importante per le sue performance.

Altezza

• Il fattore determinante: un repeater a 10m di altezza supera facilmente uno a 2m
• Ideale: tetto, attico (attenzione ai tetti metallici), palo, traliccio, collina
• Anche un singolo piano in più fa una grande differenza

Line of Sight

LoRa funziona meglio con visibilità diretta:

• Evita ostacoli tra antenna e area da coprire
• In Sardegna la terreno piatto o ondulato favorisce la propagazione
• Alberi, edifici, colline riducono significativamente la portata

Opzioni di Montaggio

• Tetto: supporto a J o morsa per camino
• Attico: buon compromesso se non puoi montare esternamente
• Palo/mast: per installazioni temporanee o testing
• Traliccio: ideale se hai accesso a strutture esistenti

6. Alimentazione

Opzioni Disponibili

Consigli Solar

Per installazioni off-grid permanenti:

• Pannello 5-6W minimo (10W consigliato per margine)
• Batteria 6000-10000mAh
• Orientamento: sud, 45° di inclinazione
• Contenitore IP65 con gel di silice anti-umidità

Risoluzione problemi

Verifica il Funzionamento

1. Check mappa: se il GPS è attivo, il repeater appare su map.meshcore.io entro pochi minuti
2. Test con Companion: avvicinati al repeater con un Companion e verifica che i messaggi vengano inoltrati
3. RSSI : nell'app, controlla il signal strength verso il repeater. Valori sopra -120 dBm indicano un link utilizzabile

Problemi Comuni

Domande frequenti

Posso aggiornare il firmware di un repeater installato in posizione remota? No. L'aggiornamento del firmware richiede connessione USB fisica al dispositivo. Solo la configurazione è modificabile da remoto tramite Remote Admin.

Il repeater richiede connessione internet? No. La rete mesh opera completamente off-grid senza server centrali. La connessione a internet serve solo per l'upload alla mappa pubblica (map.meshcore.io).

Il repeater memorizza i messaggi? No. Un repeater ritrasmette i pacchetti che riceve ma non li conserva. Per la memorizzazione dei messaggi serve un nodo configurato come Room Server .

Posso configurare il repeater senza un nodo Companion? La configurazione iniziale (flash e parametri base via config.meshcore.io) non richiede un Companion. La finalizzazione via app (sezione 4) richiede invece un dispositivo Companion nelle vicinanze per la connessione Remote Admin.

Quando conviene aspettare prima di aggiornare il firmware di un repeater remoto? Se il repeater è installato in una posizione difficile da raggiungere, aspetta qualche giorno dopo il rilascio di una nuova versione. Un aggiornamento che azzera le impostazioni su un dispositivo remoto richiede accesso fisico per la riconfigurazione.

Prossimi passi