mi-home-assistant

mi-home-assistant

1. Kurzvorstellung

Hallo zusammen! Heute geht es um ein Projekt, das Smart-Home-Fans begeistern wird: die offizielle Home Assistant-Integration von Xiaomi (ha_xiaomi_home). Dieses Projekt wird von Xiaomi selbst entwickelt und gepflegt – mit dem Ziel, Home Assistant-Nutzern eine flüssigere und zuverlässigere Steuerung ihrer Xiaomi-IoT-Geräte zu bieten.

Früher gab es zwar auch einige Drittanbieter-Integrationen für Xiaomi-Geräte, aber die hatten so ihre Tücken – zum Beispiel verzögerte Statusmeldungen. Mit der offiziellen Unterstützung können wir uns jetzt bessere Performance und mehr Sicherheit erwarten.

Home Assistant ist eine quelloffene Plattform für die Hausautomatisierung, bekannt für ihre enorme Kompatibilität und Flexibilität – bei DIY-Enthusiasten äußerst beliebt. Dass nun Xiaomi, der Smart-Home-Riese, in die Home-Assistant-Welt einsteigt, ist definitiv spannend.

Hauptmerkmale:

  • Offizielle Unterstützung: Von Xiaomi selbst entwickelt und gepflegt – für bessere Stabilität und Kompatibilität.
  • Home Assistant-Integration: Ermöglicht die Steuerung und Verwaltung von Xiaomi Smart-Home-Geräten direkt in Home Assistant.
  • Verbessertes Nutzererlebnis: Schnellere Gerätestatus-Antworten, löst das Verzögerungsproblem früherer Dritt-Integrationen.
  • Breite Geräteunterstützung: Unterstützt die meisten Xiaomi-IoT-Geräte – mit Ausnahme von Bluetooth-, Infrarot- und virtuellen Geräten.
  • Multi-Konto und Regionen: Mehrere Xiaomi-Konten können genutzt werden, und Geräte aus verschiedenen Regionen lassen sich derselben Home-Assistant-Region zuordnen.

2. Kernfunktionen

  • Verschiedene Installationsmethoden: Git-Klon, HACS und manuelle Installation stehen zur Verfügung. Offiziell empfohlen wird Git-Klon, da er Versionsverwaltung und Updates erleichtert.
    • Git-Klon-Installation: cd config; git clone https://github.com/XiaoMi/ha_xiaomi_home.git; cd ha_xiaomi_home; ./install.sh /config.
  • OAuth 2.0-Anmeldung: Nutzt OAuth 2.0 – Benutzerpasswörter werden nicht direkt in Home Assistant gespeichert, was die Sicherheit erhöht.
  • Cloud- und Lokalsteuerung: Die Steuerung erfolgt hauptsächlich über die Xiaomi-Cloud. Bei Geräten mit Lokalunterstützung kann auch über das Xiaomi-Gateway oder das lokale Netzwerk (LAN) gesteuert werden.
    • Cloud-Steuerung: Kommunikation und Steuerung über die Xiaomi-Cloud-Server.
    • Lokalsteuerung: Direkte Kommunikation im lokalen Netzwerk über das Xiaomi-Zentralgateway oder LAN – allerdings nicht in allen Regionen verfügbar.
      • Zentralgateway: Nur in China verfügbar.
      • LAN-Steuerung: In allen Regionen verfügbar, aber nur für IP-Geräte und als experimentelle Funktion – nicht für den produktiven Einsatz empfohlen.
  • Geräte-Nachrichtenabonnement: Ein Abonnementmechanismus pusht Nachrichten bei Geräteänderungen oder Ereignissen in Echtzeit an Home Assistant – das reduziert die Abfragelast auf die Cloud.
  • MIoT-Spec-V2-Zuordnung: Über das Xiaomi-IoT-Protokoll MIoT-Spec-V2 werden Geräte, Dienste, Eigenschaften, Ereignisse und Aktionen auf Home-Assistant-Entitäten (entity) abgebildet – so funktionieren alle Gerätefunktionen einwandfrei.

3. Praxistipps

  • Multi-Konto-Verwaltung: Nach der Anmeldung und Konfiguration eines Xiaomi-Kontos können über „HUB hinzufügen" weitere Xiaomi-Konten eingebunden werden.
  • Regionsauswahl: Achten Sie beim Importieren von Xiaomi-Geräten auf die richtige Region – Daten aus verschiedenen Regionen sind voneinander getrennt.
  • Debug-Modus: Der Debug-Modus für Aktionen (action) ermöglicht das manuelle Senden von Aktionsbefehlen mit Parametern.
  • Entitäts-Konvertierungsregeln aktualisieren: Wenn Sie specv2entity.py, spec_filter.json oder multi_lang.json geändert haben, müssen Sie die Entitäts-Konvertierungsregeln auf der Konfigurationsseite der Integration aktualisieren, damit die Änderungen wirksam werden.
  • Benutzerdefinierte Filterung: Mit der Datei spec_filter.json können Sie MIoT-Spec-V2-Instanzen filtern, die nicht nach Home Assistant konvertiert werden sollen.
  • Lokalisierung: Die Datei multi_lang.json stellt lokalisierte Übersetzungen für Gerätenamen und andere Textelemente bereit und hat Vorrang vor Cloud-Übersetzungen.

4. Anwendungsbeispiele

  • Intelligente Beleuchtungssteuerung: Helligkeit, Farbe und Ein-/Ausschalten von Xiaomi Smart Bulbs über Home Assistant steuern.
  • Smart Security: Xiaomi-Kameras und Sensoren kombinieren, um eine automatisierte Heimüberwachung aufzubauen – z. B. bei ungewöhnlicher Bewegung eine Warnung senden.
  • Umgebungsmonitoring: Mit Xiaomi Temperatur- und Feuchtigkeitssensoren die Raumumgebung in Echtzeit überwachen und Klimaanlage oder Heizung automatisch anpassen.
  • Automatisierte Szenarien: Home Assistants Automatisierungsfunktionen nutzen, um Szenarien wie „Nach-Hause-Modus" oder „Außer-Haus-Modus" einzurichten – für ein wirklich intelligentes Zuhause.

5. Sicherheitshinweise

Obwohl die offizielle Xiaomi-Integration mit OAuth 2.0 arbeitet und somit die Sicherheit verbessert, bleiben einige Risiken bestehen:

  • Speicherung sensibler Daten im Plaintext: Geräteinformationen, Zertifikate und Tokens werden als Plaintext in den Home-Assistant-Konfigurationsdateien gespeichert. Bei einem Datenleck könnten Unbefugte Zugriff auf Ihre Xiaomi-Geräte erhalten.
  • Konfigurationsdateien schützen: Stellen Sie sicher, dass Ihre Home-Assistant-Konfigurationsdateien sicher verwahrt sind und nicht in falsche Hände geraten.
  • Autorisierung widerrufen: Falls Sie den Verdacht haben, dass ein OAuth-Token kompromittiert wurde, können Sie die Anmeldung über die Xiaomi Home App widerrufen.

Also: Schützen Sie Ihre Home-Assistant-Konfigurationsdateien unbedingt vor unbefugtem Zugriff!

6. Häufig gestellte Fragen

  • Welche Geräte werden nicht unterstützt?
    • Bluetooth-, Infrarot- und virtuelle Geräte sind derzeit nicht unterstützt.
  • Wie füge ich mehrere Xiaomi-Konten hinzu?
    • Auf der bereits konfigurierten Xiaomi Home-Integrationsseite auf „HUB hinzufügen" klicken, um weitere Konten einzubinden.
  • Ist die Lokalsteuerung in allen Regionen verfügbar?
    • Die Lokalsteuerung über das Zentralgateway ist nur in China verfügbar. LAN-Steuerung funktioniert in allen Regionen, aber nur für IP-Geräte und wird nicht empfohlen.
  • Warum empfiehlt Xiaomi die Git-Klon-Installation?
    • Git-Klon erleichtert den Versionswechsel und Updates – einfacher zu verwalten.
  • Wie aktualisiere ich die Integration?
    • Entweder über Git-Klon auf eine bestimmte Version wechseln oder HACS für das Update nutzen.
  • Wie verwende ich benutzerdefinierte Konfigurationen?
    • Bearbeiten Sie spec_filter.json und multi_lang.json für Filterung und Übersetzung, und aktualisieren Sie anschließend die Entitäts-Konvertierungsregeln.