Metainformationen zur Seite
| Plugin-Daten | |
|---|---|
| Autor | Fenzl / Bazala / Dercasy |
| Logo |  |
| Status | UNSTABLE |
| Version | 0.1 |
| Min. LB Version | 1.4.2 |
| Beschreibung | Das Plugin stellt eine Schnittstelle (Informationen und Befehle) zur Renault-API her, und unterstützt die Datenübermittlung MQTT. |
| Sprachen | DE |
| Diskussion | https://www.loxforum.com/forum/projektforen/loxberry/plugins/209316-renault-my-ze-plugin |
SITE UNDER CONSTRUCTION!
Download loxberry-plugin-renault.zip
Renault API
Präambel
Da sich die API von Renault geändert hat, funktioniert das Plugin MY Zoe nicht mehr.
Ich habe die PHP Version von https://github.com/db-EV/ZoePHP angepasst für den Loxberry bzw. bin noch dabei.
Es kann natürlich sein, dass Renault an der API wieder etwas ändert oder das sich die API Keys ändern!
Download
Direkter Download-Link: loxberry-plugin-renault.zip
Funktion des Plugins
Auslesen einiger Werte des Renault Autos über den Renaultserver. Das Auslesen muss für die Renault-App freigeschaltet sein.
Konfigurationsoptionen
hier Benutzername, Passwort, PH1 oder PH2 (siehe weiter unten) und VIN Nummer eingeben
Renault Type
PH1 ist bis ca Baujahr 2019
* Kilometerstand
* Charger Connected
* Charging
* Akkustand
* HvAC Status
* Batterietemperatur
* Außen Temperatur
* Akkustand
PH2 ist ab ca Baujahr 2019
* Kilometerstand
* Charger Connected
* Charging
* Akkustand
* HvAC Status
* Energie im Akku
* Reichweite
Wenn freigeschaltet
* GPS Daten
* GPS Time
Datenübermittlung MQTT
Wenn du das MQTT Gateway Plugin installiert hast bzw. ab Loxberry Version 3 brauchst du nur unter MQTT Gateway → MQTT Subscriptions das Topic Renault/# angeben und alle anderen Felder leer lassen. Das Plugin holt sich die Einstellungen vom MQTT Gateway Plugin.
Das Plugin sendet als zweite Topic-Hierarchie den Auto-Namen und danach die Daten.
Einrichtung in der Loxone Config Software
Virtueller Eingang
In der Loxone Config unter "Virtuelle Eingänge" jeweils einen neuen "Virtueller Eingang" (VI) bzw. "Virtueller Texteingang" (VTI) anlegen und unter "Bezeichnung" dann den entsprechenden Befehl nach dem Schema Renault_Auto-Name_Befehl (dabei ist ´Auto-Name´ wie in den Settings des Loxberry Plugins angegeben). Befehl gemäß Tabelle, also z. B. Renault_Renault Twingo_BattSOC
Nachfolgende virtuelle Eingänge können angelegt werden. Der Syntax ist immer gleich:
| Befehl | Wertebereich | Beispiel | in Loxone | Einheit | Beschreibung | Anmerkung |
|---|---|---|---|---|---|---|
| BattSOC | 0..100 | 72 | VI, nicht "als Digitaleingang verwenden" | <v> % | aktuelle Batterieladung in Prozent | - |
| BatTemp | N/A | nur bei PH1 | ||||
| CableStatus | 0/1/3 | 1 | VI, nicht "als Digitaleingang verwenden" | 0: nicht mit Ladesäule verbunden, 1: mit Ladesäule verbunden, 3: keine Ahnung | z.B. Loxone Wallbox Eingang VC | |
| CargingStatus | 0/1 - im Loxberry MQTT unter Last transmissions to Miniserver aber auch schon Wert -1.1 gesehen | 1 | VI, digital | 0: wird nicht geladen, 1: wird geladen | Achtung: nur ein ´C´ am Anfang des Befehls, kein ´Ch´ | |
| chargeDuration(min) | 18 | VI, nicht "als Digitaleingang verwenden" | Dauer des aktuellen Ladevorgangs in Minuten | |||
| chargeEndStatus | ok | VTI | ||||
| chargeEnergyRecovered(kWh) | 16.5 | VI, nicht "als Digitaleingang verwenden" | noch keine Ahnung was dieser Wert aussagt….I | |||
| ChargeMode | always_charging/schedule_mode | always_charging | VTI | Lademodus ´immer laden´ oder ´nach Zeitplan laden´ seitens Renault | ||
| chargePower(kW) | 2.28 | VI, nicht "als Digitaleingang verwenden" | ||||
| chargePowerAverage(kW) | 55 | VI, nicht "als Digitaleingang verwenden" | evtl. Ladeleistung (5,5 kW) | |||
| ChargingEffekt | numerisch | 16 | VI, nicht "als Digitaleingang verwenden" | noch keine Ahnung was dieser Wert aussagt….Ich glaube das sind die fehlenden % bis 100 | ||
| ChargingTime | numerisch | 20 | VI, nicht "als Digitaleingang verwenden" | <v> Min | vollständig geladen in xx Minuten bei der derzeitigen Ladeleistung | |
| EnergieOnBoard | 41 | VI, nicht "als Digitaleingang verwenden" | Im Akku gespeicherte Energie in kWh | |||
| GPS-Latitude | 52.85114889 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet | |||
| Koordinaten wurden geteilt (Übertragungslänge) und können mit dem Statusbaustein wider zusammengesetzt werden. Im Statusbaustein ist es dann auch möglich, wenn das Auto zu Hause ist das Laden freizugeben | ||||||
| GPS-Latitude_1 | GPS-Koordinaten Nord Teil 1 | 52.85 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 4-stellig | ||
| GPS-Latitude_2 | GPS-Koordinaten Nord Teil 2 | 11488 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 5-stellig | ||
| GPS-Latitude_3 | GPS-Koordinaten Nord Teil 3 | 9 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 1-stellig | ||
| GPS-Longitude | 11.69266389 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet | |||
| Koordinaten wurden geteilt (Übertragungslänge) und können mit dem Statusbaustein wider zusammengesetzt werden. Im Statusbaustein ist es dann auch möglich, wenn das Auto zu Hause ist das Laden freizugeben | ||||||
| GPS-Longitude_1 | GPS-Koordinaten Ost Teil 1 | 11.69 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 4-stellig | ||
| GPS-Longitude_2 | GPS-Koordinaten Ost Teil 2 | 26638 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 5-stellig | ||
| GPS-Longitude_3 | GPS-Koordinaten Ost Teil 3 | 9 | VI, nicht "als Digitaleingang verwenden" | Wenn freigeschaltet; Wert bei Renault Twingo 1-stellig | ||
| GPSTime | HH:MM | 10:27 | VI, nicht "als Digitaleingang verwenden" | Zeitstempel vom letzten empfangenen GPS Signal | Wenn freigeschaltet | |
| HvAcStatus | 0 wenn aus; 1 wenn ein | 0 | VTI | Rückmeldung vom Fahrzeug (Text) | ||
| HvAcStatusBin | 0/1 | 0 | VI, nicht "als Digitaleingang verwenden" | <v> | Rückmeldung vom Fahrzeug (0/1) | |
| LastDataRetrieval | HHMM | 0817 | VI, nicht "als Digitaleingang verwenden" | Zeitstempel - letzte Aktualisierung der Daten vom Renault Server | überprüfen ob Daten aktuell sind, siehe unten | |
| Mileage | 0…500000 | 12853 | VI, nicht "als Digitaleingang verwenden" | <v> km | Kilometerstand | |
| Name | Auto-Name | Renault-Traffic | VTI | Der im Setup des Plugins selbst vergebene Name des Fahrzeugs, wird auch in der MQTT Subscription verwendet | ||
| OutTemp | N/A | nur bei PH1 | ||||
| phpCall | HHMM | 0814 | VI, nicht "als Digitaleingang verwenden" | Zeitstempel - letzter Aufruf der PHP Datei | Datenaktualität prüfen, siehe >>hier<< | |
| Range | 0…800; numerisch | 229 | VI, nicht "als Digitaleingang verwenden" | <v> km | Reichweite in km | |
| RenaultPHMode | 1/2 | 2 | VI, nicht "als Digitaleingang verwenden" | Modus <v> | Im Setup des Plugins vorgegebener Renault Typ | |
Wichtig Die Werte werden nicht automatisch aktualisiert. Man muss hier noch den Weg über einen automatisierten oder manuellen Trigger arbeiten. Siehe nächstes Kapitel
Virtuelle Ausgänge
Zunächst wird in der Loxone Config unter "Virtuelle Ausgänge" ein "Virtuelle Ausgang" mit der Bezeichnung z. B. "Renault" und der Adresse http://LoxberryBenutzername:LoxberryPasswort@LoxberryIPAdresse
- also z. B. http://loxberry:loxberry@192.168.1.100 -
angelegt.
Virtueller Ausgang Befehl zum Aktualisieren der Werte
Diese Befehle sind zwingend erforderlich, um die Werte abzurufen!
Beim angelegten "Virtueller Ausgang" legt man nun mehrere "Virtueller Ausgang Befehl"e an.
Virtueller Ausgang Befehl "Daten vom Auto abrufen"
Nachdem man eine Bezeichnung im Teil "Allgemein" des Befehls (z. B. ´Refresh´ oder ´Daten vom Auto abrufen´) vergeben hat, fehlt nur noch unter
´Befehl bei Ein:´ /admin/plugins/Renault_API/index.php
Virtueller Ausgang Befehl "letzte Lade-Daten abrufen"
Nachdem man eine Bezeichnung im Teil "Allgemein" des Befehls (z. B. ´letzte Lade-Daten abrufen´) vergeben hat, fehlt nur noch unter
´Befehl bei Ein:´ /admin/plugins/Renault_API/history.php
Damit man nun den Befehl zur Aktualisierung der Werte ausführen kann, verknüpft man jeweils einen einfachen Taster, der in der App visualisiert ist, mit dem jeweiligen ´Virtuellen Ausgang Befehl´:
Komfortabler geht es, wenn man jeweils zusätzlich den Baustein "Impulsgeber" (sieht anders aus als im Bild unten) mit den Werten
Don - duration on [s] 1
Doff - duration off [s] 120
zusätzlich mit dem jeweiligen ´Virtueller Ausgang Befehl´ verbindet. Öfter als alle 2 Minuten sollte nicht aktualisiert werden (kann eine Zeitsperre bei Renault auslösen)
Virtueller Ausgang Befehl "Laden Starten"
Befehl bei Ein: /admin/plugins/Renault_API/index.php?chargenow Ladung starten
Damit man nun den Befehl zum Starten des Ladevorgangs ausführen kann, verknüpft man einen einfachen Taster, der in der App visualisiert ist, mit dem ´Virtuellen Ausgang Befehl´.
Virtueller Ausgang Befehl "Vortemperieren"
Befehl bei Ein: /admin/plugins/Renault_API/index.php?acnow Heizung/Klima einschalten (ausschalten geht nicht)
Damit man nun den Befehl zur Vortemperierung ausführen kann, verknüpft man einen einfachen Taster, der in der App visualisiert ist, mit dem ´Virtuellen Ausgang Befehl´. Oder auch noch (zusätzlich) einen Baustein "Schaltuhr" um das Fahrzeug zu bestimmten Tagen zu bestimmten Uhrzeiten vorzutemperieren.
Daten Aktualität überprüfen
GPS-Auswertung
Die Daten werden nur übertragen wenn es bei Renault freigeschaltet ist und nur beim Typ PH2
Im Statusbaustein bei I3 etwas nach oben und unten dazugeben, weil man ja nicht immer genau am selben Fleck steht.
Mit dem Merker könnte man dann die Ladestation freigeben, damit nur das eigene Fahrzeug Energie bekommt, oder mit der Alarmanlage koppeln.
Es ist auch möglich Szenen im Haus auszulösen bei Ankunft (z.B.: Frau vorwarnen zum Essen herrichten oder so 
oder vorgewarnt werden wenn Frau nach Hause kommt ).
Fragen stellen und Fehler melden
- Im Loxforum in diesem Thread: https://www.loxforum.com/forum/projektforen/loxberry/plugins/209316-renault-my-ze-plugin