Fil Pilote + Home Assistant : Intégration HACS pour le DOMO-30

Le fil pilote : principe et signaux électriques

Le fil pilote est une norme française (NF C 15-100) permettant de piloter un radiateur électrique à distance via un signal superposé au réseau 230V AC. Un troisième fil — le "fil pilote" — relie le tableau électrique au radiateur et transporte des ordres de commande codés en signaux alternatifs.

Le principe est simple : en appliquant ou non certaines alternances du secteur 230V sur ce fil, le récepteur intégré dans le radiateur bascule entre différents modes de fonctionnement. Aucun bus de communication propriétaire, aucun protocole complexe — uniquement de l'électronique de puissance basique.

Les 4 modes en détail — mesures oscilloscope

Le standard 4 ordres utilise quatre combinaisons de signaux. Voici les mesures réalisées directement sur les sorties du DOMO-30.

🟢 Mode Confort — LED verte

Signal : aucun signal sur le fil pilote.
Effet : le radiateur fonctionne à sa température de consigne normale.
Usage : présence dans la pièce, confort maximal.

🔵 Mode Réduit — LED bleue

Signal : alternance positive et négative 230V superposées.
Effet : température réduite de -3,5°C par rapport au mode Confort.
Usage : absence courte, nuit légère.

⚪ Mode Hors-Gel — LED blanche

Signal : alternance négative 230V uniquement.
Effet : maintien à 7-8°C, protection contre le gel.
Usage : absence prolongée, vacances.

🔴 Mode Arrêt — LED rouge

Signal : alternance positive 230V uniquement.
Effet : arrêt complet du chauffage.
Usage : locaux inoccupés longue durée.

Le circuit fil pilote du DOMO-30

Le DOMO-30 intègre 6 zones fil pilote indépendantes. Chaque zone repose sur deux composants clés :

• 74HC139 — décodeur logique 2→4 : génère les combinaisons de signaux pour les 4 ordres à partir de 2 sorties GPIO de l'ESP32.
• MOC3083M — optotriac : assure l'isolation galvanique complète entre le circuit de commande 3,3V et le réseau 230V AC. Indispensable pour la sécurité.

Le schéma complet est disponible dans la documentation technique DOMO-30 (PDF). Côté firmware, chaque zone est exposée comme une entité select ESPHome avec les options "Confort", "Réduit", "Hors Gel", "Arrêt" — directement disponibles dans Home Assistant via l'API native ESPHome, sans MQTT.

L'intégration HACS : installation et configuration

L'intégration Fil Pilote est disponible sur HACS. Elle transforme les entités select du DOMO-30 en entités climate natives HA — aucune modification du firmware ESPHome n'est nécessaire.

Étape 1 — Ajouter le dépôt dans HACS

Étape 2 — Configurer l'intégration

Après le redémarrage : Paramètres → Appareils et services → + Ajouter une intégration → Fil Pilote.

L'assistant vous demande en deux étapes :

1. Nom du contrôleur (ex. DOMO-30 Salon) et nombre de zones
2. Pour chaque zone : un nom (ex. Cuisine) et l'entité select correspondante (select.domo30_fil_pilote_0, etc.) — via une liste déroulante de vos entités HA

Résultat dans Home Assistant

Une fois configuré, chaque zone devient une entité climate à part entière dans HA :

• Mode HVAC : Chauffage ou Arrêt
• Presets : Confort / Réduit (Eco) / Hors-gel (Away)
• Température actuelle : affichée si un capteur DS18B20 est connecté à la zone
• Synchronisation temps réel : tout changement côté DOMO-30 (bouton physique, autre client HA) est répercuté instantanément

Les entités climate sont compatibles avec le planificateur HA, les automatisations, Google Home, Amazon Alexa et Apple HomeKit (via HA).

Carte Lovelace avec code couleur

Voici une carte de tableau de bord utilisant custom:button-card (disponible sur HACS) pour contrôler les 6 zones avec un cycle au tap et un code couleur identique aux LEDs du DOMO-30 :

type: vertical-stack
cards:
  - type: markdown
    content: "## Commandes Fils Pilotes"
  - type: horizontal-stack
    cards:
      - type: custom:button-card
        entity: select.domo30_fil_pilote_0
        name: Cuisine
        icon: mdi:radiator
        show_state: true
        tap_action:
          action: call-service
          service: select.select_next
          service_data:
            entity_id: select.domo30_fil_pilote_0
        state:
          - value: Confort
            color: green
            icon: mdi:radiator
          - value: Arrêt
            color: red
            icon: mdi:radiator-off
          - value: Hors Gel
            color: white
            icon: mdi:snowflake
          - value: Réduit
            color: blue
            icon: mdi:radiator-disabled
        styles:
          card:
            - height: 90px
      # Répéter pour chaque zone (fil_pilote_1 ... fil_pilote_5)

Un tap sur une zone fait cycler entre les modes. Le code couleur correspond exactement aux LEDs physiques du DOMO-30 : vert = Confort, bleu = Réduit, blanc = Hors-gel, rouge = Arrêt.

Exemples d'automatisations

Passage automatique en mode Réduit la nuit

automation:
  - alias: "Chauffage — Mode nuit"
    trigger:
      - platform: time
        at: "22:30:00"
    action:
      - service: climate.set_preset_mode
        target:
          entity_id:
            - climate.cuisine
            - climate.sejour
        data:
          preset_mode: eco

Hors-gel automatique quand tout le monde part

automation:
  - alias: "Chauffage — Absence détectée"
    trigger:
      - platform: state
        entity_id: group.famille
        to: "not_home"
    action:
      - service: climate.set_preset_mode
        target:
          entity_id: climate.all
        data:
          preset_mode: away