ESPHome¶
Mit ESPHome bringst du die Zählerwerte über einen ESP32 per WLAN in Home Assistant, ohne eine Zeile Code zu schreiben. Die SML-Auswertung ist in ESPHome schon eingebaut. Du steckst den WattWächter TTL auf den ESP32, ergänzt die Konfiguration um ein paar Zeilen und flashst.
Du brauchst:
- Einen ESP32 mit Stiftleiste, z. B. ein ESP32-DevKitC mit ESP32-WROOM-32
- Home Assistant mit der App bzw. dem Add-on ESPHome Builder (oder ESPHome auf dem Rechner)
- Einen vorbereiteten Zähler, der SML sendet und mit der PIN freigeschaltet ist
Nur SML-Zähler
Die ESPHome-Komponente sml liest Zähler, die SML von sich aus senden. Das sind fast alle modernen Zähler. Zähler, die erst angefragt werden müssen (IEC 62056-21, Fußnote ⁴ unter Unterstützte Zähler), liest sie nicht. Dafür eignen sich Arduino, Python oder ein WattWächter Plus.
1. Anschließen¶
Stecke das Kabel mit dem USB-C-Stecker in den Lesekopf und die Adern auf den ESP32:
| Ader | ESP32 |
|---|---|
| Rot | 3V3 |
| Schwarz | GND |
| Grün | GPIO16 (RX2) |
| Weiß | wird nicht gebraucht |
Rot an 3V3, nicht an 5V
Die Datenleitung des TTL führt den Pegel seiner Versorgung. Der ESP32 verträgt an seinen Pins nur 3,3 V. Schließe die rote Ader deshalb an 3V3 an, nicht an 5V oder VIN.
ESP32-WROVER
Bei Modulen mit PSRAM (ESP32-WROVER) ist GPIO16 belegt. Nimm dort z. B. GPIO25 und trage ihn unten bei rx_pin ein.
2. Konfiguration¶
Lege im ESPHome Builder ein neues Gerät an (+ New device, Typ ESP32). Der Assistent erzeugt die Grundkonfiguration mit WLAN, API-Schlüssel und OTA. Ergänze darunter die Blöcke uart, sml und sensor:
uart:
id: uart_zaehler
rx_pin: GPIO16 # grüne Ader (RXD) des WattWächter TTL
baud_rate: 9600
sml:
id: zaehler
uart_id: uart_zaehler
sensor:
- platform: sml
name: "Bezug gesamt"
sml_id: zaehler
obis_code: "1-0:1.8.0"
unit_of_measurement: kWh
accuracy_decimals: 3
device_class: energy
state_class: total_increasing
filters:
- multiply: 0.0001
- platform: sml
name: "Einspeisung gesamt"
sml_id: zaehler
obis_code: "1-0:2.8.0"
unit_of_measurement: kWh
accuracy_decimals: 3
device_class: energy
state_class: total_increasing
filters:
- multiply: 0.0001
- platform: sml
name: "Leistung"
sml_id: zaehler
obis_code: "1-0:16.7.0"
unit_of_measurement: W
accuracy_decimals: 0
device_class: power
state_class: measurement
Vollständige Konfiguration zum Vergleich
So sieht die ganze Datei aus. Den Kopf bis einschließlich wifi erzeugt der Assistent, die Zugangsdaten stehen in secrets.yaml.
esphome:
name: wattwaechter-ttl
friendly_name: WattWächter TTL
esp32:
board: esp32dev
framework:
type: esp-idf
logger:
api:
ota:
- platform: esphome
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
uart:
id: uart_zaehler
rx_pin: GPIO16
baud_rate: 9600
sml:
id: zaehler
uart_id: uart_zaehler
sensor:
- platform: sml
name: "Bezug gesamt"
sml_id: zaehler
obis_code: "1-0:1.8.0"
unit_of_measurement: kWh
accuracy_decimals: 3
device_class: energy
state_class: total_increasing
filters:
- multiply: 0.0001
- platform: sml
name: "Einspeisung gesamt"
sml_id: zaehler
obis_code: "1-0:2.8.0"
unit_of_measurement: kWh
accuracy_decimals: 3
device_class: energy
state_class: total_increasing
filters:
- multiply: 0.0001
- platform: sml
name: "Leistung"
sml_id: zaehler
obis_code: "1-0:16.7.0"
unit_of_measurement: W
accuracy_decimals: 0
device_class: power
state_class: measurement
Hat dein Zähler keine Einspeisung, bleibt der Sensor „Einspeisung gesamt“ leer. Du kannst ihn dann weglassen.
3. Flashen¶
Das erste Mal flashst du per USB: ESP32 an den Rechner stecken, im ESPHome Builder Install → Plug into this computer wählen (Chrome oder Edge). Mit ESPHome auf dem Rechner geht das mit esphome run wattwaechter-ttl.yaml. Alle späteren Änderungen spielt ESPHome per WLAN auf.
4. Prüfen, ob Daten ankommen¶
Setze den Kopf auf den Zähler (Kabel nach oben) und öffne im ESPHome Builder die Logs. Sitzt alles richtig, kommen meist jede Sekunde neue Werte:
[D][sml:078]: OBIS info:
[D][sml:084]: (0a015341472001711c3f) 1-0:1.8.0 [0x00000000000cdf82]
[D][sml:084]: (0a015341472001711c3f) 1-0:2.8.0 [0x000000000000e896]
[D][sml:084]: (0a015341472001711c3f) 1-0:16.7.0 [0x0000000000000028]
[D][sensor:093]: 'Bezug gesamt': Sending state 84.36500 kWh with 3 decimals of accuracy
[D][sensor:093]: 'Einspeisung gesamt': Sending state 5.95420 kWh with 3 decimals of accuracy
[D][sensor:093]: 'Leistung': Sending state 40.00000 W with 0 decimals of accuracy
Die Zeilen unter OBIS info zeigen alle Werte, die dein Zähler sendet, mit dem Rohwert in eckigen Klammern. Die Zeilen Sending state sind die fertigen Sensorwerte.
Faktor mit der Anzeige am Zähler vergleichen
ESPHome gibt den Rohwert aus dem Telegramm weiter, ohne die Skalierung des Zählers einzurechnen. Vergleiche „Bezug gesamt“ mit dem Zählerstand im Display. Im Beispiel oben ist der Rohwert 0xcdf82 = 843 650, mal 0,0001 ergibt 84,365 kWh. Weicht dein Wert um den Faktor 10, 100 oder 1000 ab, passe multiply an. Die Leistung in W passt bei den meisten Zählern ohne Faktor.
5. In Home Assistant einbinden¶
Home Assistant findet das neue ESPHome-Gerät automatisch und zeigt es unter Einstellungen → Geräte & Dienste an. Nach Hinzufügen stehen die drei Sensoren bereit.
Für das Energie-Dashboard trägst du unter Einstellungen → Dashboards → Energie „Bezug gesamt“ als Netzbezug und „Einspeisung gesamt“ als Netzeinspeisung ein.
Fehlerbehebung¶
| Problem | Mögliche Ursache / Lösung |
|---|---|
Keine OBIS info im Log, grüne LED dunkel |
Rot an 3V3 und Schwarz an GND? USB-C-Stecker ganz im Kopf? Kopf mittig aufsetzen, Kabel nach oben |
Keine OBIS info im Log, grüne LED blinkt |
Grün an GPIO16? Bei ESP32-WROVER anderen Pin nehmen. Sendet der Zähler D0 statt SML (siehe oben)? |
Nur 1.8.0, kein 16.7.0 |
Zähler nicht freigeschaltet, siehe Vorbereitung des Zählers |
| Werte um Faktor 10/100/1000 falsch | multiply anpassen, siehe oben |
ESP32 startet ständig neu (POWERON_RESET), USB-Verbindung bricht ab |
Die Stromversorgung bricht ein, sobald das WLAN startet. Anderes USB-Kabel oder Netzteil nehmen, nicht an einem passiven USB-Hub betreiben |