Skip to content

Latest commit

 

History

537 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tasmota TinyC-Programme (Scripte) - Strom/Gas/Wasser-ZĂ€hler oder smarte Steckdosen auslesen [by ottelo]

Werte grafisch darstellen, Verbraucher steuern, Nulleinspeisung fĂŒr smarte Akkus realisieren

Tasmota TinyC-Programs (scripts) for Smart Meter Readers / Smart Powerplugs [by ottelo]. Display values graphically, implement zero-feed-in for smart batteries

Mein Blog: AusfĂŒhrliche Infos, Anleitungen, Hardware
Schnellanleitung TinyC
Wiki/Anleitung – TinyC Programme erklĂ€rt & Script>TinyC Konverter (DE/EN)
Firmware: Hier gehts zu meinen Tasmota Images
Die Hilfe erreicht ihr auch ĂŒber das â„č im TinyC-Programm.

Important

Damit die TinyC-Programme oder Scripte funktionieren mĂŒsst ihr mein Tasmota Image (Firmware) verwenden (flashen)!

Inhalt: Features · A) TinyC-Programme · B) Tasmota Scripte · C) Testtools · D) Image/Firmware · E) Anleitung · F) Home Assistant · Lizenz

Features

Feature Was es macht Hilfe
📊 Strom zĂ€hlen und anzeigen Verbrauch und Einspeisung in Echtzeit, Diagramme fĂŒr die letzten Minuten und 24 Stunden, Balken fĂŒr Tage, Wochen, Monate und Jahre Diagramme
🔱 Über 140 ZĂ€hler zur Auswahl ZĂ€hler im MenĂŒ auswĂ€hlen, Lesekopf-Pins einstellen, fertig - auch fĂŒr Gas- und WasserzĂ€hler ZĂ€hler, Gas/Wasser
🔌 Schnittstellen: MQTT, Home Assistant, HTTP, Modbus TCP Werte per MQTT (auch geglĂ€ttet), in Home Assistant ĂŒber die Tasmota-Integration, per HTTP (/pwr) und als Modbus-TCP-Server MQTT/HTTP, Modbus TCP
🔋 FĂŒr viele PV-Akkus und Steuerungen Marstek, Hoymiles, Growatt NOAH u. a. ĂŒber die Emulatoren; openDTU-OnBattery, AhoyDTU und andere holen sich die Netzleistung per HTTP, MQTT oder Modbus TCP Werte abfragen
☀ PV-Überschuss-Schalter Schaltet ein anderes Tasmota-GerĂ€t (z. B. Heizstab, Steckdose) bei Überschuss ein und wieder aus PV-Schalter
đŸ’Ÿ FTP-Backup Sichert ZĂ€hlerstĂ€nde und Diagrammdaten jede Nacht auf eine FRITZ!Box oder ein NAS FTP-Backup
🚗 go-e Charger: E-Auto mit PV-Überschuss laden Das Zusatzprogramm MQTT-Push schickt die Netzleistung alle paar Sekunden per MQTT an die go-e-Wallbox, die damit nur mit Überschuss lĂ€dt MQTT-Push
🔋 Shelly / EcoTracker Emulator (Nulleinspeisung) Der ESP gibt sich als Shelly Pro 3EM oder EcoTracker aus. Smarte Akkus (z. B. Marstek, Hoymiles, Growatt NOAH) speisen dann genau so viel ein, wie gerade verbraucht wird EcoTracker / Shelly
🔋 Marstek CT002 / CT003 Emulator (Nulleinspeisung) Der ESP gibt sich als Marstek-ZĂ€hler CT002/CT003 aus, fĂŒr Marstek-Akkus (Venus, Jupiter, B2500), mehrere Akkus gleichzeitig Marstek CT002

A) TinyC-Programme

TinyC ist der Nachfolger von Tasmota Script / Berry, ist ca. 10x schneller und bietet viel mehr Möglichkeiten. Es lĂ€uft allerdings nur auf dem ESP32. Wenn ihr nicht wechseln oder auf euren ESP8266 bzw. Ă€lteren Lesekopf (z.B. HichiV1 ESP01s) verzichten wollt, dann scrollt etwas herunter zu B). Ich wĂŒrde jedoch jedem empfehlen, auf TinyC umzusteigen.

Eine Liste von Programmen findet ihr auf meiner neuen Wiki/Hilfe Seite. Ich habe meine bekannten Scripte zu TinyC konvertiert und die Varianten als Optionen inkludiert. Das alles ist mit TinyC problemlos möglich gewesen. Z.b. ist nun ModbusTCP Slave als Option immer mit drin.

Wenn noch eins meiner Scripte auf eurem ESP/Lesekopf lÀuft und ihr wechseln wollt, dann könnt ihr die Diagrammdaten/VerbrÀuche exportieren und dann wieder importieren. Anleitung und Online-Converter Tool.

  1. Die TinyC Programme wĂ€hlt ihr bequem direkt auf eurem ESP aus via Tools > TinyC Console > Repository Drop Down MenĂŒ: image
  2. Oder ladet euch die Programme herunter. Fertige tcb Programme unter tinyc/bytecode. Sourcecode der Programme im tinyc Ordner. Die fertigen Programme könnt ihr auf der TinyC Seite manuell hochladen. Den Sourcecode (tc) mĂŒsst ihr ĂŒber die TinyC IDE kompilieren oder via build.html lokal auf eurem PC.
  3. Dann starten und den Autostart aktivieren
    image
  4. Auf der Hauptseite in den Optionen ⚙ könnt ihr euren StromzĂ€hler wĂ€hlen und verschiedene andere Sachen einstellen.
  5. Updates: In der Slot-Zeile steht hinter dem Programmnamen seine Version. Gibt es im Repository eine neuere, erscheint ein 🔄-Knopf. Ein Klick lĂ€dt sie in denselben Slot, Einstellungen und Daten bleiben erhalten (Image ab 18.10.2026).

B) Tasmota Scripte (veraltet)

Scripte fĂŒr den kleinen ESP8266 findet ihr in einem extra Ordner. Die grĂ¶ĂŸeren/umfangreicheren Scripte fĂŒr ESP32 liegen im Hauptverzeichnis dieser Repo, spezielle Scripte fĂŒr PV-Akkus unter pvakku-powermeter-emulator. Die komprimierten Scripte (ohne Kommentare) liegen in script-list-menu/scripts. Diese lĂ€dt Tasmota ins Scripteditor Fenster, wenn ihr sie mit dem DropDown MenĂŒ ausgewĂ€hlt habt.

Die Scripte erstellen eine grafische Anzeige (Liniendiagramm) eures Verbrauches (Leistung [W]). Und zwar fein aufgelöst fĂŒr die letzten 4 Stunden, grob aufgelöst fĂŒr die letzten 24 Stunden und dann Tages und MonatsverbrĂ€uche [kWh] als Balkendiagramm. Ich habe ĂŒber die Zeit einige Varianten des Scriptes erstellt, die alle durch unterschiedliche Nutzeranfragen auf meinem Blog entstanden sind.
Info: Die TinyC-Programme enthalten alle diese Features als wÀhlbare Optionen.

Scriptauswahl direkt in Tasmota:
image
StromzÀhler/Pin-Auswahl:
image

Hauptverzeichnis (ESP32)

  • 0_SML_Simple
    einfaches ZĂ€hlerscript ohne Diagramme, zeigt nur die reinen Werte vom ZĂ€hler an
  • 1_SML_Script_Chart
    wenn ihr keine PV-Anlage / Balkonkraftwerk BKW habt (ohne Einspeisung)
  • 2_SML_Script_Chart_PV
    wenn ihr eure Einspeisung sehen möchtet und euer ZĂ€hler das unterstĂŒtzt (2-RichtungszĂ€hler)
  • 2_SML_Script_Chart_PV_Modbus
    wie das vorherige Script aber mit ModbusTCP Server (Slave) Support. Leistung, Verbrauch und Einspeisung werden auf den Modbus Adressen 40000-40006 ausgegeben.
  • 2_SML_Script_Chart_PV2
    wie _PV Script aber mit sehr hoch aufgelöstem 4h-Leistungs-Diagramm (alle 5s ein Wert)
  • 2_SML_Script_Chart_PV3
    wie _PV Script aber mit KalenderwochenĂŒbersicht ĂŒber das ganze Jahr, Bezug und Einspeisung = 53 Wochen
  • 3_SML_Script_Chart_PV_Bezugszaehler
    wie _PV Script aber fĂŒr 1-RichtungszĂ€hler (Netzeinspeisung in kWh wird berechnet)
  • 4_SML_Script_Chart_PV_no_4h24h
    wie _PV Script aber ohne 4h und 24h Diagramme
  • 5_SteckdoseLeistungsmesser_1
    wie 1_ Script jedoch fĂŒr Energiemess-Steckdosen (z.B. Sonoff POW Elite, SONOFF POW320D, NOUS A8T) Script nicht mehr fĂŒr ESP8266/8685 (Sonoff Pow R2, Nous A1T), schaut dazu in den Ordner ESP8266
  • 5_SteckdoseLeistungsmesser_2
    wie 5_ Script aber mit sehr hoch aufgelöstem 4h-Leistungs-Diagramm (alle 5s ein Wert)
  • 6_SML_Script_Wasseruhr
    Wasseruhr Script mit Diagrammen (Impulse)

pvakku-powermeter-emulator (ESP32) Diese Scripte emulieren einen Shelly Pro 3EM oder Ecotracker, die mit smarten Akkus verbunden werden (zur Nulleinspeisung). Das Script ist direkt auf dem Lesekopf lauffĂ€hig und ĂŒbernimmt neben dem StromzĂ€hler auslesen die Emulation.
Die Scripte sind bereits von mehreren Nutzern vielfach mit unterschiedlichen Akkus getestet wurden (siehe folgende Liste). Damit der Emulator vom Akku gefunden wird bzw. auch reibungslos lÀuft, sollte der Akku und der ESP/Lesekopf (auf dem der Emu lÀuft) eine gute WLAN Verbindung haben. Bei meinem Marstek Jupiter C Plus gabs nÀmlich Probleme, der Emulator wurde erkannt war aber danach sofort Offline. Der Akku hatte schlechten Empfang (im roten Bereich). Manche andere Akkus möglich es z.B. auch nicht, wenn sie mit unterschiedlichen Accesspoints/Repeatern im WLAN verbunden sind.

Beispiel mit mehreren Akkus:
3 Marstek (2 × B2500 und einmal Venus A) im Parallelbetrieb

Getestete Akkus: Liste mit getesteten Akkus

  • 1_SML_EcoTrackerEmu_Simple
    Sehr kleines und wirklich einfaches Script zum Emulieren eines EcoTracker von everHome.
    Es hat keine Diagramme sondern zeigt nur das nötigste (ZÀhlerwerte + Tages/Monats/Jahreswerte) an. Benötigt mein Tasmota Image V15.0.1 oder höher. Im Script ist eine grobe Beschreibung, wie ihr das alles zum Laufen bekommt. Weitere Infos auf meinem Blog oder im Forum!
  • 1_SML_ShellyEmu_Simple
    Einfaches Script zum Emulieren eines Shelly Pro 3EM.
    Es hat keine Diagramme sondern zeigt nur das nötigste (ZÀhlerwerte + Tages/Monats/Jahreswerte) an. Weitere Infos auf meinem Blog oder im Forum!
  • 2_SML_Script_Chart_PV_EcoTrackerEmu
    Wie 1_SML_EcoTrackerEmu_Simple aber Diagrammen (wie 2_SML_Script_Chart_PV). Es ist kleiner als das 2_SML_Script_Chart_PV_ShellyEmu und lÀuft bei mir aktuell auf dem bitShake ESP32-C3 Lesekopf zusammen mit dem Marstek Jupiter C Plus Akku einwandfrei. Weitere Infos auf meinem Blog oder im Forum!
  • 2_SML_Script_Chart_PV_ShellyEmu
    Wie 1_SML_ShellyEmu_Simple aber Diagrammen (wie 2_SML_Script_Chart_PV). Weitere Infos auf meinem Blog oder im Forum!

andere-scripte (ESP32)

  • 1_Script_DeepSleep
    ESP Tasmota Deepsleep Testscript (nur fĂŒr ESP32)
  • 2_Script_SML_Simulator
    emuliert ein MT175 StromzÀhler, einfach auf einen 2. Lesekopf aufspielen (ESP8266 / ESP32)
  • 3_TemperaturLoggerDS18S20
    Temperatur-Logger (10x DS18S20) fĂŒr eine Solarthermie-/Heizungsanlage. Benötigt SetOption64 1 (via Console) und #define DS18X20_MAX_SENSORS 10 (meine ESP32 oder tasmota1m_energy_ottelo_tas Images).

script-list-menu (ESP32)
Hier liegen die Scripte, die via DropDown direkt ĂŒber Tasmota auswĂ€hlbar sind.

  • meters = "StromzĂ€hler konfigurieren / Daten sichern" Button -> DropDown MenĂŒ
  • scripts = Tools -> Edit Script DropDown MenĂŒ

ESP8266
Alle Scripte (auch pvakku-powermeter-emulator) in der alten Version fĂŒr den kleinen ESP8266 und ohne ZĂ€hler-DropDown AuswahlmenĂŒ. Es sind die gleichen wie aus dem Hauptverzeichnis nur werden diese nicht mehr aktualisiert (eingeforener Versionstand). Die Scripte funktionieren natĂŒrlich auch auf einem ESP32. Hier findet ihr auch die pvakku-powermeter-emulator Scripte, die auf dem ESP8266 lauffĂ€hig sind. Hier gibt es keine Diagramme, da der ESP zu klein ist. Aber die Emulation lĂ€uft ebenfalls einwandfrei!
Neu: Marstek CT002 Emulator fĂŒr bis zu 4 Marstek-Akkus (2_CT002_Emulator.tas, von next145). DafĂŒr das Image tasmota1m_ct002_ottelo_tas aus meinem Image-Repo verwenden. Es hat die Seite Marstek CT002 (/ctreg, unter Tools) zur einmaligen Anmeldung in der Marstek-Cloud.

C) Testtools:

UDP/HTTP/PING/mDNS Tester
Ihr könnt die Emulation mit meinem PowerScript Tool testen (UDP, HTTP Get, Ping, mDNS). Die Vorgabe-Knöpfe nennen jeweils das GerÀt: EcoTracker, Shelly Pro 3EM oder Pro EM50:
image

SML Simulator
Gemu2015 hat ein SML Simulator Tool (simuliert einen x-beliebigen StromzĂ€hler) fĂŒr den Google Chrome Browser erstellt. Zum Simulieren eines StromzĂ€hlers wird ein USB Lesekopf am PC benötigt. Das Tool kann auch ZĂ€hlerscripte (Meter Descriptor) erstellen und auch direkt an Tasmota senden. Wieso Google Chrome Browser? Nur Chrome unterstĂŒtzt das serielle Interface.
image

D) Tasmota Image/Firmware

Die TinyC-Programme oder Skripte funktionieren nur, wenn ihr ein speziell angepasstes Tasmota Image (Firmware) verwendet. Die Images könnt ihr ebenfalls auf meiner github Seite. herunterladen. Wenn ihr sehen möchtet, welche Features ich beim Erstellen der Images verwendet habe oder ihr euer eigenes Image erstellen wollt, dann schaut in die Readme hier.

E) Anleitung

Ein passendes Tasmota Image von mir herunterladen (_tc fĂŒr TinyC oder _tas fĂŒr Script). Dann kann das Programm unter Tools > TinyC Console > Repository bzw. das Script unter Tools > Edit Script ausgewĂ€hlt werden. Ist das Programm oder Script geladen, wĂ€hlt ihr euren ZĂ€hler und die PINs (IR-Sende/Empfangsdiode eures Lesekopfes) ĂŒber die Option im HauptmenĂŒ aus. Wenn alles lĂ€uft und ihr auch eure ZĂ€hlerwerte sehen könnt, dann mĂŒsst ihr die Daten einmalig initialisieren, damit die Tages-, Monats-, und Jahreswerte und die Diagramme stimmen. Dazu tippt einfach auf den entsprechenden Button auf der Optionsseite. Alle Werte sind dann auf 0 zurĂŒckgesetzt! Wollt ihr von Script > TinyC wechseln und die Daten mitnehmen? Das geht mit dem Online Converter Tool.

ESP8266:
FĂŒr die "alten" Scripte im ESP8266 Ordner gilt: Skript herunterladen und z.B. mit dem Windows Editor öffnen (öffnen mit). Es gibt auch fĂŒr die Tasmota Skripte einen speziellen Editor vom Tasmota Script Entwickler gemu2015 den ihr hier herunterladen könnt. Dieser kann die Scripte direkt auf euren ESP ĂŒbertragen und entfernt dabei alle Kommentare und leere Zeilen um Platz zu sparen! Eine genauere Anleitung findet ihr auf meinem Blog oder auch in jedem Script.

Die Ă€lteren Scripte fĂŒr den ESP8266, dort könnt ihr euren ZĂ€hler nicht via DropDown wĂ€hlen. Den ZĂ€hler mĂŒsst ihr im Script editieren.
Sucht die Zeile
>M 1

Dort mĂŒsst ihr den SML Descriptor fĂŒr euren ZĂ€hler anpassen. Weitere Details auf meiner Seite!
Wenn ihr SML Zeilen entfernt oder hinzufĂŒgt, dann mĂŒsst ihr auch die Variablen im Script anpassen. Wenn die erste SML Zeile im Script z.B. 1,77070100100700ff@1,Leistung,W,Power_curr,0 ist, dann wird im Hintergrund von Tasmota die aktuelle Leistung Power_curr des ZĂ€hlers in die Variable sml[1] geschrieben. Die 2te und 3te Zeile (im Script ist das der Verbrauch und die Netzeinspeisung) werden in sml[2] und sml[3] geschrieben.

Wenn Tasmota und das Script lĂ€uft und ihr auch eure ZĂ€hlerwerte (Leistung, Bezug und ggf. Einspeisung) sehen könnt, dann mĂŒsst ihr das Script einmal initialisieren, damit die Tages-, Monats-, und Jahreswerte und die Diagramme stimmen. Dazu geht zur Tasmota Console und tippt ein script>=#init. Anschließend sollte alles stimmen.

F) Home Assistant Tasmota Integration

Korrektes Sensor-Mapping: Damit die Tasmota Integration die Werte vom StromzĂ€hler voll automatisch konfiguriert (device_class, state_class, unit) muss in der >M Meter Sektion fĂŒr jeden Wert ein korrekter Name vergeben werden.

Beispiel:
1,77070100100700ff@1,Leistung,W,Power,16
1,77070100010800ff@1000,Verbrauch,kWh,ImportActive,2
1,77070100020800ff@1000,Einspeisung,kWh,ExportActive,2

Wenn ihr euren ZĂ€hler ĂŒber mein ZĂ€hler DropDown MenĂŒ im Script ausgewĂ€hlt habt, dann werden bereits die korrekten Namen vergeben. Ich habe nĂ€mlich alle ZĂ€hlerscripte hĂ€ndisch angepasst!

Energie / Leistung

JSON-Key unit device_class state_class
Total kWh energy total
Today kWh energy total_increasing
Yesterday kWh energy —
TotalTariff kWh energy total
Energy kWh energy total
ExportActive kWh energy total
ExportTariff kWh energy total
ImportActive kWh energy total
ExportReactive kVArh — total
ImportReactive kVArh — total
Power W power measurement
ActivePower W power measurement
ApparentPower VA apparent_power measurement
ReactivePower VAr reactive_power measurement
Voltage V voltage measurement
Current A current measurement
CurrentNeutral A current measurement
Frequency Hz frequency measurement
Factor (None) power_factor measurement
PhaseAngle ° — —
TotalStartTime (None) — —
FĂŒr weitere siehe hier.

Werte der einzelnen Phasen

Namen wie power_L1, voltage_L1 oder current_L1 kennt die Tasmota Integration nicht. Home Assistant legt die Sensoren zwar an, aber ohne Einheit und device_class. Wer das haben möchte, trÀgt es in der configuration.yaml nach (Entity-ID an das eigene GerÀt anpassen):

homeassistant:
  customize:
    sensor.DEIN_GERAET_power_l1:
      unit_of_measurement: W
      device_class: power
      state_class: measurement

FĂŒr L2 und L3 genauso. Bei der Spannung nehmt ihr V und voltage, beim Strom A und current.


Bedanken möchte ich mich besonders bei gemu2015, der das Tasmota Scripting und SML entwickelt hat und mir immer sofort bei Problemen geholfen hat. Und natĂŒrlich beim restlichen Tasmota Entwickler-Team, fĂŒr das grandiose Tasmota :).

Die StromzĂ€hler Meter Definition habe ich teilweise von folgenden Quellen ĂŒbernommen und modifiziert:
Tasmota SML Wiki
Stromleser.tasmota Scripte
bitshake
DANKE !

Offizielle Tasmota Github Seite


Lizenz

Alles in dieser Repo steht unter der GPL-3.0 — dieselbe Lizenz wie Tasmota selbst, auf dem die Scripte und TinyC-Programme laufen.

Die Regelung des CT002/CT003-Emulators ist der CT002-Regelung von AstraMeter nachempfunden (ebenfalls GPL-3.0). Danke an tomquist.

Releases

Sponsor this project

Contributors

Languages