Associer un capteur de mouvement Aqara à Home Assistant

  • aqara, domotique, home assistant, zigbee
Capteur de mouvement Aqara associé à Home Assistant via Zigbee2MQTT dans un couloir
Comment appairer un capteur de mouvement Aqara (RTCGQ11LM/RTCGQ12LM) à Home Assistant via Zigbee2MQTT, avec un exemple d'automatisation lumière le soir et les vraies limites à connaître (délai de réarmement, portée).

Sommaires

Tu veux que la lumière du couloir s’allume toute seule quand tu passes, sans avoir à appuyer sur un interrupteur ? Le capteur de mouvement Aqara (référence RTCGQ11LM, ou sa version avec bouton reset RTCGQ12LM) est l’un des capteurs Zigbee les plus utilisés dans la communauté Home Assistant, notamment parce qu’il s’associe directement à un dongle Zigbee via Zigbee2MQTT — pas besoin de passerelle Aqara. Dans cet article, je t’explique comment l’appairer et créer une automatisation simple.

Ce guide est basé sur la documentation officielle de Zigbee2MQTT et les retours de la communauté Home Assistant — je n’ai pas testé ça moi-même, donc n’hésite pas à confirmer certains détails avec ton propre setup.

🧩 Ce qu’il te faut avant de commencer

  • Un capteur de mouvement Aqara RTCGQ11LM ou RTCGQ12LM (pile CR2450 fournie).
  • Une clé Zigbee (Sonoff, ConBee, etc.) avec Zigbee2MQTT installé et configuré.
  • Home Assistant avec l’intégration MQTT configurée et le « MQTT discovery » activé côté Zigbee2MQTT (c’est le comportement par défaut).

🔧 Étapes d’appairage via Zigbee2MQTT

Comme pour la plupart des appareils Aqara/Xiaomi, l’appairage se fait en deux temps : autoriser le réseau à accepter de nouveaux appareils, puis réveiller le capteur.

  1. Ouvre l’interface web de Zigbee2MQTT (Zigbee2MQTT Frontend) et active Permit join (le bouton « Permit join (All) » en haut de l’écran).
  2. Sur le capteur, appuie sur le petit bouton reset (à l’intérieur, à côté de la pile) pendant environ 5 secondes, jusqu’à ce que la LED bleue clignote.
  3. Le capteur devrait apparaître dans la liste des appareils sous quelques secondes à quelques dizaines de secondes. S’il ne se présente pas du premier coup, retire et remets la pile puis recommence l’appui reset — les appareils Xiaomi/Aqara sont connus pour être un peu capricieux au premier appairage.
  4. Une fois reconnu, Zigbee2MQTT lui attribue un nom par défaut (souvent son adresse IEEE) : renomme-le tout de suite dans « friendly_name » (par exemple capteur_mouvement_couloir) pour t’y retrouver plus facilement côté Home Assistant.

📲 L’entité créée dans Home Assistant

Grâce à MQTT discovery, Home Assistant crée automatiquement une entité binary_sensor de classe « occupancy » ou « motion » selon la version d’intégration, du type binary_sensor.capteur_mouvement_couloir_occupancy. Le capteur remonte aussi d’autres informations utiles : le niveau de luminosité ambiante (illuminance), le niveau de batterie, et parfois la température interne du device. Tu peux t’en servir pour, par exemple, ne déclencher une lumière que si la pièce est déjà sombre.

⚡ Exemple d’automatisation : lumière le soir sur détection

Voici un exemple d’automatisation qui allume la lumière du couloir uniquement si du mouvement est détecté après le coucher du soleil, et l’éteint automatiquement une fois le capteur repassé à « clear ».

alias: Lumière couloir sur mouvement (soir)
trigger:
  - platform: state
    entity_id: binary_sensor.capteur_mouvement_couloir_occupancy
    to: "on"
condition:
  - condition: sun
    after: sunset
action:
  - service: light.turn_on
    target:
      entity_id: light.couloir
  - delay: "00:02:00"
  - service: light.turn_off
    target:
      entity_id: light.couloir
mode: restart

Le mode: restart est important ici : si une nouvelle détection arrive pendant le délai de 2 minutes, l’automatisation repart de zéro plutôt que d’éteindre la lumière trop tôt. Pour des automatisations plus élaborées (croiser plusieurs capteurs, gérer des horaires précis), jette un œil à l’article sur l’automatisation des volets et lumières selon l’heure.

🎯 Limites à connaître

  • Délai de réarmement (cooldown) : d’après la documentation et les retours communautaires, le RTCGQ11LM a un comportement matériel qui l’empêche de signaler une nouvelle détection avant environ 60 secondes après la précédente — c’est une limite du capteur lui-même, pas un réglage logiciel. Zigbee2MQTT recommande de ne pas configurer un occupancy_timeout inférieur à cette valeur (la valeur par défaut, 90 secondes, est un choix raisonnable), sous peine de voir l’entité repasser à « off » alors que quelqu’un est encore présent dans la pièce.
  • Portée réelle : les retours d’utilisateurs sur le forum Home Assistant indiquent une portée de détection souvent plus courte que ce que promet la fiche produit — pense à tester l’emplacement avant de fixer le capteur définitivement, surtout dans les angles ou les grandes pièces.
  • Pas de détection de présence statique : comme la plupart des PIR classiques, ce capteur détecte le mouvement, pas la présence immobile. Si tu restes assis sans bouger, il finira par repasser à « clear ». Pour un usage nécessitant une vraie détection de présence, regarde plutôt du côté des capteurs radar/mmWave — j’en parle dans l’article dédié aux capteurs de présence.
  • Fiabilité du premier appairage : comme souvent avec les appareils Xiaomi/Aqara, certains utilisateurs rapportent devoir s’y reprendre à plusieurs fois lors du premier appairage.

👉 En résumé

Le capteur de mouvement Aqara reste un choix solide et abordable pour démarrer une automatisation d’éclairage sous Home Assistant, à condition de garder en tête son délai de réarmement d’environ une minute et sa portée parfois plus courte qu’annoncée. Si tu veux aller plus loin, tu peux combiner ce capteur avec un mode absent pour qu’il ne déclenche rien quand tu n’es pas chez toi.

Découvre également