Somfy TaHoma dans Link’nX : déclarer la box et découvrir ses équipements

Déclarez une box Somfy TaHoma ou Connexoon dans Link’nX avec son adresse IP locale et son Jeton Mode Développeur, puis enregistrez la liste de ses équipements découverts : volets, stores, capteurs. Ces équipements deviennent alors sélectionnables dans les actions Somfy, les déclencheurs Somfy et la passerelle KNX Somfy.

Destiné aux administrateurs et installateurs autorisés à configurer la gateway.

Avant de commencer

• Notez l’adresse IP locale de la box sur le réseau de la passerelle KNX et son port. Faites-les confirmer par l’installateur si besoin.
• Générez le Jeton Mode Développeur de la box. L’aide (point d’interrogation) de ce champ indique comment activer le mode développeur et générer le jeton dans l’application TaHoma by Somfy. Ce mode n’existe pas sur les box TaHoma/Somfy de première génération (carrées) ni sur le Connectivity Kit. Un mot de passe de compte Somfy ne remplace pas ce jeton.
• Les modèles, versions et écrans fournisseur ne sont pas interchangeables : si la procédure n’est pas connue pour votre modèle et votre application, demandez-la au support.
• Le jeton est confidentiel : saisissez-le uniquement dans le formulaire prévu et masquez-le sur toute capture d’écran.

Déclarer la box

1. Vérifiez le projet et la gateway dans l’en-tête Link’nX. Dans Appareils, ouvrez Maison intelligente, puis Somfy, ou cherchez Somfy dans Rechercher un appareil…. Sur mobile, ouvrez d’abord la navigation.
2. Si un cadenas ou un message d’activation apparaît, vérifiez le contexte et l’option Somfy. Pour un accès manquant, contactez votre distributeur ou le support.
3. Cliquez sur Ajouter pour ouvrir Déclaration d’une box Somfy.
4. Renseignez Nom, obligatoire, 64 caractères au maximum. « Box séjour » est un exemple fictif.
5. Renseignez Adresse IP de la box, obligatoire, 128 caractères au maximum : l’adresse IP locale de la box. Saisissez l’adresse IP plutôt qu’un nom d’hôte : la passerelle ne résout pas les noms en .local.
6. PIN de la box est facultatif, 64 caractères au maximum, sous la forme XXXX-XXXX-XXXX. Son aide indique où le lire dans l’application TaHoma by Somfy.
7. Vérifiez Port, obligatoire et proposé à 8443. Renseignez Jeton Mode Développeur, obligatoire.
8. Cliquez sur la disquette ronde en bas à droite et attendez Succès !. La box apparaît dans la liste avec son adresse et son port.

Si la disquette est grisée, un champ obligatoire est vide : contrôlez Nom, Adresse IP de la box, Port et Jeton Mode Développeur.

Découvrir puis enregistrer les équipements

1. Sur la ligne de la box enregistrée, cliquez sur le crayon Éditer. La recherche démarre d’elle-même dans Équipements de la box. Lors d’une création non encore enregistrée, Découvrir les équipements est désactivé : enregistrez la box, puis rouvrez-la.
2. Examinez les colonnes Nom, Type, URL du sous-équipement et Dispo. Les volets, stores ou capteurs sont des équipements de cette box, distincts de la déclaration de la box elle-même.
3. Pour relancer la recherche, cliquez sur Actualiser et attendez son résultat.
4. Après une découverte réussie, cliquez sur la disquette pour enregistrer la liste. Attendez Mis à jour !. Une liste seulement affichée après la découverte n’est pas encore disponible pour les autres formulaires, et quitter la page ne déclenche pas de demande d’enregistrement pour elle.
5. Ouvrez ensuite une action, un déclencheur ou la passerelle KNX Somfy et sélectionnez la box : ses équipements enregistrés sont proposés dans Équipement.

Vérifier le résultat

Dans Équipements de la box, Disponible et Hors ligne décrivent le résultat de la dernière découverte, pas un état permanent de l’équipement. Pour confirmer la communication, testez une commande réelle sur un équipement. Un échec de découverte, à lui seul, ne permet pas de conclure à un défaut de l’équipement.

Modifier ou supprimer la déclaration

Ouvrez le crayon Éditer, corrigez les paramètres et enregistrez avec la disquette ; attendez Mis à jour !. Si une confirmation apparaît quand vous quittez le formulaire, relisez les changements non enregistrés.

Avant de supprimer la box, vérifiez ses actions, déclencheurs et associations KNX. Cliquez sur sa corbeille Supprimer et relisez le nom dans la confirmation du navigateur. Annulez pour conserver la box, ou confirmez puis vérifiez sa disparition après Supprimé !. Aucun bouton ne permet de restaurer la déclaration.

En cas de problème

Message affiché après la découverte	Cause	Action
La box n’a pas répondu.	Aucune réponse de la box	Vérifiez qu’il s’agit de la bonne box et qu’elle est en ligne. Relisez l’adresse IP, le port et le jeton dans la déclaration, puis cliquez sur Actualiser.
La box n’a renvoyé aucun équipement — liste enregistrée conservée.	La box a répondu sans équipement	La liste précédente est conservée. Vérifiez que la box est en ligne, puis actualisez.
La box a refusé le jeton, suivi d’un code	Jeton refusé par la box	Générez un nouveau jeton dans l’application TaHoma by Somfy, collez-le dans la déclaration, enregistrez, puis rouvrez la box.
La box est injoignable, suivi d’un code	Adresse, réseau ou mode développeur	Vérifiez l’adresse IP ou le PIN, que la box est sur le même réseau que la passerelle KNX et que le mode développeur est activé.
La découverte a échoué, suivi d’un code	Autre échec	La liste enregistrée est conservée. Cliquez sur Actualiser ; si le code persiste, notez-le pour le support.

Après un échec, le badge Liste enregistrée remplace l’état des équipements : la liste affichée est la dernière enregistrée et ne confirme pas la disponibilité actuelle des équipements. Conservez les associations existantes : les supprimer ne résout pas ce message.

Si vous connaissez l’URL exacte d’un sous-équipement, les formulaires d’action, de déclencheur et de passerelle proposent ✎ Saisie manuelle de l’URL…. Utilisez uniquement une URL confirmée d’un équipement de cette box ; l’adresse IP de la box ne la remplace pas. Cette saisie ne rétablit pas une connexion indisponible.

Un volet visible dans la déclaration mais absent des Actions n’a pas été enregistré avec la liste : enregistrez la déclaration après la découverte, puis rouvrez le formulaire d’action et sélectionnez la bonne box.

Contacter le support

Si le problème persiste, écrivez à support@can-nx.com en indiquant Link’nX, le projet et la gateway concernés, le modèle de box, le message exact avec son code et les essais réalisés. Une capture de la liste sans jeton ni données sensibles peut aider. Ne transmettez jamais le jeton.

Interface en anglais : Somfy box declaration, Box IP address, Box PIN, Developer-Mode token, Box devices, Refresh, Saved list, Device, Sub-device URL, ✎ Enter the URL manually….