Naar de inhoud
Elausys

HyperVisu / Apparaatconfiguratie

Apparatenbibliotheek & Sonos-koppeling

Maak direct gekoppelde widgets aan vanuit een catalogus met omvormers, meters, laadpalen, relais en luidsprekers — en koppel Sonos-zones.

elausys · 21 juli 2026
Op deze pagina

De apparatenbibliotheek

De apparatenbibliotheek is een catalogus van kant-en-klare apparaattemplates voor apparatuur die al voor u is gemapt: energiemeters, omvormers voor zonnepanelen, thuisbatterijen, laadpalen, slimme relais, mediaspelers en Sonos-luidsprekers. U kiest het model, vult enkele velden in — meestal niet meer dan het adres van het apparaat — en de bibliotheek maakt de widgets aan met al hun communicatieobjecten al gekoppeld: inclusief registers, topics, paden, datatypes, schaling en eenheden. Werk dat anders een middag kost met een registerhandleiding, is nu in een minuut klaar.

Open deze via Apparaten → Toevoegen uit bibliotheek.

Wat u nodig heeft: het apparaat op het netwerk met een vast adres (een DHCP-reservering), eventuele benodigde opties ingeschakeld in de eigen configuratie van het apparaat — Modbus TCP staat op de meeste omvormers standaard uit — en het protocol geactiveerd in Services (zie “Services & protocollen”).

Bladeren door de catalogus

Elke template is een kaart met het merk, het model, de protocolbadge en een korte beschrijving. Verfijn de lijst met:

  • het zoekveld — merk, model, apparaatnaam of beschrijving; de teller rechts toont overeenkomend / totaal;
  • de categorieknoppen — één per categorie die daadwerkelijk in de catalogus aanwezig is (momenteel Verlichting, Zonwering, Energie en Audio / Video);
  • de dropdownmenu's Merk en Protocol.
De catalogus van de apparatenbibliotheek: zoeken met de teller voor overeenkomend/totaal, categorieknoppen, merk- en protocolfilters en de templatekaarten.

Wat de bibliotheek omvat. De catalogus wordt meegeleverd met de server en groeit bij elke update. Deze bevat momenteel 83 templates van 49 merken:

ApparaatfamilieOndersteunde merken
PV-omvormers & hybride omvormersSMA · Huawei (SUN2000) · SolarEdge · Sungrow · GoodWe · Growatt · FoxESS · Solax · Deye · SAJ · SofarSolar · Solplanet · Solinteg · SolarMax · M-TEC · Senergy · IBC Solar · Anker (SOLIX X1) · EcoFlow (PowerOcean)
Thuisbatterijen & opslagMarstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE)
Energiemanagers & dataloggersHuawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog
EnergiemetersHomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S)
LaadpalenKEBA · 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
Verlichtings- & zonweringsrelaisShelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 roller)
Audio / videoSonos (elke zone) · AUDAC (XMP44)

De meeste energieapparaten communiceren via Modbus TCP. Shelly-modules worden aangeboden via zowel HTTP als MQTT — twee afzonderlijke kaarten; kies degene die past bij hoe het apparaat is geconfigureerd. HomeWizard gebruikt HTTP, AUDAC TCP/UDP, en Sonos zijn eigen protocol (zie “Sonos-integratie”).

📘 Opmerking: Een template heeft betrekking op een productfamilie, niet op één specifiek artikelnummer: de Sonos-template is geschikt voor elke zone, en de Shelly Plus 1-template past op zowel de 1 als de 1PM. Waar een fabrikant de registerindeling tussen generaties heeft gewijzigd, worden de generaties als afzonderlijke kaarten getoond (Shelly Gen1 en Shelly Plus).

Een apparaat aanmaken vanuit een template

  1. Klik op de templatekaart. De configuratiepagina opent met de beschrijving van de template en, indien van toepassing, het paneel Installatievereisten. Lees dit eerst — hierin staat wat op het apparaat zelf ingesteld moet zijn: een installateursaccount, een in te schakelen Modbus-optie, of een omvormer die traag reageert en een langere poll-interval vereist.
  2. Voer de Apparaatnaam in. Deze dient als voorvoegsel voor elke widget die door de template wordt aangemaakt, dus "Garage" levert "Garage — Net", "Garage — Zonne-energie", enzovoort op.
  3. Vul de parameters van de template in — wat de widgets zelf nodig hebben: een Modbus unit ID, een modelvariant uit een dropdownmenu, of de Sonos-zone. Het formulier vraagt niet om het IP-adres: dit hoort bij de verbinding en voert u in bij stap 4.
  4. Open Verbinding. De lijst toont alleen verbindingen voor het protocol van de template. Selecteer de verbinding van dit apparaat of kies — voor een apparaat met een eigen IP-adres (een omvormer, een wallbox, een luidspreker) — Een nieuwe verbinding aanmaken…: het dialoogvenster Verbinding toevoegen opent met het protocol en de naam al ingevuld. Voer daar het IP-adres van het apparaat in en klik op Verbinding aanmaken; de nieuwe verbinding is direct geselecteerd — u hoeft niet eerst naar de pagina Verbindingen te gaan. Als een verbinding al naar dat adres verwijst, meldt de bibliotheek dit en wordt deze hergebruikt in plaats van een duplicaat aan te maken. Templates voor gedeelde infrastructuur — zoals een MQTT-broker — selecteren standaard de bestaande verbinding.
  5. Kies de Ruimte en de Categorie waarin de widgets worden geplaatst. Beide zijn verplicht.
  6. Het paneel Aan te maken widgets toont direct een live voorbeeld van het resultaat.
De configuratiepagina van een omvormertemplate: parameters, verbinding, ruimte en categorie, uitgeklapte installatievereisten en het live voorbeeld.

Het voorbeeld en wat u kunt wijzigen

Elke widget in het voorbeeld toont zijn naam, het widgettype en een teller N / M objecten gekoppeld. De template bepaalt welke widgets standaard zijn aangevinkt — meestal de widgets die in elke installatie aanwezig zijn. De overige worden uitgevinkt aangeboden omdat ze afhankelijk zijn van extra hardware: de Huawei-template vinkt de zonnemeter aan en laat de net- en batterijmeters uitgevinkt, zodat u deze kunt toevoegen zodra de Smart Power Sensor is geïnstalleerd. Lees de installatievereisten en vink vervolgens aan wat er in deze installatie daadwerkelijk aanwezig is. Voordat er iets wordt aangemaakt, kunt u:

  • elke widget aan- of uitvinken — een installatie met alleen zonnepanelen heeft geen batterij nodig;
  • een widget direct op zijn plaats hernoemen;
  • de objectteller uitklappen om elk object te inspecteren: het nummer, de naam, het toegewezen adres en het datatype. Objecten die door de template bewust open zijn gelaten, tonen geen adres.

Wanneer een parameter ontbreekt of buiten het bereik valt, verschijnt er een rode melding in plaats van de widgetlijst met vermelding van de te corrigeren parameter; de knop voor aanmaken blijft uitgeschakeld totdat dit is hersteld.

Klik op N widget(s) aanmaken. De resultatenpagina toont wat er is aangemaakt met het bijbehorende aantal objecten, wat er eventueel is mislukt en waarom, en biedt de optie Nog een apparaat toevoegen om de bibliotheek opnieuw te gebruiken. Dit is gebruikelijk voor een Sonos-systeem of een installatie met meerdere zones, waarbij u dezelfde template eenmaal per zone toepast.

📘 Opmerking: De widgets zijn opgeslagen maar nog niet live actief. Klik op Wijzigingen toepassen in de zijbalk en vervolgens op Wijzigingen toepassen in het dialoogvenster Configuratiewijzigingen toepassen (zie “Rondleiding door het beheerpaneel”) om de protocollen te herstarten en naar elke client te sturen.

De resultatenpagina na het aanmaken vanuit een template, met de objectaantallen en de oplichtende knop Wijzigingen toepassen.

Na het aanmaken

Vanaf dat moment zijn de widgets gewone apparaten — u kunt ze hernoemen, iconen wijzigen, ze verplaatsen naar andere ruimtes, logging inschakelen en ze gebruiken in weergaven, scènes en automatiseringen. De koppelingen zijn ook standaardkoppelingen: open een object en bewerk het exact zoals een handmatig aangemaakt object (zie “Modbus TCP-integratie”, “MQTT-integratie”).

Meters die zijn aangemaakt via een energietemplate hebben hun rol al ingesteld — net, zonne-energie, batterij, laadpaal, verbruiker — waardoor het onderdeel Energie en de energiebalans direct werken zonder verdere configuratie (zie “Energieapparaten”, “Energieoverzicht”).

Templates importeren en exporteren

De bibliotheek ondersteunt eigen templates: een .yaml- of .yml-bestand van maximaal 256 KB, in hetzelfde formaat als de meegeleverde templates. Het beheerpaneel bevat geen template-editor: een aangepaste template is een tekstbestand dat u zelf schrijft of ontvangt en bewerkt in een teksteditor.

  • Template importeren (rechtsboven) uploadt een bestand. Dit wordt eerst gevalideerd — een template met fouten wordt geweigerd met weergave van het aantal problemen en de details; er wordt niets opgeslagen. Een geïmporteerde template toont een label geïmporteerd op de kaart.
  • Een geïmporteerde template met dezelfde identifier als een meegeleverde template overschrijft deze, en op de kaart staat vervangt ingebouwd. Bij verwijdering wordt de meegeleverde versie hersteld.
  • Geïmporteerde templates kunnen worden geëxporteerd (Exporteren als YAML) en verwijderd (Template verwijderen) via de iconen die verschijnen wanneer de cursor op de kaart staat. Template verwijderen verwijdert direct, zonder bevestiging.
  • Meegeleverde templates kunnen niet worden geëxporteerd of verwijderd: deze kaarten bevatten die iconen niet. Ze worden standaard meegeleverd met de server en hersteld bij elke update. Om een eigen template te maken, exporteert u een geïmporteerde template of schrijft u het bestand vanaf nul.

⚠️ Waarschuwing: Het verwijderen van een template heeft geen invloed op de apparaten die er al mee zijn aangemaakt. Deze blijven normaal functioneren — alleen de template zelf wordt verwijderd.


Sonos koppelen

Sonos-objecten worden gekoppeld aan een zone, niet aan een handmatig ingevoerd IP-adres. Stel het protocol van het apparaat in op Sonos — of laat de bibliotheek dit doen — waarna de objecteditor de volgende opties biedt:

VeldBeschrijving
Sonos-zoneDe zone die deze widget bedient, gekozen uit de actuele zonelijst van het systeem. De opgeslagen identifier blijft behouden wanneer de ruimte in de Sonos-app wordt hernoemd of het IP-adres wijzigt.
Toepassen op hele groepOp de twee commando-objecten, Volumerichtwaarde en Dempen aan/uit: wanneer de zone gegroepeerd is met andere zones, past het commando de groep aan in plaats van alleen deze luidspreker. Stel dit per object afzonderlijk in, zodat het volume op de groep werkt terwijl dempen individueel blijft. De schakelaar staat ook bij Volumeterugmelding en Dempingsterugmelding, waar deze geen effect heeft: terugmelding geeft altijd het eigen volume en de eigen dempingsstatus van de zone weer.

Elk object van de widget bevat dezelfde zone; het objectnummer bepaalt de functie — volume, dempen, afspelen/pauzeren, bron, vorige/volgende, titel, artiest, albumhoes. Zone aan/uit heeft geen functie op een Sonos-luidspreker en blijft ongekoppeld, daarom gebruikt de bibliotheektemplate het audiosubtype zonder zones.

Klik op Object opslaan, vervolgens op Wijzigingen toepassen in de zijbalk en bevestig (zie “Rondleiding door het beheerpaneel”).

📘 Opmerking: Groepen worden aangemaakt en ontkoppeld in de Sonos-app; HyperVisu kan dit niet doen. De apps tonen ook geen groepsstatus: elke zone blijft een afzonderlijk audio-apparaat met een eigen volumeregelaar en dempknop, en de schuifregelaar blijft het eigen volume van die specifieke zone tonen, zelfs als de commando's op de hele groep worden toegepast. Om te zien welke zones gegroepeerd zijn, kijkt u in de Sonos-app of onder Zones in dit systeem bij de Sonos-verbinding (zie “Sonos-integratie”). Afspelen, pauzeren, volgende en vorige worden altijd naar de groepscoördinator gestuurd.

De objecteditor van het volume-object van een Sonos-widget: de Sonos-koppelingskaart, de zone-identifier en de groepsschakelaar.

Bronnen zijn Sonos-favorieten. Boven de objectenlijst van de widget bevindt zich het paneel Sonos-bronnen. Klik op Sonos-favorieten synchroniseren en de server leest het systeem uit: eerst de eigen ingangen van de luidspreker (TV op een soundbar, Line-In op modellen met een lijningang), daarna de favorieten die zijn opgeslagen in de Sonos-app. Hun namen en het aantal worden opgeslagen in de widget, en de apps genereren één bronknop per item.

De lijst is hier alleen-lezen — het beheer ligt volledig bij Sonos. Synchroniseer opnieuw na het toevoegen, verwijderen of hernoemen van favorieten in de Sonos-app, anders blijven de apps de oude knoppen tonen.

Het paneel Sonos-bronnen boven de objectenlijst van een widget, met de gesynchroniseerde bronnamen en de knop Synchroniseren.

💡 Tip: Bij meer dan zes bronnen tonen de apps een dropdownmenu in plaats van knoppen, zodat de bediening ook bij een lange lijst met favorieten overzichtelijk blijft.

Veelgestelde vragen

Wat configureert een bibliotheektemplate automatisch?

Het maakt de geselecteerde widgets aan waarbij protocolkoppelingen, datatypes, schaling en eenheden al zijn ingevuld. U hoeft alleen de vereiste parameters en de verbinding op te geven.

Waarom zijn sommige widgets in het voorbeeld standaard uitgevinkt?

Ze vereisen mogelijk extra hardware die niet in elke installatie aanwezig is, zoals een netaansluitingssensor of een batterij. Selecteer alleen wat daadwerkelijk geïnstalleerd is.

Waarom is mijn nieuwe bibliotheekapparaat nog niet direct actief?

Het aanmaken via de bibliotheek slaat de widgets op, maar u moet Wijzigingen toepassen gebruiken om ze te activeren en de configuratie naar de clients te sturen.

Kan ik mijn eigen templates gebruiken?

Ja. U kunt een gevalideerd YAML-bestand importeren. Een geïmporteerde template met een bestaande identifier vervangt dat catalogusitem; bij verwijderen wordt de standaardversie hersteld.

Worden apparaten verwijderd als ik de bijbehorende template verwijder?

Nee. Reeds aangemaakte apparaten behouden hun configuratie en blijven normaal functioneren.

Hoe werk ik de Sonos-bronknoppen bij?

Gebruik Sonos-favorieten synchroniseren boven de objectenlijst van de widget na het aanpassen van favorieten in de Sonos-app. De lijst zelf wordt beheerd in de Sonos-app.

Verder verkennen

Vind de andere handleidingen voor dit product in de documentatie.

Terug naar Apparaatconfiguratie