UPnP / IGD Smart-Home-Integration, kostenlos und Open Source
Expose your internet box WAN link state and traffic counters over UPnP/IGD.
Veröffentlicht von callemand
- Geräte
- Version 1.1.0
- Erfordert Gladys >=4.84.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Overview
This integration connects Gladys Assistant to your internet box / router through the UPnP-IGD (Internet Gateway Device) protocol that almost every home box exposes on the local network. It turns your box into a Gladys device whose read-only features let you graph its traffic, chart your line and trigger scenes on the WAN link state (for example, be notified when your connection drops).
Discovery
The integration finds your box automatically using an SSDP network scan run by the Gladys core. Open the Gladys Discovery screen and your box appears — add it, and it starts reporting.
If auto-discovery finds nothing (some boxes disable UPnP, or the scan cannot
reach them), you can fill in the optional Box description URL setting with
your box's UPnP device description URL (something like
http://192.168.1.1:5000/rootDesc.xml) and run Discovery again.
Features
Each box exposes these read-only features:
- Connection status — whether the WAN link is up or down;
- External IP — your public internet IP address;
- Uptime — how long the internet connection has been up (seconds);
- Download rate / Upload rate: the average data rate (Mbit/s) since the previous poll, refreshed every 15 seconds;
- Packets sent / Packets received — total packet counters.
Notes
- The rates are computed from the box's byte counters. These counters are 32-bit: most boxes wrap them back to zero at ~4.29 GB, which the integration handles. Some boxes (for example the Orange Livebox) keep them stuck at the max value instead. On those boxes, no rate can be computed.
- The first rate appears on the second poll, about 15 seconds after the start.
- The packet counters come straight from the box. They are 32-bit too, so expect the graph to reset periodically.
- Nothing is controllable: a box exposes only statistics over IGD, so every feature is read-only.
- UPnP/IGD must be enabled on your box (it usually is by default).
Konfigurationseinstellungen
Diese Einstellungen fragt UPnP / IGD in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Box description URL (optional) | string | Nein | Only needed if automatic discovery finds nothing: the UPnP device description URL of your box. |
So installierst du UPnP / IGD in Gladys
- Öffne in Gladys Integrationen: UPnP / IGD erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/callemand/gladys-upnp-igd:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/callemand/gladys-upnp-igd.
UPnP / IGD benötigt Gladys >=4.84.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
UPnP / IGD ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von callemand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation