Déclarer une porte UniFi Access ou un contrôleur UniFi Network

Pour commander une porte UniFi Access ou un réseau UniFi Network depuis Link’nX, déclarez d’abord la porte, avec le jeton API de son contrôleur Access, ou la console UniFi Network, avec un compte local. Ces déclarations servent ensuite aux actions, aux déclencheurs de scénario et aux associations KNX.

Destiné aux administrateurs et installateurs qui disposent du projet, de la gateway et de l’option correspondante. UniFi Access commande des portes ; UniFi Network gère des équipements et clients réseau. UniFi Protect, destiné à la vidéosurveillance, se déclare avec les caméras.

Avant de commencer

• UniFi Access : préparez l’hôte et le port du contrôleur Access, un jeton API autorisé pour cette installation et la porte à commander. L’installateur confirme la création du jeton et la configuration initiale du contrôleur.
• UniFi Network : préparez une console UniFi OS, son hôte et son port, la clé du site Network et les identifiants d’un compte local autorisé à administrer le contrôleur.
• Saisissez le jeton et les identifiants uniquement dans le formulaire Link’nX, jamais dans un e-mail.

Ouvrir la liste UniFi Access ou UniFi Network

1. Sélectionnez le projet et la gateway dans Link’nX.
2. Dans la navigation des appareils, ouvrez Sécurité & Accès → UniFi Access ou Maison intelligente → UniFi Network. Vous pouvez aussi rechercher le nom de la famille. Sur petit écran, ouvrez d’abord la navigation.
3. Cliquez sur Ajouter dans la liste.

Si l’entrée est absente, vérifiez le contexte et l’option disponible avec le guide de navigation. Pour une carte marquée Bientôt, demandez au support l’accès, la licence ou la compatibilité du modèle.

Déclarer une porte UniFi Access

Une déclaration représente une porte.

1. Renseignez Nom, jusqu’à 64 caractères, par exemple Entrée fictive.
2. Dans Hôte (nom d’hôte ou IP), indiquez le contrôleur par son nom réseau ou son adresse IP, jusqu’à 128 caractères.
3. Vérifiez Port, prérempli à 12445, et gardez le port confirmé pour l’installation.
4. Renseignez Jeton API, masqué à l’écran. Sous ce champ, le formulaire rappelle que les horloges du contrôleur Access et de la gateway doivent être synchronisées par NTP : un événement daté de plus de 2 minutes est ignoré.
5. Dans Porte contrôlée, cliquez sur Détecter les portes. La détection fonctionne avant le premier enregistrement, dès que l’hôte et le jeton sont renseignés.
6. Attendez le résultat, puis sélectionnez votre porte dans Porte. Aucune porte n’est choisie automatiquement.
7. Cliquez sur le bouton rond avec une disquette, en bas à droite. Attendez Succès !, puis retrouvez la déclaration dans la liste.

Pour plusieurs portes du même contrôleur, créez une déclaration par porte. Avant de remplacer la porte d’une déclaration utilisée par des automatismes, vérifiez leurs cibles.

Déclarer un contrôleur UniFi Network

Le formulaire demande le compte local du contrôleur, pas votre compte Link’nX : faites-le confirmer par l’installateur. N’utilisez pas de jeton Access à la place du nom d’utilisateur et du mot de passe.

1. Renseignez Nom, jusqu’à 64 caractères.
2. Saisissez Hôte (nom d’hôte ou IP), jusqu’à 128 caractères, par exemple console.example.test, valeur fictive à remplacer.
3. Vérifiez Port, prérempli à 443, selon la console installée.
4. Renseignez Site, jusqu’à 64 caractères, prérempli à default. Indiquez la clé du site confirmée : son nom d’affichage peut en différer.
5. Renseignez Nom d’utilisateur, jusqu’à 128 caractères, et Mot de passe du compte local. Ces deux champs sont obligatoires. Le mot de passe s’affiche en clair pendant la saisie : masquez-le dans toute capture.
6. Cliquez sur la disquette en bas à droite, attendez Succès !, puis vérifiez la liste.

Ce formulaire ne propose ni détection des portes ni sélection automatique des clients réseau. Pour un ancien contrôleur autonome sur un autre port, faites confirmer le parcours pour votre version : changer uniquement le port ne suffit pas à établir sa compatibilité.

Modifier ou supprimer une déclaration

• Cliquez sur le crayon Éditer de la ligne, modifiez les champs utiles, enregistrez, puis relisez la déclaration. Pour UniFi Access, la détection des portes est relancée à l’ouverture de l’édition.
• Un changement d’hôte ou de port peut effacer la sélection de porte : relancez la détection et vérifiez la cible. Une saisie manuelle pas encore enregistrée peut aussi être remplacée lorsque la détection réussit.
• Si vous quittez le formulaire avec des changements non enregistrés, tenez compte de la confirmation de départ.
• Dans la liste, la corbeille Supprimer ouvre une confirmation. Vérifiez d’abord les automatismes qui utilisent la déclaration : ne comptez pas sur une restauration automatique. Voir les listes et confirmations.

Vérifier le résultat

1. Rouvrez la déclaration avec Éditer et relisez l’hôte, le port et la porte (Access) ou l’hôte, le port et le site (Network).
2. Testez ensuite une fonction réelle : Succès ! confirme l’enregistrement, pas l’acceptation d’une commande par le contrôleur. Selon la famille, suivez les actions UniFi Access, les déclencheurs et associations KNX UniFi Access, les actions UniFi Network ou la présence et les associations KNX UniFi Network.

En cas de problème

La détection des portes UniFi Access affiche l’un des résultats suivants :

Message	Signification	Action
Contrôleur injoignable ou jeton invalide…	La détection a échoué, sans indiquer si l’hôte, le port, le jeton ou l’accès réseau est en cause	Vérifiez ces quatre éléments depuis l’installation, puis cliquez sur Réessayer. Au besoin, saisissez dans Identifiant de la porte (saisie manuelle) l’UUID confirmé dans la console Access, sans le deviner
Aucune porte sur ce contrôleur…	Le contrôleur a répondu avec une liste vide : ce résultat diffère d’un échec, il ne désigne pas un jeton faux	Vérifiez les portes dans la console UniFi Access, puis cliquez sur Actualiser. Ce résultat n’ouvre pas la saisie manuelle ; une nouvelle déclaration reste impossible à enregistrer sans porte
Introuvable sur le contrôleur, avec La porte enregistrée n’existe plus sur ce contrôleur — choisissez une porte détectée ou vérifiez la console Access.	L’ancienne porte reste affichée par son identifiant, mais elle peut ne plus exister ou ne plus être joignable	Vérifiez la console et sélectionnez la porte voulue avant d’enregistrer. Une indisponibilité passagère ne justifie pas de choisir une autre porte au hasard

Pour UniFi Network, si les actions ou retours restent indisponibles, vérifiez avec l’installateur l’hôte, le port, la clé du site et le compte local.

Si ces vérifications sont déjà faites, écrivez à support@can-nx.com en indiquant le contexte, le message affiché et les essais réalisés. Masquez le jeton, le mot de passe et les données privées dans toute capture, et ne joignez jamais les identifiants.