Zum Inhalt springen
HabitatOSby GeckioDokumentation

Dokumentation durchsuchen

Suche in Titeln und vollständigen Artikeln

    App öffnen
    Alle Themen

    Home Assistant verbinden

    Home Assistant dient als Gerätebrücke. HabitatOS spricht die REST-Schnittstelle deiner Home-Assistant-Instanz an; die eigentlichen Geräte sind dort bereits eingerichtet.

    Voraussetzungen#

    • Funktionierende Geräte und Entitäten in Home Assistant.
    • Eine vom HabitatOS-Backend erreichbare Basisadresse.
    • Ein eigener Long-Lived Access Token für die Anbindung.
    • Freigabe der exakten Bridge-Origin auf dem HabitatOS-Server; im Produktivbetrieb HTTPS.

    Eine lokal erreichbare Adresse auf deinem Smartphone ist nicht automatisch vom HabitatOS-Server erreichbar. Die Freigabe vertrauenswürdiger Origins muss der Betreiber einrichten.

    Gerät in der Web-App hinzufügen#

    1. Prüfe das Gerät zuerst direkt in Home Assistant.
    2. Notiere die Haupt-Entitäts-ID, zum Beispiel light.terrarium oder switch.terrarium_light.
    3. Notiere bei Bedarf getrennte Temperatur- und Feuchte-Entitäten, etwa sensor.terrarium_temperature.
    4. Öffne im persönlichen Web-Konto den Bereich „Geräte“ und wähle „Gerät hinzufügen“. In der lokalen Demo ist ausschließlich „Demo / simuliert“ verfügbar.
    5. Trage Name, Gerätetyp und Aufgabe ein und wähle das zugehörige Terrarium.
    6. Wähle bei „Schnittstelle“ den Eintrag „Home Assistant“. Trage die Haupt-Entitäts-ID in „Externe Geräte-ID“ ein.
    7. Fülle „Home-Assistant-Adresse“ und „Langlebiger Home-Assistant-Zugriffsschlüssel“ aus. Verwende nur die zuvor freigegebene, vom Backend erreichbare HTTPS-Adresse.
    8. Beim Typ „Temperatur-/Feuchtigkeitssensor“ kannst du „Temperatur-Entität (optional)“ und „Luftfeuchtigkeits-Entität (optional)“ ergänzen. Ohne Zusatzangaben verwendet der Adapter die externe Geräte-ID als Temperatursensor.
    9. Wähle „Gerät speichern“. Prüfe anschließend den gelesenen Zustand und bei einem schaltbaren Gerät eine kontrollierte Aktion mit erneutem Rücklesen.

    Tokens werden an das HabitatOS-Backend übertragen. Die Implementierung verschlüsselt die Gerätezugänge serverseitig und entfernt sie aus öffentlichen Geräteantworten. Tokens niemals in Support-Anhänge oder Screenshots aufnehmen.

    Ergebnis prüfen#

    Die gelesenen Zustände müssen zu Home Assistant passen. Ein erfolgreich angelegter Datensatz allein bestätigt keine Verbindung. Bei Problemen prüfe Verbindung und Zugang sowie die Betriebsgrenzen.

    Verbindung vor dem Einsatz prüfen#

    Führe nach der Einrichtung die Geräteprüfung durch. Kontrolliere einen Befehl am Verbraucher und frage den Zustand erneut ab. Bei Sensordaten vergleiche Wert und Messzeitpunkt mit der Quelloberfläche; dafür gibt es die Sensorprüfung.

    Noch keine Zentrale gewählt? Der Geckio-Ratgeber zu Home Assistant im Terrarium erklärt Architektur und Geräteauswahl. Diese Anleitung beschreibt die anschließende HabitatOS-Verbindung.

    Stand: 2 Min. Lesezeit

    Noch eine Frage? Schreib uns oder öffne die Fehlerhilfe.