Suche

    Spritmonitor (Benzinverbrauchsrechner)

    Dokumentation direkt aus GitHub Wilkware/FuelMonitor ↗

    Version Product Version License Actions

    Der Spritmonitor berechnet den Spritverbrauch und die Kosten eines Fahrzeugs und hilft bei der Verwaltung von Service- und TÜV-Terminen.

    1. Funktionsumfang

    Der Spritmonitor ist etwas mehr als ein reiner Verbrauchsmonitor:

    • Berechnung von Durchschnittsverbrauch (l/100 km) und Kosten (€/100 km) nach der Volltankmethode
    • Unterstützung von Erstbefüllung, Teil- und Volltankungen – Teilbetankungen werden bis zur nächsten Volltankung aufsummiert
    • Nachträgliche Erfassung von Tankvorgängen (Heute, Gestern, Vorgestern bzw. frei wählbares Datum)
    • Automatische Plausibilitätsprüfung von Menge, Literpreis und Rechnungsbetrag
    • Verwaltung der allgemeinen Fahrzeugdaten (Marke/Modell, Kennzeichen, Erstzulassung, Fahrzeugbild)
    • Überwachung von TÜV- und Service-Fälligkeiten (nach Datum und/oder Kilometerstand) mit farbiger Statusanzeige
    • Eigene Kachel für die TileVisu (HTML-SDK) mit Eingabemaske, Verbrauchsverlauf und Fälligkeitsanzeige
    • Speicherung aller Tankdaten im Archiv für eigene Auswertungen und Statistiken
    • Import & Export der Tankdaten als CSV-Datei zur Datensicherung

    2. Voraussetzungen

    • Symcon ab Version 8.1
    • Archive Control (Standard-Instanz in Symcon) – die Tankdaten werden ausschließlich im Archiv gespeichert
    • TileVisu für die Darstellung als Kachel

    3. Installation

    • Über den Module Store das Modul Spritmonitor installieren.
    • Alternativ über das Module Control folgende URL hinzufügen: https://github.com/Wilkware/FuelMonitor

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Spritmonitor-Modul (Alias: Benzinkostenrechner, Benzinverbrauchsrechner) unter dem Hersteller ‘(Geräte)’ aufgeführt.
    • Pro Fahrzeug wird eine eigene Instanz angelegt.
    • Ohne Archivierung kann das Modul keine Tankvorgänge speichern. Die Instanz bleibt deshalb inaktiv (Status: Archivierung ist nicht (korrekt) eingerichtet), bis die Archivierung aktiviert ist.
    • Dazu im Aktionsbereich der Konfiguration im Bereich 🗄️ Archivierung auf Archivierung aktivieren klicken. Der Bereich ist automatisch aufgeklappt, solange die Archivierung fehlt. Eingerichtet wird die Archivierung der Statusvariablen Kilometer (Aggregation: Zähler), Liter, Preis, Durchschnittsverbrauch und Kosten (Aggregation: Standard); danach ist die Instanz aktiv.
    • Bei bestehenden Instanzen aus älteren Versionen ist die Instanz nach dem Update ggf. ebenfalls inaktiv, bis die Aggregation über den Button angepasst wurde. Die vorhandenen Archivdaten bleiben dabei erhalten.
    • Ist ein Anfangs-Kilometerstand eingetragen, wird nach dem Aktivieren der Archivierung automatisch die Erstbefüllung angelegt.

    Konfigurationsseite:

    Einstellungsbereich:

    🚗 Fahrzeugdaten …

    NameBeschreibung
    Marke / ModellBezeichnung des Fahrzeugs, wird optional in der Kachel angezeigt
    KennzeichenNummernschild im Format XX-YY 1234 (optional mit E oder H)
    ErstzulassungDatum der Erstzulassung; daraus wird einmalig der erste TÜV-Termin (+3 Jahre) vorgeschlagen
    KilometerstandAnfangs-Kilometerstand (z. B. beim Gebrauchtkauf); wird bei leerem Archiv automatisch als Erstbefüllung eingetragen
    FahrzeugbildMedienobjekt (PNG, JPG, GIF, WEBP), das als Hintergrundbild der Kachel dient

    🛠️ Service & TÜV …

    NameBeschreibung
    TÜV-Überwachung aktivierenLegt die Variable TÜV-Fälligkeitstermin an und zeigt den TÜV-Status in der Kachel
    Erinnere X Tage vor FälligkeitAb wie vielen Tagen vor dem Termin der Status auf Warnung wechselt
    Serviceerinnerung aktivierenAktiviert die Service-Überwachung
    Nach Kilometerleistung verfolgenLegt die Variable Wartungsintervall (fälliger Kilometerstand) an
    Erinnere X km vor FälligkeitAb wie vielen Restkilometern der Status auf Warnung wechselt; gerechnet wird mit dem zuletzt erfassten Kilometerstand
    Nach Datum verfolgenLegt die Variable Wartungsdatum an
    Erinnere X Tage vor FälligkeitAb wie vielen Tagen vor dem Servicetermin der Status auf Warnung wechselt

    Sind Service nach Datum und nach Kilometer aktiv, zeigt die Kachel jeweils die dringendere Fälligkeit an. Die Fälligkeiten selbst werden über die Statusvariablen oder direkt in der Kachel (Stift-Symbol ✎) gepflegt.

    ✨ Visualisierung …

    NameBeschreibung
    Marken- und Modellbezeichnung anzeigen?Zeigt Marke/Modell vor dem Kennzeichen an (kann entfallen, wenn die Kachel schon so heißt)
    Farbe (Normal)Statusfarbe, wenn die Fälligkeit noch nicht im Erinnerungszeitraum liegt
    Farbe (Warnung)Statusfarbe innerhalb des Erinnerungszeitraums
    Farbe (Kritisch)Statusfarbe, wenn der Termin bzw. Kilometerstand erreicht oder überschritten ist

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Zeige Fehlermeldung wenn Datum in der Zukunft liegt!Einträge mit einem Datum in der Zukunft werden immer verworfen; die Option steuert nur, ob eine Meldung erscheint
    Zeige Fehlermeldung wenn Kilometerstand abnimmt!Einträge mit kleinerem oder gleichem Kilometerstand werden immer verworfen; die Option steuert nur, ob eine Meldung erscheint
    Erlaube Erstbefüllung nur beim ersten Speichern …Aktiv (Standard): eine Erstbefüllung ist nur bei leerem Archiv möglich. Inaktiv: eine erneute Erstbefüllung löscht alle bisherigen Archivdaten der Instanz und startet neu

    Aktionsbereich:

    🗄️ Archivierung …

    Zeigt an, ob die Archivierung korrekt eingerichtet ist, und bietet den Button Archivierung aktivieren (siehe oben).

    🔄 Import & Export …

    Import und Export sind nur bei aktiver Archivierung verfügbar, sonst sind die Bedienelemente ausgegraut.

    NameBeschreibung
    DateiCSV-Datei für den Import
    ImportierenErsetzt alle vorhandenen Tankdaten im Archiv durch den Inhalt der Datei (mit Sicherheitsabfrage)
    ExportierenLädt alle Tankdaten als CSV-Datei herunter (fuelmonitor_<Kennzeichen>_<Datum>.csv), dafür muss keine Datei ausgewählt werden

    Aufbau der CSV-Datei (Trennzeichen ;, Kopfzeile in der ersten Zeile):

    SpalteInhalt
    DateZeitpunkt der Betankung, z. B. 2026-02-02 08:30:00
    Type0 = Erstbefüllung, 1 = Teilbetankung, 2 = Volltankung
    MileageKilometerstand
    Litersgetankte Liter
    PricePreis je Liter
    AverageVerbrauch in l/100 km
    CostsKosten in €/100 km

    Hinweise:

    • Die Art der Betankung wird nicht archiviert. Beim Export wird sie aus den Daten abgeleitet (erster Eintrag = Erstbefüllung, Verbrauch > 0 = Volltankung, sonst Teilbetankung).
    • Verbrauch und Kosten werden beim Import unverändert übernommen, nicht neu berechnet. Der Bezugspunkt für die nächste Volltankung wird aus den importierten Daten wiederhergestellt.
    • Die Datei kann z. B. mit Excel bearbeitet werden. Beim Import werden auch , als Trennzeichen sowie Dezimalkomma und deutsches Datumsformat (02.02.2026 08:30) erkannt.
    • Die TÜV- und Service-Fälligkeiten sind nicht Teil der Datei.

    5. Statusvariablen

    Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

    IdentNameTypBeschreibung
    kilometersKilometerIntegerKilometerstand der Betankung
    litersLiterFloatgetankte Liter
    pricePreisFloatPreis je Liter
    averageDurchschnittsverbrauchFloatverbrauchte Liter je 100 km (nur bei Volltankung, sonst 0)
    costsKostenFloatKosten je 100 km (nur bei Volltankung, sonst 0)
    tuev_due_dateTÜV-FälligkeitsterminIntegernächster TÜV-Termin (wenn aktiviert)
    service_due_dateWartungsdatumIntegernächster Servicetermin (wenn aktiviert)
    service_due_mileageWartungsintervallIntegerKilometerstand, bei dem der nächste Service fällig ist (wenn aktiviert)

    Hinweis: Tankvorgänge vom aktuellen Tag werden ganz normal gesetzt und dabei archiviert. Nachträglich erfasste Tankvorgänge (z. B. von gestern) werden mit ihrem Datum direkt ins Archiv geschrieben und nicht in die Variable übernommen. Die Statusvariablen Kilometer bis Kosten zeigen daher nicht zwingend den zuletzt erfassten Tankvorgang – maßgeblich ist immer das Archiv.

    Berechnung (Volltankmethode):

    BetankungWirkung
    ErstbefüllungSetzt den Bezugspunkt (Kilometerstand), es wird noch kein Verbrauch berechnet
    TeilbetankungSpeichert die Werte, die getankten Liter werden bis zur nächsten Volltankung aufsummiert
    VolltankungVerbrauch = (Liter seit letzter Volltankung inkl. Teilbetankungen × 100) / gefahrene km; Kosten = Verbrauch × Literpreis

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    KilometerWertanzeigekm
    LiterWertanzeigel (2 Nachkommastellen)
    PreisWertanzeige€ (3 Nachkommastellen)
    DurchschnittsverbrauchWertanzeigel/100km (2 Nachkommastellen)
    KostenWertanzeige€/100km (2 Nachkommastellen)
    TÜV-FälligkeitsterminDatum/UhrzeitDatum
    WartungsdatumDatum/UhrzeitDatum
    WartungsintervallWerteingabekm

    7. Visualisierung

    Das Modul bringt eine eigene Kachel für die TileVisu mit (HTML-SDK). Dazu einfach die Instanz in der Visualisierung verlinken.

    Die Kachel bietet:

    • Fahrzeugbild als Hintergrund, Kennzeichen und optional Marke/Modell
    • TÜV- und Service-Status als farbige Badges (Normal/Warnung/Kritisch) mit Resttagen bzw. Restkilometern; am Fälligkeitstag erscheint „heute fällig“, danach „überfällig“
    • Korrektur der Fälligkeiten über das Stift-Symbol (✎)
    • Kennzahlen des letzten Eintrags (Kilometerstand, Verbrauch, Kosten) sowie den Verbrauchsverlauf als Diagramm und Tabelle
    • Eingabemaske für neue Tankvorgänge: Datum, Art der Betankung, Kilometerstand, Menge, Literpreis und Rechnungsbetrag. Von Menge, Literpreis und Rechnung werden zwei eingegeben, der dritte Wert wird automatisch berechnet.

    Alternativ können auch nur die Statusvariablen direkt verlinkt werden – dann bitte den Hinweis unter Statusvariablen beachten.

    8. Befehlsreferenz

    Das Modul stellt keine eigenen öffentlichen Funktionen bereit. Die Bedienung erfolgt über die Kachel bzw. über RequestAction auf die Statusvariablen:

    // TÜV-Termin setzen (Unix-Zeitstempel)
    RequestAction(IPS_GetObjectIDByIdent('tuev_due_date', $instanceId), strtotime('2027-05-31'));
    // Service fällig bei Kilometerstand
    RequestAction(IPS_GetObjectIDByIdent('service_due_mileage', $instanceId), 120000);
    

    9. Versionshistorie

    v3.0.20261007

    • NEU: Import & Export der Tankdaten als CSV-Datei zur Datensicherung (nur bei aktiver Archivierung)
    • NEU: Archivierung wird über einen Button im Aktionsbereich aktiviert, ohne Archivierung bleibt die Instanz inaktiv
    • NEU: Kachel vollständig übersetzt (Deutsch/Englisch)
    • NEU: Kilometerstand ist beim Speichern eines Tankvorgangs Pflicht
    • NEU: Hinweis im Log, wenn das gewählte Fahrzeugbild nicht (mehr) vorhanden ist
    • FIX: Fälligkeitsdatum wurde in der Kachel um einen Tag verschoben angezeigt bzw. gespeichert
    • FIX: Verbrauchsverlauf konnte bei unveränderten Werten Lücken aufweisen, Laden des Verlaufs deutlich beschleunigt
    • FIX: Teilbetankungen zeigten im Verlauf den Verbrauch der vorherigen Volltankung (Nullwerte wurden beim nächsten Speichern gelöscht)
    • FIX: Service-Restkilometer berücksichtigen nachträglich erfasste Tankvorgänge
    • FIX: TÜV/Service am Fälligkeitstag als „heute fällig“ statt „überfällig“
    • FIX: Aggregation der Liter im Archiv auf „Standard“ korrigiert (einmalig über den Button anpassen)
    • FIX: Darstellungen der Statusvariablen korrigiert (Wertanzeige statt Werteingabe)
    • FIX: Sicherheit und Stabilität verbessert (Systemstart, ungültige Eingaben, fehlendes Archiv)

    v2.0.20260730

    • NEU: Eigene Kachel für die TileVisu (HTML-SDK) mit Eingabemaske und Verbrauchsverlauf
    • NEU: Unterstützung von Teilbetankungen (Volltankmethode)
    • NEU: Fahrzeugdaten (Marke/Modell, Kennzeichen, Erstzulassung, Fahrzeugbild)
    • NEU: TÜV- und Service-Überwachung nach Datum und/oder Kilometerstand
    • NEU: Darstellungen statt Profile

    v1.1.20260714

    • FIX: Umstellung auf IPSModuleStrict
    • FIX: Bibliotheken und Formular überarbeitet

    v1.0.20220424

    • NEU: Initialversion

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skripte und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence