Hive Smart-Home-Integration, kostenlos und Open Source
Steuern Sie Hive-Heizung, Warmwasser, Lampen, Steckdosen und Sensoren.
Veröffentlicht von gboulvin
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Steuern Sie Ihre Hive-Geräte (Centrica / British Gas) mit Gladys Assistant: Heizung, Warmwasser, Heizkörperthermostate, Lampen, Steckdosen, Bewegungs- und Tür-/Fenstersensoren sowie die Automationen („Aktionen“) der Hive-App.
Dies ist eine Cloud-Integration: Gladys spricht mit der Hive-Cloud, die auch die Hive-App nutzt, und benötigt eine Internetverbindung.
Unterstützte Geräte
| Hive-Produkt | In Gladys |
|---|---|
| Active Heating (Thermostat) | Thermostat: Temperatur, Sollwert, Modus, Heizen, Batterie |
| Heizkörperthermostat-Zone (TRV) | Thermostat: Temperatur, Sollwert, Modus, Heizen, Batterie |
| Warmwasser | Warmwasserbereiter: Modus (Zeitplan / an / aus), Boost, Heizen |
| Active Light (warmweiß, einstellbar, farbig) | Lampe: an/aus, Helligkeit, Weißton, Farbe |
| Active Plug | Steckdose: an/aus, Leistung (W) |
| Bewegungsmelder | Bewegung, Temperatur, Batterie |
| Tür-/Fenstersensor | Öffnung, Batterie |
| Hive-Aktionen (Automationen) | Ein Schalter, um jede Aktion zu aktivieren oder deaktivieren |
Thermostatmodi: Zeitplan (folgt dem Hive-Zeitplan), Manuell (hält den Sollwert) und Aus (Frostschutz). Wird bei ausgeschalteter Heizung eine Temperatur eingestellt, wechselt sie zu Manuell.
Konfiguration
- Öffnen Sie den Reiter Konfiguration der Integration.
- Geben Sie E-Mail-Adresse und Passwort Ihres Hive-Kontos ein und speichern Sie.
- Hive bestätigt eine neue Anmeldung meist mit einem per SMS gesendeten Code. Der Verbindungsstatus zeigt das an: Geben Sie den Code im Feld SMS-Code ein und speichern Sie innerhalb von 3 Minuten.
- Gladys ist danach ein gemerktes Gerät Ihres Hive-Kontos (es erscheint als „Gladys Assistant“ in der Geräteliste des Kontos): Spätere Anmeldungen brauchen keinen Code mehr, auch nicht nach einem Neustart.
- Ihre Geräte erscheinen im Reiter Erkennung und können hinzugefügt werden.
Weitere Einstellungen:
- Aktualisierungsintervall (standardmäßig 60 s, mindestens 30 s): wie oft Gladys die Hive-Cloud liest. Sensoren (Bewegung, Tür) werden mit dieser Verzögerung erkannt — Hive sendet keine Ereignisse an Dritte.
- Standard-Boost-Dauer / -Temperatur: für den Warmwasser-Boost, die Widget-Tasten und leer gelassene Szenenaktionen.
- Schwelle für schwache Batterie: Wert, unter dem der Auslöser „Hive- Batterie schwach“ auslöst.
Tasten
- Verbindung testen — meldet sich mit den gespeicherten Einstellungen neu an (kann einen neuen SMS-Code senden) und zählt die Geräte.
- Hive-Geräte aktualisieren — liest das Zuhause neu ein, z. B. nach dem Hinzufügen einer Lampe in der Hive-App.
- Hive-Sitzung vergessen — vergisst das gemerkte Gerät und die Sitzung: Die nächste Anmeldung fragt nach einem neuen SMS-Code.
Szenen
Die Integration fügt dem Szeneneditor eigene Karten hinzu (Gladys 5.1 oder neuer).
Auslöser: Hive-Bewegung erkannt, Hive-Tür oder -Fenster (geöffnet /
geschlossen), Hive-Boost beendet, Hive-Gerät online / offline,
Hive-Batterie schwach ({{triggerEvent.data.battery}}). Der Gerätename
steht in {{triggerEvent.data.device_name}}.
Aktionen: Hive-Heizung boosten (Zone, Dauer, Temperatur) und beenden, Hive-Warmwasser boosten (Dauer) und beenden, Hive-Heizmodus einstellen (Zeitplan, manuell mit Temperatur, aus), Hive-Warmwassermodus einstellen (Zeitplan, immer an, aus). Eine leere Zone bedeutet die erste des Zuhauses. Jede Aktion meldet, ob sie funktioniert hat.
Dashboard
- Widget Hive-Heizung: Live-Temperatur und Sollwert einer Zone, Modus, verbleibende Boost-Zeit, Kesselaktivität, Batterie, mit den Tasten Boost / Boost beenden / Zurück zum Zeitplan.
- Widget Hive-Zuhause: Verbindung, Warmwasser, eingeschaltete Lampen, offene Türen und Fenster, Offline-Geräte und schwache Batterien, mit einer Warmwasser-Boost-Taste.
Fehlerbehebung
- „Hive hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfen Sie sie in der Hive-App.
- „Falscher SMS-Code“ / „Der SMS-Code ist abgelaufen“: Nutzen Sie Verbindung testen, um einen neuen Code zu erhalten.
- Ein Gerät ist „nicht erreichbar“: Hive meldet es offline.
Die Sitzung (gemerktes Gerät, Erneuerungstoken) wird im privaten
/data-Volume der Integration gespeichert, niemals das Passwort.
Konfigurationseinstellungen
Diese Einstellungen fragt Hive in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ihr Hive-Konto | section | Nein | Melden Sie sich mit der E-Mail-Adresse und dem Passwort der Hive-App an. Hive bestätigt eine neue Anmeldung meist mit einem per SMS gesendeten Code: Wenn der Verbindungsstatus danach fragt, geben Sie den Code unten ein und speichern Sie innerhalb von 3 Minuten. Danach merkt sich Ihr Hive-Konto Gladys und braucht keinen Code mehr. |
| Hive-E-Mail | string | Ja | |
| Hive-Passwort | secret | Ja | |
| SMS-Code | string | Nein | Nur wenn der Verbindungsstatus danach fragt: der von Hive per SMS gesendete Code. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft Gladys die Hive-Cloud liest. Sensoren werden mit dieser Verzögerung erkannt. |
| Standard-Boost-Dauer (Min.) | number | Nein | |
| Standard-Boost-Temperatur Heizung (°C) | number | Nein | |
| Schwelle für schwache Batterie (%) | number | Nein |
So installierst du Hive in Gladys
- Öffne in Gladys Integrationen: Hive erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-hive: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/gboulvin/Gladys-Hive.
Hive 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
Hive 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 gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation