Home ShellyShelly als Bluetooth-Proxy: BTHome-Geräte in Home Assistant einrichten

Shelly als Bluetooth-Proxy: BTHome-Geräte in Home Assistant einrichten

by Dimitri Roschkowski
0 Kommentare

Fast jeder Shelly ab der zweiten Generation hat einen Bluetooth-Chip an Bord. Den kannst du als Shelly Bluetooth-Proxy nutzen: Der Shelly hört die Funksignale von Thermometern, Tasten und Sensoren in seiner Nähe mit und reicht sie per WLAN an Home Assistant weiter. So landen BTHome-Geräte in Home Assistant, ohne dass dein Server selbst Bluetooth braucht und ohne dass er im selben Raum stehen muss.

Die Einstellungen dazu sind verwirrend: In der Shelly-Oberfläche gibt es „Enable“, „Enable RPC“, „Bluetooth device control“, Gateway-Funktionen und BTHome-Komponenten. Die gute Nachricht vorweg: Für Home Assistant musst du am Shelly selbst fast nichts einschalten. Welcher Schalter wirklich zählt, zeige ich Schritt für Schritt mit Screenshots aus meinem eigenen Setup.

Smarte Zwischensteckdose an der Wand sendet Funkwellen zu einem Thermometer im Regal und einem Funktaster auf dem Tisch
Eine Shelly-Steckdose als Bluetooth-Proxy empfängt die Funksignale von Sensoren in der Nähe. (Symbolbild, KI-generiert)

Das Wichtigste in Kürze

  • Der entscheidende Schalter sitzt in Home Assistant, nicht im Shelly: Einstellungen → Geräte & Dienste → Shelly → Zahnrad am Gerät → Bluetooth-Scannermodus auf Auto.
  • Am Shelly musst du nichts ankreuzen. Home Assistant schaltet Bluetooth bei Bedarf selbst ein und spielt ein kleines Skript auf. Ab Shelly-Firmware 2.0 gibt es den alten „Enable“-Haken gar nicht mehr.
  • „Enable RPC“ bzw. „Bluetooth device control“ brauchst du nicht. Das ist die Fernsteuerung des Shelly per Handy über Bluetooth und hat mit dem Proxy nichts zu tun.
  • Voraussetzungen: Shelly Gen2, Gen3 oder Gen4 mit Netzstrom (keine Batteriegeräte), eingebunden über die Shelly-Integration (nicht über Matter), für Auto und Aktiv Firmware ab 1.5.1.
  • Ergebnis: BTHome-Geräte wie Shelly BLU tauchen über die Integration BTHome auf, Govee-Thermometer über Govee Bluetooth. Beides findet Home Assistant automatisch.
  • Grenze: Shellys leiten nur Funk-Ankündigungen weiter. Geräte, die eine feste Bluetooth-Verbindung brauchen (etwa viele Bluetooth-Lampen), gehen damit nicht.

Was ist ein Bluetooth-Proxy, was ist BTHome?

Viele kleine Sensoren funken per Bluetooth Low Energy (BLE), der stromsparenden Bluetooth-Variante. Sie bauen dabei meist keine Verbindung auf, sondern senden alle paar Sekunden eine kurze Ankündigung in den Raum, ein sogenanntes Advertisement. Darin stecken Messwerte wie Temperatur, Luftfeuchte oder Akkustand. Jeder Empfänger in Reichweite kann das mithören.

Ein Bluetooth-Proxy ist so ein Empfänger, der das Gehörte weiterleitet. Home Assistant nennt das „Remote-Adapter“. Der Proxy versteht die Daten selbst nicht. Er schickt sie roh an Home Assistant, und dort entscheidet die passende Integration, was damit passiert. Laut Home-Assistant-Doku können Shellys ab Gen2 genau das: Advertisements empfangen und gebündelt weiterleiten. Aktive Verbindungen zu Geräten bauen sie nicht auf.

BTHome ist ein offenes Datenformat für solche Advertisements. Shelly nutzt es für seine BLU-Reihe (Taster, Tür-/Fensterkontakt, Bewegungsmelder, BLU H&T), und viele Bastelprojekte senden ebenfalls BTHome. In Home Assistant ist dafür die Integration BTHome zuständig. Andere Hersteller haben eigene Formate: Govee-Thermometer zum Beispiel landen über die Integration Govee Bluetooth. Für den Shelly-Proxy spielt das keine Rolle, er reicht alles weiter.

Bluetooth-Proxy für Home Assistant Shelly-eigene BLU-/BTHome-Funktion
Wofür Home Assistant empfängt alle BLE-Sensoren in Reichweite der Shelly selbst wertet einzelne BLU-Geräte aus, z. B. ein BLU-Taster schaltet direkt das Relais
Wo einschalten in Home Assistant: Bluetooth-Scannermodus in der Shelly-App oder Web-Oberfläche: Gerät koppeln bzw. als Komponente hinzufügen
Welche Geräte alles, was eine HA-Integration versteht: BTHome, Govee, Xiaomi und viele mehr nur Shelly BLU bzw. BTHome-Geräte
Für HA nötig? ja nein

Die rechte Spalte brauchst du nur, wenn der Shelly auch ohne Home Assistant auf einen BLU-Taster reagieren soll. Für diesen Artikel ist sie unwichtig.

Voraussetzungen

  • Home Assistant läuft. Falls noch nicht: Home Assistant einrichten.
  • Ein Shelly ab Gen2 mit Netzstrom, also Plus-, Pro-, Gen3- oder Gen4-Geräte wie Steckdosen, Unterputz-Relais oder der BLU Gateway. Batteriebetriebene Shellys (z. B. H&T) können kein Proxy sein, Gen1-Geräte haben kein Bluetooth.
  • Eingebunden über die Shelly-Integration. Die Proxy-Funktion steckt in dieser Integration. Hast du den Shelly per Matter eingebunden, gibt es die Option nicht. Den Unterschied erkläre ich in Shelly normal, mit Matter oder mit Zigbee. Gen4-Geräte im Zigbee-Modus fallen laut Home-Assistant-Code ebenfalls raus.
  • Aktuelle Firmware. Für die Modi Auto und Aktiv verlangt Home Assistant mindestens Firmware 1.5.1, sonst erscheint unter Einstellungen → Reparaturen ein Hinweis. Wie das Update klappt, steht in Shelly-Firmware manuell aktualisieren.

Schritt 1: Am Shelly – was du wirklich einschalten musst

Kurz gesagt: nichts. Trotzdem lohnt ein Blick in die Weboberfläche, damit dich die Schalter nicht verwirren. Öffne dazu die IP-Adresse des Shelly im Browser und gehe auf Settings → Bluetooth. Je nach Firmware sieht die Seite unterschiedlich aus.

Firmware 2.x: kein Bluetooth-Schalter mehr

Shelly Web-Oberfläche mit Firmware 2.1: Bluetooth settings mit Status Active – scanning for BLU devices und dem Haken Enable Bluetooth device control (aus)
Shelly Plug S Gen3 mit Firmware 2.1.1: Bluetooth ist aktiv, obwohl kein Haken gesetzt ist. „Enable Bluetooth device control“ bleibt aus. (MAC-Adresse entfernt)

Mit Firmware 2.0 hat Shelly den globalen Bluetooth-Schalter entfernt. Im offiziellen Changelog steht das als „Breaking Change“: Bluetooth schaltet sich jetzt automatisch ein, wenn es gebraucht wird, etwa für BLU-Sensoren oder Skripte. Genau so steht es auch auf der Seite. Bei meiner Steckdose meldet sie „Active — scanning for BLU devices“, weil Home Assistant das Proxy-Skript gestartet hat.

Der einzige Haken heißt „Enable Bluetooth device control“. Damit dürfen gekoppelte Geräte den Shelly über Bluetooth steuern, zum Beispiel die Shelly-App auf dem Handy. Für den Proxy brauchst du das nicht. Lass es aus: Was nicht an ist, kann auch nicht angegriffen werden.

Firmware 1.x: „Enable“ und „Enable RPC“

Shelly Web-Oberfläche mit älterer Firmware: Bluetooth settings mit den Haken Enable und Enable RPC
Ältere Firmware (hier eine Plug M Gen3): zwei Haken, „Enable“ und „Enable RPC“. Dieses Gerät ist bei mir bewusst kein Proxy, deshalb ist Bluetooth aus. (MAC-Adresse entfernt)

Auf älterer Firmware gibt es zwei Haken. „Enable“ schaltet das Bluetooth-Funkmodul ein. „Enable RPC“ erlaubt die Steuerung per Bluetooth, das Gleiche wie „Bluetooth device control“ oben. Auch hier musst du nichts von Hand setzen: Wählst du in Home Assistant einen Scannermodus, prüft die Shelly-Integration, ob Bluetooth aus ist, schaltet es ein (RPC bleibt dabei aus) und startet den Shelly bei Bedarf neu. So steht es im Quellcode der Bibliothek, die Home Assistant für Shelly verwendet.

Was du am Shelly nicht brauchst

„Enable RPC“ / „Bluetooth device control“, den Menüpunkt zum Koppeln von BLU-Geräten, BTHome-Komponenten unter „Components“ und die Gateway-Funktion in der Shelly-App. Das alles ist für Shelly-interne Automationen oder die Shelly-Cloud gedacht. Home Assistant liest die Sensoren über den Proxy selbst aus.

Schritt 2: In Home Assistant den Bluetooth-Scannermodus wählen

Jetzt kommt der Schalter, auf den es ankommt:

  1. Einstellungen → Geräte & Dienste öffnen und auf Shelly klicken.
  2. Beim gewünschten Shelly auf das Zahnrad klicken (Konfigurieren).
  3. Unter Bluetooth-Scannermodus eine Option wählen, im Normalfall Auto, dann OK.
Home Assistant Optionen der Shelly-Integration mit Bluetooth-Scannermodus: Deaktiviert, Auto, Aktiv und Passiv
Der Optionen-Dialog eines Shelly in Home Assistant. Hier entscheidet sich, ob der Shelly als Bluetooth-Proxy arbeitet.

Die vier Modi laut Home-Assistant-Doku:

Modus Was passiert Wann sinnvoll
Deaktiviert Der Shelly scannt nicht. Shelly soll kein Proxy sein.
Auto Hört passiv zu und fragt nur bei Bedarf kurz aktiv nach. Empfehlung für fast alle. Spart laut Doku rund 95 % des scanbedingten Batterieverbrauchs der Sensoren.
Aktiv Fragt Geräte ständig nach allen Infos. Wenn Geräte mit Auto nicht gefunden werden. Schnellste Updates, mehr Batterieverbrauch bei den Sensoren.
Passiv Hört nur zu, fragt nie nach. Wenn es reicht. Am sparsamsten, manche Integrationen bekommen aber nicht alle Daten.

„Aktiv“ heißt hier: Der Shelly schickt eine Rückfrage an den Sensor, der dann ein zweites Datenpaket sendet. Das kostet den Sensor etwas Batterie. Manche Geräte brauchen das. Die Doku der Integration Govee Bluetooth nennt zum Beispiel beim Thermometer H5075 „Active scans required“. Bei mir laufen die Shellys derzeit auf Passiv, und meine H5075 liefern trotzdem Werte. Klappt die Erkennung bei dir nicht, stell auf Auto oder Aktiv.

Nach dem Speichern lädt Home Assistant ein kleines Skript auf den Shelly. Du findest es in der Shelly-Oberfläche unter Scripts als aioshelly_ble_integration.

Shelly Web-Oberfläche, Bereich Script: Skript aioshelly_ble_integration läuft
Dieses Skript hat Home Assistant selbst installiert. Es sammelt die Bluetooth-Daten und schickt sie weiter. Nicht löschen.

Dass „Run on startup“ ausgeschaltet ist, ist kein Fehler. Home Assistant startet das Skript selbst, sobald es sich mit dem Shelly verbindet.

Schritt 3: Prüfen, ob der Proxy läuft

Unter Einstellungen → Konnektivität → Bluetooth zeigt Home Assistant alle Empfänger. Ein Klick auf Adapter listet sie auf. Jeder Shelly, der als Proxy arbeitet, steht hier mit seinem Scanmodus.

Home Assistant Bluetooth-Adapter-Liste mit mehreren Shelly-Geräten im Modus Passives Scannen
Mehrere Shellys als Bluetooth-Adapter in meinem Home Assistant. „Keine Verbindungszeitschlitze“ ist normal: Shellys bauen keine aktiven Verbindungen auf. (Geräte-IDs entfernt)

Auf derselben Seite findest du unter Advertisements alle Funk-Ankündigungen, die gerade ankommen. Taucht dein Sensor dort auf, ist der Funkweg in Ordnung. Fehlt er, liegt das Problem bei Reichweite oder Sensor, nicht bei Home Assistant.

Schritt 4: BTHome-Geräte und Thermometer in Home Assistant hinzufügen

Sobald ein Proxy läuft, erkennt Home Assistant unterstützte Sensoren von selbst. Sie erscheinen unter Einstellungen → Geräte & Dienste oben im Bereich Entdeckt. So sah das bei einem meiner Govee-Thermometer aus:

Home Assistant hat ein Govee H5075 entdeckt, Karte Govee Bluetooth mit Ignorieren und Hinzufügen
Entdeckt: ein Govee-Thermometer H5075. Ein Klick auf „Hinzufügen“ reicht.
  1. Auf Hinzufügen klicken und die Frage „Möchtest du … einrichten?“ mit OK bestätigen.
  2. Einen Gerätenamen vergeben und einen Bereich (Raum) wählen, dann Fertigstellen.
  3. Fertig. Auf der Geräteseite stehen jetzt Temperatur, Luftfeuchtigkeit und Batteriestand.
Home Assistant Dialog Benennen und zuordnen für ein Govee H5075 mit Gerätename und Bereich Schlafzimmer
Name und Raum vergeben – danach ist das Thermometer eingerichtet.
Home Assistant Geräteseite eines Govee H5075 mit Batterie 100 Prozent, Luftfeuchtigkeit 56,1 Prozent und Temperatur 16,7 Grad
Das Ergebnis: Messwerte über den Shelly-Proxy, ohne Cloud. (MAC-Adresse entfernt)

Bei Shelly-BLU-Geräten und anderen BTHome-Sensoren läuft es genauso, nur über die Integration BTHome. Zwei Besonderheiten:

  • Aufwecken: Taster und Kontakte senden nur, wenn etwas passiert. Drück den Knopf oder öffne den Kontakt einmal, damit Home Assistant das Gerät sieht.
  • Verschlüsselung: BTHome kann verschlüsselt senden. Dann fragt Home Assistant beim Einrichten nach dem Bindkey, einem 32-stelligen Schlüssel. Den legst du beim Aktivieren der Verschlüsselung fest, bei Shelly-BLU-Geräten in der Regel über die Shelly-App.
Home Assistant Integrationsseite BTHome mit 4 Geräten, darunter ein BTHome sensor
Die BTHome-Integration mit meinen Shelly-BLU-Geräten.

Für Govee-Thermometer ist die Integration Govee Bluetooth zuständig. Wie sich das H5075 im Alltag schlägt, steht im Test des Govee-Thermometers.

Home Assistant Integrationsseite Govee Bluetooth mit mehreren H5075-Thermometern
Mehrere Govee H5075 in der Integration Govee Bluetooth, alle über Shelly-Proxys empfangen.

Reichweite und Platzierung

Ein Shelly-Proxy hört nur, was in seiner Funkreichweite liegt. Wie weit das ist, hängt stark vom Gebäude ab: Stahlbeton, Fußbodenheizung und Metall dämpfen Bluetooth deutlich mehr als Holz oder Trockenbau. Ein paar Regeln aus der Praxis:

  • Mehrere Proxys nutzen. Jeder Shelly kann Proxy sein, und Home Assistant nutzt alle gleichzeitig. Zwei, drei verteilte Steckdosen decken eine Wohnung meist besser ab als ein starker Empfänger.
  • Zwischenstecker sind ideale Proxys. Sie sitzen offen im Raum, oft mitten zwischen den Sensoren.
  • Shellys im Verteilerkasten sind schlechte Proxys. Ein Metallgehäuse schirmt Funk ab. Ein Pro-Gerät im Schaltschrank empfängt deshalb oft nur wenig.
  • Abstand zwischen Proxys halten. Die Home-Assistant-Doku rät, mehrere Empfänger so zu verteilen, dass sie sich nicht gegenseitig stören.
  • WLAN muss stabil sein. Der Shelly schickt die Daten per WLAN weiter. Bei schwachem Empfang kommen auch die Sensordaten verzögert an.

Fehlersuche: Wenn keine Geräte auftauchen

Problem Ursache Lösung
Kein Zahnrad bzw. keine Scanner-Option beim Shelly Gen1-Gerät, Batteriegerät, Matter-Einbindung oder Gen4 im Zigbee-Modus Netzbetriebenen Gen2+-Shelly über die Shelly-Integration einbinden
Shelly fehlt in der Adapter-Liste Scannermodus steht auf „Deaktiviert“ Modus auf Auto stellen, Shelly ggf. neu starten
Reparatur-Hinweis zur Firmware Firmware älter als 1.5.1 Firmware aktualisieren oder vorerst Passiv nutzen
Sensor erscheint nicht unter „Entdeckt“ zu weit weg, schläft oder braucht aktiven Scan Advertisements prüfen, Taste drücken, Modus Auto oder Aktiv, näheren Proxy nutzen
BTHome-Gerät fragt nach Bindkey Verschlüsselung ist an Schlüssel aus der Shelly-App eintragen oder Verschlüsselung ausschalten
Werte kommen nur sporadisch schwacher Funk oder schwaches WLAN am Proxy Proxy näher an den Sensor oder ins WLAN-Zentrum, weiteren Proxy ergänzen
Bluetooth-Lampe o. Ä. lässt sich nicht steuern braucht eine aktive Verbindung, die Shellys nicht können ESP32 mit ESPHome als Bluetooth-Proxy nutzen

Für Geräte, die eine echte Verbindung brauchen, ist ein ESP32 mit ESPHome die bessere Wahl. Wie das geht, steht in ESPHome einrichten, und warum das bei Govee-Lampen trotzdem nur eine Notlösung ist, in Govee in Home Assistant einbinden.

Passende Geräte

Netzbetriebene Shellys ab Gen2 taugen als Proxy, dazu Sensoren, die Home Assistant über Bluetooth versteht:

* Affiliate-Links: Als Amazon-Partner verdienen wir an qualifizierten Käufen. Bitte prüfe die Kompatibilität mit deinem System.

Fazit

Der Shelly Bluetooth-Proxy ist eine der praktischsten Funktionen für Home Assistant, weil die Hardware meist schon in der Wand oder Steckdose sitzt. Am Shelly selbst musst du nichts aktivieren, schon gar nicht „Enable RPC“. Wichtig ist nur der Bluetooth-Scannermodus in den Optionen der Shelly-Integration. Steht der auf Auto, erscheinen BTHome-Sensoren und Govee-Thermometer von selbst unter „Entdeckt“ und sind nach zwei Klicks eingerichtet.

Häufige Fragen

Muss ich am Shelly „Enable RPC“ für den Bluetooth-Proxy einschalten?

Nein. „Enable RPC“ (bei neuer Firmware „Bluetooth device control“) erlaubt nur die Steuerung des Shelly per Bluetooth. Für den Proxy reicht der Scannermodus in Home Assistant.

Wie kann ich bei Shelly Bluetooth aktivieren?

Ab Firmware 2.0 gar nicht mehr von Hand, Bluetooth schaltet sich bei Bedarf selbst ein. Bei älterer Firmware gibt es unter Settings → Bluetooth den Haken „Enable“. Für Home Assistant musst du ihn nicht setzen, das erledigt die Shelly-Integration beim Wählen des Scannermodus.

Welche Shellys eignen sich als Bluetooth-Proxy?

Alle Shellys ab Gen2 mit Netzstrom, also Plus-, Pro-, Gen3- und Gen4-Geräte. Batteriegeräte und die erste Generation nicht.

Brauche ich den Shelly BLU Gateway für BTHome in Home Assistant?

Nein. Jeder passende Shelly kann Proxy sein. Der BLU Gateway Gen3 arbeitet ebenfalls als Proxy und bietet sich an, wenn in einem Bereich kein anderer Shelly sitzt.

Warum findet Home Assistant mein BTHome-Gerät nicht?

Meist ist es zu weit weg vom nächsten Proxy oder hat noch nichts gesendet. Drück eine Taste am Gerät und schau unter Einstellungen → Konnektivität → Bluetooth → Advertisements, ob es ankommt. Ist es verschlüsselt, brauchst du den Bindkey.

Kann der Shelly-Proxy Bluetooth-Lampen steuern?

Nein. Shellys leiten nur Advertisements weiter und bauen keine aktiven Verbindungen auf. Dafür brauchst du einen ESP32 mit ESPHome als Proxy.

Funktioniert der Bluetooth-Proxy, wenn der Shelly per Matter eingebunden ist?

Nein. Die Proxy-Funktion gehört zur Shelly-Integration von Home Assistant. Du kannst einen Shelly aber parallel über die Shelly-Integration einbinden.

Quellen

You may also like

Hinterlasse einen Kommentar