La forma de integrar dispositivos Aqara depende del modelo y del concentrador disponible. Revise primero si el producto lleva las marcas Matter, HomeKit o Zigbee. No todos los dispositivos Zigbee necesitan un hub Aqara; para conectarlos directamente a Home Assistant sí necesita un coordinador Zigbee compatible.
Opción A: Matter o puente Matter
Si el equipo o hub Aqara admite Matter, configure la integración Matter en Home Assistant. Active el modo de vinculación Matter en el aparato o en la aplicación Aqara y use el código mostrado en la aplicación complementaria Home Assistant. Si el dispositivo Matter ya está en Casa de Apple, puede compartirlo con Home Assistant como segundo controlador cuando sea compatible. Un puente Matter puede exponer dispositivos Zigbee dependientes, aunque no necesariamente todos ni todas sus funciones.
Opción B: hub compatible con HomeKit
Si el hub ofrece HomeKit pero no el puente Matter adecuado, pruebe « HomeKit Device ». Configure el hub con la aplicación del fabricante y guarde el código HomeKit. Home Assistant solo detecta accesorios HomeKit que no estén vinculados a otro controlador. Si ya pertenece a Casa de Apple, quizá deba eliminar esa vinculación; antes revise el efecto en sus aparatos y automatizaciones. Después, en « Ajustes » → « Dispositivos y servicios », configure el hub detectado con el código.
Opción C: Zigbee sin hub Aqara
Conecte un coordinador Zigbee compatible y configure ZHA o Zigbee2MQTT. Active la vinculación y ponga el sensor Aqara en modo de emparejamiento siguiendo su manual. Un dispositivo Zigbee solo puede pertenecer a una red a la vez; al cambiar desde el hub Aqara suele hacer falta restablecerlo. Compruebe modelo y cobertura. Algunos sensores Aqara no funcionan bien con ciertos routers Zigbee de otras marcas.
Tras la configuración
Revise batería, valores y controles en Home Assistant. Cree primero una automatización sencilla, como un aviso al abrir una puerta. Anote el método utilizado y los nombres de entidades antes de trasladar equipos entre hubs o redes Zigbee.
Fuentes: https://www.home-assistant.io/integrations/aqara/, https://www.home-assistant.io/integrations/matter/, https://www.home-assistant.io/integrations/homekit_controller/ y https://www.home-assistant.io/integrations/zha/.