Kiddigital: /* Mercedes Me Integration */

2023-08-29T11:50:35Z

Mercedes Me Integration

New page

===Mercedes Me Integration===
Domoticz had since 2021.1 support for the BYOCAR API's from Mercedes (Daimler).

Per 31 of August 2023 Mercedes has discontinued their BYOCAR product! Therefor, this integration does not work anymore!

 

====Prerequisits====

*A connected Mercedes :)
*The ''VIN'' number of your car
*An account with MercedesMe (look for MercedesMe on the mercedes website)
**Connected to the car with the above ''VIN'' number
*(Optional but handy) The MercedesMe app on your mobile/tablet (to make sure you have a working account and are receiving data from your car)

====Installation====
To be able to use this integration, a few steps have to be performed:

On the Mercedes Developers Portal

*Create a ''developers account'' using the '''same''' e-mailaddress as the one used for the Mercedes Me portal and app(s)
*In the ''console'' create your own ''Project''
**Give it a nice name (''Domoticz'' maybe? ;) )
**Make sure that the '''redirect_url''<nowiki/>' is set to '''''<nowiki/>''<nowiki>https://localhost</nowiki>'<nowiki/>''
*Add the relevant ''products'' to your project
**Select ''Get for Free'' as the '''Purchase Model''', and then select ''BYOCAR'' as the '''Package'''
**Make sure all 5 BYOCAR products are added
***Fuel Status
***Vehicle Status
***Vehicle Lock Status
***Electric Vehicle Status (Please ''ADD'' even when your vehicle is ''NOT'' an electric vehicle)
***Pay As You Drive Insurance
*Make sure you copy the ''Client ID'' and the ''Client Secret'' from the '''OAuth2 credentials''' section of your ''project''
**These are needed in Domoticz

Within Domoticz

*Add new Hardware
**Add '''Mercedes Me Connect''' hardware type
*Fill in the VIN
*The ''username'' is as followed: ''<Client ID>:<Client Secret>''
*The ''password'' is the '''authorization_code''' that has te be requested by entering the following URL into your browser screen:

''Replace <Client ID> with your own Client ID!''<syntaxhighlight lang="http">
https://ssoalpha.dvb.corpinter.net/v1/auth?response_type=code&client_id=<CLIENT-ID>&redirect_uri=https://localhost&scope=openid%20mb:vehicle:mbdata:vehiclestatus%20mb:vehicle:mbdata:fuelstatus%20mb:vehicle:mbdata:payasyoudrive%20mb:vehicle:mbdata:vehiclelock%20mb:vehicle:mbdata:evstatus%20offline_access&state=test&prompt=login%20consent
</syntaxhighlight>

You should be getting the Mercedes Me portal login screen asking you to login.

After succesful login, you should get redirected to ''https://localhost'' (as entered within the console as redirect_url). Part of the URL should be a part stating ''code=<some code>'' Note that the code ends at the '&'-sign!

'''NOTE:''' Make sure that the ''Accept New Hardware'' setting is set to '''On'''. It can take up to an hour before all available sensors have been read and created within Domoticz.

*Now ''Save'' the new hardware and hop over to the ''Logging'' screen to see if the new hardware module was able to successfully login to the Mercedes API's to start retrieving data from the car.

Once the new ''Devices'' have been created in Domoticz, start using them on Dashboards, Floorplans, etc.

See the Mercedes Developers portal (https://developer.mercedes-benz.com/console) for more info and the ''console''

See this forum thread for more information and to ask question: https://www.domoticz.com/forum/viewtopic.php?f=56&t=33734 

The Mercedes Me hardware module is based on the [[EVehicles]] framework available in Domoticz.

[[Category:Domoticz]]
[[Category:Manual]]
[[Category:Setup]]
[[Category:Hardware]]
[[Category:EVehicles]]

Mercedes - Revision history

Kiddigital: /* Mercedes Me Integration */