Hermes: Meshtastic
Commander

Dov'è configurato MQTT, e un'eccezione al rifiuto del ponte (v1.12.0). Un tracker che pubblica su MQTT arriva già come device_tracker dall'integrazione MQTT di Home Assistant, che ha indirizzo, password, TLS e riconnessione, e Hermes lo legge da lì: non c'era un campo per il broker perché non deve esserci, ma nessuno lo diceva, e qualcuno lo ha cercato. La mesh bridgata via MQTT si può rifiutare, e si chiedeva di fidarsi del proprio broker e non di quello pubblico: non si può, il pacchetto porta un booleano viaMqtt e nessun topic. Si controlla il mittente invece della strada: un messaggio cifrato per questo solo gateway è sigillato con la chiave del nodo che lo manda, e nessun relay può produrne uno. L'eccezione vale solo per quelli, e la conferma si chiede accendendola, perché è la prima guardia che allenta invece di stringere. Il campo di scrittura sta sopra i messaggi, dal più recente (v1.11).

Meteo, sentieri e qualunque tracker sulla mappa (v1.9 e v1.10). Tre livelli sopra la base: i sentieri di Waymarked Trails (le relazioni di OpenStreetMap, col colore e il segnavia di ogni rete), il radar pioggia di RainViewer portato da Chronos, e i livelli OpenWeather, che restano in grigio col motivo se manca la chiave; i primi due non ne vogliono, ed è per questo che stanno davanti. La mappa disegna anche qualsiasi device_tracker di Home Assistant, come quadrati viola: un telefono OwnTracks, un Teltonika via Traccar, un tag LoRaWAN, un inReach. Ognuno ha già un'integrazione che sa parlargli, e un client MQTT dentro Hermes l'avrebbe duplicata. Sotto la mappa un tasto chiede a Overpass quali sentieri segnati passano vicino al punto: un pin su un crinale diventa "sulla GTA, Piamprato-Ronco Canavese", una frase che si legge alla radio. Client educato, con cache di un'ora e timeout corto, perché Overpass gira su capacità donata. Voce nella barra laterale a richiesta, spenta di default.

Sorvegliare chi cammina con un nodo addosso, senza gridare al lupo (v1.7 e v1.8). Un pacchetto Home Assistant in docs/hiking: modalità escursione, distanze dalla partenza e da casa, minuti dall'ultimo contatto e sei allarmi, scritti in YAML e non in Python, perché le soglie vanno lette e regolate con uno slider la mattina della gita. L'uomo morto ha due stadi e il primo non sveglia nessuno: il nodo vibra e chiede, chi si è fermato apposta risponde ok e finisce lì; solo il silenzio scala. Fermo e fuori contatto sono due allarmi diversi, con parole diverse, e niente si disarma da solo. Spegnere la modalità archivia la camminata nello store di Hermes, perché il recorder cancella dopo dieci giorni e "com'è andata quella di giugno" è una domanda di settembre.

Statistiche, limite del registro e messaggi che non spariscono più in silenzio (v1.5 e v1.6). Un ramo dell'ingresso contava il messaggio senza scriverlo da nessuna parte: un contatore che sale sopra un registro vuoto sembra una radio morta. Il registro era tagliato a 200 righe e sul canale pubblico erano ore: ora il limite è un'impostazione, la scheda Log dice quante righe tiene su quante, e quando è piena lo dice e indica dove si cambia. Una scheda Statistiche calcolata da quello che la card già tiene, senza chiamate nuove e quindi senza niente che possa andare fuori passo; i colori degli anelli sono verificati per il daltonismo e ogni anello porta la legenda con i numeri. Il pannello dice a chi appartiene un nodo.

Mappa di base su Esri, via da CARTO (v1.4.0). Da settembre 2026 CARTO stampa API KEY REQUIRED in diagonale dentro ogni tile servito senza chiave, e il testo è dentro l'immagine: nessuna impostazione da questa parte poteva toglierlo, e la mappa era illeggibile. Il nuovo fondo è il gray canvas di Esri, senza chiave, chiaro e scuro secondo il tema, con i pin dei nodi che si riprendono il colore. Nel selettore restano CARTO per chi ha una chiave, OpenTopoMap che mostra il rilievo (e su una mappa mesh non è decorazione: un crinale fra due nodi è di solito tutta la spiegazione del perché non si sentono) e un modello XYZ personale. Si può anche ingrandire più di prima: le tile di Esri si fermano a 16, e invece di bloccare lì tutta la mappa l'ultima disponibile viene scalata fino a 18, così due nodi a pochi metri restano distinguibili.

Sensori diagnostici letti per l'id reale (v1.3.2): la scheda Status non mostrava mai il contatore dei comandi eseguiti né l'ultimo comando, e non era un problema di refresh, quei valori non venivano proprio letti. La card cercava un entity id che finiva in "last_command", ma Home Assistant costruisce l'id dal nome tradotto dell'entità (in inglese sensor.gateway_last_command_received, diverso ancora su un'istanza italiana), quindi la ricerca non trovava nulla. Ora il backend li risolve dal registro e li comunica alla card. Aggiunto anche il pulsante "Nessun gruppo" per togliere un comando da un gruppo, e un lampeggio della riga quando un comando viene spostato (rispetta il movimento ridotto).

Hardening dei messaggi (v1.2): Hermes prima non guardava come un messaggio fosse cifrato, quindi la promessa "un DM con PKC ha un mittente verificato" valeva per il protocollo ma non era imposta (un mittente su firmware vecchio ricade sulla cifratura di canale e la sua identità torna una dichiarazione). Ora, leggendo i metadati del pacchetto, tre interruttori (tutti spenti di default) permettono di accettare solo i messaggi cifrati per questo nodo, rifiutare quelli passati via MQTT e rifiutare quelli troppo vecchi; i pacchetti già gestiti vengono scartati, e i comandi guadagnano una condition entity e un cooldown come difesa dal replay. La scheda Status mostra cosa portavano davvero i messaggi arrivati, così si può verificare prima di attivare le regole.

Comandi ordinabili e raggruppabili (v1.3): l'ordine non è decorativo, perché il matching restituisce il primo comando la cui parola chiave combacia, quindi un "lights kitchen" specifico messo dopo un "lights" generico non sarebbe mai scattato. Ora ogni comando ha le frecce per riordinarlo, e più comandi possono stare sotto un'intestazione di gruppo (i comandi senza gruppo vanno in fondo). Lo switch che richiede PKC ora dichiara il suo costo accanto a sé: attivarlo ferma i comandi da canale, e su un gateway in ascolto su un canale li ferma tutti.

Nomi dei gruppi normalizzati (v1.3.1): un gruppo esiste per il fatto di essere nominato, e prima "Lights" contro "lights" creava due gruppi che sembrano un errore e lo sono. Ora i gruppi già in uso compaiono come bottoni sopra il campo (dopo il primo comando basta un click) e il nome viene salvato in maiuscolo, così esiste una sola grafia. Migliorata anche la leggibilità degli stati (scritti a parole) e chiusa una lista entità che traspariva dove non doveva (v1.1).

Primo rilascio stabile 1.0. Hermes esce dalla fase pre-1.0 come integrazione funzionante e testata, con il motore di split coperto da test.

Hotfix 1.0.1 e 1.0.2 subito dopo il rilascio: corretto un config flow che non si importava (Home Assistant sollevava un errore all'avvio e l'integrazione non si configurava) e fatto sì che la card venga servita anche quando un gateway non carica, così le dashboard non mostrano più un "Configuration error" senza spiegazione. Test eseguiti anche su Python 3.14.

Pannello diviso in card e lettura del database nodi della radio: la card non presume più di possedere tutto lo schermo, e la mappa mostra ogni nodo che la radio ha sentito (con la posizione riportata) invece dei soli nodi importati dall'integrazione base. Aggiunte due card a scopo singolo per dashboard già in uso: Hermes summary (lo stato come lista di parametri che si adatta alla colonna stretta) e Hermes chat (leggere e inviare messaggi), entrambe leggere e senza toccare le impostazioni.

Configurazione della radio dalle Impostazioni con logica read-modify-write: regione, modem preset, hop limit, potenza di trasmissione e ruolo del nodo si scrivono direttamente sul dispositivo, in una sezione dedicata con il suo tasto di salvataggio e un avviso, perché la maggior parte di questi parametri riavvia il nodo e una regione sbagliata lo taglia fuori dalla mesh.

Conversazioni mesh lette e scritte da dentro Hermes: la scheda Chat elenca tutti i canali (non solo quelli su cui si è già parlato) e permette di rispondere direttamente. Nella scheda Log si vede cosa Hermes ha deciso per ogni messaggio, inclusi quelli ignorati.

Installazione da badge My Home Assistant (un click apre HACS con il repository precompilato, un altro avvia il config flow), sensori diagnostici persistenti tra i riavvii, e sezione sicurezza della guida riscritta con la forma consigliata a due istanze.

Prima versione: comandi dalla mesh che eseguono azioni Home Assistant e rispondono, servizi broadcast e send_direct per le notifiche dalle automazioni, motore di split byte-safe, whitelist dei nodi, e una card unica con le schede Status, Chat, Log, Devices, Map, Messages, Home Assistant e Settings.