ESPHome-Tutorial: Bluetooth-Anwesenheitsmelder mit einem ESP32

„Ist jemand zu Hause?" ist die Frage hinter den meisten Smart-Home-Automatisierungen: Licht aus, wenn das Haus leer ist, Heizung an, bevor Sie ankommen. Ein günstiger ESP32 kann sie beantworten, indem er Bluetooth-Geräte abhört: Ihr Smartphone, eine Smartwatch oder ein 5-Euro-Tag am Schlüsselbund.

Was Sie brauchen
- Ein ESP32 DevKit: das ESP32 DevKit. Das 3er-Pack passt gut zu diesem Projekt: ein Board pro Raum. Das ESP32-S3 N16R8 hat mehr Speicher, wenn Sie viele Sensoren betreiben.
- Etwas, das erkannt werden soll: ein BLE-Tag, eine Smartwatch oder ein Fitnessarmband, oder Ihr Smartphone.
- Ein USB-Datenkabel.

Schritt 1: sehen, was in der Nähe ist
Beginnen Sie mit dem Scanner. Fügen Sie dies einer minimalen Konfiguration hinzu und öffnen Sie das Log:
esp32_ble_tracker:
text_sensor:
- platform: ble_scanner
name: "BLE devices nearby"
Der ble_scanner-Sensor listet Geräte in der Nähe mit ihrer MAC-Adresse auf. Gehen Sie mit Ihrem Tag herum und sehen Sie, welche Adresse erscheint und verschwindet. Das ist die gesuchte.
Schritt 2: die Anwesenheitskonfiguration
esphome:
name: hallway-presence
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: false
binary_sensor:
# A BLE tag, a smartwatch, a fitness band: it keeps the same MAC address
- platform: ble_presence
mac_address: "AA:BB:CC:DD:EE:FF"
name: "Keys tag present"
timeout: 2min
min_rssi: -85dB
# An iPhone or modern Android phone: its address changes, so use the IRK
- platform: ble_presence
irk: "0123456789abcdef0123456789abcdef"
name: "Phone present"
sensor:
- platform: ble_rssi
mac_address: "AA:BB:CC:DD:EE:FF"
name: "Keys tag signal"
text_sensor:
- platform: ble_scanner
name: "BLE devices nearby"
Was die einzelnen Teile tun:
ble_presenceist ein binärer Sensor: an, wenn das Gerät zu hören ist, aus, wenn es nach demtimeoutnicht mehr zu hören war.min_rssi: -85dBignoriert sehr schwache Signale, damit ein Tag in der Nachbarwohnung nicht zählt.ble_rssiveröffentlicht die Signalstärke. Mit einem ESP32 pro Raum zeigt der mit dem stärksten Wert den Raum an.scan_parametersmitintervalgleichwindowlässt den ESP32 fast durchgehend scannen.active: falsehält den Scan passiv: Es wird nichts gesendet.
Smartphones: das Problem mit der MAC-Adresse
Aktuelle iPhones und Android-Smartphones nutzen aus Datenschutzgründen eine zufällige, wechselnde MAC-Adresse. Eine feste mac_address funktioniert dafür nicht. Zwei Lösungen:
- Den IRK nutzen (Identity Resolving Key), einen geheimen Schlüssel, mit dem ESPHome das Smartphone trotz wechselnder Adresse erkennt. Ihn zu beschaffen erfordert Kopplungsdaten vom Smartphone und ist unter iOS nicht trivial.
- Einen eigenen Tag oder eine Smartwatch nutzen: Sie behalten eine stabile Adresse. Das ist einfacher und zuverlässiger, und es ist meine Empfehlung.
Flashen und testen
docker run --rm -p 6052:6052 -v "$PWD/config":/config esphome/esphome
Installieren Sie, warten Sie auf das WLAN, gehen Sie dann außer Reichweite und zurück. Nach dem Timeout schaltet der Sensor auf aus und danach wieder auf an.

Home Assistant
Die Sensoren erscheinen automatisch. Legen Sie eine Automatisierung an wie „wenn 10 Minuten lang niemand anwesend ist, Licht ausschalten". Für Räume vergleichen Sie die ble_rssi-Werte mehrerer ESP32-Boards.
Grenzen, die Sie kennen sollten
- Die Reichweite liegt bei etwa 10 Metern, Wände verringern sie. Testen Sie und passen Sie
min_rssian. - Der BLE-Stack braucht viel RAM und teilt sich das Funkmodul mit dem WLAN. Packen Sie nicht zu viele Funktionen auf ein einzelnes Board.
- Datenschutz: Personen über ihre Geräte zu erkennen, sind vielerorts personenbezogene Daten. Nutzen Sie es zu Hause und mit Einverständnis der Betroffenen.
- Anwesenheit ist eine gute Schätzung, kein Beweis. Ein auf dem Tisch vergessener Tag sagt, dass jemand zu Hause ist.
Fazit
Ein ESP32 pro Raum, ein Tag pro Person, und Ihr Zuhause weiß, wer da ist. Kombinieren Sie es mit dem DHT22-Sensor oder dem Mijia-Thermometer auf demselben Board.
Diese Konfiguration wurde mit esphome config geprüft, nicht mit Ihren Geräten getestet. MAC-Adresse und IRK sind Platzhalter.