Domesticando el Zoo de Tuya y Olvidándose de las Nubes Chinas
Supongamos que compraste un calentador inteligente, una bombilla o un sensor de fuga de agua. La caja muestra con orgullo el logo de Tuya o SmartLife. Conectas el dispositivo, instalas la app y todo parece funcionar bien. Pero en el momento en que internet fluctúa o los servidores de China empiezan a sentirse mal, tu hogar "inteligente" se convierte en una calabaza. ¿Te suena familiar?
Muchos de nosotros llegamos a Home Assistant precisamente para arrebatar el control de nuestros hogares de las garras de los servicios en la nube. Pero Tuya siempre ha tenido una trampa: la integración oficial funciona a través de su API, que es de pago, tiene un período de prueba limitado o simplemente es lenta. El proyecto tuya-local resuelve este problema radicalmente: hace que los dispositivos se comuniquen con tu servidor directamente a través de la red local.
¿Cuál es el Objetivo de Este Proyecto
En resumen: es un componente personalizado para Home Assistant que te permite controlar dispositivos Tuya a través de Wi-Fi sin intermediarios.
Lo principal aquí no es solo la velocidad (aunque la respuesta se vuelve casi instantánea). El valor central es que la integración puede "extraer" funciones que la nube oficial no muestra en absoluto. Por ejemplo, modos operativos específicos de equipos de climatización o estadísticas detalladas de consumo energético que los chinos decidieron ocultar en la app pero no expusieron a través de la API.
Por cierto, el proyecto soporta más que solo dispositivos Wi-Fi. Si tienes una pasarela Tuya, puedes conectar periféricos Zigbee a través de ella, aunque el autor advierte honestamente: las capacidades del hub para conexiones locales simultáneas están severamente limitadas.
Qué Puede Hacer tuya-local
El repositorio afirma soportar más de mil dispositivos. No es solo "encendido/apagado" — es una operación completa con entidades complejas.
- Climatización y calefacción. Convectores inteligentes, aires acondicionados y humidificadores funcionan con todos sus sensores y presets.
- Iluminación. El soporte para diferentes protocolos (desde 3.1 hasta 3.5) permite que incluso lámparas caprichosas funcionen localmente que antes se negaban a cooperar.
- Seguridad. Hay soporte para algunos modelos de cerraduras. Implementa un esquema inteligente para interceptar claves de desbloqueo, lo cual es generalmente raro en integraciones de código abierto.
- Electrodomésticos del hogar. Desde comederos para mascotas (con soporte de programación de alimentación) hasta transmisores IR que pueden aprender comandos directamente desde la interfaz de Home Assistant.
Cómo Hacer Que Funcione Sin Romperte la Espalda
Anteriormente, configurar Tuya local se parecía a un ritual de invocación de demonios: tenías que crear una cuenta de desarrollador, extraer local_key a través de la consola y sufrir. En tuya-local, el proceso se ha simplificado significativamente.
La integración tiene dos caminos de configuración. El primero es el "asistente en la nube". Inicias sesión con tu cuenta de SmartLife una vez, la integración extrae la lista de dispositivos y sus claves secretas automáticamente, y luego trabaja con ellos solo localmente. Esto te ahorra tener que renovar la prueba cada seis meses en el portal Tuya IoT.
El segundo camino es manual. Si eres un paranoico hardcore que ya obtuvo todos los IDs y claves por tu cuenta, simplemente los escribes en la tarjeta del dispositivo.
Matices y Trampas
Hay matices, por supuesto. Tuya no es un estándar único — es más bien un mosaico de diferentes versiones de firmware.
Primero, muchos dispositivos solo mantienen una conexión local activa. Si tienes la app abierta en tu teléfono o otra integración ejecutándose (por ejemplo, la antigua localtuya), la nueva simplemente no podrá alcanzar el hardware.
Segundo, los dispositivos alimentados por batería (sensores de puerta o humo) no funcionarán localmente sin un hub. Se duermen para conservar energía y solo se despiertan para "hacer ping" de datos a la nube. No puedes engañar a la física aquí — para estos, es mejor usar versiones Zigbee con un stick adecuado.
Tercero, algunos hardware comienzan a comportarse de manera extraña si bloqueas completamente su acceso a internet en el router. Pueden terminar en un bucle infinito de reinicio. El autor recomienda bloquear no solo TCP sino también las solicitudes DNS del dispositivo en tales casos.
Por Qué Esto Supera a las Alternativas
Hay una alternativa popular — localtuya. He probado ambas. localtuya es más flexible cuando se trata de configurar manualmente cada punto de datos específico (DP), pero eso también es su perdición: configurar un termostato complejo se convierte en una hora de juguetear con tablas.
tuya-local toma la ruta de configuraciones listas para usar. Si tu dispositivo está en la lista soportada, simplemente seleccionas su tipo y todos los sensores/botones aparecen por sí mismos. Esto ahorra una cantidad de tiempo enorme. Si tu dispositivo no está soportado, puedes ayudar al proyecto enviando logs con un volcado de datos — la comunidad allí es muy activa.
Si tu hogar se está llenando gradualmente de dispositivos Tuya, instalar esta integración es imprescindible. Si solo fuera por el hecho de que las luces se encienden al instante, en lugar de un segundo después de que la señal hace un viaje de ida y vuelta a Frankfurt o Shanghái y regresa.
El proyecto es maduro, con una base de datos sólida de dispositivos y una lógica de configuración sensata. Sí, Tuya sigue siendo un "zoo", pero con esta herramienta en tus manos, al menos obtienes un látigo adecuado y una bolsa de premios de entrenamiento.
Vale la pena probarlo si:
- Estás cansado de los retrasos de la API en la nube.
- Tienes un dispositivo Tuya específico que no se移植 bien a HA usando métodos estándar.
- Quieres que las automatizaciones funcionen incluso cuando tu ISP se caiga.
Puedes encontrar el proyecto en HACS por nombre o directamente en GitHub: make-all/tuya-local.
Proyectos relacionados