Je domotise mon portail avec un QS-Zigbee-S10-C03

Mes objectifs

Disposer d’un bouton sur le dashboard pour actionner le portail (ordre = On + pause + Off).
Obtenir le retour d’état réel du portail (ouvert/fermé).
Lier Home Assistant et Alexa pour commander vocalement : « Alexa, ouvre le portail ».

Dans cet article, je détaille comment j’ai domotisé mon portail battant Came à l’aide d’une carte ZL180 et d’un module Zigbee. Je partage mon expérience, les équipements utilisés, le câblage, la configuration dans Home Assistant et l’intégration avec Alexa.

Contexte

Mon portail est un modèle battant de la marque Came, équipé d’une carte de commande ZL180. Voici la notice technique pour référence :

Notice technique de la carte ZL180

Présentation de la carte de commande

Toutes les manipulations se font au niveau des borniers de la carte de commande, situés en bas à droite. Voici l’identification des bornes :

Identification des borniers de la carte ZL180

Comment ouvrir ou fermer le portail ?

L’ouverture ou la fermeture du portail s’effectue via un contact sec entre les bornes 2 et 7, selon la séquence suivante :

ON sur Borne 2 – Borne 7
Pause de 500 ms
OFF sur Borne 2 – Borne 7

Cette séquence est documentée à la page 8 de la notice :

Comment savoir si le portail est ouvert ou fermé ?

La carte ZL180 ne propose pas de contact sec dédié pour connaître l’état du portail. J’ai donc utilisé un dispositif de signalisation « portail ouvert » qui fonctionne sous un potentiel de 24V entre les bornes 5 et 10, comme indiqué page 6 de la notice :

Dispositif de signalisation portail ouvert

Pour travailler avec des contacts secs (circuit ouvert ou fermé), j’ai transformé cette information 0/24V en on/off à l’aide d’un relais 24V. Voici le schéma du montage :

Schéma de transformation 0/24V en contact sec

J’ai utilisé un relais IEC255, que j’ai placé dans le boîtier platine du Came. Voici le câblage avec son support :

Quel équipement domotique choisir ?

J’avais initialement utilisé un ESP WiFi pour ce projet, mais j’ai finalement opté pour une solution Zigbee. Voici les équipements que j’ai considérés :

IOMZB-110 de FRIENT : 4 entrées + 2 sorties contacts secs. Un excellent produit, mais un peu cher pour mon besoin.
Smart Switch ZG-005-RF : 4 sorties en contact sec pour moins de 20€. Idéal pour des projets multi-sorties.
SIN-4-1-20 de NODON : Module commutateur Zigbee, mais sans entrée contact sec pour le retour d’état.
ZM-102-M-MS de MOES : Module pour porte de garage, à tester.
BMCT-RZ de BOSCH SMART HOME : Entrée sur potentiel, hors budget.

Finalement, j’ai opté pour un QS-Zigbee-S10-C03 trouvé sur AliExpress pour moins de 10€. Voici ses caractéristiques :

Le brochage est simple :

Un connecteur N pour le neutre et un connecteur L pour la phase.
Entre S1 et S2 : contact sec pour détecter l’état du portail.
Entre L1 et L2 : envoi de l’impulsion d’ouverture/fermeture.

Schéma de câblage complet

Appairage du module avec Zigbee2MQTT

L’appairage s’effectue facilement à la première mise sous tension. Un bouton d’appairage est présent sur le dessus du module.

Dès que Zigbee2MQTT est en mode appairage, je mets le module sous tension. La lumière verte clignote et l’appareil apparaît dans l’interface :

Le module est identifié comme un TS0603. Je le renomme en « Came » pour plus de clarté.

Je teste les commandes :

Quand je bascule l’état sur Vrai, le relais se ferme pendant une demi-seconde, puis s’ouvre. Le module envoie donc une impulsion fermée à chaque changement d’état. Une temporisation est prévue entre deux appuis, ce qui est très pratique.

Avec un câble, je court-circuite les entrées S1 et S2 : le capteur binary_sensor.came_garage_door_contact passe à Vrai, ce qui signifie que le portail est fermé.

Grâce à ce module, je récupère deux capteurs :

binary_sensor.came_garage_door_contact : état du portail (off = ouvert, on = fermé).
switch.came_state : permet d’envoyer la commande toggle, chaque toggle envoie une impulsion.

Configuration du Cover Portail dans Home Assistant

Pour simplifier la gestion, je crée un capteur unique dans Home Assistant qui permet de :

Remonter l’état du portail via binary_sensor.came_garage_door_contact.
Gérer la commande d’ouverture/fermeture via switch.came_state.

Un Cover dans Home Assistant est une entité qui représente un élément pouvant être ouvert ou fermé, comme un volet, une porte ou un portail. Cela permet de centraliser les commandes et les états, et facilite l’intégration avec les assistants vocaux.

Voici le code à placer dans le fichier covers.yaml :

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 %}

J’ai utilisé device_class: window car c’est la classe la plus proche d’un portail. Les autres classes imposent un code à 4 chiffres pour la commande vocale, ce que je ne souhaite pas.

Création du bouton pour le portail

Première version, très simple

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

Seconde version, intégrée dans un 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%

Lier Home Assistant et Alexa pour la commande vocale

Pour commander le portail à la voix, il suffit de lier Home Assistant à Alexa. Voici comment procéder :

Aller dans Paramètres > Assistants vocaux.
Cliquer sur x entité(s) exposée(s) en bas à gauche.
Sélectionner cover.portail.

C’est tout ! Vous pouvez maintenant dire « Alexa, ouvre le portail ».

Questions, remarques ou compléments ?

Pour échanger sur ce retour d’expérience, utilisez cette discussion sur le forum :

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