MMM-BMWConnected

Magic Mirror Module to display data from BMW Connected drive for your car(s).

The module has been deprecated due to changes in BMW back-end. Please use this module instead.

The module displays icons to show lock, charging and battery status, electric and combined range, and total kilometers driven. It also shows the time the Connected Drive API last received data from the car.

If you own several BMW cars, you can configure a module for each of them. The module configuration requires the vin number of the car to separate multiple module instances.

Installation

Clone this repository in your modules folder, and install dependencies:

cd ~/MagicMirror/modules 
git clone https://github.com/jannekalliola/MMM-BMWConnected.git
cd MMM-BMWConnected
npm install 

Configuration

Go to the MagicMirror/config directory and edit the config.js file. Add the module to your modules array in your config.js.

You'll need your BMW Connected Drive email and password, and your car's vin number.

Enter these details in the config.js for your MagicMirror installation:

    {
        module: "MMM-BMWConnected",
        header: 'BMW Connected',
        position: "top_right",
        config: {
            email: "email@example.com",
            password: "myComplexPassword",
            vin: "XXXXXXXXXXXXXXXXX"
        }
    },

Module configuration

The module has a few configuration options:

Option	Description
email	Your username or email for the BMW Connected Drive platform, required. Default: undefined
password	Your password for the BMW Connected Drive platform, required. Default: undefined
vin	Your car's vin code, required. Default: undefined
apiBase	The location of the base API URL for your region. Default: cocoapi.bmwgroup.com
refresh	How often to refresh the data in minutes. Default: 15
vehicleOpacity	The opacity of the car image. Default: 0.75 Between 0 and 1.
distance	The unit of distance used for mileage and range. Default: miles Can be: miles or km.
showMileage	Whether to show the mileage. Default: true
showElectricRange	Whether to show the electric range. Default: true
showElectricPercentage	Whether to show the battery charging also in percentages. Default: false
showFuelRange	Whether to show the fuel range. Note that BMW API returns the electric range as fuel range for fully electric cars. Default: true
lastUpdatedText	The text to be shown before last updated timestamp. Default: last updated

Thanks

Biggest thanks to Howard Durdle for writing the initial version and maintaining the module for several years.

Hat tip to Nils Schneider for the library code for performing the BMW authentication dance.

Thanks to Eugen for fixing the connectivity issues.

Changelog

2022-12-13 Fixed BMW connectivity and added support for several module instances, separated by vin codes. Currently tested only with European region. The car image is downloaded from the API and stored into a local file. The angle of the car cannot be selected anymore due to BMW API changes.

2022-06-13 Fixed mileage into kilometers, moved the car image to background, and added information about vehicleOpacity config option. Changed the example image.

2022-05-30 Detached from previous versions.