Donation

It took me quite some effort to get the plugin available. Small contributions are welcome...

Use your Mobile Banking App and scan the QR Code

The QR codes comply the EPC069-12 European Standard for SEPA Credit Transfers (SCT). The amount of the donation can possibly be modified in your Mobile Banking App.	5 EUR	10 EUR

Use PayPal

Domoticz-BMW-plugin

Domoticz plugin working with BMW Connected Drive. A big changes is introduced since version 2.0.0 of the plugin. BMW discontinued the BMW Connected Drive App and related services.

• From plugin 2.0.0, the new services based on the MyBMW app are integrated. This version does not work anymore due to changes at the server side of BMW. The status of the vehicle cannot longer be retrieved.
• From plugin 3.0.0, the plugin uses bimmer_connected (https://github.com/bimmerconnected/bimmer_connected) in threading mode. It solves the problem with the vehicle status update by adding a workaround in the plugin.
• From plugin 3.1.0 (still working on it), all functionality is used from the bimmer_connected library without specific code as workaround. Minimal version of the bimmer_connected library is 0.8.0.
• From plugin 3.2.0, there is the need to install at least bimmer_connected library 0.9.0.0b17. Be aware that this library contains some compatibility breaking changes that impacted the plugin (eg using the Asyncio python mechanism). At the time of the update of the BMW plugin version 0.9.0.0b17 is still beta version.

It is highly considered to follow the bimmer_connected evolutions on https://github.com/bimmerconnected/bimmer_connected as BMW is highly refactoring. You can also find more information about the supported cars (and functionality). Not all functionality is backported to Domoticz (yet). If there is an interesting functionality to add, let me know.

Currently it supports the keep track of the following information:

• Mileage (several devices are created to followup the mileage)
• Driving (indicates whether the car is driving or not)
• Home (indicates whether the car is located within a defined area)
• Doors, windows and car: open - closed
• Remaining mileage for fuel and electric
• Remote services: flash light, horn, activate airco/heating, lock/unlock car (in case you installed a previous version without all these remote services, delete first the device in Domoticz, it will be recreated with all features afterwards)
• In case of electric support:
  • Charging status
  • Remaining charging time (working again as from version 3.1.0)
  • Battery level

If there are requests to integrate other information/functions, please leave a message.

Today, the plugin does not support BMW Connected Drive cars in China and USA.

Remark that using remote services heavily is blocked by BMW. They give a dedicated message back in that case (it will show up in the Domoticz log also). So fast executing remote service one after the other won't be successful.

Installation (linux)

Preliminary install bimmer_connected by with sudo pip3 install bimmer_connected or alternatively sudo pip3 install bimmer_connected==[version] to install a specific version. Be sure that the python3 module threading and queue is installed (otherwise install them also as described below).

Follow this procedure to install the plugin.

• Go to "~/Domoticz/plugins" with the command cd ~/Domoticz/plugins
• Create directory "Bmw" with the command mkdir Bmw
• Copy all the files from github in the created directory
• Be sure the following python3 libraries are installed: urllib, json, datetime
  • use pip3 <library> to verify if the libraries are installed
  • to install the missing libraries: sudo pip3 install <library>

Configuration

Enter your BMW Connected Drive username and password, together with your with your VIN number (Vehicle Identification Number). The number can be found in your official BMW Connected Drive APP-Information.

Technical configuration

A Bmw.json file is available to update the technical configuration. This file is optional and when the file is not available, default values are used.

{
"EnteringHomeDistance (m)": 1000,
"EnteringHomeDistance_FastPollingDistance (m)": 2000,
"EnteringHomeDistance_FastPollingDelay (min)": 2
}

• EnteringHomeDistance [default 1000]: indicate the distance (in meters) from the Domoticz location (set in the Domoticz system setup) to trigger the "Home" functionality. Once the car is within the indicate area, the Home device will be set to "on".
• EnteringHomeDistance_FastPollingDistance (m) [default 2000]: indicate the distance (in meters) from the Domoticz location to increase the update of the BMW Status requests.
• EnteringHomeDistance_FastPollingDelay (min) [default 2]: Delay between update of BMW Status readings. This delay will be applied once the car is at a distance lower than EnteringHomeDistance_FastPollingDistance.

Tips/Hints

• you can use the remote services in combination with a script that looks to the Google Calendar... In this way it is possible to plan the start of the airco/heating.
• you can create a small script that activate other devices one the car is detected coming "home". I personally use this to switch already on several devices so that my house is "ready" once arriving by car.

Privacy

For the management of the "Home" function, the geolocation of the car is used. This means that the location coordinates of the car is known by the plugin. However for privacy reason, these coordinates are NOT stored in any matter in the plugin. Only the last coordinate is kept in volatile memory and systematically overwritten. This coordinates are also lost once Domoticz or the plugin is stopped, reset, removed, ...

Success!

Don't forget a small gift by using the donation button...