# ioBroker.bmw

Source: https://docs.evcc.io/en/vehicles/iobroker-bmw

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

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| vin | Vehicle Identification Number BMW VehicleIdentificationNumber | WBA8E9G50GM091234 |  |
| uri | ioBroker URL including ioBroker.simple-api Port |  |  |
| title | Title Will be displayed in the user interface |  |  |
| capacity | Battery capacity | 50 kWh |  |
| icon | 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) | car | advanced |
| phases | Maximum number of phases Used to determine the minimum solar surplus and plan duration. (1, 2, 3) |  | advanced |
| minCurrent | Minimum current The minimum current per connected phase that can be used | 6 A | advanced |
| maxCurrent | Maximum current The maximum current per connected phase that can be used | 16 A | advanced |
| maxPower | 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._ | 10000 W | advanced |
| identifiers | RFID identification Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](https://docs.evcc.io/en/docs/features/vehicle) |  | advanced |
| priority | Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority). |  | advanced |
| id | Instance ID | 0 | advanced |
| coarsecurrent | 1A current control Vehicle supports 1A current steps only |  | advanced |
| streaming | Supports streaming Streaming data is received asynchronously | true | advanced |
| 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. |  | advanced |
| climaterdisabled | Disable climater detection Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request. |  | advanced |
| autodetectdisabled | Exclude from auto detection Ignore the vehicle for auto detection of connected vehicles |  | advanced |
| wakeupdisabled | Disable wake-up calls Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups. |  | advanced |

## Configuration example for evcc.yaml

```yaml
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: # Maximum number of phases, Used to determine the minimum solar surplus and plan duration. [1, 2, 3] (optional)
      minCurrent: 6 # Minimum current (A), The minimum current per connected phase that can be used (optional)
      maxCurrent: 16 # Maximum current (A), The maximum current 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: # RFID identification, Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](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 surplus energy (higher values, higher priority). (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)
      climaterdisabled: # Disable climater detection, Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request. (optional)
      autodetectdisabled: # Exclude from auto detection, Ignore the vehicle for auto detection of connected vehicles (optional)
      wakeupdisabled: # Disable wake-up calls, Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups. (optional)
```