NetPulse y Home Assistant

Qué te llevas

La red, como una entidad más de tu casa

NetPulse escribe el estado de tu red en el broker MQTT que ya tienes para Home Assistant. A partir de ahí, los routers y sus métricas están disponibles para paneles, automatizaciones y avisos, igual que una luz o un sensor de temperatura.

La instalación entera

Un dispositivo con la salud global (puntuación y etiqueta), los clientes online y totales, los routers online y totales, y las alertas sin leer.

Cada router, por separado

Un dispositivo por router con si está en línea, su salud, CPU, memoria, temperatura y número de clientes. Vinculado a la instalación, para agruparlo en el panel.

Las alertas cuando pasan

Cada alerta se publica como evento en el momento en que se dispara (temperatura, WAN caída, dispositivo nuevo...), para que la conviertas en la automatización que quieras.

NetPulse escribe, no escucha: es un publicador. Desde Home Assistant lees la red; para actuar sobre un router se usa NetGrip, su panel, que habla MQTT igual y sí acepta órdenes.

Puesta en marcha

Cuatro pasos, una vez

Viene desactivado: hasta que lo enciendas, NetPulse no publica nada. Se configura por variables de entorno (o opciones UCI en el modo on-box).

Un broker MQTT (el add-on Mosquitto de Home Assistant es lo más común)
Descubrimiento MQTT activo en Home Assistant (lo normal con Mosquitto)
Un nombre de instancia si tienes más de una instalación (casa, oficina...)
Nada más: no hay que abrir puertos ni tocar el router

Variables de entorno

NETPULSE_MQTT_ENABLED=1
NETPULSE_MQTT_HOST=10.0.0.10
NETPULSE_MQTT_USER=netpulse
NETPULSE_MQTT_PASS=...
NETPULSE_MQTT_INSTANCE=casa

Tras reiniciar, el registro muestra «[mqtt] connected ... as instance "casa"». El primer estado tarda como mucho un intervalo.

Entidades

Lo que aparece en Home Assistant

Un dispositivo para la instalación y uno por router, colgando del primero. Estas son las entidades que se crean solas:

Dispositivo	Entidad	Tipo	Unidad
NetPulse <instancia>	Health score	sensor
	Clients online	sensor
	Routers online	sensor
	Unread alerts	sensor
	NetPulse version	sensor (diagnóstico)
cada router	Online	binario (conectividad)
	Health	sensor
	CPU usage	sensor	%
	Memory usage	sensor	%
	Temperature	sensor	°C
	Clients	sensor (diagnóstico)

Si un router lleva NetGrip con su MQTT activado, es NetGrip quien lo expone a Home Assistant y NetPulse no lo publica: solo verás un dispositivo por router.

El dispositivo de un router en Home Assistant, con sus entidades creadas por descubrimiento.

Y algo más: NetGrip

Controlar el router desde Home Assistant

NetPulse solo publica, pero los routers que llevan NetGrip (su panel) también aceptan órdenes por MQTT. Con NetGrip activado, Home Assistant no solo ve el router: lo maneja.

Acción	Topic de orden	Valor
WiFi de invitados	`netgrip/<router>/command/guest_wifi`	ON / OFF
banIP	`netgrip/<router>/command/banip`	ON / OFF / RELOAD
IPv6	`netgrip/<router>/command/ipv6`	ON / OFF
SQM	`netgrip/<router>/command/sqm`	ON / OFF
Reiniciar	`netgrip/<router>/command/reboot`	PRESS

Cada router responde con el resultado en netgrip/<router>/result. Y además publica 17 sensores propios: clientes por banda, señal WiFi mínima y media, y tráfico de la red local.

Un panel de Home Assistant con el tráfico de la red local y la salud de la instalación.

Lo que hay que saber

La conexión al broker no lleva TLS (puerto 1883): pensada para un broker de tu red local, no para exponerlo a Internet.
Está desactivado hasta que lo enciendas, y en modo demo no publica nada.
No hay nube de por medio: los datos van de NetPulse a tu broker y de ahí a tu Home Assistant, sin pasar por terceros.
Si el broker cae, NetPulse no se entera: la publicación falla en silencio y reintenta. La monitorización sigue igual.

Pruébalo en tu red

Instala NetPulse, apunta su instancia al broker y en un minuto tendrás tu red dentro de Home Assistant.

Instalar en tu red Funciones

Tu red, dentro de Home Assistant