Components Home Assistant „Xiaomi Gateway"

6 Minuten des Lesens
ProLeiter: Home Assistant Community
Verfügbarkeit: enthalten in derHUB
Kategorie: Software
Typologie: Komponenten Home Assistant
Implementierungsschwierigkeiten: niedrig
Kartenrevision: 1

Die "Xiaomi" -Komponente Gateway" di Home Assistant es ist notwendig zu integrieren il BRIDGE/Gateway ZigBee↔︎TCP/IP der Linie Xiaomi Mi Smart Home (Mijia).

Geschichte gateway hat die Funktion BRIDGE/Gateway (in der Praxis von Centralizer) für alle Geräte ZigBee der Xiaomi Linie zusammen von Sensoren, Schaltern, Impulsen, Geräten und mehr sowie alle kompatiblen (zum Beispiel ein Teil der Linie IKEA TRÅDFRIoder etwas Aqara).

Der vollständige Name der Komponente eigentlich wäre es "Xiaomi Gateway (Aqara)", Aber es ist ein Name extrem irreführend. In der Tat erlaubt die Komponente NUR die Integration von gateway Xiaomi Mi (Mijia) e NICHT die gateway LUMI Aqara was, obwohl konzeptionell sehr ähnlich (es ist auch ein BRIDGE/Gateway ZigBee↔︎TCP/IP), kann nicht integriert werden.

Das Vorhandensein des Namens "Aqara"Verweist auf die Tatsache, dass Komponenten (Sensoren, Aktoren usw.) als Aqara kompatibel mit gateway Xiaomi, wenn letzteres mit integriert ist Home Assistant sind wiederum integriert. Das Gegenteil ist nicht wahr: Xiaomi-Komponenten kompatibel mit a gateway Aqara NICHT kann indirekt mit integriert werden Home Assistant wie oben, wie letztere NICHT kann mit integriert werden Home Assistant.

Il gateway ist anfänglich konfiguriert (für den Zugriff auf proehe Wi-Fi) durch dieapplished hier "Xiaomi Mi Home" (verfügbar für androide e iOS) und nach erfolgter Konfiguration immer über dieapp es ist möglich, an ihn "Satelliten" -Komponenten anzuschließen, die über ihn verbunden sind proProtokoll ZigBee. Das Verhalten (dh Benachrichtigungen, Alarme, Anpassungen) dieser Komponenten in Bezug auf gateway (Aussendung von akustischen, visuellen oder Mitteilungen an dieapp) werden verwaltet und verwaltet von Gateway durch dieapp "Xiaomi Mi Home".

Einmal konfiguriert die gateway am proehe Wi-Fi durch dieapp "Xiaomi Mi Home", es wird möglich sein, es zu integrieren - durch die Komponente "Xiaomi Gateway"Hier beschrieben - mit dem proPetition für Home Assistant um:

  • integrieren die gleichen Funktionen wie die gateway (Emission von Soundeffekten, Beleuchtung - chromatisch - seines LED-Lichts);
  • die eventuell angeschlossenen Geräte / Sensoren / Komponenten in das gateway Gleiche.
ACHTUNG: Um diese Integration durchführen zu können, muss die Firmware-Version der Komponente vorliegen gleich oder kleiner als der 1.41.159. Höhere Firmware erlaubt die hier beschriebene Integration außer nicht die Umsetzung von dies Führung.

Sobald die Integration abgeschlossen ist il Gateway und alle Satellitenkomponenten entstehen auf Home Assistant wie Wesen von verschiedenen Artenaufgrund ihrer Art (appFettsensoren, Knöpfe usw.).

Unterstützte Geräte
  • Gatewa Xiaomi (lumi.gateway.v2, lumi.gateway.v3)
  • LUMI Aqara Air Conditioning Companion (lumi.acpartner.v3)
  • LUMI Intelligentes Türschloss von Aqara (lock.aq1)
  • Temperatur und Luftfeuchtigkeit Sensor (erste und zweite Generation)
  • Bewegung Sensor (erste und zweite Generation)
  • Tür und Fenster Sensor (erste und zweite Generation)
  • Taste 1st Generation (handlich: einfach, doppelt, lang drücken)
  • Taste 2nd Generation (handlich: einfach, doppelt drücken)
  • Stecker aka Socket (Version ZigBee: meldet verbrauchte Energie, Momentan, Status und ob das Gerät in Gebrauch ist)
  • Steckdose (zeigt den Stromverbrauch, den Schnappschuss und den Status an)
  • LUMI Aqara Wall Switch (einfacher Druck)
  • LUMI Aqara Wall Switch (doppelter Druck)
  • LUMI Aqara Wall Switch LN (Einfachdruck)
  • LUMI Aqara Wall Switch LN (zweimal drücken)
  • LUMI Aqara Wireless Switch (einfacher Druck)
  • LUMI Aqara Wireless Switch (doppelter Druck)
  • LUMI/ Xiaomi Cube
  • Gaslecksucher (Berichte Alarm und Dichte)
  • Rauchmelder (Berichte Alarm und Dichte)
  • Gateway (überschaubar: Licht, Sensor von lumiNeugier, riproDuktionsgeräusche)
  • Intelligenter Vorhang
  • Wasserleck Sensor
  • Vibration Sensor
  • Batterie
Nicht unterstützte Geräte
  • Gateway LUMI Aqara
  • Gateway Radio
  • Gateway Taste
  • Xiaomi Mi Air Conditioning Companion (lumi.acpartner.v2)
  • LUMI Aqara Intelligent Air Conditioner Controller Hub (lumi.acpartner.v1)
  • Entkoppelter Modus der Aqara-Mauer Switches (Einzel- und Doppelpresse)
  • Zusätzliche Alarmereignisse des Gas- und Rauchmelders: Analoger Alarm, Batteriefehleralarm, Empfindlichkeitsfehleralarm, I2C-Kommunikationsfehler

Nb Die Liste wird ständig weiterentwickelt die offizielle Komponentenseite.

Führung

Die detaillierte Anleitung zur Integration lautet wie folgt:

Integrieren Sie die Gateway Xiaomi Mi Smart Home a Home Assistant

Konfiguration

Der Codeblock, unter dem eingegeben werden soll die Konfiguration von Home Assistant was erlaubt, die zu integrieren gateway ist der folgende:

xiaomi_aqara:
  discovery_retry: 5
  gateways:
    - key: xxxxxxxxxxxxxxxx

Falls mehr vorhanden sind gatewaylautet die Syntax wie folgt:

xiaomi_aqara:
  gateways:
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx

Die Variablen verfügbar zur Konfigurationsanpassung sind die folgenden:

interface(Zeichenfolge, optional) - Die Netzwerkschnittstelle, über die nach dem Vorhandensein von gesucht werden soll gateway.
discovery_retry(intern, optional) - Die Häufigkeit, mit der Home Assistant Wiederholen Sie die Verbindung zu gateway im Falle einer Insolvenz. Voreinstellung: 3
gateway(Karte, erforderlich) - Die Liste der gateway integriert werden.

mac(Zeichenfolge) - Il MAC Adresse der gateway. Optional, falls es nur einen gibt gateway.
Schlüssel(Zeichenfolge, Anforderung) - Der LAN-Zugriffsschlüssel für gateway (erklärt in Leitfaden für die Integration von Gateway su Home Assistant).
host(Zeichenfolge, optional) - Die IP-Adresse der gateway. Wird verwendet, wenn Sie die automatische Multicast-Erkennung nicht verwenden möchten.
deaktivieren(Boolean, optional) - Deaktivieren Sie das gateway. Wird verwendet, um ein bestimmtes Element nicht zu integrieren gateway im Falle von mehr Co-Präsenz gateway.

Service

Die Integration dieser Komponente umfasst vier Services:

xiaomi_aqara.play_ringtoneRiproGibt einen bestimmten Soundeffekt
xiaomi_aqara.stop_ringtoneStoppen Sie die ReproErzeugung eines Klangeffekts
xiaomi_aqara.add_deviceAktivieren Sie den Modus zum Hinzufügen von Satellitengeräten zum gateway. Es ist das gleiche wie durch dieapp "Mi Zuhause"
xiaomi_aqara.remove_deviceBenötigt al gateway Entfernen von Satellitengeräten auf dem gateway. Es ist das gleiche wie durch dieapp "Mi Zuhause"

Dienst "Xiaomi_aqara.play_ringtone"

Wenn es hervorgerufen wird, benötigt es das gateway von riproDuce ein bestimmter Klang unter denen ab Werk erhältlich. Dieser Dienst funktioniert nur auf gateway mit Firmware ab der Version 1.4.1_145. Dies ist eine nützliche Funktion, zum Beispiel als akustische Benachrichtigung in unseren automatisierungen Home Assistant.

ServicedatenattributeFakultativBeschreibung
gw_macnichtMAC Adresse von gateway
ringtone_idnichtDie ID des Tons, der wiedergegeben werden sollproDuce
ringtone_voljaDas Volumen in Prozent

Akzeptierte Werte für das Feldringtone_id sie sind:

  • Alarm
    • 0 - Polizeiwagen 1
    • 1 - Polizeiwagen 2
    • 2 - Unfall
    • 3 - Countdown
    • 4 - Ghost
    • 5 - Scharfschützengewehr
    • 6 - Schlacht
    • 7 - Luftangriff
    • 8 - Rinde
  • Campanelli
    • 10 - Türklingel
    • 11 - Klopfe an eine Tür
    • 12 - Amüsieren
    • 13 - Wecker
  • Wake
    • 20 - MiMix
    • 21 - Begeistert
    • 22 - GuitarClassic
    • 23 - IceWorldPiano
    • 24 - Freizeit
    • 25 - ChildHood
    • 26 - MorningStreamLiet
    • 27 - MusicBox
    • 28 - Orange
    • 29 - Denker
  • Benutzerdefinierte Sounds (hinzugefügt über dieapp "Mi Home") ab der ID 10001 zu wachsen.

Dienst "Xiaomi_aqara.stop_ringtone"

Wenn es hervorgerufen wird, benötigt es das gateway das ri zu unterbrechenproTonerzeugung im Zuge von reproduktion.

ServicedatenattributeFakultativBeschreibung
gw_macnichtMAC Adresse von gateway

Service "xiaomi_aqara.add_device"

Wenn es hervorgerufen wird, benötigt es das gateway um den Modus zum Hinzufügen von Satellitengeräten zu aktivieren gateway. Es ist das gleiche wie durch dieapp "Mi Zuhause"

ServicedatenattributeFakultativBeschreibung
gw_macnichtMAC Adresse von gateway

Service "xiaomi_aqara.remove_device"

Wenn es hervorgerufen wird, benötigt es das gateway Entfernen von Satellitengeräten auf dem gateway. Es ist das gleiche wie durch dieapp "Mi Zuhause"

ServicedatenattributeFakultativBeschreibung
gw_macnichtMAC Adresse von gateway
device_id
nichtHardware-Adresse des zu entfernenden Satellitengeräts

Anwendungsbeispiele in der Automatisierung

Schauen wir uns ein Beispiel an:

- alias: Doppio click
  trigger:
    platform: event
    event_type: xiaomi_aqara.click
    event_data:
      entity_id: binary_sensor.switch_158d000xxxxxc2
      click_type: double
  action:
    service: light.toggle
    data:
      entity_id: light.living_room_lamp

In diesem Beispiel der Doppelklick auf eine Aqara-Schaltfläche (Wesen mit Namen "binary_sensor.switch_158d000xxxxxc2") Integriert durch Gateway und die vorliegende Komponente "Xiaomi Gateway (Aqara) "verursacht eine Lampe (Entität des Namens"light.living_room_lamp") Ein- / Ausschalten.

ProProbleme

Sie können auf den Protokollen von finden Home Assistant Stimmen dieser Art:

2017-08-20 16:51:19 ERROR (SyncWorker_0) [homeassistant.components.xiaomi] No gateway discovered
2017-08-20 16:51:20 ERROR (MainThread) [homeassistant.setup] Setup failed for xiaomi: Component failed to initialize.

Dies bedeutet, dass die gateway wurde von nicht erkannt Home Assistant.

Um zu versuchen zu lösen, appDrängen Sie auf folgende Aspekte:

  • Vergewissern Sie sich, dass Sie den LAN-Zugang auf dem aktiviert haben gateway (Siehe Führung zur integration auf Home Assistant).
  • Deaktivieren Sie die Firewall auf dem Gerät, auf dem sie ausgeführt wird Home Assistant.
  • Stellen Sie sicher, dass der Router Wi-Fi unterstützt (und hat aktiviert) den Multicast-Dienst (mDNS).
  • Prodas Feld setzen "mac"Leer.
  • Prodas Feld setzen "discovery_retry"Zu 10.
  • Prozum Deaktivieren und erneuten Aktivieren des LAN-Zugriffs auf dem gateway.
  • Führen Sie einen Kaltstart des gateway: Drücken Sie die Taste für 30 Sekunden und führen Sie die proPaarung auf derapp "Xiaomi Mi Home".
  • Falls Home Assistant läuft auf Docker, stellen Sie sicher, dass Sie die "–net=host"(Muss der Datei hinzugefügt werden"/boot/cmdline.txt").
  • Für den Fall, dass versucht wird, das Licht des Lichts zu überprüfen gatewayist der Fehler{ "Fehler" : "Ungültiger Schlüssel" }, regenerieren Sie den Schlüssel (Betreff der Leitfaden zur Integration auf Home Assistant) mit einem Android-Smartphone (einige Instanzen haben proProbleme mit den von iOS erzeugten Schlüsseln) oder alternativ einen Emulator wie BlueStacks.
  • Falls die angeforderte Bibliothek „PyXiaomiGateway”Kann nicht installiert werden, einige notwendige Abhängigkeiten müssen zuerst installiert werden, wie zpython3-dev,libssl-dev,libffi-dev im manuellen Modus (zB $ sudo apt-get installiere python3-dev libssl-dev libffi-dev).


Home Assistant Offizielles LogoATTENZIONE: Denken Sie daran, dass es in unserer FORUM-Community gibt ein Ad-hoc-Bereich für Home Assistantfür jeden Zweifel, Frage, Information auf dem spezifischen Verdienst dieser Komponenten.