Skip to content
EN | DE

ioBroker.bmw

ioBroker BMW Adapter. Requires ioBroker.bmw and ioBroker.simple-api

Parameters

NameDescriptionValueLevel
vinVehicle Identification Number

BMW VehicleIdentificationNumber

Example: WBA8E9G50GM091234
optional
uriioBroker URL

including ioBroker.simple-api Port

optional
titleTitle

Will be displayed in the user interface

optional
capacity [kWh]Battery capacity
Example: 50
optional
iconIcon

Will be displayed in the user interface

Default: car
advanced
phasesMaximum number of phases

The maximum number of phases which can be used

Example: 3
advanced
modeDefault charging mode

Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set

advanced
minCurrent [A]Minimum amperage

The minimum amperage per connected phase that can be used

Example: 6
advanced
maxCurrent [A]Maximum amperage

The maximum amperage per connected phase that can be used

Example: 16
advanced
maxPower [W]Maximum charging power hint

Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. The offered current of the loadpoint is not affected.

Example: 10000
advanced
identifiersIdentification

Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle

advanced
priorityPriority

Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy

advanced
idInstance ID
Default: 0
advanced
coarsecurrent1A current control

Vehicle supports 1A current steps only

advanced
streamingSupports streaming

Streaming data is received asynchronously

Default: true
advanced
welcomechargeCharge on connection

Charger will enable charging for short time when vehicle is connected, irrespective of configured charge mode. This is useful for vehicles that require power supply when connecting.

advanced
Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

vehicles:
- name: my_car
type: template
template: ioBroker.bmw
vin: WBA8E9G50GM091234 # Vehicle Identification Number, BMW VehicleIdentificationNumber
uri: # ioBroker URL, including ioBroker.simple-api Port
title: # Title, Will be displayed in the user interface (optional)
capacity: 50 # Battery capacity (kWh), optional
icon: car # Icon, Will be displayed in the user interface [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
phases: 3 # Maximum number of phases, The maximum number of phases which can be used (optional)
mode: # Default charging mode, Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set (optional)
minCurrent: 6 # Minimum amperage (A), The minimum amperage per connected phase that can be used (optional)
maxCurrent: 16 # Maximum amperage (A), The maximum amperage per connected phase that can be used (optional)
maxPower: 10000 # Maximum charging power hint (W), Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. _The offered current of the loadpoint is not affected._ (optional)
identifiers: # Identification, Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle (optional)
priority: # Priority, Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy (optional)
id: 0 # Instance ID, optional
coarsecurrent: # 1A current control, Vehicle supports 1A current steps only (optional)
streaming: true # Supports streaming, Streaming data is received asynchronously (optional)
welcomecharge: # Charge on connection, Charger will enable charging for short time when vehicle is connected, irrespective of configured charge mode. This is useful for vehicles that require power supply when connecting. (optional)