Mini CarData (EU Data Act)

Requires CarData activation in BMW/Mini portal. The following data points need to be configured for streaming access:

vehicle.body.chargingPort.status
vehicle.cabin.infotainment.navigation.currentLocation.latitude
vehicle.cabin.infotainment.navigation.currentLocation.longitude
vehicle.cabin.hvac.preconditioning.status.comfortState
vehicle.drivetrain.batteryManagement.header
vehicle.drivetrain.electricEngine.charging.hvStatus
vehicle.drivetrain.electricEngine.charging.status
vehicle.drivetrain.electricEngine.charging.timeRemaining
vehicle.drivetrain.electricEngine.kombiRemainingElectricRange
vehicle.powertrain.electric.battery.stateOfCharge.target
vehicle.vehicle.preConditioning.activity
vehicle.vehicle.travelledDistance

Data will be updated on restart and when received using streaming. This only happens when the vehicle actively creates new updates.

Parameters

Name	Description	Level
`vin`	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: `WBMW...`	optional
`clientid`	Client ID	optional
`title`	Title Will be displayed in the user interface	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`icon`	Icon Will be displayed in the user interface Default: `car`	advanced
`phases`	Maximum number of phases The maximum number of phases which can be used Example: `3`	advanced
`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	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
`identifiers`	Identification Mostly this can be added later, see: 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 pv energy	advanced
`coarsecurrent`	1A current control Vehicle supports 1A current steps only	advanced
`streaming`	Supports streaming Enable if vehicle sends streaming updates during charging.	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

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: cardata
      vin: WBMW... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer
      clientid: # Client ID
      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)
      coarsecurrent: # 1A current control, Vehicle supports 1A current steps only (optional)
      streaming: # Supports streaming, Enable if vehicle sends streaming updates during charging. (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)