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

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.

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.

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_trackerist erforderlich, weil der Proxy davon abhängt.intervalgleichwindowlässt den ESP32 fast durchgehend scannen, damit weniger Sendungen verloren gehen.bluetooth_proxy: active: trueerlaubt Home Assistant zusätzlich, über diesen ESP32 Verbindungen zu Geräten aufzubauen. Ohne das leitet der Proxy nur Sendungen weiter (der Standardwert istfalse).
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
- ESPHome: Bluetooth-Proxy (auf Englisch)
- Home Assistant: Bluetooth (auf Englisch)
- ESPHome: Projekte mit Bluetooth-Proxy-Unterstützung (auf Englisch)
- Omar Ghader, How to monitor your home temperature with ESP32 and Xiaomi Mijia using ESPHome (auf Englisch)