Solicitud de integración externa para robot aspirador/lavador TINECO

Integración externa para controlar los aspiradores lavadores TINECO como el S7 Strech

La integración existe en HA - GitHub - wheeller123/Tineco-Integration: Home Assistant custom integration for Tineco vacuum cleaners · GitHub

Estructura de los datos (Payload decodificado)

La respuesta de estado del aspirador contiene un objeto JSON con claves abreviadas:

  • wm (Modo de trabajo) :
    • 1 = En espera (Standby)
    • 2 = En carga (Charging)
    • 3 = En funcionamiento (In Operation)
    • 8 = Auto-limpieza del cepillo (Self-cleaning)
    • 9 = Actualización OTA
    • 13 = Secado rápido (Drying / Flashdry)
  • e2 / e3 (Máscaras de bits de alerta de los depósitos de agua) :
    • Depósito de agua sucia lleno: verificado por e2 & 256 (o e3 & 4096).
    • Depósito de agua limpia vacío: verificado por e2 & 64 (o e3 & 8192).
  • battery : Porcentaje restante de la batería.
  • vs : Estado en línea (online/offline).
  • ms / vl : Modo silencioso (ms: 0 o 1) y nivel de sonido (vl: 1 bajo, 2 medio, 3 alto).
  • Controles adicionales : Potencia de succión (120W, 150W), flujo de spray, iluminación del cepillo.

Voy a lanzar a Claude sobre eso :wink:

Fue más rápido que yo :sweat_smile:

Sois máquinas, chicos… :rofl:
Ahora todas las noches hay que prever 1 hora para repasar la lista de integraciones y ver las novedades

¡Listo, está lista! En una hora en la tienda o, si tienes prisa, manualmente: Build and publish image · gboulvin/Gladys-Tineco@ad8eee7 · GitHub

Y el mensaje que va bien:

La integración conecta a Gladys los dispositivos de tu cuenta Tineco (Floor One S3, S5, S7, S7 Flashdry, S7 Stretch, iFloor… todo lo que muestra la aplicación Tineco), a través de la nube Tineco, como la aplicación oficial.

Lo que recopila

  • Estado (estándar aspiradora Gladys) y actividad detallada: limpieza, auto-limpieza, secado, en carga, actualización, en espera, fuera de línea
  • Batería y carga en curso
  • Depósito de agua limpio (vacío) y depósito de agua sucia (lleno)
  • Volumen de voz, anuncios vocales y iluminación del cepillo (en los modelos equipados), controlables desde Gladys
  • Insignia nube / inalcanzable cuando el dispositivo está apagado o sin Wi-Fi

Escenas

  • Disparadores: limpieza iniciada, limpieza terminada (con la duración), auto-limpieza terminada (el momento ideal para ser notificado de vaciar el depósito de agua sucia :wink:), alerta de depósito
  • Acciones: leer un dispositivo (salidas utilizables en condición: batería, actividad, depósitos…), ajustar el volumen, apagar los anuncios vocales, encender/apagar la luz del cepillo

Widgets del tablero de control

  • Dispositivo Tineco: indicador de batería, actividad, depósitos, historial de batería de 24 h y botón « Actualizar »
  • Vista general de Tineco: una línea por dispositivo, en naranja si un depósito requiere su atención

Instalación

  1. Instale la integración Tineco desde el catálogo de integraciones.
  2. Ingrese el correo electrónico, la contraseña y el país de su cuenta Tineco.
  3. En la primera conexión, Tineco le envía un código por correo electrónico: ingrese en « Código de verificación » y guarde (una sola vez).
  4. Cree sus dispositivos desde la pestaña Descubrimiento.

La integración está disponible en francés, inglés, alemán y español.

Qué saber

Tineco no publica una API: la integración se basa en el protocolo de la aplicación, documentado por la comunidad (gracias al autor de Tineco-HACS-Integration y al descifrado del payload compartido en este foro). No todos los modelos recopilan todos los valores: sus comentarios (modelo + lo que funciona / no funciona) son bienvenidos para mejorarla!

¡Feliz limpieza! :broom:

La he instalado y la he vinculado a mi cuenta + he introducido el código de verificación.
Cuando pruebo la conexión, recibo un mensaje que indica que la conexión es correcta, pero que no encuentra ningún dispositivo vinculado a esta cuenta. Sin embargo, en la aplicación TINECO de mi teléfono, sí tengo acceso a mi aspiradora lavadora S7.

¿Tienes un registro para darme? En la integración → Registros

[2026-10-16T20:07:46.731Z] [INFO] Iniciando la integración de Tineco...
[2026-10-16T20:07:46.962Z] [INFO] [gladys-sdk] conectado a Gladys (http://172.30.0.1:80)
[2026-10-16T20:07:47.015Z] [ERROR] [tineco] Tineco: correo electrónico o contraseña de Tineco faltante
[2026-10-16T20:09:46.311Z] [INFO] [tineco-session] código de verificación de Tineco enviado por correo electrónico
[2026-10-16T20:09:46.311Z] [INFO] [tineco] Esperando el código de verificación de Tineco
[2026-10-16T20:10:24.835Z] [INFO] [tineco-session] dispositivo de la aplicación Tineco verificado
[2026-10-16T20:10:25.988Z] [INFO] [tineco-session] sesión de Tineco abierta, 0 dispositivo(s)
[2026-10-16T20:10:28.482Z] [INFO] [tineco-session] sesión de Tineco abierta, 0 dispositivo(s)
[2026-10-16T20:11:05.105Z] [INFO] [tineco-session] sesión de Tineco abierta, 0 dispositivo(s)
[2026-10-16T20:11:24.663Z] [INFO] [tineco-session] sesión de Tineco abierta, 0 dispositivo(s)
[2026-10-16T20:13:14.770Z] [INFO] [tineco-session] sesión de Tineco abierta, 0 dispositivo(s)

¡Gracias por la respuesta y el registro! La conexión funciona: es la lista de dispositivos devuelta por Tineco la que está vacía. ¿Podrías:

  1. actualizar la integración a v1.0.2. Si la instalaste manualmente, debes eliminar la anterior;
  2. verificar que el País de la cuenta sea el de la aplicación Tineco (Perfil > Configuración), luego guardar y hacer clic en Probar la conexión;
  3. si no aparece ningún dispositivo, copiarme la línea del registro que contiene « Answer shape »: no contiene ninguna información personal y me dirá dónde Tineco guarda tus dispositivos.

He verificado en la aplicación y mi cuenta está configurada en « Francia »


[2026-10-16T20:29:39.539Z] [INFO] [tineco-session] Sesión de Tineco abierta, 0 dispositivo(s)
[2026-10-16T20:29:39.539Z] [WARN] [tineco-session] No hay dispositivos en la lista de dispositivos de los servidores FR. Verifique el país de la cuenta. Forma de respuesta: { code: "0000", msg: "操作成功", time: number, data: [], success: boolean }

¡Buenas noticias!

Hemos encontrado la causa: la integración solicitaba la lista de dispositivos con el identificador de usuario incorrecto, por lo que Tineco respondía con una lista vacía.

Esto se ha corregido en la v1.0.3. ¿Podrías actualizar la integración, hacer clic en Probar la conexión y luego abrir la pestaña Descubrimiento? Tu S7 debería aparecer. Si no es así, envíame la nueva línea « Answer shape » del registro.

Disculpa por estos vaivenes :wink:

¡Demasiado fuerte!!!

¡Genial!

Ten en cuenta que si la instalaste « manualmente » en modo desarrollador, no se ofrecerán actualizaciones de la integración en el futuro. Te recomiendo que lo hagas a través de la tienda para fines de producción :wink:

La volvería a instalar tan pronto como aparezca en la página de integraciones.