{"id":8856,"date":"2026-08-26T12:45:00","date_gmt":"2026-08-26T10:45:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=8856"},"modified":"2026-10-24T02:37:47","modified_gmt":"2026-10-24T00:37:47","slug":"esphome-und-esp32-in-der-praxis-eigene-cloud-freie-umweltsensoren","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/smart-home-de\/esphome-und-esp32-in-der-praxis-eigene-cloud-freie-umweltsensoren\/","title":{"rendered":"ESPHome und ESP32 in der Praxis: Eigene Cloud-freie Umweltsensoren entwickeln"},"content":{"rendered":"

ESPHome und ESP32 in der Praxis: Eigene Cloud-freie Umweltsensoren entwickeln<\/h2>\n

Ein ESP32 mit SCD40 kann CO\u2082, Temperatur und relative Luftfeuchtigkeit direkt an Home Assistant \u00fcbertragen. ESPHome erzeugt die Firmware aus einer YAML-Konfiguration. F\u00fcr diesen Datenweg ist kein Herstellerkonto in der Cloud erforderlich. Die Messqualit\u00e4t h\u00e4ngt weiterhin von Sensor, Geh\u00e4use und Kalibrierung ab; eine lokale Verbindung erzeugt keine Laborpr\u00e4zision.<\/p>\n

1. Messgr\u00f6\u00dfe ausw\u00e4hlen und Sensor anschlie\u00dfen<\/h2>\n

Der SCD40 misst CO\u2082 mit fotoakustischer NDIR-Technik. Der spezifizierte Genauigkeitsbereich betr\u00e4gt 400\u20132.000 ppm, nicht 5.000 ppm; au\u00dferhalb dieses Bereichs gilt dieselbe Genauigkeitszusage nicht. Der SCD30 ist ein anderer optischer NDIR-Baustein mit einem spezifizierten Genauigkeitsbereich von 400\u201310.000 ppm. Diese Bereiche sind vom digitalen Ausgabebereich zu unterscheiden.<\/p>\n

Ein VOC-Index beschreibt Ver\u00e4nderungen eines Gemischs fl\u00fcchtiger organischer Verbindungen, keine direkte CO\u2082-Konzentration. ESPHome kann mit dem Baustein sgp4x<\/code> einen VOC-Index aus einem SGP40 berechnen. Die einfache BME680-Komponente liefert Gaswiderstand; ein Luftqualit\u00e4tsindex ben\u00f6tigt zus\u00e4tzliche Verarbeitung, beispielsweise BSEC. Ein SHT40 misst Temperatur und Feuchtigkeit. Diese optionalen Module ben\u00f6tigen eigene Konfigurationen und geh\u00f6ren nicht zum folgenden Beispiel.<\/p>\n

I\u00b2C ben\u00f6tigt SDA und SCL sowie eine gemeinsame Masse und eine geeignete Stromversorgung: Zwei Signalleitungen versorgen kein vollst\u00e4ndiges Ger\u00e4t. Das Beispiel nutzt GPIO21 und GPIO22 auf einer klassischen ESP32-Platine mit der Boarddefinition esp32dev. Andere Platinen, insbesondere C3-\/S3-Varianten, ben\u00f6tigen passende Boardeinstellungen und Pinzuordnungen. Die Dokumentation des Sensor-Breakouts legt Versorgung, Pull-ups und Verdrahtung fest. ESP32-Signalleitungen ben\u00f6tigen 3,3-V-Pegel; eine Versorgung des Breakouts mit 5 V erlaubt keine 5-V-Pull-ups an SDA\/SCL. Kurze Leitungen und die gemeinsame Belastung mehrerer vorhandener Pull-ups sind beim Aufbau zu ber\u00fccksichtigen.<\/p>\n

\"Lokaler
Lokaler Datenweg: Zus\u00e4tzlich zu SDA\/SCL sind Versorgung und Masse erforderlich. Messwerte erreichen Home Assistant \u00fcber die verschl\u00fcsselte API; Firmware-Updates nutzen eine eigene Verbindung.<\/figcaption><\/figure>\n

2. Firmware konfigurieren und pr\u00fcfen<\/h2>\n

Das folgende Beispiel umfasst ESP32 und SCD40. Aktuelles ESPHome trennt den Block esp32 von esphome. Zugangsdaten geh\u00f6ren in eine private secrets.yaml<\/code> neben der Konfiguration. api_encryption_key<\/code> muss 32 zuf\u00e4llige Bytes als Base64 kodieren; ein beschreibender Platzhalter oder ein gemeinsam genutzter Beispielschl\u00fcssel gen\u00fcgt nicht. Das OTA-Passwort ist vom API-Schl\u00fcssel getrennt. Die Erstinstallation erfolgt \u00fcblicherweise per USB; sp\u00e4tere Aktualisierungen sind \u00fcber das lokale Netzwerk m\u00f6glich.<\/p>\n

esphome:\n  name: env-monitor-office\n\nesp32:\n  board: esp32dev\n  framework:\n    type: esp-idf\n\nlogger:\n\nwifi:\n  ssid: !secret wifi_ssid\n  password: !secret wifi_password\n\napi:\n  encryption:\n    key: !secret api_encryption_key\n\nota:\n  - platform: esphome\n    password: !secret ota_password\n\ni2c:\n  sda: GPIO21\n  scl: GPIO22\n  scan: true\n  frequency: 100kHz\n\nsensor:\n  - platform: scd4x\n    co2:\n      name: B\u00fcro CO2\n    temperature:\n      name: B\u00fcro Temperatur\n    humidity:\n      name: B\u00fcro Luftfeuchtigkeit\n    measurement_mode: periodic\n    update_interval: 30s\n    automatic_self_calibration: false\n<\/code><\/pre>\n
Der Sensor misst im Modus periodic alle f\u00fcnf Sekunden; die Konfiguration \u00fcbermittelt Werte alle 30 Sekunden. Die physikalische Reaktion auf ver\u00e4nderte Raumluft dauert l\u00e4nger als die Netzwerk\u00fcbertragung. H\u00e4ufigeres Abfragen erzeugt keine verz\u00f6gerungsfreie Gasmessung.<\/p>\n
3. Kalibrierung und Aufstellung<\/h2>\n
Die automatische Selbstkalibrierung bleibt im Beispiel bewusst deaktiviert, bis der Aufbau die Herstellervoraussetzungen erf\u00fcllt. Zur ASC-Annahme des SCD4x geh\u00f6rt regelm\u00e4\u00dfige Luft mit ungef\u00e4hr 400 ppm, laut verlinktem Datenblatt mindestens w\u00f6chentlich. Ein dauerhaft belegter Raum mit erh\u00f6htem CO\u2082 erf\u00fcllt diese Voraussetzung m\u00f6glicherweise nicht. Auch deaktiviertes ASC verhindert keine Drift: Referenzmessung und ein geeignetes Wartungsverfahren bleiben erforderlich.<\/p>\n
Eine erzwungene Nachkalibrierung ben\u00f6tigt eine bekannte, stabile CO\u2082-Referenz und das Herstellerverfahren, einschlie\u00dflich mindestens drei Minuten Betrieb unter stabilen Bedingungen vor der Kalibrierungssequenz. Au\u00dfenluft darf nicht pauschal mit exakt 400 ppm angesetzt werden. Ein sinkendes Tagesminimum beweist allein noch keine Kalibrierungsdrift. Daf\u00fcr ist der Vergleich mit einer verl\u00e4sslichen Referenz erforderlich.<\/p>\n
Der Sensor ben\u00f6tigt Abstand zu ESP32 und Spannungsregler sowie Luftaustausch im Geh\u00e4use. Nach Erreichen des thermischen Gleichgewichts folgt ein Temperaturvergleich mit einer Referenz. temperature_offset<\/code> hat in ESPHome f\u00fcr SCD4x den Standardwert 4 \u00b0C und ben\u00f6tigt eine zum tats\u00e4chlichen Aufbau passende Einstellung. Diese Korrektur betrifft Temperatur und relative Feuchtigkeit, kalibriert jedoch nicht CO\u2082. Die Temperatur- und Feuchtekan\u00e4le liefern n\u00fctzliche Raumindikatoren; Geh\u00e4useerw\u00e4rmung kann den Messfehler allerdings ma\u00dfgeblich bestimmen.<\/p>\n
4. Lokaler Zugriff und Netzwerkgrenzen<\/h2>\n
Ein eigenes IoT-VLAN mit Firewall kann den direkten Internetzugriff des Sensors sperren. Home Assistant ben\u00f6tigt weiterhin Zugriff auf TCP 6053 des Sensors f\u00fcr die verschl\u00fcsselte native API; der freigegebene Update-Rechner ben\u00f6tigt TCP 3232 f\u00fcr ESP32-OTA sowie R\u00fcckverkehr f\u00fcr diese Verbindungen. Das Beispiel aktiviert API-Verschl\u00fcsselung und passwortgesch\u00fctzte OTA-Updates.<\/p>\n
mDNS-Erkennung \u00fcberschreitet VLAN-Grenzen normalerweise nicht automatisch. Eine DHCP-Reservierung und die manuelle Einbindung \u00fcber die IP-Adresse bieten einen berechenbaren Alternativweg; namensbasierte Erkennung ben\u00f6tigt eine gezielte Netzwerkkonfiguration. Die Firmware entsteht auf dem Build-Rechner, der f\u00fcr herunterzuladende Abh\u00e4ngigkeiten Internetzugriff ben\u00f6tigen kann. F\u00fcr die gezeigten lokalen API- und OTA-Funktionen braucht der Sensor selbst keine Internetverbindung.<\/p>\n
Die Firewall begrenzt direkte externe Verbindungen. Exporte, Cloud-Integrationen und Sicherungen von Home Assistant k\u00f6nnen Messwerte trotzdem nach au\u00dfen \u00fcbertragen. Die Verf\u00fcgbarkeit h\u00e4ngt au\u00dferdem von WLAN, Stromversorgung, Firmware und Automationsrechner ab; lokaler Betrieb garantiert keinen unterbrechungsfreien Dienst.<\/p>\n
\n
Fragen und Antworten<\/h2>\n
Wie l\u00e4sst sich die Konfiguration vor der Installation pr\u00fcfen?<\/h3>\n
Vor dem Kompilieren pr\u00fcft der ESPHome-Konfigurationsvalidator die tats\u00e4chliche Boardkonfiguration mit der privaten Geheimnisdatei. Ein erfolgreicher Konfigurationscheck best\u00e4tigt das Schema, jedoch weder elektrische Kompatibilit\u00e4t noch Messgenauigkeit. Nach der Installation folgen Pr\u00fcfungen von I\u00b2C-Adresse, Protokollen, Messwerten, Updateweg und Verhalten bei WLAN- oder Home-Assistant-Ausfall. Die Kalibrierung ben\u00f6tigt einen separaten Messvergleich.<\/p>\n
Bedeutet ein nicht verf\u00fcgbarer Sensor null CO\u2082?<\/h3>\n
Nein. Ein fehlender Messwert oder eine unterbrochene Verbindung bedeutet fehlende Information, keine Konzentration von null. Automationen ben\u00f6tigen einen ausdr\u00fccklichen St\u00f6rzustand und eine Pr\u00fcfung der letzten erfolgreichen Messung. Ein unver\u00e4nderter Zahlenwert allein unterscheidet stabile Raumverh\u00e4ltnisse nicht von einem festh\u00e4ngenden Sensor.<\/p>\n<\/div>\n
\n
Quellen<\/h2>\n