Guide
Connect to Home Assistant
Install the HomeBrainz Home Assistant integration and add the device on your local network.
Bevor Sie Beginnen
Dieser Leitfaden beschreibt den aktuellen lokalen Home Assistant-Weg für Atmos Wi‑Fi-Geräte, nachdem sie bereits mit Ihrem Heim-Wi‑Fi verbunden sind.
- Sie benötigen ein Atmos-Gerät, das bereits mit Ihrem Heimnetzwerk verbunden ist.
- Sie benötigen eine funktionierende Home Assistant-Instanz im selben lokalen Netzwerk.
- Sie benötigen die IP-Adresse des Geräts oder ein Netzwerk, in dem Home Assistant discovery das Gerät erreichen kann.
- Sie können prüfen, ob das Gerät online ist, indem Sie http://DEVICE_IP/ im Browser öffnen.
- Nützliche lokale Seiten und Endpunkte des Geräts sind /, /ota, /status, /sensors, /config.json und /ws.
Option 1: Installation Über HACS
- Öffnen Sie HACS in Home Assistant.
- Öffnen Sie Integrations.
- Fügen Sie das benutzerdefinierte Repository https://github.com/11ado33/ha-homebrainz-integration hinzu.
- Setzen Sie die Kategorie auf Integration.
- Installieren Sie HomeBrainz.
- Starten Sie Home Assistant neu.
Option 2: Manuelle Installation
- Öffnen Sie Ihren Home Assistant-Konfigurationsordner.
- Erstellen Sie custom_components/homebrainz, falls es noch nicht existiert.
- Kopieren Sie die Dateien aus dem Ordner custom_components/homebrainz des Integrations-Repositorys in diesen Ordner.
- Starten Sie Home Assistant neu.
Fügen Sie Die Integration In Home Assistant Hinzu
- Öffnen Sie in Home Assistant Settings > Devices & Services.
- Wählen Sie Add Integration.
- Suchen Sie nach HomeBrainz.
- Wenn Home Assistant das Gerät automatisch erkennt, wählen Sie es aus.
- Wenn nicht, geben Sie die IP-Adresse des Geräts manuell ein.
- Schließen Sie den Konfigurationsablauf ab.
Home Assistant discovery kann mit aktuellen HomeBrainz- und inkVision-Namensvarianten funktionieren, aber die manuelle Eingabe der IP-Adresse ist immer eine gültige Fallback-Option.
Was Hinzugefügt Wird
- Sensor-Entitäten für Temperatur, Luftfeuchtigkeit, Druck, Wi‑Fi-Signalstärke und Luftqualitätswerte.
- Steuerung für Helligkeit und Zeitzone.
- Steuerung für Bildschirmrotation.
- Aktionen zum Prüfen und Installieren von Firmware.
- Lautsprecher- oder Media-Player-Steuerung in unterstützten Builds.
Verwenden Sie Die Integrierten Geräteseiten
Vor oder nach dem Hinzufügen des Geräts zu Home Assistant können Sie den lokalen Gerätestatus direkt auf den integrierten Seiten vergleichen.
- Öffnen Sie http://DEVICE_IP/.
- Verwenden Sie das inkVision Device Dashboard, um Gerätezustand, Live-Sensorwerte, Helligkeit, Bildschirmrotation, OTA-Prüf- oder Installationsaktionen und Neustart-Steuerungen zu prüfen.
- Öffnen Sie http://DEVICE_IP/ota, wenn Sie eine lokale Firmware-.bin-Datei manuell hochladen möchten.
- Wenn Home Assistant veraltete Werte anzeigt, vergleichen Sie sie mit dem Dashboard oder den Rohantworten von /status und /sensors.
Verbindung Überprüfen
- Öffnen Sie die neue HomeBrainz-Geräteseite in Home Assistant.
- Bestätigen Sie, dass sich die Sensorwerte aktualisieren.
- Öffnen Sie den lokalen Weblink des Geräts aus Home Assistant, falls verfügbar.
- Wenn Ihr Build Steuerelemente enthält, testen Sie eine sichere Aktion wie die Helligkeit.
Fehlerbehebung
Wenn discovery nicht funktioniert, stellen Sie sicher, dass Home Assistant und das Atmos-Gerät im selben LAN oder in einem erreichbaren lokalen Subnetz sind, prüfen Sie, ob http://DEVICE_IP/status antwortet, und fügen Sie die Integration mit der IP-Adresse erneut manuell hinzu.
Wenn einige Entitäten fehlen, beachten Sie, dass Sensor-Entitäten einen Build mit Sensoren benötigen, Lautsprechersteuerungen einen Build mit Audio und Display-Steuerungen einen Build mit Display.
Wenn die Integration hinzugefügt wurde, sich die Werte aber nicht aktualisieren, laden Sie die Integration neu, starten Sie das Atmos-Gerät einmal neu und prüfen Sie die Home Assistant-Logs auf Verbindungs- oder WebSocket-Fehler.
Wenn Sie die IP-Adresse des Geräts nicht kennen, prüfen Sie die Client-Liste Ihres Routers oder verwenden Sie einen lokalen Netzwerkscanner.