ESPHome-Sensoren planen, verbinden und erhalten.

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 ist eine zusätzliche Aufgabe

Ein geeigneter ESPHome-Proxy kann unterstützte Bluetooth-Geräte für Home Assistant erreichbar machen. Er ist kein universeller Adapter für beliebiges Zubehör. Benötigt werden eine passende Geräteintegration und eine Proxy-Plattform mit den erforderlichen Fähigkeiten.

Die Dokumentation unterscheidet passive Werbenachrichten von aktiven BLE-Verbindungen. Bei ESP32-Proxys sind standardmäßig drei gleichzeitige aktive Verbindungen vorgesehen; reine Werbenachrichten unterliegen nicht dieser Slotzahl. Manche Plattformen unterstützen nur deren Weiterleitung. Planen Sie daher nach Gerät und Nutzung statt nach einer pauschalen Zahl „unterstützter Bluetooth-Geräte“. Standort und Versorgung bleiben ebenfalls wichtig.

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 Verwendung vor zusätzlichen Nachkommastellen festlegen

Ein Sensor soll eine konkrete Frage beantworten. Bei einem Raumwert ist deshalb zuerst wichtig, welche Situation am gewählten Standort tatsächlich erfasst wird. Ein Wert direkt neben einer Wärmequelle kann eine andere Bedeutung haben als eine Messung im üblichen Aufenthaltsbereich. Auch Gehäuse und Einbauort werden in die Auswahl einbezogen. Eine technische Anzeige mit mehreren Nachkommastellen ist kein Ersatz für einen geeigneten Messaufbau. Wir betrachten den vorgesehenen Nutzen gemeinsam mit der verwendeten Hardware und ihrer Dokumentation.

Nach der Einrichtung werden Einheit, plausible Änderung und zeitlicher Verlauf geprüft. Wenn ein Wert auffällig ist, beginnt die Klärung nicht mit einer beliebigen Korrekturzahl. Zuerst werden Messort, Betriebsart und Datenweg betrachtet. Eine Kalibrierung oder Anpassung muss nachvollziehbar begründet sein, damit spätere Betreuung nicht auf unbekannten Annahmen aufbaut. Für eine Automation wird außerdem festgelegt, wie mit fehlenden oder unplausiblen Daten umzugehen ist. Ein einfacher Komfortsensor wird dadurch nicht automatisch zu einem zugelassenen Mess- oder Schutzgerät für einen anderen Anwendungszweck.

Jedes Gerät mit seiner passenden Konfiguration erhalten

Mehrere ähnlich aussehende Sensoren können unterschiedliche Boards, Anschlüsse oder Bauteile verwenden. Für spätere Änderungen wird deshalb dokumentiert, welche Konfiguration zu welchem physischen Gerät gehört. Sinnvolle Namen und eine Zuordnung zum Einbauort erleichtern diese Arbeit. Eine erfolgreiche Firmwareerstellung ist noch keine Bestätigung, dass die verwendete Datei zu dem angeschlossenen Gerät passt. Vor einem Update wird daher der konkrete Ausgangszustand geprüft, insbesondere bei übernommenen oder nachträglich veränderten Aufbauten.

Auch gemeinsam verwendete Konfigurationsbestandteile müssen bekannt bleiben. Wenn mehrere Geräte auf dieselbe Datei oder Vorlage zurückgreifen, kann eine Änderung mehr als einen Sensor betreffen. Der vereinbarte Prüfplan berücksichtigt diese Abhängigkeiten. Vertrauliche Schlüssel und Zugangsdaten werden dabei nicht in frei geteilte Beispiele kopiert. Eine getrennte Datei für Geheimnisse erleichtert die Organisation, ersetzt aber keine geeignete Zugriffsbeschränkung und sichere Aufbewahrung. Bei der Übergabe wird erklärt, welche Unterlagen für spätere Änderungen benötigt werden und welche Person diese verwahrt.

Eine Erweiterung erst nach einem nachvollziehbaren Pilotbetrieb ausrollen

Für mehrere gewünschte Sensoren ist ein erster vollständiger Pilotaufbau hilfreich. Dieser wird am vorgesehenen Einsatzort mit der später verwendeten Versorgung und Verbindung geprüft. Dabei werden Messwert, Aktualisierung, Anzeige und das Verhalten nach einer vereinbarten Unterbrechung betrachtet. Erst danach wird der Aufbau auf weitere Geräte übertragen. Diese Reihenfolge macht wiederkehrende Anforderungen sichtbar, ohne einen unklaren Fehler gleich auf mehrere Standorte zu verteilen. Sie ist keine pauschale Garantie, dass jeder spätere Montageort dieselben Bedingungen besitzt.

Für den längerfristigen Betrieb wird festgelegt, wer Softwareänderungen übernimmt und wie vor einer Änderung ein nutzbarer Ausgangsstand gesichert wird. Ein erfolgreicher Upload allein beendet die Prüfung nicht. Nach dem Neustart sollen API beziehungsweise MQTT-Verbindung und die eigentliche Messfunktion wieder nachvollziehbar arbeiten. Wenn ein Gerät zugleich als Bluetooth-Proxy dient, wird diese zusätzliche Aufgabe mitbetrachtet. Ein Sensor kann mehrere Rollen besitzen; eine Änderung an einer Rolle darf nicht unbemerkt andere Funktionen beeinträchtigen. Zusätzlicher Aufbau, Versorgung oder Montage werden getrennt vom reinen Softwareauftrag vereinbart.

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.