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

« 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.

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.

É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_presenceest un capteur binaire : actif quand l'appareil est entendu, inactif après letimeoutsans l'entendre.min_rssi: -85dBignore les signaux très faibles, pour qu'un badge chez le voisin ne compte pas.ble_rssipublie la force du signal. Avec un ESP32 par pièce, celui qui a la valeur la plus forte indique la pièce.scan_parametersavecintervalégal àwindowfait scanner l'ESP32 presque en continu.active: falsegarde 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 :
- 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.
- 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.

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.