Passer au contenu
Elausys

HyperVisu / Dépannage et référence

Dépannage : KNX et appareils

Aucun télégramme, interface occupée, appareils sans réaction — une démarche de diagnostic méthodique.

elausys · 15 août 2026
Sur cette page

KNX

Commencez par cliquer sur Test au niveau de la connexion KNX sur la page Connexions (voir « Connexions ») : le système indique Connexion réussie ou Échec de la connexion. Le test de connexion de l'assistant de configuration initiale (voir « Assistant de configuration initiale ») va plus loin et fonctionne comme une échelle de diagnostic : chacun de ses cinq résultats permet d'écarter un niveau de défaillance — accessibilité réseau, port, tunnel, adresse attribuée, télégrammes reçus pendant l'écoute du test (environ cinq secondes). Le moniteur de bus (voir « Moniteur de bus KNX ») en apporte la confirmation : si des télégrammes y apparaissent, la liaison avec le bus fonctionne.

ProblèmeVérificationSolution
Les appareils KNX ne répondent pasLe protocole KNX est-il activé (voir « Services et protocoles ») ? Que mentionne l'état de la connexion (voir « Connexions ») ?Activer le protocole ; vérifier l'adresse IP et les paramètres de l'interface ; lancer le test de connexion.
Le test de connexion n'ouvre pas le tunnelD'autres outils sont-ils connectés à la même interface ?Les interfaces KNX/IP disposent d'un nombre limité de tunnels. Fermer ETS ou les autres outils de bus, ou redémarrer l'interface électriquement.
Un seul appareil ne réagit pasL'objet du widget est-il lié à la bonne adresse de groupe (voir « Intégration KNX ») ? Y a-t-il des erreurs de transformation ?Corriger la liaison ; consulter la page État du système (voir « Transformations de valeurs et état du système ») pour identifier les liaisons incompatibles et les erreurs d'exécution.

Appareils et données

ProblèmeVérificationSolution
Un appareil ne réagit pas depuis l'applicationÉtat de la connexion (voir « Connexions ») ; objets non liés ; page État du système (voir « Transformations de valeurs et état du système »)Lier les objets manquants, rétablir la connexion, corriger les erreurs de transformation.
Un appareil ignore les commandes « Tout éteindre » / commandes de pièceEst-il exclu des commandes globales (voir « Code PIN d'alarme et exclusions de commandes globales ») ?Cette exclusion est délibérée — l'administrateur l'a configurée. La retirer dans le panneau d'administration si elle n'est pas souhaitée.
Aucun historique, graphiques videsLe service d'historique est-il activé (voir « Services et protocoles ») ? L'option Enregistrer les valeurs d'historique est-elle activée pour cet objet (voir « Paramètres d'objet, enregistrement et notifications ») ?Activer la base de données d'historique et cocher Enregistrer les valeurs d'historique sur chaque objet concerné. L'historique démarre à l'activation de l'enregistrement — il n'est pas rétroactif.
La météo n'affiche rienClé API renseignée ? Emplacement défini (voir « Paramètres réseau et heure », « Service météo ») ? Service activé ?Saisir une clé de fournisseur valide et définir la ville/coordonnées ; vérifier via la valeur en direct sur la page Météo.
Les tarifs de l'énergie sont videsClé ENTSO-E ? Zone d'enchère sélectionnée (voir « Service de tarification de l'énergie ») ?Saisir la clé, choisir la zone d'enchère, cliquer sur Enregistrer la configuration, puis activer le service ; le commutateur revient à l'arrêt en cas d'échec de récupération.
Une connexion MQTT affiche DéconnectéTester la connexion (voir « Connexions ») : le broker indique-t-il Non autorisé ou refuse-t-il la connexion ?Corriger l'identifiant/mot de passe ou le port ; pour mqtts://, vérifier le certificat (certificat CA ou Accepter les certificats auto-signés pour un broker utilisant le sien). Le serveur relance la tentative automatiquement dès que la configuration est correcte.
Un widget MQTT ne se met jamais à jourLe topic de l'objet correspond-il exactement à ce que l'appareil publie ? Le chemin JSON pointe-t-il vers un champ existant ?Cliquer sur Analyser le broker dans l'éditeur d'objets (voir « Intégration MQTT ») et sélectionner le topic ainsi que le champ directement dans les messages reçus du broker — un mauvais chemin ignore silencieusement chaque message. Un topic sortant ne doit pas contenir + ni #. Un broker refusant les filtres de topic (sa liste de contrôle d'accès) est consigné dans le journal du serveur.
Le broker intégré n'affiche rien sur la page Broker MQTTLe service Broker MQTT est-il activé et le serveur a-t-il été redémarré ensuite (voir « Services et protocoles ») ?Activer le service, redémarrer, puis rouvrir Configurer. Le panneau d'état signale si le broker n'est pas en cours d'exécution (voir « Le broker MQTT intégré »).
Un appareil ne parvient pas à se connecter au broker intégréDispose-t-il de son propre compte ? L'adresse configurée dans l'appareil correspond-elle exactement à celle sous Adresse à saisir dans l'appareil ?Ajouter un compte par appareil ; les connexions anonymes étant désactivées par défaut, un appareil sans identifiants est refusé. Vérifier que la carte d'écoute indique En écoute et non Arrêté.
Un appareil cesse de fonctionner dès l'activation des règles de topicCe compte dispose-t-il d'une règle couvrant les topics qu'il utilise ?Lorsque l'option Restreindre les topics par compte est activée, un compte sans règle correspondante est systématiquement refusé. Ajouter une règle par appareil ; le compte propre d'HyperVisu n'en requiert aucune — il conserve en permanence un accès complet.
Les valeurs persistantes disparaissent après un redémarrageL'option Conserver les messages persistants au redémarrage est-elle activée ? L'option Autoriser les messages persistants est-elle activée ?Activer les deux options. Sans persistance, le broker démarre vide et chaque widget attend la publication suivante de l'appareil.
Rien n'apparaît sur les topics d'état publiésL'option Publier l'état des widgets sur MQTT est-elle activée ? Le panneau indique-t-il qu'elle est activée mais sans publication ?La publication nécessite l'activation du protocole MQTT et une connexion établie vers un broker. Vérifier que l'aperçu du topic correspond à votre abonnement — le numéro de série et le format du topic en font partie.
Les commandes sur un topic …/set restent sans effetL'option Accepter les commandes via MQTT est-elle activée ? L'accès anonyme est-il désactivé ? L'objet est-il en lecture seule ?Les commandes sont globalement refusées tant que le broker autorise les clients anonymes, et message par message sur les objets en lecture seule ou dont la charge utile ne correspond pas au type de l'objet.
La commande BACnet Analyser le réseau ne trouve rienLe service BACnet/IP fonctionne-t-il (voir « Services et protocoles ») ? L'appareil est-il sur ce sous-réseau, sur le port standard ?Activer le service ; utiliser ensuite Analyser l'adresse (voir « Intégration BACnet/IP ») avec l'adresse de broadcast du sous-réseau (192.168.1.255) lorsque les diffusions sont filtrées entre VLANs, ou l'adresse directe de l'appareil (192.168.1.70:47808) — un appareil sur un port non standard n'est jamais détecté par broadcast.
Un appareil BACnet ignore le widgetUn autre système (la gestion technique du bâtiment) écrit-il sur le même objet ? L'état multiple présente-t-il un décalage d'une unité ?Définir une Priorité d'écriture de valeur numérique inférieure à celle de l'autre émetteur (voir « Intégration BACnet/IP ») ; appliquer un décalage de -1 sur les liaisons multi-états.
Un test TCP/UDP échoue ou la connexion reste DéconnectéImpossible de joindre … délai de connexion dépassé ou ECONNREFUSEDVérifier l'adresse et le port, et s'assurer qu'aucun autre outil n'occupe la connexion unique de l'appareil (l'outil propriétaire du fabricant). Un test exécuté sur une connexion déjà occupée par le service renvoie l'état réel au lieu de sonder l'appareil — ce comportement est normal.
La fonction Sonos Analyser le réseau ne trouve aucune zoneLes enceintes sont-elles sur le même segment réseau que le serveur ? Le protocole Sonos est-il activé ?La découverte s'appuie sur une diffusion réseau, souvent bloquée par les routeurs et les VLANs. Saisir manuellement l'adresse IP de l'enceinte référente — une seule adresse suffit pour l'ensemble du foyer (voir « Intégration Sonos »).
Les boutons de source Sonos affichent des noms incorrectsLes favoris ont-ils été modifiés dans l'application Sonos après la création du widget ?Cliquer sur Synchroniser les favoris Sonos sur le widget (voir « Bibliothèque d'appareils et liaison Sonos »). Les noms sont enregistrés sur le widget et ne s'actualisent pas d'eux-mêmes depuis l'application Sonos.
Un appareil créé depuis la bibliothèque ne réagit pasL'option Appliquer les modifications a-t-elle été exécutée après sa création ? L'appareil requiert-il l'activation d'une option (Conditions préalables de configuration) ?Appliquer les modifications en attente ; relire ensuite les prérequis du modèle — la majorité des onduleurs sont livrés avec le Modbus TCP désactivé et certains nécessitent un compte installateur pour l'activer (voir « Bibliothèque d'appareils et liaison Sonos »).
Un appareil TCP/UDP ignore les commandes ou ne transmet aucune valeurLa trame se termine-t-elle par le délimiteur ? Les commandes sont-elles envoyées trop rapidement ? Existe-t-il un Modèle de correspondance ?Vérifier l'aperçu Trame envoyée (voir « Intégration TCP/UDP ») ; augmenter le Délai entre les commandes ; un objet entrant sans modèle de correspondance ne reçoit jamais de valeur, et la clé doit figurer dans la trame de retour de l'appareil.

Questions fréquentes

Par quoi commencer lorsque les appareils KNX ne répondent pas ?

Vérifiez que le protocole KNX est activé, contrôlez les paramètres de l'interface et lancez Connexions → KNX → Test. Le moniteur de bus permet de confirmer si les télégrammes atteignent HyperVisu.

Pourquoi l'étape du tunnel KNX échoue-t-elle ?

L'interface ne dispose peut-être d'aucun emplacement de tunnel libre. HyperVisu nécessite son propre tunnel et ne le libère pas pour ETS ; fermez ETS ou les autres outils de bus, ou utilisez une interface offrant davantage de tunnels.

Pourquoi mes graphiques d'historique sont-ils vides ?

Activez la base de données d'historique ainsi que l'enregistrement sur l'objet concerné. La collecte commence dès l'activation de l'enregistrement ; les valeurs antérieures ne peuvent pas être récupérées.

Pourquoi un widget MQTT ne s'actualise-t-il jamais ?

Vérifiez la concordance exacte du topic d'état et du chemin JSON. Utilisez l'option Analyser le broker dans l'éditeur d'objets pour sélectionner un topic et un champ issus des messages réels.

Pourquoi un appareil de la bibliothèque ne répond-il pas après sa création ?

Appliquez les modifications en attente, puis consultez les prérequis de configuration du modèle. Certains appareils nécessitent l'activation préalable de leur protocole, tel que Modbus TCP.

Pourquoi les favoris Sonos ne sont-ils pas à jour ?

Les noms des favoris enregistrés sur le widget ne s'actualisent pas automatiquement. Utilisez la fonction Synchroniser les favoris Sonos après toute modification dans l'application Sonos.

Continuer l'exploration

Retrouvez les autres guides de ce produit dans la documentation.

Retour à Dépannage et référence