inkVisioninkVision

Anleitung

Mit Home Assistant verbinden

Installieren Sie die inkVision-Integration für Home Assistant und fügen Sie das Gerät in Ihrem lokalen Netzwerk hinzu.

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/HomeBrainz/ha-inkVision hinzu.
  4. Setzen Sie die Kategorie auf Integration.
  5. Installieren Sie inkVision.
  6. Starten Sie Home Assistant neu.

Option 2: Manuelle Installation

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

Umstieg Von Der HomeBrainz-Integration

  • Die Integration hieß früher HomeBrainz. Nach dem Update in HACS und einem Neustart von Home Assistant werden Ihre Geräte automatisch zu inkVision übernommen und behalten ihre Entitäts-IDs und ihren Verlauf.
  • Aktionen wurden von homebrainz.* in inkvision.* umbenannt. Die alten Namen funktionieren weiterhin, und unter Einstellungen > Reparaturen sehen Sie, wenn eine Automatisierung noch einen davon verwendet.
  • HACS lässt den alten Ordner custom_components/homebrainz zurück. Eine Reparaturmeldung bietet an, ihn zu löschen; starten Sie Home Assistant danach 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 inkVision.
  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 findet das Gerät im lokalen Netzwerk normalerweise automatisch, die manuelle Eingabe der IP-Adresse funktioniert aber immer als Alternative.

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 inkVision-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.