Skip to main content

Library to read data from the BMW Connected Drive portal

Project description

https://pepy.tech/badge/bimmer-connected/week https://pepy.tech/badge/bimmer-connected/month https://pepy.tech/badge/bimmer-connected https://badge.fury.io/py/bimmer-connected.svg https://travis-ci.org/bimmerconnected/bimmer_connected.svg?branch=master https://coveralls.io/repos/github/bimmerconnected/bimmer_connected/badge.svg?branch=master

bimmer_connected

This is a simple library to query and control the status of your BMW or Mini vehicle from the Connected Drive portal.

See bimmerconnected for usage instruction or the API Documentation.

This library is written to include it in Home Assistant.

Compatibility

This works with BMW (and Mini) vehicles with a Connected Drive account. So far it is tested on vehicles with a ‘MGU’, ‘NBTEvo’, ‘EntryEvo’, ‘NBT’, or ‘EntryNav’ navigation system. If you have any trouble with other navigation systems, please create an issue with your server responses (see next section).

To use this library, your BMW (or Mini) must have the remote services enabled for your vehicle. You might need to book this in the Connected Drive/Mini Connected portal and this might cost some money. In addition to that you need to enable the Remote Services in your infotainment system in the vehicle.

Different models of vehicles and infotainment systems result in different types of attributes provided by the server. So the experience with the library will certaily vary across the different vehicle models.

Data Contributions

If some features do not work for your vehicle, we would need the data returned form the server to analyse this and potentially extend the code. Different models and head unit generations lead to different responses from the server.

If you want to contribute your data, perform the following steps:

# get the latest version of the library
pip3 install --upgrade bimmer_connected

# run the fingerprint function
bimmerconnected fingerprint <username> <password> <region>

This will create a set of log files in the “vehicle_fingerprint” folder. Before sending the data to anyone please check for any personal data. The following attributes should be replaced with default values: * vin (=Vehicle Identification Number) * lat and lon (=GPS position) * licensePlate

Create a new issue in bimmer_connected and add the files as attachment to the issue.

Please add your model and year to the title of the issue, to make it easier to organize. If you know the “chassis code” of your car, you can include that too. (For example, Googling “2017 BMW X5” will show a Wikipedia article entitled “BMW X5 (F15)”. F15 is therefore the chassis code of the car.)

Note: We will then use this data as additional test cases. So we will publish (parts of) it (after checking for personal information again) and use this as test cases for our library. If you do not want this, please let us know in advance.

Code Contributions

Contributions are welcome! Please make sure that your code passed the “tox” checks. And please add tests where it makes sense. The more the better.

https://travis-ci.org/bimmerconnected/bimmer_connected.svg?branch=master https://coveralls.io/repos/github/bimmerconnected/bimmer_connected/badge.svg?branch=master

Thank you

Thank you Christian, @m1n3rva, @kernelkraut, @robbz23 and @lawtancool for your research and contributions!

This library is basically a best-of of other similar solutions, yet none of them provided a ready to use library with a matching interface to be used in Home Assistant and is available on pypi.

Thank you for your great software!

License

The bimmer_connected library is licensed under the Apache License 2.0.

Disclaimer

This library is not affiliated with or endorsed by BMW Group.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bimmer_connected-0.7.4.tar.gz (25.4 kB view hashes)

Uploaded Source

Built Distribution

bimmer_connected-0.7.4-py3-none-any.whl (26.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page