NetPulse et Home Assistant

Ce que vous obtenez

Votre réseau, comme une entité de plus à la maison

NetPulse écrit l’état de votre réseau sur le broker MQTT que vous utilisez déjà pour Home Assistant. À partir de là, les routeurs et leurs métriques sont disponibles pour les tableaux de bord, les automatisations et les alertes, comme une lumière ou un capteur de température.

L’installation entière

Un appareil avec la santé globale (score et libellé), les clients en ligne et au total, les routeurs en ligne et au total, et les alertes non lues.

Chaque routeur, séparément

Un appareil par routeur avec son état en ligne, sa santé, son CPU, sa mémoire, sa température et son nombre de clients. Lié à l’installation, pour le regrouper dans le panneau.

Les alertes quand elles arrivent

Chaque alerte est publiée comme événement au moment où elle se déclenche (température, WAN coupé, nouvel appareil...), pour que vous en fassiez l’automatisation que vous voulez.

NetPulse écrit, n’écoute pas : il publie. Depuis Home Assistant vous lisez le réseau ; pour agir sur un routeur, vous utilisez NetGrip, son panneau, qui parle MQTT lui aussi et accepte les commandes.

Mise en route

Quatre étapes, une seule fois

Il est livré désactivé : tant que vous ne l’activez pas, NetPulse ne publie rien. Il se configure par variables d’environnement (ou options UCI en mode on-box).

Un broker MQTT (l’add-on Mosquitto de Home Assistant est le plus courant)
La découverte MQTT activée dans Home Assistant (la norme avec Mosquitto)
Un nom d’instance si vous avez plusieurs installations (maison, bureau...)
Rien d’autre : aucun port à ouvrir, aucun routeur à toucher

Variables d’environnement

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

Après un redémarrage, le journal affiche « [mqtt] connected ... as instance "maison" ». Le premier état prend au plus un intervalle.

Entités

Ce qui apparaît dans Home Assistant

Un appareil pour l’installation et un par routeur, rattachés au premier. Voici les entités créées toutes seules :

Appareil	Entité	Type	Unité
NetPulse <instancia>	Health score	capteur
	Clients online	capteur
	Routers online	capteur
	Unread alerts	capteur
	NetPulse version	capteur (diagnostic)
chaque routeur	Online	binaire (connectivité)
	Health	capteur
	CPU usage	capteur	%
	Memory usage	capteur	%
	Temperature	capteur	°C
	Clients	capteur (diagnostic)

Si un routeur fait tourner NetGrip avec son MQTT activé, c’est NetGrip qui l’expose à Home Assistant et NetPulse ne le publie pas : vous ne verrez qu’un seul appareil par routeur.

L’appareil d’un routeur dans Home Assistant, avec ses entités créées par découverte.

Et plus encore : NetGrip

Contrôler le routeur depuis Home Assistant

NetPulse ne fait que publier, mais les routeurs qui font tourner NetGrip (son panneau) acceptent aussi les commandes par MQTT. Avec NetGrip activé, Home Assistant ne fait pas que voir le routeur : il le pilote.

Action	Topic de commande	Valeur
WiFi invité	`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
Redémarrer	`netgrip/<router>/command/reboot`	PRESS

Chaque routeur répond avec le résultat sur netgrip/<router>/result. Il publie en plus 17 capteurs qui lui sont propres : clients par bande, signal WiFi le plus faible et moyen, et trafic du réseau local.

Un tableau de bord Home Assistant avec le trafic du réseau local et la santé de l’installation.

Ce qu’il faut savoir

La connexion au broker n’utilise pas TLS (port 1883) : pensée pour un broker de votre réseau local, pas pour l’exposer à Internet.
Il est désactivé tant que vous ne l’activez pas, et en mode démo il ne publie rien.
Aucun cloud au milieu : les données vont de NetPulse à votre broker, puis à votre Home Assistant, sans passer par des tiers.
Si le broker tombe, NetPulse ne s’en aperçoit pas : la publication échoue en silence et réessaie. La supervision continue.

Essayez-le sur votre réseau

Installez NetPulse, pointez son instance vers le broker et en une minute vous aurez votre réseau dans Home Assistant.

Installer sur votre réseau Fonctions

Votre réseau, dans Home Assistant