En artículos anteriores, hemos hablado mucho sobre Zigbee, MQTT y gestión de energía. Pero para muchos usuarios, yo incluido, otra tecnología de radio ha formado parte del paisaje durante años: EnOcean.
Interruptores sin batería, módulos empotrados, enchufes, sensores… NodOn ofrece una gama completa de productos EnOcean. El problema es que su integración en Home Assistant nunca ha sido verdaderamente sencilla. Por eso he desarrollado NodOcean for HA, una integración de Home Assistant disponible a través de HACS.
EnOcean, en pocas palabras
EnOcean es una tecnología de radio diseñada para hogares y edificios, con una característica distintiva: muchos productos funcionan de forma inalámbrica y sin pilas. Un interruptor EnOcean aprovecha la energía de la propia pulsación para enviar su mensaje de radio. Algunos sensores funcionan únicamente con energía luminosa.
El resultado: controles que puedes colocar en cualquier lugar, sin mantenimiento, y módulos que continúan funcionando directamente con sus interruptores, incluso sin un controlador domótico.
El problema: una integración nativa muy técnica
Home Assistant dispone de una integración nativa de EnOcean. Pero para añadir un producto, generalmente hay que:
- conocer el perfil EEP del producto (por ejemplo D2-01-0F o A5-04-01);
- registrar su ID EnOcean;
- escribir algunas líneas de YAML;
- y, para módulos y enchufes, gestionar manualmente el emparejamiento bidireccional.
Para un entusiasta, es factible. Para un usuario que simplemente quiere controlar su persiana o su radiador, suele ser donde termina la aventura.
La solución: elige tu producto de una lista
El principio de NodOcean for HA puede resumirse en una frase: eliges tu producto NodOn de una lista, y Home Assistant hace el resto.
No hay perfil EEP que buscar, no hay ID que copiar, no hay archivo YAML, no hay broker MQTT ni complemento. La integración se comunica directamente con un stick USB EnOcean conectado al servidor de Home Assistant.
En la práctica, añadir un producto requiere solo unos pocos pasos:
- En la integración, haz clic en Añadir un producto NodOn;
- Elige el producto de la lista;
- Sigue la instrucción que aparece, por ejemplo «pulsa el botón del módulo 3 veces rápidamente»;
- Home Assistant escucha durante 60 segundos, detecta el producto y, para módulos y enchufes, responde él mismo a la solicitud de emparejamiento;
- Asigna un nombre al producto, elige su habitación: listo.
16 productos NodOn compatibles
La integración cubre toda la gama actual de NodOn EnOcean:
| Familia | Productos | En Home Assistant |
| 🔌 Módulos empotrados | SIN-2-1-01 Multifunción, SIN-2-2-01 Iluminación 2 canales, SIN-2-FP-01 Hilo piloto, SIN-2-RS-01 Persiana motorizada | Interruptor, luces, modo hilo piloto (6 órdenes) + medición, persiana con posición |
| 🔋 Enchufes | ASP-2 Enchufe inteligente, MSP-2 Micro Enchufe Inteligente + medición | Enchufe, potencia y energía |
| 🎛️ Mandos | CWS-2-1 Interruptor de pared, CRC-2 Soft Remote, CFS-2 Interruptor de suelo, CCS-2 Interruptor de tarjeta, TSB-2 Soft Button | Eventos por tecla, pulsación simple / doble / larga, tarjeta insertada |
| 🌡️ Sensores | SDO-2 y SWO-2 Apertura, PIR-2 Movimiento, STP-2 Temperatura, STPH-2 Temperatura + humedad | Apertura, movimiento + luminosidad, temperatura, humedad |
Configuración de productos, directamente en Home Assistant
Esta es posiblemente la parte que aporta un valor añadido real. Los productos NodOn EnOcean ofrecen muchos parámetros que, hasta ahora, eran difíciles de acceder. Con NodOcean for HA, aparecen en la tarjeta de Configuración de la página de dispositivo de cada producto:
- LED de estado encendido o apagado (modo día / noche);
- Estado tras corte de corriente: anterior, encendido o apagado;
- Apagado automático tras un retardo, por ejemplo para la luz de un garaje;
- Tipo de interruptor cableado conectado a un módulo: interruptor de palanca, pulsador…;
- Calibración y tiempo de recorrido del módulo de persiana motorizada;
- Modo repetidor para ampliar el alcance de la radio;
- Corrección de temperatura y humedad para los sensores;
- Gestión de mandos a distancia emparejados directamente con un módulo.
Es bueno saberlo: los productos EnOcean no permiten leer sus configuraciones. Home Assistant muestra por tanto el último valor enviado, y los valores predeterminados son los de un producto nuevo.
Y para interruptores y mandos a distancia, la integración ofrece disparadores de dispositivo directamente en el editor de automatizaciones: «Pulsación superior izquierda», «Doble pulsación»… Sin necesidad de decodificar tramas.
Un botón «Ayuda NodOn» integrado
En la página de dispositivo de cada producto, la tarjeta de Diagnósticos incluye un botón Ayuda NodOn. Con un toque, aparece una notificación con el manual del producto, el enlace de soporte de NodOn y el ID EnOcean del producto.
Es un pequeño detalle, pero responde a una pregunta muy real del día a día: «¿cómo pongo este módulo de nuevo en modo de emparejamiento?».
Y para quienes quieran ir más lejos: el puente MQTT
Después del artículo sobre MQTT, ya te lo ves venir… NodOcean for HA también puede publicar los estados de los productos en un broker MQTT y recibir comandos, como Zigbee2MQTT.
- Estados: nodocean/<producto> → {"state": "ON", "power": 12.5, "energy": 3.2}
- Comandos: nodocean/<producto>/set → {"state": "ON"}, {"position": 50} o {"mode": "eco"}
- Botones: nodocean/<producto>/action → left_up, single…
Los productos EnOcean quedan así accesibles para Node-RED, Jeedom, un BMS u otra instancia de Home Assistant. El puente es opcional y está desactivado por defecto: para un uso estándar, no lo necesitas.
Lo que necesitas para empezar
- Home Assistant 2025.3 o posterior (OS, Container, Core…);
- un stick USB EnOcean USB300, o un stick compatible con ESP3 (TCM310, USB500…);
- HACS, para instalación y actualizaciones con un clic.
La interfaz está disponible en francés, inglés y alemán, según el idioma de Home Assistant.
⚠️ Atención: un stick EnOcean solo puede ser utilizado por una integración a la vez. Si la integración nativa de EnOcean de Home Assistant ya lo está usando, debes eliminarla antes de instalar NodOcean for HA.
Instalación vía HACS
NodOcean for HA no está todavía en el catálogo predeterminado de HACS. Solo tienes que añadirlo una vez como repositorio personalizado: las actualizaciones llegarán normalmente.
- En HACS, abre el menú ⋮ (arriba a la derecha) → Repositorios personalizados;
- Añade la dirección https://github.com/eHomeLabs/NodOcean-for-HA, categoría Integración, luego Añadir;
- Busca NodOcean for HA en HACS, haz clic en Descargar, luego reinicia Home Assistant;
- Ajustes → Dispositivos y servicios → Añadir integración → NodOcean for HA. Un stick USB300 conectado suele detectarse automáticamente.
¿Tus productos ya están emparejados con otro hub? Los sensores e interruptores pueden emparejarse con varios receptores: simplemente añádelos. Para un módulo o enchufe, realiza el emparejamiento desde Home Assistant y, si falla, un restablecimiento de fábrica del producto antes de volver a intentarlo.
Un proyecto de eHome Labs, abierto y en beta
NodOcean for HA es un proyecto personal de eHome Labs. No está desarrollado por NodOn, y se distribuye como código abierto (licencia MIT) y actualmente en fase beta: cada comentario cuenta.
Para saber a quién dirigirse:
- Una pregunta sobre la integración (instalación, emparejamiento en Home Assistant, error, sugerencia): abre un issue en el repositorio de GitHub, adjuntando el archivo de diagnóstico descargable desde Home Assistant;
- Una pregunta sobre un producto NodOn (manual, cableado, restablecimiento, garantía): el soporte de NodOn sigue siendo tu punto de contacto, en support.nodon.fr.
La documentación completa (instalación, emparejamiento producto a producto, configuración, automatizaciones, preguntas frecuentes) está disponible en el wiki de NodOcean for HA, en GitHub.
En resumen
- ✔ NodOcean for HA integra los 16 productos NodOn EnOcean actuales en Home Assistant
- ✔ Elige tu producto de una lista: sin perfil EEP, sin ID, sin YAML
- ✔ La configuración de los productos (LED, estado tras corte de corriente, temporizadores, persiana…) es accesible desde Home Assistant
- ✔ Los interruptores y mandos a distancia ofrecen disparadores listos para usar en automatizaciones
- ✔ Solo necesitas un stick USB EnOcean, sin broker MQTT ni complemento
- ✔ Un puente MQTT opcional abre los productos EnOcean a otros sistemas
- ✔ Instalación vía HACS, como repositorio personalizado
Enlaces útiles
- Repositorio GitHub: https://github.com/eHomeLabs/NodOcean-for-HA
- Documentación (wiki): https://github.com/eHomeLabs/NodOcean-for-HA/wiki
- Soporte productos NodOn: support.nodon.fr
Productos citados
- SIN-2-1-01 – Módulo Multifunción EnOcean
- SIN-2-2-01 – Módulo de Iluminación ON/OFF 2 canales EnOcean
- SIN-2-FP-01 – Módulo de Calefacción Hilo Piloto EnOcean
- SIN-2-RS-01 – Módulo de Persiana Motorizada EnOcean
- ASP-2-1-00 – Enchufe Inteligente EnOcean
- MSP-2-1-01 – Micro Enchufe Inteligente + Medición EnOcean
- CWS-2-1-01 – Interruptor de Pared sin batería
- CRC-2-6-0x – Soft Remote
- CFS-2-1-05 – Interruptor de Suelo
- CCS-2-1-01 – Interruptor de Tarjeta
- TSB-2-2-02 – Soft Button
- SDO-2-1-05 – Sensor de Apertura de Puertas y Ventanas EnOcean
- SWO-2-1-00 – Sensor de Apertura Invisible sin batería EnOcean
- PIR-2-1-01 – Detector de Movimiento EnOcean
- STP-2-1-05 – Sensor de Temperatura EnOcean
- STPH-2-1-05 – Sensor de Temperatura y Humedad EnOcean
Sobre el autor – eHome Labs
Apasionado de la domótica desde hace más de 20 años, Pascal Stephany evoluciona continuamente su instalación junto con sus experimentos. Cada automatización se prueba en condiciones reales antes de adoptarla en la vida diaria, convirtiendo su hogar en un verdadero laboratorio a escala real.
Pascal STEPHANY – Product Manager NodOn
Dejar un comentario
Este sitio está protegido por hCaptcha y se aplican la Política de privacidad de hCaptcha y los Términos del servicio.