Tutoriel ESPHome : détecteur de présence Bluetooth avec un ESP32

4 min de lecture

« Y a-t-il quelqu'un à la maison ? » est la question derrière la plupart des automatisations : éteindre les lumières quand la maison est vide, lancer le chauffage avant votre arrivée. Un ESP32 à bas prix peut y répondre en écoutant les appareils Bluetooth : votre téléphone, une montre connectée, ou un badge à 5 euros sur vos clés.

Un ESP32 par pièce mesure le signal d'un téléphone ou d'un badge

Ce qu'il vous faut

  • Une carte ESP32 DevKit : l'ESP32 DevKit. Le lot de 3 convient bien à ce projet : une carte par pièce. L'ESP32-S3 N16R8 a plus de mémoire si vous utilisez beaucoup de capteurs.
  • Quelque chose à détecter : un badge BLE, une montre connectée ou un bracelet d'activité, ou votre téléphone.
  • Un câble USB de données.

Une carte ESP32 DevKit

Étape 1 : voir ce qui se trouve autour

Commencez par le scanner. Ajoutez ceci à une configuration minimale et ouvrez les logs :

esp32_ble_tracker:

text_sensor:
  - platform: ble_scanner
    name: "BLE devices nearby"

Le capteur ble_scanner liste les appareils proches avec leur adresse MAC. Promenez-vous avec votre badge, regardez quelle adresse apparaît et disparaît. C'est celle qu'il vous faut.

Étape 2 : la configuration de présence

esphome:
  name: hallway-presence

esp32:
  board: esp32dev

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

logger:

api:
  encryption:
    key: !secret api_key

ota:
  - platform: esphome
    password: !secret ota_password

esp32_ble_tracker:
  scan_parameters:
    interval: 1100ms
    window: 1100ms
    active: false

binary_sensor:
  # A BLE tag, a smartwatch, a fitness band: it keeps the same MAC address
  - platform: ble_presence
    mac_address: "AA:BB:CC:DD:EE:FF"
    name: "Keys tag present"
    timeout: 2min
    min_rssi: -85dB

  # An iPhone or modern Android phone: its address changes, so use the IRK
  - platform: ble_presence
    irk: "0123456789abcdef0123456789abcdef"
    name: "Phone present"

sensor:
  - platform: ble_rssi
    mac_address: "AA:BB:CC:DD:EE:FF"
    name: "Keys tag signal"

text_sensor:
  - platform: ble_scanner
    name: "BLE devices nearby"

Le rôle de chaque partie :

  • ble_presence est un capteur binaire : actif quand l'appareil est entendu, inactif après le timeout sans l'entendre.
  • min_rssi: -85dB ignore les signaux très faibles, pour qu'un badge chez le voisin ne compte pas.
  • ble_rssi publie la force du signal. Avec un ESP32 par pièce, celui qui a la valeur la plus forte indique la pièce.
  • scan_parameters avec interval égal à window fait scanner l'ESP32 presque en continu. active: false garde un scan passif : rien n'est émis.

Téléphones : le problème de l'adresse MAC

Les iPhone et les Android récents utilisent une adresse MAC aléatoire et changeante pour protéger la vie privée. Une mac_address fixe ne marchera pas pour eux. Deux solutions :

  1. Utiliser l'IRK (identity resolving key), une clé secrète qui permet à ESPHome de reconnaître le téléphone malgré le changement d'adresse. L'obtenir demande des informations d'appairage du téléphone, et ce n'est pas simple sur iOS.
  2. Utiliser un badge dédié ou une montre connectée : ils gardent une adresse stable. C'est plus simple et plus fiable, et c'est ce que je recommande.

Flasher et tester

docker run --rm -p 6052:6052 -v "$PWD/config":/config esphome/esphome

Installez, attendez le Wi-Fi, puis sortez de la portée et revenez. Après le délai, le capteur passe à inactif, puis de nouveau à actif.

Le tableau de bord ESPHome en train d'éditer hallway-presence.yaml

Home Assistant

Les capteurs apparaissent automatiquement. Créez une automatisation du type « si personne n'est présent pendant 10 minutes, éteindre les lumières ». Pour les pièces, comparez les valeurs ble_rssi de plusieurs cartes ESP32.

Limites à connaître

  • La portée est d'environ 10 mètres, et les murs la réduisent. Testez et ajustez min_rssi.
  • La pile BLE consomme beaucoup de RAM et partage la radio avec le Wi-Fi. N'empilez pas trop de fonctions sur une seule carte.
  • Vie privée : détecter des personnes par leurs appareils relève des données personnelles dans beaucoup de pays. Utilisez-le chez vous, avec l'accord des personnes concernées.
  • La présence est une bonne estimation, pas une preuve. Un badge oublié sur la table dit que quelqu'un est là.

Conclusion

Un ESP32 par pièce, un badge par personne, et votre maison sait qui est là. Combinez-le avec le capteur DHT22 ou le thermomètre Mijia sur la même carte.

Cette configuration a été validée avec esphome config, pas testée avec vos appareils. L'adresse MAC et l'IRK sont des valeurs fictives.