Hyundai EU Data Act

Uses the vehicle data provided under the EU Data Act through the Pleos Vehicle Data API (Europe only).

Register at the Pleos Playground, open "My Vehicle Data API", select the manufacturer and log in with your Bluelink/Kia Connect/Genesis Connected account to obtain a client ID and client secret (instructions).

The API returns the data last reported by the vehicle to the manufacturer's servers; it does not wake the vehicle.

Older vehicles (CCS 1.0) need welcomecharge for automatic detection.

Parameters

Name	Description	Level
`clientid`	Client ID	optional
`clientsecret`	Client Secret	optional
`title`	Title Will be displayed in the user interface	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`vin`	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: `KMHK...`	optional
`icon`	Icon Will be displayed in the user interface Default: `car`	advanced
`phases`	Maximum number of phases Used to determine the minimum solar surplus and plan duration.	advanced
`minCurrent` [A]	Minimum current The minimum current per connected phase that can be used Example: `6`	advanced
`maxCurrent` [A]	Maximum current The maximum current 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`	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.	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
`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
`brand`	Brand Optional, otherwise detected from the API key	advanced
`cache`	Cache Time interval for data refresh Default: `15m` Example: `5m`	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: pleos
      clientid: # Client ID
      clientsecret: # Client Secret
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 50 # Battery capacity (kWh), optional
      vin: KMHK... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer (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)
      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)
      brand: # Brand, Optional, otherwise detected from the API key [hyundai, kia, genesis] (optional)
      cache: 15m # Cache, Time interval for data refresh (optional)

View nightly version