https://github.com/jupe76/bmwcdapi
Bmwcdapi.py is a python script to query various information about your car from the BMW ConnectedDrive portal in conjunction with openhab.
I'm using it for a BMW i3, but should work with other models as well.
The techniques to access the ConnectedDrive portal were taken from https://github.com/sergejmueller/battery.ebiene.de
You'll need the credentials (username / password) for a ConnectedDrive login and the 17 chars long vehicle ident number (VIN) of your car. Furthermore you need a running openhab installation and python 3.x . The script has been tested with openhab2.
Copy bmw.rules and bmw.items in the according openhab dirs.
Edit Bmw_Username, Bmw_Password and Bmw_Vin placed in bmw.items to hold your credentials and the VIN of your car. Edit Bmw_Region to set the region for ConnectedDrive access.
If your script dir is not /etc/openhab2/scripts then you need to edit bmw.rules.
Copy bmwcdapi.py to the openhab script dir. If the script is running on another computer than your openhab installation, then you need to adjust OPENHABIP.
Edit your sitemap to visualize the items.
The script is called every 30 min to update the values. You can adjust the timespan in bmw.rules (be nice to the ConnectedDrive portal and don't hammer the server) With the switch Bmw_ForceUpdate you could initiate an immediate update.
To execute services like to climate the car, call the bmwcd api.py with the commandline parameter --execservice and the appropriate service, i.e. bmwcdapi.py --execservice climate
| OH-Item | Type | Description |
|---|---|---|
Bmw_Username |
String | BMW ConnectedDrive username |
Bmw_Password |
String | BMW ConnectedDrive password |
Bmw_Vin |
String | 17 chars long VIN of the car |
Bmw_Region |
String | Region to use for ConnectedDrive access, 1 = EU and rest of the World, 2 = North America, 3 = China |
| OH-Item | Type | Description |
|---|---|---|
Bmw_Climate |
Switch | Switch to call the service to climate the car |
Bmw_LockDoors |
Switch | Switch to lock the car |
Bmw_UnlockDoors |
Switch | Switch to unlock the car |
Bmw_ForceUpdate |
Switch | switch to update the values immediately |
| OH-Item | Type | Description |
|---|---|---|
Bmw_accessToken |
String | access token |
Bmw_tokenExpires |
String | Timestamp at which the accesstoken becomes invalid |
Bmw_doorLockState |
String | state of the door locks |
Bmw_socMax |
Number | maximum "state of charge" in kWh |
Bmw_chargingLevelHv |
Number | charging level in percent |
Bmw_beRemainingRangeElectric |
Number | remaining electric range in km or mls |
Bmw_beRemainingRangeFuel |
Number | remaining fuel range in km or mls |
Bmw_mileage |
Number | mileage in km or mls |
Bmw_chargingSystemStatus |
String | charging state |
Bmw_updateTimeConverted |
String | last status update from the car |
Bmw_remainingFuel |
Number | remaining fuel in l |
Bmw_lastTripAvgConsum |
Number | average consum of last trip in kWh |
Bmw_lastTripAvgRecup |
Number | average recuperation of last trip in kWh |
Bmw_gpsLat |
String | GPS position latitude |
Bmw_gpsLng |
String | GPS position longitude |
Bmw_gpsLatLng |
String | GPS position latitude,longitude |
Bmw_lastChargingEndResult |
String | Result of last charge |
Bmw_lastUpdateReason |
String | Reason for last update |
Bmw_unitOfLength |
String | length unit, km or mls |
If bmwcdapi.py is called without parameters, the current values will be queried from ConnectedDrive and propagated to openHAB.
| parameter long | parameter short | Description |
|---|---|---|
| --help | -h | show commandline help |
| --printall | -p | print all values, usefull for debuging or just for exploring |
| --execservice <service> | -e | execute service service may be one of
|
| --sendmesg <subject> <message> | -s | send a message to the car |
| return code | Description |
|---|---|
0 |
OK |
13 |
EACCES Permission denied |
62 |
ETIME, Timeout |
70 |
ECOMM, Communication error |
