Nachdem der erste Administrator angelegt wurde, bietet das Admin-Panel den Einrichtungsassistenten im Dialog Your setup wizard is ready an – klicken Sie auf Start setup. Der Assistent führt Sie durch die Inbetriebnahme: welche Art von Projekt es ist, wo es sich befindet, wie es den KNX-Bus erreicht, welche Dienste laufen und was das Gebäude enthält. Sie können ihn auch später über die Schaltfläche Setup wizard auf der Seite System öffnen.
So funktioniert der Assistent
- Bis zum abschließenden Anwenden wird nichts auf den Server geschrieben. Jeder frühere Schritt legt nur einen Entwurf an.
- Der Entwurf bleibt nach dem Neuladen erhalten – er wird im verwendeten Browser gespeichert, sodass Sie die Seite schließen und am selben Computer zurückkehren können; Ihre Eingaben sind noch da.
- Save & exit in der Kopfzeile verlässt den Assistenten und behält den Entwurf für später. Skip setup – configure later unter der Schrittliste verlässt den Assistenten und verwirft den Entwurf. Beides führt auf die Seite System.
- Navigieren Sie mit Back und Continue. Die Kopfzeile zeigt Ihren Fortschritt („Step 2 of 7“ – die ETS-Route hat einen zusätzlichen Schritt und zählt daher bis 8).
Schritt 1 – Einrichtungsmodus
„How do you want to build this project?“ Drei Optionen:
- Import an ETS project (Fastest route) – laden Sie die
.knxproj-Datei der Installation hoch, und HyperVisu baut die Visualisierung aus dem auf, was ETS bereits kennt: Gebäude und Räume werden zu Etagen und Räumen, Gruppenadressen kommen benannt und typisiert an, ETS-Funktionen werden zu Geräten, deren Gruppenobjekte bereits zugewiesen sind. - Configure manually (No file needed) – beschreiben Sie das Gebäude selbst. Am besten, wenn kein ETS-Projekt zur Hand ist oder die Visualisierung diesem nicht folgen soll.
- Restore a HyperVisu backup instead – ein Backup stellt einen kompletten Server wieder her (Räume, Geräte, Benutzer und Dienste), der Rest des Assistenten ist daher nicht nötig. Choose a file öffnet keinen Dateiauswahldialog: Es verlässt den Assistenten und öffnet die Seite Backup & Restore, auf der Sie die Datei unter Restore from file wiederherstellen (siehe „Backup & Restore“). Dort werden Sie weder nach einem Passwort noch nach einer Auswahl von Diensten gefragt – die gesamte Datei wird wiederhergestellt und ersetzt, was auf dem Server liegt, einschließlich des gerade angelegten Administrators.
📘 Hinweis: Sie können es sich später anders überlegen – ein Moduswechsel führt Sie zurück zu Schritt 4, weil die beiden folgenden Bildschirme zur anderen Route gehören. Was Sie auf der verlassenen Route eingegeben haben, bleibt erhalten, falls Sie zurückwechseln.
Schritt 2 – Projekt und Standort
„Name the project and place it on the map.“
| Feld | Zweck |
|---|---|
| Project name | Wie diese Installation bezeichnet wird |
| Installer reference | Ihre eigene Projektnummer |
| App language | Die Sprache, in der die mobile App und die Web-App öffnen; jeder Benutzer kann sie ändern |
| City → Get coordinates | Stadt eingeben und den Server Längen- und Breitengrad nachschlagen lassen |
| Latitude / Longitude | Durch die Suche befüllt oder von Hand eingegeben |
| Timezone | Die Uhr, nach der der Server läuft |
Koordinaten und Zeitzone bestimmen Sonnenauf- und -untergangszeiten, zeitgesteuerte Automatisierungen und jeden Zeitstempel, den der Server schreibt – stellen Sie sie genau ein.
Schritt 3 – KNX-Busschnittstelle
„Connect to the bus.“ Der Assistent durchsucht beim Öffnen des Schritts einmal das Netzwerk nach KNX/IP-Schnittstellen und listet die Antwortenden als Karten mit dem Namen der Schnittstelle, dem Typ (Interface oder Router), der Adresse und der Seriennummer auf. Klicken Sie auf Scan again, um die Suche zu wiederholen.
Antwortet nichts, oder befindet sich die Schnittstelle in einem anderen Subnetz oder hinter einem VPN, verwenden Sie Enter an address manually: Geben Sie Adresse und Port in das eine Feld ein, zum Beispiel 192.168.1.20:3671. Ohne Port wird 3671 verwendet.
Legen Sie außerdem fest:
- Connection type – Tunnel (UDP, für eine KNX/IP-Schnittstelle) oder Multicast (für einen KNX/IP-Router). Die Auswahl einer gefundenen Karte setzt ihn für Sie; bei einer von Hand eingegebenen Adresse setzen Sie ihn selbst.
- HyperVisu physical address – die individuelle Adresse, die der Server selbst am Bus annimmt. Sie ist mit
1.1.250vorbelegt und muss am Bus frei sein.
Der Verbindungstest. Klicken Sie auf Run connection test, um zu sehen, wie weit die Verbindung kommt. Es erscheinen fünf Ergebnisse:
| Ergebnis | Was es Ihnen sagt |
|---|---|
| Host reachable | Die Schnittstelle antwortet im Netzwerk (yes, mit der Antwortzeit, oder no). |
| Port 3671 / UDP | Ob die Schnittstelle eine Beschreibungsanfrage beantwortet hat. Es kann not answered anzeigen, obwohl der Tunnel offen ist – manche Schnittstellen antworten nur auf eine echte Verbindung. Das ist kein Fehler. |
| Tunnel | Ob ein Tunnel geöffnet werden konnte (yes oder no). |
| Assigned address | Die Adresse, die die Schnittstelle dem Testtunnel zugewiesen hat. |
| Telegrams seen | Wie viele Telegramme eingingen, während der Test den Bus abgehört hat. |
Wenn der Tunnel öffnet, zeigt das Panel Tunnel open, und die Fußzeile lautet „Tunnel open – the bus answers.“
Ein offener Tunnel belegt die Verbindung; nur Telegrams seen belegt echten Busverkehr. Sobald der Tunnel offen ist, hört der Test etwa fünf Sekunden lang mit, daher ist 0 auf einem ruhigen Bus kein Fehler. Um Verkehr zu sehen, klicken Sie auf Test again und betätigen Sie sofort einen Wandtaster, während der Test läuft.
📘 Hinweis: Wenn Sie den Assistenten erneut auf einem Server ausführen, der bereits mit dem Bus verbunden ist, öffnet der Test keinen zweiten Tunnel, da dies die laufende Verbindung unterbrechen könnte. Er meldet die bestehende Verbindung und zählt keine Telegramme.
Öffnet der Tunnel nicht, zeigt das Panel No response, und der Assistent schlägt drei Prüfpunkte vor: Tunneling an der Schnittstelle aktiviert, kein anderer ETS-Client belegt alle Kanäle, und Server und Schnittstelle im selben VLAN.
Dieser Schritt blockiert nie: Sie können ohne Test oder nach einem fehlgeschlagenen Test fortfahren und die Verbindung später korrigieren.
Noch kein Bus vor Ort? Klicken Sie auf I'll configure KNX later. Der Assistent wird ohne Busverbindung angewendet – Räume, Geräte und Dienste werden normal angelegt, und alles, was an KNX gebunden ist, bleibt stumm, bis in Connections eine Schnittstelle festgelegt wird (siehe „Connections“).
Schritt 4 – Dienste
„Which services should run?“ Die Schalter sind in drei Bereiche gruppiert, dieselben wie auf der Seite Services. Jeder Bereich trägt einen Chip, der angibt, was eine Änderung darin kostet:
| Bereich | Chip | Bedeutung |
|---|---|---|
| Services | Changes need a restart | Die optionalen Dienste, die dieser Server anbietet, etwa die Verlaufsdatenbank, Dashboards, Node-RED, Kamera-Streaming und Home Assistant. Sie starten oder stoppen nur beim Neustart des Servers – der Assistent bietet den Neustart nach dem Anwenden an (siehe „Final step – Review & apply“ unten). |
| Communication protocols | Applied immediately | Die Protokolle, mit denen der Server mit Geräten kommuniziert. |
| Application services | no restart needed | Wetter, Energiepreise und E-Mail. |
Standardmäßig aktiv: die Protokolle KNX und Virtual sowie InfluxDB (die Verlaufsdatenbank). Die Schaltfläche über den Karten zeigt, wie viele aktiviert sind, und setzt sie auf diese Standardwerte zurück.
Eine Karte mit dem Badge API key needed benötigt zusätzlich einen Schlüssel oder Zugangsdaten: Vervollständigen Sie diese nach dem Assistenten auf der Seite Services (siehe „Services & Protocols“).
Aktivieren Sie nur, was dieses Projekt nutzt – jeder Dienst kostet Speicher und Startzeit. Alles lässt sich später über Services & protocols einschalten.
Manuelle Route – Gebäudestruktur
(Die Schritte 5–6 hängen vom Einrichtungsmodus ab. Dieser und der nächste Bildschirm erscheinen auf der manuellen Route.)
„List the floors and their rooms.“
- Der Assistent beginnt mit einem Ground floor (Ebene 0). Um eine weitere Etage hinzuzufügen, geben Sie ihren Namen in die Zeile Add a floor ein und drücken Enter.
- Geben Sie einen Raumnamen ein und drücken Sie Enter, um den nächsten hinzuzufügen – ein Raum pro Zeile, so schnell Sie tippen können.
- Um viele auf einmal hinzuzufügen, verwenden Sie Add several rooms at once: Wählen Sie die Etage, geben Sie Namen durch Kommas getrennt ein („Bedroom 2, Bedroom 3, Dressing“) und klicken Sie auf die Hinzufügen-Schaltfläche.
- Symbole sind jetzt optional – die App greift auf den Raumnamen zurück, bis Sie eines festlegen.
- Klicken Sie auf Continue to categories. Die Schaltfläche bleibt deaktiviert, bis mindestens ein Raum vorhanden ist.
📘 Hinweis: Der Assistent kann die Ebene einer Etage nicht festlegen. Etagen werden in der Reihenfolge des Hinzufügens mit 0, 1, 2 … nummeriert, ein hier hinzugefügtes Untergeschoss erhält also eine positive Ebene. Um ihm nachträglich eine negative Ebene zu geben, öffnen Sie Building → Floors, bearbeiten die Etage und ändern ihre Floor Number (siehe „Building Structure & Categories“).
Manuelle Route – Kategorien
„Decide how the app groups devices.“ Kategorien werden zu den Kacheln auf dem Startbildschirm der App und zu den Filtern in jedem Raum; ein Gerät gehört zu einer Kategorie und einem Raum.
Der Assistent legt sieben Standardkategorien an: Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Klicken Sie auf einen Namen, um ihn umzubenennen.
- Entfernen Sie eine Kategorie, die das Projekt nicht braucht.
- Add a category nach eigenem Bedarf (Name + Symbol), z. B. „Home cinema“.
Klicken Sie dann auf Review everything, um zum letzten Schritt zu gelangen (siehe „Final step – Review & apply“ unten).
📘 Hinweis: Die manuelle Route legt keine Geräte an. Sie fügen sie nach der Einrichtung raumweise über die Seite Devices hinzu (siehe „The Devices Workspace“).
ETS-Route – Importauswahl
(Dieser Bildschirm ersetzt diesen Artikel, wenn Sie „Import an ETS project“ gewählt haben.)
„Choose what to import.“
- Ziehen Sie die
.knxproj-Datei (ETS-5- oder ETS-6-Projektexport) auf den Bereich Drop the .knxproj file here, oder klicken Sie auf diesen Bereich, um die Datei auszuwählen. Es gibt keine separate Durchsuchen-Schaltfläche. - Ist das Projekt in ETS passwortgeschützt, geben Sie das Project password ein und klicken Sie auf Unlock and read. Das Passwort dient zum Lesen der Datei und wird nie gespeichert.
- Der Assistent liest das Projekt und bietet drei ankreuzbare Teile an, jeweils mit den tatsächlichen Zahlen aus Ihrer Datei:
- Building structure – die Etagen und Räume, die das ETS-Projekt beschreibt („3 floors · 14 rooms“).
- Group addresses – die vollständige Adresstabelle, damit der Busmonitor und die Adressauswahl jede Adresse beim Namen kennen; die Anzahl typisierter und untypisierter Adressen wird angezeigt.
- Devices from ETS functions – jede ETS-Funktion wird zu einem Gerät, das bereits an seine Gruppenadressen gebunden ist.
- Entfernen Sie das Häkchen bei allem, was Sie nicht möchten, und klicken Sie dann auf Continue to categories. Lassen Sie Building structure angekreuzt: Ohne diese gibt es keine Räume, denen Geräte zugeordnet werden können, und aus dem Projekt wird nichts angelegt.
Die ETS-Route zeigt anschließend den Bildschirm Categories mit den Kategorien, die das Projekt ergeben hat – eine pro beschriebener Geräteart. Benennen Sie sie um, ändern Sie Symbole oder fügen Sie eine hinzu, die das Projekt nicht abdeckt, wie auf dem Bildschirm Categories der manuellen Route. Eine Kategorie, die noch von Geräten verwendet wird, kann erst gelöscht werden, wenn diese Geräte auf dem Prüfbildschirm in eine andere Kategorie verschoben wurden. Klicken Sie auf Review rooms and devices, um mit der Prüfung fortzufahren (siehe „ETS branch – Review import“ unten).
ETS-Route – Import prüfen
„Check what we found.“ Dies ist der Korrekturdurchgang über alles, was der Import anlegen wird, gegliedert als Baum aus Etagen, Räumen und Geräten. Vor dem Anwenden können Sie:
- Räume und Geräte umbenennen, die noch wie ETS-Bezeichnungen klingen – der ursprüngliche ETS-Name bleibt sichtbar („was … in ETS“), mit der Aktion Revert.
- Den Widget-Typ eines Geräts ändern, wo der Import falsch geraten hat – die gebundenen Adressen schränken ein, welche Typen passen.
- Geräte in einen anderen Raum oder eine andere Kategorie verschieben oder sie mit Exclude ausschließen, wenn die App sie nicht anzeigen soll.
- Abgeleitete Datenpunkttypen bestätigen – Adressen ohne DPT in ETS erhalten einen abgeleiteten, zur Bestätigung markierten Typ.
- Die Gruppe „No room found“ abarbeiten: echte Geräte, deren Raum nicht ermittelt werden konnte. Verschieben Sie jedes in einen Raum; was übrig bleibt, wird ohne Raum angelegt.
📘 Hinweis: Deklariert das Projekt keine ETS-Funktionen, leitet der Assistent Geräte aus den Aktorkanälen ab und markiert jedes als guessed – prüfen Sie Räume, Namen und Typen, bevor Sie fortfahren.
Filter („Needs attention“, „Renamed“), Suche und eine Verknüpfung „Next room with an issue“ helfen Ihnen, große Projekte schnell durchzugehen. Sie können mit verbleibenden Problemen anwenden und diese später in Devices beheben. Klicken Sie abschließend auf Review everything.
Letzter Schritt – Prüfen und anwenden
„Project Review“ fasst alles in sechs Karten zusammen – Einrichtungsmodus und Projekt, Standort und Zeit, KNX-Bus, Dienste, Gebäude, Geräte und Adressen –, jeweils mit einem Link Edit, der zum zugehörigen Schritt zurückspringt.
Blockierende Probleme werden über den Karten aufgelistet (zum Beispiel „No coordinates – the apply will stop on the settings stage“, „No rooms – the app will open empty“). Beheben Sie sie oder bestätigen Sie, dass sie beabsichtigt sind.
Was das Anwenden tut, der Reihe nach:
- Die Servereinstellungen schreiben – Standort, Zeitzone, Busschnittstelle und die aktivierten Dienste.
- Die Struktur anlegen – Etagen, Räume, Kategorien und (auf der ETS-Route) Geräte und Gruppenadressen.
- Die KNX-Bridge neu starten – eine Neuverbindung; der Bus selbst bleibt unberührt.
Klicken Sie auf Apply and finish. Ein Live-Fortschrittspanel verfolgt die Phasen und zeigt die verstrichene Zeit an. Sobald dort Setup complete steht, schließt sich der Assistent und die Seite System öffnet sich.
📘 Hinweis: Haben Sie einen Dienst im Bereich Services ein- oder ausgeschaltet (siehe „Schritt 4 – Dienste“ oben), erscheint stattdessen der Dialog Reboot to finish setup: Diese Dienste starten oder stoppen nur beim Neustart des Servers, der etwa zwei Minuten dauert. Klicken Sie auf Reboot now, oder auf Later und starten Sie von der Seite System aus neu, wann es Ihnen passt.
Wenn etwas schiefgeht: Der Durchlauf stoppt in der fehlgeschlagenen Phase und meldet dies. Was frühere Phasen geschrieben haben, bleibt bestehen; Retry führt alle Phasen erneut aus, prüfen Sie daher zuerst das Gebäude auf der Seite System, wenn der Fehler spät auftrat. Wurde der Server während des Anwendens neu gestartet, meldet der Assistent, dass der Auftrag verloren ging – prüfen Sie das Ergebnis auf der Seite System und führen Sie den Assistenten erneut aus, wenn die Struktur fehlt.