Aqara ou MOES : appairer un capteur d’ouverture Zigbee dans Home Assistant

Les capteurs d’ouverture Aqara MCCGQ11LM et MOES ZSS-G02-GWM-C fonctionnent de la même façon dans Home Assistant via Zigbee2MQTT. La procédure ci-dessous couvre les deux modèles, avec les différences signalées au fur et à mesure.

Préparation du capteur

Les deux modèles fonctionnent sur pile bouton et ne nécessitent aucune configuration préalable.

Aqara MCCGQ11LM (piles CR1632)

Il n’y a rien à faire à l’installation. Mais si la pile est trop ancienne, ais levier délicatement avec un ongle ou un petit tournevis plat dans la fente sur la tranche inférieure pour ouvrir le boîtier. Insère une pile CR1632, face positive (+) vers le haut. Referme le boîtier en clipsant le couvercle.

MOES ZSS-G02-GWM-C (pile CR2032)

1. Glisse un ongle ou un petit tournevis dans la fente du boîtier arrière pour l’ouvrir.
2. Retire la languette en plastique transparent qui bloque la pile.

Dans les deux cas, effectue l’appairage à proximité de ton ordinateur ou de ta box domotique avant de coller le capteur à son emplacement définitif.

Appairage dans Zigbee2MQTT

1. Ouvre l’interface web de Zigbee2MQTT.
2. Clique sur Permit join en haut à droite.
3. Maintiens le bouton du capteur enfoncé environ 5 secondes jusqu’à ce que la LED clignote, puis relâche.
4. Zigbee2MQTT détecte le capteur en quelques secondes et l’ajoute à la liste.
5. Renomme-le immédiatement (ex : Capteur Porte Entrée ou Capteur Fenêtre Cuisine) et coche la case pour synchroniser le nom avec Home Assistant.

Astuce Aqara uniquement – Les capteurs Aqara de première génération ont tendance à s’endormir rapidement pendant l’appairage. Pendant les 10 à 20 secondes que dure la détection, appuie brièvement sur le bouton toutes les 2 secondes pour maintenir le capteur éveillé et lui permettre d’envoyer ses informations de configuration.

Installation physique

Le principe est le même pour les deux modèles :

• Place le grand boîtier sur la partie fixe (le cadre de porte ou de fenêtre) et le petit aimant sur la partie mobile (le battant).
• Aligne les petites lignes gravées sur le côté de chaque pièce l’une en face de l’autre.
• Respecte la distance maximale entre les deux éléments : 22 mm pour l’Aqara, 20 mm pour le MOES. Au-delà, le capteur considère la porte comme ouverte même quand elle est fermée.

Entités disponibles dans Home Assistant

Une fois appairé, le capteur apparaît automatiquement dans Home Assistant via l’intégration MQTT. Tu y trouveras :

• binary_sensor.contact – état d’ouverture : on pour ouvert, off pour fermé. Dans les paramètres de l’entité, utilise « Afficher en tant que » pour choisir Porte, Fenêtre ou Garage – l’icône s’adapte automatiquement.
• sensor.battery – pourcentage de pile restant (peut prendre jusqu’à 24h à se stabiliser après le premier appairage).
• sensor.linkquality – force du signal Zigbee (Aqara uniquement).
• binary_sensor.battery_low – alerte pile faible (MOES uniquement).

Exemples d’automatisations

Allumage automatique à l’ouverture d’une porte (idéal pour un couloir ou un dressing)

alias: "Lumière : Allumage auto sur ouverture porte"
trigger:
  - platform: state
    entity_id: binary_sensor.capteur_porte_entree_contact
    to: "on"
condition:
  - condition: state
    entity_id: sun.sun
    state: "below_horizon"
action:
  - service: light.turn_on
    entity_id: light.lumiere_couloir

Notification si une fenêtre reste ouverte

alias: "Notification : Fenêtre restée ouverte"
trigger:
  - platform: state
    entity_id: binary_sensor.capteur_fenetre_cuisine_contact
    to: "on"
    for:
      minutes: 10
action:
  - service: notify.mobile_app_votre_telephone
    data:
      title: "Attention"
      message: "La fenêtre de la cuisine est ouverte depuis plus de 10 minutes !"

Remplace les noms d’entités par ceux de tes capteurs dans Home Assistant.