Un terminale LoRa avanzato per configurare, monitorare e gestire dispositivi Meshtastic. Funziona come app desktop su Windows, macOS e Linux. Si connette al tuo dispositivo via USB e ti permette di configurare parametri radio, canali, ruoli, e molto altro — tutto dal browser, senza bisogno di Android o iOS.
| Componente | Minimo | Consigliato |
|---|---|---|
| Sistema Operativo | Windows 10 / macOS 11 / Ubuntu 20.04 | Windows 11 / macOS 14 / Ubuntu 22.04 |
| Python | 3.9 | 3.11+ |
| RAM | 512 MB | 1 GB |
| Spazio Disco | 100 MB | 200 MB |
| USB | Porta USB per il dispositivo | USB 2.0+ |
| Browser | Qualsiasi browser moderno | Chrome / Edge / Firefox |
Scarica Python da python.org. IMPORTANTE: spunta "Add Python to PATH" durante l'installazione!
Se il dispositivo non viene riconosciuto, installa il driver appropriato:
| Heltec / T-Beam | CP210x (Silicon Labs) |
| Cloni / board economiche | CH340 (WCH) |
| T-Echo / RAK | Integrato in Windows 10+ |
# Apri Prompt dei comandi o PowerShell
cd app
pip install -r requirements.txt
Doppio click su start_app.bat oppure:
cd app python start_app.py
Si apre automaticamente nel browser: http://localhost:5555
# Se non hai Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Installa Python: brew install python
macOS riconosce la maggior parte dei dispositivi automaticamente. Se serve:
# Solo per dispositivi con chip CH340:
brew install --cask wch-ch34x-usb-serial-driver
cd app chmod +x start_app.sh ./start_app.sh
Lo script crea automaticamente un ambiente virtuale Python, installa le dipendenze e avvia l'app. Non serve eseguire pip install manualmente.
Alternativa: python3 start_app.py (rileva automaticamente se serve il venv e lo crea)
Si apre automaticamente nel browser: http://localhost:5555
# Ubuntu/Debian: sudo apt update && sudo apt install python3 python3-pip python3-venv # Fedora/CentOS: sudo dnf install python3 python3-pip
# Aggiungi il tuo utente al gruppo dialout (richiede logout/login): sudo usermod -a -G dialout $USER # Verifica dopo il re-login: ls -la /dev/ttyUSB0
usermod, devi fare logout e login per rendere effettivi i permessi!cd app pip3 install -r requirements.txt
cd app python3 start_app.py
Oppure usa lo script:
chmod +x start_app.sh ./start_app.sh
L'app richiede una licenza valida per le funzionalità avanzate. I livelli disponibili sono:
| Livello | Funzionalità |
|---|---|
| 🟢 BASE | CLI, Configurazione dispositivo, Info Nodo, Dev Tools |
| ⭐ PRO | + Config Pro avanzata, PSK Generator, Gestione Canali |
| 🔧 PRO+MOD | + MOD Firmware, esptool flash, Modifica hardware |
Apri l'app e vai nella sezione Info Licenza. Il tuo codice macchina unico viene mostrato automaticamente (formato: A7F3-K9M2-X4B8-Q1D6).
Comunica il codice macchina all'amministratore MANGOLINK via Telegram o email. Specifica il livello di licenza desiderato.
Riceverai due file: license.key e pub_key. Questi file sono legati al TUO computer e non funzionano su altre macchine.
Copia i due file nella cartella principale dell'app (la stessa cartella dove si trova start_app.py). Riavvia l'app — la licenza verrà rilevata automaticamente.
Il Monitor è un osservatorio completo della rete LoRa intorno a te. Ti mostra chi è attivo, cosa viene trasmesso, come si muove il traffico e dove sono posizionati i nodi — tutto in tempo reale. Si attiva con un click ed è completamente opzionale.
| Sezione | Cosa trovi |
|---|---|
| Hub | Elenco di tutti i nodi attivi con nome, ID, firmware, ultimo contatto, qualità del segnale. Ricerca globale e scheda di dettaglio per ogni nodo. |
| Nodi | Lista completa con posizione GPS quando disponibile, numero di salti, ruolo (router, client, tracker). Apertura diretta su Google Maps. |
| Classifiche | Top nodi più attivi, canali più usati, tipo di messaggio più frequente, mappa di calore orario. Finestre da 1 ora fino a 30 giorni. |
| Analyst | Rilevamento automatico di comportamenti anomali: nodi che inviano troppi pacchetti (spam), nodi stealth, nodi silenziosi. Utile per mantenere la rete sana. |
| Crypto Agent | Se hai le chiavi dei canali, il Monitor può mostrare anche i messaggi decifrati (testo, telemetria, posizioni). Senza chiave resta tutto privato. |
| Rete | Configurazione rapida per le reti italiane: Mesh Italia, LoRa Italia e altre. Imposta il PSK del canale principale con un click. |
| Soglie & Preset FW | Profili ottimizzati (LongFast, MediumFast, ShortFast, LongSlow, VeryLongSlow). Un click applica tutte le soglie di protezione e carico per quel profilo. |
Dalla barra di navigazione principale, clicca la scheda 📡 Monitor. La funzione è disponibile con licenza PRO o superiore.
Vedrai una card iniziale con un grande bottone di attivazione. Un click e il Monitor comincia ad ascoltare il traffico che arriva dal tuo nodo USB.
Nella sezione Soglie & Preset FW puoi scegliere un profilo di lavoro adatto alla tua zona: LongFast per copertura estesa, MediumFast per uso generico, ShortFast per reti urbane fitte.
Più resti in ascolto, più classifiche, statistiche e mappe diventano ricche. Tutto è conservato localmente sul tuo computer — niente va su Internet.
Installa il driver USB corretto (vedi sezione Installazione). Su Linux, assicurati di essere nel gruppo dialout. Prova un cavo USB diverso (alcuni cavi sono solo di ricarica, senza dati).
Verifica che Python sia nel PATH di sistema. Su Windows: apri cmd e digita python --version. Se non funziona, reinstalla Python con "Add to PATH" selezionato.
Esegui pip install -r requirements.txt nella cartella app/. Se usi Python 3, prova con pip3 invece di pip.
L'app cerca automaticamente una porta libera (5555-5565). Se tutte sono occupate, chiudi le altre applicazioni che usano quelle porte.
Verifica che license.key e pub_key siano nella cartella corretta. Controlla che la licenza non sia scaduta nella sezione Info Licenza dell'app.