--- title: "UniFi Network : présence des clients, déclencheurs et tableau KNX" description: "UniFi Network : présence des clients, déclencheurs et tableau KNX. Link’nX : créer un déclencheur Network connexion déconnexion MAC et le relier au scénario, distinguer état initial…" canonical: https://wiki.can-nx.com/guides/link-unifi-network-presence-knx/ language: fr product: Link’nX audience: - administrateur - installateur context: Link’nX dans un projet et une gateway autorisés ; UniFi Access ou UniFi Network selon option et contrôleur ; FR/EN, navigation mobile --- # UniFi Network : présence des clients, déclencheurs et tableau KNX Contexte : Link’nX dans un projet et une gateway autorisés ; UniFi Access ou UniFi Network selon option et contrôleur ; FR/EN, navigation mobile Ce guide concerne l’administrateur ou l’installateur disposant d’un [contrôleur déclaré](https://wiki.can-nx.com/guides/link-unifi-devices/). La présence d’un client réseau correspond à un appareil associé, pas à une personne identifiée. Le nombre de clients peut inclure téléphones, ordinateurs et équipements connectés. ## Déclencher un scénario à la connexion ou à la déconnexion 1. Dans le bon projet et la bonne gateway, ouvrez **Déclencheurs → Ajouter → UniFi Network**. 2. Renseignez **Nom**, puis **Contrôleur UniFi Network**. 3. Renseignez **Adresse MAC du client**, par exemple `02:00:00:00:00:01`, valeur fictive à remplacer par la MAC du client vu par la console. 4. Dans **Événement**, choisissez **Client connecté** ou **Client déconnecté**. 5. Cliquez sur la disquette en bas à droite, attendez **Succès !** et retrouvez le déclencheur dans la liste. Associez-le ensuite au [scénario](https://wiki.can-nx.com/guides/link-scenario-save/) concerné et enregistrez ce dernier. Ces événements correspondent à des changements observés. Une première lecture établissant l’état initial ne constitue pas automatiquement une nouvelle connexion. La déconnexion est confirmée sur plusieurs lectures ; ne promettez pas une réaction instantanée ni un délai exact. Une indisponibilité du contrôleur ne prouve pas le départ du client, et un état précédemment affiché ne prouve pas sa présence actuelle. Si le scénario ne réagit pas, vérifiez contrôleur, site, MAC, événement, association au scénario et enregistrement. Si ces étapes ont déjà été vérifiées, contactez support@can-nx.com avec l’événement attendu, le résultat et les essais ; ne transmettez pas de mot de passe ni de liste nominative d’occupants. ## Ouvrir et remplir le tableau KNX Depuis la liste **UniFi Network**, cliquez sur les deux flèches **Configuration de la partie passerelle** du contrôleur. Cette passerelle utilise **un tableau unique** : chaque ligne possède **Cible (MAC du client / ID de l’équipement)**, **Commande / état**, **DPT**, **Adresse de groupe KNX** et **Actif**. 1. Cliquez sur **Ajouter**. 2. Choisissez **Commande / état**, dans **Commandes** ou **États**. 3. Renseignez la cible correspondant au point. **Nombre de clients actifs** concerne tout le site et accepte une cible vide ; les autres points demandent une cible. 4. Vérifiez le **DPT** proposé. Il reste modifiable : conservez le type prévu avec l’installateur. 5. Renseignez **Adresse de groupe KNX**, puis cochez **Actif** pour l’association à utiliser. Par exemple, `1/2/3` est une adresse fictive à remplacer selon le projet ETS. 6. Complétez aussi les champs requis des éventuelles lignes inactives, ou retirez une ligne inutile avec sa corbeille **Supprimer**. 7. Cliquez sur la disquette en bas à droite. Attendez **Succès ! / Mis à jour !**, puis quittez et rouvrez **Configuration de la partie passerelle** pour relire toutes les associations. Enregistrez avant de quitter : ce tableau ne promet pas de confirmation de départ. La corbeille retire une ligne du formulaire ; enregistrez pour conserver la suppression. Pour suspendre une association en gardant ses paramètres, décochez **Actif** et enregistrez. ## Commandes et valeurs KNX Toutes les commandes proposées utilisent **DPT 1.001**. Les cibles sont les mêmes que dans [Actions Network](https://wiki.can-nx.com/guides/link-unifi-network-actions/). | Commande | Valeur `1` | Valeur `0` | | --- | --- | --- | | Bloquer le client | Demander le blocage de la MAC | Demander son déblocage | | Activer le WLAN | Demander l’activation du WLAN nommé | Demander sa désactivation | | Reconnecter (kick) le client | Demander la reconnexion de la MAC | Aucune commande de reconnexion | | Redémarrer l’équipement | Demander le redémarrage de la MAC d’équipement | Aucune demande de redémarrage | | Redémarrer le port PoE | Demander le cycle d’alimentation de la cible MAC_port | Aucun cycle demandé | Le tableau KNX ne propose pas de ligne séparée **Débloquer le client** ou **Désactiver le WLAN** : utilisez `0` sur la commande correspondante. Les redémarrages et cycles PoE ne servent pas à vérifier simplement une association ; une demande envoyée ne prouve pas son exécution. ## Interpréter les états | État | Cible | DPT | Lecture et limite | | --- | --- | --- | --- | | Client connecté | MAC du client | 1.001 | `1` associé, `0` absent de l’état de présence connu ; ce n’est pas une preuve de présence humaine ni d’actualité en cas de perte de communication | | Client bloqué | MAC du client | 1.001 | `1` blocage connu ; `0` ne suffit pas à exclure un blocage décidé ailleurs pour un client hors ligne | | WLAN activé | Nom exact du WLAN | 1.001 | `1` activé, `0` désactivé dans l’état disponible ; une valeur absente ne doit pas être remplacée par `0` | | Nombre de clients actifs | Aucune nécessaire | 7.001 | Nombre d’appareils du site, sans déduire un nombre de personnes | Si un retour manque, vérifiez le point, sa cible, le DPT, l’adresse, **Actif**, la sauvegarde et le contexte du contrôleur. Si la cible WLAN n’est pas unique ou qu’un blocage hors ligne doit être établi avec certitude, faites confirmer la situation par le responsable réseau ou support@can-nx.com. Si le contrôle de ces champs a déjà échoué, transmettez un résumé des essais au support au lieu de modifier d’autres réglages au hasard. En anglais : **Client MAC address**, **Event**, **Client connected**, **Client disconnected**, **Command / state**, **Commands**, **States**, **Client blocked**, **WLAN enabled** et **Active client count**. Voir aussi [l’édition des déclencheurs](https://wiki.can-nx.com/guides/link-trigger-edit/).