Skip to content

lorbetzki/net.lorbetzki.zoe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Renault Zoe

Modul für Symcon ab 5.5 Erlaubt es eine Renault Zoe Phase 1/2 an Symcon anzubinden und Fahrzeug- sowie Batteriedaten auszulesen und wahlweise als Variable zu speichern.

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Software-Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. WebFront
  7. PHP-Befehlsreferenz
  8. Bekannte Bugs

1. Funktionsumfang

  • Auslesen von Batteriedaten (Akkustand, Restreichweite, Kapazität, usw)
  • Auslesen der Fahrgestellnr und Gesamtkilometerstand
  • starten der Klimatisierung

grafik

2. Vorraussetzungen

  • IP-Symcon ab Version 5.5
  • Einen Renault Zoe Phase 1/2, Renault Twingo oder einen Dacia Spring

3. Software-Installation

  • Über den Module Store das 'Renault ZE'-Modul installieren.

4. Einrichten der Instanzen in IP-Symcon

Unter 'Instanz hinzufügen' kann das 'Renault ZE'-Modul mithilfe des Schnellfilters gefunden werden.
- Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen

Im Anschluss muss im Konfigurationsformular des Moduls die Mailadresse sowie das Passwort von MyRenault eingegeben und das Modell sowie das Land ausgewählt werden. Nachdem Ihr die Änderung übernommen habt, klickt im Aktionsbereich auf "Erstmaliger Login". Hat alles geklappt habt Ihr diverese Auswahlmöglichkeiten.

Konfigurationsseite:

Name Beschreibung
Email Adresse Eingabe der Mailadresse mit der man in der MyRenault App angemeldet ist
Passwort ratet mal ;)
Modell Hier wählt ihr eurer Fahrzeug aus, dahingehend werden die Variablen
Phase 1 Q90, R90, R110, Q210, R210, R240 ausgelesen und gefüllt.
Phase 2 R110 Z.E.40/50 und R135 Z.E.50
Renault Twingo
Dacia Spring
Land auswahl des Landes auf dass das Fahrzeug in der My Renaul App registriert ist.

Konfigurationsseite erreichbar nach dem Klick auf "Erstmaliger Login":

Name Beschreibung
Welche Variablen sollen erstellt werden? Hier können bestimmte Variablen ab-/angewählt werden.
Akkustand Akkustand in %
Batteriekapazität die Kapazität der Batterie. Nicht überall verfügbar.
Restreichweite in KM Restreichweite in KM
Restkapazität in kWh Restkapazität im Akku in kWh
Ladekabelstatus 1 = eingesteckt, 0= nicht eingesteckt
Ladestatus gibt verschiedene Ladestati an: -1.1 = nicht Verfügbar, -1 = FEHLER beim laden, 0 = lädt nicht, oder nicht eingesteckt, 0.1 = Warte auf geplante Ladung, 0.2 = Ladung beendet, 0.3 = warte auf aktuelle Ladung, 0.4 = Energy flap opened, 1 = Fahrzeug lädt.
Laderestzeit Laderestzeit bis 100% erreicht ist in min.
letzte Änderung Akkustand
Gesamt-KM gesamte gefahrene KM.
Fahrgestellnr. die Fahrgestell-Nr.
Klimatisierung starten dies ist ein Aktionsknopf und erlaubt das fernstarten der Klimatisierung
Fahrzeugbild speichern lädt das Fahrzeugbild runter und speichert es als Media
Erweiterte Einstellung
Kameron Api ID Die Kameron Api ID sorgt dafür das eine Verbindung zum Renault-Server aufgebaut werden kann gelegentlich wird diese Api-ID geändert. Hier kann dieser neu hinzugefügt werden.
Intervall in minuten Intervall in min. in der die Variablen aktualisiert werden. Ich rate von max. alle 5 min da die Renaultserver gerne mal den Zugang für 24h blockieren bei zu häufigen Abfragen
Standort des Fahrzeug
GPS Latitude schreibt die Latitude in eine Variable
GPS Longitude schreibt die Longitude in eine Variable
letzte Änderung der GPS Koordination was wurde der letzte Status übermittelt
Fahrzeug in Google maps anzeigen zeigt in Google Maps den aktuellen Aufenthaltsort an, es wird eine GoogleMaps API Key benötigt
GoogleMaps API Key die GoogleMaps API Key wird hier eingetragen.

Aktionsbereich während der ersten Einrichtung:

Name Beschreibung
Erstmaliger Login Anhand der eingegeben Benutzer und Fahrzeugdaten wird ein Benutzer-Token, eine persönliche-ID, eine Fahrzeug-ID und eine Account-ID generiert bzw. abgeholt. Zudem werden statische Infos wie die VIN oder das Fahrzeugbild abgefragt. Erst nach Ablauf dieser Prozedur werden weitere Funktionen aktiviert.

Aktionsbereich nach der Einrichtung:

Name Beschreibung
Aktualisiere Token es wird alle paar Stunden automatisiert ein Benutzer Token benötigt und automatisiert erstellt dieser Button forciert das und man bekommt den Token direkt erneuert.
Aktualisiere Daten holt die Daten manuell ab und aktualisiert die Variablen

5. Statusvariablen und Profile

Die Statusvariablen/Kategorien werden automatisch angelegt. Das löschen einzelner kann zu Fehlfunktionen führen.

Statusvariablen

Name Typ Beschreibung
Akkustand integer zeigt den Akkustand in % an
Batteriekapazität integer zeigt die Batteriekapazität in kWh an,
Fahrgestellnr. string Fahrgestellnr. des Fahrzeugs
Gesamt-KM integer gesamt gefahrene KM
Google Maps string Google maps Karte
GPS Latitude float GPS Latitude
GPS Longitude float GPS Longitude
Klimatisierung boolean Script zum starten der Klimatisierung
Ladekabelstatus integer gibt den Zustand des Ladeports an. Steckt das Kabel im Fahrzeug (1) oder nicht (0)
Laderestzeit integer Restladedauer (unplausible Werte)
Ladestatus float
letzte Änderung Akkustand integer letzte mitgeteilte Änderung des Akkustands
letzte Änderung der GPS Koordination integer letzte mitgeteilte Änderung der GPS Koordination
Restkapazität in kWh integer wieviel Rest ist im Akku in kWh
Restreichweite in KM integer theoretische Restreichweite laut Bordcomputer
Fahrzeugbild media das Fahrzeugbild

Profile

Name Typ Beschreibung
RZE_ChargingStatus float div Information zum Ladestatus

6. WebFront

neben auswählbaren Fahrzeugbezogenen Variablen, lässt sich, je nach Modell und aktivierten und vorhandener Googlemaps-API Key der Standort vom Fahrzeug anzeigen und auf einer HTML-Map anzeigen. Zudem kann man, sofern aktiviert, die Vorklimatisierung starten.

7. PHP-Befehlsreferenz

RZE_FirstRun(int $InstanceID);

INTERNE FUNKTION: ist eine interne Funktion und ruft nacheinander die API ID ab und aktualisert einmalig alle Daten.

RZE_HVAC(int $InstanceID);

INTERNE FUNKTION: ruft die Funktion RZE_startClimate() auf

RZE_UpdateData(int $InstanceID);

INTERNE FUNKTION: aktualsiert alle Daten und setzt die Variablen

RZE_UpdateToken(int $InstanceID);

INTERNE FUNKTION: ruft intervallmäßig die Funktion RZE_GetToken() auf.

RZE_SetFirstRunDoneManually(int $InstanceID);

Betatester die eine Instanz vor Version 1.2 installiert haben, müssen diese Funktion einmalig ausführen. Am einfachsten führt Ihr ein Rechtsklick auf eure Instanz auf, wählt "Befehle testen" und sucht nach obiger Funktion und klickt auf "ausführen". Nun könnt Ihr in der Instanz wieder alle Optionspanele sehen.

8. Bekannte Bugs

  • Optionspanele einer vorhanden Instanz sind verschwunden

Wer eine Beta vor Version 1.1 installiert hat, wird beim öffnen der Instanz feststellen, das die Panele für die Variablenauswahl, erweitere Optionen und ggf auch das Panel für die GPS Daten nicht mehr vorhanden sind. Grund ist, das diese erst nach dem durchlaufen des "First Run" sichtbar gemacht werden. Diese Funktion ist aber nach dem ausführen nicht mehr auswählbar.

Am einfachsten führt Ihr ein Rechtsklick auf eure Instanz auf, wählt "Befehle testen" und sucht nach der Funktion "RZE_SetFirstRunDoneManually" und klickt auf "ausführen". Nun könnt Ihr in der Instanz wieder alle Optionspanele sehen.

About

Renault Zoe Module for Symcon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages