Neu: Für unseren Bausatz aus Reedkontakt, Gehäuse und ESP32-C3 gibt es jetzt eine fertige, kostenlose ESPHome-Firmware. Du installierst sie mit einem Klick im Browser, ganz ohne ESPHome Device Builder, ohne YAML und ohne API-Key. Nach wenigen Minuten erscheint dein BK-Gaszähler mit Zählerstand, Durchfluss und Tagesverbrauch in Home Assistant.
Was ist neu an der ESPHome-Firmware?
In unserer bisherigen Anleitung BK-G4 Gaszähler mit ESPHome und Home Assistant auslesen legst du das ESPHome-Gerät selbst im Device Builder an, fügst den YAML-Code ein und trägst den Zählerstand im Code ein. Das funktioniert weiterhin. Die neue ESPHome-Firmware nimmt dir diese Schritte ab und kann einiges mehr:
| Bisherige Anleitung (YAML) | Neue ESPHome-Firmware | |
|---|---|---|
| Installation | ESPHome Device Builder in Home Assistant | Web-Installer im Browser |
| YAML-Code | selbst einfügen und anpassen | nicht nötig |
| Zählerstand | im Code eintragen | in Home Assistant eintippen |
| Impulswert | Faktor im Code ändern | Auswahlfeld: 0,001 / 0,01 / 0,1 / 1 m³ |
| Werte | Zählerstand | Zählerstand, Durchfluss, heute, gestern, Monat, Jahr |
| Verschlüsselung | API-Key kopieren und eingeben | richtet Home Assistant automatisch ein |
| Updates | selbst neu kompilieren | mit einem Klick in Home Assistant |
Kurz erklärt: so zählt der ESPHome-Gaszähler
Ein Magnet in der letzten Zählrolle deines BK-Gaszählers schaltet bei jeder Umdrehung den Reedkontakt. Der ESP32-C3 zählt diese Impulse mit dem ESPHome-Baustein pulse_meter und rechnet sie in Kubikmeter um. Wie der Sensor aufgebaut ist und zu welchen BK-Zählern er passt, haben wir in Reedkontakt Sensor jetzt auch mit ESP32-Gehäuse beschrieben.
Was du für den ESPHome-Gaszähler brauchst
- Unseren Bausatz mit ESP32-C3 für BK-Gaszähler. Darin sind:
- das Gehäuse mit vormontiertem Reedkontakt
- der Waveshare ESP32-C3 Mini (ESP32-C3-Zero), auf den die ESPHome-Firmware kommt
- die Befestigungsschraube
- eine Kurzanleitung mit QR-Code zum Web-Installer
- USB-C-Kabel und USB-Netzteil mit 5 V
- Lötkolben für zwei Lötstellen
- Computer mit Google Chrome oder Microsoft Edge
- Home Assistant. Ein ESPHome-Add-on brauchst du nicht.
Schritt für Schritt: ESPHome-Firmware installieren
1. Reedkontakt anlöten
Die beiden Adern kommen an GPIO4 und GND des ESP32-C3, die Polung ist egal. Das ist dieselbe Belegung wie in der bisherigen Anleitung, ein bereits verdrahteter Sensor passt also ohne Änderung.
2. ESPHome-Firmware per Web-Installer aufspielen
- Die BOOT-Taste am ESP32-C3 gedrückt halten und das USB-C-Kabel am Computer einstecken.
- Den ESPHome Web-Installer öffnen: ng3d-druck.github.io/Gas-Connect-DIY
- Auf Installieren klicken und den Port auswählen. Nach rund einer Minute ist die Installation fertig.
- Das Kabel kurz abziehen und ohne BOOT-Taste wieder einstecken.
3. WLAN einrichten
Direkt im Web-Installer über Configure Wi-Fi, per Bluetooth mit der Home-Assistant-App oder über den Hotspot des Geräts. Aus Sicherheitsgründen ist das nur in den ersten 15 Minuten nach dem Einstecken möglich. Danach einfach kurz ab- und wieder anstecken.
4. In Home Assistant hinzufügen
Home Assistant meldet das ESPHome-Gerät unter Einstellungen → Geräte & Dienste als entdeckt. Ein Klick auf Hinzufügen genügt, einen API-Key musst du nicht kopieren. Danach stellst du Pulse volume laut Typenschild ein und trägst unter Set meter reading deinen Zählerstand ein, mit Komma, so wie er auf dem Zähler steht.
Das zeigt die ESPHome-Firmware in Home Assistant
- Gas meter reading: Zählerstand in m³ für das Energie-Dashboard
- Gas flow: Durchfluss in m³/h, z. B. um zu sehen, wann die Therme läuft
- Gas today, yesterday, this month, this year: Verbrauch seit Mitternacht, des Vortags, seit dem Monatsersten und seit dem 1. Januar
- Reed contact: der Kontakt live, hilfreich beim Ausrichten am Zähler
- Debounce time: Entprellzeit, falls ein Impuls doppelt gezählt wird
- LED mode: Status über die RGB-LED oder aus
Den Zählerstand fügst du unter Einstellungen → Dashboards → Energie → Gasverbrauch hinzu. Hinterlegst du dort deinen Gaspreis pro m³, rechnet Home Assistant die Kosten gleich mit aus.
Tipps aus der Praxis
- Ein Impuls wird doppelt gezählt? Debounce time erhöhen, z. B. auf 200 ms.
- Bei hohem Verbrauch fehlen Impulse? Die Entprellzeit verringern.
- Verbrauch um Faktor 10 falsch? Pulse volume mit dem Typenschild vergleichen. BK-G10 bis G25 zählen oft 0,1 m³ pro Impuls.
- Kubikmeter in kWh: m³ × Brennwert × Zustandszahl von deiner Gasrechnung, typischerweise rund 10 kWh pro m³.
ESPHome-Konfiguration erweitern oder selbst schreiben
Die Firmware ist quelloffen und lässt sich mit einem Klick in den ESPHome Device Builder übernehmen, zum Beispiel um die ESPHome-MQTT-Komponente für ioBroker, Node-RED oder FHEM zu ergänzen. Wer lieber alles selbst in YAML aufbaut, findet den Weg in unserer bisherigen ESPHome-Anleitung. Den Quellcode der neuen Firmware gibt es auf GitHub.
Sicherheit geht vor
- Nur in trockenen Innenräumen verwenden, nicht in explosionsgefährdeten Bereichen.
- Keine Manipulation am Gaszähler vornehmen: nicht öffnen und keine Plomben beschädigen.
- Bei Gasgeruch keine elektrischen Geräte bedienen, das Gebäude verlassen und von draußen den Notdienst deines Gasversorgers anrufen.
- Für die Abrechnung gilt allein die Anzeige des Gaszählers.
Jetzt loslegen
Mit dem Bausatz und der fertigen ESPHome-Firmware ist dein Gaszähler an einem Nachmittag in Home Assistant, ganz ohne Programmieren. Im Bausatz steckt alles, was du dafür brauchst. Nur USB-C-Kabel und Netzteil fehlen.
