Integration

Dein Netzwerk, direkt in Home Assistant

NetPulse veröffentlicht den Flottenstatus auf einem MQTT-Broker, und Home Assistant erkennt ihn von selbst: Es legt die Geräte und ihre Entitäten an, ohne dass du irgendetwas von Hand definierst. Alles geschieht in deinem lokalen Netzwerk.

In deinem Netz installieren Handbuch lesen
Was du bekommst

Dein Netzwerk als eine weitere Entität zu Hause

NetPulse schreibt deinen Netzwerkstatus in den MQTT-Broker, den du ohnehin für Home Assistant betreibst. Von dort stehen die Router und ihre Metriken für Dashboards, Automatisierungen und Benachrichtigungen bereit, genau wie ein Licht oder ein Temperatursensor.

Die gesamte Installation

Ein Gerät mit der globalen Gesundheit (Wert und Bezeichnung), Clients online und gesamt, Router online und gesamt sowie ungelesenen Alarmen.

Jeder Router, für sich

Ein Gerät pro Router mit Online-Status, Gesundheit, CPU, Speicher, Temperatur und Client-Anzahl. Mit der Installation verknüpft, damit es im Panel gruppiert wird.

Alarme, sobald sie passieren

Jeder Alarm wird als Event veröffentlicht, sobald er ausgelöst wird (Temperatur, WAN-Ausfall, neues Gerät ...), damit du daraus die gewünschte Automatisierung machst.

NetPulse schreibt, es hört nicht zu: Es ist ein Publisher. Von Home Assistant aus liest du das Netzwerk; um auf einem Router zu handeln, nutzt du NetGrip, sein Panel, das ebenfalls MQTT spricht und Befehle akzeptiert.

Erste Schritte

Vier Schritte, einmalig

Es ist deaktiviert: Bis du es einschaltest, veröffentlicht NetPulse nichts. Konfiguriert wird es über Umgebungsvariablen (oder UCI-Optionen im On-Box-Modus).

  • Ein MQTT-Broker (das Mosquitto-Add-on von Home Assistant ist die übliche Wahl)
  • MQTT-Discovery in Home Assistant aktiviert (der Normalfall mit Mosquitto)
  • Ein Instanzname, wenn du mehr als eine Installation betreibst (Zuhause, Büro ...)
  • Sonst nichts: keine Ports zu öffnen, kein Router anzufassen

Umgebungsvariablen

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

Nach einem Neustart zeigt das Log „[mqtt] connected ... as instance \"home\"“. Der erste Status dauert höchstens ein Intervall.

Entitäten

Was in Home Assistant auftaucht

Ein Gerät für die Installation und eines pro Router, das am ersten hängt. Das sind die Entitäten, die von selbst angelegt werden:

Gerät Entität Typ Einheit
NetPulse <instancia>Health scoreSensor
Clients onlineSensor
Routers onlineSensor
Unread alertsSensor
NetPulse versionSensor (Diagnose)
jeder RouterOnlineBinär (Konnektivität)
HealthSensor
CPU usageSensor%
Memory usageSensor%
TemperatureSensor°C
ClientsSensor (Diagnose)

Wenn ein Router NetGrip mit aktiviertem MQTT betreibt, ist NetGrip derjenige, der ihn für Home Assistant bereitstellt, und NetPulse veröffentlicht ihn nicht: Du siehst nur ein Gerät pro Router.

Ein Router-Gerät in Home Assistant, mit seinen durch Discovery angelegten Entitäten.

Und mehr: NetGrip

Den Router aus Home Assistant steuern

NetPulse veröffentlicht nur, aber Router mit NetGrip (seinem Panel) akzeptieren auch Befehle über MQTT. Mit aktiviertem NetGrip sieht Home Assistant den Router nicht nur: Es steuert ihn.

Aktion Befehlstopic Wert
Gast-WLANnetgrip/<router>/command/guest_wifiON / OFF
banIPnetgrip/<router>/command/banipON / OFF / RELOAD
IPv6netgrip/<router>/command/ipv6ON / OFF
SQMnetgrip/<router>/command/sqmON / OFF
Neustartnetgrip/<router>/command/rebootPRESS

Jeder Router antwortet mit dem Ergebnis auf netgrip/<router>/result. Außerdem veröffentlicht er 17 eigene Sensoren: Clients pro Band, schwächstes und durchschnittliches WLAN-Signal sowie lokalen Netzwerkverkehr.

Ein Home-Assistant-Dashboard mit dem lokalen Netzwerkverkehr und der Gesundheit der Installation.

Was du wissen solltest

  • Die Broker-Verbindung hat kein TLS (Port 1883): gedacht für einen Broker in deinem lokalen Netzwerk, nicht um ihn ins Internet zu stellen.
  • Es ist deaktiviert, bis du es einschaltest, und im Demo-Modus veröffentlicht es nichts.
  • Keine Cloud dazwischen: Die Daten gehen von NetPulse zu deinem Broker und von dort zu deinem Home Assistant, ohne Dritte.
  • Wenn der Broker ausfällt, merkt NetPulse es nicht: Das Veröffentlichen schlägt still fehl und wird erneut versucht. Die Überwachung läuft weiter.

Probier es in deinem Netzwerk

Installiere NetPulse, richte seine Instanz auf den Broker und in einer Minute hast du dein Netzwerk in Home Assistant.

In deinem Netz installieren Funktionen
Erscheinungsbild
Thema