Neues Modul zur Nutzung der Pleos-API (Hyundai, KIA, Genesis) - 98_PleosVehicle

[softwear]

Moin zusammen,

da der EU-Data-Act zwar noch unzureichend umgesetzt, jedoch per Pleos Playground für die Fahrzeuge von Hyundai, KIA und Genesis in einer API rudimentär gekapselt ist, hier die erste Beta zur Abfrage dieser Autos.

Es ist noch keine Hilfe integriert! Allerdings ist bisher auch ausschließlich zu beachten, dass im Playground https://pleos.ai/playground vorab eine Registrierung erfolgen muss, damit eine ClientID und ein ClientSecret erzeugt werden können (bitte geheim halten!), die benötigt werden, um über ein zu erstellendes Token die API berechtigt abfragen zu können. Die Crux ist sicherlich, dass der Server maximal alle 15 Minuten aktuell befragt werden können soll. Jedoch hat diese Frequenz mit einer Stunde begonnen und scheint stetig kürzere Intervalle zuzulassen.

Die ClientID und das ClientSecret werden unsichtbar gespeichert, ebenso das Token. Die VIN dagegen ist noch offen sichtbar (Optionen zum Verbergen werden folgen).

Ablauf der Integration des hier angehängten Moduls zum Testen:

• Kopie in den FHEM Ordner
• reload 98_PleosVehicle in der fhem-Eingabeaufforderung
• define <name> PleosVehicle
• set <name> pleos_clientID <clientID>
• set <name> pleos_clientSecret <clientSecret>

Danach können das Intervall-Attribut angepasst und Autorefresh (ebenfalls per Attribut) aktiviert werden. Alternativ können auch unmittelbar die get-Befehle zum Aktualisieren bestimmter Bereiche gezielt angesteuert werden. Per AutoRefresh werden sämtliche Daten (abgesehen von Statistiken) geholt.

Fehler dürfen gerne gemeldet werden, ebenso wie selbstverständlich Verbesserungsvorschläge!

Ich habe bisher sehr von FHEM profitiert, weshalb ich hiermit auch etwas zurückgeben möchte! Dennoch seid bitte nachsichtig, falls irgendetwas nicht 100%ig gelungen sein sollte. Ich gelobe Verbesserung und ich denke, sicher lernfähig zu sein.

24.10.2026 - Dokumentation (für commandref) eingefügt, Download aktualisiert

Beste Grüße
softwear

[Mumpitz]

Moin zusammen,

da der EU-Data-Act zwar noch unzureichend umgesetzt, jedoch per Pleos Playground für die Fahrzeuge von Hyundai, KIA und Genesis in einer API rudimentär gekapselt ist, hier die erste Beta zur Abfrage dieser Autos.

Es ist noch keine Hilfe integriert! Allerdings ist bisher auch ausschließlich zu beachten, dass im Playground https://pleos.ai/playground vorab eine Registrierung erfolgen muss, damit eine ClientID und ein ClientSecret erzeugt werden können (bitte geheim halten!), die benötigt werden, um über ein zu erstellendes Token die API berechtigt abfragen zu können. Die Crux ist sicherlich, dass der Server maximal alle 15 Minuten aktuell befragt werden können soll. Jedoch hat diese Frequenz mit einer Stunde begonnen und scheint stetig kürzere Intervalle zuzulassen.

Die ClientID und das ClientSecret werden unsichtbar gespeichert, ebenso das Token. Die VIN dagegen ist noch offen sichtbar (Optionen zum Verbergen werden folgen).

Ablauf der Integration des hier angehängten Moduls zum Testen:

• Kopie in den FHEM Ordner
• reload 98_PleosVehicle in der fhem-Eingabeaufforderung
• define <name> PleosVehicle
• set <name> pleos_clientID <clientID>
• set <name> pleos_clientSecret <clientSecret>

Danach können das Intervall-Attribut angepasst und Autorefresh (ebenfalls per Attribut) aktiviert werden. Alternativ können auch unmittelbar die get-Befehle zum Aktualisieren bestimmter Bereiche gezielt angesteuert werden. Per AutoRefresh werden sämtliche Daten (abgesehen von Statistiken) geholt.

Fehler dürfen gerne gemeldet werden, ebenso wie selbstverständlich Verbesserungsvorschläge!

Ich habe bisher sehr von FHEM profitiert, weshalb ich hiermit auch etwas zurückgeben möchte! Dennoch seid bitte nachsichtig, falls irgendetwas nicht 100%ig gelungen sein sollte. Ich gelobe Verbesserung und ich denke, sicher lernfähig zu sein.

24.10.2026 - Dokumentation (für commandref) eingefügt, Download aktualisiert

Beste Grüße
softwear

Hallo softwear
Besten Dank für die Erstellung des Moduls. Ich habe es heute in den Einsatz gebracht und die Daten kommen sofort in fhem an. Besten Dank dafür.
Folgende beiden Meldungen sind im LogFile von fhem ersichtlich:

Code Auswählen Erweitern

2026.11.07 11:00:45 1: PERL WARNING: Prototype mismatch: sub main::encode_json ($) vs ($;$) at ./FHEM/98_PleosVehicle.pm line 26.
2026.11.07 11:00:45 1: PERL WARNING: Prototype mismatch: sub main::to_json ($) vs ($@) at ./FHEM/98_PleosVehicle.pm line 26.
2026.11.07 11:00:45 1: PERL WARNING: Prototype mismatch: sub main::from_json ($) vs ($@) at ./FHEM/98_PleosVehicle.pm line 26.
Grund zur Sorge?

[softwear]

Hallo Mumpitz,

grundsätzlich müsstest Du Dir keine Sorgen machen. Die Warnung besagt, dass Du bereits an irgendeiner Stelle das/ein Modul JSON geladen hast (oder an anderer Stelle die gelisteten Funktionen definiert hast), das von den Prototypen des Perl-Moduls JSON abweicht. Eventuell hast Du eine ältere Perl-Version?

PleosVehicle nutzt ausschließlich JSON::decode_json (ich könnte es auch direkt so addressieren, aber das ist ja nicht die eigentliche Warnung). Pleos selbst nutzt keine der drei Funktionen. Von daher kein Problem, nur durch das Laden eine Redefinition.

Grüße
softwear