Technical

NodOcean for HA : les produits EnOcean NodOn dans Home Assistant, sans prise de tête

NodOcean for HA - Intégration EnOcean NodOn dans Home Assistant

Dans les articles précédents, on a beaucoup parlé de Zigbee, de MQTT et de pilotage énergétique. Mais chez beaucoup d'utilisateurs, et chez moi le premier, une autre technologie radio fait partie du paysage depuis des années : EnOcean.

Interrupteurs sans pile, modules encastrés, prises, capteurs… NodOn propose une gamme EnOcean complète. Le hic, c'est que leur intégration dans Home Assistant n'a jamais été vraiment simple. C'est pour régler ce problème que j'ai développé NodOcean for HA, une intégration Home Assistant disponible via HACS.

Vue d'ensemble de l'intégration NodOcean for HA dans Home Assistant

EnOcean, en deux mots

EnOcean est une technologie radio pensée pour la maison et le bâtiment, avec une particularité : de nombreux produits fonctionnent sans fil sans pile. Un interrupteur EnOcean récupère l'énergie de l'appui lui-même pour envoyer son message radio. Certains capteurs fonctionnent même avec la seule énergie de la lumière.

Résultat : des commandes que l'on peut coller n'importe où, sans entretien, et des modules qui continuent de fonctionner en direct avec leurs interrupteurs, même sans contrôleur domotique.

Le problème : une intégration native très technique

Home Assistant dispose bien d'une intégration EnOcean native. Mais pour y ajouter un produit, il faut généralement :

  • connaître le profil EEP du produit (par exemple D2-01-0F ou A5-04-01) ;
  • relever son identifiant EnOcean ;
  • écrire quelques lignes de YAML ;
  • et, pour les modules et les prises, gérer soi-même l'appairage bidirectionnel.

Pour un passionné, c'est faisable. Pour un utilisateur qui veut simplement piloter son volet roulant ou son radiateur, c'est souvent là que l'aventure s'arrête.

La solution : choisir son produit dans une liste

Le principe de NodOcean for HA tient en une phrase : on choisit son produit NodOn dans une liste, et Home Assistant fait le reste.

Pas de profil EEP à chercher, pas d'identifiant à recopier, pas de fichier YAML, pas de broker MQTT ni d'add-on. L'intégration dialogue directement avec une clé USB EnOcean branchée sur le serveur Home Assistant.

Concrètement, l'ajout d'un produit se fait en quelques étapes :

  1. Dans l'intégration, on clique sur Ajouter un produit NodOn ;
  2. On choisit le produit dans la liste ;
  3. On suit la consigne affichée, par exemple « appuyez 3 fois rapidement sur le bouton du module » ;
  4. Home Assistant écoute pendant 60 secondes, détecte le produit et, pour les modules et les prises, répond lui-même à la demande d'appairage ;
  5. On donne un nom au produit, on choisit sa pièce : c'est terminé.

Écran du wizard d'ajout de produit NodOn dans Home Assistant

16 produits NodOn pris en charge

L'intégration couvre l'ensemble de la gamme EnOcean NodOn actuelle :

Famille Produits Dans Home Assistant
🔌 Modules encastrés SIN-2-1-01 Multifonction, SIN-2-2-01 Éclairage 2 canaux, SIN-2-FP-01 Fil pilote, SIN-2-RS-01 Volet roulant Interrupteur, lumières, mode fil pilote (6 ordres) + mesure, volet avec position
🔋 Prises ASP-2 Prise intelligente, MSP-2 Micro Smart Plug + mesure Prise, puissance et énergie
🎛️ Commandes CWS-2-1 Interrupteur mural, CRC-2 Soft Remote, CFS-2 Interrupteur de sol, CCS-2 Interrupteur à carte, TSB-2 Soft Button Événements par touche, simple / double / appui long, carte insérée
🌡️ Capteurs SDO-2 et SWO-2 Ouverture, PIR-2 Mouvement, STP-2 Température, STPH-2 Température + humidité Ouverture, mouvement + luminosité, température, humidité

Vue des appareils NodOcean dans l'interface Home Assistant

Les réglages des produits, directement dans Home Assistant

C'est sans doute la partie qui apporte un vrai plus. Les produits EnOcean NodOn proposent de nombreux paramètres qui, jusqu'ici, restaient difficiles d'accès. Avec NodOcean for HA, ils apparaissent dans la carte Configuration de la fiche de chaque produit :

  • LED de statut allumée ou éteinte (mode jour / nuit) ;
  • État après coupure de courant : précédent, allumé ou éteint ;
  • Extinction automatique après un délai, par exemple pour l'éclairage d'un garage ;
  • Type d'interrupteur filaire raccordé à un module : interrupteur, poussoir… ;
  • Calibration et temps de course du module volet roulant ;
  • Mode répéteur pour étendre la portée radio ;
  • Correction de température et d'humidité des capteurs ;
  • Gestion des télécommandes appairées en direct à un module.

Bon à savoir : les produits EnOcean ne permettent pas de relire leurs réglages. Home Assistant affiche donc la dernière valeur envoyée, et les valeurs par défaut sont celles d'un produit neuf.

Et pour les interrupteurs et télécommandes, l'intégration propose des déclencheurs d'appareil directement dans l'éditeur d'automatisations : « Haut gauche appuyé », « Double appui »… Plus besoin de décoder des trames.

Carte Configuration d'un produit NodOn dans Home Assistant

Un bouton « Aide NodOn » intégré

Sur la fiche de chaque produit, la carte Diagnostic propose un bouton Aide NodOn. Un appui, et une notification apparaît avec la notice du produit, le lien vers le support NodOn et l'identifiant EnOcean du produit.

C'est un petit détail, mais il répond à une vraie question du quotidien : « comment je remets ce module en mode appairage, déjà ? ».

Notification Aide NodOn avec notice et lien support

Et pour ceux qui veulent aller plus loin : le pont MQTT

Vous me voyez venir après l'article sur MQTT… NodOcean for HA peut aussi publier l'état des produits sur un broker MQTT et recevoir des commandes, à la manière de Zigbee2MQTT.

  • États : nodocean/<produit> → {"state": "ON", "power": 12.5, "energy": 3.2}
  • Commandes : nodocean/<produit>/set → {"state": "ON"}, {"position": 50} ou {"mode": "eco"}
  • Boutons : nodocean/<produit>/action → left_up, single…

Les produits EnOcean deviennent ainsi accessibles à Node-RED, Jeedom, une GTB ou un autre Home Assistant. Le pont est facultatif et désactivé par défaut : pour un usage classique, vous n'en avez pas besoin.

Pont MQTT NodOcean for HA

Ce qu'il faut pour démarrer

  • Home Assistant 2025.3 ou plus récent (OS, Container, Core…) ;
  • une clé USB EnOcean USB300, ou une clé compatible ESP3 (TCM310, USB500…) ;
  • HACS, pour l'installation et les mises à jour en un clic.

L'interface est disponible en français, en anglais et en allemand, selon la langue de Home Assistant.

⚠️ Attention : une clé EnOcean ne peut servir qu'à une seule intégration à la fois. Si l'intégration EnOcean native de Home Assistant l'utilise déjà, il faut la supprimer avant d'installer NodOcean for HA.

Installation via HACS

NodOcean for HA n'est pas encore dans le catalogue par défaut de HACS. Il suffit de l'ajouter une fois en dépôt personnalisé : les mises à jour arrivent ensuite normalement.

  1. Dans HACS, ouvrez le menu ⋮ (en haut à droite) → Dépôts personnalisés ;
  2. Ajoutez l'adresse https://github.com/eHomeLabs/NodOcean-for-HA, catégorie Intégration, puis Ajouter ;
  3. Recherchez NodOcean for HA dans HACS, cliquez sur Télécharger, puis redémarrez Home Assistant ;
  4. Paramètres → Appareils et services → Ajouter une intégration → NodOcean for HA. Une clé USB300 branchée est normalement détectée automatiquement.

Vos produits sont déjà appairés à une autre box ? Les capteurs et interrupteurs peuvent être appairés à plusieurs récepteurs : il suffit de les ajouter. Pour un module ou une prise, faites l'appairage depuis Home Assistant et, en cas d'échec, une réinitialisation usine du produit avant de recommencer.

Un projet eHome Labs, ouvert et en bêta

NodOcean for HA est un projet personnel eHome Labs. Il n'est pas développé par NodOn, et il est distribué en open source (licence MIT) et actuellement en phase de bêta : chaque retour compte.

Pour savoir à qui s'adresser :

  • Une question sur l'intégration (installation, appairage dans Home Assistant, bug, suggestion) : ouvrez une issue sur le dépôt GitHub, en joignant le fichier de diagnostics téléchargeable depuis Home Assistant ;
  • Une question sur un produit NodOn (notice, câblage, réinitialisation, garantie) : le support NodOn reste votre interlocuteur, sur support.nodon.fr.

La documentation complète (installation, appairage produit par produit, réglages, automatisations, FAQ) est disponible sur le wiki NodOcean for HA, sur GitHub.

À retenir

  • ✔ NodOcean for HA intègre les 16 produits EnOcean NodOn actuels dans Home Assistant
  • ✔ On choisit son produit dans une liste : pas de profil EEP, pas d'identifiant, pas de YAML
  • ✔ Les réglages des produits (LED, état après coupure, temporisations, volet…) sont accessibles depuis Home Assistant
  • ✔ Interrupteurs et télécommandes proposent des déclencheurs prêts à l'emploi dans les automatisations
  • ✔ Il suffit d'une clé USB EnOcean, sans broker MQTT ni add-on
  • ✔ Un pont MQTT facultatif ouvre les produits EnOcean à d'autres systèmes
  • ✔ Installation via HACS, en dépôt personnalisé

Liens utiles

Produits cités

À propos de l'auteur – eHome Labs

Passionné de domotique depuis plus de 20 ans, Pascal Stephany fait évoluer son installation au rythme de ses expérimentations. Chaque automatisation est testée en conditions réelles avant d'être adoptée au quotidien, faisant de sa maison un véritable laboratoire grandeur nature.

Pascal STEPHANY – Chef Produit NodOn

En lire plus

Module multifonction NodOn SIN-4-1-21 installé près d'un chauffe-eau électrique

Laisser un commentaire

Ce site est protégé par hCaptcha, et la Politique de confidentialité et les Conditions de service de hCaptcha s’appliquent.