inkVisioninkVision

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

  1. Öffnen Sie HACS in Home Assistant.
  2. Öffnen Sie Integrations.
  3. Fügen Sie das benutzerdefinierte Repository https://github.com/11ado33/ha-homebrainz-integration hinzu.
  4. Setzen Sie die Kategorie auf Integration.
  5. Installieren Sie HomeBrainz.
  6. Starten Sie Home Assistant neu.

Option 2: Manuelle Installation

  1. Öffnen Sie Ihren Home Assistant-Konfigurationsordner.
  2. Erstellen Sie custom_components/homebrainz, falls es noch nicht existiert.
  3. Kopieren Sie die Dateien aus dem Ordner custom_components/homebrainz des Integrations-Repositorys in diesen Ordner.
  4. Starten Sie Home Assistant neu.

Fügen Sie Die Integration In Home Assistant Hinzu

  1. Öffnen Sie in Home Assistant Settings > Devices & Services.
  2. Wählen Sie Add Integration.
  3. Suchen Sie nach HomeBrainz.
  4. Wenn Home Assistant das Gerät automatisch erkennt, wählen Sie es aus.
  5. Wenn nicht, geben Sie die IP-Adresse des Geräts manuell ein.
  6. 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.

  1. Öffnen Sie http://DEVICE_IP/.
  2. Verwenden Sie das inkVision Device Dashboard, um Gerätezustand, Live-Sensorwerte, Helligkeit, Bildschirmrotation, OTA-Prüf- oder Installationsaktionen und Neustart-Steuerungen zu prüfen.
  3. Öffnen Sie http://DEVICE_IP/ota, wenn Sie eine lokale Firmware-.bin-Datei manuell hochladen möchten.
  4. Wenn Home Assistant veraltete Werte anzeigt, vergleichen Sie sie mit dem Dashboard oder den Rohantworten von /status und /sensors.

Verbindung Überprüfen

  1. Öffnen Sie die neue HomeBrainz-Geräteseite in Home Assistant.
  2. Bestätigen Sie, dass sich die Sensorwerte aktualisieren.
  3. Öffnen Sie den lokalen Weblink des Geräts aus Home Assistant, falls verfügbar.
  4. 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.