Integración externa - Xiaomi MIoT (purificadores, humidificadores, enchufes…)

¡Hola a todos! :waving_hand:

Los aspiradores Xiaomi ya tienen sus integraciones (Xiaomi Home de @callemand, Roborock, Dreame). Pero quedaba todo el resto del ecosistema Mi Home: purificadores, humidificadores, ventiladores, enchufes, lámparas… Aquí está Xiaomi MIoT, que los controla localmente.

Qué hace

  • No hay una lista de modelos codificada a mano: la integración lee la especificación pública de cada modelo (miot-spec.org) y traduce lo que encuentra en dispositivos Gladys:
    • purificadores de aire: encendido/apagado, modo, velocidad, PM2.5, filtro restante, bloqueo infantil;
    • humidificadores y deshumidificadores: humedad, consigna, depósito;
    • ventiladores: velocidad, oscilación;
    • enchufes (con el consumo cuando se mide);
    • lámparas: luminosidad, temperatura de color, color;
    • sensores ambientales: temperatura, humedad, PM2.5, PM10, CO2, luminosidad.
    • Los radiadores se muestran, pero nunca se controlan: prefiero no calentar nada a distancia.
  • Un disparador « mantenimiento necesario »: filtro al 10% o menos, depósito vacío, fallo.
  • Una acción de escena para ajustar cualquier propiedad de un dispositivo, para casos avanzados.
  • Un widget « calidad del aire »: PM2.5, humedad, filtro y botones de encendido/modo.
  • En francés, inglés, alemán y español.

Lo bueno

PM2.5 por encima de 35 → el purificador pasa a modo máximo
Depósito del humidificador vacío → notificación
Me voy de la casa → todos los enchufes Xiaomi se apagan

Instalación

:warning: Gladys 5.1 mínimo.

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-xiaomi-miot: Xiaomi MIoT / Mi Home purifiers, humidifiers, fans, plugs and lights for Gladys Assistant, local miIO protocol · GitHub

  1. Importa tus dispositivos desde tu cuenta Xiaomi (correo electrónico, contraseña, región de la cuenta; la verificación en dos pasos está gestionada). La cuenta solo se usa para recuperar los «tokens» de los dispositivos, una sola vez: después, todo se hace localmente.
  2. O añade un dispositivo manualmente, con su dirección IP y su token.
  3. Pestaña Descubrimiento: añádelos.

Pequeñas reservas honestas

  • Desarrollado sin el hardware: todo se ha probado con las especificaciones reales de 14 modelos, y he verificado que la conexión a la cuenta Xiaomi llega bien al servidor real, pero nada ha funcionado en un purificador real. ¡Tus comentarios son bienvenidos! :folded_hands:
  • Los aspiradores, y los dispositivos Bluetooth o Zigbee que pasan por un puente Xiaomi, no se gestionan aquí.

Se basa en el trabajo de hass-xiaomi-miot (Apache 2.0): ¡gracias a al-one! Como los anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a Xiaomi.

Depósito: GitHub - guim31/gladys-xiaomi-miot: Xiaomi MIoT / Mi Home purifiers, humidifiers, fans, plugs and lights for Gladys Assistant, local miIO protocol · GitHub