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#
- Prüfe das Gerät zuerst direkt in Home Assistant.
- Notiere die Haupt-Entitäts-ID, zum Beispiel
light.terrariumoderswitch.terrarium_light. - Notiere bei Bedarf getrennte Temperatur- und Feuchte-Entitäten, etwa
sensor.terrarium_temperature. - Ö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.
- Trage Name, Gerätetyp und Aufgabe ein und wähle das zugehörige Terrarium.
- Wähle bei „Schnittstelle“ den Eintrag „Home Assistant“. Trage die Haupt-Entitäts-ID in „Externe Geräte-ID“ ein.
- Fülle „Home-Assistant-Adresse“ und „Langlebiger Home-Assistant-Zugriffsschlüssel“ aus. Verwende nur die zuvor freigegebene, vom Backend erreichbare HTTPS-Adresse.
- 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.
- 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.