ESPHome-Tutorial: Bluetooth-Anwesenheitsmelder mit einem ESP32

3 Min. Lesezeit

„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.

Ein ESP32 pro Raum misst das Signal eines Smartphones oder Tags

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.

Ein ESP32-DevKit-Board

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_presence ist ein binärer Sensor: an, wenn das Gerät zu hören ist, aus, wenn es nach dem timeout nicht mehr zu hören war.
  • min_rssi: -85dB ignoriert sehr schwache Signale, damit ein Tag in der Nachbarwohnung nicht zählt.
  • ble_rssi veröffentlicht die Signalstärke. Mit einem ESP32 pro Raum zeigt der mit dem stärksten Wert den Raum an.
  • scan_parameters mit interval gleich window lässt den ESP32 fast durchgehend scannen. active: false hä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:

  1. 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.
  2. 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.

Das ESPHome-Dashboard beim Bearbeiten von hallway-presence.yaml

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_rssi an.
  • 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.