NetPulse e Home Assistant

O que levas

A rede como mais uma entidade em casa

O NetPulse escreve o estado da tua rede no broker MQTT que já tens para o Home Assistant. A partir daí, os routers e as suas métricas ficam disponíveis para painéis, automatizações e avisos, tal como uma luz ou um sensor de temperatura.

A instalação completa

Um dispositivo com a saúde global (pontuação e etiqueta), os clientes online e totais, os routers online e totais, e os alertas por ler.

Cada router, à parte

Um dispositivo por router com se está online, a sua saúde, CPU, memória, temperatura e número de clientes. Ligado à instalação, para agrupar no painel.

Alertas à medida que acontecem

Cada alerta é publicado como evento no momento em que dispara (temperatura, WAN em baixo, dispositivo novo...), para o transformares na automatização que quiseres.

O NetPulse escreve, não escuta: é um publicador. No Home Assistant lês a rede; para atuar sobre um router usas o NetGrip, o seu painel, que também fala MQTT e aceita comandos.

Primeiros passos

Quatro passos, uma vez

Vem desativado: até o ligares, o NetPulse não publica nada. Configura-se por variáveis de ambiente (ou opções UCI no modo on-box).

Um broker MQTT (o add-on Mosquitto do Home Assistant é a escolha habitual)
Descoberta MQTT ativa no Home Assistant (o normal com o Mosquitto)
Um nome de instância se tiveres mais do que uma instalação (casa, escritório...)
Mais nada: não há portas para abrir nem router para tocar

Variáveis de ambiente

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

Após reiniciar, o registo mostra «[mqtt] connected ... as instance "casa"». O primeiro estado demora no máximo um intervalo.

Entidades

O que aparece no Home Assistant

Um dispositivo para a instalação e um por router, pendurado no primeiro. Estas são as entidades que se criam sozinhas:

Dispositivo	Entidade	Tipo	Unidade
NetPulse <instancia>	Health score	sensor
	Clients online	sensor
	Routers online	sensor
	Unread alerts	sensor
	NetPulse version	sensor (diagnóstico)
cada router	Online	binário (conetividade)
	Health	sensor
	CPU usage	sensor	%
	Memory usage	sensor	%
	Temperature	sensor	°C
	Clients	sensor (diagnóstico)

Se um router levar o NetGrip com o seu MQTT ligado, é o NetGrip que o expõe ao Home Assistant e o NetPulse não o publica: só vês um dispositivo por router.

O dispositivo de um router no Home Assistant, com as suas entidades criadas por descoberta.

E mais: NetGrip

Controlar o router a partir do Home Assistant

O NetPulse só publica, mas os routers que levam o NetGrip (o seu painel) também aceitam comandos por MQTT. Com o NetGrip ligado, o Home Assistant não só vê o router: controla-o.

Ação	Tópico de comando	Valor
Wi-Fi de convidados	`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 com o resultado em netgrip/<router>/result. E publica ainda 17 sensores próprios: clientes por banda, sinal WiFi mais fraco e médio, e tráfego da rede local.

Um painel do Home Assistant com o tráfego da rede local e a saúde da instalação.

O que deves saber

A ligação ao broker não leva TLS (porta 1883): pensada para um broker da tua rede local, não para o expor à internet.
Está desativado até o ligares, e em modo demo não publica nada.
Não há nuvem pelo meio: os dados vão do NetPulse para o teu broker e daí para o teu Home Assistant, sem passar por terceiros.
Se o broker cair, o NetPulse não dá por isso: a publicação falha em silêncio e volta a tentar. A monitorização continua a funcionar.

Experimenta-o na tua rede

Instala o NetPulse, aponta a sua instância ao broker e num minuto terás a tua rede dentro do Home Assistant.

Instalar na tua rede Funcionalidades

A tua rede, dentro do Home Assistant