--- title: Associer les relais, volets et lumières Shelly au KNX dans Link’nX description: "Associer les relais, volets et lumières Shelly au KNX dans Link’nX. Link’nX : ouvrir tableau passerelle Shelly et choisir le canal réel, renseigner DPT adresse Actif enregistrer…" canonical: https://wiki.can-nx.com/guides/link-shelly-knx/ language: fr product: Link’nX audience: - administrateur - installateur context: Link’nX projet et gateway autorisés ; Shelly selon option modèle génération et canal ; FR/EN et navigation mobile --- # Associer les relais, volets et lumières Shelly au KNX dans Link’nX Contexte : Link’nX projet et gateway autorisés ; Shelly selon option modèle génération et canal ; FR/EN et navigation mobile Pour l’installateur ou l’administrateur ayant les adresses KNX du projet et [un Shelly déclaré](https://wiki.can-nx.com/guides/link-shelly-device/). Identifiez le canal réel et le mode de l’appareil avant d’activer une ligne. Les relais proposés sont numérotés **0 à 3**, les volets **0 à 1** et les lumières **0 à 1** ; cette numérotation ne garantit pas leur présence sur chaque modèle. Pour les volets et variateurs Gen1, faites confirmer à support@can-nx.com les commandes et retours adaptés avant activation. Le réglage de position d’un volet suppose un appareil correctement préparé et étalonné ; les étapes d’étalonnage constructeur ne sont pas établies dans ce guide. ## Ouvrir et remplir la passerelle 1. Sélectionnez le projet et la gateway, puis ouvrez **Maison intelligente → Shelly**. 2. Sur la ligne de l’appareil, cliquez sur les deux flèches opposées **Configuration de la partie passerelle**. 3. Dans **Actions**, repérez la fonction et le numéro du canal. Le tableau présente **Nom**, **DPT**, **Adresse** et **Actif**. 4. Renseignez dans **Adresse** l’adresse de groupe KNX prévue pour la fonction, puis cochez **Actif**. Le nom et le DPT sont fixes. N’activez que les lignes correspondant à votre matériel. 5. Cliquez sur la disquette en bas à droite. Attendez **Succès — Données sauvegardées avec succès !**. 6. Pour les retours d’état, ouvrez le **deuxième onglet**, avec une bulle de message, et suivez [les mesures et états Shelly](https://wiki.can-nx.com/guides/link-shelly-feedback/). Enregistrez chaque onglet avant d’en changer. 7. Revenez à la liste, rouvrez la passerelle et vérifiez les adresses et les cases enregistrées. Le tableau commun est décrit dans [la saisie et la sauvegarde KNX](https://wiki.can-nx.com/guides/link-gateway-table/), notamment pour les filtres, le format des adresses et la désactivation d’une ligne. L’exemple fictif `1/3/20` ne doit être utilisé que s’il correspond à votre plan d’adresses. Une sauvegarde ne confirme pas un échange physique KNX ni l’effet d’une commande. ## Choisir la commande et sa valeur Dans les libellés ci-dessous, le numéro est celui du canal. Par exemple, **Relais 0 — marche/arrêt** et **Relais 1 — marche/arrêt** concernent deux canaux différents. | Lignes proposées | DPT | Valeur et effet demandé | | --- | --- | --- | | **Relais 0 à 3 — marche/arrêt** | 1.001 | 1 demande marche, 0 arrêt | | **Relais 0 à 3 — bascule** | 1.017 | Chaque télégramme demande d’inverser l’état, y compris un télégramme à 0 ; ce n’est pas un ordre « mettre en marche » | | **Volet 0 ou 1 — ouvrir/fermer** | 1.008 | 0 demande ouvrir/monter, 1 fermer/descendre | | **Volet 0 ou 1 — stop** | 1.017 | Chaque télégramme demande l’arrêt | | **Volet 0 ou 1 — régler la position** | 5.001 | Pourcentage KNX : **0 = ouvert**, **100 = fermé** ; 25 signifie une consigne de fermeture à 25 % | | **Lumière 0 ou 1 — marche/arrêt** | 1.001 | 1 demande marche, 0 arrêt | | **Lumière 0 ou 1 — régler la luminosité** | 5.001 | Pourcentage de 0 à 100 ; luminosité et commande marche/arrêt sont deux fonctions distinctes | La liste comporte les lignes individuelles de chaque canal, pas une ligne collective « Relais 0 à 3 ». Le choix du DPT doit correspondre à celui du participant KNX. **Mon bouton bascule deux fois.** Vérifiez s’il émet un télégramme à l’appui puis un autre au relâchement. Pour une bascule Shelly, ces deux télégrammes peuvent demander deux inversions. Faites régler l’émission du bouton par l’installateur, ou choisissez la fonction marche/arrêt si le besoin est de fixer explicitement l’état. N’utilisez pas un changement de DPT au hasard comme correction. **La luminosité est réglée mais la lampe reste éteinte.** Vérifiez aussi la fonction **marche/arrêt** du même canal. Un réglage de luminosité ne suffit pas à garantir l’allumage. Ne confondez pas le sens de luminosité avec celui de fermeture du volet. ## Utiliser Shelly depuis un scénario Il n’y a pas de type **Shelly** dédié dans **Actions → Ajouter**, ni de déclencheur d’événement Shelly dédié dans cette interface. Après avoir enregistré l’association KNX ci-dessus : 1. Ouvrez **Actions → Ajouter**, choisissez **KNX** et renseignez le **Nom** obligatoire de l’action, de 64 caractères maximum. 2. Renseignez **Adresse de groupe**, **DPT** et **Valeur** selon l’association Shelly et la commande voulue. Cliquez sur **AJOUTER AU GROUPE DE L'ACTION**, vérifiez la ligne sous **Added actions :**, puis enregistrez avec la disquette. Le [guide de l’action KNX](https://wiki.can-nx.com/guides/link-action-knx/) détaille ces champs. 3. Dans le [formulaire du scénario](https://wiki.can-nx.com/guides/link-compose-scenario/), renseignez son **Nom**, choisissez au moins un déclencheur et sélectionnez l’action KNX enregistrée. Cliquez sur **Ajouter l'action** et vérifiez sa carte avant d’[enregistrer le scénario](https://wiki.can-nx.com/guides/link-scenario-save/). Pour employer la valeur préparée, conservez la valeur par défaut de l’action. 4. Un scénario nouvellement créé est désactivé : [activez-le dans la liste](https://wiki.can-nx.com/guides/link-run/) lorsque sa configuration est prête pour un démarrage automatique. La déclaration du Shelly ne crée pas ces actions automatiquement. La sauvegarde du scénario ne confirme pas l’exécution physique de la commande. Pour une remontée native de bouton, un canal supplémentaire, une temporisation propre au relais ou une fonction absente, contactez support@can-nx.com avec le modèle et l’objectif. Ne remplacez pas le parcours par une URL ou une commande fournisseur inventée. En anglais : **Gateway mode configuration**, **Actions**, **Relay 0 — on/off**, **Relay 0 — toggle**, **Cover 0 — open/close**, **Cover 0 — stop**, **Cover 0 — set position**, **Light 0 — on/off**, **Light 0 — set brightness**. Les numéros restent ceux des canaux ; le message du tableau commun reste **Données sauvegardées avec succès !**.