MMM-BMWConnected

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

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

Installation

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

cd ~/MagicMirror/modules 
git clone https://github.com/hdurdle/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.

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"
        }
    },

Module configuration

The module has a few configuration options:

Option	Description
email	Your username or email for the BMW Connected Drive platform. Default: undefined
password	Your password for the BMW Connected Drive platform. Default: undefined
apiBase	The location of the base API URL for your region. Default: www.bmw-connecteddrive.co.uk
refresh	How often to refresh the data in minutes. Default: 15
vehicleAngle	The angle of rotation for the car image. Default: 300 Between 0 and 350 in increments of 10.
distance	The unit of distance used for mileage and range. Default: miles Can be: miles or km.

Notes

If possible the module will pull an image of your car from BMW's API. I only have one BMW, so can't test the placement/graphics of other vehicles. I'd love to see what it looks like if you try it. Tweet images to me at https://twitter.com/hdurdle

No Data?

So far this is confirmed working in Europe and the USA. If you're somewhere else, please visit my Powershell BMW repository and follow the instructions there to run Get-BMWInfo.ps1. Send me the output and I'll be able to update the module to work in your country.

Help

If you have a moment, please set debug to true in the config and see what text appears in [ ] after the last updated time. I'm trying to see what the BMW API returns for countries that use KM instead of miles. I might be able to avoid making it a config option and pull it direct from the API. Tweet images and comments to me at https://twitter.com/hdurdle

Also, if you can offer translations for the few bits of direct text ("last updated") for your language, let me know (along with where the placeholder should go in your language!).

Thanks

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