Tutoriel ESPHome : surveiller la température de la maison avec un ESP32 et un Xiaomi Mijia

Je voulais connaître la température de la maison depuis l'extérieur. Le salon est-il glacial ? Ai-je laissé le chauffage allumé toute la journée ? Une question simple, et je ne voulais pas payer un service cloud pour y répondre.
La réponse était déjà sur mon bureau : un thermomètre Bluetooth Xiaomi Mijia (le petit modèle à écran LCD, référence LYWSD03MMC, environ 4 euros) et un ESP32. Le thermomètre mesure, l'ESP32 écoute et met tout sur votre Wi-Fi. Pas de compte, pas d'application, pas de cloud.

Ce qu'il vous faut
- Une carte ESP32 DevKit : l'ESP32 DevKit convient parfaitement, Wi-Fi et Bluetooth sont intégrés. Pour plus de mémoire dans des projets plus gros, prenez l'ESP32-S3 N16R8.
- Un thermomètre Xiaomi Mijia LYWSD03MMC.
- Un câble USB de données (pas un câble de charge seule, voir notre checklist des premiers pas).
- Un ordinateur pour flasher le premier firmware. Ensuite, les mises à jour passent par le Wi-Fi.

Qu'est-ce qu'ESPHome ?
ESPHome transforme un court fichier YAML en firmware complet pour votre ESP32. Vous décrivez ce que vous avez (« un thermomètre Xiaomi à cette adresse »), ESPHome écrit et compile le code. Vous obtenez gratuitement le Wi-Fi, une petite page web, les mises à jour à distance et une connexion native à Home Assistant. Vous n'écrivez pas une seule ligne de C++.
Étape 1 : trouver l'adresse MAC
Chaque appareil Bluetooth a une adresse MAC. ESPHome en a besoin pour savoir quel thermomètre écouter.
Le plus simple est de laisser l'ESP32 scanner. Flashez une configuration minimale avec esp32_ble_tracker: et regardez les logs : ESPHome affiche tous les appareils qu'il voit, y compris les Mijia (leur nom ressemble à LYWSD03MMC). Sous Linux, vous pouvez aussi lancer bluetoothctl puis scan on.
Notez l'adresse, par exemple A4:C1:38:12:34:56.
Étape 2 : récupérer la bindkey
Les thermomètres Mijia récents chiffrent leurs messages. ESPHome a besoin de la bindkey (une clé de 32 caractères) pour les lire. Deux options :
- Garder le firmware d'origine : associez une fois le thermomètre à l'application Xiaomi Home, puis extrayez la clé avec un outil de la communauté (la page web Telink flasher ou un script d'extraction de bindkey). La clé reste sur votre ordinateur.
- Flasher un firmware personnalisé comme PVVX ou ATC. Le thermomètre diffuse alors en clair, pas de bindkey, et la pile dure encore plus longtemps.
Les deux marchent bien. L'option 1 est la moins risquée si vous ne voulez rien toucher.
Étape 3 : la configuration
Créez livingroom.yaml :
esphome:
name: livingroom
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
web_server:
port: 80
esp32_ble_tracker:
sensor:
- platform: xiaomi_lywsd03mmc
mac_address: "A4:C1:38:12:34:56"
bindkey: "your_32_character_bindkey_here"
temperature:
name: "Living room temperature"
humidity:
name: "Living room humidity"
battery_level:
name: "Living room thermometer battery"
binary_sensor:
- platform: status
name: "Living room ESP32 status"
Et un fichier secrets.yaml à côté, pour que vos mots de passe ne finissent pas dans le fichier principal :
wifi_ssid: "MyWifi"
wifi_password: "mypassword"
api_key: "generate-one-in-the-esphome-dashboard"
ota_password: "choose-a-password"
L'élément important est esp32_ble_tracker:. Il fait écouter à l'ESP32 les messages Bluetooth. Il ne s'associe jamais au thermomètre, donc la pile du thermomètre n'est pas affectée.
Étape 4 : le flasher
Le plus simple est le tableau de bord ESPHome. Avec Docker :
docker run --rm -p 6052:6052 -v "$PWD/config":/config esphome/esphome
Ou avec Python :
pip install esphome esphome-device-builder
esphome dashboard config
Ouvrez http://localhost:6052, ajoutez votre fichier, cliquez sur Install et choisissez Plug into this computer pour le premier flashage. Le tableau de bord compile le firmware (la première compilation prend quelques minutes), le téléverse et affiche les logs.

Quand les logs affichent des valeurs de température et d'humidité, c'est bon. La fois suivante, choisissez Wirelessly : plus besoin de câble.
L'ESP32 sert aussi une petite page web sur http://livingroom.local avec les valeurs en direct. Pratique depuis le téléphone.
Étape 5 : Home Assistant
Home Assistant découvre l'appareil automatiquement : allez dans Paramètres, Appareils et services, acceptez le nouvel appareil ESPHome et saisissez la clé api_key quand elle est demandée. Vous avez maintenant des entités température, humidité et batterie, avec des graphiques d'historique. Ajoutez-les à un tableau de bord ou déclenchez une automatisation de chauffage.
Astuces
- Un seul ESP32 peut écouter plusieurs thermomètres. Ajoutez un bloc
xiaomi_lywsd03mmcpar adresse MAC. - La portée Bluetooth est d'environ 10 mètres en intérieur. Les murs comptent. Placez l'ESP32 près des thermomètres.
- L'ESP32 peut faire plus en même temps : le tutoriel DHT22 montre un capteur filaire.
Conclusion
Pour quelques euros, vous obtenez un moniteur de température privé et local, qui marche même sans internet. Le même ESP32 peut ensuite faire bien plus. Si quelque chose ne marche pas, ou si vous voulez connecter un autre capteur, écrivez-nous via la page contact.
Ces configurations ont été validées avec esphome config. L'adresse MAC et les clés des exemples sont des valeurs fictives : remplacez-les par les vôtres.