Xiaomi Gateway: Tu Centro de Control Domótico

En el mundo de la domótica, tener un centro de control fiable es fundamental para que todos tus dispositivos 'inteligentes' se comuniquen entre sí y funcionen de manera armoniosa. Aquí es donde entra en juego el Xiaomi Gateway, particularmente la versión Aqara, que se ha convertido en una pieza clave para muchos entusiastas del hogar inteligente, especialmente aquellos que utilizan plataformas como Home Assistant.

Pero, ¿qué es exactamente este dispositivo y por qué es tan importante? El Xiaomi Gateway, también conocido como Xiaomi Mi Smart Home Hub, es esencialmente el cerebro de tu red de dispositivos inteligentes Xiaomi y Aqara. Actúa como un puente, permitiendo que dispositivos que utilizan diferentes protocolos de comunicación, como Zigbee y Bluetooth, se conecten a tu red Wi-Fi doméstica. Esto te permite controlarlos a través de una aplicación móvil, crear escenas automatizadas y, lo que es más emocionante para muchos, integrarlos en sistemas de automatización más avanzados como Home Assistant.

La capacidad de este hub para soportar múltiples protocolos (Wi-Fi IEEE 802.11 b/g/n 2.4 GHz, Zigbee 3.0 y Bluetooth 5.0) es una de sus mayores fortalezas. Esto significa que puedes conectar una amplia gama de sensores, interruptores, bombillas y otros dispositivos de las marcas Xiaomi y Aqara a un único punto central, simplificando la gestión de tu hogar inteligente. Además, el Mi Smart Home Hub cuenta con antenas Wi-Fi duales integradas para una conexión inalámbrica mejorada y, en algunas versiones, soporte para Apple Homekit, añadiendo versatilidad.

Integración del Xiaomi Gateway (Aqara) con Home Assistant

Para los usuarios de Home Assistant, el Xiaomi Gateway (Aqara) abre un mundo de posibilidades al permitir la integración de una gran cantidad de dispositivos compatibles. La integración específica para esta versión del gateway facilita que Home Assistant detecte y controle estos dispositivos, así como que reciba eventos de ellos.

Es importante notar que existen diferentes versiones del hub. La versión v1 generalmente se integra con Home Assistant sin mayores complicaciones. Sin embargo, la versión v2 puede requerir pasos adicionales para habilitar la API local, incluso pudiendo necesitar intervenciones físicas en el dispositivo, aunque Xiaomi ha indicado que esto podría cambiar en futuras actualizaciones de firmware. Si tienes la versión v2 y experimentas problemas, la sección de resolución de problemas puede ofrecerte soluciones.

Dispositivos Compatibles y No Compatibles

La compatibilidad es clave al construir un ecosistema de hogar inteligente. El Xiaomi Gateway (Aqara), a través de su integración con Home Assistant, soporta una amplia gama de dispositivos, permitiéndote monitorizar y controlar diversas funciones de tu hogar. Aquí hay una lista basada en la información proporcionada:

Esta tabla te da una idea clara de qué dispositivos podrás integrar en tu sistema basado en Home Assistant a través del Xiaomi Gateway (Aqara). Es crucial verificar la compatibilidad antes de adquirir nuevos dispositivos si tu objetivo es utilizarlos con este hub y Home Assistant.

Configuración y Puesta en Marcha

Para comenzar a utilizar tu Xiaomi Gateway (Aqara) e integrarlo con Home Assistant, primero debes configurarlo utilizando la aplicación Mi Home en tu smartphone. Este es el paso inicial donde el gateway se conecta a tu red Wi-Fi y se vincula a tu cuenta Xiaomi.

Durante el proceso de configuración inicial con la app Mi Home, deberás habilitar el 'Modo Desarrollador' o 'Acceso LAN' (la terminología puede variar ligeramente entre versiones de la app y firmware). Este paso es fundamental, ya que permite que Home Assistant se comunique localmente con el gateway sin depender de los servidores en la nube de Xiaomi. Un paso crítico aquí es la obtención de la 'clave' o 'contraseña' del gateway, la cual es necesaria para la integración con Home Assistant. Existe un tutorial específico para recuperar esta clave desde la aplicación Mi Home.

Una vez que el gateway está configurado en la app Mi Home y tienes la clave, la integración con Home Assistant es relativamente sencilla. Si tu instancia de Home Assistant está en la misma red local, debería descubrir automáticamente el gateway y mostrarlo en la sección 'Configuración > Dispositivos y servicios'. Simplemente haz clic en 'Configurar' y sigue los pasos, introduciendo la clave obtenida previamente si es necesario. Si el gateway no aparece automáticamente, puedes añadirlo manualmente haciendo clic en el icono '+' y buscando la integración 'Xiaomi Aqara'. Puedes configurar múltiples gateways repitiendo este proceso.

La configuración en Home Assistant permite especificar algunas variables opcionales, como la interfaz de red a usar, la clave del gateway (opcional si solo usas sensores binarios) y un nombre para el gateway.

Entidades y Control en Home Assistant

Una vez integrado, el Xiaomi Gateway (Aqara) expone diferentes tipos de entidades en Home Assistant para interactuar con los dispositivos conectados. Estas entidades representan las funcionalidades específicas de cada dispositivo.

Covers (Cortinas/Persianas)

Si tienes cortinas o persianas inteligentes Aqara compatibles, Home Assistant las representará como entidades de tipo 'Cover'. Esto te permite:

• Abrir la cubierta.
• Cerrar la cubierta.
• Detener el movimiento.
• Mover la cubierta a una posición específica (por ejemplo, 50% abierta).
• Ver la posición actual de la cubierta.

Esto es ideal para automatizaciones basadas en la hora del día o la intensidad de la luz solar.

Lights (Luces)

El propio gateway tiene una luz integrada que puede ser controlada a través de Home Assistant. Esta luz se expone como una entidad de tipo 'Light'. Puedes:

• Encender y apagar la luz del gateway.
• Ajustar el brillo.
• Establecer el color utilizando códigos de color HS o RGB.

Esta luz puede servir como indicador visual para diferentes eventos o alarmas.

Locks (Cerraduras)

Aunque la integración no permite controlar directamente las cerraduras inteligentes Aqara (como abrir o cerrar), sí expone información útil como una entidad de tipo 'Lock'. Puedes ver:

• Quién (qué usuario o llave) realizó el último desbloqueo exitoso (`changed_by`).
• Cuántos intentos fallidos de desbloqueo ha habido desde el último desbloqueo exitoso (`verified_wrong_times`).

Esta información es valiosa para la seguridad y el monitoreo.

Binary Sensors (Sensores Binarios)

Los sensores binarios son dispositivos que reportan un estado de 'encendido' o 'apagado' (o eventos específicos). El Xiaomi Gateway soporta una amplia variedad de estos sensores, que son fundamentales para la automatización:

• Sensor de Movimiento (1ª y 2ª Gen): Reporta 'on'/'off' cuando detecta movimiento. Genera un evento `xiaomi_aqara.motion`.
• Sensor de Puerta y Ventana (1ª y 2ª Gen): Reporta 'on'/'off' según si la puerta/ventana está abierta o cerrada.
• Detector de Humo: Reporta 'on' cuando detecta humo (alarma).
• Detector de Fugas de Gas: Reporta 'on' cuando detecta gas (alarma), también reporta la densidad.
• Sensor de Fugas de Agua: Reporta 'on' cuando detecta agua.
• Botón Inalámbrico (1ª y 2ª Gen): Estos son muy versátiles. No solo reportan un estado, sino que generan eventos diferentes según cómo se presionen (clic simple, doble clic, mantener presionado, etc.). Los modelos Aqara pueden generar eventos como `single`, `double`, `long_click_press`, `hold`, `shake`. El modelo cuadrado WXKG12LM incluso soporta el evento `shake`.
• Cubo Aqara: Un dispositivo único que genera eventos basados en su manipulación física (girar 90°, girar 180°, moverse, tocar dos veces, agitar, etc.). Los eventos pueden ser `flip90`, `flip180`, `move`, `tap_twice`, `shake_air`, `swing`, `alert`, `free_fall`, y `rotate` (con un valor de grados).
• Sensor de Vibración: Genera eventos como `vibrate`, `tilt`, `free_fall`.

La riqueza de eventos que reportan estos sensores, especialmente los botones y el cubo, permite crear automatizaciones complejas y personalizadas.

Sensors (Sensores)

Además de los binarios, el gateway soporta sensores que reportan valores numéricos o estados más complejos:

• Nivel de batería (en porcentaje).
• Actividad de cama / vibración (en micrómetros).
• Coordinación.
• Humedad (en porcentaje).
• Iluminación (en lux).
• Energía consumida (en kWh).
• Carga de energía (en Watt).
• Presión (en hPa).
• Temperatura (en Celsius o Fahrenheit, según la configuración de Home Assistant).
• Ángulo de inclinación.

Estos sensores te permiten monitorizar las condiciones ambientales, el uso de energía y el estado de tus dispositivos con gran detalle.

Switches (Interruptores)

Las entidades tipo 'Switch' en Home Assistant permiten no solo ver el estado de los interruptores de pared Aqara y otros dispositivos conmutables, sino también cambiarlos (encender/apagar). Esto integra tus interruptores físicos en el sistema de automatización, permitiendo controlarlos remotamente o como parte de escenas.

Acciones Disponibles del Gateway

El propio Xiaomi Gateway ofrece algunas acciones que pueden ser invocadas desde Home Assistant, añadiendo otra capa de interactividad a tu sistema:

• xiaomi_aqara.play_ringtone: Permite reproducir un timbre o sonido específico a través del altavoz del gateway. Requiere una versión de firmware 1.4.1_145 o superior. Debes especificar la dirección MAC del gateway, el ID del timbre y, opcionalmente, el volumen (0-100%). Hay IDs predefinidos para alarmas (Policía, Accidente, etc.), timbres de puerta (Doorbell, Knock) y despertadores (MiMix, Enthusiastic, etc.), además de timbres personalizados a partir del ID 10001.
• xiaomi_aqara.stop_ringtone: Detiene inmediatamente cualquier timbre que se esté reproduciendo en el gateway.
• xiaomi_aqara.add_device: Habilita el permiso de emparejamiento en el gateway durante 30 segundos. Durante este tiempo, puedes añadir un nuevo dispositivo Aqara/Xiaomi presionando su botón de emparejamiento.
• xiaomi_aqara.remove_device: Permite eliminar un dispositivo específico del gateway, lo cual es necesario si deseas emparejarlo con otro gateway. Debes proporcionar la dirección MAC del gateway y el ID de hardware del dispositivo a eliminar.

Estas acciones son muy útiles para notificaciones audibles (como una alarma de humo o gas), confirmaciones de acciones o para gestionar tu red de dispositivos Zigbee directamente desde Home Assistant.

Ejemplos Prácticos de Automatización

La verdadera potencia del Xiaomi Gateway con Home Assistant reside en la capacidad de crear automatizaciones que reaccionen a los estados y eventos de los dispositivos conectados. Aquí algunos ejemplos conceptuales basados en la información proporcionada:

• Iluminación Activada por Movimiento: Utiliza un sensor de movimiento (Sensor de Movimiento 1ª/2ª Gen) para encender una luz (quizás la luz del propio gateway o cualquier otra luz integrada en Home Assistant) cuando se detecta movimiento, pero solo si el nivel de iluminación (detectado por el sensor de iluminación del gateway) es bajo. Puedes apagar la luz después de un período sin movimiento.
• Control de Climatización con Sensor de Ventana: Si tienes un termostato o climatizador integrado en Home Assistant, puedes usar un sensor de puerta/ventana para apagar la calefacción o el aire acondicionado cuando se abre una ventana y volver a encenderlo después de que la ventana haya estado cerrada por un tiempo.
• Notificaciones de Seguridad: Configura una automatización para que te envíe una notificación al móvil si se abre una puerta o ventana (usando el sensor correspondiente) cuando Home Assistant detecta que no hay nadie en casa (basado, por ejemplo, en la ubicación de los miembros de la familia).
• Alarmas Sonoras: Utiliza los detectores de humo o gas. Cuando detecten una alarma ('on'), haz que Home Assistant envíe una notificación visual y reproduzca un timbre de alarma fuerte en el gateway usando la acción xiaomi_aqara.play_ringtone.
• Control con Botones Inalámbricos: Asigna diferentes acciones a los clics simples, dobles o largos de un botón inalámbrico. Por ejemplo, un clic simple puede encender/apagar una luz, un doble clic puede alternar entre escenas de iluminación y mantener presionado puede reproducir un sonido específico en el gateway (como el ladrido de perro para disuadir).
• Automatizaciones con el Cubo: El Cubo Aqara permite interacciones muy creativas. Girarlo podría ajustar el brillo de una luz, agitarlo podría activar o desactivar una alarma, o moverlo podría cambiar el color de una luz.
• Control de Brillo con Interruptores de Pared: Con interruptores de pared Aqara de doble tecla, puedes asignar una tecla para aumentar el brillo de una luz y la otra para disminuirlo, mientras que presionar ambas teclas apaga la luz.
• Acciones Basadas en Vibración: Un sensor de vibración en una puerta o ventana podría activar una alarma o una luz si detecta vibración (como un intento de forzar la entrada) o inclinación.

Estos ejemplos ilustran cómo la combinación de los sensores, entidades y acciones expuestas por el Xiaomi Gateway en Home Assistant permite construir un hogar verdaderamente inteligente y reactivo.

Resolución de Problemas Comunes

Aunque la integración del Xiaomi Gateway (Aqara) con Home Assistant es potente, a veces pueden surgir problemas durante la configuración o el uso. Aquí se presentan algunas soluciones a inconvenientes frecuentes:

• Problemas en la Configuración Inicial con la App Mi Home: Si tienes dificultades para configurar el gateway con la aplicación Mi Home, intenta usar un smartphone diferente. Algunos usuarios han reportado éxito cambiando de dispositivo.
• Problemas de Conexión / Gateway No Descubierto: Si Home Assistant no detecta el gateway o muestra errores de conexión, verifica lo siguiente:
  • Asegúrate de haber habilitado el 'Acceso LAN' o 'Modo Desarrollador' en la configuración del gateway dentro de la app Mi Home.
  • Verifica la configuración del cortafuegos (firewall) en el sistema donde se ejecuta Home Assistant. Intenta desactivarlo temporalmente para descartar que esté bloqueando la comunicación.
  • Confirma que tu router soporta multicast, ya que es un requisito para la comunicación local con el gateway. Algunos routers requieren habilitar esta función.
  • Intenta deshabilitar y volver a habilitar el 'Acceso LAN' en la app Mi Home.
  • Realiza un restablecimiento de fábrica del gateway (manteniendo presionado el botón durante 30 segundos) y configúralo de nuevo desde cero.
  • Si usas Home Assistant en Docker, asegúrate de ejecutarlo con la opción --net=host para permitir la comunicación de red adecuada.
• Error "Invalid key": Si recibes este error al intentar controlar la luz del gateway, la clave obtenida de la app Mi Home es incorrecta. Intenta generar la clave de nuevo, preferiblemente usando un teléfono Android o un emulador como Bluestacks, ya que a veces hay problemas al obtener la clave desde la aplicación de iOS. Asegúrate de que tu red soporte multicast. Si usas Home Assistant en una máquina virtual (como Proxmox), puede ser necesario ejecutar echo 0 >/sys/class/net/vmbr0/bridge/multicast_snooping (adaptando la interfaz de red) en el host y reiniciar el servicio o el host.
• Problemas con la Instalación de Librerías: Si la librería necesaria "PyXiaomiGateway" no se instala correctamente, puede que falten dependencias del sistema. Instala manualmente los paquetes necesarios como python3-dev, libssl-dev, libffi-dev (usando el gestor de paquetes de tu sistema, por ejemplo, sudo apt-get install ... en sistemas basados en Debian/Ubuntu).
• Gateway con MAC 04:CF:8C o 7C:49:EB: Algunos gateways con estas direcciones MAC pueden tener el puerto 9898 cerrado por defecto, lo que impide la comunicación local. La información proporcionada sugiere que existen soluciones, pero a menudo requieren modificaciones físicas y trabajos con componentes eléctricos, lo cual no es recomendable a menos que tengas experiencia.

Preguntas Frecuentes sobre el Xiaomi Gateway (Aqara)

Aquí respondemos algunas preguntas comunes basadas en la información disponible:

¿Qué protocolos de comunicación soporta el Xiaomi Gateway?
Soporta Wi-Fi (2.4 GHz), Zigbee 3.0 y Bluetooth 5.0.

¿Puedo controlar mis dispositivos Xiaomi/Aqara solo con la aplicación Mi Home?
Sí, el gateway funciona como centro de control para la app Mi Home, permitiendo control remoto y automatizaciones básicas.

¿Es necesario el Xiaomi Gateway para usar dispositivos Aqara con Home Assistant?
Generalmente sí, para dispositivos Zigbee y Bluetooth de Xiaomi/Aqara, el gateway actúa como coordinador Zigbee/Bluetooth para la integración local con Home Assistant (cuando la API local está habilitada).

¿Hay alguna diferencia entre el Gateway v1 y v2 para Home Assistant?
Sí, la versión v1 suele ser más fácil de integrar, mientras que la v2 puede requerir pasos adicionales y, en algunos casos, modificaciones para habilitar la API local.

¿Cómo obtengo la clave del gateway para Home Assistant?
La clave se obtiene a través de la aplicación Mi Home, siguiendo un tutorial específico para acceder a la información del gateway. Se recomienda usar un dispositivo Android para este proceso.

¿Qué tipos de dispositivos puedo conectar al gateway?
Una amplia variedad, incluyendo sensores de movimiento, puerta/ventana, temperatura/humedad, fugas, detectores de humo/gas, botones, interruptores de pared, enchufes, cerraduras (para monitoreo), cortinas, y el Cubo Aqara. Consulta la lista de dispositivos compatibles.

¿Puedo reproducir mis propios sonidos en el gateway?
La información indica soporte para timbres personalizados a partir del ID 10001, que se suben a través de la app Mi Home.

¿Qué hago si mi gateway no es detectado por Home Assistant?
Verifica el 'Acceso LAN' en la app Mi Home, el cortafuegos, el soporte de multicast en tu router, y considera un restablecimiento de fábrica si es necesario. Asegúrate también de que Home Assistant se ejecuta correctamente en tu red local.

¿Por qué un botón inalámbrico puede generar diferentes eventos (clic simple, doble, mantener)?
Estos botones están diseñados para ser multifuncionales. La forma en que los presionas (rapidez, duración) determina el evento que reportan, permitiendo controlar múltiples funciones con un solo botón físico.

¿Es seguro habilitar el 'Acceso LAN' en el gateway?
Habilitar el acceso LAN permite la comunicación local sin depender de la nube, lo cual es preferido por muchos por privacidad y fiabilidad. Sin embargo, como con cualquier dispositivo conectado a tu red, es importante asegurar tu red Wi-Fi con una contraseña fuerte.

Conclusión

El Xiaomi Gateway (Aqara) es un componente esencial para quienes buscan construir un hogar inteligente versátil y potente, especialmente al combinarlo con una plataforma de automatización como Home Assistant. Su capacidad para unir dispositivos que usan diferentes protocolos bajo un mismo techo, junto con la rica información y las acciones que expone, permite crear automatizaciones sofisticadas que mejoran la comodidad, la seguridad y la eficiencia energética de tu hogar. Si bien pueden surgir desafíos de configuración, las soluciones están bien documentadas y, una vez superados, el potencial para transformar tu espacio vital es inmenso. Es una inversión sólida para un ecosistema de hogar inteligente integrado y personalizable.

Si quieres conocer otros artículos parecidos a Xiaomi Gateway: Tu Centro de Control Domótico puedes visitar la categoría Radio.