---
title: Scanner une ligne KNX et ajouter ses participants à la surveillance Boss’nX
description: "Scanner une ligne KNX et ajouter ses participants à la surveillance Boss’nX. Boss’nX : ouvrir Scanner le bus KNX avec Gérer la santé réseau et choisir passerelle ligne, renseigner…"
canonical: https://wiki.can-nx.com/guides/boss-health-scan/
language: fr
product: Boss’nX
audience:
  - administrateur
  - installateur
context: Supervision autonome ou ouverte depuis hypervision ; Santé réseau sur ordinateur ; FR/EN
---

# Scanner une ligne KNX et ajouter ses participants à la surveillance Boss’nX

Contexte : Supervision autonome ou ouverte depuis hypervision ; Santé réseau sur ordinateur ; FR/EN

Pour un administrateur ou un installateur ayant **Voir la santé réseau** et **Gérer la santé réseau**, dans la supervision concernée, sur ordinateur. Préparez la passerelle KloudnX et la ligne confirmées pour l’installation.

Le scan détecte des participants pour créer des suivis dans **Santé réseau**. Il ne remplace pas un import ETS, la création de points dans un composant ou [la sélection des adresses à historiser](https://wiki.can-nx.com/guides/boss-knx-monitoring/).

## Lancer le scan

1. Ouvrez **Santé réseau**, éventuellement depuis **Plus**, puis cliquez sur **Scanner le bus KNX**.
2. Dans **Passerelle KloudnX**, vérifiez et choisissez la passerelle dont le bus doit être sondé. Ne conservez pas automatiquement le premier choix.
3. Dans **Ligne à scanner**, indiquez **zone.ligne**, avec chaque nombre de zéro à quinze. **1.1**, exemple fictif proposé initialement, désigne une ligne ; **1.1.5** désigne un participant et ne convient pas à ce champ.
4. Lisez l’avertissement : le scan sonde **256 adresses**, dure environ **40 secondes** et génère du trafic sur le bus. Évitez de le lancer pendant une mise en service ETS.
5. Cliquez sur **Lancer le scan**. Vérifiez le rappel de la passerelle et de la ligne, puis observez les compteurs d’adresses sondées et de participants détectés.
6. Attendez **Scan terminé — … participants détectés sur … adresses sondées en … s.** avant de préparer l’ajout.

La durée annoncée est indicative. Une adresse découverte montre un résultat du scan, pas une garantie de disponibilité permanente. Si un participant manque, vérifiez d’abord la ligne et la passerelle ; ne concluez pas immédiatement qu’il est absent ou défectueux.

## Choisir les participants à ajouter

1. Relisez chaque adresse physique. Les nouveaux participants sont cochés initialement : décochez ceux que vous ne souhaitez pas surveiller.
2. Une ligne **déjà surveillé** affiche le nom existant et sa case est désactivée. Cette reconnaissance porte sur un suivi ayant la même passerelle et la même adresse physique, même si ce suivi est suspendu. Pour le réactiver, utilisez [Modifier → Surveillance active](https://wiki.can-nx.com/guides/boss-health-manage/).
3. Sur les nouvelles lignes, adaptez le champ de nom à droite de l’adresse. Le nom proposé est **Participant …**. Donnez des noms permettant de reconnaître les appareils ; ne confondez pas nom et adresse.
4. Vérifiez le compteur **… participants sélectionnés** et cliquez sur **Ajouter … participants à la surveillance**.
5. Attendez la fermeture de la fenêtre, puis retrouvez les nouvelles lignes dans **Équipements surveillés**, avec **Tous** ou **KNX**.
6. Si nécessaire, ouvrez le crayon **Modifier** de chaque ligne pour relire sa passerelle et son adresse, choisir un emplacement ou ajuster l’intervalle.

Les participants ajoutés sont des suivis KNX actifs, avec l’adresse physique détectée, un intervalle initial de **60 secondes** et aucun emplacement renseigné. Le scan ne renseigne pas automatiquement une adresse de groupe dans ces suivis. Consultez [la signification des états](https://wiki.can-nx.com/guides/boss-health/) avant de conclure sur leur fonctionnement.

## Fermer ou annuler

Avant le lancement, **Annuler** ferme la fenêtre sans lancer le scan. Pendant le scan, **Annuler le scan** ferme l’assistant ; ne supposez pas que cela arrête immédiatement le sondage déjà lancé sur la passerelle. Attendez sa fin avant d’en relancer un sur la même passerelle.

Sur les résultats, **Fermer** abandonne les choix non ajoutés. Après avoir lancé l’ajout, fermer la fenêtre ne revient pas sur les participants déjà créés.

## Comprendre une erreur et reprendre

| Message ou situation | Marche à suivre |
| --- | --- |
| **Sélectionnez une passerelle KloudnX.** | Choisissez la passerelle confirmée. Si aucune ne convient, faites vérifier les passerelles du projet. |
| **Ligne invalide — format zone.ligne (ex. 1.1).** | Corrigez les deux nombres séparés par un point ; n’utilisez ni adresse de groupe ni adresse complète de participant. |
| **Un scan est déjà en cours sur cette passerelle. Réessayez dans une minute.** | Attendez la fin du scan existant. Fermez l’assistant, puis rouvrez-le pour une nouvelle tentative si elle reste nécessaire. |
| **Bus KNX injoignable — la passerelle n'a pas pu ouvrir de connexion au bus.** | Faites vérifier la bonne passerelle et son accès au bus. Ce message ne désigne pas un participant particulier comme défectueux. |
| **Passerelle à mettre à jour — cette version ne sait pas encore scanner le bus KNX.** | Contactez **support@can-nx.com** pour faire confirmer la mise à jour adaptée. Ne déduisez pas une procédure de mise à jour de ce seul message. |
| **Le scan n'a pas répondu à temps. Vérifiez la passerelle puis réessayez.** | Vérifiez la passerelle et la session, puis réessayez une fois après fermeture et réouverture de l’assistant. Si ces vérifications ont déjà échoué, passez au support. |
| **Le scan a échoué. Réessayez.** | Conservez le message et le contexte ; ne supposez pas une cause précise. Si une tentative dans le bon contexte échoue encore, contactez le support. |

Avec **L'ajout des participants a échoué. Réessayez.**, certains participants peuvent avoir été créés avant l’échec. **Ne relancez pas immédiatement l’ajout de la même sélection.**

1. Fermez l’assistant et vérifiez les lignes déjà ajoutées dans **Santé réseau**.
2. Si une reprise est nécessaire et que le scan précédent est terminé, rouvrez **Scanner le bus KNX** avec la même passerelle et la même ligne.
3. Après le nouveau scan, vérifiez les lignes **déjà surveillé** et sélectionnez uniquement les participants encore manquants.
4. Lancez leur ajout une fois, puis contrôlez la liste. Si l’état reste incertain ou si l’ajout échoue encore, contactez **support@can-nx.com** avant d’autres créations.

Indiquez au support le bâtiment, la passerelle, la ligne, le message, les participants déjà visibles et les essais réalisés. Une capture sans données sensibles peut aider. N’annoncez pas que le scan a supprimé, ajouté ou réparé des équipements physiques.

En anglais : **Network health → Scan the KNX bus**, **KloudnX gateway**, **Line to scan**, **Start the scan**, **Cancel the scan**, **Scan complete**, **already monitored**, **Add … participants to monitoring**, **Close**, **Adding the participants failed. Try again.**