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.

Wat de bibliotheek omvat. De catalogus wordt meegeleverd met de server en groeit bij elke update. Deze bevat momenteel 83 templates van 49 merken:
| Apparaatfamilie | Ondersteunde merken |
|---|---|
| PV-omvormers & hybride omvormers | SMA · 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 & opslag | Marstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE) |
| Energiemanagers & dataloggers | Huawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog |
| Energiemeters | HomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S) |
| Laadpalen | KEBA · 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- & zonweringsrelais | Shelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 roller) |
| Audio / video | Sonos (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
- 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.
- 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.
- 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.
- 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.
- Kies de Ruimte en de Categorie waarin de widgets worden geplaatst. Beide zijn verplicht.
- Het paneel Aan te maken widgets toont direct een live voorbeeld van het resultaat.

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.

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:
| Veld | Beschrijving |
|---|---|
| Sonos-zone | De 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 groep | Op 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.

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.

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