📡 Meshtastic Italia Network App v1

🔐

🔐 Attivazione App v1.2.0

Per accedere a CLI, Configurazione, Nodo e Dev serve una licenza.

⚖️ TERMINI D'USO, COPYRIGHT E DISCLAIMER

© 2026 🌐🥭MANGOLINK🥭🌐 — Tutti i diritti riservati

LICENZA D'USO: Questa applicazione è distribuita esclusivamente per uso non commerciale legato alla community Meshtastic Italia Network. È vietata la riproduzione, distribuzione o modifica per scopi commerciali senza autorizzazione scritta dell'autore.

DISCLAIMER DI RESPONSABILITÀ: L'utilizzo di questa applicazione e dei dispositivi Meshtastic è sotto la PIENA E TOTALE RESPONSABILITÀ DELL'UTENTE. Gli autori, sviluppatori e la community Meshtastic Italia Network NON si assumono ALCUNA responsabilità per:
• Danni diretti, indiretti, incidentali o consequenziali
• Configurazioni errate dei dispositivi radio
• Violazioni delle normative sulle telecomunicazioni
• Danni a dispositivi hardware (incluso accensione senza antenna)
• Interferenze radio o disturbi a servizi terzi
• Perdita dati, comunicazioni mancate o ritardate
• Qualsiasi danno economico, fisico o legale

NORMATIVE RADIO: L'utente è OBBLIGATO a rispettare: Regione EU_868, max 27 dBm (500mW ERP), Duty Cycle 10%. MAI accendere senza antenna. L'uso improprio delle frequenze radio è PERSEGUIBILE PER LEGGE (D.Lgs. 259/2003).

PRIVACY: L'app gira su localhost. Nessun dato personale viene inviato a server esterni. Il file license.key contiene solo il fingerprint hardware criptato.

Contatti: [email protected] | t.me/MeshtasticItalia | discord.gg/Rbhwf54nB3

Ho letto e accetto i Termini d'Uso, il Disclaimer di Responsabilità e le Normative Radio. Confermo che l'utilizzo dell'app e dei dispositivi è sotto la mia piena responsabilità.

Il tuo codice macchina:

Caricamento...

📖 Guida Attivazione:
1️⃣ Copia il codice macchina qui sopra
2️⃣ Invialo a MANGOLINK_LATINA su Telegram (t.me/MeshtasticItalia) o via email a info@meshtasticitalia.it
3️⃣ Riceverai 2 file: license.key + pub_key
4️⃣ Metti entrambi i file nella cartella dell'app
5️⃣ Clicca "🔄 Verifica Licenza" qui sotto
ℹ️ Il file pub_key contiene la chiave pubblica di verifica. Per i rinnovi basta sostituire license.key

ℹ️ Le sezioni Guida, Flash, Tecnica, Assistente e Links sono accessibili gratuitamente senza licenza.

📖 Guida Iniziale

Tutto quello che ti serve per partire da zero.

📡 Cos'è Meshtastic?

Un sistema per comunicare senza internet, senza SIM e senza abbonamenti. Usa piccole radio LoRa a 868 MHz che creano una rete mesh — ogni nodo può ricevere e ritrasmettere messaggi, estendendo la copertura automaticamente.

Il Meshtastic Italia Network è la community italiana che coordina la configurazione e la copertura su tutto il territorio nazionale.

📡 ANTENNA SEMPRE COLLEGATA! Non accendere MAI il dispositivo senza antenna — rischi di bruciare il chip radio!

🔌 Cavo USB DATI! Usa un cavo che supporta trasferimento dati, NON solo ricarica. Se il PC non vede il dispositivo, probabilmente è il cavo.

🛒 Hardware Supportato (25 dispositivi)

📟 Heltec V3 (~30€)

ESP32-S3 • SX1262 • OLED 0.96" • WiFi/BLE

Lo standard economico. Il più diffuso in Italia.

⚡ Heltec V4 (~40€)

ESP32-S3 • SX1262 • 27dBm • 2MB PSRAM • 16MB Flash

Porta solare e connettore GPS. Pin-compatibile V3.

📡 Heltec Wireless Tracker (~35€)

ESP32-S3 • SX1262 • GPS UC6580 • OLED

GPS integrato nativo. Perfetto per tracking.

🛰️ T-Beam V1.1 (~45€)

ESP32 • SX1276 • GPS NEO-6M • 18650

Il classico! GPS + batteria 18650. Giorni di autonomia.

🛰️ T-Beam Supreme S3 (~65€)

ESP32-S3 • SX1262 • GPS L76K • OLED 1.3"

Top: sensori, RTC, IMU 6 assi, display grande.

⌨️ T-Deck (~70€)

ESP32-S3 • SX1262 • IPS 2.8" • Tastiera

Tastiera QWERTY + trackball. Standalone!

⌨️ T-Deck Plus (~80€)

ESP32-S3 • SX1262 • IPS 2.8" • GPS

T-Deck con GPS integrato.

📱 T-Echo (~55€)

nRF52840 • SX1262 • E-Ink 1.54" • GPS • NFC

Case incluso, e-paper, ultra low power. Pronto all'uso.

⌚ T-Watch S3 (~70€)

ESP32-S3 • SX1262 • IPS 1.54" Touch

Smartwatch LoRa! Meshtastic al polso.

🧩 RAK WisBlock 4631 (~30€)

nRF52840 • SX1262 • Modulare

Gold standard per solare. Modulare, aggiungi sensori.

📱 RAK WisMesh Pocket V2 (~99€)

nRF52840 • SX1262 • OLED 1.3" • GPS • SOS

Handheld pronto all'uso con pulsante SOS.

📱 RAK WisMesh Pocket Mini (~59€)

nRF52840 • SX1262 • GPS • Ultra compatto

Nodo mini tascabile, solo LED.

💪 RAK WisMesh 1W Booster (~60€)

nRF52840 • SX1262 • 1W (30 dBm) • PA

Alta potenza con amplificatore SKY66122!

🖥️ RAK WisMesh TAP V2 (~120€)

nRF52840 • SX1262 • Touch 3.5" • GPS • IP67

Touchscreen outdoor, waterproof.

💳 SenseCAP T1000-E (~40€)

nRF52840 • LR1110 • GPS • IP65

Grande come carta credito! Tracker ultra compatto.

☀️ SenseCAP Solar P1 (~70$)

nRF52840 • SX1262 • Solare • IP67

Solare 48mA relay. Metti e dimentica.

☀️ SenseCAP Solar P1 Pro (~90$)

nRF52840 • SX1262 • Solare Pro • IP67

Versione pro, batteria maggiorata.

📡 Wio Tracker L1 (~30€)

ESP32-S3 • SX1262 • GPS

Economico con GPS. Modulare.

📡 Wio Tracker L1 Pro (~43€)

ESP32-S3 • SX1262 • E-Ink • GPS • Solare

E-Ink + solare integrato. Handheld pronto.

📱 Nano G2 Ultra (~85€)

nRF52840 • SX1262 • OLED 1.3" • GPS • BLE 5.4

3.5 giorni di batteria! Ultra efficiente.

🛡️ Canary One (~120$)

nRF52840 • SX1262 • LCD • GPS

Rugged per ambienti estremi.

💪 Station G2 (~80€)

ESP32-S3 • SX1262 • Alta potenza

Per radioamatori. Potenza elevata.

🏔️ ThinkNode M2 (~50€)

ESP32-S3 • SX1262 • OLED • GPS

Outdoor portatile compatto.

📱 Muzi R1 Neo (~60€)

nRF52840 • SX1262 • OLED • GPS • Buzzer

Design custom, notifiche sonore.

🔧 RAK11310 RP2040 (~25€)

RP2040 • SX1262 • DIY

Per maker. UF2 bootloader, economico.

🔌 Driver USB

Driver necessari per collegare il dispositivo al PC

Rilevamento OS...

CP210x (Silicon Labs)

Usato da: Heltec V3/V4, T-Beam, la maggior parte

📥 Scarica CP210x

CH340 / CH341 (WCH)

Usato da: cloni, dispositivi economici

📥 Win 📥 Mac

ℹ️ Dopo l'installazione dei driver, RIAVVIA il PC prima di procedere.

⚡ Flash Firmware

Installa o aggiorna il firmware Meshtastic sul tuo dispositivo.

🌐 Il flash richiede Chrome, Edge, Brave o Opera. Firefox e Safari NON supportano WebSerial.

🚀 Web Flasher — Metodo Consigliato

Il modo più rapido per flashare. Funziona direttamente dal browser, senza scaricare nulla.

🔗 Apri Web Flasher → flasher.meshtastic.org

📋 Procedura Passo-Passo

Collega il dispositivo al PC con un cavo USB dati
Apri il Web Flasher su Chrome o Edge
Seleziona il tuo dispositivo dalla lista (Heltec V3, T-Beam, ecc.)
Versione: scegli "Stable" (consigliata)
Full Erase & Install: CONSIGLIATO — cancella tutto e installa pulito
Connetti porta seriale (COM3/COM4 su Windows, /dev/cu.usb* su Mac)
Flash! Attendi 1-3 minuti. NON scollegare il cavo!

🔧 Modalità Bootloader (se il flash non parte)

Dispositivo	Procedura
Heltec V3/V4	Tieni premuto BOOT, premi e rilascia RST, poi rilascia BOOT
T-Beam	Tieni premuto BOOT, collega il cavo USB, poi rilascia BOOT
T-Deck	Spegni. Tieni premuta la trackball, accendi, poi rilascia
RAK WisBlock	Doppio click sul tasto RESET per entrare in UF2

🔍 Rileva Porte USB

💻 Comandi CLI Meshtastic

Clicca ▶ per eseguire direttamente nel terminale, o 📋 per copiare.

📊 Info Dispositivo

Info completa del nodo

meshtastic --info

Lista nodi visibili

meshtastic --nodes

Tutte le impostazioni

meshtastic --get all

Esporta config YAML

meshtastic --export-config

Versione CLI

meshtastic --version

📡 Regione e Radio

Imposta EU_868 (OBBLIGATORIO Italia!)

meshtastic --set lora.region EU_868

Preset MediumFast (Standard Italia)

meshtastic --set lora.modem_preset MEDIUM_FAST

👤 Identità del Nodo

Nome lungo (personalizza!)

meshtastic --set-owner "MioNodo-Roma"

Nome corto (4 char)

meshtastic --set-owner-short "MNRM"

🌐 MQTT

Abilita MQTT

meshtastic --set mqtt.enabled true

Server MQTT

meshtastic --set mqtt.address "mqtt.meshtastic.org"

Root topic Italia

meshtastic --set mqtt.root "msh/EU_868/IT"

Crittografia MQTT

meshtastic --set mqtt.encryption_enabled true

💬 Messaggistica

Invia messaggio

meshtastic --sendtext "Ciao dal CLI!"

Invia su canale specifico (Ch4)

meshtastic --sendtext "Aiuto" --ch-index 4

🔧 Utilità

⚠️ Reset fabbrica (cancella TUTTO!)

meshtastic --factory-reset

Riavvia dispositivo

meshtastic --reboot

Cancella lista nodi

meshtastic --reset-nodedb

🖥️ Terminale Live

📡 Terminale Meshtastic — Clicca ▶ su un comando o scrivi qui sotto

meshtastic

📡 Guida Tecnica Completa

Tutto quello che devi sapere su Meshtastic, dalla teoria alla pratica.

📡 Cos'è Meshtastic?

Meshtastic è un progetto open-source che trasforma radio LoRa economiche in una rete mesh decentralizzata. Ogni nodo funge da ripetitore per gli altri, creando una rete che si estende automaticamente.

📻

LoRa Radio

Comunicazione a lungo raggio (fino a 250+ km in condizioni ideali) con bassissimo consumo energetico.

🕸️

Rete Mesh

Ogni nodo ritrasmette i messaggi. Nessun server centrale, nessuna SIM, nessun abbonamento. Off-grid totale.

🔒

Crittografia E2E

Messaggi cifrati AES-256 + Curve25519 PKC. Nessuno può leggerli tranne i destinatari.

🇮🇹 Standard del Network Italiano — Parametri Obbligatori

Per comunicare sulla rete Meshtastic Italia TUTTI devono usare questi parametri identici:

EU_868

Regione — 868 MHz

⚠️ Usare altre regioni in Italia è ILLEGALE

MediumFast

Preset Modem

SF11 / BW250 / CR4/5

27 dBm

Max potenza TX

500 mW ERP — Limite EU legale

msh/EU_868/IT

Root MQTT — identifica i nodi italiani sulle mappe globali

Duty Cycle 10%

Limite EU — max 36 sec di TX ogni 6 minuti

📻 Come Funziona LoRa — La Tecnologia Radio

LoRa (Long Range) usa una modulazione CSS (Chirp Spread Spectrum) che "spalma" il segnale su una banda larga, rendendolo resistente al rumore e capace di viaggiare molto lontano.

Parametro	Cos'è	Valore MediumFast	Effetto
Spread Factor (SF)	Quanto tempo impiega a trasmettere un bit. SF più alto = più lento ma più portata	SF11	Buon compromesso portata/velocità
Bandwidth (BW)	Larghezza della banda radio usata. Più larga = più veloce ma meno portata	250 kHz	Velocità maggiore di LongFast (125kHz)
Coding Rate (CR)	Quanti dati extra aggiungi per correggere errori. 4/8 = massima protezione	4/5	Minima ridondanza, velocità ottimale
Hop Limit	Quanti nodi può attraversare un messaggio prima di fermarsi	3 (default)	Evita congestione. Max 7 per reti sparse

📊 Preset Radio a Confronto

MediumFast è lo standard italiano. Gli altri preset sono per casi specifici.

Preset	SF	BW	Bitrate	Portata	Uso
SHORT_FAST	7	250	~6.8 kbps	~3 km	Test locale rapido
SHORT_SLOW	8	250	~3.9 kbps	~5 km	Edifici vicini
MEDIUM_FAST ⭐	11	250	~1.1 kbps	~20 km	STANDARD ITALIA
MEDIUM_SLOW	11	250	~0.3 kbps	~30 km	Portata media, lento
LONG_FAST	11	125	~0.5 kbps	~40 km	Default Meshtastic mondiale
LONG_MODERATE	11	125	~0.3 kbps	~60 km	Reti molto sparse
LONG_SLOW	12	125	~0.18 kbps	~100+ km	Massima portata possibile
VERY_LONG_SLOW	12	62.5	~0.09 kbps	~200+ km	Record di distanza

👤 I 12 Ruoli del Dispositivo (firmware 2.7.x)

Il ruolo definisce il COMPORTAMENTO del nodo nella rete. Scegliere quello sbagliato può danneggiare la rete!

⚠️ ROUTER_CLIENT è DEPRECATO dal firmware 2.3.15 — Non usarlo più!

Ruolo	Ritr.	Prior.	BLE/WiFi	Display	Visib.	Descrizione e quando usarlo
🟢 CLIENT	Sì*	—	✅	✅	✅	Default. Invia, riceve, ritrasmette. Per la maggior parte degli utenti.
🟢 CLIENT_MUTE	No	—	✅	✅	✅	NON ritrasmette. Per zone dense o se hai più nodi (metti tutti tranne uno su MUTE).
🟢 CLIENT_HIDDEN	Loc.	—	✅	✅	❌	Invisibile nella lista nodi altrui. Per privacy/stealth.
🟡 CLIENT_BASE	Sì*	Fav.	✅	✅	✅	⭐ 2025! "Base station". Ritrasmette con priorità i nodi nei tuoi Preferiti. Ideale per nodo tetto.
🔵 TRACKER	Sveg.	—	✅	❌	✅	Si sveglia, invia GPS, torna a dormire. LoRa SPENTA in sleep. Per bici/auto/zaini.
🔵 SENSOR	Sveg.	—	✅	❌	✅	Come TRACKER ma per sensori ambientali (BME280, BME680, SHT40). Stazioni meteo.
🔵 LOST_AND_FOUND	Sì	—	✅	❌	✅	Invia posizione come TESTO sul canale primario. Per ritrovare nodi smarriti.
🟤 TAK	Sì	—	✅	Opz.	✅	Per comunicazione con ATAK (Android Team Awareness Kit). Riduce trasmissioni routine.
🟤 TAK_TRACKER	Sì	—	✅	Opz.	✅	TAK + invio posizione automatico senza app ATAK collegata.
🟡 ROUTER_LATE	SEMPRE**	—	✅	✅	✅	⭐ 2025! "Router gentile". Ritrasmette sempre ma ASPETTA se sente un altro nodo. Per tetti in città.
🔴 ROUTER	SEMPRE	Alta	❌	❌	✅	INFRASTRUTTURA. Display e BLE off. SOLO per posizioni strategiche con vista 360°. ⚠️ Il ruolo PIÙ ABUSATO!
🔴 REPEATER	SEMPRE	Alta	✅	❌	❌	Relay invisibile. Zero telemetria, zero posizione. "Metti e dimentica" per solare remoto.

* Solo se nessun altro nodo l'ha già fatto | ** Aspetta nella "finestra tardiva" | Loc. = Solo messaggi locali | Sveg. = Solo quando sveglio

📡 Canali del Network Italia

8 canali configurati. I canali 1-6 usano la stessa PSK crittografata del network. Il Ch0 è pubblico mondiale, il Ch7 è un canale italiano leggero.

Ch#	Nome	PSK	Uplink	Downlink	Uso
0	MediumFast	AQ== (pubblico)	✅	❌	PRIMARY — Canale mondiale pubblico
1	Ita-Nord	🔒 PSK Network	✅	✅	Piemonte, Lombardia, Veneto, Friuli, E.Romagna, Liguria, Trentino
2	Ita-Centro	🔒 PSK Network	✅	✅	Toscana, Lazio, Umbria, Marche, Abruzzo, Sardegna
3	Ita-Sud	🔒 PSK Network	✅	✅	Campania, Puglia, Calabria, Sicilia, Basilicata, Molise
4	Ita-Help	🔒 PSK Network	✅	✅	Assistenza tecnica, domande configurazione
5	Ita-Test	🔒 PSK Network	✅	✅	Test portata, sperimentazione, range test
6	Ita-Shop	🔒 PSK Network	✅	✅	Compravendita hardware, scambio componenti
7	Italia	mQ== (semplice)	✅	✅	Canale nazionale leggero

🌐 MQTT — Il Ponte tra LoRa e Internet

MQTT permette ai nodi connessi a internet (via WiFi) di fare da "ponte" tra la rete LoRa locale e il mondo.

📤 Uplink (LoRa → Internet)

Il nodo riceve un messaggio via radio e lo pubblica su MQTT. Così appare sulle mappe globali e raggiunge nodi in altre città.

📥 Downlink (Internet → LoRa)

Il nodo riceve messaggi da internet via MQTT e li trasmette sulla radio LoRa. Permette a nodi lontani di comunicare.

Server: mqtt.meshtastic.org | Root: msh/EU_868/IT | Crittografia: AES-256

📶 Capire il Segnale — SNR, RSSI e Hops

Metrica	Cos'è	Buono	Scarso	Note
SNR	Signal to Noise Ratio (dB)	> 5 dB	< -10 dB	LoRa funziona anche con SNR negativo!
RSSI	Received Signal Strength (dBm)	> -100 dBm	< -130 dBm	Più vicino a 0 = più forte
Hops	Quanti nodi ha attraversato	0-2	5-7	0 = diretto, 7 = max consentito
Channel Util	% del canale occupata	< 15%	> 40%	>50% = rete congestionata
Airtime TX	% tempo in trasmissione	< 2%	> 5%	Duty cycle EU = max 10%

📡 Guida Antenna — Il Parametro Più Importante!

L'antenna fa PIÙ differenza di qualsiasi impostazione software. Una buona antenna può triplicare la portata.

⚠️ MAI accendere il dispositivo SENZA antenna collegata! Può bruciare il chip LoRa!

Tipo Antenna	Guadagno	Pattern	Uso ideale
Stub inclusa (quella corta)	~1 dBi	Omnidirezionale	Solo per test rapidi — buttala via appena puoi
Whip λ/4 (8.6 cm)	~2 dBi	Omnidirezionale	Portatile, zaino, bici
Collineare 1/2 wave	~3-5 dBi	Orizzontale	Nodi fissi su tetti, pali
Yagi direzionale	~8-12 dBi	Direzionale	Link punto-punto tra montagne

💡 Regola d'oro: ogni +3 dBi di guadagno antenna RADDOPPIA la portata!

🔧 Problemi Comuni e Soluzioni

Problema	Causa probabile	Soluzione
Il nodo non si collega al PC	Driver USB mancante o cavo solo ricarica	Installa CP210x/CH340. Usa cavo USB DATI.
Non vedo nessun nodo	Regione/preset sbagliati	Verifica EU_868 e MediumFast
I messaggi non arrivano	PSK diverso o canale diverso	Usa l'URL autoconfigurazione
Il nodo si disconnette	Sospensione USB del PC	Disabilita risparmio energia USB
Batteria si scarica veloce	WiFi abilitato, display sempre acceso	Disabilita WiFi, schermo a 30s
Portata scarsa	Antenna cattiva o posizione bassa	Antenna esterna, posiziona il nodo in alto
Rete congestionata	Troppi ROUTER o hop_limit alto	Riduci ROUTER, usa CLIENT_MUTE/ROUTER_LATE
"Hop gobbling"	ROUTER in posizione bassa	Cambia a CLIENT_BASE o ROUTER_LATE

🔋 Calcolatori Integrati

🔋 Autonomia Batteria

⚡ Convertitore RF

📡 Lunghezza Antenna λ/4

🔧 Hardware Consigliato per Iniziare

Dispositivo	Prezzo ~	GPS	Display	Per chi è
Heltec V3	~25€	❌	OLED 0.96"	Principianti, nodi fissi, il più diffuso
Heltec V4	~35€	Opz.	OLED	27 dBm nativo, ESP32-S3, porta solare + GPS opzionale
T-Beam V1.1/S3	~35-50€	✅	Opz.	GPS integrato, batteria 18650, perfetto per mobile
T-Deck	~55€	❌	IPS 2.8"	Tastiera QWERTY integrata — chatti senza telefono
RAK WisBlock	~40€	Opz.	Opz.	Modulare, professionale, nRF52840
SenseCAP Solar	~55€	❌	❌	Pannello solare integrato, per nodi outdoor autonomi

🤖 Assistente Configurazione

Non sai quali parametri usare? Rispondi a poche domande e ti consiglio la configurazione perfetta per il tuo caso.

🧙♂️

Configuratore Guidato

5 domande rapide per trovare il ruolo, le impostazioni e i consigli migliori per il tuo nodo Meshtastic.

📋 Guida Rapida: Quale Ruolo Scegliere?

Scenario	Ruolo Consigliato
Sono nuovo, voglio chattare	🟢 CLIENT
Ho un nodo sul tetto + portatili dentro casa	🟡 CLIENT_BASE (tetto) + CLIENT_MUTE (interni)
Ho 3+ nodi, quale come principale?	1x CLIENT o CLIENT_BASE, gli altri CLIENT_MUTE
Ripetitore sulla montagna del paese	🔴 ROUTER (solo se vista 360°!)
Tetto in città che copre zona morta	🟡 ROUTER_LATE
Ripetitore solare remoto "metti e dimentica"	🔴 REPEATER (invisibile)
Tracciare bici/auto/zaino	🔵 TRACKER
Stazione meteo con sensore BME280	🔵 SENSOR
Non voglio apparire sulla mappa	🟢 CLIENT_HIDDEN
Zona densa con molti nodi vicini	🟢 CLIENT_MUTE

🔍 Interroga il Nodo

Terminale integrato per comunicare con il tuo dispositivo Meshtastic.

📡 Stato CLI Meshtastic

Verifico installazione CLI...

💻 Terminale Meshtastic

Comandi rapidi (click per eseguire):

📡 Meshtastic Italia Network — Terminale v1.2.0 Collega il dispositivo via USB e clicca un comando rapido, oppure scrivi un comando meshtastic nel campo qui sotto. Esempio: --info, --nodes, --get all, --set lora.region EU_868 ────────────────────────────────────────────

meshtastic

🔍 Analisi Configurazione

Esegui --info nel terminale sopra, poi clicca per analizzare i parametri e ricevere consigli personalizzati.

🛰️ Monitor — Scanner Real-Time Rete Mesh

Analizza in tempo reale tutti i pacchetti che il tuo nodo LoRa riceve: radio, MQTT, messaggi, metadati, payload criptati e classifiche dei nodi più attivi.

🔌 Porta USB dispositivo

⏸️ Inattivo

🔬 Modalità visualizzazione: Verbose (espandi tutto) ℹ️ Auto-espandi NODEINFO/TELEMETRY ℹ️ Terminale RAW Dump ℹ️ Rileva ritrasmissioni (↻ dup) ℹ️ Duplicati: 0

📡 RADIO LoRa ℹ️ 0 pkt

☁️ MQTT Internet ℹ️ 0 pkt

💬 Messaggi Canali ℹ️ 0 msg

🐛 RAW Dump ℹ️ 0 pkt

🛰️ Hub Nodi — Scanner Rete Mesh

Esplora i nodi rilevati con metadati completi (firmware, regione, preset, licenza HAM, chiavi pubbliche). Clicca un nodo per aprire la scheda dettagli con 8 pannelli.

🌐 Rete: 📟 Firmware: ⏱️ Finestra:

🆔 Nodo	👤 Nome	💻 HW	🧬 FW	🌍 Rgn	📡 Preset	🎭 Ruolo	🌐 Rete	📶 RSSI	📊 SNR	📏 hop	1h	24h	Tot	🏷️ Flag	⏱️ Visto
Caricamento...

📡 Canali del nodo (8 slot LR)

Gli 8 slot canale configurati nel nodo USB collegato. Sincronizzando, importi automaticamente le PSK e mappi channel_hash → nome canale per arricchire il terminale.

Legge gli 8 slot dal nodo USB, salva la mappa hash8→nome e upserta le PSK (richiede Monitor attivo).

Slot	Nome	Short	Ruolo	Hash8	PSK
Nessun canale mappato. Premi "Sync canali dal nodo" per popolare.

🔑 PKI Pubkey Harvester

Ogni pacchetto Meshtastic con chiave pubblica X25519 viene catalogato automaticamente. La tabella raccoglie (nodo ↔ chiave) con primo/ultimo avvistamento e conteggio, utile per decrypt DM e rilevare rotazioni chiave.

Nodi unici

Chiavi uniche

Record totali

Avvia il Monitor: le chiavi vengono raccolte automaticamente dai pacchetti in transito.

Nodo	Chiave pubblica (X25519)	#	Ultimo	Sorg.
Nessuna chiave pubblica ancora raccolta. Avvia il Monitor.

🔐 Chiavi PSK — Pubbliche & Private

Le chiavi precondivise (PSK) Meshtastic permettono di decifrare pacchetti cifrati. Le pubbliche sono note e precaricate; le private le aggiungi tu per i canali cui sei stato invitato.

Legge i canali del nodo USB collegato e importa automaticamente le PSK (richiede Monitor attivo). Carica il catalogo completo delle reti italiane (36 canali, 9 chiavi uniche) così tutti i messaggi regionali escono decifrati anche senza configurarli manualmente.

Etichetta

Chiave (base64 o hex)

Tipo

Canale (opzionale)

Etichetta	Tipo	Canale	Chiave	Match	Pkt canale	Ultimo match	Azioni
Caricamento...

🎯 Crypto Hunter — Brute Force

Ruota TUTTE le PSK abilitate del catalogo sul buffer RAM e sui pacchetti cifrati del DB (ultimi N giorni). Ogni pacchetto viene testato con ogni chiave finché una decripta. Ritorna statistiche per-PSK e sample dei risultati.

🔑 PSK catalogo—

📦 Buffer RAM—

🔍 Scansionati—

🔓 Decrittati—

📅 Finestra (giorni)

🔢 Max pacchetti

Suggerimento: aggiungi nuove PSK al catalogo via la card PSK Manager sopra. Il Hunter le ruota automaticamente al prossimo run. Il firmware Meshtastic accetta PSK base64 (es. AQ==), hex, o valori simple-byte 1-10. Richiede PRO.

🔓 Crypto Agent — Decrittore universale

Prova TUTTE le chiavi PSK del DB + PKI (X25519 + AES-CCM) configurate e decodifica integralmente i pacchetti in chiaro: include parser per tutti i 23 portnum Meshtastic (ADMIN_APP, ATAK_PLUGIN, TELEMETRY, POSITION, NEIGHBORINFO, TRACEROUTE, MAP_REPORT, WAYPOINT, ecc.).

🔐 Encrypted hex

🔑 PKI list (JSON, opzionale)

📦 packet_id (dec)

🛰️ from_node (dec)

🎯 portnum hint

Suggerimento: i bottoni 🔓 sui pacchetti nel Monitor (RF/MQTT/Text) chiamano automaticamente questo agente con i dati precompilati.

🧰 H4.3 — Crypto Tool-Suite

Suite crypto completa: PKI keystore (import USB + auto-discovery), Path Tracer (ricostruzione percorso pacchetto), MQTT Bridge (broker esterno). 16 endpoint REST unificati.

🔐 PKI—

🔑 PSK—

📦 Buffer—

☁️ MQTT—

🔐 PKI Keystore (T1-T2-T4)

Gestisci chiavi X25519 per decrypt DM PKI (priv × pub peer). Importa da USB o auto-discovery dai nodi conosciuti.

🗺️ Path Tracer (T5)

Ricostruisce il percorso di un pacchetto attraverso la rete mesh: departure → transit → arrival, con gateway e stato decrypt.

📦 packet_id (dec)

Solo cifrati

☁️ MQTT Bridge (T6)

Connetti un broker MQTT esterno (es. mqtt.meshtastic.org) per ingerire pacchetti globali nella pipeline monitor.

🌐 Broker host

🔢 Port

📡 Topic (virgola-separato)

💡 Più topic separati da virgola. Auto-wildcard /# se manca. Es: msh/EU_868/IT → msh/EU_868/IT/#

👤 Username

🔒 Password

TLS (port 8883)

🎛️ H4.4 — Admin Control Suite

30 comandi AdminMessage per gestione nodo: power, owner, config, channels, nodedb, position, canned, advanced. PRO required.

◌ Pronto: ?

🎛️ Comandi: —

⚠️ Distruttivi: —

📦 Famiglie: —

🔌 Interfaccia: —

📦 Famiglia

⚙️ Comando

📋 Output:

📶 F4 — Soglie alert + Standard FW

Regola le soglie degli alert (spam, flood, segnale debole) o applica un preset standard del firmware LoRa. PRO required.

◌ Preset: ?

📦 Applica un preset FW standard (sostituisce tutte le soglie):

⚙️ Preset

🎚 Oppure modifica singole soglie:

🔧 Ottimizza nodo per Monitor

Regola i parametri del nodo USB per massimizzare i pacchetti rilevabili (TX power, MQTT, broadcast). Prima mostra un'anteprima, poi richiede conferma esplicita. Nessun factory-reset, nessun comando shell.

🔬 Analyst — Insight ultima ora

Classifica per Finestra Top N Auto

Analisi automatica ogni 60s su finestra 1h: top nodi, sospetti spam, gateway MQTT, canali caldi e silenti.

Caricamento insight...

📡 Config rete Mesh Italia

Confronto tra la config attuale del nodo collegato e quella attesa dalla rete MIN / Mesh Italia (EU_868 MediumFast).

Premi Aggiorna per leggere la config del nodo.

🛡️ Attiva Monitor Mode

Prende possesso del nodo USB collegato e lo configura per massimizzare l'estrazione di metadati dalla rete.

Profilo firmware

🔁 Manutenzione automatica (opt-in)

Riavvio automatico ogni 6h Reset NodeDB ogni 7 giorni

🗺️ Nodi con GPS

Auto 30s

Elenco dei nodi che hanno inviato pacchetti GPS (POSITION / WAYPOINT / MAP_REPORT). Clicca 🌍 per aprire la posizione in Google Maps.

Nessun nodo GPS ancora.

📊 Statistiche 7 giorni

Memoria rotante: tutti i pacchetti vengono conservati per 7 giorni (configurabile 1–30) e poi cancellati automaticamente. Usa i filtri per esplorare le classifiche.

⏱️ Finestra

🌐 Network

🧬 Firmware

🛰️ Top nodi per traffico

Nessun dato

📻 Top canali

Nessun dato

🔌 Top tipo pacchetto

Nessun dato

🌐 Distribuzione network

Nessun dato

🧬 Distribuzione firmware

Nessun dato

📶 Miglior segnale (RSSI/SNR)

Nessun dato

✨ Nuovi nodi

Nessun dato

😴 Nodi silenti (>24h)

Nessun dato

🗜️ Nodi con compressione

Nessun dato

🔥 Heatmap oraria (7×24)

⚙️ Impostazioni Monitor

Privacy, retention dati e pulizia. Tutte le impostazioni vengono salvate localmente.

📅 Giorni di memoria (1–30)

💬 Salva testo messaggi

🔐 Salva payload crittato (hex)

🌐 Arricchimento online nodi

Caricamento info DB…

🔗 Link & Community

Tutti i link del Meshtastic Italia Network.

🛠️ Setup Ambiente & Ottimizzazione Sistema

Installazione dettagliata, ambiente sviluppo, e comandi potenti per ottimizzare il tuo PC.

🐍 STEP 1 — Installa Python

Python è il linguaggio con cui è costruita questa app. Serve la versione 3.13 o 3.14.

Download: python.org/downloads

🪟 Windows

⚠️ Durante l'installazione spunta SEMPRE: "Add Python to PATH" e "Install launcher for all users"

winget install Python.Python.3.14

Oppure scarica manualmente da python.org/downloads/windows/

python --version

pip --version

🍎 macOS

Installa prima Homebrew (gestore pacchetti Mac):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install python

python3 --version && pip3 --version

🐧 Linux (Ubuntu/Debian)

sudo apt update && sudo apt install python3 python3-pip python3-venv python3-dev build-essential git curl -y

python3 --version && pip3 --version

⚠️ Permessi USB (OBBLIGATORIO per parlare con il nodo via USB):

sudo usermod -a -G dialout $USER

Dopo questo comando fai LOGOUT e rientra!

📡 STEP 2 — Installa Meshtastic CLI + Dipendenze App

Il CLI è lo strumento per comunicare con il nodo via USB/BLE/WiFi.

pip install --upgrade meshtastic

Con supporto QR code e funzioni extra:

pip install --upgrade "meshtastic[cli]"

meshtastic --version

Dipendenze di questa app:

pip install flask flask-cors flask-socketio pyserial protobuf pyyaml tabulate requests "qrcode[pil]" Pillow psutil platformdirs eventlet pypubsub

📦 STEP 3 — Ambiente Virtuale (consigliato)

Un contenitore isolato per le librerie del progetto — evita conflitti con altri programmi Python.

python -m venv meshenv

Attivare l'ambiente:

🪟 Windows:

meshenv\Scripts\activate

🍎🐧 macOS/Linux:

source meshenv/bin/activate

Dopo l'attivazione vedrai (meshenv) all'inizio del terminale. Per disattivare: deactivate

📚 Come Funziona l'App (per chi impara)

🐍 Python (server.py) → Il cervello: avvia server web su localhost:5555
🌐 HTML (index.html) → Lo scheletro: struttura della pagina
🎨 CSS (style.css) → Il vestito: colori, font, animazioni
⚡ JavaScript (app.js) → Il muscolo: click, API, interattività
🌶️ Flask → Framework web Python (crea le API REST)
📦 pip → "App store" per librerie Python
🏠 localhost → Il tuo stesso PC. Nessun dato esce su internet
📟 COM/ttyUSB → Porta seriale USB per parlare col nodo

ℹ️ Info Sistema Attuale

Rilevamento Python...

🔧 Ottimizzazione Sistema Operativo

Comandi potenti per pulire, ottimizzare e riparare il tuo PC. Seleziona il tuo sistema:

⚠️ Apri PowerShell come AMMINISTRATORE

Click destro su Start → "Terminale (Amministratore)" oppure cerca "PowerShell" → Esegui come Admin

🧹 Pulizia File Temporanei e Cache

Elimina file spazzatura, cache, log vecchi e libera spazio disco.

Remove-Item -Path "$env:TEMP\*" -Recurse -Force -ErrorAction SilentlyContinue

Svuota la cartella TEMP dell'utente (file temporanei app, installer)

Remove-Item -Path "C:\Windows\Temp\*" -Recurse -Force -ErrorAction SilentlyContinue

Svuota la cartella TEMP di sistema

Remove-Item -Path "$env:LOCALAPPDATA\Temp\*" -Recurse -Force -ErrorAction SilentlyContinue

Svuota cache locale utente

cleanmgr /d C /VERYLOWDISK

Pulizia disco Windows automatica (modalità aggressiva)

Clear-RecycleBin -Force -ErrorAction SilentlyContinue

Svuota il cestino

pip cache purge

Svuota cache pip Python

🌐 DNS — Ottimizzazione e Pulizia

Ripulisci la cache DNS e imposta i DNS più veloci.

ipconfig /flushdns

Svuota la cache DNS — risolve problemi di navigazione lenta o siti irraggiungibili

netsh interface ip set dns "Wi-Fi" static 1.1.1.1 primary

Imposta Cloudflare DNS primario (1.1.1.1) — tra i più veloci al mondo

netsh interface ip add dns "Wi-Fi" 8.8.8.8 index=2

Imposta Google DNS secondario (8.8.8.8) — fallback affidabile

nslookup meshtasticitalia.it

Testa la risoluzione DNS

💿 Disco — Ottimizzazione e Controllo

chkdsk C: /F /R /X

Controlla e ripara errori del disco, settori danneggiati (/R), forza smontaggio (/X). Richiede riavvio.

Optimize-Volume -DriveLetter C -Defrag -Verbose

Deframmenta disco C: (solo per HDD — su SSD usa -ReTrim)

Optimize-Volume -DriveLetter C -ReTrim -Verbose

TRIM per SSD — libera blocchi non usati, mantiene la velocità

Get-Volume | Format-Table -AutoSize

Mostra tutti i volumi con spazio libero

🛡️ Sicurezza — Scansione Malware e Virus

Start-MpScan -ScanType QuickScan

Scansione rapida Windows Defender — controlla le aree più comuni

Start-MpScan -ScanType FullScan

Scansione COMPLETA — controlla OGNI file sul disco (richiede tempo)

Update-MpSignature

Aggiorna le definizioni antivirus all'ultimo database

Get-MpThreatDetection | Select-Object -First 10

Mostra le ultime 10 minacce rilevate

🔧 Riparazione Sistema e File Corrotti

sfc /scannow

System File Checker — scansiona e ripara file di sistema corrotti

DISM /Online /Cleanup-Image /RestoreHealth

DISM — ripara l'immagine di Windows (usare se sfc trova errori non riparabili)

DISM /Online /Cleanup-Image /StartComponentCleanup /ResetBase

Pulisce vecchie versioni di componenti Windows — libera GB di spazio

⚡ Prestazioni e USB per Meshtastic

powercfg /setactive 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c

Attiva piano "Prestazioni elevate" — impedisce sleep durante flash/config

powercfg /SETACVALUEINDEX SCHEME_CURRENT 2a737441-1930-4402-8d77-b2bebba308a3 48e6b7a6-50f5-4782-a5d4-53bb8f07e226 0

Disabilita sospensione USB — impedisce disconnessioni del nodo

powercfg /SETACTIVE SCHEME_CURRENT

Applica le modifiche

Get-PnpDevice -Class Ports -Status OK

Verifica porte seriali USB attive (CP210x, CH340)

netstat -an | findstr "5555"

Verifica che la porta 5555 dell'app sia libera

🔄 Rete — Ripristino Completo

netsh winsock reset

Reset Winsock — ripara problemi di rete/connessione

netsh int ip reset

Reset stack TCP/IP

ipconfig /release && ipconfig /renew

Rilascia e rinnova indirizzo IP (risolve conflitti DHCP)

Apri: Applicazioni → Utility → Terminale

🧹 Pulizia File Temporanei e Cache

sudo rm -rf /private/var/folders/*

Pulisce cache temporanee di sistema (si ricreano automaticamente)

rm -rf ~/Library/Caches/*

Pulisce cache utente (browser, app, Xcode)

sudo rm -rf /Library/Caches/*

Pulisce cache di sistema globale

rm -rf ~/Library/Logs/*

Elimina vecchi log utente

pip3 cache purge && brew cleanup --prune=all

Pulisce cache pip + vecchie versioni Homebrew

df -h

Mostra spazio disco disponibile

🌐 DNS — Ottimizzazione e Pulizia

sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder

Svuota cache DNS macOS — risolve DNS lento o errato

networksetup -setdnsservers Wi-Fi 1.1.1.1 8.8.8.8

Imposta Cloudflare + Google DNS (i più veloci)

networksetup -getdnsservers Wi-Fi

Verifica DNS impostati

💿 Disco — Verifica e Riparazione

diskutil verifyVolume /

Verifica integrità del volume principale

sudo fsck -fy

File System Check — ripara errori (meglio da Recovery Mode)

tmutil listlocalsnapshotdates / | head -5

Lista snapshot Time Machine locali (occupano spazio)

sudo tmutil thinlocalsnapshots / 10000000000 4

Elimina vecchi snapshot TM per liberare spazio (~10GB)

🛡️ Sicurezza — Scansione e Verifica

sudo /usr/libexec/xprotect version

Verifica versione XProtect (antimalware integrato Apple)

spctl --status

Verifica stato Gatekeeper (blocca app non firmate)

sudo find / -name "*.dmg" -mtime +30 -delete 2>/dev/null

Elimina file .dmg scaricati più di 30 giorni fa

⚡ Prestazioni e USB per Meshtastic

caffeinate -d -i -s &

Impedisce al Mac di andare in sleep (kill %1 per fermarlo)

ls /dev/cu.usb*

Lista porte USB seriali (cerca cu.usbserial o cu.wchusbserial)

system_profiler SPUSBDataType

Info completa tutti i dispositivi USB collegati

lsof -i :5555

Verifica porta 5555 libera

sudo purge

Libera RAM inattiva (memoria compressa/cache)

🔧 Riparazione Sistema

sudo periodic daily weekly monthly

Esegue tutti gli script di manutenzione macOS (log rotation, pulizie)

sudo mdutil -E /

Ricostruisce indice Spotlight (risolve ricerche lente/corrotte)

Apri il Terminale: Ctrl+Alt+T

🧹 Pulizia File Temporanei e Cache

sudo apt autoremove -y && sudo apt autoclean && sudo apt clean

Rimuove pacchetti orfani, pulisce cache APT e pacchetti scaricati

sudo rm -rf /tmp/* /var/tmp/*

Svuota cartelle temporanee

sudo journalctl --vacuum-time=7d

Elimina log di sistema più vecchi di 7 giorni (può liberare GB)

sudo journalctl --vacuum-size=100M

Limita i log di sistema a 100MB massimo

rm -rf ~/.cache/*

Pulisce cache utente (thumbnail, browser, app)

pip3 cache purge

Svuota cache pip Python

df -h && free -h

Spazio disco e RAM disponibili

🌐 DNS — Ottimizzazione e Pulizia

sudo systemd-resolve --flush-caches

Svuota cache DNS systemd-resolved

echo -e "nameserver 1.1.1.1\nnameserver 8.8.8.8" | sudo tee /etc/resolv.conf

Imposta Cloudflare + Google DNS (temporaneo, si resetta al riavvio)

resolvectl status | grep "DNS Server"

Verifica DNS server in uso

💿 Disco — Controllo e Riparazione

sudo fsck -f /dev/sda1

File System Check — verifica e ripara il disco (da eseguire su partizione smontata o in recovery)

sudo e2fsck -f /dev/sda1

Verifica ext4 filesystem (specifica per Linux)

sudo fstrim -av

TRIM per SSD — libera blocchi, mantiene velocità

sudo smartctl -a /dev/sda

Info SMART del disco — salute, temperatura, errori (installa: sudo apt install smartmontools)

du -sh /var/log/* 2>/dev/null | sort -rh | head -10

Trova i 10 log più grandi

🛡️ Sicurezza — Scansione e Verifica

sudo apt install clamav clamav-daemon -y && sudo freshclam

Installa ClamAV antivirus e aggiorna database

clamscan -r --bell -i /home

Scansione antivirus della cartella home (-r ricorsivo, -i solo infetti)

sudo apt install rkhunter -y && sudo rkhunter --check --skip-keypress

Scansione rootkit — cerca software malevolo nascosto nel sistema

sudo debsums --changed

Verifica integrità dei pacchetti installati (trova file corrotti/modificati)

⚡ Prestazioni e USB per Meshtastic

sudo usermod -a -G dialout $USER && groups $USER

Aggiunge utente al gruppo seriale USB (OBBLIGATORIO, poi logout/login)

ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null

Lista porte USB seriali

Ultimi messaggi kernel su USB — diagnostica problemi connessione

echo 'on' | sudo tee /sys/bus/usb/devices/*/power/control

Disabilita risparmio energia USB (impedisce disconnessioni)

ss -tlnp | grep 5555

Verifica porta 5555 libera

sudo sysctl -w vm.swappiness=10

Riduce uso dello swap — priorità alla RAM (velocizza il sistema)

🔧 Riparazione Sistema

sudo apt install --fix-broken -y

Ripara pacchetti rotti o installazioni interrotte

sudo dpkg --configure -a

Completa configurazioni dpkg interrotte

sudo update-grub

Rigenera configurazione bootloader GRUB

🖥️ Terminale Sistema — Comandi Copiati

Clicca ▶ su un comando sopra: verrà copiato negli appunti e mostrato qui. Incollalo nel tuo terminale reale (PowerShell/Terminal).

🖥️ Terminale Sistema — I comandi copiati appariranno qui Clicca ▶ su un comando, poi incollalo nel tuo PowerShell/Terminal/Terminale ────────────────────────────────────────────

🔐 Attivazione App v1.2.0

📖 Guida Iniziale

🛒 Hardware Supportato (25 dispositivi)

🔌 Driver USB

⚡ Flash Firmware

⚙️ Configurazione

📻 Canali (8 slot) ℹ️

👤 Identità

📻 Radio LoRa

📍 Posizione & GPS

📍 Posizione Fissa Abilita ℹ️

🌐 MQTT (Bridge Internet)

📶 Connettività

📊 Telemetria

🔋 Energia & Hardware

📦 Moduli

📻 Canali (8 slot) ℹ️

🔬 Parametri Avanzati — Solo Esperti Mostra

📻 LoRa Avanzato

🔵 Bluetooth Avanzato

🌐 MQTT Avanzato

🖥️ Display Avanzato

📍 GPS Avanzato

📊 Telemetria Avanzata

🔋 Power Management Avanzato

🔐 Sicurezza Avanzata

📡 Device Avanzato

🔧 MOD Firmware — Zona Pericolo Mostra

📖 GUIDA MOD FIRMWARE COMPLETA — Clicca per aprire

📡 TX Power Override — Modifica Potenza

🔓 Sblocca Limiti Firmware

📊 Device Dump — Leggi Tutto dal Nodo

🆔 Modifica Identità Nodo

💾 Backup / Restore / Clone Config

🔩 Raw Config — Qualsiasi Parametro

⚡ Flash & Memory — esptool (solo ESP32)

🧙 Wizard MOD — Cosa vuoi modificare?

💻 Comandi CLI Meshtastic

📡 Guida Tecnica Completa

📤 Uplink (LoRa → Internet)

📥 Downlink (Internet → LoRa)

🔋 Autonomia Batteria

⚡ Convertitore RF

📡 Lunghezza Antenna λ/4

🤖 Assistente Configurazione

Configuratore Guidato

🔍 Interroga il Nodo

🛰️ Monitor — Scanner Real-Time Rete Mesh

⭐ Funzione PRO

🛰️ Hub Nodi — Scanner Rete Mesh

🛰️ Nodo

📡 Canali del nodo (8 slot LR)

🔑 PKI Pubkey Harvester

🔐 Chiavi PSK — Pubbliche & Private

🎯 Crypto Hunter — Brute Force

🏆 Breakdown per-PSK (chi ha decrittato quanto)

📊 Motivi fallimento decrittazione

📜 Sample decrittati (max 50)

🔓 Crypto Agent — Decrittore universale

🧰 H4.3 — Crypto Tool-Suite

🎛️ H4.4 — Admin Control Suite

📶 F4 — Soglie alert + Standard FW

👤 Scheda Tecnica Nodo

🔍 Dettagli Pacchetto

🔧 Ottimizza nodo per Monitor

🔬 Analyst — Insight ultima ora

📡 Config rete Mesh Italia

🛡️ Attiva Monitor Mode

🔁 Manutenzione automatica (opt-in)

🗺️ Nodi con GPS

📊 Statistiche 7 giorni

⚙️ Impostazioni Monitor

🔗 Link & Community

👥 Community

🗺️ Mappe

📱 App & Strumenti

🛒 Hardware

🛠️ Setup Ambiente & Ottimizzazione Sistema

🪟 Windows

🍎 macOS

📻 Canali (8 slot)

📍 Posizione Fissa Abilita

📻 Canali (8 slot)