Indice MeshCom ARTICOLO 11

Usare WebDesk

Una volta installato, WebDesk diventa il tuo "pannello di controllo" della stazione MeshCom. Tutto da browser, senza app. Ti porto attraverso le 6 pagine principali, da come mandare un messaggio a come aggiornare il firmware via OTA.

Accesso a WebDesk

Apri qualunque browser (Firefox, Chrome, Safari, Edge) di un dispositivo collegato alla stessa rete WiFi del nodo, e digita:

http://192.168.x.y

(Sostituisci con l'IP che il router ha assegnato al tuo nodo, o quello che hai fissato come statico). Se hai messo password, ti compare il prompt basic auth: inseriscila. Bookmarka la pagina per accesso veloce.

Suggerimento: sul mio nodo personale ho l'IP 192.168.50.180 e il bookmark del browser punta direttamente lì. Tre tap dal telefono, sono operativo.

Anteprima dell'interfaccia

http://192.168.50.180/ MeshCom WebDesk IZ5KHP-10 · 433.175 MHz · RX +14 / TX +6 · WiFi -52 dBm Msgs MHeard Map Messaggi IK5ZPV-10 09:42 Forte e chiaro da Pistoia, 73! Tu (IZ5KHP-10) 09:43 ✓✓ Test ricevuto, ottimo segnale IZ5KHP-11 09:45 Posizione: lat 43.93 lon 10.93 Scrivi un messaggio... INVIA

Esempio della homepage WebDesk: header con stato nodo, tabs di navigazione, area messaggi e form di invio.

Le 6 pagine principali

1. Messaggi (homepage)

Lista cronologica di tutti i messaggi: in entrata, in uscita, broadcast, diretti. Form in basso per scrivere uno nuovo: scegli destinatario (* per ALL, IK5ZPV-10 per direct), digita il testo (max 160 caratteri), invia. Gli ACK arrivano automaticamente: vedi i ✓✓ verdi.

Il buffer messaggi è di circa 100 elementi; più vecchi vengono ruotati fuori per fare spazio.

2. MHeard (sentiti di recente)

Lista dei nodi (callsign) che il tuo nodo ha "sentito" via radio negli ultimi minuti/ore. Per ognuno vedi:

  • Callsign-SSID e nome libero (se presente)
  • RSSI (forza del segnale) e SNR (rapporto segnale/rumore)
  • Hop count: quanti nodi hanno ripetuto il messaggio prima di arrivare a te
  • Last seen: tempo dall'ultimo pacchetto ricevuto

Cliccando su un callsign si apre la sua "scheda" con storia dei messaggi e posizione (se l'ha trasmessa).

3. Mappa locale

Vista OpenStreetMap centrata sulla tua posizione, con un pin per ogni nodo geolocalizzato nella lista MHEARD. Cliccando un pin vedi callsign, distanza km, RSSI, e ultimo messaggio. Utile per capire chi sta dove e perché c'è/non c'è copertura.

4. Settings (impostazioni)

Stessi parametri configurabili dall'app MeshCom, accessibili da browser. Comodo per:

  • Cambiare nome libero del nodo senza scollegarti
  • Modificare posizione manuale
  • Attivare/disattivare gateway mode da remoto
  • Aggiustare gli intervalli di POS / HEY
  • Toggle dei debug verbose per la diagnosi

Importante: dopo aver modificato, clicca Save in basso. Senza save il nodo non persiste le modifiche al prossimo reboot.

5. Log di sistema

Tail in tempo reale dei messaggi serial della radio: [LoRa], [MC-DBG], [MC-SM], errori, stato canale. È esattamente lo stesso log che vedresti con il monitor seriale USB, ma accessibile dal browser.

Indispensabile per troubleshooting senza dover aprire la scatola e collegare USB. Si può anche scaricare l'intero log a file txt.

6. OTA (aggiornamento firmware)

Carichi via browser il file firmware.bin nuovo, il nodo lo scrive in flash e si riavvia con la versione aggiornata. Nessuno smonta la scatola dal tetto.

Procedura tipica:

  1. Scarichi l'ultima release del firmware dal repo GitHub icssw-org
  2. Vai sulla pagina OTA di WebDesk
  3. Clicca Browse, scegli il file .bin
  4. Clicca Upload, attendi la barra al 100%
  5. Il nodo si riavvia automaticamente

Importante: in caso di OTA fallita (es. interruzione corrente a metà upload), il bootloader safeboot integrato resta in piedi per il rollback. Non rischi di "brickare" il nodo solo perché ti è caduta la linea durante l'upload.

Scenari d'uso quotidiani

📨 Controllo veloce della rete

Apri WebDesk, vai sulla pagina MHEARD. Vedi chi è attivo in 2 secondi. Se vuoi sapere se IK5ZPV è in zona o no, è tutto lì.

🌍 Aggiornamento posizione GPS

Hai spostato l'antenna di 50 m? Apri Settings, aggiorna lat/lon, salva. Il prossimo beacon trasmette la nuova posizione.

🐛 Debug remoto di un problema

Hai sospetto che la radio non riceva? Vai sulla pagina Log, abilita --loradebug on, osservi il flow [MC-SM] e [LoRa] in tempo reale.

📤 Manda un broadcast veloce

"Qualcuno mi sente in zona Pistoia?" → broadcast a "*" da WebDesk → ricevi tutti gli ACK / risposte in pochi secondi.

App MeshCom vs WebDesk: quando uno, quando l'altro

ScenarioMeglio appMeglio WebDesk
Nodo portatile in tasca✅ BLE diretto, sempre con te
Nodo fisso sul tetto + tu in casa✅ accesso da PC/tablet
Notifiche push messaggi in arrivo✅ supporto OS nativo
Configurazione complessa (testo lungo, copia/incolla)✅ tastiera fisica
Aggiornamento firmware (OTA)✅ upload .bin via browser
Debug log in tempo reale✅ pagina Log dedicata
Mostra nodo a un visitatore✅ apri URL nel suo browser

Best practice: tieni entrambi attivi. App per uso quotidiano "in movimento", WebDesk per configurazione, debug e aggiornamenti.

WebDesk: il tuo "shack virtuale"

Una volta che ti abitui a WebDesk, ogni altra interfaccia ti sembra antica. Il nodo è sempre raggiungibile, sempre configurabile, sempre debuggabile. La stazione MeshCom diventa un servizio della tua rete domestica, come la stampante o il NAS.

Home MeshCom