Skip to content

Latest commit

 

History

History
97 lines (77 loc) · 3.5 KB

README.md

File metadata and controls

97 lines (77 loc) · 3.5 KB
Raw

MMM-BMWConnected

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

Screenshot

The module displays icons to show lock, fuel, door, windows and sunroof status, range, and total kms 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/philmavedzenge/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: "bottom_right",
    config: {
        email: "yourBMWConnectEmail",
        password: "StrongPassword",
    apiBase: "b2vapi.bmwgroup.com", //this works for me in South Africa not sure what other regions would be
        distance: "km",
        refresh: 15,
        vehicleAngle: 10,
    country: "South Africa", //Type exactly as it appears on https://www.bmw-connecteddrive.com/
    region: "REST_OF_WORLD" //Choose one : NORTH_AMERICA,CHINA,REST_OF_WORLD
    }
},

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 apiBase url for your country.

Default: www.bmw-connecteddrive.co.za
country Your BMWConnect registration country.

Check: https://www.bmw-connecteddrive.com/
refresh How often to refresh the data in minutes.

Default: 15
vehicleAngle The initial 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.

No Data?

Contact me and i will try to help as best as i can. PLease note that i'm not the original developer of this module. I have just forked it and made a few changes.

Help

I have not tested for other regions except for REST_OF_WORLD, if you can, please test and let me know.

Thanks

Hat tip to Howard Durdle for the original code.