Guía de solución de problemas de emparejamiento de dispositivos Home Assistant para ZHA, HomeKit, HACS y LinknLink
Agregar un dispositivo a Home Assistant debería ser simple: descúbrelo, vincúlalo, ponle un nombre y úsalo en una automatización. En hogares reales, el emparejamiento puede fallar en muchos niveles. Se puede descubrir un dispositivo pero no exponer ninguna entidad útil. Un sensor Zigbee puede unirse a la red pero estar demasiado lejos del enrutador. Es posible que un dispositivo HomeKit aún esté bloqueado en otro controlador. Una integración HACS puede instalarse correctamente pero perder credenciales, acceso a la red o un reinicio.
Esta guía es una ruta práctica de solución de problemas para el emparejamiento de dispositivos Home Assistant en dispositivos ZHA, Zigbee2MQTT, controlador HomeKit, HACS, MQTT y LinknLink. Está escrito para hogares inteligentes locales que utilizan HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, y eHome HA.
Comience por identificar la capa de emparejamiento
La mayoría de los problemas de emparejamiento de Home Assistant no son aleatorios. Por lo general, pertenecen a una capa: transporte, descubrimiento, credenciales, mapeo de entidades o lógica de automatización. No reconstruya toda la configuración hasta que sepa qué capa está fallando.
| capa | Síntoma típico | Qué comprobar primero | Mejor siguiente acción |
|---|---|---|---|
| Transporte | El dispositivo nunca aparece | Potencia, distancia, segmento LAN, coordinador Zigbee, banda Wi-Fi. | Acerque el dispositivo, confirme la accesibilidad de la red o restablezca el modo de emparejamiento. |
| Descubrimiento | El dispositivo aparece pero no se puede agregar | Tipo de integración, modo de emparejamiento, propiedad del dispositivo, código HomeKit. | Elimínelo del controlador anterior, reinicie la integración y vuelva a intentarlo desde un estado de emparejamiento limpio. |
| Credenciales | El inicio de sesión o el token fallan | IP local, broker MQTT, configuración de integración HACS, permisos de usuario. | Vuelva a ingresar las credenciales y verifique que Home Assistant pueda llegar al punto final local. |
| Mapeo de entidades | El dispositivo se agrega pero faltan entidades | Funciones no compatibles, entidades de diagnóstico deshabilitadas, versión de integración. | Habilite entidades ocultas, actualice la integración o elija la plataforma correcta. |
| Lógica de automatización | La entidad funciona manualmente pero la automatización falla | Estado de activación, condición, modo, tiempo de reutilización, contexto de la sala. | Utilice el seguimiento de automatización y pruebe cada condición por separado. |
Solución de problemas de emparejamiento de ZHA
ZHA es la ruta Zigbee más directa en Home Assistant. Funciona bien cuando el coordinador es estable, el dispositivo está lo suficientemente cerca durante el emparejamiento y la malla tiene buenos enrutadores. Si un dispositivo Zigbee se empareja pero no está disponible, el problema suele ser la calidad de la malla y no el dispositivo en sí.
Pareja cercana al coordinador primero
Acerque el dispositivo al coordinador para la primera unión. Después de que esté estable, muévalo a la habitación final y permita que la malla se asiente.
Comprobar superposición de canales
Wi-Fi 2.4GHz y Zigbee pueden interferir. Si el emparejamiento no es confiable, mantenga el coordinador alejado del enrutador y de los puertos USB 3.0.
Utilice un dispositivo enrutador con alimentación
Los sensores de batería no se encaminan. Agregue dispositivos Zigbee con alimentación entre el coordinador y las salas distantes para mejorar la confiabilidad de la malla.
Para una ruta de coordinador dedicada, utilice ZG-808Z. Si necesita un flujo de diagnóstico Zigbee más profundo, lea el Guía de solución de problemas de Zigbee2MQTT ZG-808Z.
Solución de problemas de emparejamiento Zigbee2MQTT
Zigbee2MQTT brinda más visibilidad sobre las uniones de dispositivos, las rutas y la compatibilidad con convertidores. Es útil cuando un dispositivo se une pero expone entidades inesperadas o cuando necesita inspeccionar la calidad del enlace y el estado de la entrevista.
| Problema | donde buscar | Razón probable | Arreglar |
|---|---|---|---|
| Entrevista fallida | Interfaz Zigbee2MQTT | Señal débil, dispositivo no compatible, dispositivo abandonado en modo de emparejamiento. | Vuelva a emparejar cerca del coordinador y mantenga el dispositivo despierto. |
| Ninguna entidad Home Assistant | Descubrimiento MQTT | Descubrimiento deshabilitado o el tema no coincide. | Verifique el prefijo de descubrimiento MQTT y reinicie Home Assistant después de corregir la configuración. |
| La entidad parece no disponible | Configuración de disponibilidad | Dispositivo con batería apagada o problema de enrutamiento. | Espere el próximo informe de batería o mejore las rutas de malla. |
| Tipo de dispositivo incorrecto | Soporte de convertidor | Mapas de huellas dactilares del dispositivo para soporte parcial. | Actualice Zigbee2MQTT y consulte las notas del convertidor. |
Solución de problemas de emparejamiento del controlador HomeKit
El controlador HomeKit es potente porque muchos dispositivos HomeKit se pueden emparejar localmente con Home Assistant. El fallo más común es el de propiedad: el dispositivo todavía pertenece a otra aplicación, puente, cuenta o controlador de Home.
- Retire el dispositivo del controlador HomeKit anterior antes de emparejarlo con Home Assistant.
- Mantenga Home Assistant y el dispositivo en la misma red local durante la configuración.
- Utilice el código de emparejamiento original de HomeKit y manténgalo visible hasta que se complete la configuración.
- Apague y encienda el accesorio si aparece en el descubrimiento pero el emparejamiento nunca se completa.
Después de que funcione el emparejamiento de HomeKit, conecte la entidad a la lógica de la habitación desde la guía del panel de la sala de aplicaciones LinknLink por lo que el dispositivo es más fácil de controlar por habitación.
Solución de problemas de integración HACS
HACS no es una capa de emparejamiento de dispositivos en sí misma. Instala integraciones personalizadas. El emparejamiento aún depende de la integración, las credenciales, el acceso a la LAN, el token de nube o el puente MQTT detrás de él. Trate primero los problemas de HACS como problemas de instalación, compatibilidad y reinicio.
| Síntoma HACS | lo que significa | Arreglar |
|---|---|---|
| Integración instalada pero no visible | Home Assistant no ha recargado el componente personalizado. | Reinicie Home Assistant y borre la memoria caché del navegador. |
| El flujo de configuración falla | Las credenciales o el punto final de la red son incorrectos. | Confirme la IP local, el token, la región de la cuenta y los permisos requeridos. |
| Las entidades desaparecen después de la actualización. | Cambios importantes o entidades renombradas. | Lea las notas de la versión y actualice las automatizaciones por ID de entidad. |
| La automatización funciona solo manualmente | La entidad existe, pero las condiciones o los desencadenantes son incorrectos. | Revise los seguimientos de automatización y pruebe primero con un disparador simple. |
Comprobaciones de descubrimiento MQTT para dispositivos LinknLink
Los problemas de emparejamiento de MQTT suelen ser más fáciles de depurar que las integraciones en la nube porque cada paso es local y visible. Si un dispositivo LinknLink no aparece correctamente, verifique la conexión del agente, el tema de descubrimiento, los mensajes retenidos y la categoría de entidad.
MQTT checklist: - Confirm the LinknLink device is online - Confirm Home Assistant can reach the MQTT broker - Confirm username, password and port - Confirm discovery is enabled - Confirm the topic prefix matches Home Assistant - Restart Home Assistant only after fixing broker settings - Test one simple entity before rebuilding scenes
Para dispositivos de control remoto, utilice el Guía de control remoto Home Assistant. Para fallas del comando IR después del emparejamiento, use el Guía de solución de problemas del blaster IR.
Emparejamiento del sensor eMotion y comprobaciones de entidades
Los sensores de presencia pueden crear varios tipos de entidades: ocupación, movimiento, distancia, iluminancia, zonas, batería, temperatura o contexto de humedad según el modelo. El emparejamiento sólo es exitoso cuando las entidades útiles aparecen y se actualizan de manera confiable.
| Producto | Enfoque de emparejamiento | Entidad a verificar | Mejor caso de uso |
|---|---|---|---|
| eMotion Air | Colocación alimentada por baterías e informes de presencia local. | Presencia, batería, estado de la habitación. | Salas flexibles donde el cableado es complicado. |
| eMotion Pro | Presencia mmWave más control de ambiente IR incorporado. | Presencia, iluminancia, entidades de mando IR. | Habitaciones que necesitan detección y control de electrodomésticos. |
| eMotion Ultra | Presencia de 60GHz, IR incorporado y contexto del cable de datos de temperatura/humedad. | Presencia, zonas, IR, datos de confort. | Salas de precisión, escenas de sueño y lógica HVAC. |
Si elige entre los tres, lea el Guía de compra de eMotion Air vs Pro vs Ultra.
Comprobaciones de emparejamiento de dispositivos remotos y RF
Los dispositivos IR y RF pueden resultar confusos porque el control remoto original puede parecer similar incluso cuando el protocolo es diferente. Un ventilador puede usar RF. Un TV normalmente usa IR. Una persiana enrollable puede utilizar RF, Wi-Fi o un puente patentado. Empareje la ruta de control con el protocolo antes de escribir automatizaciones.
- uso eRemote HA para escenas IR locales.
- uso eHome HA cuando el control RF es parte de la habitación.
- uso eMotion Pro o eMotion Ultra cuando la presencia y el IR deberían convivir.
Para comparar el concentrador RF, lea el Guía eHome HA vs. Puente Bond.
Utilice HomeClaw como capa de recuperación local
Cuando un dispositivo está emparejado pero no es confiable, la capa de puerta de enlace es importante. HomeClaw puede mantener la lógica Home Assistant local, coordinar los paneles de la sala y ayudar a organizar los estados de los dispositivos en automatizaciones que sean más fáciles de depurar.
Para la aplicación y la estructura de control de la sala, lea la Guía de automatización de la aplicación LinknLink y el guía del tablero de la habitación.
Tabla de decisiones sobre resolución de problemas de emparejamiento
| si esto sucede | haz esto primero | Entonces usa esta ruta LinknLink |
|---|---|---|
| El sensor Zigbee se une pero se desconecta | Acérquelo, verifique los dispositivos del enrutador, inspeccione LQI. | ZG-808Z más la guía de solución de problemas Zigbee2MQTT. |
| El dispositivo HomeKit rechaza el emparejamiento | Retírelo del controlador anterior y reinicie el emparejamiento. | Flujo de trabajo HomeClaw local Home Assistant. |
| La entidad de presencia existe pero las automatizaciones fallan | Verifique el seguimiento de la automatización y los cambios de estado de la entidad. | eMotion Air, Pro o Ultra con ayudantes del modo habitación. |
| La entidad de comando IR/RF existe pero el dispositivo no responde | Consulta protocolo, colocación y comando aprendido. | eRemote HA para IR o eHome HA para RF/IR. |
| La integración personalizada se instala pero no crea entidades | Reinicie Home Assistant e inspeccione los registros de flujo de configuración. | Solución de problemas locales de HomeClaw más guías canónicas. |
Guías relacionadas y productos populares
Utilice estos enlaces de artículos y productos canónicos para pasar del emparejamiento a la automatización local estable.
Productos calientes
HomeClaw, ZG-808Z, eMotion Air, eMotion Pro, eMotion Ultra, eRemote HA, eHome HA.
Emparejamiento e integraciones
Solución de problemas de Zigbee2MQTT, Las mejores integraciones de Home Assistant, Guía de puerta de enlace Raspberry Pi vs HomeClaw.
Presencia y mandos a distancia
Los mejores sensores de presencia mmWave, guía de control remoto, Guía de solución de problemas de IR.
Arregla la capa de emparejamiento antes de reconstruir la automatización.
Las automatizaciones confiables de Home Assistant comienzan con entidades confiables. Confirme el transporte, el descubrimiento, las credenciales y el mapeo de entidades antes de agregar escenas, paneles de sala o conversaciones de Agent+.
Preguntas frecuentes
¿Por qué Home Assistant descubre un dispositivo pero no crea las entidades correctas?
El descubrimiento y la creación de entidades son pasos separados. Verifique el tipo de integración, los permisos del dispositivo, el tema MQTT, el estado del coordinador y si la integración expone la función como un sensor, interruptor, botón, entidad climática o entidad de diagnóstico.
¿Debo emparejar dispositivos Zigbee a través de ZHA o Zigbee2MQTT?
Utilice ZHA cuando desee una configuración Home Assistant nativa más sencilla. Utilice Zigbee2MQTT cuando necesite soporte de dispositivo más amplio, más diagnósticos y control preciso sobre el enrutamiento Zigbee a través de un coordinador como ZG-808Z.
¿Se pueden agregar dispositivos HomeKit a Home Assistant localmente?
Sí. Se pueden agregar muchos dispositivos HomeKit a través de la integración del controlador HomeKit. Mantenga el dispositivo en la misma red local, retírelo del controlador anterior si es necesario y use el código de emparejamiento durante la configuración.
¿Qué debo comprobar cuando los dispositivos LinknLink no aparecen en Home Assistant?
Confirme que el dispositivo esté en línea, que el acceso a la red local esté disponible, que MQTT o las credenciales de integración sean correctas y que la instancia Home Assistant pueda alcanzar el mismo segmento de LAN que el dispositivo LinknLink.
¿Qué productos LinknLink ayudan con el emparejamiento y el control local del Home Assistant?
Utilice HomeClaw como puerta de enlace Home Assistant local, ZG-808Z para coordinación Zigbee, sensores eMotion para automatización de presencia, eRemote HA para control local IR y eHome HA para flujos de trabajo remotos RF y IR.