Mes trois objectifs domotisation portail

J’ai fixé trois objectifs précis pour domotiser mon portail battant Came équipé d’une carte de commande ZL180.

• Un seul bouton sur le dashboard Home Assistant actionne le portail via une séquence impulsionnelle précise : contact sec ON pendant 500 ms, pause 500 ms minimum, puis OFF.
• Retour d’état réel affichant si le portail est ouvert ou fermé à tout moment, grâce à un capteur de position.
• Commande vocale simple avec Alexa : « Alexa, ouvre le portail » ou « Alexa, ferme le portail ».

Ce tutoriel remplace l’ancien utilisant le module QS-Zigbee-S10-C03 qui causait des déconnexions fréquentes du réseau Zigbee. Article obsolète : Domotisation QS-Zigbee-S10-C03.

Ma carte de commande Came ZL180

Mon portail battant fonctionne avec la carte électronique Came ZL180 qui gère tous les mouvements, les sécurités et les fins de course.

Notice technique officielle complète : Télécharger PDF ZL180.

Borniers commande carte ZL180

Toutes les connexions domotiques se branchent sur les borniers en bas à droite de la carte ZL180. Ces 10 bornes permettent la commande du portail et la lecture des états.

Commande ouverture/fermeture portail

La carte ZL180 commande l’ouverture/fermeture par un contact sec (sans tension) entre les bornes 2 (COM) et 7 (IMP). Un contact sec signifie simplement fermer le circuit électrique sans appliquer de tension.

• Fermer le contact bornes 2-7 pendant exactement 500 millisecondes (0,5 seconde).
• Maintenir une pause d’au moins 500 ms avant nouvelle commande.
• Ouvrir le contact (OFF) pour terminer l’impulsion.

Cette séquence impulsionnelle est obligatoire et décrite page 8 de la notice ZL180.

Retour d’état ouvert/fermé portail

La carte ZL180 ne fournit pas de contact sec direct pour l’état du portail. Elle délivre un signal 24V entre les bornes 5 (COM) et 10 (OUV) quand le portail est totalement ouvert.

Pour convertir ce signal 0/24V en contact sec compatible domotique, j’installe un relais 24V IEC255 dans le boîtier Came. Le relais isole électriquement les circuits et crée un contact sec simple ouvert/fermé.

Voici mon relais IEC255 monté sur support DIN dans le boîtier Came :

Configuration DIP switches cruciale

Problème fréquent : certaines impulsions ne sont pas prises en compte. La cause est souvent la fonction « Stop » activée sur le DIP switch 2 de la carte ZL180. Cette fonction arrête le portail à chaque impulsion reçue.

Solution : positionner impérativement le DIP2 sur OFF pour permettre les commandes partielles (ouverture/fermeture normale).

Mon choix module Zigbee MOES

J’ai testé plusieurs modules mais choisi le MOES ZM-102-M pour sa stabilité Zigbee, son prix abordable et ses fonctions complètes pour portail.

• IOMZB-110 FRIENT : Excellent mais 60€.
• Smart Switch ZG-005-RF : 4 sorties à 18€ mais pas d’entrée.
• NODON SIN-4-1-20 : Pas d’entrée contact sec.
• MOES ZM-102-M choisi à 17,90€.
• QS-Zigbee-S10-C03 : Déconnexions fréquentes, abandonné.

Le MOES ZM-102-M-MS inclut alimentation 230V, sortie impulsionnelle, entrée contact sec et capteur magnétique. Version ZM-102-M = module seul sans capteur.

Où acheter cet équipement ?

Voici le lien vers la page dédiée au ZM-102-M. J’y ai référencé les vendeurs et les prix.

Brochage précis MOES ZM-102-M

• L et N : Alimentation 230V phase + neutre.
• S4-S5 : Entrée contact sec (connecté au relais IEC255 pour état portail).
• S1-S2 : Sortie impulsionnelle vers bornes 2-7 carte ZL180.

Schéma câblage complet portail

J’appaire le module Zigbee2MQTT

Mise sous tension = mode appairage automatique (LED bleue clignote 10 min). Bouton appairage derrière le module. Placer temporairement près du coordinateur Zigbee si distance importante.

Dans Zigbee2MQTT en mode « Permit Join », le module apparaît comme _TZE200_fabuwqzo_ts0601. Je le renomme « Portail Came ».

Fonctionnalités exposées MOES

Le module expose ces propriétés essentielles :

• trigger (binary) : Envoie impulsion S1-S2. true=ouvrir, false=fermer. Intelligence : n’envoie pas si état déjà correct.
• garage_door_contact (binary) : État S4-S5. true=fermé, false=ouvert.
• countdown (0-43200s) : Impulsion forcée après délai.
• run_time (-1 à 120s) : Timeout mouvement. Alarme si dépassé.
• status : Normal / RunTimeAlarm / OpenTimeAlarm.

Intégration automatique Home Assistant

Les entités apparaissent automatiquement dans Home Assistant après redémarrage ou actualisation Zigbee2MQTT.

• binary_sensor.portail_came_garage_door_contact : État réel (off=fermé, on=ouvert).
• switch.portail_came_trigger : Bouton impulsion (ON 500ms puis auto-OFF).
• sensor.portail_came_status : Statut module.

Ma configuration Cover Portail

Je crée une entité Cover unifiée combinant l’état réel (binary_sensor) et la commande (switch). Un Cover Home Assistant représente tout élément ouvrable : portail, porte, volet roulant.

Ajouter dans configuration.yaml sous template → cover :

- cover:
  - name: Portail
    unique_id: cover.portail
    device_class: gate
    icon: >
      {% if is_state('binary_sensor.portail_came_garage_door_contact', 'off') %}
        mdi:gate
      {% else %}
        mdi:gate-open
      {% endif %}
    state: >
      {% if is_state('binary_sensor.portail_came_garage_door_contact', 'off') %}
        closed
      {% else %}
        open
      {% endif %}
    open_cover:
      - service: script.actionne_le_portail_toogle
    close_cover:
      - service: script.actionne_le_portail_toogle

Mes boutons dashboard portail

Version simple button-card

type: custom:button-card
show_name: false
tap_action:
  action: toggle
  entity: cover.portail
state:
  - value: closed
    color: gray
  - value: open
    color: red

Version avancée picture-elements

- type: custom:button-card
  color_type: card
  entity: cover.portail
  show_name: false
  tap_action:
    action: toggle
  state:
    - value: open
      color: "#4f010a"
      icon: mdi:gate-open
      styles:
        card:
        - animation: blink 2s ease infinite
    - operator: default
      color: "#49556c"
      icon: mdi:gate
      styles:
        card:
        - height: 110px
        - width: 110px
  style:
    top: 93%
    left: 5%

Alexa commande vocale portail

Exposer l’entité cover.portail vers Alexa pour contrôle vocal.

1. Paramètres → Assistants vocaux → « x entité(s) à exposer ».
2. Sélectionner cover.portail.
3. Commandes : « Alexa, ouvre le portail », « Alexa, ferme le portail ».

Bonus impulsion visuelle

Confirmation visuelle immédiate de l’envoi d’impulsion par icône clignotante. Créer input_boolean.impulsion_portail via Paramètres → Appareils & Services → Helpers → Interrupteur.

type: custom:button-card
entity: input_boolean.impulsion_portail
name: Impulsion Portail
show_state: false
show_name: false
icon: mdi:access-point
styles:
  icon:
    - color: |
        [[[
          if (entity.state === 'on') return '#39FF14';
          return 'transparent';
        ]]]
    - animation: |
        [[[
          if (entity.state === 'on') return 'blink 0.4s linear infinite';
          return 'none';
        ]]]
  card:
    - width: 150px
    - height: 150px
    - border-radius: 12px
    - background-color: transparent
    - box-shadow: none

Script actionne_le_portail_toogle (à créer dans scripts.yaml) :

sequence:
  - service: switch.turn_on
    target:
      entity_id: switch.portail_came_trigger
  - service: input_boolean.turn_on
    target:
      entity_id: input_boolean.impulsion_portail
  - delay:
      seconds: 1
  - service: input_boolean.turn_off
    target:
      entity_id: input_boolean.impulsion_portail
alias: Actionne le portail

Bonus Rustine ouverture

J’ai constaté, pour une raison qui m’échappe encore, qu’environ une fois sur vingt, la commande d’ouverture du portail se déclenche correctement : l’impulsion est bien envoyée au module, aucune erreur n’apparaît… mais rien ne se passe.

Tout laisse penser que le module est en veille au moment de la commande et qu’il ne réagit tout simplement pas.

En revanche, si je renvoie une seconde impulsion dans les secondes qui suivent, le portail s’ouvre immédiatement.

Habituellement, je suis plutôt allergique aux “rustines”. J’aime comprendre et corriger le problème à la source. Mais dans ce cas précis, la solution la plus pragmatique m’a semblé être d’ajouter un mécanisme de rattrapage.

L’idée est simple :
si, après une commande d’ouverture, le portail est toujours détecté comme fermé au bout de quelques secondes, alors le script renvoie automatiquement une seconde impulsion.

Au pire, on perd 2 secondes.
Au mieux, on corrige un aléa invisible pour l’utilisateur.

J’ai donc mis en place le script suivant :

sequence:
  - alias: Enregistre l'état du portail avant impulsion
    variables:
      etat_portail_avant: "{{ states('binary_sensor.portail_came_garage_door_contact') }}"
  - alias: Envoie l'impulsion au portail
    action: switch.toggle
    target:
      entity_id: switch.portail_came_trigger
    data: {}
  - parallel:
      - alias: Fait clignoter l'envoi d'impulsion sur Dashboard
        sequence:
          - action: input_boolean.turn_on
            target:
              entity_id: input_boolean.impulsion_portail
            data: {}
          - delay:
              seconds: 1
          - action: input_boolean.turn_off
            target:
              entity_id: input_boolean.impulsion_portail
            data: {}
      - alias: Rustine uniquement si le portail était fermé
        sequence:
          - if:
              - condition: template
                value_template: "{{ etat_portail_avant == 'off' }}"
            then:
              - alias: Attend maximum 2s que le portail passe à ouvert
                wait_template: >-
                  {{ is_state('binary_sensor.portail_came_garage_door_contact',
                  'on') }}
                timeout:
                  seconds: 2
                continue_on_timeout: true
              - if:
                  - condition: template
                    value_template: "{{ not wait.completed }}"
                then:
                  - alias: Relance l'impulsion si le portail n'a pas réagi
                    action: switch.toggle
                    target:
                      entity_id: switch.portail_came_trigger
                    data: {}
alias: Actionne le portail
description: ""

Ce script met en place un mécanisme simple de vérification après l’envoi d’une impulsion au portail, avec une logique de rattrapage en cas de problème.

La première étape consiste à mémoriser l’état du portail avant toute action. On enregistre s’il est ouvert ou fermé au moment où la commande est envoyée (binary_sensor.portail_came_garage_door_contact). Cette information est importante, car elle permet de savoir ensuite si l’on doit activer ou non la logique de secours.

Une fois cet état sauvegardé, le script envoie l’impulsion au portail via le module (switch.portail_came_trigger), exactement comme dans le fonctionnement normal. En parallèle, un petit indicateur visuel est activé pendant une seconde (input_boolean.impulsion_portail), simplement pour matérialiser l’envoi de l’impulsion sur le tableau de bord.

C’est ensuite que la “rustine” entre en jeu, mais uniquement dans un cas bien précis : si le portail était fermé au moment de la commande. Cette précaution évite des effets indésirables, notamment si le portail est en train de se fermer, car dans ce cas il peut mettre plusieurs secondes à réagir et il ne faut surtout pas renvoyer une impulsion.

Si le portail était bien fermé, le script attend alors jusqu’à deux secondes pour voir s’il passe à l’état “ouvert” (binary_sensor.portail_came_garage_door_contact). Cette attente est active : si le changement se produit rapidement, le script le détecte immédiatement et s’arrête là.

En revanche, si rien ne se passe pendant ces deux secondes, on considère que l’impulsion initiale n’a pas été prise en compte, probablement à cause d’un module encore en veille. Le script envoie alors automatiquement une seconde impulsion via le module (switch.portail_came_trigger).

Au final, ce mécanisme agit comme un filet de sécurité. Dans la majorité des cas, il ne sert à rien et reste invisible. Mais dans les rares situations où le portail ne réagit pas, il permet de corriger le problème sans intervention manuelle, avec un simple délai de deux secondes.

Documentation technique complète

• Manuel MOES ZM-102-M PDF
• Liste compatibilités portails MOES

Forum échanges retours expérience

Questions, retours d’expérience, schémas complémentaires : Discussion forum HACF.

Domotiser portail Came ZL180 en 5 étapes

Je domotise mon portail battant Came avec carte ZL180 grâce à un module Zigbee QS-Zigbee-S10-C03. Ce tutoriel explique le câblage, la configuration Zigbee2MQTT, Home Assistant et Alexa pour un contrôle vocal complet. Un bouton dashboard et retour d’état réel rendent l’usage simple et fiable pour tous.

Mes objectifs précis

• Je crée un bouton dashboard qui envoie l’ordre On + pause 500ms + Off pour actionner le portail.
• Je récupère le retour d’état réel ouvert/fermé via un contact sec.
• J’intègre avec Alexa pour commander « Alexa, ouvre le portail » vocalement.

Contexte de mon installation

Mon portail battant Came utilise une carte de commande ZL180. Cette carte gère les moteurs, les fins de course et les sécurités. La notice technique complète est disponible ici pour référence :

Notice technique carte ZL180 Came

Présentation des borniers ZL180

Toutes les connexions domotiques se font sur les borniers en bas à droite de la carte ZL180. Ces bornes permettent de raccorder des contacts secs ou des potentiels pour commander et superviser le portail.

Je commande l’ouverture/fermeture

Pour ouvrir ou fermer le portail, j’utilise un contact sec entre les bornes 2 et 7. La séquence exacte est : contact fermé 500ms puis ouvert. Cette impulsion inverse le sens du portail (impulsionnel).

• Je ferme le contact entre borne 2 et borne 7 (ON).
• J’attends 500 millisecondes précises.
• J’ouvre le contact (OFF).

Ce principe d’impulsion est détaillé page 8 de la notice technique Came ZL180.

Je récupère l’état ouvert/fermé

La carte ZL180 n’offre pas de contact sec direct pour l’état du portail. J’utilise le dispositif de signalisation « portail ouvert » qui délivre 24V entre bornes 5 et 10 quand le portail est fermé (page 6 notice).

Pour convertir ce 24V en contact sec (compatible domotique), j’ajoute un relais 24V IEC255. Le schéma montre le raccordement : bobine entre 5-10, contact NA vers le module Zigbee.

Le relais s’installe dans le boîtier Came avec son support DIN. Vérifiez l’isolation électrique pour la sécurité.

Configuration DIP2 obligatoire

Si certaines impulsions ne sont pas prises en compte, vérifiez le DIP2 de la carte ZL180. La fonction « Stop » (DIP2=ON) bloque le portail à chaque impulsion. Passez DIP2 à OFF pour un fonctionnement impulsionnel normal.

Choix du module Zigbee domotique

J’ai testé plusieurs modules avant de choisir. L’ESP WiFi initial posait des problèmes de fiabilité. Voici les alternatives évaluées :

• Frient IOMZB-110 : 4 entrées + 2 sorties secs, performant mais 50€.
• Tuya ZG-005-RF : 4 sorties secs à 18€, excellent multi-usages.
• Nodon SIN-4-1-20 : Sorties puissantes, pas d’entrée état.
• Moes ZM-102-M-MS : Spécifique garage, à tester.
• Bosch BMCT-RZ : Qualité pro, entrée potentiel seulement.

Choix final : QS-Zigbee-S10-C03 à 9€. Compact, entrée/sortie secs, temporisation intégrée 500ms, appairage simple.

Brochage simple et logique : N (neutre), L (phase 230V), S1-S2 (entrée contact sec état), L1-L2 (sortie impulsion).

Où acheter cet équipement ?

Voici le lien vers la page dédiée au QS-Zigbee-S10-C03. J’y ai référencé les vendeurs et les prix.

Schéma câblage complet portail

J’appaire le module Zigbee2MQTT

Mise sous tension = mode appairage automatique (LED verte clignote). Bouton physique sur le module pour forcer si besoin. Le module apparaît comme TS0603 dans Zigbee2MQTT.

Je renomme en « Came » et teste : toggle switch = impulsion 500ms auto + cooldown anti-spam. Court-circuit S1-S2 = binary_sensor ON (fermé).

• binary_sensor.came_garage_door_contact : off=ouvert, on=fermé.
• switch.came_state : toggle = impulsion ouverture/fermeture.

Configuration Cover Home Assistant

Un Cover unifie état + commande en une entité. value_template lit le binary_sensor, open/close toggle le switch. Icon change selon état pour visualisation claire.

platform: template
covers:
  portail:
    device_class: window
    friendly_name: "Portail"
    unique_id: cover.portail
    value_template: "{{ is_state('binary_sensor.came_garage_door_contact', 'off') }}"
    open_cover:
      service: switch.toggle
      target:
        entity_id: switch.came_state
    close_cover:
      service: switch.toggle
      target:
        entity_id: switch.came_state
    icon_template: >-
      {% if is_state('binary_sensor.came_garage_door_contact', 'off') %}
        mdi:gate-open
      {% else %}
        mdi:gate
      {% endif %}

device_class: window évite le code PIN vocal. Fichier dans configuration/covers.yaml, redémarrage HA nécessaire.

Création bouton dashboard portail

Version simple button-card

type: custom:button-card
show_name: false
tap_action:
  action: toggle
entity: cover.portail
state:
  - value: close
    color: gray
  - value: open
    color: red

Version avancée picture-elements

- type: custom:button-card
  color_type: card
  entity: cover.portail
  show_name: false
  tap_action:
    action: toggle
  state:
    - value: open
      color: "#4f010a"
      icon: mdi:gate-open
      styles:
        card:
          - animation: blink 2s ease infinite
    - operator: default
      color: "#49556c"
      icon: mdi:gate
  styles:
    card:
      - height: 110px
      - width: 110px
  style:
    top: 93%
    left: 5%

Intégration commande vocale Alexa

Exposer cover.portail vers Alexa permet « Alexa, ouvre le portail ». Pas de code PIN grâce à device_class window.

1. Paramètres > Assistants vocaux dans Home Assistant.
2. Cliquer « x entité(s) exposée(s) » bas gauche.
3. Cocher cover.portail et valider.

Forum discussion et retours

Échangez sur ce projet domotisation portail Came ZL180 sur le forum HACF :

Forum HACF : Domotiser portail Came

Produit N°1

Produit commandé

J’ai donc commandé ce produit :

Entre 6 et 7€.

Il est spécifié : 286MHz-868MHz

Programmation

Voici la doc fournie, la programmation est archi-simple.

La programmation est donc archi simple, d’abord, on reset tout en appuyant sur les deux boutons du haut. Puis on configure bouton par bouton en laissant appuyé dessus et en présentant la télécommande source devant en appuyant également, c’est instantané.

Produit N°2

Produit commandé

J’ai commandé ce produit :

Un peu plus petite que la précédente.

Entre 5 et 6€

Emetteur RF, 433Mhz

Matériel: Plastique.
Taille: 60*36*12mm.
Tension nominale: 2*3V CR2016.Batterie (incluse).
Distance de transmission sans fil: 150 (m).

Puces qui peuvent être copiées: PT2262,PT2240, PT2264, PT2260,PT2242,SC2262, SC2260, EV1527,P527,HT600,HT640,HT12D,HT12F,HT12E,SC5262 etc.

Programmation

Pas de mode d’emploi fournie, j’ai trouvé sur le net la procédure

Reset : Appuyer sur les deux boutons du haut (la led clignote 3 fois) puis maintenir le bouton de gauche , relâcher le bouton de droite puis appuyer 3 fois sur le bouton de droite, la led clignote, c’est reseté. Normalement l’appui sur les boutons ne déclenche pas la led.

Prog (pour chaque bouton) : laisser appuyer sur le bouton à programmer, présenter l’ancienne télécommande et presser le bouton. Le bouton se programme quand la led réagit.

Produit N°3

Produit commandé

J’ai commandé ce produit :

433Mhz

Entre 4 et 5€

Programmation

Elle est identique à la précédente, juste au dessus.

Produit N°4

Produit commandé

J’ai commandé ce produit :

Entre 4 et 5€

(1) fréquence de fonctionnement: 433.92 MHz
(2) régime d’alimentation d’énergie: Alimentation d’énergie de DC3V (2032 de batterie de bouton).
(3) courant de veille: moins de 0.15uA.
(4) Bonne sélectivité et capacité de suppression des rayonnements parasites.
(5) Bonne capacité locale de suppression de rayonnement de vibration.
(6) plage de température: -20-70 ° C (-20-70 ° C) Même dans des températures ambiantes difficiles, il peut fonctionner normalement.

(7) taille de produit: 60*37.4*11.4 (millimètre) (logement y compris).

(8) poids du produit: 14.39g (y compris le cas).

Programmation

Elle est identique à la précédente, juste au dessus.

Voici la documentation fournie :

Et l’explication sur le site de vente :

Conclusion, résultats

Pour l’instant la pile est neuve, ainsi, j’ai l’impression que les nouvelles télécommandes portent plus loin, il faudrait que je change la pile de la télécommande originelle pour en être certain

La programmation est plutôt simple, le résultat immédiat, à ce stade, je n’ai rien de négatif à signaler.

Les 3 télécommandes chinoises sont dans un plastique de qualité, l’appui des boutons est agréable, rien à dire côté esthétique non plus, j’aime beaucoup la ronde qui change.

Le temps me dira si elles tiendront aussi longtemps que la télécommande de marque.

Mes objectifs 

• Avoir un bouton sur le dashboard qui permette d’actionner le portail (Ordre=On + pause + Off)
• Avoir le retour de l’état réel du portail (ouvert / fermé)
• Lier HA et Alexa pour pouvoir dire « Alexa ouvre le portail » par exemple

Contexte

J’ai un portail Came battant, Carte ZL180.

• Notice

Présentation de la carte de commande

Tout va se passer au niveau des borniers de la carte de commande en bas à droite, voici l’identification des bornes

Comment ouvrir/fermer le portail ?

C’est un contact sec qui peut être symbolisé par cette séquence qui va ouvrir (ou fermer) le portail :

• ON sur Borne 2 – Borne 7
• pause 500ms
• OFF sur Borne 2 – Borne 7

Ces éléments sont documentés page 8 de la notice :

Comment savoir si le portail est ouvert ou fermé ?

Je n’ai pas trouvé de contact sec accessible qui donne cette information, j’ai utilisé un dispositif de signalisation « portail ouvert » qui sous potentiel 24v entre les bornes 5 et 10 , cette information est documenté page 6 de la notice :

Préférant travailler avec des contacts sec on/off sans potentiel, c’est à dire des circuits ouverts ou fermés, j’ai transformé cette information 0/24v en on/off.

Pour réaliser ce montage, rien de plus simple, 4 câbles et un relais 24V. J’avais déja un relais, j’ai donc utilisé celui-là, c’est un IEC255 qui ressemble à cela :

J’ai assez de place dans le boitier platine du Came pour y placer ce relais en haut à droite.

Voici le câblage avec le support :

Quel équipement domotique ?

A ce stade, il faut choisir quel équipement domotique va envoyer à Home Assistant l’information de portail ouvert / portail fermé et quel équipement est capable de commander un contact sec qui va déclencher l’ouverture. Idéalement, le même équipement pour faire les deux.

J’ai fait plusieurs essais, dans un premier temps avec un détecteur porte/fenêtre pour envoyer le portail ouvert/fermé, en Zigbee mais je pense que la proximité du transfo posait souci, je ne sais pas, ce n’était pas convainquant. Puis cet équipement ne permettait pas de commander un relais.

J’aurais véritablement préféré utiliser le Zigbee car pour moi le Wifi n’est pas un protocole domotique.

Finalement, voici mon choix, très simple : Un Sonoff Basic 

Cet équipement qui valait moins de 4€ il n’y a pas longtemps coute entre 5 et 6€ au moment où j’écris ceci sur AliExpress et dans les 14 € sur Amazon.

Attention, j’ai dû un peu bricoler, souder mais pour ce prix, cela vaut le coup (et le coût).

Préparation du Sonoff Basic

Modifier le Sonoff Basic pour que la sortie soit un contact sec

Le Sonoff Basic, R2 dans mon cas est un équipement qui bascule un relais quand on lui envoie une commande On ou Off sur GPIO12.

Le souci dans cette configuration c’est que j’envoie le potentiel d’entrée donc 220V sur la sortie, entre les bornes de sortie, on a donc soit 0v soit 220v. Ce n’est pas ce dont j’ai besoin, j’ai juste besoin de fermer un circuit (court-circuit) entre les bornes de sortie. J’ai donc besoin de ce type de schéma :

Pour réaliser cette modification, j’ai réalisé ce retex :

• Un contact sec (ou relais) connecté wifi pour -4€ compatible Jeedom

Relier les équipements

(cela peut être fait après la configuration logiciel, c’est au choix)

Voici le schéma complet 

Je n’ai pas oublié d’alimenter en 220v le Sonoff sur le bornier du bas et j’ai bien mis le relais sur son support noir.

Flasher le Sonoff Basic et lui installer ESP Home

• Flasher un ESP Sonoff avec ESPHome

Intégrer le Sonoff Basic dans Home Assistant

Une fois flashé dans ESP Home, le nouvel équipement est reconnu dans Home Assistant dans les intégrations

Je peux me lancer dans la configuration des entités.

Récupérer les informations sur esphome.io

Il est toujours mieux de récupérer à la source les informations, à défaut, beaucoup de sites, tutos ou forums peuvent donner les éléments de configuration nécessaires.

Pour mon Sonoff Basic, je vais sur 

• https://esphome.io/devices/sonoff_basic.html?highlight=sonoff

Evidemment, je ne suis pas la doc, je change la led pour pouvoir la commander et je configure Rx et Tx pour avoir deux input de plus :

esphome:
  name: esphome-web-a8d117
  friendly_name: Portail

esp8266:
  board: esp8285

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: "xx"

ota:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO0
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Bouton"
  - platform: gpio
    pin:
      number: GPIO1
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Tx"
  - platform: gpio
    pin:
      number: GPIO3
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Rx"

switch:
  - platform: gpio
    name: "Relais"
    pin: GPIO12
    id: relay
    on_turn_on:
    - delay: 0.5s
    - switch.turn_off: relay
  - platform: gpio
    name: "Led"
    pin: GPIO13
    id: led

wifi:
  ssid: xxx
  password: xxx

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: xxx
    password: xxx

captive_portal:
    

Je garde le code ci-dessus comme référence pour d’autres équipements mais finalement pour ma domotisation de portail, je simplifie encore le code en supprimant tout ce qui n’est pas utile pour le projet :

esphome:
  name: esphome-web-a8d117
  friendly_name: Portail

esp8266:
  board: esp8285

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: "xx/xx="

ota:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO1
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Tx"

switch:
  - platform: gpio
    name: "Relais"
    pin: GPIO12
    id: relay
    on_turn_on:
    - delay: 0.5s
    - switch.turn_off: relay

wifi:
  ssid: xx
  password: xx

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: esp_portail
    password: xx

Installation du code sur le Sonoff

Ensuite je sauvegarde puis j’installe.

Une fois l’installation faite, le module se relance, il faut être un peu patient.

Nota : J’ai eu quelques soucis car les variables !secret n’étaient pas configurées chez moi, j’ai mis en clair et cela a fonctionné. Les variables des secrets se configurent en haut à droite de l’interface ESP Home.

  ssid: !secret wifi_ssid
  password: !secret wifi_password

Résultat de l’intégration

Comme tout s’est bien passé, je me retrouve avec plusieurs entités sur son ESP nouvellement créé.

Configuration des Entités sur HA

Configuration du capteur Portail

J’utilise l’entrée Tx (GPIO01) pour détecter le contact sec du portail.

Je renomme ce capteur en « Portail » et je lui affecte « Ouverture » pour avoir les états  Ouvert / Fermé

Je change son id qui sera : binary_sensor.portail_ouvert_ferme

Je désactive les deux autres capteurs (Bouton et Rx) qui ne me sont pas utiles.

Configuration du contrôle Commande du Portail

Il s’agit du switch relais que j’ai renommé Commande du Portail avec id: switch.portail_relais

Configuration du Cover Portail

Il est nécessaire d’avoir un cover pour permettre 2 choses :

• D’avoir l’état qui remonte du capteur Portail (binary_sensor.portail_ouvert_ferme) cela alors que les commandes sont à passer au contrôle Commande du Portail (switch.portail_relais)
• De gérer le turn_off qui sera en réalité un turn_on

Le code du cover placé dans covers.yaml est le suivant :

- platform: template
  covers:
    portail:
      device_class: window
      friendly_name: "Portail"
      unique_id: cover.portail
      value_template: "{{ is_state('binary_sensor.portail_ouvert_ferme', 'on') }}"
      open_cover:
        service: switch.turn_on
        target:
            entity_id: switch.portail_relais
      close_cover:
        service: switch.turn_on
        target:
            entity_id: switch.portail_relais
      icon_template: >-
        {% if is_state('binary_sensor.portail_ouvert_ferme', 'on') %}
          mdi:gate-open
        {% else %}
          mdi:gate
        {% endif %}

A noter que dans ce code, je gère l’icone à utiliser. La couleur sera gérée dans la carte bouton au moment de l’affichage du bouton.

J’ai utilisé la device_class: window car c’est la plus proche d’un portail (ouvert ou fermé) mais les autres class rendent obligatoire un code à 4 chiffres en commande vocale ce que je ne souhaite pas si je veux demander à Alexa d’ouvrir le portail.

Création d’une carte bouton

type: custom:button-card
show_name: false
tap_action:
  action: toggle
entity: cover.portail
state:
  - value: close
    color: gray
  - value: open
    color: red

Lier HA et Alexa pour commander à la voix

Dire « Alexa ouvre le portail » est quand même le graal de tout cela.

Il me reste a établir le lien.

Pour cela je vais dans Paramètres/ Assistants vocaux

En bas à gauche, je clique sur x entité(s) exposée(s)

et je vis cherche mon cover.portail

C’est tout !

Bonus : Ping pour vérifier que l’équipement est en ligne

J’ai une confiance toute relative aux équipements en wifi (contrairement au Zigbee) et je me rassure en vérifiant de temps en temps leur connectivité.

Pour cela, rien de plus simple, un petit ping toutes les 5min via un binary_sensor qui me donner l’information sur mon Dashboard, je place cette config dans mon fichier binary_sensor.yaml

- platform: ping
  host: !secret ip_portail
  name: ping_portail

Evidemment, il faut bien configurer !secret ou remplacer par l’IP en brut.

La personnalisation de l’icone est abordé sur un autre retex:

• Signaler visuellement un défaut sur le dashboard

Une question ? une remarque ? un complément ?

Utilisez cette discussion pour évoquer ce retex :

• https://forum.hacf.fr/t/retex-je-domotise-mon-portail/