WBE2-I-KNX
Interface KNX TP interne pour contrôleurs Wiren Board
Références de commande couvertes (1)
WBE2-I-KNX— Module d’interface KNX TP interne
WBE2-I-KNX est un module d’extension interne ajoutant une interface de bus KNX TP aux contrôleurs Wiren Board compatibles. Il est destiné à intégrer les appareils d’automatisation de bâtiment KNX aux services du contrôleur, à MQTT et aux logiciels d’automatisation.

Présentation du module

Le module s’installe à l’intérieur d’un contrôleur Wiren Board et fournit un port pour les appareils communiquant via KNX. Le bus KNX doit être alimenté pour que le module fonctionne.
Affectation des bornes
| Borne | Fonction |
|---|---|
| O1 (anciennement rouge) | KNX (+) |
| O2 | Not used |
| O3 (anciennement gris) | KNX (−) |
Garantie et durée de service
| Garantie | 2 ans |
|---|---|
| Durée de service | 8 ans |
Installation
Les modules commandés avec un contrôleur sont normalement installés en usine et doivent seulement être activés dans l’interface web du contrôleur. Installez les modules achetés séparément comme suit :
- Arrêtez le contrôleur et déconnectez toutes les sources d’alimentation.
- Ouvrez le boîtier du contrôleur.
- Insérez le module dans un emplacement interne compatible. Respectez le sens : l’ergot du module doit entrer dans la découpe correspondante du circuit imprimé du contrôleur.
- Remontez le boîtier, raccordez le bus KNX et mettez le contrôleur sous tension.


Compatibilité des contrôleurs
| Contrôleur | Emplacements compatibles | Emplacements incompatibles |
|---|---|---|
| Wiren Board 6.3–6.6 | MOD1, MOD2 | MOD3 |
| Wiren Board 6.7 / 7 | MOD1, MOD2, MOD3 | MOD4 |
| Wiren Board 8.4 | MOD1, MOD2, MOD4 | MOD3 |
| Wiren Board 8.5 | MOD1, MOD2, MOD3, MOD4 | Aucune |

Lors de l’installation du module dans MOD3 sur Wiren Board 6.7–8.4 ou dans MOD4 sur Wiren Board 8.5, retirez l’ergot plastique gênant du boîtier à l’aide d’une pince coupante ou d’une lime. Ne retirez que l’ergot indiqué et gardez les débris à l’écart de l’électronique.
Configuration du contrôleur
Accès Admin

Les autorisations de configuration sont affectées aux comptes utilisateurs authentifiés par identifiant et mot de passe. Pour modifier les paramètres du contrôleur, connectez-vous avec un compte ayant le niveau d’accès Admin . Gérez les comptes sous Settings → Users. Sur les versions du contrôleur antérieures à wb-2602, réglez le niveau d’accès sous Settings → Access level.
Activer le module

- Open Settings → Configs → Expansion modules and ports dans l’interface web du contrôleur.
- Sélectionnez l’emplacement interne contenant WBE2-I-KNX.
- Choisissez le type du module installé dans la liste Module type .
- Sélectionnez l’option d’appareil KNX requise par la configuration et cliquez sur Save. Le contrôleur active les ports nécessaires au module.
Pour retirer le module de la configuration logicielle, sélectionnez Not installed pour l’emplacement et enregistrez la modification.
Nœuds de périphériques
La configuration crée des liens symboliques dans /dev: ttyKNX1 pour Internal slot 1 et ttyKNX2 pour Internal slot 2. Lorsque la configuration ne contient qu’un seul appareil KNX, le lien supplémentaire ttyKNX est créé quel que soit celui des deux emplacements contenant le module.
Fonctionnement
Logiciels préinstallés
Le service d’intégration recommandé est wb-mqtt-knx. Il traduit les télégrammes KNX en topics MQTT et les commandes MQTT en télégrammes KNX. La communication avec le bus KNX physique est gérée par le routeur knxd .
Utilisez KnxTool pour les diagnostics, la surveillance des télégrammes et la vérification de la communication. Vérifiez que l’alimentation KNX, la polarité, la topologie du bus et la terminaison sont conformes à la conception de l’installation KNX avant de diagnostiquer le logiciel.
Logiciels alternatifs
iRidium Server peut aussi être installé sur un contrôleur Wiren Board. Il peut communiquer avec le bus KNX directement via le module série ou via knxd. Utilisez des versions logicielles compatibles avec l’architecture du contrôleur et la version Debian actuelle.
Chemin typique des données
- Un appareil KNX transmet un télégramme sur le bus KNX TP alimenté.
- WBE2-I-KNX le transfère à l’interface série du contrôleur.
knxdfournit les services de routage de bus et de tunnel.wb-mqtt-knxpublie le télégramme sur MQTT ou convertit une commande MQTT en télégramme KNX.
Dépannage
- Aucun nœud de périphérique : vérifiez l’emplacement physique, le type de module et la configuration enregistrée du module d’extension.
- Aucun trafic KNX : vérifiez l’alimentation du bus KNX et la polarité O1/O3, puis examinez l’état du service
knxdet lewb-mqtt-knx. - Communication intermittente : comparez le lot et la révision du module à l’historique ci-dessous. Les premières versions matérielles présentent des problèmes de communication documentés.
- ETS ne détecte pas l’interface : vérifiez que le tunnel KNX et la découverte sont activés dans
knxd, et que le réseau du poste de travail autorise la découverte multicast.
Révisions matérielles
Le numéro de lot figure sur l’étiquette latérale du boîtier ou directement sur le circuit imprimé du module.
| Révision | Lots | Période de production | Variation |
|---|---|---|---|
| 2.6 | v2.6A, v2.6B, v2.6C | Février 2025–aujourd’hui | L’isolation galvanique par isolateur numérique remplace les optocoupleurs. |
| 2.5 | v2.5B/1, v2.5C, v2.5D, v2.5E | Juillet 2024–février 2025 | Résolution d’un possible problème de communication entre module et contrôleur (ERRKNX220002). |
| 2.5 | v2.5B | Janvier–juillet 2024 | Émetteur-récepteur NCN5121. |
| 2.5 | v2.5A | Octobre 2023 | Découpe du circuit imprimé agrandie pour la compatibilité avec Wiren Board 7.4. |
| 2.4 | v2.4E, v2.4F | Mai–octobre 2023 | Émetteur-récepteur NCN5120. |
| 2.4 | v2.4A–v2.4D | Janvier 2022–mai 2023 | Géométrie du circuit imprimé modifiée pour la compatibilité avec Wiren Board 7. |
| 2.3 | v2.3A–v2.3E | Avril 2020–janvier 2022 | Émetteur-récepteur NCN5121 ; ERRKNX220001 corrigé. |
| 2.2 | v2.2A | Septembre 2019–avril 2020 | Géométrie du circuit imprimé modifiée et ergot de fixation agrandi. |
| 2.1 | Fin 2017–août 2019 | Fin 2017–août 2019 | Première version de production. |