Erweiterte V3/MQTT-Server-Unterstützung

Für den hier bereitgestellten V3/MQTT-Serverdienst gibt es nun folgende Zusatzfunktionen:

1. Verbindungs- und V3-Livestatus
2. V3-Shell und Kommando-API
3. V3 Mail-Notifications
4. V3 Server­-Datenarchiv
5. V3 Fehlerüberwachung

Verbindungs- und V3-Livestatus

Zur Unterstützung der Shell-Funktion und Hilfe bei der Fehlersuche zeigen Fahrzeug-Editor, -Status und die Shells nun den aktuellen Verbindungsstatus des Moduls sowie der Peers (interaktiven Clients) für den V2- und V3-Server an.

Die über die V3-Verbindung erhaltenen wichtigsten Statusmetriken werden außerdem in V2-Statusdatensätze übersetzt, so dass auch ohne V2-Verbindung der aktuelle Live-Status des Fahrzeugs angezeigt werden kann. Die V3-Statusdaten ersetzen dabei die V2-Statusdaten auf dem Server, können also auch von einer V2-App oder über die V2-API abgerufen werden (jedoch ohne automatische Push-Aktualisierung). Um einen regulären parallelen V2-Betrieb nicht zu stören erfolgt dies automatisch nur, wenn die V2-Verbindung offline ist.

V3-Shell und Kommando-API

Die V3-Shell ermöglicht die interaktive Ausführung von Shell-Kommandos auf dem Modul über eine bestehende V3/MQTT-Verbindung. Vorteil gegenüber der Ausführung über die V2-Verbindung ist u.a. eine idR. erhöhte Geschwindigkeit, sowie die korrekte Wiedergabe von Kommata (das V2-Protokoll muss diese in Semikolon wandeln).

Nachteil ggü. der V2-Shell ist, dass über die V3-Shell (und API) keine V2/MP Protokoll-Kommandos ausgeführt werden können, sondern nur V3-Textbefehle. Auch die spezielle Syntax für Modem- und USSD-Kommandos wird hier nicht unterstützt, diese müssen über die V3-Kommandos cellular cmd und cellular sendussd gesendet werden.

Analog zur Kommando-API für die V2-Verbindung stellt der Server ebenfalls eine HTTP-REST-API für die Kommandoausführung per V3/MQTT-Verbindung zur Verfügung. curl-Beispiel:

curl 'https://dexters-web.de/api/ovms/cmd_v3' \
  --data-urlencode 'fn.vehicleid=MYCAR123' \
  --data-urlencode 'fn.carpass=mysecret' \
  --data-urlencode 'fn.cmd=charge start'

Details zur Nutzung beider Kommando-APIs sind hier im User-Guide erläutert.

V3 Mail-Notifications

Wichtige Meldungen sendet das Modul als Text-Push-Nachrichten. Wer diese ohne V2-Verbindung empfangen wollte, war bislang auf den Pushover-Client im Modul (Modul-UI Config→Pushover) angewiesen. Der Server kann diese nun wahlweise auch per Mail weiterleiten.

Diese Funktion wird im Fahrzeug-Editor aktiviert. Für Nutzer, die zeitweise eine V2- und V3-Verbindung gleichzeitig aktivieren, kann die Weiterleitung wahlweise nur dann erfolgen, wenn die V2-Verbindung offline ist.

Bei Bedarf können Push-Nachrichten modulseitig nach Kanal und Subtyp gefiltert werden, siehe User-Guide.

V3 Server-Datenarchiv

Das Modul sendet erweiterte Telemetriedaten ("Historical Records") als CSV-Datensätze auch an den V3/MQTT-Server, jedoch werden diese im Normalfall nur auf dem jeweils letzten Stand vorgehalten. Durch diese neue Option (aktivierbar im Fahrzeug-Editor) können diese nun auch in die V2-Datenbank übernommen werden. Bei Aktivierung werden auch die Live-Statusdaten für 24 Stunden aufgezeichnet, analog zur V2-Serverfunktion.

Die Daten können über das Download-Tool hier auf der Fahrzeug-Statusseite heruntergeladen werden, sowie über die V2-Server-API und die HTTP-REST-API abgerufen werden, und wahlweise täglich per Mail versendet werden. Wie bei der V2-Funktion versieht der Server beim Export bekannte Datensätze automatisch mit Feldnamen.

V3 Fehlerüberwachung

Um Nutzer bei der Einrichtung der V3-Verbindung zu unterstützen überwacht der Server nun die V3/MQTT-Verbindungen auf Problemmeldungen, und schickt ggf. Mails mit Hinweisen zu möglichen Fehlern in der Modul- bzw. Client-Konfiguration.