Metainformationen zur Seite
| Plugin-Daten | |
|---|---|
| Autor | Gagi |
| Logo |  |
| Status | STABLE |
| Version | 2.3 |
| Min. LB Version | 1.4 |
| Release | https://github.com/Gagi2k/LoxBerry-Plugin-WifiScanner/archive/v2.3.zip |
| Beschreibung | Scannt das Netzwerk nach Geräten und sendet den Status an den Miniserver. Zum Beispiel zur Anwesenheitserkennung. |
| Sprachen | EN, DE |
Dies ist eine alte Version des Dokuments!
| 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 das Renault an der Api wider etwas ändert oder das Sich die Api Keys ändern!
Download
Direkter Download-Link: loxberry-plugin-renault.zip
Funktion des Plugins
Auslesen einiger werte des 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, brauchst du nur 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 | Beschreibung | Anmerkung |
|---|---|---|---|---|---|
| BattSOC | 0..100 | 72 | VI, nicht digital | aktuelle Batterieladung in Prozent | - |
| BatTemp | N/A | nur bei PH1 | |||
| CableStatus | 0/1 | 1 | VI, digital | 0: nicht mit Ladesäule verbunden, 1: mit Ladesäule verbunden | z.B. Loxone Wallbox Eingang VC |
| chargeDuration(min) | 18 | VI, digital | |||
| chargeEndStatus | ok | ||||
| chargeEnergyRecovered(kWh) | 5.4 | ||||
| ChargeMode | always_charging/shedule | always_charging | VTI | Lademodus ´immer laden´ oder ´nach Zeitplan laden´ seitens Renault | |
| chargePower(kW) | 2.28 | ||||
| chargePowerAverage(kW) | 55 | ||||
| ChargingEffekt | numerisch | 16 | VI, nicht digital | noch keine Ahnung was dieser Wert aussagt….Ich glaube das sind die fehlenden % bis 100 | |
| ChargingStatus | 0/1 aber auch Werte -1.1 bzw. 10.2 wenn erfolgreich beendet? | 1 | VI, digital | 0: wird nicht geladen, 1: wird geladen | |
| ChargingTime | numerisch | 20 | VI, nicht digital | Ladedauer bis Ende bei der derzeitigen Ladeleistung in Minuten | |
| EnergieOnBoard | 41 | Im Akku gespeicherte Energie in kWh | |||
| GPS-Latitude | 52.851148888889 | Wenn freigeschaltet | |||
| GPS-Latitude_1 | GPS-Koordinaten Nord Teil 1 | 52.85 | Wenn freigeschaltet | ||
| GPS-Latitude_2 | GPS-Koordinaten Nord Teil 2 | 11488 | Wenn freigeschaltet | ||
| GPS-Latitude_3 | GPS-Koordinaten Nord Teil 3 | 88889 | Wenn freigeschaltet | ||
| GPS-Longitude | 9.6926638888889 | 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 | 9.69 | Wenn freigeschaltet | ||
| GPS-Longitude_2 | GPS-Koordinaten Ost Teil 2 | 266388 | Wenn freigeschaltet | ||
| GPS-Longitude_3 | GPS-Koordinaten Ost Teil 3 | 88889 | Wenn freigeschaltet | ||
| GPSTime | 10:27 | Timestamp 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 | Rückmeldung vom Fahrzeug (0/1) | ||
| LastDataRetrieval | HHMM | 0817 | ZeitStempel aktuelle Daten vom Renault Server | überprüfen ob Daten aktuell; Datenaktualität prüfen, siehe unten | |
| Mileage | 10000 | VI, nicht digital | Kilometerstand | ||
| Name | Auto-Name | Renault-Traffic | VTI | Der im Setup selbst vergebene Name des Fahrzeugs, wird auch in der MQTT Subscription verwendet | |
| OutTemp | N/A | nur bei PH1 | |||
| phpCall | HHMM | 0814 | ZeitStempel letzter Aufruf der PHP Datei | Datenaktualität prüfen, siehe >>hier<< | |
| Range | numerisch | 229 | VI, nicht digital | Reichweite in km | |
| RenaultPHMode | 2 | Im Setup 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 der virtuelle Ausgang mit folgender Adresse angelegt:
http://LoxberryBenutzername:LoxberryPasswort:LoxberryIPAdresse
Also z.B: http://loxberry:loxberry@192.168.1.100
Virtueller Ausgang Befehl "Werte aktualisieren"
Dieser Befehl ist zwingend erforderlich um die Werte abzurufen
Beim angelegten "Virtuellen Ausgang" legt man nun den "Virtuellen Ausgang Befehl" an.
Nachdem man eine Bezeichnung im Teil Allgemein des Befehls (z.B. Refresh) vergeben hat, fehlt nur noch:
Befehl bei Ein: /admin/plugins/Renault_API/index.php Daten vom Auto abrufen
Befehl bei Ein: /admin/plugins/Renault_API/history.php letzte Lade-Daten abrufen
Damit man nun den Befehl zur Aktualisierung der Werte ausführen kann, verknüpft man den Befehl mit einem einfachen Taster, der in der App visualisiert ist:
Komfortabler geht es, mit dem Impulsgeber Don 1s, Doff 120s öfter als alle 2 Minuten sollte nicht aktualisiert werden (kann eine Zeitsperre bei Renault auslösen), oder eine Kombination aus allem :)
Virtueller Ausgang Befehl "Laden Starten"
Befehl bei Ein: /admin/plugins/Renault_API/index.php?chargenow Ladung starten
Virtueller Ausgang Befehl "Vortemperieren"
Befehl bei Ein: /admin/plugins/Renault_API/index.php?acnow Heizung/Klima einschalten (ausschalten geht nicht)
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