Naar de inhoud
Elausys

HyperVisu / Integraties

KNX-integratie

De busverbinding, programmeren met ETS ter plaatse of op afstand, de groepsadresbibliotheek en koppelen via slepen en neerzetten.

elausys · 21 juli 2026
Op deze pagina

KNX-integratie

De pagina KNX in het beheerpaneel is de werkplek voor alles wat met KNX te maken heeft: de busverbinding, ETS-programmeertoegang, de groepsadresbibliotheek, de busmonitor, de KNX Bridge en KNX-triggers. Open de pagina via de zijbalk. De pagina heeft drie tabbladen: Bridge, Bus monitor en Group addresses. Op de tabbladen Bridge en Bus monitor toont een verbindingsbalk het Protocol, het Gateway IP en de actuele status (Connected / Disconnected).

KNX-pagina, desktopbrowser.

Verbinding en ETS-toegang op afstand

Wat u nodig hebt: een geconfigureerde KNX-verbinding (zie „Connections”) met de status Connected.

De verbindingsbalk geeft de KNX-verbinding weer die u op de pagina Connections hebt geconfigureerd. Als daar Disconnected staat, herstel dan eerst de verbinding daar – zonder de bus werkt niets op deze pagina.

Programmeren met ETS ter plaatse. HyperVisu behoudt zijn KNX-verbinding terwijl u met ETS programmeert: er hoeft niets omgeschakeld te worden en widgets blijven actueel. De meeste KNX/IP-interfaces laten slechts een beperkt aantal tunnels toe en HyperVisu bezet er één, dus ETS heeft een andere vrije tunnel op de interface nodig (of een eigen programmeerinterface).

ETS-toegang op afstand. Om de bus vanaf buiten het gebouw met ETS te programmeren, schakelt u Remote ETS access in. Hiermee wordt een beveiligde tunnel via de cloudverbinding geopend en worden de Server en een Port-nummer getoond.

  1. Schakel op de KNX-pagina (tabblad Bridge) Remote ETS access in. De schakelaar doet er enkele seconden over terwijl de tunnel wordt geopend.
  2. Noteer de getoonde server en het poortnummer. De poort wordt telkens opnieuw toegewezen wanneer de toegang wordt ingeschakeld.
  3. Configureer in ETS een KNX/IP-tunnelverbinding naar die server en voer die poort in.
  4. Schakel Remote ETS access uit wanneer u klaar bent.

📘 Note: De tunnel op afstand sluit automatisch na 8 uur. Schakel hem opnieuw in als u meer tijd nodig hebt en noteer de nieuwe poort.

Tabblad Bridge, kaart Remote ETS access ingeschakeld, met de tunnelpoort, de aanwijzing „Use this port number in ETS” en de melding over automatisch uitschakelen.

Group addresses

Het tabblad Group addresses bevat de groepsadresbibliotheek van de server – elk adres dat uit ETS bekend is, te doorbladeren als ETS project tree („N main groups · M addresses”). Dit is dezelfde bibliotheek die de werkruimte Devices aanbiedt voor koppelen via slepen en neerzetten.

  • Zoek op adres, naam of datapointtype met het zoekveld boven de boomstructuur.
  • Importeer adressen uit een ETS-groepsadres-XML-export als u niet het hele project wilt importeren: klik in de kop van dit tabblad op Import Group Addresses en kies het bestand dat ETS aanmaakt via Group Addresses → Export.

Selecteer een adres in de boomstructuur om het detailpaneel te openen:

VeldBetekenis
Last valueDe meest recente gedecodeerde waarde op de bus.
Last seenWanneer die waarde binnenkwam.
Used byElk apparaat en elke automatisering die aan dit adres gekoppeld is („Not used by any device or automation” als het vrij is).
Watch on the bus monitorOpent het tabblad Bus monitor met een herinnering aan het adres. De tabel wordt niet gefilterd: typ het adres in Search telegrams... om de telegrammen ervan te isoleren (zie „KNX Bus Monitor”).

💡 Tip: „Used by” is de snelste manier om „wat gebeurt er als dit adres verandert?” te beantwoorden voordat u iets herbekabelt.

Tabblad Group addresses.

KNX koppelen

In de werkruimte Devices toont het tabblad KNX van de balk Communication objects de ETS project tree – uw groepsadressen, geordend zoals in ETS – ongeacht welk apparaat is geselecteerd. Als de boomstructuur leeg is, klikt u in de balk op Import Group Addresses en kiest u uw ETS-groepsadresexport (XML) (zie „Group addresses” hierboven).

Om te koppelen:

  1. Klap de apparaatrij uit (Show objects) om de communicatieobjecten te tonen.
  2. Zoek het adres in de boomstructuur, of typ in Search group addresses....
  3. Sleep het groepsadres naar de bijbehorende objectrij. Tijdens het slepen staat op lege rijen Drop here to assign. Het adres wordt toegewezen en het object neemt het datapoint type (DPT) van het adres over uit de ETS-gegevens, met de bijbehorende eenheid en het aantal decimalen.
  4. Herhaal dit voor elk commando- en terugmeldobject van het apparaat.
  5. Klik in de zijbalk op Apply changes en vervolgens op Apply changes in het dialoogvenster Apply configuration changes (zie „Admin Panel Tour”).

📘 Note: Een groepsadres wordt op één objectrij tegelijk neergezet. Het kan niet op het apparaat als geheel worden neergezet: alleen een Home Assistant-entiteit vult meerdere objecten in één keer (zie „Home Assistant Integration”).

Een groepsadres wordt vanuit de ETS-boomstructuur naar de objectrij „Position” van een uitgeklapt apparaat gesleept.

Wanneer het datatype niet overeenkomt. Als het DPT van het groepsadres afwijkt van wat het object verwacht, legt het dialoogvenster Data type differs from object type het verschil uit: het werkelijke datatype van het adres wordt aan het object gekoppeld en er is een transformatie vereist om tussen beide om te zetten. Klik op Cancel en zet het juiste adres neer, of klik alleen op Map anyway als u van plan bent de transformatie toe te voegen – het object blijft op de pagina Health gemarkeerd totdat u dat doet (zie „Value Transformations & Health”).

💡 Tip: Typisch geval: een statusbyte (DPT 5.010) die een booleaans object voedt – koppel toch (Map anyway) en voeg daarna een Bit Check-transformatie toe (zie „Value Transformations & Health”).

Veelgestelde vragen

Moet ik HyperVisu loskoppelen voordat ik met ETS programmeer?

Nee. HyperVisu behoudt zijn KNX-verbinding en widgets blijven actueel terwijl ETS programmeert. ETS heeft alleen een eigen vrije tunnel op de interface nodig.

Hoe lang blijft ETS-toegang op afstand open?

De beveiligde tunnel op afstand sluit automatisch na acht uur. Schakel hem opnieuw in als u meer tijd nodig hebt; de poort verandert elke keer.

Kan ik groepsadressen importeren zonder een volledig ETS-project?

Ja. Importeer een ETS-groepsadres-XML-export op het tabblad Group addresses.

Hoe koppel ik een KNX-groepsadres?

Sleep het vanuit de ETS-projectboom naar een objectrij, één object tegelijk. Het object neemt het geïmporteerde DPT over. Pas daarna de wijzigingen toe.

Wat gebeurt er als het DPT niet overeenkomt met het object?

Het dialoogvenster over het verschil legt de benodigde omzetting uit. Als u Map anyway selecteert, voeg dan een geschikte transformatie toe; Health markeert het object tot die tijd.

Verder verkennen

Vind de andere handleidingen voor dit product in de documentatie.

Terug naar Integraties