Zum Hauptinhalt springen

GE Appliances (SmartHQ) Smart-Home-Integration, kostenlos und Open Source

GE Appliances (SmartHQ)-Integration für Gladys Assistant

GE, Café, Monogram, Haier, Hotpoint über SmartHQ: Wäsche, Geschirr, Kühlschrank, Klimageräte.

Auf GitHub ansehenAlle Integrationen

Überblick​

Diese Integration bringt die vernetzten Haushaltsgeräte von GE Appliances über die SmartHQ-Cloud in Gladys: GE, GE Profile, Café, Monogram, Haier (USA) und Hotpoint. Waschmaschinen, Trockner und Geschirrspüler zeigen Zustand, Programm und Restzeit; Backöfen und Herde ihre Temperatur und Timer; Kühlschränke ihre Temperaturen, Sollwerte, Türen und den Wasserfilter; Fenster- und mobile Klimageräte steuerst du wie jedes Klimagerät in Gladys.

Änderungen kommen innerhalb von Sekunden über die Echtzeitverbindung von SmartHQ an. Zwei Szenenauslöser („Programm beendet“, „Gerätewarnung“), eine Szenenaktion (einen Geschirrspüler pausieren oder stoppen) und ein Dashboard-Widget (laufende Geräte, Restzeit) ergänzen die Geräte.

Sicherheit zuerst: Nichts, was heizt, wird je aus der Ferne gestartet. Backöfen, Herde und Warmwasserbereiter sind schreibgeschützt; ein Geschirrspüler kann pausiert oder gestoppt, nie gestartet werden; Waschmaschinen und Trockner sind schreibgeschützt.

Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Diese Integration hat keine Verbindung zu GE Appliances oder Haier; GE, SmartHQ, Café, Monogram, Profile und Hotpoint sind deren Marken.

Voraussetzungen​

  • Gladys Assistant 5.1.0 oder neuer.
  • Geräte, die bereits in der SmartHQ-App (der nordamerikanischen App von GE Appliances) gekoppelt sind, mit verbundenem WLAN-Modul.
  • Die E-Mail-Adresse und das Passwort dieses SmartHQ-Kontos. Ein Konto mit Bestätigungscode (Zwei-Faktor-Authentifizierung) funktioniert auch: siehe Konfiguration.
  • Internetzugang für Gladys: GE-Geräte haben keine lokale API, alles läuft über die SmartHQ-Cloud.

Konfiguration​

  1. Öffne in Gladys Integrationen, installiere GE Appliances (SmartHQ) und öffne den Reiter Konfiguration.
  2. Trag die E-Mail-Adresse und das Passwort deines SmartHQ-Kontos ein. Lass die Region des Kontos auf „USA“, außer dein Konto wurde in Europa angelegt.
  3. Wähle die Temperatureinheit (standardmäßig °C; GE-Geräte arbeiten in °F, die Werte werden umgerechnet) und die Sprache der Funktionsnamen. Wähle beides, bevor du die Geräte hinzufügst: Namen und Einheiten eines Geräts werden beim Hinzufügen festgelegt.
  4. Speichere. Der Status wechselt auf „verbunden“ und die Geräte erscheinen im Reiter Entdecken: Füge die gewünschten hinzu.
  5. Verlangt SmartHQ einen Bestätigungscode, sagt es der Status. Führe die Aktion Bestätigungscode senden aus (SmartHQ schickt ihn per E-Mail), dann Bestätigungscode eingeben mit dem erhaltenen Code, innerhalb von 15 Minuten. Die Integration behält danach ein Aktualisierungstoken in ihrem privaten Volume: Beim nächsten Neustart wird kein Code mehr verlangt.

Die Aktion Verbindung testen listet die Geräte des Kontos auf.

Ein abgelehntes Passwort wird erst wieder versucht, wenn du es geändert und gespeichert hast: wiederholte Fehlversuche könnten das Konto sperren. Verlangt SmartHQ, neue Nutzungsbedingungen zu akzeptieren, akzeptiere sie in der SmartHQ-App und speichere dann die Konfiguration erneut: Die Integration akzeptiert nie Bedingungen an deiner Stelle.

Die Geräte​

Ein Gladys-Gerät pro GE-Gerät, benannt nach seinem Spitznamen in SmartHQ. Eine Funktion wird nur angelegt, wenn das Gerät den Wert dazu liefert.

  • Waschmaschinen, Trockner, Waschtrockner: Zustand, Programm (GE-Namen, auf Englisch), Restzeit, voraussichtliches Ende, Startvorwahl, Tür, Warnungen (Abpumpproblem, verstopfte Trockner-Abluft). Schreibgeschützt.
  • Geschirrspüler: Zustand, Programm, Programmphase (Vorspülen, Hauptspülgang, Trocknen…), Restzeit, voraussichtliches Ende, Tür, Fernsteuerung aktiviert, Warnungen (Klarspüler fast leer, Filter reinigen). Pausieren oder Stoppen nur über die Szenenaktion.
  • Backöfen und Herde: für jeden Garraum (oben und unten bei einem Doppelbackofen) Zustand (Vorheizen, Garen, Warmhalten, Reinigung…), erreichte Temperatur, Solltemperatur, Restzeit eines zeitgesteuerten Garvorgangs, Kurzzeitwecker. Schreibgeschützt: keine Einstellung, kein Start.
  • Kühlschränke und Getränkekühler: Temperaturen von Kühlschrank und Gefrierfach, Sollwerte von Kühlschrank und Gefrierfach (änderbar, innerhalb der Grenzen des Geräts), Tür (offen, sobald eine Tür offen ist), Zustand und Lebensdauer des Wasserfilters, Warnungen (Filter, Leck, Tür offen, zu warm).
  • Klimageräte (Fenster, mobil, Split, Einbau): Ein/Aus, Modus (Kühlen, Nur Lüfter, Entfeuchten, Heizen und Auto je nach Gerät), Sollwert (in ganzen Grad), Lüftergeschwindigkeit (Auto, niedrig, mittel, hoch), Raumtemperatur, Filterwarnung.
  • GeoSpring-Warmwasserbereiter: Wassertemperatur, Sollwert und Modus, schreibgeschützt.
  • Opal-Eismaschinen: Zustand (Eisbereitung, Eisbehälter voll, Wasser nachfüllen…) und Warnungen, schreibgeschützt.

Türen folgen Gladys: 0 bedeutet offen, 1 geschlossen. Ein von SmartHQ getrenntes Gerät behält seine letzten Werte, zeigt „Nicht verbunden“ als Zustand, und sein Abzeichen wechselt auf „nicht erreichbar“.

Widget​

Das Widget GE-Geräte listet, was läuft: Waschmaschinen, Trockner, Geschirrspüler und Backöfen, das beschäftigtste zuerst, mit Programm, Phase und voraussichtlichem Ende, und einem Abzeichen mit der Restzeit (oder „Pausiert“, „Beendet“, „Alarm“). Läuft nichts, sagt es eine Zeile. Es aktualisiert sich jede Minute und sobald ein Gerät startet oder stoppt.

Szenenauslöser und Szenenaktion​

  • GE-Programm beendet: Eine Waschmaschine, ein Trockner oder Geschirrspüler hat das Programm beendet, oder ein zeitgesteuerter Garvorgang eines Backofens ist abgelaufen. Filter: das Gerät. Variablen: Gerätename, Programm.
  • Warnung eines GE-Geräts: Ein Gerät meldet eine neue Warnung (Tür offen, Wasserleck, Wasserfilter, Klarspüler, verstopfte Trockner-Abluft, Filter des Klimageräts, Eismaschine…). Filter: das Gerät, die Warnungen. Variablen: Gerätename, Warnung (in der eingestellten Sprache), Warncode.
  • GE-Geschirrspüler pausieren/stoppen (Aktion): pausiert oder stoppt das Programm eines Geschirrspülers, dessen Fernsteuerung am Gerät aktiviert ist. Die Aktion startet und setzt nie ein Programm fort. Ausgabe: Befehl gesendet.

Ein Auslöser feuert einmal pro Übergang, nie beim Start.

Szenenbeispiele​

  • Wäsche fertig: Auslöser „GE-Programm beendet“ an der Waschmaschine → der Familie die Nachricht „Die Waschmaschine ist fertig ({{triggerEvent.data.cycle}})“ senden.
  • Kühlschranktür offen gelassen: Auslöser „Warnung eines GE-Geräts“, Warnung „Kühlschranktür offen“ → Benachrichtigung, und das Küchenlicht blinken lassen.
  • Ruhezeiten: um 22 Uhr → „GE-Geschirrspüler pausieren/stoppen“ mit „Pausieren“ (folgenlos abgelehnt, wenn nichts läuft).
  • Schlafzimmer vor dem Schlafengehen kühlen: im Sommer um 21 Uhr → Klimagerät im Schlafzimmer ein, Modus Kühlen, Sollwert 22 °C.

Aktualisierung und Kontingente​

Die Integration verlässt sich nicht auf das Abfragen durch Gladys, das für externe Integrationen unzuverlässig ist (GladysAssistant/Gladys#3198): Die Integration hält eine SmartHQ-Echtzeitverbindung offen, erhält jede Änderung innerhalb von Sekunden und liest alle Geräte von sich aus alle 10 Minuten vollständig (das Sicherheitsnetz und der Herzschlag der Werte, die sich nie ändern). Gladys erhält nur die geänderten Werte, und einen unveränderten Wert alle 6 Stunden erneut.

GE veröffentlicht für SmartHQ weder API-Bedingungen noch Kontingente. Die Integration folgt dem Takt von gehomesdk, der Bibliothek der Home-Assistant-Integration: eine Verbindung, ein Keep-Alive alle 30 Sekunden, die Geräteliste alle 10 Minuten, Befehle nur, wenn du handelst. Eine verlorene Verbindung wird nach 10 Sekunden wieder geöffnet, dann nach 20, 40… bis zu 15 Minuten.

Fehlerbehebung​

  • „SmartHQ hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfe sie in der SmartHQ-App, korrigiere sie, speichere.
  • „SmartHQ verlangt einen Bestätigungscode“: Führe „Bestätigungscode senden“ aus, dann „Bestätigungscode eingeben“ innerhalb von 15 Minuten.
  • „Neue Nutzungsbedingungen“: Öffne die SmartHQ-App, akzeptiere sie und speichere die Konfiguration erneut.
  • Ein Gerät fehlt: Es muss in der SmartHQ-App desselben Kontos erscheinen. Nicht unterstützte Gerätetypen (Mikrowellen, Kochfelder, Dunstabzugshauben, Minibacköfen…) werden nicht veröffentlicht; die Logs sagen es einmal.
  • Temperaturen in der falschen Einheit: Ändere die Einheit, speichere und nutze dann Aktualisieren am Gerät im Reiter Entdecken (oder lösche es und füge es neu hinzu).
  • Mehr Details: Setz LOG_LEVEL=debug für die Integration. Die Logs enthalten nie das Passwort, die Tokens oder die Verbindungsadresse.

Grenzen​

  • Ohne GE-Geräte und ohne SmartHQ-Konto entwickelt und getestet, mit aus gehomesdk abgeleiteten Werten: Rückmeldungen sind willkommen, besonders zu den Werten, die deine Geräte liefern.
  • Nur Cloud: Ohne Internet wird nichts aktualisiert.
  • Backofentüren, Spender von Kühlschränken und in Kühlschränke eingebaute Eismaschinen sind nicht in den Daten enthalten, die die Integration liest.
  • Waschmaschinen und Trockner können nicht aus der Ferne pausiert oder gestoppt werden (GE bietet diesen Befehl nicht an); ein Geschirrspüler nur, wenn seine Fernsteuerung am Gerät aktiviert ist.
  • Mikrowellen, Advantium, Kochfelder, Dunstabzugshauben, Luftentfeuchter, Kaffeemaschinen, Wasserfilter und Enthärter werden noch nicht unterstützt.
  • Die Namen der Wasch- und Trockenprogramme bleiben auf Englisch, so wie GE sie benennt.

Konfigurationseinstellungen​

Diese Einstellungen fragt GE Appliances (SmartHQ) in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Bevor du anfängstsectionNeinGE-Geräte haben keine lokale API: Alles läuft über die SmartHQ-Cloud, mit dem Konto der SmartHQ-App (GE, GE Profile, Café, Monogram, Haier, Hotpoint). Trag die E-Mail-Adresse und das Passwort ein und speichere. Verlangt das Konto einen Bestätigungscode, führe die Aktion „Bestätigungscode senden“ aus, dann „Bestätigungscode eingeben“ mit dem erhaltenen Code. Nichts, was heizt, wird je aus der Ferne gestartet. Keine Verbindung zu GE Appliances oder Haier.
E-Mail-AdressestringJaDie E-Mail-Adresse deines SmartHQ-Kontos.
PasswortsecretJaDas Passwort deines SmartHQ-Kontos. Ein abgelehntes Passwort wird erst wieder versucht, wenn du es änderst.
Region des KontosselectNeinUSA für fast alle Konten (die SmartHQ-App für Nordamerika).
TemperatureinheitselectNeinEinheit der Temperaturen und Sollwerte der Geräte. GE-Geräte arbeiten in °F: Die Werte werden umgerechnet. Wähle sie, bevor du die Geräte hinzufügst.
SpracheselectNeinFunktionsnamen neuer Geräte, Zustände und Widget. Wasch- und Trockenprogramme behalten die GE-Namen, auf Englisch.

So installierst du GE Appliances (SmartHQ) in Gladys​

  1. Öffne in Gladys Integrationen: GE Appliances (SmartHQ) erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-smarthq:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-smarthq.

GE Appliances (SmartHQ) 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​

GE Appliances (SmartHQ) 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am