Nadat de eerste beheerder is aangemaakt, biedt het beheerpaneel de installatiewizard aan in het dialoogvenster Your setup wizard is ready — klik op Start setup. De wizard leidt u door de inbedrijfstelling: wat voor project het is, waar het zich bevindt, hoe het de KNX-bus bereikt, welke services draaien en wat het gebouw bevat. U kunt de wizard ook later openen met de knop Setup wizard op de pagina System.
Hoe de wizard werkt
- Er wordt niets naar de server geschreven vóór de laatste toepassing. Elke eerdere stap legt alleen een concept vast.
- Het concept blijft behouden na herladen — het wordt bewaard in de browser die u gebruikt, zodat u de pagina kunt sluiten en op dezelfde computer kunt terugkomen; uw antwoorden staan er nog.
- Save & exit, in de koptekst, verlaat de wizard en bewaart het concept voor later. Skip setup — configure later, onder de stappenlijst, verlaat de wizard en verwerpt het concept. Beide brengen u naar de pagina System.
- Navigeer met Back en Continue. De koptekst toont uw voortgang („Step 2 of 7“ — de ETS-route heeft één stap extra en telt dus tot 8).
Stap 1 — Instelmodus
„How do you want to build this project?“ Drie keuzes:
- Import an ETS project (Fastest route) — upload het
.knxproj-bestand van de installatie en HyperVisu bouwt de visualisatie opnieuw op uit wat ETS al weet: gebouwen en ruimtes worden verdiepingen en ruimtes, groepsadressen komen binnen met naam en type, ETS-functies worden apparaten waarvan de groepsobjecten al zijn toegewezen. - Configure manually (No file needed) — beschrijf het gebouw zelf. Het beste als er geen ETS-project bij de hand is, of als de visualisatie het project niet hoeft te volgen.
- Restore a HyperVisu backup instead — een back-up herstelt een volledige server (ruimtes, apparaten, gebruikers en services), dus de rest van de wizard is niet nodig. Choose a file opent geen bestandskiezer: het verlaat de wizard en opent de pagina Backup & Restore, waar u het bestand herstelt onder Restore from file (zie „Backup & Restore“). Daar wordt niet om een wachtwoord of een selectie van services gevraagd — het hele bestand wordt hersteld en vervangt wat op de server staat, inclusief de beheerder die u zojuist hebt aangemaakt.
📘 Opmerking: U kunt later van gedachten veranderen — van modus wisselen brengt u terug naar stap 4, omdat de twee schermen erna bij de andere route horen. Wat u op de verlaten route hebt ingevoerd, blijft bewaard voor het geval u terugwisselt.
Stap 2 — Project en locatie
„Name the project and place it on the map.“
| Veld | Doel |
|---|---|
| Project name | Hoe deze installatie wordt aangeduid |
| Installer reference | Uw eigen projectnummer |
| App language | De taal waarin de mobiele app en de webapp openen; elke gebruiker kan deze wijzigen |
| City → Get coordinates | Typ de plaats en laat de server de breedte- en lengtegraad opzoeken |
| Latitude / Longitude | Ingevuld door het opzoeken, of met de hand ingetypt |
| Timezone | De klok waarop de server draait |
Coördinaten en tijdzone bepalen zonsopgang- en zonsondergangtijden, geplande automatiseringen en elk tijdstempel dat de server schrijft — stel ze nauwkeurig in.
Stap 3 — KNX-businterface
„Connect to the bus.“ De wizard scant het netwerk eenmalig op KNX/IP-interfaces wanneer de stap opent en toont wat heeft geantwoord als kaarten met de naam van de interface, het type (Interface of Router), het adres en het serienummer. Klik op Scan again om de scan te herhalen.
Als er niets antwoordt, of als de interface op een ander subnet of achter een VPN staat, gebruik dan Enter an address manually: typ het adres en de poort in het ene veld, bijvoorbeeld 192.168.1.20:3671. Zonder poort wordt 3671 gebruikt.
Stel ook in:
- Connection type — Tunnel (UDP, voor een KNX/IP-interface) of Multicast (voor een KNX/IP-router). Een gevonden kaart selecteren stelt dit voor u in; bij een met de hand ingetypt adres stelt u het zelf in.
- HyperVisu physical address — het individuele adres dat de server zelf op de bus aanneemt. Het is vooraf ingevuld met
1.1.250en moet vrij zijn op de bus.
De verbindingstest. Klik op Run connection test om te zien hoe ver de verbinding komt. Er verschijnen vijf resultaten:
| Resultaat | Wat het u vertelt |
|---|---|
| Host reachable | De interface antwoordt op het netwerk (yes, met de responstijd, of no). |
| Port 3671 / UDP | Of de interface een beschrijvingsverzoek heeft beantwoord. Het kan not answered tonen terwijl de tunnel open is — sommige interfaces antwoorden alleen op een echte verbinding. Dat is geen storing. |
| Tunnel | Of er een tunnel kon worden geopend (yes of no). |
| Assigned address | Het adres dat de interface aan de testtunnel heeft gegeven. |
| Telegrams seen | Hoeveel telegrammen zijn binnengekomen terwijl de test de bus afluisterde. |
Wanneer de tunnel opent, toont het paneel Tunnel open en staat in de voettekst „Tunnel open — the bus answers.“
Een open tunnel bewijst de verbinding; alleen Telegrams seen bewijst echt busverkeer. Zodra de tunnel open is, luistert de test ongeveer vijf seconden, dus 0 op een rustige bus is geen storing. Om verkeer te zien klikt u op Test again en bedient u meteen een wandschakelaar terwijl de test loopt.
📘 Opmerking: Als u de wizard opnieuw uitvoert op een server die al met de bus is verbonden, opent de test geen tweede tunnel, omdat dat de lopende verbinding kan onderbreken. Hij meldt de actieve verbinding en telt geen telegrammen.
Als de tunnel niet opent, toont het paneel No response en stelt de wizard drie controles voor: tunnelling ingeschakeld op de interface, geen andere ETS-client die alle kanalen bezet houdt, en server en interface op hetzelfde VLAN.
Deze stap blokkeert nooit: u kunt doorgaan zonder te testen, of na een mislukte test, en de verbinding later herstellen.
Nog geen bus op locatie? Klik op I'll configure KNX later. De wizard wordt toegepast zonder busverbinding — ruimtes, apparaten en services worden normaal aangemaakt, en alles wat aan KNX is gekoppeld blijft stil totdat in Connections een interface is ingesteld (zie „Connections“).
Stap 4 — Services
„Which services should run?“ De schakelaars zijn gegroepeerd in drie secties, dezelfde als op de pagina Services. Elke sectie draagt één chip die aangeeft wat een wijziging daarin kost:
| Sectie | Chip | Betekenis |
|---|---|---|
| Services | Changes need a restart | De optionele services die deze server aanbiedt, zoals de historiedatabase, dashboards, Node-RED, camerastreaming en Home Assistant. Ze starten of stoppen alleen wanneer de server opnieuw opstart — de wizard biedt de herstart aan na het toepassen (zie „Final step — Review & apply“ hieronder). |
| Communication protocols | Applied immediately | De protocollen waarmee de server met apparaten communiceert. |
| Application services | no restart needed | Weer, energieprijzen en e-mail. |
Standaard ingeschakeld: de protocollen KNX en Virtual, en InfluxDB (de historiedatabase). De knop boven de kaarten toont hoeveel er zijn ingeschakeld en zet ze terug naar deze standaardwaarden.
Een kaart met de badge API key needed vereist ook een sleutel of inloggegevens: vul die aan op de pagina Services na de wizard (zie „Services & Protocols“).
Schakel alleen in wat dit project gebruikt — elke service kost geheugen en opstarttijd. Alles kan later worden ingeschakeld via Services & protocols.
Handmatige route — Gebouwstructuur
(Stap 5–6 hangen af van de instelmodus. Dit scherm en het volgende verschijnen op de handmatige route.)
„List the floors and their rooms.“
- De wizard begint met een Ground floor (niveau 0). Om een andere verdieping toe te voegen, typt u de naam in de regel Add a floor en drukt u op Enter.
- Typ een ruimtenaam en druk op Enter om de volgende toe te voegen — één ruimte per regel, zo snel als u kunt typen.
- Om er veel tegelijk toe te voegen, gebruikt u Add several rooms at once: kies de verdieping, typ namen gescheiden door komma's („Bedroom 2, Bedroom 3, Dressing“) en klik op de toevoegknop.
- Pictogrammen zijn nu optioneel — de app valt terug op de ruimtenaam totdat u er een instelt.
- Klik op Continue to categories. De knop blijft uitgeschakeld totdat er minstens één ruimte is.
📘 Opmerking: De wizard kan het niveau van een verdieping niet instellen. Verdiepingen worden genummerd 0, 1, 2… in de volgorde waarin u ze toevoegt, dus een hier toegevoegde kelder krijgt een positief niveau. Om er achteraf een negatief niveau aan te geven, opent u Building → Floors, bewerkt u de verdieping en wijzigt u het Floor Number (zie „Building Structure & Categories“).
Handmatige route — Categorieën
„Decide how the app groups devices.“ Categorieën worden de tegels op het startscherm van de app en de filters in elke ruimte; een apparaat hoort bij één categorie en één ruimte.
De wizard zaait zeven standaardcategorieën: Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Klik op een naam om die te hernoemen.
- Verwijder een categorie die het project niet nodig heeft.
- Add a category van uzelf (naam + pictogram), bijvoorbeeld „Home cinema“.
Klik vervolgens op Review everything om naar de laatste stap te gaan (zie „Final step — Review & apply“ hieronder).
📘 Opmerking: De handmatige route maakt geen apparaten aan. U voegt ze per ruimte toe vanaf de pagina Devices na de installatie (zie „The Devices Workspace“).
ETS-route — Importselectie
(Dit scherm vervangt dit artikel wanneer u „Import an ETS project“ hebt gekozen.)
„Choose what to import.“
- Sleep het
.knxproj-bestand (ETS 5- of ETS 6-projectexport) naar het gebied Drop the .knxproj file here, of klik op dat gebied om het bestand te kiezen. Er is geen aparte bladerknop. - Als het project in ETS met een wachtwoord is beveiligd, voert u het Project password in en klikt u op Unlock and read. Het wachtwoord wordt gebruikt om het bestand te lezen en wordt nooit opgeslagen.
- De wizard leest het project en biedt drie aan te vinken onderdelen, elk met echte aantallen uit uw bestand:
- Building structure — de verdiepingen en ruimtes die het ETS-project beschrijft („3 floors · 14 rooms“).
- Group addresses — de volledige adrestabel, zodat de busmonitor en de adreskiezer elk adres bij naam kennen; aantallen met en zonder type worden getoond.
- Devices from ETS functions — elke ETS-functie wordt één apparaat, al gekoppeld aan zijn groepsadressen.
- Vink uit wat u niet wilt en klik op Continue to categories. Laat Building structure aangevinkt: zonder dit zijn er geen ruimtes om apparaten onder te plaatsen en wordt er niets uit het project aangemaakt.
De ETS-route toont vervolgens het scherm Categories met de categorieën die het project heeft opgeleverd — één per soort apparaat dat het beschrijft. Hernoem ze, wijzig pictogrammen of voeg er een toe die het project niet dekt, zoals op het scherm Categories van de handmatige route. Een categorie die nog door apparaten wordt gebruikt, kan niet worden verwijderd totdat die apparaten op het controlescherm naar een andere categorie zijn verplaatst. Klik op Review rooms and devices om verder te gaan naar de controle (zie „ETS branch — Review import“ hieronder).
ETS-route — Import controleren
„Check what we found.“ Dit is de correctieronde over alles wat de import gaat aanmaken, georganiseerd als een boom van verdiepingen, ruimtes en apparaten. Voordat u toepast kunt u:
- Ruimtes en apparaten hernoemen die nog op ETS-labels lijken — de oorspronkelijke ETS-naam blijft zichtbaar („was … in ETS“), met een actie Revert.
- Het widgettype van een apparaat wijzigen waar de import het verkeerd had — de gekoppelde adressen beperken welke typen passen.
- Apparaten naar een andere ruimte of categorie verplaatsen, of ze Excluden als de app ze niet moet tonen.
- Afgeleide datapointtypen bevestigen — adressen zonder DPT in ETS krijgen een afgeleid type dat ter bevestiging is gemarkeerd.
- De groep „No room found“ afwerken: echte apparaten waarvan de ruimte niet kon worden bepaald. Verplaats elk naar een ruimte; wat overblijft wordt zonder ruimte aangemaakt.
📘 Opmerking: Als het project geen ETS-functies declareert, leidt de wizard apparaten af uit de actorkanalen en markeert elk apparaat als guessed — controleer ruimtes, namen en typen voordat u doorgaat.
Filters („Needs attention“, „Renamed“), zoeken en een snelkoppeling „Next room with an issue“ helpen u grote projecten snel door te lopen. U kunt toepassen terwijl er problemen overblijven en ze later oplossen in Devices. Klik als u klaar bent op Review everything.
Laatste stap — Controleren en toepassen
„Project Review“ vat alles samen in zes kaarten — instelmodus en project, locatie en tijd, KNX-bus, services, gebouw, apparaten en adressen — elk met een link Edit die terugspringt naar de bijbehorende stap.
Blokkerende problemen staan boven de kaarten (bijvoorbeeld „No coordinates — the apply will stop on the settings stage“, „No rooms — the app will open empty“). Los ze op, of bevestig dat ze bedoeld zijn.
Wat toepassen doet, in volgorde:
- De serverinstellingen schrijven — locatie, tijdzone, businterface en de ingeschakelde services.
- De structuur aanmaken — verdiepingen, ruimtes, categorieën en (op de ETS-route) apparaten en groepsadressen.
- De KNX-bridge herstarten — één herverbinding; de bus zelf blijft onaangetast.
Klik op Apply and finish. Een live voortgangspaneel volgt de fasen en toont de verstreken tijd. Zodra er Setup complete staat, sluit de wizard en opent de pagina System.
📘 Opmerking: Als u een service in de sectie Services hebt in- of uitgeschakeld (zie „Stap 4 — Services“ hierboven), verschijnt in plaats daarvan het dialoogvenster Reboot to finish setup: deze services starten of stoppen alleen wanneer de server opnieuw opstart, wat ongeveer twee minuten duurt. Klik op Reboot now, of klik op Later en start opnieuw op vanaf de pagina System wanneer het u uitkomt.
Als er iets misgaat: de uitvoering stopt bij de mislukte fase en meldt dat. Wat eerdere fasen hebben geschreven, blijft staan; Retry voert alle fasen opnieuw uit, controleer dus eerst het gebouw op de pagina System als de fout laat optrad. Als de server tijdens het toepassen opnieuw is opgestart, meldt de wizard dat de taak verloren is gegaan — controleer het resultaat op de pagina System en voer de wizard opnieuw uit als de structuur ontbreekt.