Zum Hauptinhalt springen

hOn Smart-Home-Integration, kostenlos und Open Source

hOn-Integration für Gladys Assistant

Haier-, Candy- und Hoover-Geräte der hOn-App: Waschmaschinen, Trockner, Klima, Kühlschränke.

Auf GitHub ansehenAlle externen Integrationen

Überblick​

Diese Integration holt die Haier-, Candy- und Hoover-Geräte Ihrer hOn-App in Gladys: Waschmaschinen, Waschtrockner, Wäschetrockner, Geschirrspüler, Klimaanlagen, Kühlschränke, Gefrierschränke, Weinkühlschränke und Backöfen. Sie verfolgen Zustand, Phase und Restzeit auf dem Dashboard, starten ein Programm oder pausieren einen Durchlauf aus Gladys, und Ihre Szenen reagieren, wenn ein Programm endet, ein Fehler auftritt oder das Salz ausgeht.

Sie kommuniziert mit der hOn-Cloud über das Konto der App, über dieselbe inoffizielle Schnittstelle wie die App (Haier veröffentlicht keine API): Ihre Geräte und deren Zustände laufen über die Server von Haier, über das Internet. Haier kann diese Schnittstelle ohne Vorankündigung ändern.

Voraussetzungen​

  • Gladys Assistant 5.1.1 oder neuer.
  • Ein hOn-Konto (E-Mail-Adresse und Passwort), in dem Ihre Geräte in der hOn-App bereits hinzugefügt und verbunden sind. Melden Sie sich einmal in der App an, wenn Sie das Konto gerade erstellt oder das Passwort geändert haben (Bedingungen zu akzeptieren).
  • Konten mit Zwei-Schritt-Bestätigung per E-Mail werden nicht unterstützt.

Konfiguration​

Konto​

Geben Sie die E-Mail-Adresse und das Passwort Ihres hOn-Kontos ein und speichern Sie. Das Passwort wird von Gladys gespeichert und nur an die hOn-Cloud gesendet; die Sitzung (nie das Passwort) behält die Integration, damit ein Neustart sich nicht erneut anmeldet: Die hOn-Cloud sperrt Konten, die sich zu oft anmelden.

Drücken Sie Verbindung testen: Die Meldung listet Ihre Geräte und ihren Zustand auf. Lehnt hOn das Konto ab, wartet die Integration 15 Minuten (dann länger), bevor sie es erneut versucht; korrigieren Sie E-Mail-Adresse oder Passwort, um sofort neu zu versuchen.

Aktualisierungsintervall und Sprache​

  • Aktualisierungsintervall: Der Zustand der Geräte wird alle 30 Sekunden, jede Minute (Standard), alle 2 oder 5 Minuten gelesen.
  • Sprache der Gerätetexte: Funktionsnamen und Textzustände (Gerätezustand, Phase) werden in dieser Sprache geschrieben, da Gladys Ihre Sprache dabei nicht übermittelt.

Fernsteuerung​

Wie in der hOn-App nimmt eine Waschmaschine, ein Trockner oder ein Geschirrspüler einen Start, eine Pause oder einen Stopp nur an, wenn die Fernsteuerung am Bedienfeld aktiviert ist: beladen, Tür schließen, dann die Fernsteuerungs- oder WLAN-Taste drücken. Die Funktion Fernsteuerung des Geräts zeigt, ob sie aktiv ist. Backöfen sind nur lesbar: kein Fernstart aus Gladys.

Verwendung​

Geräte​

Öffnen Sie den Tab Entdecken der Integration: Jedes Gerät des Kontos ist mit den Funktionen aufgeführt, die es meldet. Fügen Sie die gewünschten hinzu.

  • Waschmaschinen, Waschtrockner, Trockner, Geschirrspüler: Zustand (läuft, pausiert, beendet, Startzeitvorwahl…), Phase (Waschen, Spülen, Schleudern, Trocknen…), Programm (eines wählen, um es zu starten), Restzeit, Pause, Tür, Fernsteuerung, Energieverbrauch und Wasserverbrauch (Modelle, die sie melden), Fehler, bei Geschirrspülern zudem Salz nachfüllen und Klarspüler nachfüllen.
  • Klimaanlagen: Ein/Aus, Modus, Sollwert, Lüfterstufe, Schwenkung, Innen- und Außentemperatur.
  • Kühlschränke, Gefrierschränke, Weinkühlschränke: Temperatur und Sollwert jeder Zone, Türen, Superkühlen, Supergefrieren, Urlaubs- und Automatikmodus (steuerbar, wenn das Modell es erlaubt), Raumtemperatur und -luftfeuchte.
  • Backöfen und andere Typen: Zustand, Temperaturen, Restzeit, Fehler.

Jedes Gerät trägt ein Abzeichen Cloud, oder nicht erreichbar, wenn es nicht mit der hOn-Cloud verbunden ist. Die Programmnamen sind die der hOn-Cloud, auf Englisch.

Widgets​

Die Widgets „hOn-Geräte“ und „hOn-Gerät“: Zustand, Phase und Restzeit jedes Geräts, Fortschritt der Waschmaschine mit ihren Tasten Pause und Stopp (generierte Illustration, kein Screenshot)

  • hOn-Geräte: jedes Gerät mit Zustand, Phase und Restzeit (oder Temperaturen) und eine Taste Aktualisieren. Einstellung: alle Geräte oder nur die laufenden.
  • hOn-Gerät: ein Gerät (Einstellung): Zustand, Phase, Programm, Fernsteuerung, Fortschritt, Restzeit, Temperaturen und die Tasten Pause, Fortsetzen, Stoppen (mit Bestätigung) oder Einschalten / Ausschalten.

Szenenauslöser​

  • Ein hOn-Programm startet und Ein hOn-Programm ist beendet (Filter: Gerät, Typ): Variablen Gerätename, Typ, Programm, verbleibende Minuten oder Dauer.
  • Ein hOn-Gerät meldet einen Fehler: Variable Fehlercode.
  • Ein hOn-Gerät muss nachgefüllt werden: Salz, Klarspüler, Waschmittel oder Weichspüler.
  • Ein hOn-Gerät geht offline / ist wieder online.
  • Das hOn-Konto wird abgelehnt: Gladys erhält keine Zustände mehr.

Ein von einer Szenenaktion gestartetes oder gestopptes Programm löst diese Auslöser nicht aus (keine Schleife).

Szenenaktionen​

  • hOn-Programm starten: Gerät, Programmname (von der Schaltfläche Programme auflisten der Konfiguration, z. B. cottons), optionale Startzeitvorwahl in Minuten. Ausgaben: Programm, geschätzte Dauer.
  • hOn-Programm pausieren, fortsetzen oder stoppen.
  • Zustand eines hOn-Geräts lesen: Ausgaben Gerätezustand, Phase, Programm, verbleibende Minuten, verbunden, Fehlercode, für eine Bedingung oder Nachricht.

Szenenbeispiele​

  • Wenn das Programm der Waschmaschine beendet ist → „Die Wäsche ist fertig ({{triggerEvent.data.duration_minutes}} Min.)“ an die Familie senden.
  • Wenn der Geschirrspüler Salz braucht → „Salz“ in die Einkaufslisten-Benachrichtigung aufnehmen.
  • Werktags um 13 Uhr, wenn der Strom günstig ist → hOn-Programm starten eco_40_60 auf der morgens beladenen Waschmaschine (Fernsteuerung aktiv).

Fehlerbehebung​

  • „hOn hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfen Sie sie in der hOn-App. Dieselbe Meldung erscheint, wenn sich das Konto zu oft angemeldet hat: warten, die Integration versucht es selbst erneut. Konten mit Zwei-Schritt-Bestätigung per E-Mail können sich nicht anmelden.
  • Kein Gerät: Fügen Sie sie zuerst in der hOn-App hinzu und drücken Sie dann Verbindung testen.
  • „Die Fernsteuerung ist deaktiviert“: Aktivieren Sie sie am Bedienfeld; bei den meisten Modellen schaltet sie sich am Programmende wieder ab.
  • Ein Befehl wird angenommen, aber nichts passiert: Das Gerät führt ihn in wenigen Sekunden aus; es wird 5 und 20 Sekunden später erneut gelesen. Prüfen Sie Tür und Fernsteuerung.
  • Eine Funktion fehlt: Die Funktionen folgen dem, was das Modell an die hOn-Cloud meldet; eröffnen Sie ein Issue mit Typ und Modell.
  • Protokolle: der Tab Protokolle der Integration, mit DEBUG=gladys-integration-sdk für Details. Issues: https://github.com/William-De71/gladys-hon/issues

Konfigurationseinstellungen​

Diese Einstellungen fragt hOn in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Gladys mit Ihrem hOn-Konto verbindensectionNeinVerwenden Sie das Konto der mobilen hOn-App, in der Ihre Haier-, Candy- oder Hoover-Geräte bereits hinzugefügt sind. Gladys kommuniziert mit der hOn-Cloud (eine inoffizielle API, die der App): Ihre Geräte und deren Zustände laufen über die Server von Haier. Fügen Sie die Geräte anschließend im Tab Entdecken hinzu.
hOn-E-Mail-AdressestringJa
hOn-PasswortsecretJaWird von Gladys gespeichert und nur an die hOn-Cloud gesendet. Konten mit Zwei-Schritt-Bestätigung per E-Mail werden nicht unterstützt.
AktualisierungsintervallselectNeinWie oft der Zustand der Geräte aus der hOn-Cloud gelesen wird.
Sprache der GerätetexteselectNeinFunktionsnamen und Textzustände (Gerätezustand, Phase). Gladys übermittelt Ihre Sprache dabei nicht.
Ein Programm aus Gladys startensectionNeinWie in der hOn-App nimmt eine Waschmaschine, ein Trockner oder ein Geschirrspüler einen Start, eine Pause oder einen Stopp nur an, wenn die Fernsteuerung am Bedienfeld aktiviert ist (beladen, Tür schließen, dann die Fernsteuerungs- oder WLAN-Taste drücken). Die Funktion „Fernsteuerung“ des Geräts zeigt es an.

So installierst du hOn in Gladys​

  1. Öffne in Gladys Integrationen: hOn erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-hon:0.1.0) 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/William-De71/gladys-hon.

hOn benötigt Gladys >=5.1.1. 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​

hOn 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 William-De71 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