6 de octubre de 2026 Actualizado: 25 de octubre de 2026 13 min de lectura

Conectar digitalSTROM con Home Assistant: integración local y automatizaciones

Una integración local de Home Assistant para el servidor digitalSTROM, además de iluminación por movimiento, modo ducha, música con 4× pulsaciones y salida automática mediante FRITZ!Box. Con los problemas surgidos en la práctica.

En las instalaciones de digitalSTROM, las luces, persianas y otros consumidores están conectados a bornes en el cuadro eléctrico y se controlan mediante pulsadores y un servidor digitalSTROM (dSS20). Cuando se añaden otros sistemas como Philips Hue, Sonos y una FRITZ!Box, resulta natural centralizarlo todo localmente en Home Assistant, sin cuenta en la nube y sin guardar la contraseña del dSS en Home Assistant. Para ello escribí una pequeña integración y la publiqué, junto con las automatizaciones correspondientes, como pfstr/ha-digitalstrom-local bajo licencia MIT.

Conclusión breve: el dSS ofrece una API JSON funcional con eventos. Quien la utilice con moderación obtiene pulsadores, escenas y las actividades Salir y Llegar en Home Assistant sin demora, y puede activar con ellas automatizaciones que digitalSTROM por sí solo no conoce.

Cómo funciona la integración

El dSS ofrece su API mediante HTTPS en el puerto 8080, con un certificado autofirmado. digitalSTROM prevé tokens de aplicación para los programas: el programa solicita un token, el usuario lo autoriza en el Configurator en Sistema > Permiso de acceso y, después, el programa inicia sesión con él. La contraseña del dSS permanece con el usuario.

DSS=https://dss.local:8080/json
curl -sk "$DSS/system/requestApplicationToken?applicationName=Home%20Assistant"
curl -sk "$DSS/system/loginApplication?loginToken=<APP-TOKEN>"
curl -sk "$DSS/event/subscribe?name=callScene&subscriptionID=42&token=<SESSION>"
curl -sk "$DSS/event/get?subscriptionID=42&timeout=30000&token=<SESSION>"
Opciones explicadas
OpciónEfecto
-ssin indicador de progreso
-kaceptar el certificado autofirmado del dSS
requestApplicationTokencrea un token de aplicación que debe autorizarse en el Configurator
loginApplicationintercambia el token de aplicación autorizado por un token de sesión
event/subscribesuscribe un evento (callScene, stateChange, buttonClick …) bajo un ID elegido libremente
event/get con timeoutespera hasta 30 segundos nuevos eventos (sondeo largo)

La integración mantiene abierta permanentemente una conexión de sondeo largo de este tipo. Cada escena activada por un pulsador, la aplicación o el Configurator llega como evento. Estados como «luz encendida en la habitación» o la presencia se encuentran en la caché del dSS, en /usr/states, y pueden consultarse sin cargar los bornes.

En cambio, las consultas directas de valores de salida (device/getOutputValue) pasan por el bus dS485 hasta el borne y tardan entre medio segundo y un segundo por valor. Muchas consultas de este tipo a intervalos cortos pueden sobrecargar los Meter. Por ello, la integración solo lee directamente las posiciones de persianas y las salidas Joker, cada 15 minutos y aproximadamente un minuto después de un movimiento.

PlataformaContenido
lightuna luz por habitación, controlada mediante escenas de habitación como los pulsadores; brillo en bornes regulables, solo encendido/apagado en los conmutados
coverpersianas con subir, bajar, detener y posición
sceneambientes nombrados en el Configurator
buttonSalir (escena 72) y Llegar (escena 71)
binary_sensorpresencia, alarma de viento, detectores de movimiento, salidas Joker
sensorconsumo total

Además, la integración comunica cada escena de habitación, así como Salir y Llegar, como evento digitalstrom_local_event a Home Assistant. Así se pueden asignar libremente 2× o 4× pulsaciones en un interruptor de luz convencional.

Automatizaciones como Blueprints

Las siguientes automatizaciones están incluidas como Blueprints en el repositorio y pueden incorporarse a Home Assistant mediante el botón de importación del README.

Iluminación por movimiento que no apaga la luz encendida manualmente

Con movimiento, la luz se enciende y, tras un tiempo configurable sin movimiento, vuelve a apagarse. Opcionalmente, esto solo se aplica por debajo de un umbral de luminosidad, dentro de una franja horaria o con atenuación nocturna. Si alguien enciende la luz con el pulsador, permanece encendida. Un interruptor auxiliar (input_boolean) registra si la automatización encendió la luz; solo entonces también la apaga.

Un detalle solo se aprecia durante el funcionamiento: el activador «detector en reposo durante 2 minutos» es un contador que Home Assistant descarta en cada reinicio. Si el detector se movió por última vez antes del reinicio, no se produce un nuevo cambio a «en reposo» y la luz permanece encendida. Por eso, el Blueprint comprueba adicionalmente cada minuto si una luz encendida por él sigue iluminada aunque el detector lleve suficiente tiempo en reposo.

Apagar la luz al salir de la habitación

El tiempo de apagado de la iluminación por movimiento es un compromiso: si es demasiado corto, la luz se apaga mientras alguien permanece quieto en la habitación; si es demasiado largo, sigue encendida durante minutos tras salir. Por ello, otro Blueprint utiliza un segundo detector fuera de la habitación, normalmente en el pasillo. Si este detecta movimiento, el detector de la habitación había detectado movimiento poco antes (dentro de 30 segundos) y después permanece en reposo, la luz de la habitación se apaga inmediatamente. Con detectores Hue, que notifican «en reposo» unos 10 segundos después del último movimiento, ocurre aproximadamente entre 10 y 15 segundos después de salir.

Para que nadie se quede a oscuras, la regla solo se aplica bajo ciertas condiciones: la luz debe haber sido encendida por la automatización de movimiento, no puede estar activo un modo ducha y debe haber como máximo una persona en casa. El número de personas se determina a partir de los teléfonos que Home Assistant reconoce como personas. La condición de 30 segundos protege además frente al caso de que alguien permanezca quieto durante más tiempo en la habitación y otra persona pase por el pasillo.

Modo ducha mediante 2× pulsaciones

En la ducha, un detector de movimiento normalmente no detecta a nadie y, tras el tiempo configurado, se hace de noche. 2× pulsaciones en el pulsador del baño activan en digitalSTROM el ambiente 2 (escena 17). La automatización reconoce esta escena en la habitación y activa un modo ducha que bloquea el apagado. Los movimientos durante los primeros 2 minutos se ignoran (desvestirse, entrar). El primer movimiento posterior finaliza el modo ducha; a partir de entonces vuelve a aplicarse el tiempo de apagado normal. Tras una duración máxima configurable (20 minutos por defecto), finaliza por sí solo.

4× pulsaciones inician Sonos

Al pulsar varias veces rápidamente un pulsador, digitalSTROM cambia los ambientes uno tras otro: escena 5, 17, 18 y, en la cuarta pulsación, 19. Si se configura la escena 19 en el Configurator para todas las lámparas como «No modificar salida», queda libre para otros fines. Un Blueprint reacciona a esta escena, apaga la luz de la habitación e inicia el altavoz Sonos de la habitación o, en habitaciones sin altavoz, varios conjuntamente.

El script correspondiente tiene en cuenta tres aspectos: si ya hay un altavoz reproduciendo, se añade la nueva habitación a su grupo para mantener la reproducción sincronizada. Si no se puede reanudar nada, reproduce una emisora de radio del directorio Radio Browser. Además, antes de cada inicio se establece el mismo volumen inicial; de lo contrario, una habitación reproduce bajo y otra al volumen al que alguien escuchó música por última vez.

Salir y Llegar mediante FRITZ!Box

La integración FRITZ!Box Tools informa de si un teléfono está en la WLAN; evalúa la lista de dispositivos del router y cubre simultáneamente las redes de 2,4 GHz, 5 GHz y LAN. Si ya no hay nadie en casa y no se ha pulsado Salir, un Blueprint activa Salir. Al volver a casa, sigue Llegar y, si está oscuro, una luz de bienvenida.

Como complemento, una automatización puede apagar las lámparas de otros sistemas (por ejemplo, Hue) y pausar Sonos al salir. El propio dSS apaga las lámparas digitalSTROM.

Plano como panel de control

Una representación clara en Home Assistant es un plano con la tarjeta integrada picture-elements. Sobre el plano se coloca un SVG transparente por habitación, que se sustituye por otro ligeramente amarillo cuando la luz está encendida; al pulsar la habitación se enciende o apaga la luz. Lámparas, altavoces, persianas y detectores se sitúan como símbolos en su ubicación. Las instrucciones con una configuración de ejemplo se encuentran en el repositorio, en docs/floor-plan-dashboard.md.

Problemas de la práctica

ProblemaCausaSolución
El pulsador Salir no tiene efectoEl dSS no está en la red; las actividades a través de varios circuitos eléctricos pasan por el servidorSe restauró la conexión de red del dSS
Las persianas no reaccionanLa alarma de viento estaba «activa» aunque no había sensor de vientoSe activó la escena 87 («sin viento») para todas las habitaciones
Las persianas no suben al salirEscena 72 configurada como «No modificar salida» (dontCare)device/setSceneMode con dontCare=0; se aceptó el valor false, pero se ignoró
No se puede regular la luzTubo fluorescente conectado a un borne conmutado (modo de salida 35)La integración reconoce los bornes conmutados y solo ofrece encendido/apagado en ellos
La luz permanece encendida tras reiniciarEl contador de «en reposo desde hace X minutos» se pierde al reiniciarComprobación adicional cada minuto
El teléfono se considera ausenteEl iPhone utiliza una dirección WLAN privada cambiante y desconecta brevemente la WLAN en reposoDirección WLAN privada en «Fija», periodo de gracia de 10 minutos
DECT transmite continuamente«DECT Eco» no está disponible en cuanto se registra un dispositivo FRITZ! Smart HomePrescindir de enchufes DECT si se desea DECT Eco

Una búsqueda de dispositivos en el puente Hue incorpora todos los dispositivos que se encuentren en ese momento en modo de emparejamiento. Después, compruebe en la lista de dispositivos que solo se hayan añadido sus propias lámparas.

Las tablas de escenas de los bornes pueden leerse y modificarse mediante la API, por ejemplo con device/getSceneMode y device/saveScene. Cada una de estas llamadas pasa por el bus. Antes de realizar cambios, guarde los valores anteriores, por ejemplo en un archivo CSV, para poder restaurarlos si fuera necesario.

Historial de cambios

  • 25 de octubre de 2026: se actualizó el enlace de Fuentes a la nueva dirección de la base de conocimientos de FRITZ!.

Fuentes

  1. pfstr/ha-digitalstrom-local

    integración y Blueprints de este artículo, licencia MIT.

    https://github.com/pfstr/ha-digitalstrom-local
  2. digitalSTROM: Manual de uso y configuración

    actividad Salir (mantener pulsado 3 segundos), ajuste «No modificar salida» en el capítulo 3.5.2.

    https://www.digitalstrom.com/wp-content/uploads/2021/08/AHB_DE_A1121D001V013_neu.pdf
  3. digitalSTROM: Documentación de pulsadores de los bornes

    ajustes de fábrica de las funciones de pulsador por tipo de borne.

    https://www.digitalstrom.com/wp-content/uploads/2021/08/A0818D078V001_Tastendokumentation.pdf
  4. digitalSTROM: Manuales de instrucciones

    resumen de manuales, documentación para planificación e instalación.

    https://www.digitalstrom.com/bedienungsanleitungen/
  5. Home Assistant: FRITZ!Box Tools

    detección de presencia, interruptores WLAN, opciones de la integración.

    https://www.home-assistant.io/integrations/fritz/
  6. Home Assistant: tarjeta Picture Elements
  7. Home Assistant: Blueprints
  8. Base de conocimientos de FRITZ!: el enchufe FRITZ! pierde la conexión
  9. Radio Browser

    directorio libre de transmisiones de radio, integrado en Home Assistant como fuente multimedia.

    https://www.radio-browser.info/

Comentarios

Los comentarios se cargan desde GitHub / Giscus.