Perché un inventario, e perché con un file di Excel
Una casa con Home Assistant si riempie di dispositivi: luci, prese, telecamere, sensori, elettrodomestici, telefoni. Le domande a cui voglio poter rispondere sono semplici: in quale stanza sta quella presa, quando scade la garanzia dell'aspirapolvere, quel dispositivo sconosciuto comparso in rete è nuovo? Il mio inventario le risolve dentro la dashboard.
Ho scelto di tenere la parte umana, cioè la stanza, la marca, l'acquisto e la garanzia, in un file dispositivi.csv che si apre con Excel. Tutto il resto lo prendo da dove è già scritto. Ogni informazione ha una sola fonte, ed è la regola che regge il progetto.
Le quattro fonti
- Il file dispositivi.csv, compilato a mano: tipo, stanza, piano, marca, modello, collegamento, alimentazione, acquisto, garanzia e note.
- Omada: quali dispositivi Wi-Fi sono in rete adesso, con indirizzo, access point e segnale (la copia dei dati che lo script del Wi-Fi scrive in
logs/omada-status.json). - Il registro syslog del router: i MAC che chiedono un indirizzo (DHCP) o che il router vede sulla rete. È l'unica fonte per i dispositivi via cavo e per quelli sul Wi-Fi del router, che Omada non elenca. Non dà l'indirizzo né il nome: dice solo «è stato visto» (vedi la guida sulla rete).
- Il registro di Home Assistant: nome, area, produttore e modello dei dispositivi collegati. Serve solo a riempire i campi che lascio vuoti nel CSV, abbinati con il MAC.
La chiave che lega tutto è il MAC (la colonna id). I dispositivi senza MAC di rete, come quelli Zigbee o Matter, hanno un identificativo libero e si collegano a Home Assistant con la colonna ha_entita.
Il file dei dispositivi
Le colonne sono quattordici: id, nome, tipo, stanza, piano, marca, modello, collegamento, alimentazione, critico, acquisto, garanzia_fino, ha_entita, note. Sono obbligatori nome, tipo, stanza e collegamento. I valori di tipo, collegamento e alimentazione sono elenchi chiusi.
- tipo: luce, presa, interruttore, telecamera, sensore, serratura, tapparella, termostato, elettrodomestico, assistente vocale, tv, pc, telefono, tablet, stampante, rete, altro.
- collegamento: wifi, ethernet, zigbee, matter, thread, bluetooth, z-wave, altro.
- alimentazione: rete, batteria, usb, poe, altro.
- nome: con lo schema stanza-tipo-numero, minuscolo e senza accenti, per esempio
cucina-presa-01. - critico: sì o no. Se è sì, ricevi un avviso quando non si vede da oltre 30 minuti.
Al primo avvio il file si crea da solo con i dispositivi Wi-Fi che erano in rete: compili i campi vuoti. Il file finisce nel backup notturno cifrato e non su un servizio cloud in chiaro, perché elenca cosa c'è in casa. Nelle note non scrivere mai password.
# dentro il container di Home Assistant (chiudi prima il file in Excel)
python3 /config/scripts/inventario.py --init # crea dispositivi.csv dai dispositivi in rete
python3 /config/scripts/inventario.py --aggiungi # aggiunge quelli in rete che non ci sono ancora
python3 /config/scripts/inventario.py --aggiungi --tutti # include anche i telefoni con MAC casuale
Con --tutti entrano anche i dispositivi con MAC casuale (telefoni e tablet moderni ne usano uno diverso per ogni rete Wi-Fi). Senza quell'opzione lo script li lascia fuori, così i telefoni degli ospiti non riempiono l'inventario né generano avvisi.
Lo script inventario.py
Lo script gira dentro il container di Home Assistant, con la sola libreria standard, e stampa un JSON. Un sensore command_line lo legge ogni cinque minuti, oppure quando premo il pulsante «Rileggi l'inventario adesso». Il sensore grezzo è escluso dalla cronologia, come gli altri.
Da quello che sa, lo script ricava per ogni dispositivo uno stato: in rete, non raggiungibile, «visto dal router» (un segnale recente, entro tre ore). Per i dispositivi visti solo dal router non genero avvisi di offline: il DHCP non è abbastanza frequente per dire «spento» in pochi minuti.
Gli avvisi sono due, con il solito menu dei canali nella scheda «Messaggi»:
- Nuovo dispositivo: un dispositivo in rete che non è nel CSV (e non ha un MAC casuale) genera l'evento
nuovo_dispositivo. - Dispositivo offline: un dispositivo marcato critico che non si vede da oltre 30 minuti genera
dispositivo_offline, e un secondo avviso quando torna. Se i dati di Omada sono vecchi, nessun dispositivo viene dichiarato offline: meglio tacere che dare un falso allarme.
La scheda «Dispositivi» del dashboard
- Inventario: i numeri: censiti, in rete, non raggiungibili, da censire, da completare, garanzie in scadenza (entro 60 giorni), con il pulsante per rileggere subito.
- Da censire: i dispositivi visti in rete che non sono ancora nell'inventario.
- Come si compila: un promemoria sempre a portata di mano.
- Elenco completo, e poi lo stesso elenco raggruppato per stanza e per tipo, quello dei non raggiungibili, quello dei dispositivi da completare o correggere e quello delle garanzie.
I riquadri degli elenchi sono di tipo Markdown.
Se hai anche telecamere e assistenti vocali, passa alle guide dedicate: Alexa, Android TV e le due telecamere (Arlo, Blink).