UniFi Network : présence des clients, déclencheurs et adresses KNX

Dans Link’nX, la connexion ou la déconnexion d’un client UniFi Network peut déclencher un scénario. Le tableau KNX du contrôleur associe aussi des adresses de groupe aux commandes réseau (blocage, WLAN, redémarrage, PoE) et aux états : client connecté ou bloqué, WLAN activé, nombre de clients actifs.

Destiné aux administrateurs et installateurs. La présence d’un client correspond à un appareil associé au réseau, pas à une personne identifiée. Le nombre de clients peut inclure téléphones, ordinateurs et équipements connectés.

Avant de commencer

• Le contrôleur est déclaré dans Link’nX.
• Vous connaissez la MAC des clients suivis, telle que la console l’affiche, et les adresses de groupe prévues dans le projet ETS.

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.
6. Associez-le au scénario concerné et enregistrez ce dernier. Pour modifier un déclencheur existant, suivez l’édition des déclencheurs.

Ces événements correspondent à des changements observés :

• La première lecture établit l’état initial ; elle ne compte pas automatiquement comme une nouvelle connexion.
• La déconnexion est confirmée sur plusieurs lectures : la réaction n’est donc pas instantanée, et aucun délai exact n’est garanti.
• Une indisponibilité du contrôleur n’indique pas le départ du client, et un état affiché auparavant n’indique pas sa présence actuelle.

Remplir le tableau KNX du contrôleur

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 le groupe 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, par exemple 1/2/3, adresse fictive à remplacer selon le projet ETS. Cochez Actif pour l’association à utiliser.
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 et attendez Succès ! / Mis à jour !. Enregistrez avant de quitter : ce tableau ne demande 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.

Associer les commandes KNX

Toutes les commandes proposées utilisent DPT 1.001. Leurs cibles sont les mêmes que dans les actions UniFi Network.

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 : envoyez 0 sur la commande correspondante. N’utilisez pas les redémarrages et cycles PoE pour simplement vérifier une association.

Lire 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 ; ni preuve de présence humaine, ni garantie d’actualité en cas de perte de communication
Client bloqué	MAC du client	1.001	1 blocage connu ; pour un client hors ligne, 0 n’exclut pas un blocage décidé ailleurs
WLAN activé	Nom exact du WLAN	1.001	1 activé, 0 désactivé dans l’état disponible ; ne remplacez pas une valeur absente par 0
Nombre de clients actifs	Aucune nécessaire	7.001	Nombre d’appareils du site, sans en déduire un nombre de personnes

Vérifier le résultat

1. Rouvrez le déclencheur pour relire le contrôleur, la MAC et l’événement, puis vérifiez qu’il figure dans le scénario enregistré.
2. Quittez puis rouvrez Configuration de la partie passerelle pour relire toutes les associations.
3. Envoyez une commande depuis le bus dans le contexte autorisé, puis contrôlez son effet dans la console UniFi. Pour un état, comparez la valeur reçue sur le bus avec la console.

En cas de problème

• Le scénario ne réagit pas : vérifiez le contrôleur, le site, la MAC, l’événement, l’association au scénario et son enregistrement.
• Un retour manque : vérifiez le point, sa cible, le DPT, l’adresse, Actif, l’enregistrement et le contexte du contrôleur.
• La cible WLAN n’est pas unique, ou un blocage hors ligne doit être établi avec certitude : faites confirmer la situation par le responsable réseau ou par le support.

Si le contrôle de ces champs a déjà échoué, écrivez à support@can-nx.com avec l’événement ou le point attendu, le résultat observé et un résumé des essais, au lieu de modifier d’autres réglages au hasard. Ne transmettez ni mot de passe ni liste nominative d’occupants.

Interface en anglais : Client MAC address, Event, Client connected, Client disconnected, Command / state, Commands, States, Client blocked, WLAN enabled et Active client count.