BMW Connected Drive

The BMW Connected Drive integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] lets you retrieve data of your BMW or MINI vehicle from the MyBMW portal (previously BMW Connected Drive).

Prerequisites

You need to have an active MyBMW account with a connected car. For MINI vehicles, you register with MINI Connected.

For compatibility with your BMW vehicle check the bimmer_connected page on GitHub.

配置

要将 BMW Connected Drive integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

选项

BMW Connected Drive 的选项可以通过用户界面设置，具体步骤如下：

• 浏览到您的 Home Assistant 实例。
• 转到 设置 > 设备与服务。
• 如果配置了多个 BMW Connected Drive 实例，请选择您想配置的实例。
• 选择集成，然后选择 配置。

Data updates

The integration will pull data from MyBMW/MINI servers at the following intervals:

Defining a custom polling interval

如果您想要定义一个特定的间隔来轮询您的设备以获取数据，可以禁用默认的轮询间隔并创建自己的轮询自动化。

要添加自动化：

1. 转到 设置 > 设备与服务，并选择您的集成。
2. 在集成条目上，选择 。
   • 然后，选择 系统选项 并切换按钮以禁用轮询。
3. 要定义您的自定义轮询间隔，创建一个自动化。
   • 转到 设置 > 自动化与场景 并创建一个新的自动化。
   • 定义您喜欢的任何触发器和条件。
   • 选择 添加动作，然后选择 其他动作。
   • 选择 执行动作，然后从列表中选择 homeassistant.update_entity 动作。
4. 保存您的新自动化以轮询数据。

Available platforms

This integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] provides the following platforms平台是某些集成提供的构建块，可供其他集成使用。 [Learn more]:

• Binary sensors: Doors, windows, condition based services, check control messages, parking lights, door lock state, charging status (electric cars) and connections status (electric cars).
• Device tracker: The location of your car.
• Lock: Control the lock of your car.
• Sensors: Mileage, remaining range, remaining fuel, charging time remaining (electric cars), charging status (electric cars), remaining range electric (electric cars).
• Notifications: Send Points of Interest (POI) to your car.
• Buttons: Turn on air condition, sound the horn, flash the lights, update the vehicle location and update the state.
• Selects: Display and control charging related settings for (PH)EVs.
• Switches: Display and toggle settings on your car.
• Numbers: Display and control numeric charging related settings for (PH)EVs.

Notifications

The BMW Connected Drive integration offers a notification action. Using this action you can send Points of Interest (POI) to your vehicle. In your vehicle, you can select this POI, and the navigation will automatically start using the POI as a destination. The name of the action is notify.bmw_connected_drive_<your_vehicle>.

Send a Point of Interest to your vehicle

...
actions:
  - action: notify.bmw_connected_drive_<your_vehicle>
    data:
      message: The name of the POI # this is shown on the iDrive dashboard
      data:
        latitude: 48.177024
        longitude: 11.559107
        street: Street name  # Optional
        city: City name  # Optional
        postal_code: Postal Code  # Optional
        country: Country  # Optional

Lock

The vehicle can be locked and unlocked via the lock integration that is created automatically for each vehicle.

Buttons

Buttons are used to trigger actions in your car. The buttons are automatically created and can be pressed/executed from the UI or using the button.press action. Please see the button documentation for more information.

Air conditioning

The air conditioning of the vehicle can be activated with the button.<your_vehicle>_activate_air_conditioning button.

What exactly is started here depends on the type of vehicle. It might range from just ventilation over auxiliary heating to real air conditioning. If your vehicle is equipped with auxiliary heating, only trigger this action if the vehicle is parked in a location where it is safe to use it (e.g., not in an underground parking or closed garage).

Sound the horn

The button.<your_vehicle>_sound_horn button sounds the horn of the vehicle. This option is not available in some countries (among which the UK). Use this feature responsibly, as it might annoy your neighbors.

Flash the lights

The button.<your_vehicle>_light_flash button flashes the lights of the vehicle.

Vehicle finder

The button.<your_vehicle>_find_vehicle button requests the vehicle to update the GPS location. This can be used for older vehicles which don’t automatically send the updated GPS location.

Selects

If you have a (PH)EV, you can control the charging process through Home Assistant. The selects are created automatically depending on your vehicle’s capabilities and can be pressed/executed from the UI or using the select.select_option action. For more information, please see the select documentation.

• Charging Mode: Vehicle can be set to IMMEDIATE_CHARGING (charge as soon as plugged in) or DELAYED_CHARGING (charge only if within charging window). It can be used to start/stop charging if the charging window is set accordingly.
• AC Charging Limit: The maximum current a vehicle will charge with. Not available on all EVs.

Switches

If supported by your vehicle, you can display and toggle remote actions with start/stop functionality.

• Climate: Toggle vehicle climatization. It is not possible to force it to heat or cool; the vehicle will decide on its own. If turned on, it will run for 30 minutes (as if toggled via the MyBMW app).
• Charging: Toggle vehicle charging if plugged in. Only available on some electric vehicles.

Numbers

If you have a (PH)EV, you can control the charging process through Home Assistant. The number entities are created automatically depending on your vehicle’s capabilities and can be changed from the UI or using the number.set_value action. For more information, please see the number documentation.

• Target SoC: Vehicle will charge until this battery level is reached. Not available on all EVs.

Troubleshooting

Known limitations

• The entities available to Home Assistant depend on your vehicle. Even inside the same model code (for example, U11 for BMW X1) you will see different entities, depending on your specific car’s features.
• Not all features, mostly related to charging control for (PH)EVs, are implemented. If you have a functionality in your MyBMW/MINI app that is not yet available, search for an existing feature request in the bimmer_connected discussions or create a new one.

Removing the integration

从Home Assistant中移除集成实例

1. 前往 设置 > 设备与服务 并选择集成卡片。
2. 从设备列表中，选择要删除的集成实例。
3. 在条目旁边，选择三个点 菜单。然后，选择 删除。

Disclaimer

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