Spritmonitor (Benzinverbrauchsrechner)

Dokumentation direkt aus GitHub Wilkware/FuelMonitor ↗

Version Product Version License Actions

Der Spritmonitor berechnet den Spritverbrauch und Kosten von einem Fahrzeugs und hilft bei der Serviceverwaltung.

1. Funktionsumfang

Der Spritmonitor ist eigentlich schon etwas mehr als ein reiner Verbrauchsmonitor:

  • berechnet den Durchschnitsverbrauch und die dazugehörenden Kosten
  • verwaltet die algemeinen Fahrzeugdaten
  • verwaltet und informiert bei fälligen Service und TÜV-Terminen
  • stellt alles zentral über TileVisu zur Verfügung

2. Voraussetzungen

  • Symcon ab Version 8.1

3. Installation

  • Über den Modul Store das Modul Sprintmonitor installieren.
  • Alternativ Über das Modul-Control folgende URL hinzufügen.
    https://github.com/Wilkware/FuelMonitor oder git://github.com/Wilkware/FuelMonitor.git

4. Einrichten der Instanzen in Symcon

  • Unter ‘Instanz hinzufügen’ ist das Sprintmonitor-Modul (Alias: Benzinverbrauchsrechner, Benzinkostenrechner) unter dem Hersteller ‘(Geräte)’ aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

🚗 Fahrzeugdaten …

NameBeschreibung
Marke / ModellDient nur zur besseren Fahrzeugverwaltung
KennzeichenNummernschild
ErstzulassungDatum der Erstzulassung (berechnet automatisch ersten TÜV-Termin)
KilometerstandDient zur einfachen Erstinitialisierung
Fahrzeugbildwenn vorhanden, dient als Hintergrundbild in der Visu

🛠️ Service & TÜV …

NameBeschreibung
TÜV-Überwachung aktivierenAktiviert Meldung bei TÜV-Fälligkeit
Erinnere X Tage vor FälligkeitEinstellung wieviel Tage vorher erinnert werden soll (Termin machen)
Serviceerinnerung aktivierenAktiviert Meldung für Service-Fälligkeit
Nach Kilometerleistung verfolgenEntscheidung, ob nach gefahrenen Kilometern informiert werden soll
Erinnere X km vor FälligkeitWird durch Tankkilometer gegengerechnet
Nach Datum verfolgenEntscheidung, ob nach festem Intervall (Datum) informiert werden soll
Erinnere X Tage vor FälligkeitEinstellung wieviel Tage vor Service erinnert werden soll (Termin machen)

✨ Visualisierung …

NameBeschreibung
Marken- und Modellbezeichnung anzeigen?Wird vor Nummernschild angezeigt und kann aber auch weggelassen werden (meistens heißt die Darstellung schon so)
Farbe (Normal)Darstellungsfarbe in Visu für Zustand “Alles easy”
Farbe (Warnung)Darstellungsfarbe in Visu für Zustand “Wird eng”
Farbe (Kritisch)Darstellungsfarbe in Visu für Zustand “Jetzt aber schnell”

⚙️ Erweiterte Einstellungen …

NameBeschreibung
Zeige Fehlermeldung wenn Datum in der Zukunft liegt!Nur Rückwirkend wenn kein Zwischendatum ist!
Zeige Fehlermeldung wenn Kilometerstand abnimmt!Bitte keine Manipulationen :)

5. Statusvariablen und Darstellungen

Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner zerstört die komplette Funktionalität!!!

Statusvariablen

NameTypBeschreibung
KilometerIntegergefahrene Kilometer (ob aktuell, abhängig vom Tankdatum)
LiterFloatgetankten Liter (ob aktuell, abhängig vom Tankdatum)
PreisFloatgetankten Liter (ob aktuell, abhängig vom Tankdatum)
DurchschnittsverbrauchFlaotverbrauchte Liter je gefahrene 100 Kilometer
KostenFlaotKosten je 100 Kilometer
TÜV-FälligkeitsterminIntegernächser TÜV-Termin (wenn aktiviert)
WartungsdatumIntegernächster Servicetermin (wenn aktiviert)
WartungsintervallIntegernächster Serviceintervall bei Kilometer X (wenn aktiviert)

HINWEIS: da man auch nachträglich (also nicht unbedingt am gleichen Tag) die Daten eingeben kann,
werden diese dann direkt ins Archive geschrieben und nicht mit SetValue. Dadurch müssen sie nicht immer den
aktuellsten Stand abbilden.

Darstellungen

Die Dartsellungen werden den Variablen über direkte Assoziazion zugewiesen.
Es werden keine Darstellungs-Templates angelegt.

6. Visualisierung

Man kann sowohl das gesamte Modul (HTML-SDK Support) als auch nur die Statusvariablen direkt in der Visualisierung verlinken. Bitte dann aber den obigen HINWEIS beachten!!!

7. PHP-Befehlsreferenz

Ein direkter Aufruf von öffentlichen Funktionen ist nicht notwendig!

8. Versionshistorie

v2.0 20260730

  • NEU: komplette Erweiterung durch neue Möglichkeiten in der TileVisu

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 Skript 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