ESPHome mit Home Assistant: Sensoren einrichten und pflegen

1. Mit einer konkreten Messfrage beginnen

Möchten Sie die Luftfeuchtigkeit im Keller beobachten oder CO₂-Werte für einen Lüftungshinweis nutzen? Schreiben Sie Messgröße, Raum und gewünschte Aktualisierung auf. Dazu gehört, was bei fehlenden Daten passieren soll. Ein dekorativer Zahlenwert ist weniger hilfreich als eine verständliche Anzeige mit bekanntem Messort.

Planen Sie eine passende fertige Sensorlösung oder einen fachgerecht aufgebauten Kleinspannungsaufbau. Ein Mikrocontroller ersetzt weder ein geeignetes Gehäuse noch die Prüfung der Versorgung und des Einbauorts. Arbeiten an Netzspannung gehören nicht zu diesem Ratgeber. Die Softwareeinrichtung beginnt erst bei der geeigneten Hardware.

2. Modell und Firmware müssen zusammenpassen

ESPHome erzeugt gerätespezifische Firmware aus einer Konfiguration. Die Angabe „ESP32“ allein beschreibt noch nicht das vollständige Gerät. Erfassen Sie Board-Modell, Chipvariante, Speicher, verwendete Sensoren und vorhandene Firmware. Eine Konfiguration für ein ähnlich aussehendes Board wird nicht ungeprüft übernommen.

3. Messbetrieb bewusst auswählen

Die Betriebsart kann den Inhalt der Anzeige verändern: Beim SCD41 misst „single_shot_rht_only“ ausschließlich Feuchte und Temperatur; die ESPHome-Dokumentation beschreibt dabei CO₂ mit 0 ppm. Dieser Wert darf nicht als erfolgreiche CO₂-Messung verwendet werden. Prüfen Sie die gewünschte Messfunktion deshalb vor dem Einbau.

Auch Gehäuse, Wärmequellen und Platzierung beeinflussen, welche Situation der Sensor erfasst. Vergleichen Sie nach der Einrichtung plausible Änderungen und beobachten Sie den Verlauf. Eine Zahl mit vielen Nachkommastellen belegt keine entsprechende Genauigkeit. Korrekturen oder Kalibrierungen brauchen eine nachvollziehbare Grundlage.

4. Native API und MQTT gezielt unterscheiden

Die native ESPHome-API verbindet geeignete Geräte direkt mit Home Assistant und benötigt dafür keinen MQTT-Broker. Die Home-Assistant-Integration nennt standardmäßig Port 6053 sowie Hostname oder IP-Adresse. Ein automatisch entdecktes Gerät wird über den Einrichtungsdialog aufgenommen; andernfalls werden die bestätigten Verbindungsdaten verwendet.

MQTT ist ein alternativer Datenweg über einen Broker. ESPHome unterscheidet dabei MQTT-Entitäts-Discovery von der Erkennung eines Geräts für eine anschließende native API-Verbindung. Beide Wege ungeplant parallel zu aktivieren kann die Zuordnung unnötig verwirren. Wer ausschließlich MQTT verwendet, muss außerdem die dokumentierte API-Neustartüberwachung passend berücksichtigen.

5. Netzwerk und API-Schlüssel vorbereiten

Gerät und Home Assistant müssen sich über den vorgesehenen lokalen Netzweg erreichen. Bei WLAN-Geräten gehören Empfang und passende Zugangsdaten dazu; Ethernet setzt ein dafür geeignetes Board voraus. Green selbst verwendet LAN. Ein Gäste-WLAN oder eine unpassende Netztrennung kann die direkte Verbindung verhindern.

Die native API unterstützt Verschlüsselung mit einem 32 Byte langen, Base64-codierten Schlüssel. Verwenden Sie gerätespezifische Schlüssel und bewahren Sie die Konfiguration vertraulich auf. Home Assistant benötigt den dazu passenden Schlüssel. Ein vorhandener Schlüssel wird bei einer bloßen Neuordnung der Dateien nicht unbemerkt ersetzt.

6. API-Verschlüsselung und Updates getrennt prüfen

Die laufende Datenverbindung und das Übertragen neuer Firmware sind unterschiedliche Vorgänge. Seit ESPHome 2026.9.0 unterstützt die ESPHome-OTA-Plattform verschlüsselte Updates. Die aktuelle Dokumentation empfiehlt dafür die Verschlüsselungskonfiguration; mit nativer API kann der Geräteschlüssel auch für OTA verwendet werden. Ein bloßes OTA-Passwort authentifiziert den Upload, schützt das Firmwareabbild aber nicht vor Mitlesen.

Bei älterer Firmware beschreibt ESPHome eine zweistufige Migration: Zuerst muss das Gerät eine Firmware erhalten, die Verschlüsselung anbietet; anschließend wird sie verpflichtend aktiviert. Übernehmen Sie deshalb nicht nur einen neuen Konfigurationsblock. Prüfen Sie laufende Version, vorgesehenen Updateweg und Protokollmeldung. Bestehende Zugangsdaten bleiben während der vorbereitenden Migration relevant.

7. Bluetooth-Proxy: Verbindung gezielt prüfen

Ein ESPHome-Bluetooth-Proxy erweitert den Empfang für unterstützte BLE-Geräte. Bluetooth Classic gehört nicht dazu. Entscheidend sind das genaue Gerät, seine Home-Assistant-Integration und die Fähigkeiten des Proxys. Eine erreichbare ESPHome-Verbindung allein bestätigt noch nicht, dass das gewünschte Zubehör unterstützt wird.

„Aktiv“ bezeichnet zwei verschiedene Aufgaben: Aktives Scannen fordert zusätzliche Angaben zu empfangenen Werbenachrichten an. Eine aktive GATT-Verbindung dient dem verbundenen Datenaustausch mit einem Gerät. Die beiden Einstellungen sind nicht austauschbar. Bei ESP32-Proxys gelten standardmäßig drei gleichzeitige aktive Verbindungen; daraus folgt keine Grenze von drei werbenden Sensoren.

Prüfen Sie zuerst die ESPHome-Verbindung zu Home Assistant, danach den Bluetooth-Empfang und anschließend die Geräteintegration. Unter der Bluetooth-Integration zeigt der Advertisement Monitor empfangene Werbenachrichten, der Connection Monitor bestehende Verbindungen. Ein sichtbarer Werbeeintrag ist deshalb noch kein Nachweis einer funktionierenden aktiven Verbindung oder einer passenden Geräteintegration.

• Funkbedingungen: ESP32 nutzt für WLAN und Bluetooth dieselben Funkressourcen. Ein Ethernet-Proxy kann die WLAN-Aufgabe vermeiden, garantiert aber keine bestimmte Reichweite. Für einen ersten Vergleich bleiben die empfohlenen Scan-Standardwerte bestehen; aggressivere Einstellungen können andere Verbindungen beeinträchtigen.
• Für die Prüfung bereithalten: Modell, Proxy-Board, Firmwarestand, die betroffene Integration und eine konkrete Beobachtung aus dem passenden Monitor. Notieren Sie auch, was noch funktioniert. Zugangsschlüssel gehören nicht in öffentliche Fehlerberichte. Dokumentationsstand dieses Bluetooth-Abschnitts: 15. Oktober 2026.

8. Funktion, Sicherung und Übergabe abschließen

Prüfen Sie Messwert, Einheit, Aktualisierung und Verhalten bei fehlender Verbindung. Testen Sie vor einer größeren Ausweitung ein einzelnes Gerät. Nach einem geplanten Update müssen sowohl die API-Verbindung als auch die eigentlichen Sensorwerte wieder funktionieren; eine erfolgreiche Firmwareübertragung allein reicht nicht.

Sichern Sie Geräte-YAML, eingebundene Konfigurationen, benötigte Schlüssel und die dokumentierte ESPHome-Version. Die Datei secrets.yaml trennt vertrauliche Werte vom teilbaren Beispiel, ist aber kein verschlüsselter Tresor. Prüfen Sie, ob der tatsächliche Speicherort Ihrer ESPHome-Dateien im Sicherungsplan enthalten ist. Ein Home-Assistant-Dashboard ersetzt diese Unterlagen nicht.

Elektro-Zentrum unterstützt bei geeigneter Hardwareauswahl, Integration und Programmierung. Für die Anfrage helfen Messziel, Raum, vorhandenes Board und gewünschte Anzeige. Wir vereinbaren Einrichtung, Abnahmetest, erforderliche Hardware und weitere Betreuung vorab.

Messort und zeitlichen Verlauf prüfen

Der Sensor soll die benötigte Situation erfassen. Prüfen Sie Standort, Einheit und plausible Wertänderung, bevor Sie Korrekturwerte eintragen. Mehr Nachkommastellen ersetzen keinen geeigneten Messort.

Konfiguration dem richtigen Gerät zuordnen

Ähnliche Sensoren können unterschiedliche Boards und Anschlüsse verwenden. Dokumentieren Sie die zugehörige Konfiguration. Gemeinsam verwendete Dateien oder Vorlagen müssen ebenfalls bekannt sein, da Änderungen mehrere Geräte betreffen können.

Einen vollständigen Aufbau vor der Serie testen

Prüfen Sie den ersten Sensor am vorgesehenen Ort mit späterer Versorgung und Verbindung. Ein erfolgreicher Upload allein genügt nicht. Halten Sie vor Änderungen einen nutzbaren Ausgangsstand bereit und benennen Sie die Person für Softwarepflege.

Einrichtung, Hardware und Vor-Ort-Leistung getrennt beauftragen

Die aktuelle Preisübersicht trennt Einrichtung per vereinbartem Fernzugriff von zusätzlicher Hardware und Arbeiten vor Ort. Für einen Softwareauftrag müssen geeignete Geräte, notwendige Unterlagen und ein nutzbarer Zugang vorbereitet sein. Physischer Aufbau, elektrische Montage, zusätzliche Leitungen oder ein ungeklärtes Netzwerkproblem sind nicht automatisch Bestandteil eines Remote-Pakets. Wir beschreiben den konkreten Ausgangszustand und das vereinbarte Ergebnis vor der Beauftragung.

Ein zusätzlicher Vor-Ort-Termin umfasst nach der Preisliste den vereinbarten Serviceumfang bis zu zwei Arbeitsstunden; die fixe Anfahrt wird als eigene Position berücksichtigt. Für Wien und Niederösterreich beziehungsweise Burgenland gelten unterschiedliche Anfahrtspositionen. Material, zusätzliche Arbeiten und optionale Dienste werden vorab abgestimmt. Alle ausgewiesenen Preise verstehen sich inklusive Umsatzsteuer. Eine laufende Betreuung entsteht nicht automatisch durch einen einzelnen Einrichtungstermin.