Mercedes

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' is set to https://localhost'
• 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!

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

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.