Externe Integration - Xiaomi MIoT (Luftreiniger, Luftbefeuchter, Steckdosen...)

Hallo zusammen! :waving_hand:

Die Xiaomi-Staubsauger haben bereits ihre Integrationen (Xiaomi Home von @callemand, Roborock, Dreame). Aber es fehlte noch der Rest des Mi Home-Ökosystems: Luftreiniger, Luftbefeuchter, Ventilatoren, Steckdosen, Lampen… Hier ist Xiaomi MIoT, das sie lokal steuert.

Was es kann

  • Keine manuell codierte Modellliste: Die Integration liest die öffentliche Spezifikation jedes Modells (miot-spec.org) und übersetzt, was sie findet, in Gladys-Geräte:
    • Luftreiniger: Ein/Aus, Modus, Geschwindigkeit, PM2.5, Restfilter, Kindersicherung;
    • Luftbefeuchter und Luftentfeuchter: Luftfeuchtigkeit, Sollwert, Behälter;
    • Ventilatoren: Geschwindigkeit, Schwingung;
    • Steckdosen (mit Verbrauch, wenn gemessen);
    • Lampen: Helligkeit, Farbtemperatur, Farbe;
    • Umwelt-Sensoren: Temperatur, Luftfeuchtigkeit, PM2.5, PM10, CO2, Helligkeit.
    • Heizkörper werden angezeigt, aber nie gesteuert: Ich möchte nichts aus der Ferne heizen.
  • Ein Trigger „Wartung erforderlich“: Filter bei 10 % oder weniger, leerer Behälter, Fehler.
  • Eine Szenenaktion, um jede Eigenschaft eines Geräts einzustellen, für fortgeschrittene Fälle.
  • Ein Widget „Luftqualität“: PM2.5, Luftfeuchtigkeit, Filter und Ein/Aus-Modus-Tasten.
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Das coole Ding

PM2.5 über 35 → Der Luftreiniger schaltet auf Maximalmodus
Leerer Behälter des Luftbefeuchters → Benachrichtigung
Ich verlasse das Haus → Alle Xiaomi-Steckdosen werden ausgeschaltet

Installation

:warning: Gladys 5.1 mindestens.

Sie kommt im Store beim nächsten Indexer-Durchlauf. In der Zwischenzeit: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-xiaomi-miot: Xiaomi MIoT / Mi Home purifiers, humidifiers, fans, plugs and lights for Gladys Assistant, local miIO protocol · GitHub

  1. Importieren Sie Ihre Geräte von Ihrem Xiaomi-Konto (E-Mail, Passwort, Kontoregion; die Zwei-Schritt-Verifizierung wird verwaltet). Das Konto wird nur verwendet, um die „Tokens“ der Geräte einmal abzurufen: danach läuft alles lokal.
  2. Oder fügen Sie ein Gerät manuell mit seiner IP-Adresse und seinem Token hinzu.
  3. Registerkarte Entdeckung: Fügen Sie sie hinzu.

Kleine ehrliche Vorbehalte

  • Entwickelt ohne Hardware: Alles wurde an den echten Spezifikationen von 14 Modellen getestet, und ich habe überprüft, dass die Verbindung zum Xiaomi-Konto bis zum echten Server funktioniert, aber nichts wurde auf einem echten Luftreiniger getestet. Ihr Feedback ist willkommen :folded_hands:
  • Staubsauger und Bluetooth- oder Zigbee-Geräte, die über einen Xiaomi-Hub laufen, werden hier nicht unterstützt.

Es basiert auf der Arbeit von hass-xiaomi-miot (Apache 2.0): Danke an al-one! Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht mit Xiaomi verbunden.

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