UniFi Access : déclencheurs de scénario et adresses de groupe KNX

Un événement UniFi Access (sonnette, accès autorisé ou refusé, entrée ou sortie) peut déclencher un scénario Link’nX. Le tableau de passerelle de la porte associe aussi des adresses de groupe KNX à son déverrouillage et à ses états : verrou et position de la porte.

Destiné aux administrateurs et installateurs. Gardez en tête qu’un accès autorisé, l’état du verrou et la position physique de la porte sont trois informations différentes.

Avant de commencer

• La porte est déclarée dans Link’nX.
• Les horloges du contrôleur Access et de la gateway sont synchronisées par NTP : un événement daté de plus de 2 minutes est ignoré.
• Pour le KNX, l’installateur fournit les adresses de groupe de son projet ETS ; 1/2/3 n’est qu’un exemple fictif.

Créer un déclencheur UniFi Access

1. Dans le bon projet et la bonne gateway, ouvrez Déclencheurs → Ajouter → UniFi Access.
2. Renseignez Nom, puis Porte UniFi Access.
3. Choisissez Type d’événement : Sonnette, Accès autorisé, Accès refusé, Accès autorisé (entrée) ou Accès autorisé (sortie).
4. Pour les quatre événements d’accès, Méthode d’accès propose Toutes les méthodes, Badge NFC, Bouton sortie (REX), Bouton entrée (REN), À distance (app/API) et Tap mobile (Bluetooth). Laissez Toutes les méthodes si vous ne souhaitez pas restreindre la méthode. Sonnette n’affiche pas ce filtre.
5. Enregistrez avec la disquette en bas à droite, attendez Succès ! et retrouvez le déclencheur dans la liste.
6. Ajoutez le déclencheur au scénario concerné et enregistrez ce dernier. Pour modifier un déclencheur existant, suivez l’édition des déclencheurs.

Choisir l’événement et la méthode d’accès

• La méthode décrit le moyen d’accès, l’événement annonce la direction : Bouton sortie (REX) est une méthode, Accès autorisé (sortie) une direction.
• Un même accès autorisé peut déclencher l’événement général Accès autorisé et sa variante entrée ou sortie. Sans direction annoncée, ne déduisez ni une entrée ni une sortie.
• Ces déclencheurs ne comptent pas les passages et ne fournissent pas d’historique nominatif.
• Faites confirmer par le support le filtre Bouton entrée (REN) avant d’en dépendre : selon le matériel, l’option peut ne produire aucun événement exploitable. Faites aussi confirmer le comportement attendu pour plusieurs portes sur un même équipement ou pour une méthode particulière.

Associer les commandes et retours KNX de la porte

1. Dans la liste UniFi Access, cliquez sur les deux flèches Configuration de la partie passerelle de la porte.
2. Dans l’onglet Actions, vérifiez le DPT de chaque commande utile, renseignez son adresse de groupe KNX et cochez Actif.
3. Enregistrez avec la disquette et attendez Données sauvegardées avec succès ! avant de changer d’onglet.
4. Ouvrez le deuxième onglet, signalé par une bulle de message, et associez de la même façon les retours voulus.
5. Enregistrez cet onglet.

Le fonctionnement commun (filtre, activation, enregistrement) est décrit dans le guide du tableau de passerelle. Pour désactiver une association, décochez Actif et enregistrez l’onglet.

Tous les points proposés ici utilisent DPT 1.001 :

Onglet et point	Valeur 1	Valeur 0
Actions — Déverrouiller (momentané)	Demande l’ouverture temporaire	Aucune demande de verrouillage
Actions — Maintenir déverrouillé	Maintient la porte déverrouillée	Demande le retour au planning, qui ne verrouille pas forcément tout de suite
Deuxième onglet — État du verrou	Relais déverrouillé	À interpréter avec l’état disponible sur le contrôleur
Deuxième onglet — Position de la porte	Porte ouverte	Ne certifie pas une porte fermée lorsque l’information de contact est inconnue ou absente

Les règles avec durée et l’urgence se configurent dans les actions UniFi Access, pas dans ces deux lignes KNX. Dans votre logique KNX, ne remplacez pas un retour absent par 0 et vérifiez l’actualité de la dernière valeur.

Vérifier le résultat

• Déclencheur : rouvrez-le pour relire la porte, le type d’événement et la méthode, puis vérifiez qu’il figure dans le scénario enregistré. Après un événement réel, consultez l’historique des scénarios. Un déclencheur d’accès signale un accès, pas un mouvement de la porte : pour sa position physique, utilisez Position de la porte.
• KNX : rouvrez le tableau pour relire les associations. Envoyez ensuite une commande depuis le bus, par exemple avec le moniteur de groupe d’ETS, et observez la porte. Pour un retour, envoyez une demande de lecture sur son adresse.

En cas de problème

• Le scénario ne se déclenche pas : vérifiez la porte sélectionnée, le type d’événement et la méthode, puis l’association au scénario et son enregistrement. Si vous êtes passé à Sonnette, le filtre de méthode a disparu. Ne remplacez pas le filtre par un autre événement au hasard.
• L’historique des scénarios affiche l’origine UniFi Access — événement ignoré (trop ancien) : vérifiez la synchronisation NTP du contrôleur Access et de la gateway.
• Un retour KNX manque : vérifiez le contexte, la porte, l’adresse, le DPT, la case Actif et l’enregistrement de l’onglet.

Si le problème persiste après ces vérifications, écrivez à support@can-nx.com en indiquant le type d’événement attendu ou le point KNX concerné, le modèle et la version, le contexte et les essais déjà faits. Ne transmettez ni jeton ni données d’occupants.

Interface en anglais : Event type, Access method, All methods, NFC badge, Exit button (REX), Entry button (REN), Remote (app/API), Mobile tap (Bluetooth), Lock state et Door position.