ioBroker.xiaomi-gateway3

Xiaomi-Gateway3 ioBroker-Adapter

Dieser Adapter ermöglicht es ioBroker, mit dem Xiaomi Gateway 3 zu kommunizieren und damit Xiaomi-Geräte zu steuern. Die Kommunikation mit dem Gateway erfolgt über das MQTT-Protokoll (der Adapter verbindet sich mit dem integrierten MQTT-Broker). Gateway und Geräte müssen jedoch über Mi Home (Cloud) gekoppelt werden.

Frühe Version

Der Adapter befindet sich derzeit noch in der Entwicklungsphase, verfügt aber bereits über einsatzbereite Funktionen.

Für eine erfolgreiche Adapterentwicklung ist die Unterstützung der Community, insbesondere beim Testen von Adaptern und Geräten, unerlässlich.

Danke

Ein Großteil des Codes basiert auf dem AlexxIT -Projekt XiaomiGateway3 und wurde von diesem neu geschrieben.

Wie können Sie helfen?

Zunächst können Sie den Adapter einfach installieren, ihn verwenden und etwaige Probleme melden.

Wenn Sie viele verschiedene Geräte besitzen, können Sie deren Unterstützung verbessern, indem Sie die entsprechende Option aktivieren.Debug output (to state) (siehe unten) und geben Sie mir nach einigen Tagen der Datenerfassung eine Debug-Ausgabe.

Hardware und Grenzen

Der Adapter unterstütztXiaomi Gateway 3 (ZNDMWG03LM and ZNDMWG02LM) Diese Versionen laufen mit der Original-Firmware:

v1.5.0_0026 (darauf aufgebaut)
v1.5.0_0102 (ähnlich1.5.0_0026 (aber nicht getestet)

Sie können das Gateway mit benutzerdefinierter oder Standard-Firmware dieser Versionen flashen: wiki .

Achtung: Firmware-Versionen niedriger als1.4.7_0000 Der Adapter wird nicht unterstützt und wird es auch zukünftig nicht. Unterstützt werden Versionen unterhalb vonv1.5.0_0026 Nicht garantiert.

Unterstützte Geräte

Getestet
Nicht getestet

ZigBee-Geräte

BLE-Geräte

Hinweis: BLE-Geräte verfügen nach dem ersten Koppeln möglicherweise nicht über Statusinformationen, da mir die Gerätespezifikationen noch nicht bekannt sind und ich daher noch nicht für alle Geräte Eigenschaften definiert habe. Statusinformationen werden hinzugefügt, sobald das Gerät die entsprechenden Eigenschaften aktualisiert. Ich hoffe, ich kann dies mit Ihrer Hilfe im Laufe der Zeit beheben.

Beschreibung einiger Staaten

`Button long press`

Bei Tastengeräten können Sie eine Kombination aus zwei Zuständen sehen (zum Beispiel):long_press Undlong_timeout Wie funktioniert das? Tasten, die langes Drücken unterstützen, senden beim Drücken und Loslassen eine Nachricht. Manchmal kann es vorkommen, dass eine Taste beim Loslassen keine Nachricht sendet. In diesem Falltimeout sollte dazu beitragen, den Zustand "freizugeben".

Standardmäßigtimeout Zustandswert nicht gesetzt undlong_press Die Taste wird nach einer Sekunde losgelassen, nachdem Sie sie gedrückt gehalten haben, auch wenn Sie sie noch gedrückt halten. Wenn Sie einstellenlong_timeout Ein Timeout von -1 wird vollständig ignoriert und der Status wird nur durch eine Nachricht vom Button "freigegeben".

In den meisten Fällen ist es sinnvoll, festzulegentimeout auf einen kleinen Wert wie 4 oder 5 Sekunden.

`Occupancy` Und`Occupancy timeout`

Der RTCGQ11LM und andere Bewegungsmelder weisen nach der Bewegungserkennung eine Verzögerung (Timeout) von 5 bis 60 Sekunden auf (abhängig von Version und Modifikationen). Das bedeutet, dass während dieser Zeit keine weitere Bewegung erkannt werden kann (der Sensor sendet technisch gesehen keine Nachricht).

occupancytrifft zu, wenn der Sensor eine Bewegung erkennt, und bleibt gültig .

Ziel vonoccupancy_timeout ist festgelegtoccupancy wird auf „false“ gesetzt, wenn der Sensor wieder Nachrichten senden kann. Standardmäßigoccupancy_timeout ist nicht festgelegt undoccupancy Nach 60 Sekunden wieder auf „false“ zurücksetzen. Falls Ihr Sensor eine andere Verzögerung aufweist, ist es besser, diese einzustellen.occupancy_timeout bis zu diesem Verzögerungswert.

Wenn Sie die Bewegungserkennung direkt nach dem Erkennen wieder auf „false“ zurücksetzen möchten, können Sie Folgendes einstellen:occupancy_timeout bis zu 1 Sekunde.

Konfiguration

Um ein Gateway zu verbinden, benötigen Sie die IP-Adresse und das Token des Gateways. Dies können Sie manuell oder über die Cloud tun.

Außerdem müssen Sie den Befehl „telnet open“ auswählen (in den meisten Fällen Option 2). Sie können die Verbindung und Telnet über die Schaltflächen testen.

Hierbei handelt es sich nicht um einen eigentlichen Ping, sondern eher um eine Überprüfung der Geräteverfügbarkeit.

Sie haben mehrere Möglichkeiten, Adapter und Gateway zu konfigurieren.

Adaptereinstellungen

Statistiken sammeln
Der Adapter erfasst Statistiken über die Nachrichten der ZigBee-Geräte: wie viele empfangen wurden, wie viele verloren gingen usw. Die Statistiken werden im Status jedes Geräts gespeichert und können auf der Registerkarte (über das Seitenmenü) angezeigt werden.
Hinweis: Der Adapter setzt die Statistik beim Neustart zurück.
Debug-Ausgabe (zum Status)
Der Adapter gibt für jedes Gerät einige Debug-Informationen im Status aus.

Grundlegende Gateway3-Einstellungen

Telnet aktiviert
Standardmäßig aktiviert und muss aktiviert bleiben. Nur zur Information.
Öffentliches MQTT aktiviert
Standardmäßig aktiviert und muss aktiviert bleiben. Nur zur Information.
Firmware sperren
Setzen Sie den Wert auf „true“ (oder „false“), um die Möglichkeit zum Aktualisieren der Gateway-Firmware zu deaktivieren (bzw. zu aktivieren).
Summer deaktivieren
Stellen Sie „true“ ein, um störende Summersignale zu deaktivieren, oder „false“, um alle Signale zu aktivieren.

Erweiterte Gateway3-Einstellungen

Speicherung im Arbeitsspeicher (Beta)
Verschieben Sie die Gerätedatenbankdateien in den Arbeitsspeicher. Dies kann die Funktion von ZigBee- und Bluetooth-Geräten verbessern. Es kann jedoch zu Datenverlust kommen. Die Verwendung erfolgt auf eigene Gefahr.

Protokollierungseinstellungen

Hinweis: Um Debug-Meldungen im ioBroker-Protokoll anzuzeigen, müssen Sie Folgendes einstellen:debug Protokollierungsstufe für Adapter unterInstances Seite (Expertenmodus aktivieren)

Lumi MQTT-Nachrichten
Aktivieren Sie die Debug-Protokollierung von MQTT-Nachrichten für Lumi (ZigBee)-Geräte.
Ble MQTT-Nachrichten
Aktivieren Sie die Debug-Protokollierung von MQTT-Nachrichten für BLE-Geräte.
Der Rest
Aktivieren Sie die Debug-Protokollierung aller anderen Adaptermeldungen.
SPAM schneiden
Aktivieren Sie die Option zum Ausblenden doppelter Meldungen. Wenn identische Fehlermeldungen mehrmals auftreten, werden sie ausgeblendet und nach einer Stunde als Gesamtzahl angezeigt.

Registerkartenseite

Geräte

Es gibt Gerätekarten aufdevices Seite, auf der Sie Informationen über das Gerät und aktuelle Statuswerte einsehen und einige davon steuern können.

Sie können auch ändernfriendly name des Geräts.

Hinweis: Diese Seite bietet derzeit nur grundlegende Funktionen. Sie wird in Zukunft erweitert.

Gerätekonfiguration

Sie können verschiedene Optionen zur Konfiguration des Geräts (und seiner Karte) mithilfe einer YAML-Konfiguration festlegen. Die verfügbaren Optionen sind in der folgenden Tabelle beschrieben. Sie können das Gerätekonfigurationsfenster (Fenster mit Texteingabefeld) mit folgendem Befehl aufrufen:Config Im Menü auswählen.

Gerätekonfigurationsoptionen

Feld	Typ	Beschreibung
Kartenzustände	Wörterbuch	Dieses Wörterbuch enthält Optionen für Zustände in der Gerätekarte
Kartenzustände ausblenden	Liste	Liste der Bundesstaaten (Bundesstaats-IDs), die auf der Gerätekarte ausgeblendet werden müssen

Statistik

Statistiken werden nicht standardmäßig geladen. Sie müssen die Schaltfläche verwenden.RELOAD um die Statistik auf der Seite zu aktualisieren.
Außerdem können Sie die Statistik mit der Schaltfläche löschen.CLEAR Dadurch werden die Statistiken nicht wirklich gelöscht. Es werden lediglich die Zustände gelöscht, die Statistiken enthalten. Dies kann hilfreich sein, wenn der Adapter neu gestartet wird, da die ioBroker-Zustände beim Neustart nicht gelöscht werden.

Achtung: Beachten Sie bitte, dass es sich hierbei nicht um eine Statistik der ZigBee-Nachrichten zwischen Gateway und Gerät (ZigBee-Protokollstatistik) handelt. Es ist eine Statistik der Nachrichten, die den Adapter erreichen. Was bedeutet das? Es macht keinen Unterschied, ob das Gateway oder der Adapter selbst (per MQTT) keine Nachrichten vom Gateway empfängt. Sollte der Adapter aus irgendeinem Grund (z. B. bei einem WLAN-Verbindungsproblem) keine Nachrichten vom Gateway empfangen, interpretiert er diese als verloren, obwohl ZigBee selbst weiterhin funktioniert.

Changelog

0.3.6 (2022-06-14)

Fixes and improvements

0.3.5 (2022-05-08)

Added configuration for devices
Added cutting SPAM messages at log
Remove unnecessary Debug log option
Fixes and improvements

0.3.4 (2022-02-10)

Fix issue getting devices from cloud and switch to RC4
Add devices page
Other fixes and improvements

0.3.3 (2022-01-30)

Fix lumi temperature and voltage

0.3.2 (2022-01-30)

Bug fixes and code improvements
Add curtain and buttons support
Update README

0.3.1 (2022-01-17)

Bug fixes and code improvements
Improved support firmware 1.5.1_0032 and some devices

0.3.0 (2021-12-10)

Improved adapter logging

0.2.0 (2021-12-07)

Added states classes and rewrote code with using them
Added tab-page of adapter
Added zigbee (lumi) devices statistic
A lot of code improvements

0.1.0 (2021-11-09)

(Evgenii Abramov) Added support for BLE devices (needed tests)
(Evgenii Abramov) Improvements for zigbee and BLE support
(Evgenii Abramov) Added output for debug purpose
(Evgenii Abramov) A lot of code improvements

0.0.1-alpha.0 (2021-10-13)

(Evgenii Abramov) Initial release

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Xiaomi Gateway 3