Integración Aqara Display Switch Z2M
Índice
Integración del Aqara Display Switch con Zigbee2MQTT: Guía Completa
El Aqara Display Switch V1 EU, identificado por su modelo WS-K02D y el código lumi.switch.aeu001, se presenta como una solución versátil para la automatización del hogar inteligente. Su integración con Zigbee2MQTT (Z2M) abre un abanico de posibilidades para personalizar la experiencia del usuario, desde el control de dispositivos hasta la visualización de información relevante en su pantalla integrada.
Entendiendo la Arquitectura de Integración
La configuración de dispositivos como el Aqara Display Switch en Zigbee2MQTT se basa en el concepto de “External Converters”. Estos archivos de código JavaScript actúan como traductores, permitiendo a Z2M interpretar y controlar las funcionalidades específicas del dispositivo que no son estándar en Zigbee.
El Papel del Código de Conversión Externa
El código proporcionado define cómo Zigbee2MQTT interactúa con el Aqara Display Switch. Se centra en:
- Mapeo de Atributos: Traduce los comandos y datos del dispositivo Zigbee a entidades comprensibles por Z2M y, por extensión, por plataformas de domótica como Home Assistant.
- Control de Funciones Específicas: Permite gestionar ajustes de pantalla, modos de visualización, colores de botones, y la presentación de información meteorológica o datos de sensores.
- Gestión de Eventos: Interpreta las acciones del usuario en el dispositivo, como pulsaciones de botones, y las comunica al sistema domótico.
Funcionalidades Clave del Aqara Display Switch V1 EU en Z2M
La potencia de este convertidor externo radica en su capacidad para exponer y controlar una gran cantidad de características del dispositivo. A continuación, detallamos las funcionalidades más destacadas:
Control de Pantalla y Visualización
El Aqara Display Switch permite una personalización avanzada de su interfaz visual:
- Tema de Pantalla: Seleccione entre diferentes temas de diseño para la interfaz.
- Modo de Visualización: Configure si los botones deben mostrar solo iconos, solo texto, o una combinación de ambos.
- Brillo de Pantalla: Ajuste el brillo general de la pantalla LCD para una visibilidad óptima en diversas condiciones de iluminación.
- Brillo en Reposo: Controle el brillo de la pantalla cuando el dispositivo está en modo de espera.
- Tiempo de Reposo: Defina cuánto tiempo tarda la pantalla en atenuarse o apagarse después de un período de inactividad.
- Salvapantallas: Active y configure el salvapantallas, permitiendo la visualización de la hora, el estado del tiempo o datos de sensores internos.
- Estilo del Salvapantallas: Elija entre un reloj digital, condiciones meteorológicas o el entorno interior como contenido del salvapantallas.
- Tamaño de Fuente: Ajuste el tamaño del texto en la pantalla para mejorar la legibilidad.
- Color de Botón: Personalice el color de los botones de la interfaz mediante la especificación de los componentes RGB.
Gestión de Botones y Acciones
El dispositivo cuenta con múltiples botones (hasta 4), cada uno configurable:
- Función de Botón: Asigne a cada botón una función específica, ya sea como interruptor (controlando otros dispositivos) o como botón de acción simple.
- Nombres Personalizados: Asigne nombres descriptivos a los interruptores y botones para una fácil identificación en la interfaz domótica.
- Iconos Personalizados: Seleccione iconos de una amplia biblioteca para representar visualmente cada interruptor o botón, mejorando la experiencia de usuario.
Integración de Sensores y Datos Meteorológicos
El Aqara Display Switch puede actuar como un centro de información ambiental:
- Condiciones Meteorológicas: Muestre información detallada del tiempo, incluyendo iconos y descripciones como “soleado”, “lluvia” o “nublado”.
- Temperatura Meteorológica: Visualice la temperatura exterior pronosticada.
- Humedad Meteorológica: Muestre la humedad exterior pronosticada.
- Temperatura Interior: Integre un sensor de temperatura para mostrar las condiciones ambientales del hogar.
- Humedad Interior: Integre un sensor de humedad para monitorizar las condiciones interiores.
Configuraciones Avanzadas del Dispositivo
Otras funcionalidades importantes incluyen:
- Activación por Proximidad: Configure el dispositivo para que la pantalla se active al detectar movimiento cercano.
- Sensibilidad de Proximidad: Ajuste la distancia a la que el sensor de proximidad se activa.
- Anulación por Doble Toque: Habilite la opción de que un doble toque en un interruptor active o desactive de forma predeterminada un dispositivo o escena.
Monitorización de Energía
El dispositivo también ofrece capacidades de monitorización de energía:
- Potencia Consumida: Visualice la potencia eléctrica actual en vatios.
- Corriente Eléctrica: Monitorice la corriente en amperios.
- Energía Consumida: Registre el consumo total de energía en kilovatios-hora (kWh).
Configuración e Implementación en Zigbee2MQTT
La integración de este dispositivo requiere la colocación del archivo de código del convertidor externo en el directorio correspondiente de su instalación de Zigbee2MQTT.
Ubicación del Archivo del Convertidor
Generalmente, los convertidores externos se ubican en una carpeta específica dentro de la estructura de directorios de Zigbee2MQTT, a menudo etiquetada como custom_converters o similar. Debe asegurarse de que el archivo aqara_display_switch_v1_eu.js (o el nombre que le haya asignado) se encuentre en la ruta correcta.
Registro y Reinicio de Zigbee2MQTT
Una vez que el archivo del convertidor esté en su lugar, deberá reiniciar el servicio de Zigbee2MQTT para que los cambios surtan efecto. Al reiniciar, Z2M cargará el nuevo convertidor y, tras el emparejamiento del Aqara Display Switch, las funcionalidades descritas estarán disponibles.
Exposición de Entidades en Home Assistant (u otra Plataforma)
Tras una configuración exitosa, Zigbee2MQTT expondrá una serie de entidades en su plataforma domótica (como Home Assistant) que corresponden a las funcionalidades del Aqara Display Switch. Estas entidades le permitirán:
- Leer el estado actual de los interruptores y botones.
- Enviar comandos para activar o desactivar los interruptores.
- Configurar los ajustes de pantalla, botones, y sensores.
- Visualizar datos de monitorización de energía.
- Gestionar acciones de botones como pulsaciones únicas.
La flexibilidad de este convertidor permite una personalización profunda, transformando el Aqara Display Switch V1 EU en un componente central y altamente interactivo de su sistema de hogar inteligente.
