La configuración de Matter puede parecer simple hasta que un dispositivo está visible en una aplicación pero no está disponible en otra. La causa puede ser el código de puesta en servicio, el controlador, la ruta Thread o Wi-Fi, el comportamiento de IPv6 o un puente que no ha completado su intercambio de estado local.
Esta guía utiliza un flujo de trabajo capa por capa para la configuración del puente Home Assistant Matter. Mantiene la primera prueba pequeña, separa emparejamiento desde la automatización y muestra dónde pueden caber las puertas de enlace, sensores y dispositivos de control LinknLink después de que la ruta Matter sea estable.
Qué hace un puente Matter en Home Assistant
Puesta en marcha
Utilice el código QR o numérico correcto y el controlador previsto.
Ruta de red
Verifique la accesibilidad local, el comportamiento de Thread o Wi-Fi y los cambios de dirección.
Prueba de automatización
Verificar una entidad y una acción reversible antes de ampliar el puente.
Un puente Matter conecta dispositivos Matter compatibles o tipos de dispositivos en puente a un controlador de hogar inteligente. Home Assistant proporciona el entorno de integración y automatización, mientras que el puente y la red local determinan si la puesta en servicio, las actualizaciones de estado y los comandos de control se pueden completar de manera confiable.
Antes de comenzar
- Confirme que el dispositivo Matter, el puente y el controlador Home Assistant sean compatibles juntos.
- Registre si el dispositivo utiliza Wi-Fi, Thread o una ruta de transporte en puente.
- Mantenga el dispositivo, el controlador y el teléfono en la red local prevista durante la puesta en marcha.
- Mantenga disponible el código QR o el código de configuración numérico y evite reutilizar un registro de emparejamiento antiguo.
- Cree una nota de copia de seguridad o recuperación antes de eliminar una estructura existente o restablecer un dispositivo.
- Elija una acción de prueba de bajo impacto, como un cambio de estado de luz, después de que se complete el emparejamiento.
Verificar un puente Matter una capa a la vez
1. Identifique el rol Matter
Decida si el dispositivo es un dispositivo nativo Matter, un punto final de puente o una ruta de controlador.
2. Confirmar el transporte
Anota si el dispositivo utiliza Wi-Fi, Thread u otra ruta local compatible.
3. Verifique el controlador
Confirme que la integración Home Assistant Matter y los servicios locales requeridos se estén ejecutando.
4. Prepara la red
Mantenga la coherencia de IPv6, multidifusión, descubrimiento local y comportamiento del enrutador durante la configuración.
5. Comience a poner en marcha
Utilice el código QR o numérico deseado y primero agregue el dispositivo a un controlador.
6. Espere el descubrimiento del estado
Permita que el puente exponga entidades antes de cambiar nombres, áreas o automatizaciones.
7. Verificar los detalles de la entidad
Verifique el nombre del dispositivo, el área, los datos del fabricante y las actualizaciones de estado en Home Assistant.
8. Pruebe el control local
Ejecute un comando reversible mientras el teléfono o la conexión a la nube no sean parte de la prueba.
9. Agregar contexto de sala
Utilice entidades climáticas o de presencia LinknLink solo después de que el estado Matter sea estable.
10. Recuperación de documentos
Registre la estructura, el controlador, la ruta de reinicio y el control manual antes de emparejar más dispositivos.
Mensajes de ejemplo y qué revisar
| Caso de uso | Solicitud de ejemplo | Revisar antes de actuar |
|---|---|---|
| Primera prueba de luz | Empareje esta luz Matter y muéstreme su entidad Home Assistant antes de cambiar cualquier escena. | Resultado de la puesta en servicio, ID de entidad, área y estado actual |
| Verificación de red | El dispositivo Matter está emparejado pero no está disponible después de reiniciar el enrutador. Enumere las comprobaciones de la red local antes de restablecerla. | Transporte, dirección, IPv6, multidifusión y estado del controlador |
| Límite del hilo | Explique qué estado del enrutador de borde de Thread se debe verificar antes de volver a emparejar este dispositivo. | Ruta del enrutador fronterizo, estructura y registros de puesta en servicio duplicados |
| Punto final del puente | Muestre qué punto final puenteado cambió de estado y prepare una acción de prueba reversible. | Identidad de punto final, transición de estado y acción de destino |
| Contexto de presencia | Cuando la habitación esté ocupada, prepare una acción de luz Matter pero muéstrela antes de ejecutarla. | Entidad de presencia, entidad Matter, retraso y aprobación |
| Nota de recuperación | Cree una breve lista de verificación de recuperación de Matter sin eliminar el emparejamiento actual. | Copia de seguridad, instrucciones de reinicio, controlador y respaldo manual |
Utilice las etapas de lectura, preparación, aprobación y ejecución
| etapa | Tarea del agente | control de usuario |
|---|---|---|
| leer | Inspeccione sólo la fuente permitida. | Elija la aplicación, rango de fechas, sala, carpeta o cuenta. |
| preparar | Extraiga entidades y cree un borrador o plan propuesto. | Consultar supuestos, información faltante y recursos afectados. |
| Aprobar | Presentar la acción y el destino. | Confirmar o revisar antes de la ejecución. |
| ejecutar | Ejecute la acción admitida después de la aprobación. | Verifique el resultado y mantenga una ruta de reversión cuando sea posible. |
Revisar la lista de verificación
- ¿Está el dispositivo emparejado con el tejido y el controlador Matter previstos?
- ¿El transporte coincide con la documentación del dispositivo y el diseño de la red local?
- ¿Están el dispositivo, el puente y el controlador Home Assistant en la red esperada?
- ¿La entidad muestra el estado actual después de un reinicio o una desconexión temporal?
- ¿Están claramente identificados los dispositivos duplicados o los registros de puesta en servicio obsoletos?
- ¿La primera prueba de control es reversible y se limita a un solo dispositivo?
- ¿Las condiciones de presencia, clima o IR se agregan solo después de que el estado de Matter sea estable?
- ¿Se documenta una ruta de recuperación y control manual antes de ampliar la configuración?
Privacidad, permisos y valores predeterminados más seguros
Las tareas entre aplicaciones pueden afectar comunicaciones personales, calendarios, archivos, fotografías, ubicaciones y dispositivos domésticos. Otorgue el permiso útil más pequeño, mantenga los datos no relacionados fuera del alcance y evite compartir credenciales, contraseñas, códigos de un solo uso o detalles de cuentas privadas.
Utilice borradores para mensajes y archivos adjuntos. Utilice vistas previas de escenas para cambios en el hogar inteligente. Mantenga las compras, el control de acceso, los dispositivos de seguridad y las acciones destructivas de archivos detrás de una confirmación humana explícita.
Solución de problemas
El código QR no se empareja
Confirme que el código pertenece al dispositivo deseado, verifique el modo de puesta en servicio y elimine solo los registros obsoletos que pueda recuperar.
El dispositivo se empareja pero no está disponible
Verifique el transporte, el comportamiento de la dirección local, IPv6, la multidifusión y los registros del controlador antes de restablecer el dispositivo.
Los dispositivos de hilo desaparecen
Verifique la ruta del enrutador de borde, la membresía de la estructura y el estado de energía, luego pruebe un dispositivo sin cambiar varias capas a la vez.
El puente expone el punto final incorrecto
Revise la asignación de puntos finales, los nombres de los dispositivos y la integración del puente en lugar de crear entidades duplicadas.
Las actualizaciones estatales se retrasan
Pruebe la accesibilidad local y el estado del controlador, luego separe el retraso de estado Matter de un retraso o enfriamiento de automatización.
Una escena cambia demasiado
Elimine condiciones adicionales, mantenga una acción Matter y solicite una vista previa antes de agregar control de presencia, clima o IR.
Productos relacionados LinknLink
- HomeClaw: una ruta de puerta de enlace Home Assistant local y AI.
- eMotion Air: contexto de presencia mmWave con batería.
- eMotion Pro: mmWave detección de presencia para salas compatibles.
- eMotion Ultra: Presencia de 60 GHz, soporte de cable de sensor de temperatura y humedad y IR incorporado.
- eRemote HA: control de aparato IR compatible para Home Assistant.
Guías relacionadas LinknLink App y Home Assistant
- Guía del puente HomeKit para tableta Android
- Home Assistant Guía de solución de problemas de emparejamiento de dispositivos
- LinknLink App Guía de funciones
- LinknLink App Guía de diagnóstico de Agent+
- Home Assistant Guía de configuración de la puerta de enlace AI
- Guía gratuita de acceso remoto Home Assistant
Preguntas frecuentes
¿Qué es un puente Matter para Home Assistant?
Un puente Matter expone las funciones del dispositivo admitidas a un controlador como Home Assistant. El punto final exacto y el comportamiento de transporte dependen del puente y la integración del dispositivo.
¿Matter siempre usa Thread?
No. Los dispositivos Matter pueden usar rutas Wi-Fi, Thread o Ethernet compatibles. Consulte la documentación del dispositivo y confirme qué transporte local está activo.
¿Por qué un dispositivo Matter se empareja pero muestra no disponible?
El paso de puesta en servicio puede tener éxito mientras la ruta estatal local tenga un problema de red, enrutador fronterizo, controlador o descubrimiento de direcciones. Verifique esas capas antes de reiniciar el dispositivo.
¿Pueden los dispositivos LinknLink proporcionar contexto para una automatización Matter?
Cuando las integraciones exponen las entidades requeridas, la presencia de eMotion o los datos climáticos pueden proporcionar el contexto de la habitación después de que se haya verificado la entidad Matter.
¿Puede un evento Matter controlar un dispositivo IR?
Puede ser parte de un flujo de trabajo Home Assistant compatible cuando se configura una ruta IR compatible, como eRemote HA. Pruebe primero el disparador Matter y el comando IR por separado.
¿Qué debo emparejar primero?
Comience con un dispositivo compatible y un controlador. Verifique el estado de la entidad y una acción local reversible antes de agregar más dispositivos o puentes.
Comience con un dispositivo Matter y una prueba local
Empareje un dispositivo Matter compatible, confirme su estado en Home Assistant y ejecute una acción local reversible. Sólo entonces agregue más dispositivos, puentes o condiciones de la habitación.