DevelopmentNetzwerktechnikSmart Home

Peplink InControl 2: WAN, Mobilfunk und GPS in Home Assistant

Peplink InControl 2 für Home Assistant – WAN, Mobilfunk und GPS

Bei verteilten Standorten reicht ein einzelner Online-Indikator selten aus. Interessant wird es, wenn WAN-Status, Mobilfunkqualität und Datenverbrauch zusammen sichtbar werden. Dafür habe ich Peplink InControl 2 Monitor for Home Assistant entwickelt. Die Integration nutzt die offizielle InControl 2 API und bringt die verfügbaren Routerdaten in ein gemeinsames Dashboard.

Die wichtigsten Funktionen

  • Router und WAN-Verbindungen: Cloud-Erreichbarkeit, Status der einzelnen WAN-Schnittstellen, Laufzeit, Firmware und verbundene Clients.
  • Mobilfunkqualität: RSRP, RSRQ, SINR und RSSI sowie Provider, Band und Zellinformationen, sofern das jeweilige Gerät diese an die Cloud meldet.
  • Verbrauch und Verbindungsqualität: Täglicher und monatlicher Upload und Download, Verfügbarkeit sowie zuletzt gemeldete Latenzen je WAN.
  • Standortdaten: GPS-Position, Alter der Positionsmeldung, Geschwindigkeit und Höhe; aktuelle und zuletzt bekannte historische Positionen bleiben unterscheidbar.

Cloud-Anbindung mit klarer zeitlicher Einordnung

Der Zugriff erfolgt ausschließlich lesend über InControl 2. Ein direkter LAN-Zugriff, eine öffentliche Router-IP oder ein VPN zu den Standorten sind dafür nicht erforderlich. Routerkonfigurationen werden nicht verändert; auch Mobilfunk-Site-Surveys werden nicht ausgelöst. Ausgewertet werden bereits vorhandene Berichte.

Inventar, Gerätedetails und GPS werden im Abstand von etwa 120 Sekunden nach Abschluss des vorherigen Durchlaufs aktualisiert. Aufwendigere Berichte zu Verbrauch, Qualität und Ereignissen folgen in größeren Abständen von mindestens 20 Minuten zwischen erfolgreichen Berichtsläufen. Neu erkannte Geräte und WAN-Schnittstellen werden automatisch ergänzt.

Besonders wichtig ist mir die Aussagekraft der Daten: Ein historischer Signalwert ist keine Live-Messung. Deshalb gehören Quellzeitpunkte und der Status der Berichtsabdeckung zur Integration. Ein fehlender Mobilfunkwert bleibt unbekannt, statt als null zu erscheinen. Welche Felder verfügbar sind, hängt vom Routermodell und den Cloud-Berichten ab.

Einrichtung und Einsatz im Dashboard

Voraussetzungen sind Home Assistant ab Version 2025.3 und ein InControl 2 Konto mit Zugriff auf die gewünschten Organisationen sowie aktivierten API-Zugangsdaten. Nach der Installation über das benutzerdefinierte Repository im Marketplace beziehungsweise HACS und einem Neustart werden Client ID und Client Secret in der Integration hinterlegt.

Im Alltag lässt sich damit eine Standortübersicht aufbauen, die Erreichbarkeit, WAN-Zustände, Signalqualität und Verbrauch nebeneinander zeigt. Eine eigene Home-Assistant-Automation kann beispielsweise melden, wenn ein Router länger offline bleibt. Für diese Entscheidung ist der Cloud-Online-Sensor maßgeblich; vorhandene historische Berichte allein belegen keine aktuelle Verbindung.

Das Projekt ist eine unabhängige Community-Integration unter der MIT-Lizenz. Die vollständige Entitätenübersicht, Einrichtung und technischen Grenzen sind im Repository dokumentiert.

Projekt, Installation und Downloads: Peplink InControl 2 Monitor auf GitHub

Projektstart auf GitHub: 10.11.2026. Beschriebener Funktionsumfang: Stand 17.11.2026. Unabhängiges Community-Projekt, keine offizielle Herstellerintegration.

Schreibe einen Kommentar