**__SITE UNDER CONSTRUCTION!__** Download {{ :plugins:renault_my_ze:loxberry-plugin-renault.zip |}} ====== Renault API ====== ++++ Version History...| **Version 0.1** ++++ ---- ===== 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: {{ :plugins:renault_my_ze: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 [[plugins:mqtt_gateway:start|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" | % | 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 | V**T**I | | | | | %%chargeEnergyRecovered(kWh)%% | | 16.5 | VI, **nicht** "als Digitaleingang verwenden" | | | noch keine Ahnung was dieser Wert aussagt....I | | %%ChargeMode%% | always_charging/schedule_mode | always_charging | V**T**I | | | 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" | 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 | V**T**I | | | %%Rückmeldung vom Fahrzeug (Text)%% | | %%HvAcStatusBin%% | 0/1 | 0 | VI, **nicht** "als Digitaleingang verwenden" | | | %%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" | km | Kilometerstand | | | %%Name%% | Auto-Name | %%Renault-Traffic%% | V**T**I | | | 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 [[plugins:renault_my_ze:start#daten_aktualität_überprüfen|>>hier<<]] | | %%Range%% | 0...800; numerisch | 229 | VI, **nicht** "als Digitaleingang verwenden" | km | Reichweite in km | | | %%RenaultPHMode%% | 1/2 | 2 | VI, **nicht** "als Digitaleingang verwenden" | Modus | | %%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´: {{:plugins:renault_my_ze:pasted:20240519-215747.png?400}} 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) {{:plugins:renault_my_ze:pasted:20240519-220013.png?400}} === 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 ==== {{:plugins:renault_my_ze:neue_bitmap.png?400&direct }} ===== 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 ). {{:plugins:renault_my_ze:neue_bitmap2.png?400 |}} {{:plugins:renault_my_ze:neue_bitmap3.png?400 |}} ===== Fragen stellen und Fehler melden ===== * Im Loxforum in diesem Thread: https://www.loxforum.com/forum/projektforen/loxberry/plugins/209316-renault-my-ze-plugin ====== Technische Details ======