Gree Smart-Home-Integration, kostenlos und Open Source
Gree-Klimageräte und Partnermarken im lokalen Netzwerk: Modus, Solltemperatur, Lüfter.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Steuere deine Gree-Klimageräte aus Gladys über dein lokales Netzwerk: Ein und Aus, Modus, Solltemperatur, Lüftergeschwindigkeit, Lamellen und die Zusatzfunktionen des Geräts. Die Integration funktioniert auch mit Gree-Geräten anderer Marken, die in der App Gree+ eingerichtet sind, zum Beispiel Cooper & Hunter, Trane, Innova, Proklima, Tadiran, Heiwa, Ekokai oder Lessar. Dazu gibt es ein Dashboard-Widget, einen Szenen-Auslöser und zwei Szenen-Aktionen. Kein Konto und keine Cloud: Gladys spricht direkt mit jedem Gerät, wie die App Gree+ in deinem WLAN.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde nach den veröffentlichten Beschreibungen des Gree-Protokolls geschrieben und gegen simulierte Geräte getestet, nicht gegen ein echtes Klimagerät. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues. Diese Integration ist nicht mit Gree verbunden.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Klimageräte mit einem Gree-WLAN-Modul, bereits mit der App Gree+ mit deinem WLAN verbunden (diese Ersteinrichtung kann Gladys nicht), im selben Netzwerk wie Gladys.
- Sonst nichts: kein Gree-Konto, kein Schlüssel, kein Internetzugang. Die Integration koppelt sich selbst und lokal mit jedem Gerät und behält den Schlüssel, den jedes Gerät ihr gibt.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Öffne ihre Konfiguration. Nichts ist Pflicht; die Optionen sind:
- IP-Adressen der Klimageräte: nur für Geräte, die die automatische
Erkennung nicht findet, durch Kommas getrennt (zum Beispiel
192.168.1.60, 192.168.1.61). Dein Router zeigt die Adresse jedes Geräts. Eine feste Adresse im Router ist eine gute Idee. - Aktualisierungsintervall: wie oft jedes Gerät gelesen wird, 10, 15, 30 oder 60 Sekunden (standardmäßig 30). So schnell sieht Gladys eine Änderung über die Fernbedienung oder die App Gree+.
- Signalton bei Befehlen von Gladys: Die Geräte piepen bei jedem Befehl, wie mit der Fernbedienung. „Lautlos“ bittet sie darum, es zu lassen, angenehm im Schlafzimmer; manche Firmware ignoriert es.
- Sprache der Gerätenamen: Englisch, Französisch, Deutsch oder Spanisch (standardmäßig Französisch). Die Namen der Funktionen eines Geräts werden beim Hinzufügen vergeben.
- IP-Adressen der Klimageräte: nur für Geräte, die die automatische
Erkennung nicht findet, durch Kommas getrennt (zum Beispiel
- Öffne den Tab Entdecken: Jedes gefundene Gerät erscheint, benannt mit „Gree“ und dem Namen aus der App Gree+ (oder dem Ende seiner MAC-Adresse). Füge die gewünschten hinzu. Die Taste Nach Klimageräten suchen in der Konfiguration sucht erneut und zeigt, was gefunden wurde.
Die Erkennung läuft über Gladys selbst (die Integration läuft in einem isolierten Container, der dein Netzwerk nicht per Broadcast erreicht): Gladys sendet die Suche an UDP-Port 7000, den Port des Gree-Protokolls, und gibt die Antworten weiter. Danach spricht die Integration direkt mit jedem Gerät. Alle 15 Minuten läuft eine neue Suche, um neue Geräte zu finden und einem Gerät mit neuer Adresse zu folgen.
Die Geräte in Gladys
Ein Gerät pro Klimagerät, mit diesen Funktionen:
| Funktion | Was sie tut |
|---|---|
| Klimagerät | Ein und Aus. |
| Modus | Auto, Kühlen, Heizen, Entfeuchten, Lüften. |
| Solltemperatur | 16 bis 30 °C, in ganzen Grad. |
| Innentemperatur | Die vom Gerät gemessene Temperatur, wenn es einen Fühler hat (nur lesen). |
| Lüftergeschwindigkeit | Auto, niedrig, mittel-niedrig, mittel, mittel-hoch, hoch, dazu „Leise“ und „Turbo“, die Vorrang haben. |
| Vertikale Lamellen | Standard, Schwenken oder eine von fünf festen Positionen. |
| Horizontale Lamellen | Ebenso, bei Geräten mit motorisierten seitlichen Lamellen. |
| Displaybeleuchtung | Anzeige und Leuchten des Innengeräts. |
| Energiesparen | Der Energiesparmodus des Geräts. |
| Frostschutz 8 °C | Hält den Raum auf 8 °C, im Heizmodus (das „8 °C“ der Fernbedienung). |
| Schlafmodus | Die Nachtkurve des Geräts: Die Solltemperatur ändert sich in der Nacht langsam. |
| X-Fan (Trocknung) | Lässt den Lüfter nach dem Ausschalten eine Weile laufen, um den Wärmetauscher zu trocknen (Kühlen, Entfeuchten). |
| Health (Ionisator) | Der Ionisator („Health“ oder „Kaltplasma“), bei Geräten, die einen haben. |
Eine Funktion erscheint nur, wenn das Gerät sie meldet: Ein Gerät ohne Fühler hat keine Innentemperatur, ein Gerät ohne motorisierte seitliche Lamellen keine horizontalen Lamellen. Taucht eine Funktion später auf (ein Fühler, der verspätet antwortet), bietet der Tab Entdecken an, das Gerät zu aktualisieren. Eine Funktion, die das Gerät meldet, aber nicht wirklich hat (das kommt vor), bleibt einfach wirkungslos.
Änderungen über die Fernbedienung oder die App Gree+ kommen innerhalb des Aktualisierungsintervalls in Gladys an. Ein Gerät, das nicht mehr antwortet (Stromausfall, WLAN verloren), behält seine letzten Werte in Gladys, mit einem Hinweis „nicht erreichbar“, bis es wieder antwortet.
Dashboard-Widget
Das Widget Klimageräte zeigt alle Gree-Geräte in Gladys auf einer Karte: für jedes seinen Modus, seine Solltemperatur und die Raumtemperatur, oder „Aus“, oder „Antwortet nicht“. Seine Taste Alle ausschalten schaltet mit einem Tipp alle eingeschalteten Geräte aus: beim Verlassen des Hauses, vor dem Schlafengehen. Das Widget hat keine Einstellungen.
Szenen
Auslöser
Klimagerät außerhalb von Gladys geändert: Jemand hat ein Gerät mit der
Fernbedienung oder der App Gree+ ein- oder ausgeschaltet oder seinen Modus
oder seine Solltemperatur geändert. Was Gladys selbst tut, löst ihn nie aus:
Eine Szene kann also auf die Fernbedienung reagieren, ohne auf ihre eigenen
Befehle zu reagieren. Filter (alle optional): das Klimagerät und die
Änderung: Eingeschaltet, Ausgeschaltet,
Modus oder Solltemperatur geändert. Variablen für die Aktionen: die
Änderung (turned_on, turned_off, settings), der Betrieb (on, off),
der Modus (auto, cool, heat, dry, fan), die Solltemperatur und die
Innentemperatur in °C.
Aktionen
- Mit Einstellungen einschalten: schaltet ein Klimagerät mit einem Modus und optional einer Solltemperatur (16 bis 30 °C) und einer Lüftergeschwindigkeit ein, in einem einzigen Befehl, also mit einem einzigen Signalton. Die Aktion gibt die Innentemperatur zurück, für eine Benachrichtigung. Die üblichen Gladys-Aktionen auf den Funktionen des Geräts gehen auch, je ein Befehl.
- Alle Klimageräte ausschalten: schaltet alle Gree-Geräte in Gladys aus, die eingeschaltet sind und antworten, auch die, die nach dem Erstellen der Szene hinzugefügt wurden. Die Aktion gibt zurück, wie viele ausgeschaltet wurden.
Ideen für Szenen
- Haus verlassen: Wenn die letzte Person geht, „Alle Klimageräte ausschalten“, dann eine Nachricht mit der Zahl der ausgeschalteten Geräte senden.
- Schlafzimmer vor dem Schlafen kühlen: Im Sommer um 22 Uhr, wenn das Schlafzimmer über 26 °C hat, „Mit Einstellungen einschalten“ auf dem Gerät im Schlafzimmer: Kühlen, 25 °C, leiser Lüfter.
- Jemand hat die Fernbedienung genommen: Bei „Klimagerät außerhalb von Gladys geändert“, Änderung „Eingeschaltet“, während ein Fensterkontakt ein offenes Fenster meldet: die Nachricht „Die Klimaanlage läuft bei offenem Fenster“ senden.
Fehlerbehebung
- Kein Gerät gefunden: Prüfe, ob das Gerät mit der App Gree+ verbunden und im selben Netzwerk wie Gladys ist (nicht in einem Gast-WLAN), dann drücke Nach Klimageräten suchen. Fehlt es immer noch, gib seine IP-Adresse in der Konfiguration ein. Der Bericht unter der Taste sagt, wenn die automatische Erkennung nicht verfügbar ist.
- „verweigert die Kopplung“: Das Gerät antwortet, gibt aber seinen Schlüssel nicht heraus. Starte es neu (eine Minute an der Sicherung ausschalten) und suche dann erneut.
- Antwortet nicht: Das Gerät ist an der Sicherung aus, außerhalb der WLAN-Reichweite oder hat eine neue Adresse. Eine Suche findet es unter seiner neuen Adresse; eine feste Adresse im Router vermeidet das Problem.
- Mit der App Gree+ neu gekoppelt: Ein zurückgesetztes oder in der App neu hinzugefügtes Gerät bekommt einen neuen Schlüssel. Die Integration merkt es und koppelt sich selbst neu.
- Das Gerät piept bei jedem Befehl: Wähle „Lautlos“ für Signalton bei Befehlen von Gladys. Manche Firmware ignoriert es.
- Die Protokolle: Die Integration schreibt nur ihren Lebenslauf (Start,
gefundene, verlorene und wiedergefundene Geräte, Fehler) und eine Zeile pro
Befehl. Mehr Details mit
LOG_LEVEL=debug. Die Schlüssel der Geräte erscheinen nie in den Protokollen.
Grenzen
- Ohne die Hardware entwickelt: Das Protokoll ist das, das die App Gree+ im lokalen Netzwerk nutzt, wie es Open-Source-Projekte beschreiben, aber die Integration wurde noch nicht an einem echten Gerät ausprobiert.
- Die erste WLAN-Einrichtung eines Geräts braucht die App Gree+.
- Geräte hinter einem Multi-Split- oder VRF-Gateway (ein WLAN-Modul für mehrere Innengeräte) werden nicht unterstützt, ebenso wenig die Gree-Luftentfeuchter.
- Nur ganze Grad, in Celsius; ein Gerät, das Fahrenheit anzeigt, behält seine Anzeigeeinheit.
- Die Innentemperatur ist die des Fühlers im Gerät: nahe der Decke, oft etwas wärmer als der Raum.
- Die Geräte melden ihre Änderungen nicht: Gladys liest sie im Aktualisierungsintervall, eine Änderung über die Fernbedienung erscheint also innerhalb dieser Zeit.
- Anfragen: ein kurzer UDP-Austausch pro Gerät bei jeder Aktualisierung, nichts im Internet; es gibt kein Kontingent.
- Die Schlüssel der Geräte liegen im Datenvolume der Integration
(
/data/gree-state.json), nur für sie lesbar.
Konfigurationseinstellungen
Diese Einstellungen fragt Gree in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Klimageräte finden | section | Nein | Gree-Klimageräte (und Cooper & Hunter, Trane, Ekokai… in der App Gree+ eingerichtet) im selben Netzwerk wie Gladys werden automatisch gefunden: Öffne den Tab „Entdecken“. Fehlt eines, gib unten seine IP-Adresse ein. |
| IP-Adressen der Klimageräte | string | Nein | Optional, durch Kommas getrennt. Nur für Geräte nötig, die die automatische Erkennung nicht findet. |
| Aktualisierungsintervall | select | Nein | Wie oft jedes Klimagerät gelesen wird, um Änderungen über die Fernbedienung oder die App Gree+ zu verfolgen. |
| Signalton bei Befehlen von Gladys | select | Nein | Die Geräte piepen bei jedem Befehl. „Lautlos“ bittet sie darum, es zu lassen, für Schlafzimmer; manche Firmware ignoriert es. |
| Sprache der Gerätenamen | select | Nein | Namen der Funktionen neuer Geräte (Modus, Lüftergeschwindigkeit, Displaybeleuchtung…). |
So installierst du Gree in Gladys
- Öffne in Gladys Integrationen: Gree erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-gree:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-gree.
Gree benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Gree ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation