Michael
der Shelly funktioniert nich ( habe ihn selber ausprobiert), was ging ist (https://www.amazon.de/dp/B0D8WDDGC3?ref=ppx_yo2ov_dt_b_fed_asin_title) dann ESPHome Bluetooth‑Proxy flashen .
ESP32 Bluetooth‑Proxy für Home Assistant – Schritt‑für‑Schritt
Diese Anleitung führt dich vom Auspacken deines ESP32 bis zur Verwendung als Bluetooth‑Proxy in Home Assistant. Sie ist für Windows 11 als Host und Home Assistant in VirtualBox optimiert.
0) Checkliste & Voraussetzungen
• Hardware: ESP32‑Board (z. B. NodeMCU‑32S/DevKitC), USB‑Kabel (Datenkabel!), 5 V‑USB‑Netzteil.
• Browser: Chrome oder Edge (WebSerial-Unterstützung).
• WLAN: 2,4 GHz aktiv (ESP32 kann kein 5 GHz). SSID & Passwort griffbereit.
• Home Assistant VM: Nach Möglichkeit Netzwerkmodus „Bridged Adapter“, damit die VM im gleichen Netz wie dein PC/ESP32 ist (mDNS/Auto‑Discovery funktioniert so zuverlässiger).
Tipp (VirtualBox): VM ausschalten → Einstellungen → Netzwerk → „Angeschlossen an“ = Bridged Adapter → passenden Netzwerkadapter auswählen → OK.
1) Windows‑Treiber & COM‑Port prüfen
- ESP32 per USB am PC anschließen.
- Geräte-Manager öffnen → Anschlüsse (COM & LPT). Du solltest einen Eintrag wie CP210x / USB‑SERIAL (COMx) oder CH340 (COMx) sehen.
- Fehlt der COM‑Port oder steht ein Ausrufezeichen da? → Treiber installieren:
o Silicon Labs CP210x (für viele DevKitC/NodeMCU‑32S)
o WCH CH34x (falls dein Board diesen USB‑Chip nutzt)
- Danach USB einmal ab‑/anstecken und Nummer des COM‑Ports merken (z. B. COM4).
Hinweis: Verwende ein Daten‑USB‑Kabel. Reine Lade‑Kabel führen oft zu „Kein Gerät gefunden“.
________________________________________
2) ESPHome Bluetooth‑Proxy flashen (Web‑Installer)
- Öffne https://esphome.github.io/bluetooth-proxies/ in Chrome/Edge.
- Klicke Install → wähle den COM‑Port deines ESP32.
- Falls der Connect hängen bleibt: BOOT gedrückt halten, RESET kurz tippen, BOOT weiter gedrückt halten bis „Connecting…“ erscheint, dann loslassen.
- Der Installer flasht die Bluetooth‑Proxy‑Firmware automatisch.
- Nach dem Flashen → Connect/Configure Wi‑Fi → trage WLAN‑SSID & Passwort ein.
- Optional: Gerätename vergeben (z. B. bt-proxy-wohnzimmer).
- Warten, bis „Wi‑Fi connected“/„Installation successful“ erscheint. Der ESP32 startet neu und hängt im WLAN.
Fehlerhilfe: Wenn kein Port erscheint, alle seriellen Tools (Arduino IDE, PlatformIO) schließen, anderes USB‑Kabel/USB‑Port testen, Treiber prüfen.
________________________________________
3) Aufstellen & Stromversorgung
• ESP32 dort platzieren, wo Bluetooth‑Geräte gut empfangen werden (zentral, 1–2 m hoch, weg von Metall/Router‑Antenne).
• Dauerhafte Versorgung über USB‑Netzteil (stabiler als PC‑USB‑Port).
• Du kannst mehrere ESP32 als Proxy einsetzen, um die Reichweite zu erhöhen.
________________________________________
4) In Home Assistant einbinden
- Home Assistant öffnen → Einstellungen → Geräte & Dienste.
- Warte kurz: ESPHome sollte das Gerät automatisch entdecken (mDNS). → Konfigurieren.
- Nicht automatisch gefunden? → Integration hinzufügen → ESPHome → Hostname/IP des ESP32 eintragen (z. B. bt-proxy-wohnzimmer.local oder die IP aus deinem Router).
- Nach der ESPHome‑Einbindung taucht in Einstellungen → Geräte & Dienste → Bluetooth ein „Entfernter Adapter“ auf (der Proxy). Stelle sicher, dass „Für aktive Scans verwenden“ bzw. „Bluetooth‑Proxy aktiv“ eingeschaltet ist.
Wichtig (VM‑Netz): Wenn Auto‑Discovery nicht klappt, liegt es fast immer an NAT in VirtualBox. Stelle auf Bridged um (siehe Schritt 0) und starte HA neu.
________________________________________
5) Funktionstest
• Öffne in HA die Bluetooth‑Integration → es sollten RSSI‑Einträge/entdeckte Geräte erscheinen.
• Schalte ein typisches BLE‑Gerät in die Nähe (z. B. Thermometer, Präsenzsensor), warte 1–2 Min. → es sollte auftauchen.
• In den Protokollen des ESPHome‑Geräts siehst du bei Bedarf Live‑Logs.
________________________________________
6) Updates & Verwaltung
Variante A (empfohlen): ESPHome‑Add‑on in HA installieren → Gerät erscheint im ESPHome‑Dashboard → Updates/Logs/Umbenennen bequem möglich (OTA).
Variante B: Web‑Installer erneut nutzen (gleich wie beim ersten Flash), z. B. für ein frisches Release.
________________________________________
7) Troubleshooting (Kurz & knackig)
Kein COM‑Port sichtbar: anderes USB‑Kabel (Datenfähig), anderen USB‑Port, Treiber (CP210x/CH34x) installieren, Geräte‑Manager prüfen.
Web‑Installer findet den ESP32 nicht: Browser mit WebSerial (Chrome/Edge), serielle Monitore geschlossen, BOOT/RESET‑Kombination nutzen, ggf. anderen Rechner testen.
ESP32 verbindet nicht mit WLAN: 2,4 GHz aktiv; SSID/Passwort korrekt; Sonderzeichen testen; DHCP aktiv; Gast‑WLAN isoliert? → normales WLAN nutzen.
In HA nicht sichtbar: VirtualBox‑Netz auf Bridged, HA & ESP32 neu starten, Firewall/Multicast (mDNS) im Netz zulassen, zur Not die IP manuell in der ESPHome‑Integration eintragen.
Bluetooth‑Reichweite schwach: ESP32 umplatzieren (höher, freie Sicht), Abstand zu dicken Wänden/Metall, mehrere Proxies einsetzen.
________________________________________
8) Optional: Eigene YAML‑Konfiguration (Feinschliff)
Wenn du später im ESPHome‑Dashboard mehr Kontrolle willst, kannst du den Proxy als reguläres ESPHome‑Projekt anlegen. Beispiel‑YAML:
esphome:
name: bt-proxy-wohnzimmer
esp32:
board: esp32dev
framework:
type: arduino
logger:
api:
encryption:
key: "<dein_api_key>"
ota:
wifi:
ssid: "<deine_ssid>"
password: "<dein_passwort>"
ap: {}
bluetooth_proxy:
active: true
Danach per Installieren → OTA aufspielen. Der Proxy bleibt weiterhin voll funktionsfähig.
________________________________________
9) Was du jetzt direkt machen kannst
- Heute: ESP32 flashen (5–10 Min).
- In HA einbinden und testen (5 Min).
- Position feinjustieren & ggf. 2. Proxy einplanen (optional).
Fertig! 🎉 Ab jetzt bekommst du Bluetooth in Home Assistant stabil – ganz ohne VirtualBox‑USB‑Ärger.