Proxy Bluetooth ESPHome : étendre la portée Bluetooth de Home Assistant avec un ESP32

Home Assistant sait lire des capteurs Bluetooth, mais sa radio Bluetooth est souvent dans un placard, loin des capteurs. Le signal est faible et les appareils décrochent. La solution coûte quelques euros : un ESP32 qui exécute le proxy Bluetooth ESPHome, placé là où se trouvent les appareils.

Ce que fait un proxy Bluetooth
Home Assistant reçoit les signaux Bluetooth via un adaptateur branché sur son hôte, ou via un proxy Bluetooth sur votre réseau. La documentation Bluetooth de Home Assistant recommande les proxys plutôt qu'un adaptateur directement connecté, car on peut placer le proxy près des appareils. Quand Home Assistant se connecte à un appareil, il choisit automatiquement le proxy qui a le meilleur signal.
L'ESP32 écoute les annonces Bluetooth Low Energy et les transmet à Home Assistant par Wi-Fi. L'intégration Bluetooth de Home Assistant regroupe tous les proxys et les éventuels adaptateurs USB. Les intégrations d'appareils (thermomètres, capteurs de plantes, appareils BTHome) fonctionnent alors comme si la radio était locale (documentation du proxy Bluetooth ESPHome). Seuls les appareils BLE sont pris en charge.
Ce qu'il vous faut
- Un ESP32 DevKit par zone : l'ESP32 DevKit suffit. Le lot de 3 a du sens si vous voulez couvrir plusieurs pièces. Pour plus de marge, prenez l'ESP32-S3 N16R8.
- Une alimentation USB près de l'endroit à couvrir.
- Home Assistant avec l'intégration ESPHome.

La configuration
esphome:
name: bt-proxy-kitchen
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: true
bluetooth_proxy:
active: true
Ce que font les lignes importantes :
esp32_ble_trackerest obligatoire, car le proxy en dépend.intervalégal àwindowfait scanner l'ESP32 presque en continu, pour manquer moins d'annonces.bluetooth_proxy: active: truepermet aussi à Home Assistant d'ouvrir des connexions vers les appareils via cet ESP32. Sans cela, le proxy ne fait que relayer les annonces (la valeur par défaut estfalse).
La documentation ESPHome indique que le nombre de connexions actives est limité : trois en même temps, et un appareil qui garde une connexion ouverte en occupe une en permanence. Prévoyez plus de proxys si vous utilisez beaucoup d'appareils connectés.
Flasher et ajouter à Home Assistant
Utilisez le Device Builder d'ESPHome comme dans notre tutoriel Mijia : ajoutez le fichier, cliquez sur Install et branchez la carte pour le premier flashage. Home Assistant découvrira l'appareil. Acceptez-le avec votre clé API. Pour une option toute prête, ESPHome publie aussi un installateur de proxy Bluetooth que vous pouvez flasher depuis votre navigateur.
Ensuite, les appareils Bluetooth autour du proxy sont découverts dans Paramètres, Appareils et services.
Où placer le proxy
- Près des appareils, pas près de la box.
- Loin du métal et des gros appareils électroménagers.
- Un par zone : cuisine, chambre, garage. Le Bluetooth traverse mal les murs.
- Sur une source d'alimentation stable ; un chargeur USB est parfait.
- N'exécutez pas trop d'autres fonctions sur la même carte : la pile Bluetooth consomme beaucoup de RAM et partage la radio avec le Wi-Fi.
Proxy ou capteur de présence ?
Ils utilisent le même ESP32 et la même radio, mais font des choses différentes. Un proxy donne à Home Assistant l'accès aux appareils Bluetooth. Un capteur de présence vous dit si un badge ou un téléphone est à proximité. Pour le second, lisez notre tutoriel du détecteur de présence Bluetooth. Si vous voulez seulement lire un thermomètre, le guide Xiaomi Mijia le lit directement dans ESPHome.
Conclusion
Un proxy Bluetooth est le moyen le moins cher de réparer un Bluetooth capricieux dans Home Assistant, et vous pouvez en ajouter à mesure que votre maison grandit. Flashez une carte, testez-la avec un capteur, puis ajoutez-en une autre là où le signal est faible.
La configuration a été validée avec esphome config ; elle n'a pas été testée avec vos appareils.
Sources
- ESPHome : proxy Bluetooth (en anglais)
- Home Assistant : Bluetooth (en anglais)
- ESPHome : projets avec prise en charge du proxy Bluetooth (en anglais)
- Omar Ghader, How to monitor your home temperature with ESP32 and Xiaomi Mijia using ESPHome (en anglais)