ESPHome-Bluetooth-Proxy: Bluetooth-Reichweite von Home Assistant mit einem ESP32 erweitern

3 Min. Lesezeit

Home Assistant kann Bluetooth-Sensoren lesen, aber sein Bluetooth-Funkmodul steckt meist in einem Schrank, weit von den Sensoren entfernt. Das Signal ist schwach, und Geräte fallen aus. Die Lösung kostet wenige Euro: ein ESP32 mit dem ESPHome-Bluetooth-Proxy, platziert dort, wo die Geräte sind.

Mehrere ESP32-Proxys leiten Bluetooth-Daten per WLAN an Home Assistant weiter

Was ein Bluetooth-Proxy macht

Home Assistant empfängt Bluetooth-Signale über einen an seinen Host angeschlossenen Adapter oder über einen Bluetooth-Proxy im Netzwerk. Die Bluetooth-Dokumentation von Home Assistant empfiehlt Proxys gegenüber einem direkt angeschlossenen Adapter, weil Sie den Proxy nah an die Geräte stellen können. Verbindet sich Home Assistant mit einem Gerät, wählt es automatisch den Proxy mit dem besten Signal.

Der ESP32 hört Bluetooth-Low-Energy-Sendungen mit und leitet sie per WLAN an Home Assistant weiter. Die Bluetooth-Integration von Home Assistant fasst alle Proxys und eventuelle USB-Adapter zusammen. Geräteintegrationen (Thermometer, Pflanzensensoren, BTHome-Geräte) funktionieren dann, als wäre das Funkmodul lokal (Dokumentation des ESPHome-Bluetooth-Proxys). Unterstützt werden nur BLE-Geräte.

Was Sie brauchen

  • Ein ESP32 DevKit pro Bereich: Das ESP32 DevKit genügt. Das 3er-Pack lohnt sich, wenn Sie mehrere Räume abdecken wollen. Für mehr Reserve nehmen Sie das ESP32-S3 N16R8.
  • Ein USB-Netzteil in der Nähe des Bereichs, den Sie abdecken wollen.
  • Home Assistant mit der ESPHome-Integration.

Ein ESP32-DevKit-Board

Die Konfiguration

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

Was die wichtigen Zeilen tun:

  • esp32_ble_tracker ist erforderlich, weil der Proxy davon abhängt.
  • interval gleich window lässt den ESP32 fast durchgehend scannen, damit weniger Sendungen verloren gehen.
  • bluetooth_proxy: active: true erlaubt Home Assistant zusätzlich, über diesen ESP32 Verbindungen zu Geräten aufzubauen. Ohne das leitet der Proxy nur Sendungen weiter (der Standardwert ist false).

Die ESPHome-Dokumentation vermerkt, dass die Zahl aktiver Verbindungen begrenzt ist: drei gleichzeitig, und ein Gerät, das eine Verbindung offen hält, belegt dauerhaft eine. Planen Sie mehr Proxys ein, wenn Sie viele verbundene Geräte nutzen.

Flashen und zu Home Assistant hinzufügen

Nutzen Sie den ESPHome Device Builder wie in unserem Mijia-Tutorial: Datei hinzufügen, auf Install klicken und das Board für das erste Flashen anstecken. Home Assistant erkennt das Gerät. Übernehmen Sie es mit Ihrem API-Schlüssel. Als fertige Option veröffentlicht ESPHome außerdem einen Bluetooth-Proxy-Installer, den Sie aus dem Browser flashen können.

Danach werden Bluetooth-Geräte in der Nähe des Proxys unter Einstellungen, Geräte & Dienste erkannt.

Wohin mit dem Proxy

  • Nah an den Geräten, nicht nah am Router.
  • Weg von Metall und großen Haushaltsgeräten.
  • Einer pro Bereich: Küche, Schlafzimmer, Garage. Bluetooth durchdringt Wände schlecht.
  • An einer stabilen Stromquelle; ein USB-Ladegerät ist perfekt.
  • Betreiben Sie nicht zu viele weitere Funktionen auf demselben Board: Der Bluetooth-Stack braucht viel RAM und teilt sich das Funkmodul mit dem WLAN.

Proxy oder Anwesenheitssensor?

Sie nutzen denselben ESP32 und dasselbe Funkmodul, tun aber Unterschiedliches. Ein Proxy gibt Home Assistant Zugriff auf Bluetooth-Geräte. Ein Anwesenheitssensor sagt Ihnen, ob ein Tag oder ein Smartphone in der Nähe ist. Für Letzteres lesen Sie unser Tutorial zum Bluetooth-Anwesenheitsmelder. Wollen Sie nur ein Thermometer auslesen, liest die Xiaomi-Mijia-Anleitung es direkt in ESPHome.

Fazit

Ein Bluetooth-Proxy ist der günstigste Weg, wackliges Bluetooth in Home Assistant zu reparieren, und Sie können mit Ihrem Zuhause weitere ergänzen. Flashen Sie ein Board, testen Sie es mit einem Sensor und fügen Sie dann eines dort hinzu, wo das Signal schwach ist.

Die Konfiguration wurde mit esphome config geprüft; mit Ihren Geräten wurde sie nicht getestet.

Quellen