Saltar al contenido principal

Integración domótica UPnP / IGD, gratuita y de código abierto

Integración UPnP / IGD para Gladys Assistant

Expose your internet box WAN link state and traffic counters over UPnP/IGD.

Ver en GitHubTodas las integraciones externas
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

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);
  • Bytes sent / Bytes received — total traffic counters;
  • Packets sent / Packets received — total packet counters.

Notes​

  • The byte and packet counters come straight from the box's IGD service. On many boxes these counters are 32-bit and wrap back to zero at ~4 GB — the raw value is reported as-is, so expect the graph to reset periodically on those boxes.
  • 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).

Parámetros de configuración​

Estos son los parámetros que UPnP / IGD te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Box description URL (optional)stringNoOnly needed if automatic discovery finds nothing: the UPnP device description URL of your box.

Cómo instalar UPnP / IGD en Gladys​

  1. En Gladys, abre Integraciones: UPnP / IGD aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/callemand/gladys-upnp-igd:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/callemand/gladys-upnp-igd.

UPnP / IGD requiere Gladys >=4.84.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

UPnP / IGD es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene callemand, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en