ESPHome für Einsteiger: Eigene Sensoren bauen und in Home Assistant einbinden

Du willst einen Sensor, den es so nicht zu kaufen gibt? Oder einen günstigen Temperatursensor für jeden Raum? ESPHome ist die Antwort. Mit einem ESP32-Mikrocontroller (ab 4 EUR) und ein paar Zeilen YAML-Konfiguration baust du eigene Sensoren, die sich nahtlos in Home Assistant integrieren, komplett lokal, ohne Cloud.

Was ist ESPHome?

ESPHome ist ein Open-Source-Framework, das Mikrocontroller (ESP32, ESP8266) per YAML-Konfiguration programmiert. Du beschreibst in YAML, welche Sensoren angeschlossen sind, wie oft sie messen sollen und wie die Daten an Home Assistant gesendet werden. ESPHome kompiliert die YAML-Datei in Firmware und flasht sie auf den Mikrocontroller.

Der entscheidende Vorteil gegenüber Arduino oderMicroPython: Du musst keinen Code schreiben. Die gesamte Konfiguration passiert in YAML. Und die Integration in Home Assistant ist nativ, keine MQTT-Konfiguration, kein manuelles Setup. Der Sensor taucht automatisch auf.

Schritt 1: ESPHome installieren

ESPHome läuft als Add-on direkt in Home Assistant. Die Installation ist simpel:

1. In Home Assistant: Einstellungen > Add-ons > Add-on Store.
2. Nach ESPHome suchen und installieren.
3. Das Add-on starten und Im Seitenbereich anzeigen aktivieren.
4. Das ESPHome-Dashboard öffnet sich, hier verwaltest du alle deine ESPHome-Geräte.

Alternativ kannst du ESPHome auf einem separaten Rechner per pip install esphome installieren oder per Docker betreiben. Für die meisten Nutzer ist das HA-Add-on aber der einfachste Weg.

Schritt 2: Den ESP32 zum ersten Mal flashen

Beim allerersten Flash musst du den ESP32 per USB an deinen Computer anschließen. Danach geht alles über WiFi (OTA, Over the Air).

1. ESP32 per USB-Kabel an den Rechner anschließen (Micro-USB oder USB-C, je nach Board).
2. Im ESPHome-Dashboard auf New Device klicken.
3. Einen Namen eingeben (z. B. wohnzimmer-sensor) und dein WiFi-Netzwerk konfigurieren.
4. Den ESP32-Board-Typ auswählen (meist esp32dev).
5. Auf Install klicken und Plug into this computer wählen.
6. Die Firmware wird kompiliert und auf den ESP32 geflasht, das dauert 1-2 Minuten.

Nach dem Flash verbindet sich der ESP32 mit deinem WiFi und erscheint im ESPHome-Dashboard als Online. Ab jetzt kannst du Änderungen drahtlos übertragen.

Schritt 3: Ersten Sensor anschließen (DHT22)

Der DHT22 (auch AM2302) ist ein beliebter Einsteiger-Sensor für Temperatur und Luftfeuchtigkeit. Er kostet ca. 3 EUR und braucht nur drei Verbindungen: VCC (3.3V), GND und Daten.

Verdrahtung

• VCC (roter Draht) → 3.3V-Pin am ESP32
• GND (schwarzer Draht) → GND-Pin am ESP32
• DATA (gelber Draht) → GPIO4 am ESP32
• Optional: 10kΩ Pull-up-Widerstand zwischen VCC und DATA (viele Module haben diesen bereits eingebaut)

YAML-Konfiguration

board: esp32dev

wifi:
 ssid: "DeinWiFi"
 password: "DeinPasswort"

api:
 encryption:
 key: "dein-api-key"

ota:
 platform: esphome
 password: "dein-ota-passwort"

sensor:
 - platform: dht
 pin: GPIO4
 model: DHT22
 temperature:
name: "Temperatur"
 filters:
 - offset: -0.5
 humidity:
 name: "Luftfeuchtigkeit"
 update_interval: 60s


Der offset: -0.5 Filter korrigiert die typische Abweichung des DHT22, der oft 0,5°C zu hoch misst. Du kannst den Wert anpassen, indem du den DHT22 neben ein Referenzthermometer legst und die Differenz als Offset einträgst.

Schritt 4: In Home Assistant einbinden

Wenn der ESP32 online ist und die ESPHome-API aktiv ist, erkennt Home Assistant den Sensor automatisch:

1. In Home Assistant erscheint eine Benachrichtigung: Neues Gerät entdeckt: Wohnzimmer Sensor.
2. Klicke auf Konfigurieren und gib den API-Key ein.
3. Die Entities sensor.wohnzimmer_sensor_temperatur und sensor.wohnzimmer_sensor_luftfeuchtigkeit erscheinen sofort.

Ab jetzt kannst du die Sensorwerte in Dashboards, Automationen und Bedingungen verwenden, genau wie jeden anderen Sensor in Home Assistant.

Beispielprojekte für Fortgeschrittene

Projekt 1: Lichtsensor mit BH1750

sensor:
 - platform: bh1750
 name: "Lichtstärke"
 address: 0x23
 update_interval: 30s

Der BH1750 misst die Beleuchtungsstärke in Lux. Ideal für Automationen wie Licht einschalten, wenn die Helligkeit unter 100 Lux fällt.

Projekt 2: Bewegungsmelder mit PIR-Sensor

binary_sensor:- platform: gpio
 pin: GPIO14
 name: "Bewegung"
 device_class: motion
 filters: - delayed_off: 30s

Ein HC-SR501 PIR-Sensor (ca. 2 EUR) meldet Bewegung an Home Assistant. Der delayed_off: 30s Filter verzögert das Abschalten um 30 Sekunden, so flackert das Licht nicht bei kurzen Bewegungen.

Projekt 3: Tür-/Fensterkontakt mit Reed-Schalter

binary_sensor:- platform: gpio
 pin: number: GPIO5
 mode: INPUT_PULLUPname: "Fenster"
 device_class: window
 filters: - delayed_on: 100ms
 - delayed_off: 100ms

Ein Reed-Schalter (ca. 1 EUR) am Fensterrahmen meldet, ob das Fenster offen oder geschlossen ist. Zusammen mit einem kleinen Magneten am Fensterflügel hast du einen DIY-Fensterkontakt für unter 5 EUR.

Tipps für zuverlässige ESPHome-Geräte

• WiFi-Signal prü

  fen: Füge sensor: - platform: wifi_signal hinzu, um die Signalstärke in HA zu sehen. Unter -70 dBm wird es instabil.

• Feste IP vergeben: In der WiFi-Konfiguration mit manual_ip eine feste IP zuweisen. Das beschleunigt die Verbindung nach einem Neustart.
• Fallback-Hotspot: ESPHome erstellt automatisch einen WiFi-Hotspot, falls die Verbindung zum Router fehlschlägt. So erreichst du den ESP32 auch ohne funktionierendes WiFi.
• Web-Serveraktivieren: Mit web_server: port: 80 kannst du die Sensorwerte direkt im Browser unter der IP-Adresse des ESP32 sehen, nützlich zur Fehlersuche.