Zum Inhalt springen
Elausys

HyperVisu / Gerätekonfiguration

Gerätebibliothek & Sonos-Anbindung

Erstellen Sie vorkonfigurierte Widgets aus einem Katalog für Wechselrichter, Zähler, Ladestationen, Relais und Lautsprecher – inklusive Sonos-Anbindung.

elausys · 21 Juli 2026
Auf dieser Seite

Die Gerätebibliothek

Die Gerätebibliothek ist ein Katalog vorgefertigter Geräte-Vorlagen für bereits vorkonfigurierte Geräte: Energiezähler, Solar-Wechselrichter, Batteriespeicher, Wallboxen, intelligente Relais, Mediaplayer und Sonos-Lautsprecher. Sie wählen das Modell aus, füllen einige Felder aus – meist kaum mehr als die Geräteadresse – und die Bibliothek erstellt die Widgets mit bereits vollständig angebundenen Kommunikationsobjekten: inklusive Register, Topics, Pfade, Datentypen, Skalierungen und Einheiten. Arbeiten, die sonst einen halben Tag mit Registerhandbüchern erfordern, sind in einer Minute erledigt.

Öffnen Sie diese über Geräte → Aus Bibliothek hinzufügen.

Voraussetzungen: Das Gerät befindet sich mit fester IP-Adresse (DHCP-Reservierung) im Netzwerk, die erforderlichen Optionen in der Gerätekonfiguration sind aktiviert – Modbus TCP ist bei den meisten Wechselrichtern standardmäßig deaktiviert – und das Protokoll ist unter Dienste aktiviert (siehe „Dienste & Protokolle“).

Katalog durchsuchen

Jede Vorlage ist eine Kachel mit Marke, Modell, Protokoll-Badge und einer Kurzbeschreibung. Grenzen Sie die Auswahl ein über:

  • das Suchfeld – Marke, Modell, Gerätename oder Beschreibung; der Zähler rechts zeigt Treffer / Gesamt;
  • die Kategorie-Filter – jeweils einer pro im Katalog enthaltener Kategorie (aktuell Beleuchtung, Beschattung, Energie und Audio / Video);
  • die Dropdown-Menüs Marke und Protokoll.
Katalog der Gerätebibliothek: Suche mit Treffer-/Gesamtzähler, Kategorie-Filter, Marken- und Protokollfilter sowie Vorlagenkacheln.

Umfang der Bibliothek. Der Katalog wird mit dem Server ausgeliefert und mit jedem Update erweitert. Er enthält derzeit 83 Vorlagen von 49 Marken:

GerätefamilieUnterstützte Marken
Solar-Wechselrichter & Hybrid-WechselrichterSMA · Huawei (SUN2000) · SolarEdge · Sungrow · GoodWe · Growatt · FoxESS · Solax · Deye · SAJ · SofarSolar · Solplanet · Solinteg · SolarMax · M-TEC · Senergy · IBC Solar · Anker (SOLIX X1) · EcoFlow (PowerOcean)
Batteriespeicher & HeimspeicherMarstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE)
Energiemanager & DatenloggerHuawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog
EnergiezählerHomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S)
Ladestationen / WallboxenKEBA · Mennekes · Schneider (EVlink Pro) · Phoenix Contact (CHARX, EM-CP-PP-ETH, EV-SER) · Heidelberg · go-e · Bender · Peblar · EM2GO · OBO Bettermann · openWB · Stark in Strom
Schalt- & JalousierelaisShelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 roller)
Audio / VideoSonos (jede Zone) · AUDAC (XMP44)

Die meisten Energiegeräte kommunizieren über Modbus TCP. Shelly-Geräte stehen sowohl über HTTP als auch über MQTT zur Verfügung – als zwei separate Kacheln; wählen Sie diejenige, die Ihrer Gerätekonfiguration entspricht. HomeWizard nutzt HTTP, AUDAC TCP/UDP und Sonos ein eigenes Protokoll (siehe „Sonos-Integration“).

📘 Hinweis: Eine Vorlage deckt eine Produktfamilie ab, nicht nur eine einzelne Artikelnummer: Die Sonos-Vorlage passt für jede Zone, und die Shelly Plus 1-Vorlage funktioniert für 1 und 1PM. Wenn ein Hersteller das Register-Mapping zwischen Generationen geändert hat, sind die Generationen als separate Kacheln ausgeführt (Shelly Gen1 und Shelly Plus).

Gerät aus einer Vorlage erstellen

  1. Klicken Sie auf die Vorlagenkachel. Die Konfigurationsseite öffnet sich mit der Vorlagenbeschreibung und, falls vorhanden, dem Bereich Einrichtungsanforderungen. Lesen Sie diesen zuerst – er führt auf, was am Gerät vorbereitet sein muss: Installateur-Zugang, Aktivierung der Modbus-Option oder ein längeres Abfrageintervall bei langsam antwortenden Wechselrichtern.
  2. Geben Sie den Gerätenamen ein. Er dient als Präfix für jedes von der Vorlage erstellte Widget, z. B. ergibt „Garage“ die Bezeichnungen „Garage — Netz“, „Garage — Solar“ usw.
  3. Füllen Sie die Parameter der Vorlage aus – spezifische Einstellungen für die Widgets: eine Modbus-Unit-ID, eine Modellvariante aus dem Dropdown-Menü oder die Sonos-Zone. Die IP-Adresse wird hier nicht abgefragt: Sie gehört zur Verbindung und wird in Schritt 4 eingetragen.
  4. Öffnen Sie Verbindung. Die Liste zeigt nur Verbindungen des entsprechenden Protokolls an. Wählen Sie die Verbindung dieses Geräts aus oder wählen Sie – bei Geräten mit eigener IP-Adresse (Wechselrichter, Wallbox, Lautsprecher) – Neue Verbindung erstellen…: Der Dialog Verbindung hinzufügen öffnet sich mit vorausgefülltem Protokoll und Namen. Geben Sie dort die IP-Adresse des Geräts ein und klicken Sie auf Verbindung erstellen; die neue Verbindung wird direkt ausgewählt – ein Wechsel zur Verbindungsseite ist nicht erforderlich. Verweist bereits eine Verbindung auf diese Adresse, weist die Bibliothek darauf hin und verwendet diese wieder, anstatt ein Duplikat anzulegen. Vorlagen für gemeinsame Infrastruktur – wie ein MQTT-Broker – nutzen standardmäßig die bestehende Verbindung.
  5. Wählen Sie Raum und Kategorie für die Widgets aus. Beide Angaben sind Pflichtfelder.
  6. Der Bereich Zu erstellende Widgets zeigt eine Live-Vorschau des Ergebnisses.
Konfigurationsseite einer Wechselrichter-Vorlage: Parameter, Verbindung, Raum und Kategorie, ausgeklappte Einrichtungsanforderungen und Live-Vorschau.

Vorschau und Anpassungsmöglichkeiten

Jedes Widget in der Vorschau zeigt seinen Namen, den Widget-Typ und einen Zähler N / M Objekte angebunden. Die Vorlage bestimmt, welche Widgets vorausgewählt sind – üblicherweise die Basisfunktionen jeder Installation. Die übrigen sind standardmäßig nicht ausgewählt, da sie zusätzliche Hardware erfordern: Die Huawei-Vorlage wählt den Solar-Zähler vor, belässt Netz- und Batterie-Zähler jedoch abgewählt, bis der Smart Power Sensor installiert ist. Prüfen Sie die Einrichtungsanforderungen und wählen Sie nur die tatsächlich vorhandenen Komponenten aus. Vor der Erstellung können Sie:

  • jedes Widget an- oder abwählen – bei einer reinen Solaranlage wird kein Batteriespeicher erstellt;
  • Widgets direkt umbenennen;
  • den Objektzähler ausklappen, um alle Objekte zu prüfen: Nummer, Name, aufgelöste Adresse und Datentyp. Objekte, die in der Vorlage bewusst offen gelassen wurden, zeigen keine Adresse.

Fehlt ein Parameter oder liegt er außerhalb des gültigen Bereichs, weist ein roter Hinweistext auf den zu korrigierenden Parameter hin; die Schaltfläche zum Erstellen bleibt solange deaktiviert.

Klicken Sie auf N Widget(s) erstellen. Die Ergebnisseite zeigt die erstellten Elemente samt Objektanzahl sowie eventuelle Fehler mit Ursache an und bietet die Option Weiteres Gerät hinzufügen. Dies ist das Standardvorgehen für Mehrzonen-Systeme oder Sonos-Installationen, bei denen dieselbe Vorlage einmal pro Zone angewendet wird.

📘 Hinweis: Die Widgets sind gespeichert, aber noch nicht aktiv. Klicken Sie in der Seitenleiste auf Änderungen übernehmen und bestätigen Sie im Dialog Konfigurationsänderungen übernehmen (siehe „Übersicht Admin-Panel“), um die Protokolle neu zu starten und die Konfiguration an alle Clients zu übertragen.

Ergebnisseite nach dem Erstellen aus einer Vorlage mit Objektanzahl und aktivem Badge für Änderungen übernehmen.

Nach der Erstellung

Nach dem Erstellen verhalten sich die Widgets wie gewöhnliche Geräte – Sie können sie umbenennen, Symbole ändern, Räumen zuweisen, Logging aktivieren sowie in Ansichten, Szenen und Automationen einbinden. Die Anbindungen lassen sich wie manuelle Konfigurationen öffnen und bearbeiten (siehe „Modbus TCP-Integration“, „MQTT-Integration“).

Zähler aus einer Energie-Vorlage werden direkt mit ihrer zugewiesenen Rolle angelegt – Netz, Solar, Batterie, Ladestation, Verbraucher. Dadurch funktioniert der Bereich Energiemanagement mit seiner Leistungsbilanz ohne weitere Konfiguration (siehe „Energiegeräte“, „Energieübersicht“).

Vorlagen importieren und exportieren

Die Bibliothek unterstützt eigene Vorlagen: .yaml- oder .yml-Dateien mit maximal 256 KB im identischen Format der integrierten Vorlagen. Das Admin-Panel enthält keinen internen Vorlageneditor: Benutzerdefinierte Vorlagen werden als Textdatei in einem externen Editor erstellt und bearbeitet.

  • Über Vorlage importieren (oben rechts) laden Sie Dateien hoch. Vor dem Import erfolgt eine Validierung – fehlerhafte Vorlagen werden unter Angabe der Fehlerdetails abgewiesen und nicht gespeichert. Importierte Vorlagen erhalten auf ihrer Kachel den Hinweis Importiert.
  • Eine importierte Vorlage mit identischer Kennung wie eine Standardvorlage überschreibt diese; die Kachel zeigt Ersetzt integrierte Vorlage. Nach dem Löschen wird die Standardvorlage wiederhergestellt.
  • Importierte Vorlagen können über die Kachelsymbole exportiert (Als YAML exportieren) und gelöscht (Vorlage löschen) werden. Vorlage löschen löscht die Vorlage sofort ohne Sicherheitsabfrage.
  • Standardvorlagen können weder exportiert noch gelöscht werden: Die entsprechenden Symbole sind nicht vorhanden. Sie sind fester Bestandteil des Servers und werden bei jedem Update aktualisiert. Eigene Vorlagen basieren am besten auf dem Export einer importierten Vorlage oder einer neuen Textdatei.

⚠️ Warnung: Das Löschen einer Vorlage verändert keine daraus bereits erstellten Geräte. Diese bleiben voll funktionsfähig – lediglich die Vorlage wird entfernt.


Sonos-Anbindung

Sonos-Objekte werden an eine Zone angebunden, nicht an eine manuell eingegebene Adresse. Stellen Sie das Geräteprotokoll auf Sonos – oder nutzen Sie die Gerätebibliothek – und bearbeiten Sie die Objekteinstellungen:

FeldBeschreibung
Sonos-ZoneDie über dieses Widget gesteuerte Zone, ausgewählt aus der Zonenliste des Systems. Die gespeicherte Kennung bleibt auch nach dem Umbenennen des Raums in der Sonos-App oder bei Änderung der IP-Adresse gültig.
Auf gesamte Gruppe anwendenFür die Steuerobjekte Lautstärke-Sollwert und Stummschaltung Ein/Aus: Ist die Zone gruppiert, steuert der Befehl die gesamte Gruppe statt nur diesen Lautsprecher. Die Einstellung erfolgt separat pro Objekt, sodass z. B. die Lautstärke gruppenweit, die Stummschaltung jedoch individuell gesteuert werden kann. Die Option wird auch bei Lautstärke-Rückmeldung und Stummschaltung-Rückmeldung angezeigt, hat dort jedoch keine Auswirkung: Rückmeldungen spiegeln immer den Status der jeweiligen Einzelzone wider.

Alle Objekte des Widgets sind derselben Zone zugeordnet; die Objektnummer bestimmt die Funktion – Lautstärke, Stummschaltung, Wiedergabe/Pause, Quelle, Vorheriger/Nächster Titel, Titelname, Interpret, Albumcover. Zone Ein/Aus hat bei Sonos-Lautsprechern keine Funktion und bleibt unbelegt; daher verwendet die Bibliotheksvorlage den Audio-Untertyp ohne Zonen.

Klicken Sie auf Objekt speichern, danach in der Seitenleiste auf Änderungen übernehmen und bestätigen Sie (siehe „Übersicht Admin-Panel“).

📘 Hinweis: Gruppen werden ausschließlich in der Sonos-App verwaltet; HyperVisu bietet keine Gruppenverwaltung. Die Visualisierung zeigt keinen Gruppenstatus an: Jede Zone bleibt ein eigenständiges Audiogerät mit eigenem Lautstärkeregler und Stummschalter. Der Regler zeigt stets die zoneneigene Lautstärke an, auch wenn Befehle an die Gruppe gesendet werden. Die aktuelle Gruppierung ist in der Sonos-App oder unter Zonen in diesem Haushalt in der Sonos-Verbindung ersichtlich (siehe „Sonos-Integration“). Befehle für Wiedergabe, Pause, Vor und Zurück werden immer an den Gruppen-Koordinator übertragen.

Objekteditor des Lautstärke-Objekts eines Sonos-Widgets: Sonos-Anbindung, Zonen-ID und Gruppenschalter.

Quellen basieren auf Sonos-Favoriten. Oberhalb der Objektliste befindet sich der Bereich Sonos-Quellen. Ein Klick auf Sonos-Favoriten synchronisieren liest das System aus: Zuerst geräteeigene Eingänge (TV bei Soundbars, Line-In bei entsprechenden Modellen), danach die in der Sonos-App hinterlegten Favoriten. Namen und Anzahl werden in das Widget übernommen; die Visualisierung erzeugt für jeden Eintrag eine Quellentaste.

Die Liste ist hier schreibgeschützt und wird in der Sonos-App verwaltet. Nach dem Hinzufügen, Entfernen oder Umbenennen von Favoriten in der Sonos-App ist eine erneute Synchronisierung erforderlich, um die Auswahltasten zu aktualisieren.

Bereich Sonos-Quellen oberhalb der Objektliste mit synchronisierten Quellennamen und Synchronisieren-Schaltfläche.

💡 Tipp: Ab mehr als sechs Quellen schaltet die Visualisierung automatisch von Einzeltasten auf ein Dropdown-Menü um.

Häufig gestellte Fragen

Was konfiguriert eine Vorlage aus der Bibliothek automatisch?

Sie erstellt die ausgewählten Widgets mit vorkonfigurierten Protokollanbindungen, Datentypen, Skalierungen und Einheiten. Sie müssen lediglich die Geräteparameter und die Verbindung angeben.

Warum sind manche Widgets in der Vorschau nicht ausgewählt?

Diese erfordern optionale Hardware, die nicht in jeder Installation vorhanden ist, wie Netzzähler oder Batteriespeicher. Wählen Sie nur die tatsächlich verbauten Komponenten aus.

Warum ist das neu erstellte Bibliotheksgerät noch nicht aktiv?

Das Erstellen speichert die Widgets zunächst nur ab. Erst über „Änderungen übernehmen“ werden sie aktiviert und an die Clients übertragen.

Können eigene Vorlagen verwendet werden?

Ja. Sie können geprüfte YAML-Vorlagen importieren. Eine importierte Vorlage mit gleicher Kennung überschreibt die Standardvorlage; durch Löschen wird die integrierte Version wiederhergestellt.

Werden durch das Löschen einer Vorlage auch die daraus erstellten Geräte gelöscht?

Nein. Bereits erstellte Geräte behalten ihre Konfiguration und bleiben unverändert in Betrieb.

Wie werden die Sonos-Quellentasten aktualisiert?

Klicken Sie nach Änderungen an den Favoriten in der Sonos-App oberhalb der Objektliste auf „Sonos-Favoriten synchronisieren“. Die Verwaltung der Favoriten erfolgt in der Sonos-App.

Weiter erkunden

Finden Sie die weiteren Anleitungen zu diesem Produkt in der Dokumentation.

Zurück zu Gerätekonfiguration