Mercedes EQ SoC Modul #823

DetMoerk · 2020-12-28T11:03:40Z

First Beta of a Mercedes EQ SoC Module ussing the API at https://developer.mercedes-benz.com/products/electric_vehicle_status.
As every User has to create his own account at developer.mercedes-benz.com (BYOCAR= Bring your own Car), configuration has some traps. I will try to bring a step-by-step documentation in openwb Forum and here.
Requirements:

Mercedes Me Account
FIN (VIN) of own Car
Make sure that your car has "Schnittstelle Drittanbieter: Fahrzeugdaten" active. Got to Mercedes Me App/Garage/Diensteverwaltung/Komfort.

Steps to get a API Access:
1. Go to the Mercedes Developer Site

2. Login (upper right corner) using your MercedesMe Credentials

3. Get Access to The API

4. Choose Purchase Model "Get for free"

5. Choose Package "BYOCAR"

6. Create an App (this looks different, as I still have Apps in MercedesMe)

7. Fill Application Name and Business Purpose and choose "Create" button

8. after Confirm you will see your new Application (OPENWBSOC)

9. Subscribe an use "View in Console"

10. Change Redirect URLs

You will get an "App ID", "Client ID" and "Client Secret". You'll have to fill in the Value(s) for rediect URL(s).
The redirect URL must contain the IP Address (marked as IPopenWB) in the picture. You can also add additional Redirect URLs for example with a hostname (place the hostname of your openWB instead of hostname) as you see in the second line.
To use the SoC Api also for the second LP, use a Redirect URL (like in line 3) with the matching callback function (callback_lp2.php)
Make sure you use same protocol as used by the openWB (here http://).

Note the Values in "Client ID" and "Client Secret". You will need these and the according Redirect URL in the openWV LP Configuration

11: Configure openWB LP (Ladepunkt)

Got to Einstellungen/Modulkonfiguration/Ladepunkte

12. Choose Mercedes EQ (BETA!!!) from the List

13. Fill the values "Client ID", "Client Secret", "Fahrzeug Ident", "Callback" with the matching Values from Step 10

14. Save the Values

Go tot the Bottom of the page and press "Speichern" Button

15. Go back to the Ladepunkt and press the "HIER bei Mercedes Me anmelden" link.

This will open an new Window, reach out to the Mercedes API (if Asked, log in with your Mercedes Me ID)and save the needed Access token inside the openWB Config.

You can close that empty window,

Finally your configuration is done.

Erweiterung curl VZ auf Ausgabe mit Zeilennummern

Beta Test des Mercedes EQ Soc von Achim. Leichte Änderungen zum Stand von Achim. Verwendung der container Ressource um SoC und Range in eimen Aufruf zu erhalten, zur späteren Verwendung des Range Wertes. MArkierung in der LP Konfig als BETA!!!. Genaue Anleitung muss noch erstellt werden.

DetMoerk · 2020-12-28T11:13:44Z

May solve Issue #687

modules/soc_eq/callback_lp2.php

modules/soc_eqlp2/main.sh

Copy Paste Errors in Comments fixed

less -N stays in less after executing the curl. cat -n ends in Shell after curl.

DetMoerk · 2020-12-28T14:36:16Z

Kann es sein, dass es für LP3-LP8 (noch) keine SoC Module gibt? Aus der aktuellen Verzeichnisstruktur scheint das auch bei den anderen SoC Modulen hard coded nur LP1 und LP2 zu sein.

benderl · 2020-12-28T15:17:03Z

Ja, das stimmt. Die Module wurden bzw. werden nach und nach aber umgeschrieben.

benderl · 2020-12-28T17:07:12Z

modules/soc_eq/main.sh

+  soctimer=$((soctimer+1))
+  echo $soctimer > $soctimerfile
+else
+  export soc_eq_client_id soc_eq_client_secret soc_eq_vin soc_file CHARGEPOINT


Diese Einstellungen sollten nicht im Environment exportiert werden. Besser als Parameter im Aufruf des soc.py angeben.

ist im letzten Commit umgesetzt

benderl · 2020-12-28T17:10:14Z

modules/soc_eq/main.sh

+  echo $soctimer > $soctimerfile
+else
+  export soc_eq_client_id soc_eq_client_secret soc_eq_vin soc_file CHARGEPOINT
+  /var/www/html/openWB/modules/soc_eq/soc.py


Bitte an den Aufruf der soc.py ein "&" anhängen, damit das Skript im Hintergrund ausgeführt wird und nicht die Regelschleife ausbremst.

Gibt es ein SoC Modul, das als gutes Beispiel dienen kann? Ich hab den Code in einem Beitrag im Forum bekommen und bei mir eingebaut. Das hat soweit funktioniert, ein paar Blicke habe ich schon in andere SoC Module geworfen, aber da sind die Implementierungen auch sehr unterschiedlich.

Da hast Du Recht, das ist teilweise sehr unterschiedlich. Schau mal dort rein, das entspricht dem, was mir als "Standard" vorschwebt:

openWB/modules/soc_kia/main.sh

Line 56 in 6cc2ca3

sudo python3 $MODULEDIR/kiasoc.py $kia_email $kia_password $kia_pin $kia_vin $socfile >> $LOGFILE &

ist analog realisiert, allerdings verstehe ich and er Stelle den sudo nicht. Ist der zwingend? Bei meinem Modul geht das auch ohne sudo, allerdings als Installation auf einem meiner Raspis.

Welchen OS User verwendet denn eine openWB Installation auf dem Raspi? Ich hatte heute ein Thema mit Userberechtigungen auf Files um die Token zu persistieren. Die Callback URL ist bei mir ein php Script, welches dann ein Python Script aufruft. Die laufen auf meinem Raspi wie üblich unter dem User www-data. Die openWB Verzeichnisse liegen bei mir aber unter dem User pi.
VG
Det

OpenWB nutzt sudo häufig und auch meiner Meinung nach zu oft. Alle Prozesse laufen als user pi. Mit Version 2.x werden die benötigten Rechte detaillierter geprüft. Wenn Dein Modul ohne sudo läuft, kann es gerne weggelassen werden.

Läuft der Apache auch als User pi? Ansonsten müssen die leeren Dateien zum Persistieren der Token und der Expire Time mit user pi und mode 666 angelegt sein, damit der apache im callback auch darauf zugreifen darf.

VG
Det

Changed main.sh and soc.py to write to logfile. soc.py is called with arguments instead of exporting

benderl · 2020-12-30T08:56:49Z

Hallo @DetMoerk ,
Danke für das Modul und die ganzen Anpassungen. Siehst Du noch eine Möglichkeit, die callback Handler zu verallgemeinern, damit ein Skript für alle LP genutzt werden kann? Falls nicht, kann der PR durchaus jetzt gemerged werden. Vielleicht finden wir später gemeinsam eine Lösung.
Die Anleitung kopiere ich dann kommende Woche in das Wiki und füge einen Link direkt bei der Modulauswahl ein.

DetMoerk · 2020-12-30T12:03:32Z

Hi, warte mal noch mit mergen, ich hab noch ne Änderung die ich nicht committed habe. Denke heute im Lauf des Nachmittags werde ich das noch fertig bekommen, ist hauptsächlich Logging und ne Ausgabe wenn der Auth Callback erfolgreich war. Die ist aber noch nicht schön, da muss ich noch mal ran.
Die Ladepunkte zusammen zu führen sehe ich gerade keine Möglichkeit, das wäre dann was für die nächste Version des Moduls ;-)

VG
Det

DetMoerk · 2020-12-30T12:08:03Z

Eine Frage habe ich auch noch, die API bringt auch eine Rangeelectric Wert zurück. Aktuell schreibe ich den nicht weg, aber wenn das auf der openWB Seite noch irgendwo dargestellt werden kann, würde ich das auch noch in ne Datei schreiben.

VG
Det

benderl · 2020-12-30T13:01:54Z

Das ist aktuell nicht vorgesehen. Kann man in Version 2.x drüber diskutieren, wenn das eine Mehrzahl der SoC Module ermöglicht.
Deine Beschreibung ist jetzt auch im Wiki: https://github.com/snaptec/openWB/wiki/EV-SoC-Modul-Mercedes-EQ
Bitte füge doch den Link in der modulconfiglp.php als "alert-info" Block ein.

Dokumentation in den modulconfiglp eingebaut.

DetMoerk · 2020-12-30T15:15:25Z

@benderl: Ichhabe die Doku verlinkt, leider habe ich übersehen, dass es als alert-info sein soll.
Bei mir sieht es jetzt so aus.
Wäre das auch OK?

Wenn Ja, kannst du gerne mergen.

benderl · 2020-12-30T15:55:04Z

Sieht auch gut aus.

@snaptec
Kannst Du dann bitte mergen?

DetMoerk added 3 commits December 26, 2020 19:59

Check in soc_eq

d61c3ad

curl VZ mit Zeilennummern

5c167d3

Erweiterung curl VZ auf Ausgabe mit Zeilennummern

benderl requested changes Dec 28, 2020

View reviewed changes

modules/soc_eq/callback_lp2.php Outdated Show resolved Hide resolved

modules/soc_eqlp2/main.sh Outdated Show resolved Hide resolved

DetMoerk added 2 commits December 28, 2020 14:24

Comment Bugs fixed

82a1290

Copy Paste Errors in Comments fixed

less -N replaced with cat -n

2bed820

less -N stays in less after executing the curl. cat -n ends in Shell after curl.

benderl requested changes Dec 28, 2020

View reviewed changes

Implement call parameters and Logging

1388c74

Changed main.sh and soc.py to write to logfile. soc.py is called with arguments instead of exporting

Doku und Auth.py angepasst

bc54562

Dokumentation in den modulconfiglp eingebaut.

Merge branch 'master' into master

0dc012e

snaptec merged commit b4f4b74 into snaptec:master Jan 2, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Mercedes EQ SoC Modul #823

Mercedes EQ SoC Modul #823

DetMoerk commented Dec 28, 2020

DetMoerk commented Dec 28, 2020 •

edited

Loading

DetMoerk commented Dec 28, 2020 •

edited

Loading

benderl commented Dec 28, 2020

benderl Dec 28, 2020

DetMoerk Dec 28, 2020

benderl Dec 28, 2020

DetMoerk Dec 28, 2020

benderl Dec 28, 2020

DetMoerk Dec 28, 2020

DetMoerk Dec 29, 2020

benderl Dec 30, 2020

DetMoerk Dec 30, 2020

benderl commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

benderl commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

benderl commented Dec 30, 2020

Mercedes EQ SoC Modul #823

Mercedes EQ SoC Modul #823

Conversation

DetMoerk commented Dec 28, 2020

DetMoerk commented Dec 28, 2020 • edited Loading

DetMoerk commented Dec 28, 2020 • edited Loading

benderl commented Dec 28, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

benderl commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

benderl commented Dec 30, 2020

DetMoerk commented Dec 30, 2020

benderl commented Dec 30, 2020

DetMoerk commented Dec 28, 2020 •

edited

Loading

DetMoerk commented Dec 28, 2020 •

edited

Loading