Zum Inhalt springen
EN | DE

Kia EU Data Act

Diese Seite zeigt die Nightly-Version. Wechsle zur Release-Version.

Nutzt die im Rahmen des EU Data Act bereitgestellten Fahrzeugdaten über die Pleos Vehicle Data API (nur Europa).

Registrierung im Pleos Playground, dort unter "My Vehicle Data API" den Hersteller wählen und mit dem Bluelink-/Kia Connect-/Genesis Connected-Konto des Hauptnutzers anmelden, um Client ID und Client Secret zu erhalten (Anleitung).

Die API liefert die zuletzt vom Fahrzeug an die Herstellerserver gemeldeten Daten; das Fahrzeug wird nicht geweckt.

Ältere Fahrzeuge (CCS 1.0) brauchen welcomecharge zur automatischen Erkennung.

Parameter

NameBeschreibungWertStufe
clientidClient IDoptional
clientsecretClient Secretoptional
titleTitel

Wird in der Benutzeroberfläche angezeigt

optional
capacity [kWh]Akkukapazität
Beispiel: 50
optional
vinFahrzeugidentifikationsnummer

Wenn mehrere Fahrzeuge eines Herstellers vorhanden sind

Beispiel: KMHK...
optional
iconIcon

Wird in der Benutzeroberfläche angezeigt

Standard: car
erweitert
phasesMaximale Phasenanzahl

Wird für die Bestimmung des minimalen Solar-Überschusses und der Planungsdauer verwendet.

erweitert
minCurrent [A]Minimale Stromstärke

Definiert die minimale Stromstärke pro angeschlossener Phase die genutzt werden kann

Beispiel: 6
erweitert
maxCurrent [A]Maximale Stromstärke

Definiert die maximale Stromstärke pro angeschlossener Phase die genutzt werden kann

Beispiel: 16
erweitert
maxPower [W]Ladeleistungs-Hinweis

Definiert die maximale Ladeleistung des Fahrzeugs. Hilft, die Ladeplanung zu verbessern, wenn das Fahrzeug üblicherweise weniger Strom nutzt als angeboten oder höhere Ströme bei einphasigem Laden erlaubt als bei dreiphasigem. Der bereitgestellte Strom des Ladepunktes wird nicht beeinflusst.

Beispiel: 10000
erweitert
identifiersRFID-Identifikation

Für die Zuordnung des Fahrzeugs an einen Ladepunkt via RFID-Karte. Die Kennung wird am Ladepunkt angezeigt. Übernehme den Wert von dort. Mehr erfahren.

erweitert
priorityPriorität

Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von Überschussenergie (höhere Werte, höhere Priorität).

erweitert
welcomechargeLaden bei Verbindung

Wallbox gibt kurzzeitige Ladefreigabe bei Fahrzeugverbindung. Das ermöglicht es Fahrzeugen, die eine Stromversorgung beim Anschließen benötigen, einen Fehlerzustand zu vermeiden.

erweitert
climaterdisabledKlimatisierungserkennung deaktivieren

Klimatisierungsstatus des Fahrzeugs für die Ladesteuerung ignorieren, sodass der Ladevorgang am SoC- oder Energielimit endet, auch wenn das Fahrzeug einen aktiven Klimatisierungswunsch signalisiert.

erweitert
autodetectdisabledVon automatischer Erkennung ausschließen

Das Fahrzeug von der automatischen Erkennung beim Anschließen eines Fahrzeugs ausschließen

erweitert
wakeupdisabledAufweck-Aufrufe deaktivieren

Keine Aufweck-Aufrufe an Fahrzeug oder Ladegerät senden, hilfreich bei Fahrzeugen, die nach wiederholtem Aufwecken das Laden verweigern.

erweitert
brandMarke

Optional, wird sonst anhand des API-Schlüssels ermittelt

erweitert
cacheCache

Zeitintervall für erneute Datenabfrage

Standard: 15m
Beispiel: 5m
erweitert
Konfigurationsbeispiel für evcc.yaml

Falls du die Konfiguration nicht über die Oberfläche vornehmen möchtest, kannst du alternativ diesen YAML-Block verwenden.

vehicles:
- name: my_car
type: template
template: pleos
clientid: # Client ID
clientsecret: # Client Secret
title: # Titel, Wird in der Benutzeroberfläche angezeigt (optional)
capacity: 50 # Akkukapazität (kWh), optional
vin: KMHK... # Fahrzeugidentifikationsnummer, Wenn mehrere Fahrzeuge eines Herstellers vorhanden sind (optional)
icon: car # Icon, Wird in der Benutzeroberfläche angezeigt [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: # Maximale Phasenanzahl, Wird für die Bestimmung des minimalen Solar-Überschusses und der Planungsdauer verwendet. [1, 2, 3] (optional)
minCurrent: 6 # Minimale Stromstärke (A), Definiert die minimale Stromstärke pro angeschlossener Phase die genutzt werden kann (optional)
maxCurrent: 16 # Maximale Stromstärke (A), Definiert die maximale Stromstärke pro angeschlossener Phase die genutzt werden kann (optional)
maxPower: 10000 # Ladeleistungs-Hinweis (W), Definiert die maximale Ladeleistung des Fahrzeugs. Hilft, die Ladeplanung zu verbessern, wenn das Fahrzeug üblicherweise weniger Strom nutzt als angeboten oder höhere Ströme bei einphasigem Laden erlaubt als bei dreiphasigem. _Der bereitgestellte Strom des Ladepunktes wird nicht beeinflusst._ (optional)
identifiers: # RFID-Identifikation, Für die Zuordnung des Fahrzeugs an einen Ladepunkt via RFID-Karte. Die Kennung wird am Ladepunkt angezeigt. Übernehme den Wert von dort. [Mehr erfahren.](https://docs.evcc.io/docs/features/vehicle) (optional)
priority: # Priorität, Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von Überschussenergie (höhere Werte, höhere Priorität). (optional)
welcomecharge: # Laden bei Verbindung, Wallbox gibt kurzzeitige Ladefreigabe bei Fahrzeugverbindung. Das ermöglicht es Fahrzeugen, die eine Stromversorgung beim Anschließen benötigen, einen Fehlerzustand zu vermeiden. (optional)
climaterdisabled: # Klimatisierungserkennung deaktivieren, Klimatisierungsstatus des Fahrzeugs für die Ladesteuerung ignorieren, sodass der Ladevorgang am SoC- oder Energielimit endet, auch wenn das Fahrzeug einen aktiven Klimatisierungswunsch signalisiert. (optional)
autodetectdisabled: # Von automatischer Erkennung ausschließen, Das Fahrzeug von der automatischen Erkennung beim Anschließen eines Fahrzeugs ausschließen (optional)
wakeupdisabled: # Aufweck-Aufrufe deaktivieren, Keine Aufweck-Aufrufe an Fahrzeug oder Ladegerät senden, hilfreich bei Fahrzeugen, die nach wiederholtem Aufwecken das Laden verweigern. (optional)
brand: # Marke, Optional, wird sonst anhand des API-Schlüssels ermittelt [hyundai, kia, genesis] (optional)
cache: 15m # Cache, Zeitintervall für erneute Datenabfrage (optional)