Bluetooth-Reichweite in Home Assistant mit einem ESP32 erweitern¶

Veröffentlicht am 22. August 2026 · Geschätzte Lesezeit: 5 Minuten

Ein ESPHome-Bluetooth-Proxy empfängt Bluetooth-Low-Energy-Signale in seiner Nähe und leitet sie über das Heimnetz an Home Assistant weiter. Das hilft besonders bei entfernten Sensoren oder einer virtuellen Home-Assistant-Installation ohne zuverlässiges USB-Bluetooth. Einrichtung und Platzierung dauern ungefähr 20 bis 30 Minuten.

Voraussetzungen

Eine aktuelle Home-Assistant-Installation mit Bluetooth- und ESPHome-Integration
Ein gewöhnliches ESP32-Board mit USB-Kabel
Ein Computer mit unterstütztem Browser und USB-Anschluss
Ein 2,4-GHz-WLAN mit WPA2 oder WPA3
Ein unterstütztes Bluetooth-Low-Energy-Gerät zum Testen

1. Geeignetes ESP32-Board prüfen¶

Verwende für die einfache Webinstallation einen gewöhnlichen ESP32. Die Option Generic ESP32 der offiziellen Projektseite gilt ausdrücklich nicht für ESP32-C3 und andere Varianten. Bei abweichender Hardware wählst du nur ein Modell, das auf der offiziellen Projektseite aufgeführt ist.

Nur Bluetooth Low Energy

Der Proxy unterstützt BLE-Geräte. Klassische Bluetooth-Geräte wie viele Lautsprecher oder Kopfhörer werden dadurch nicht automatisch mit Home Assistant kompatibel.

2. Sicheren Rückweg vorbereiten¶

Erstelle vor der Änderung unter Einstellungen → System → Sicherungen eine vollständige Home-Assistant-Sicherung und lade sie zusätzlich auf einen zweiten Speicherort herunter.

Notiere die genaue ESP32-Modellbezeichnung. Falls die Einrichtung scheitert, kannst du das Board per USB erneut flashen; bestehende Home-Assistant-Geräte werden durch diesen Rückweg nicht gelöscht.

3. Offizielles Proxy-Projekt öffnen¶

Verbinde den ESP32 per USB mit deinem Computer. Öffne anschließend im Browser die offizielle ESPHome-Projektseite, wähle Bluetooth proxy und danach Generic ESP32 oder dein exakt aufgeführtes Board.

Klicke auf Install, wähle den erkannten seriellen Anschluss und bestätige das Löschen sowie Flashen. Trenne das USB-Kabel während des Vorgangs nicht.

Richtiges USB-Gerät auswählen

Beim Flashen wird der ausgewählte Mikrocontroller überschrieben. Wähle nur den angeschlossenen ESP32 und niemals ein anderes serielles Gerät.

4. WLAN einrichten¶

Nach erfolgreichem Flashen wählst du Connect to Wi-Fi und übermittelst SSID sowie Passwort deines 2,4-GHz-Heimnetzes. Diese Werte werden nur in den vorgesehenen Einrichtungsdialog eingetragen und gehören nicht in Screenshots oder öffentliche Anleitungen.

Warte, bis das Gerät eine Netzwerkverbindung meldet. Benenne den Proxy eindeutig nach seinem Standort, zum Beispiel bluetooth-proxy-flur.

Kein ungeschütztes Geräte-WLAN

Betreibe den ESP32 nur in einem mit WPA2 oder WPA3 geschützten Netz. ESPHome-Geräte sind für vertrauenswürdige Heimnetze gedacht und dürfen nicht direkt aus dem Internet erreichbar sein.

5. ESPHome-Gerät in Home Assistant hinzufügen¶

Öffne Einstellungen → Geräte & Dienste. Home Assistant sollte das neue ESPHome-Gerät automatisch entdecken. Wähle Konfigurieren, bestätige die Aufnahme und ordne das Gerät dem Raum zu, in dem der Proxy später steht.

Wird nichts entdeckt, wähle Integration hinzufügen → ESPHome und trage den Hostnamen oder die lokale IP-Adresse des Proxys ein. Eine Portfreigabe im Router ist dafür nicht erforderlich.

6. Proxy-Konfiguration kontrollieren¶

Nach einer Übernahme in den ESPHome Device Builder kannst du die Geräte-YAML ansehen. Ersetze nicht die vollständige, automatisch erzeugte Datei. Kontrolliere nur, ob sinngemäß diese beiden Blöcke vorhanden sind:

esp32_ble_tracker:

bluetooth_proxy:
  active: true

esp32_ble_tracker empfängt BLE-Signale. bluetooth_proxy reicht sie an Home Assistant weiter; aktive Verbindungen sind in der aktuellen Komponente standardmäßig eingeschaltet.

Keine aggressiven Scanwerte kopieren

Die offiziellen Standardwerte sind für die meisten Installationen empfohlen. Kürzere Intervalle erhöhen CPU-Last und Netzwerkverkehr und können WLAN- oder Temperaturprobleme verursachen.

7. Sicherheitsfunktionen nicht entfernen¶

Die automatisch erzeugte Konfiguration soll eine verschlüsselte ESPHome-API und einen geschützten OTA-Zugang verwenden. Entferne die generierten Schlüssel und Passwörter nicht. Geheime Werte gehören in secrets.yaml und niemals in Git oder einen öffentlichen Beitrag.

Falls du eine manuelle Konfiguration prüfst, muss sie sinngemäß geschützte Einträge enthalten:

api:
  encryption:
    key: !secret bluetooth_proxy_api_key

ota:
  - platform: esphome
    password: !secret bluetooth_proxy_ota_password

Die Platzhalter hinter !secret verweisen auf lokal gespeicherte Geheimnisse. Kopiere keine Beispielschlüssel; lasse ESPHome für jedes Gerät eigene Werte erzeugen.

8. Standort und Scanmodus optimieren¶

Stelle den Proxy in die Nähe der betroffenen BLE-Geräte, aber möglichst mindestens drei Meter von Router, Switch, Serverrack und anderen starken Störquellen entfernt auf. Metallgehäuse und Schränke schwächen den Empfang.

Öffne das ESPHome-Gerät in Einstellungen → Geräte & Dienste, wähle Konfigurieren und lasse den Bluetooth-Scanmodus zunächst auf Auto. Dieser Modus schaltet nur bei Bedarf kurz auf aktives Scannen und schont dadurch die Batterien umliegender BLE-Geräte.

9. Funktion prüfen¶

Öffne Einstellungen → Geräte & Dienste → Bluetooth und kontrolliere, ob der Proxy als entfernter Adapter erscheint. Bringe danach einen unterstützten BLE-Sensor in seine Nähe.

Warte einige Minuten und prüfe, ob Home Assistant das Gerät entdeckt oder dessen vorhandene Entitäten wieder regelmäßig aktualisiert. ESPHome selbst entschlüsselt die Sensordaten nicht; dafür muss in Home Assistant eine passende Geräteintegration vorhanden sein.

10. Backup, Update und Rückweg¶

Nimm den ESPHome Device Builder und seine Konfigurationsdateien in deine Home-Assistant- Sicherungen auf. Bewahre insbesondere secrets.yaml geschützt auf, weil ohne die Schlüssel spätere API- und OTA-Verbindungen scheitern können.

Installiere Firmware-Updates über den ESPHome Device Builder zunächst per OTA. Bleibt das Gerät danach offline, verbinde es per USB und flashe das offizielle Bluetooth-Proxy-Projekt erneut. Entferne den alten Geräteeintrag erst, wenn der Proxy dauerhaft ersetzt werden soll.

Geheimnisse nicht mit der YAML veröffentlichen

Eine Geräte-YAML kann geteilt werden, secrets.yaml dagegen nicht. Nach versehentlicher Veröffentlichung müssen WLAN-Passwort, API-Schlüssel und OTA-Passwort geändert werden.

11. Typische Fehler¶

Der Browser findet keinen seriellen Anschluss: Verwende ein Daten- statt reines Ladekabel, installiere bei Bedarf den USB-Seriell-Treiber und schließe andere Programme mit Zugriff auf den Port.
ESP32 verbindet sich nicht mit WLAN: Prüfe SSID, Passwort und 2,4-GHz-Abdeckung; viele klassische ESP32-Boards unterstützen kein 5-GHz-WLAN.
Home Assistant entdeckt den Proxy nicht: Prüfe, ob beide Geräte dasselbe erreichbare Netz nutzen und mDNS oder TCP-Port 6053 nicht durch VLAN-Regeln blockiert wird.
Sensor wird trotz Proxy nicht angezeigt: Prüfe, ob es sich um BLE handelt und ob Home Assistant eine passende Integration für das Gerät besitzt.
Verbindung ist instabil: Vergrößere den Abstand zu Router, Switch und Metallflächen und lasse die Scanparameter auf Standard.

12. Quellen und Videos¶

Fertig¶

Der ESP32 erweitert jetzt die BLE-Abdeckung von Home Assistant. Kontrolliere den Proxy unter Einstellungen → Geräte & Dienste → Bluetooth und beobachte einen entfernten Testsensor. Kommen dessen Werte nach einem Neustart von ESP32 und Home Assistant wieder an, funktioniert die Verbindung dauerhaft.