Verbindingen (zijbalkgroep SYSTEEM) beheert de geconfigureerde koppelingen tussen de server en de buitenwereld. Een verbinding is één geconfigureerde koppeling — één KNX-interface, één Home Assistant-server, één Modbus-apparaat, één HTTP-eindpunt, één MQTT-broker, één BACnet-apparaat, één TCP/UDP-apparaat. Apparaten worden vervolgens aan een verbinding gekoppeld (zie "De apparaten-werkruimte").
Hoeveel verbindingen een protocol vereist:
- KNX, Home Assistant en Virtueel — precies één verbinding elk.
- Modbus TCP, HTTP, MQTT, BACnet/IP en TCP/UDP — zoveel als nodig: één per fysiek apparaat of eindpunt (één per broker voor MQTT).
Vereiste: het protocol moet ingeschakeld zijn op de pagina Diensten (zie "Diensten & Protocollen"). Een verbinding die gedefinieerd is voor een uitgeschakeld protocol toont Schakel <protocol> in bij Diensten in plaats van een live-status.
De lijst met verbindingen
De lijst toont elke verbinding met een live-status.
Voor elke verbinding kunt u:
- Zoeken op naam, host of apparaat.
- De individuele verbinding in-/uitschakelen.
- Testen — voert een live verbindingstest uit en meldt Verbinding geslaagd of Verbinding mislukt. De knop is beschikbaar voor KNX, Home Assistant, MQTT, TCP/UDP, BACnet/IP en Sonos.
- Dupliceren — kopieert de verbinding (met de toevoeging "(kopie)"); handig voor een tweede Modbus- of TCP/UDP-apparaat met vergelijkbare instellingen.
- Verwijderen — een waarschuwing geeft aan hoeveel apparaten hun bron verliezen: de apparaten blijven behouden en worden gemarkeerd als onbereikbaar, niet verwijderd.
Het selecteren van een verbinding opent het detailpaneel:
- Waarmee verbinding wordt gemaakt — de protocolspecifieke adresinstellingen.
- Hoe vaak en hoe lang te wachten — poll-interval en time-out, voor zover het protocol deze gebruikt.
- Apparaten op deze verbinding — de apparaten die deze koppeling gebruiken, met een snelkoppeling Openen in Apparaten.
Een verbinding toevoegen
- Klik op Verbinding toevoegen.
- Kies eerst het protocol. Het dialoogvenster toont vervolgens alleen de velden van dat protocol.
- Geef de verbinding een naam — dit is de naam die zichtbaar is bij apparaten die de koppeling gebruiken.
- Vul de protocolvelden in en klik op Verbinding aanmaken.
Instellingen per protocol
KNX
| Veld | Omschrijving |
|---|---|
| IP-adres / Poort | De KNX/IP-interface of -router op uw LAN. |
| Fysiek adres | Het fysieke adres dat HyperVisu op de bus gebruikt. |
| Communicatieprotocol | Tunnel UDP (point-to-point naar een interface) of Multicast (routing). |
| Bus datum/tijd | Optioneel: de server zendt de actuele datum en tijd uit op de bus via een groepsadres, elke zendcyclus seconden. |
Klik op Interfaces detecteren om het netwerk te scannen naar KNX/IP-interfaces. Kies er een uit de resultaten en de instellingen worden automatisch ingevuld.
Home Assistant
| Veld | Omschrijving |
|---|---|
| Home Assistant-URL | Volledige URL inclusief http:// of https:// en de poort. |
| API-token | Een 'long-lived access token', gegenereerd in de gebruikersinstellingen van Home Assistant. |
Modbus TCP
| Veld | Omschrijving |
|---|---|
| Server IP-adres | Het Modbus TCP-apparaat. |
| Poort | Standaard 502. |
| Poll-interval | Hoe vaak de server de registers uitleest, in seconden. |
HTTP
| Veld | Omschrijving |
|---|---|
| Weergavenaam | Een herkenbare naam voor het eindpunt. |
| Basis-URL | Bijv. https://api.example.com/v1. Paden van objecten worden hieraan toegevoegd (zie "HTTP-integratie"). |
| Poort | Optioneel; meestal afgeleid van de URL. |
| Poll-interval | Seconden tussen polls. Stel in op 0 voor een 'write-only' eindpunt. |
| Time-out | Time-out van het verzoek in milliseconden. |
| Authenticatie | Geen, API-sleutel (Header), API-sleutel (Queryparameter), Basic Authentication, Bearer Token, of Aangepaste headers (verzonden bij elk verzoek). |
MQTT
| Veld | Omschrijving |
|---|---|
| Broker-adres | Host, of een volledige URL (mqtt://, mqtts://, ws://, wss://); een losse host betekent mqtt://. |
| Poort | Standaard 1883 (8883 voor mqtts://). |
| Gebruikersnaam / Wachtwoord / Client-ID | Inloggegevens als de broker dit vereist; laat het Client-ID leeg om er een af te leiden van het MAC-adres van de server. |
| Zelfondertekende certificaten accepteren / CA-certificaat | Alleen TLS (mqtts:// / wss://): standaard uit; plak het PEM-certificaat van de certificeringsinstantie wanneer dit geen openbaar certificaat is. |
| Broker-opties | Keepalive (60 s), Standaard QoS (0/1/2), Beschikbaarheidstopic (hypervisu/status) met Beschikbaarheid van HyperVisu melden, Clean session. |
Test maakt verbinding met de broker en wacht op de bevestiging — ook beschikbaar in het dialoogvenster voor het toevoegen van een verbinding voordat deze daadwerkelijk bestaat (zie "MQTT-integratie").
Wanneer de ingebouwde broker actief is en er nog niets mee verbonden is, toont de pagina Verbindingen een snelkoppeling: een paneel genaamd De lokale MQTT-broker is actief met een knop Gebruik de lokale broker, die de verbinding aanmaakt met het account dat HyperVisu zelf beheert — zonder dat er een adres of wachtwoord ingevoerd hoeft te worden (zie "De ingebouwde MQTT-broker").
BACnet/IP
| Veld | Omschrijving |
|---|---|
| Apparaatadres | IP-adres van het BACnet-apparaat of van de router ervoor. |
| Poort | De UDP-poort waarop het apparaat luistert (standaard 47808). |
| Device Instance | De device object instance (0–4194302); optioneel, gecontroleerd tijdens de test indien ingesteld. |
| Levensduur COV-abonnement | Seconden voordat een Change-of-Value-abonnement wordt vernieuwd; leeg = standaardwaarde van de dienst (600 s). |
| Poll-interval (seconden) | Hoe vaak punten zonder COV-abonnement opnieuw worden uitgelezen (standaard 30). |
Klik op Netwerk scannen om een Who-Is uit te zenden en kies het apparaat uit de antwoorden — adres, poort en instance worden automatisch ingevuld (zie "BACnet/IP-integratie").
TCP/UDP
| Veld | Omschrijving |
|---|---|
| Apparaatadres / Poort | Het apparaat (AUDAC XMP44: poort 5001). |
| Poll-interval (seconden) | Hoe vaak het apparaat opnieuw moet worden uitgelezen; 0 voor een apparaat dat zijn status zelfstandig verstuurt. |
| Framing en timing | Transport (TCP · permanente verbinding / UDP · datagrammen), Framescheidingsteken (\r\n), Payload-codering (ASCII-tekst / HEX-bytes), Luisterpoort (UDP), Heartbeat-frame • Elke (TCP), Verbindingstime-out, Vertraging tussen commando's, Alles lezen bij verbinding. |
De frames zelf worden per object geconfigureerd (zie "TCP/UDP-integratie").
Virtueel
Niets te configureren — virtuele apparaten draaien volledig op de server (zie "Virtuele apparaten & Node-RED").