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

4 min de lecture

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.

Plusieurs proxys ESP32 transmettent les données Bluetooth à Home Assistant par Wi-Fi

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.

Une carte ESP32 DevKit

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_tracker est obligatoire, car le proxy en dépend.
  • interval égal à window fait scanner l'ESP32 presque en continu, pour manquer moins d'annonces.
  • bluetooth_proxy: active: true permet 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 est false).

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