Une fois le premier administrateur créé, le panneau d'administration propose l'assistant de configuration dans la boîte de dialogue Your setup wizard is ready — cliquez sur Start setup. L'assistant vous guide dans la mise en service : quel type de projet, où il se situe, comment il atteint le bus KNX, quels services fonctionnent et ce que contient le bâtiment. Vous pouvez aussi l'ouvrir plus tard avec le bouton Setup wizard de la page System.
Fonctionnement de l'assistant
- Rien n'est écrit sur le serveur avant l'application finale. Chaque étape précédente ne fait que préparer un brouillon.
- Le brouillon survit aux rechargements — il est conservé dans le navigateur que vous utilisez, ce qui vous permet de fermer la page et d'y revenir sur le même ordinateur ; vos réponses sont toujours là.
- Save & exit, dans l'en-tête, quitte l'assistant et conserve le brouillon pour plus tard. Skip setup — configure later, sous la liste des étapes, quitte l'assistant et supprime le brouillon. Les deux mènent à la page System.
- Naviguez avec Back et Continue. L'en-tête indique votre progression (« Step 2 of 7 » — la voie ETS comporte une étape de plus, elle compte donc jusqu'à 8).
Étape 1 — Mode de configuration
« How do you want to build this project? » Trois choix :
- Import an ETS project (Fastest route) — chargez le fichier
.knxprojde l'installation et HyperVisu reconstruit la visualisation à partir de ce qu'ETS connaît déjà : les bâtiments et les pièces deviennent des étages et des pièces, les adresses de groupe arrivent nommées et typées, les fonctions ETS deviennent des appareils dont les objets de groupe sont déjà affectés. - Configure manually (No file needed) — décrivez vous-même le bâtiment. Idéal lorsqu'il n'y a pas de projet ETS sous la main, ou lorsque la visualisation ne doit pas le suivre.
- Restore a HyperVisu backup instead — une sauvegarde restaure un serveur complet (pièces, appareils, utilisateurs et services), le reste de l'assistant n'est donc pas nécessaire. Choose a file n'ouvre pas de sélecteur de fichier : il quitte l'assistant et ouvre la page Backup & Restore, où vous restaurez le fichier sous Restore from file (voir « Backup & Restore »). Aucun mot de passe ni sélection de services ne vous y est demandé — le fichier est restauré en entier et remplace ce qui se trouve sur le serveur, y compris l'administrateur que vous venez de créer.
📘 Note : Vous pouvez changer d'avis plus tard — changer de mode vous renvoie à l'étape 4, car les deux écrans suivants appartiennent à l'autre voie. Ce que vous aviez saisi sur la voie abandonnée est conservé au cas où vous y reviendriez.
Étape 2 — Projet et localisation
« Name the project and place it on the map. »
| Champ | Rôle |
|---|---|
| Project name | Identifie cette installation |
| Installer reference | Votre propre numéro de projet |
| App language | La langue dans laquelle s'ouvrent les apps mobile et web ; chaque utilisateur peut la modifier |
| City → Get coordinates | Saisissez la ville et laissez le serveur chercher la latitude et la longitude |
| Latitude / Longitude | Renseignées par la recherche, ou saisies à la main |
| Timezone | L'horloge sur laquelle fonctionne le serveur |
Les coordonnées et le fuseau horaire pilotent les heures de lever et de coucher du soleil, les automatisations programmées et chaque horodatage écrit par le serveur — renseignez-les avec précision.
Étape 3 — Interface du bus KNX
« Connect to the bus. » L'assistant analyse une fois le réseau à la recherche d'interfaces KNX/IP à l'ouverture de l'étape et affiche celles qui ont répondu sous forme de cartes indiquant le nom de l'interface, son type (Interface ou Router), son adresse et son numéro de série. Cliquez sur Scan again pour relancer l'analyse.
Si rien ne répond, ou si l'interface se trouve sur un autre sous-réseau ou derrière un VPN, utilisez Enter an address manually : saisissez l'adresse et le port dans le champ unique, par exemple 192.168.1.20:3671. Sans port, 3671 est utilisé.
Renseignez également :
- Connection type — Tunnel (UDP, pour une interface KNX/IP) ou Multicast (pour un routeur KNX/IP). Le sélectionner sur une carte découverte le définit pour vous ; pour une adresse saisie à la main, définissez-le vous-même.
- HyperVisu physical address — l'adresse individuelle que le serveur prend lui-même sur le bus. Elle est préremplie avec
1.1.250et doit être libre sur le bus.
Le test de connexion. Cliquez sur Run connection test pour voir jusqu'où la connexion aboutit. Cinq résultats s'affichent :
| Résultat | Ce qu'il vous indique |
|---|---|
| Host reachable | L'interface répond sur le réseau (yes, avec le temps de réponse, ou no). |
| Port 3671 / UDP | Si l'interface a répondu à une requête de description. Il peut indiquer not answered alors que le tunnel est ouvert — certaines interfaces ne répondent qu'à une vraie connexion. Ce n'est pas un défaut. |
| Tunnel | Si un tunnel a pu être ouvert (yes ou no). |
| Assigned address | L'adresse que l'interface a attribuée au tunnel de test. |
| Telegrams seen | Le nombre de télégrammes arrivés pendant que le test écoutait le bus. |
Quand le tunnel s'ouvre, le panneau affiche Tunnel open et le pied de page indique « Tunnel open — the bus answers. »
Un tunnel ouvert prouve la connexion ; seul Telegrams seen prouve un véritable trafic sur le bus. Une fois le tunnel ouvert, le test écoute pendant environ cinq secondes, donc 0 sur un bus calme n'est pas un défaut. Pour voir du trafic, cliquez sur Test again et actionnez aussitôt un interrupteur mural, pendant que le test s'exécute.
📘 Note : Lorsque vous relancez l'assistant sur un serveur déjà connecté au bus, le test n'ouvre pas de second tunnel, car cela pourrait interrompre la connexion en cours. Il signale la connexion active et ne compte aucun télégramme.
Si le tunnel ne s'ouvre pas, le panneau affiche No response et l'assistant propose de vérifier trois points : le tunnelling activé sur l'interface, aucun autre client ETS n'occupant tous les canaux, et le serveur et l'interface sur le même VLAN.
Cette étape ne bloque jamais : vous pouvez continuer sans tester, ou après un test échoué, et corriger la connexion plus tard.
Pas encore de bus sur site ? Cliquez sur I'll configure KNX later. L'assistant s'applique sans connexion au bus — les pièces, les appareils et les services sont créés normalement, et tout ce qui est lié au KNX reste silencieux tant qu'une interface n'est pas définie dans Connections (voir « Connections »).
Étape 4 — Services
« Which services should run? » Les commutateurs sont regroupés en trois sections, les mêmes que sur la page Services. Chaque section porte une pastille qui indique ce que coûte un changement :
| Section | Pastille | Signification |
|---|---|---|
| Services | Changes need a restart | Les services optionnels proposés par ce serveur, tels que la base de données d'historique, les tableaux de bord, Node-RED, le streaming de caméras et Home Assistant. Ils ne démarrent ou ne s'arrêtent qu'au redémarrage du serveur — l'assistant propose le redémarrage après l'application (voir « Final step — Review & apply » ci-dessous). |
| Communication protocols | Applied immediately | Les protocoles par lesquels le serveur dialogue avec les appareils. |
| Application services | no restart needed | Météo, prix de l'énergie et e-mail. |
Activés par défaut : les protocoles KNX et Virtual, et InfluxDB (la base de données d'historique). Le bouton au-dessus des cartes indique combien sont activés et les réinitialise à ces valeurs par défaut.
Une carte portant le badge API key needed exige aussi une clé ou des identifiants : complétez-les sur la page Services après l'assistant (voir « Services & Protocols »).
N'activez que ce que ce projet utilise — chaque service consomme de la mémoire et allonge le temps de démarrage. Tout peut être activé plus tard depuis Services & protocols.
Voie manuelle — Structure du bâtiment
(Les étapes 5 à 6 dépendent du mode de configuration. Cet écran et le suivant apparaissent sur la voie manuelle.)
« List the floors and their rooms. »
- L'assistant démarre avec un Ground floor (niveau 0). Pour ajouter un autre étage, saisissez son nom dans la ligne Add a floor et appuyez sur Enter.
- Saisissez un nom de pièce et appuyez sur Enter pour ajouter la suivante — une pièce par ligne, aussi vite que vous tapez.
- Pour en ajouter plusieurs d'un coup, utilisez Add several rooms at once : choisissez l'étage, saisissez les noms séparés par des virgules (« Bedroom 2, Bedroom 3, Dressing ») et cliquez sur le bouton d'ajout.
- Les icônes sont facultatives pour l'instant — l'app utilise le nom de la pièce tant qu'aucune n'est définie.
- Cliquez sur Continue to categories. Le bouton reste désactivé tant qu'il n'y a pas au moins une pièce.
📘 Note : L'assistant ne peut pas définir le niveau d'un étage. Les étages sont numérotés 0, 1, 2… dans l'ordre où vous les ajoutez : un sous-sol ajouté ici reçoit donc un niveau positif. Pour lui donner ensuite un niveau négatif, ouvrez Building → Floors, modifiez l'étage et changez son Floor Number (voir « Building Structure & Categories »).
Voie manuelle — Catégories
« Decide how the app groups devices. » Les catégories deviennent les vignettes de l'écran d'accueil de l'app et les filtres de chaque pièce ; un appareil appartient à une catégorie et à une pièce.
L'assistant crée sept catégories par défaut : Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Cliquez sur un nom pour le renommer.
- Supprimez une catégorie dont le projet n'a pas besoin.
- Add a category de votre choix (nom + icône), par exemple « Home cinema ».
Cliquez ensuite sur Review everything pour passer à l'étape finale (voir « Final step — Review & apply » ci-dessous).
📘 Note : La voie manuelle ne crée aucun appareil. Vous les ajoutez pièce par pièce depuis la page Devices après la configuration (voir « The Devices Workspace »).
Voie ETS — Sélection de l'import
(Cet écran remplace cet article lorsque vous avez choisi « Import an ETS project ».)
« Choose what to import. »
- Déposez le fichier
.knxproj(export de projet ETS 5 ou ETS 6) sur la zone Drop the .knxproj file here, ou cliquez sur cette zone pour choisir le fichier. Il n'y a pas de bouton de parcours distinct. - Si le projet est protég par mot de passe dans ETS, saisissez le Project password et cliquez sur Unlock and read. Le mot de passe sert à lire le fichier et n'est jamais enregistré.
- L'assistant lit le projet et propose trois parties à cocher, chacune avec les chiffres réels de votre fichier :
- Building structure — les étages et les pièces décrits par le projet ETS (« 3 floors · 14 rooms »).
- Group addresses — la table complète des adresses, afin que le moniteur de bus et le sélecteur d'adresses connaissent chaque adresse par son nom ; les nombres d'adresses typées et non typées sont indiqués.
- Devices from ETS functions — chaque fonction ETS devient un appareil, déjà lié à ses adresses de groupe.
- Décochez ce que vous ne voulez pas, puis cliquez sur Continue to categories. Laissez Building structure coché : sans cela, il n'y a pas de pièces où ranger les appareils et rien n'est créé à partir du projet.
La voie ETS affiche ensuite l'écran Categories avec les catégories produites par le projet — une par type d'appareil décrit. Renommez-les, changez les icônes ou ajoutez-en une que le projet ne couvre pas, comme sur l'écran Categories de la voie manuelle. Une catégorie encore utilisée par des appareils ne peut pas être supprimée tant que ces appareils n'ont pas été déplacés vers une autre catégorie sur l'écran de vérification. Cliquez sur Review rooms and devices pour passer à la vérification (voir « ETS branch — Review import » ci-dessous).
Voie ETS — Vérification de l'import
« Check what we found. » C'est la passe de correction sur tout ce que l'import va créer, organisée en arbre d'étages, de pièces et d'appareils. Avant d'appliquer, vous pouvez :
- Renommer les pièces et les appareils qui ressemblent encore à des libellés ETS — le nom ETS d'origine reste visible (« was … in ETS »), avec une action Revert.
- Modifier le type de widget d'un appareil lorsque l'import s'est trompé — les adresses liées limitent les types possibles.
- Déplacer des appareils vers une autre pièce ou catégorie, ou les Exclude si l'app ne doit pas les afficher.
- Confirmer les types de points de données déduits — les adresses sans DPT dans ETS reçoivent un DPT déduit, marqué à confirmer.
- Traiter le groupe « No room found » : de vrais appareils dont la pièce n'a pas pu être déterminée. Déplacez chacun vers une pièce ; ce qui reste est créé sans pièce.
📘 Note : Si le projet ne déclare aucune fonction ETS, l'assistant déduit les appareils à partir des canaux des actionneurs et signale chacun comme guessed — vérifiez les pièces, les noms et les types avant de continuer.
Les filtres (« Needs attention », « Renamed »), la recherche et un raccourci « Next room with an issue » vous aident à parcourir rapidement les grands projets. Vous pouvez appliquer avec des problèmes restants et les corriger plus tard dans Devices. Lorsque vous avez terminé, cliquez sur Review everything.
Étape finale — Vérification et application
« Project Review » résume l'ensemble en six cartes — mode de configuration et projet, localisation et heure, bus KNX, services, bâtiment, appareils et adresses — chacune avec un lien Edit qui renvoie à son étape.
Les problèmes bloquants sont listés au-dessus des cartes (par exemple « No coordinates — the apply will stop on the settings stage », « No rooms — the app will open empty »). Corrigez-les, ou confirmez qu'ils sont voulus.
Ce que fait l'application, dans l'ordre :
- Écrire les paramètres du serveur — localisation, fuseau horaire, interface de bus et services activés.
- Créer la structure — étages, pièces, catégories et (sur la voie ETS) appareils et adresses de groupe.
- Redémarrer le pont KNX — une seule reconnexion ; le bus lui-même n'est pas touché.
Cliquez sur Apply and finish. Un panneau de progression en direct suit les étapes et affiche le temps écoulé. Lorsqu'il indique Setup complete, l'assistant se ferme et la page System s'ouvre.
📘 Note : Si vous avez activé ou désactivé un service de la section Services (voir « Étape 4 — Services » ci-dessus), la boîte de dialogue Reboot to finish setup s'affiche à la place : ces services ne démarrent ou ne s'arrêtent qu'au redémarrage du serveur, qui prend environ deux minutes. Cliquez sur Reboot now, ou sur Later et redémarrez depuis la page System quand cela vous convient.
En cas de problème : l'exécution s'arrête sur l'étape en échec et vous le signale. Ce que les étapes précédentes ont écrit reste en place ; Retry relance toutes les étapes, vérifiez donc d'abord le bâtiment sur la page System si l'échec est survenu tard. Si le serveur a redémarré pendant l'application, l'assistant indique que la tâche a été perdue — vérifiez le résultat sur la page System et relancez l'assistant si la structure est absente.