Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 3.0.3 im Kanal Beta. Im Kanal Stable liegt noch die Version 2.0.3. Dort können Funktionen fehlen, die hier beschrieben sind.
Diese IP-Symcon Bibliothek berechnet Verbrauch und Kosten eines im Archiv geloggten Zählers über beliebige Zeiträume, mit Tarifwechseln, Hoch- und Niedertarif, Grundpreis, Prognose und dem Saldo der Abschläge. Das Modul Energierechner 2 ersetzt das bisherige Modul Energierechner, das aber erhalten bleibt.
Inhaltsverzeichnis
1. Voraussetzungen
- mindestens IPS Version 9.0 (ab Library-Version 3.0)
- eine Instanz Archive Control
- ein im Archiv geloggter Zähler für den Verbrauch (Aggregationstyp Zähler)
- bei dynamischen Preisen zusätzlich die im Archiv geloggte Preisvariable (Aggregationstyp Standard)
2. Funktionsumfang
- Verbrauch und Kosten für Heute, Gestern, Woche, Monat, Jahr, einzelne Tarifzeiträume und eigene Zeiträume
- Tarifwechsel, Hoch- und Niedertarif (mehrere Zeitfenster, Wochenende ganztägig) und dynamische Preise, zum Beispiel Börsenstrom
- Grundpreis taggenau, Abschläge und Saldo
- Prognose für Woche, Monat und Jahr, für Monat und Jahr mit dem Verlauf des Vorjahres
- Zählereinheiten kWh, Wh, Impulse, m³ (mit Umrechnung in kWh bei Gas) und Liter
- Zusatzwerte wie Durchschnittskosten je Tag, Vergleich mit dem Vorjahr, teuerster Tag und die Daten des aktuellen Tarifs
- Warnungen bei geänderten Archivdaten, fehlenden Preisen und vor dem Ende eines Tarifzeitraums
- Abfrage des aktuell gültigen Preises für Skripte
- Kachel-Visualisierung (experimentell)
- Übernahme der Einstellungen und Tarife aus dem bisherigen Energierechner
Die einzelnen Funktionen stehen bei den Instanzen unter “Enthaltene Module” und in der README des jeweiligen Moduls.
3. Enthaltene Module
- Energierechner 2
- Berechnet Verbrauch und Kosten eines Zählers für die gewählten Zeiträume und legt dafür Variablen an.
- Geräteinstanz, der Tarif kommt aus dem Energierechner Tarif 2.
- Energierechner Tarif 2
- Hält die Tarifabschnitte mit Preisen, Niedertarif, Grundpreis, Abschlag und Gaswerten.
- Splitterinstanz, mehrere Energierechner können sich einen Tarif teilen.
- Energierechner Kachel
- Zeigt einen festen Zeitraum eines Energierechner 2 als Kachel in der Kachel-Visualisierung.
- Anzeigeinstanz, experimentell.
- Energierechner
- Berechnet die Verbrauchskosten über mehrere Zeiträume mit unterschiedlichen Arbeitspreisen.
- Geräteinstanz, bisheriges Modul. Es bleibt unverändert erhalten, damit bestehende Installationen weiterlaufen.
- EnergierechnerTarif
- Hält den Tarif für den bisherigen Energierechner.
- Splitterinstanz, bisheriges Modul.
Für neue Installationen wird Energierechner 2 empfohlen.
4. Installation
Installation über den IP-Symcon Module Store.
5. Konfiguration in IP-Symcon
Als Erstes wird die Geräteinstanz Energierechner 2 angelegt. Die Tarif-Instanz Energierechner Tarif 2 wird dabei angeboten oder angelegt. In der Tarif-Instanz werden die Tarifzeiträume eingetragen, in der Geräteinstanz Verbrauchsvariable und Zählereinheit gewählt, die gewünschten Zeiträume angekreuzt und die Instanz aktiviert. Danach legt der Energierechner die Variablen an. Wer den bisherigen Energierechner nutzt, kann dessen Einstellungen und Tarife übernehmen (siehe Umstieg).
Die weitere Dokumentation steht in den einzelnen Modulen.
6. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
7. Lizenz
Dieses Modul wurde im Auftrag von 12systems GmbH entwickelt.
Changelog
Alle Versionen dieses Moduls, die neueste oben.
Version 3.0.3
- Neu: Die Energierechner Kachel kann auch Tarifzeiträume, die Summe und eigene Zeiträume anzeigen: Die Zeitraum-Auswahl listet alle Zeiträume des gewählten Energierechners.
Version 3.0.2
- Neu: Neue Option "Ertrag statt Kosten" für Einspeisung, zum Beispiel einer PV-Anlage: Variablen und Kachel heißen dann Ertrag statt Kosten.
- Neu: Neue Variable "Durchschnittsverbrauch je Tag" bei den Zusatzwerten, auch in der Kachel.
Version 3.0.1
- Neu: Neue Variable "Durchschnittsverbrauch je Tag" bei den Zusatzwerten, auch in der Kachel.
Version 3.0
- Neu: Neues Modul Energierechner 2 mit eigener Tarif-Instanz (Energierechner Tarif 2): Tarifwechsel, Hoch- und Niedertarif mit bis zu zwei Zeitfenstern und Wochenende, taggenauer Grundpreis, Abschläge und Saldo.
- Neu: Dynamische Preise (zum Beispiel Börsenstrom) aus einer geloggten Preisvariable.
- Neu: Prognose für Woche, Monat und Jahr, für Monat und Jahr mit dem Verlauf des Vorjahres.
- Neu: Zählereinheiten kWh, Wh, Impulse, m³ (mit Umrechnung in kWh bei Gas) und Liter.
- Neu: Warnungen im Formular und im Meldungsfenster, zum Beispiel bei geänderten Archivdaten oder fehlenden Preisen.
- Neu: Zusatzwerte als Variablen (Option): Durchschnittskosten je Tag, Vergleich mit dem Vorjahr, teuerster Tag sowie Preise und Ende des aktuellen Tarifs.
- Neu: Warnung vor dem Ende des Tarifzeitraums, einstellbar in Tagen.
- Neu: Die Funktionen ER2GetPrice und ER2TGetPrice liefern den aktuell gültigen Preis (HT, NT oder dynamisch) als Ersatz für ERgetPrice.
- Neu: Kachel-Visualisierung (experimentell) mit Zeitraumwechsel, Kosten, Verbrauch, Prognose, Saldo, Vorjahresvergleich, Tarif und Details.
- Neu: Die Kachel zeigt bei Gas den Verbrauch in m³ und kWh und den Preis je kWh.
- Neu: Neue Instanz Energierechner Kachel: zeigt einen festen Zeitraum eines Energierechners, so lassen sich mehrere Kacheln mit verschiedenen Zeiträumen anlegen.
- Neu: Die automatische Berechnung lässt sich abschalten, dann rechnet das Modul nur auf Anforderung (Jetzt berechnen, ER2UpdateCalculation).
- Neu: Die Einstellungen und Tarife eines alten Energierechners lassen sich übernehmen.
- Fix: Die Kachel nennt beim Effektivpreis die Einheit des Zählers (zum Beispiel je m³ bei Wasser) statt immer kWh.
- Fix: Der Grundpreis wird taggenau gerechnet, auch in Schaltjahren und bei Tarifwechseln mitten im Zeitraum.
- Fix: Zeiträume über Mitternacht und mit mehreren Tarifwechseln werden bei Nachttarif korrekt gerechnet.
- Achtung: Die Bibliothek braucht ab Version 3.0 Symcon 9.0.
- Achtung: Der Energierechner 2 ist ein neues Modul neben dem unveränderten alten, und weil seine Variablen neu heißen (ohne Datum), müssen Verknüpfungen und Skripte angepasst werden.
- Achtung: Bei laufenden Zeiträumen zählt der Grundpreis nur bis heute, der Saldo nutzt den bis heute aufgelaufenen Abschlag, und das Aktualisierungsintervall steht in Minuten.
- Achtung: Bei Gas setzt die Übernahme die Zählereinheit m³ mit Umrechnung in kWh, bereits übernommene Instanzen müssen einmal von Hand auf m³ umgestellt werden.
Version 2.0.5 Beta
- Neu: Methode getGasCalculationValues öffentlich gesetzt
Version 2.0.4 Beta
- Neu: Experten Einstellungen "Durch Parameteränderung aktualisieren"
- Fix: Übersetzungen
Version 2.0.3
- Neu: Abschläge pro Jahr können in der Tarife Instanz hinterlegt werden
- Neu: Calculate Funktion auf öffentlich gesetzt
- Neu: Nach Änderung der Tarife Instanz wird nun die Berechnung erneut durchgeführt
- Fix: Berechnung aktuelle Woche: Der Sonntag fehlte
- Fix: Bei der Gas zu kWh Berechnung konnte es zu Fehlern kommen
- Fix: Nachkommastellen für Tagespreis, Nachtpreis und Grundpreis geändert
- Fix: Wenn keine Perioden im Buffer waren gab es bei der Gas Berechnung ein Problem
Version 2.0.2
- Neu: Aktuelle Woche
- Neu: Funktion getPrice
- Neu: Gaspreisberechnung m² to kWh
- Neu: Zeitraum für das letzte Jahr
- Neu: Profil Liter
- Fix: Bei indivudelle Perioden wurden bei einer Änderung die Kostenvariablen neu angelegt
- Fix: Letzte Woche funktioniert wieder
- Fix: Übersetzung für Current Year Consumption (nighttime)
- Fix: Für die Benennung des tägliche und nächtlichen Verbrauch in der Form
- Fix: Tarife Instanz: Die Anzeige der Liste wurde auf 30 Einträge vergrößert
- Fix: Tarife Instanz: Die Anzeige der Liste wird nach Startdatum sortiert
Version 2.0.1
- Neu: Berechnungszeitraum aktuelles Jahr
- Neu: Grundpreis Berechnung ist standardmäßig deaktiviert.
- Neu: Profil für Wh hinzugefügt
- Fix: Nach einem Neustart von Symcon funktioniert die Berechnung nun korrekt.
Version 2.0
- Neu: Energierechner mit Nachtstunden Tarif
- Neu: Auswahl von Berechnungszeiträumen (Zeitraumberechnung anhand der Perioden, Täglich, Vortag, Vorwoche, Aktueller Monat, Letzter Monat, Individuelle Zeiträume)
- Neu: Aktualisierungszeit kann eingestellt werden
- Neu: Integervariablen können auch als Verbrauchsvariable hinterlegt werden
- Neu: Umrechnung von Impulszählern (Experteneinstellungen)
- Neu: Die Tarife werden in einem Splitter gepflegt, somit können mehrere Zähler überwacht werden, ohne das die Tarife immer erneut gepflegt werden müssen
- Neu: Pro Zeitraum kann ein Grundpreis hinterlegt werden
- Neu: Der Name des Anbieters kann hinterlegt werden
- Neu: Es kann ausgewählt werden, welche Einheit genutzt werden soll (kWh, m³)
- Neu: Verbräuche können tags- und nachtsüber ermittelt werden