Zum Hauptinhalt springen

Hyundai / Kia Smart-Home-Integration, kostenlos und Open Source

Hyundai / Kia-Integration für Gladys Assistant

Hyundai-Bluelink- und Kia-Connect-Autos (Europa): Batterie, Laden, Klima, Verriegelung.

Auf GitHub ansehenAlle externen Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Follow and control your Hyundai or Kia car from Gladys through the cloud of the official apps (Bluelink for Hyundai, Kia Connect for Kia), European accounts only for now.

What you get​

One Gladys device per car of the account, with:

  • Electric and plug-in hybrid cars: battery level, electric range, charging state, plugged in, start / stop charging, AC and DC charge limits, time left to full charge.
  • All cars: range (total range for a hybrid or combustion car), climate on / off with its set temperature, doors locked / unlocked (lock and unlock), door or trunk open, window open, odometer, 12 V battery, engine on.
  • Newer cars (2024 and later, such as the EV9 or the IONIQ 5 facelift): outside temperature too.

A dashboard widget Vehicle shows the battery, the range, the charging and climate state, the doors and the last update, with buttons for the climate, charging, locks and a refresh. Two scene actions are available: Refresh a Hyundai / Kia vehicle (outputs the battery level and the range) and Start the climate of a Hyundai / Kia (temperature and duration can be set in the scene).

Configuration​

  1. Make sure the car works in the official app (Bluelink or Kia Connect) and that you accepted its latest terms.
  2. In Gladys, open the integration, choose the brand, then enter the e-mail address and password of the account.
  3. Enter the PIN (4 digits) of the account: it is needed for remote commands (locks, climate, charging). Without it, the car can still be followed.
  4. Choose the account language (the language of the app account), and the device names language (English, French, German or Spanish: Gladys keeps the names given when the car is added), then save.
  5. Click Test the connection: the cars of the account are listed. The test uses the saved configuration, not the form being edited: save first. A result stays under the button until the next test.
  6. In the Discover tab, add your car to Gladys.

Refresh token instead of the password: if the sign-in keeps failing, you can paste a 48-character refresh token (obtained with the tools of the hyundai_kia_connect_api project) in the password field.

The password, PIN and tokens never leave the container except towards the Hyundai / Kia cloud, and are never written in the logs. The session tokens are kept in /data.

How fresh is the data?​

By default, the integration reads the last state the car sent to the cloud every 30 minutes (15, 30 or 60). That read does not wake the car: the car sends its state itself when it is switched off, plugged in, or after a command.

Forced refresh asks the car itself for its state. It wakes the car's modem and uses its 12 V battery, and the cloud limits the number of daily requests. It is off by default; when enabled (every 2, 4, 8 or 12 hours), it never runs between 10 pm and 6 am nor while the engine is on. The widget's Refresh button and the Refresh a Hyundai / Kia vehicle scene action force a read at any time.

Commands​

A command goes through the cloud to the car, which can take from a few seconds to two minutes. Gladys shows the expected value once the car confirms it; if the car does not answer, the real state comes back with the next read. A refused command puts the known value back at once; the widget then shows the reason in red (and a Commands line when the PIN is missing or refused), and the integration logs it.

  • Climate: starts with the set temperature (16 to 30 °C, kept by the integration, 21 °C by default) for the duration chosen in the configuration.
  • Charge limits: 50 to 100 % by steps of 10.
  • Unlock: the widget asks for a confirmation first.

Limits​

  • European accounts only (not North America, China, Australia or India).
  • Tested on a Hyundai IONIQ 5 (European account): sign-in and unlocking; the rest awaits your feedback on the Gladys forum.
  • Nothing about the car's position is read or published.

Troubleshooting​

  • "The account refused the sign-in": check the brand, e-mail and password.
  • "Your account asks you to accept new terms": open the official app, sign in, accept, then save the configuration again.
  • "The sign-in pages refused the connection": too many sign-ins in a short time; wait a few hours before saving again.
  • "Enter the PIN of your account": enter the PIN of the account in the configuration of the integration, then save.
  • "The PIN of your account was refused": check the PIN (the one the official app asks for commands), then save.
  • "No account is saved yet" after Test the connection: save the configuration, then test again.
  • "The daily request quota is spent": the integration pauses for an hour; lower the refresh frequency or turn the forced refresh off.

Konfigurationseinstellungen​

Diese Einstellungen fragt Hyundai / Kia in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Bevor du loslegstsectionNeinDiese Integration meldet sich wie die offizielle App bei deinem Hyundai-Bluelink- oder Kia-Connect-Konto (Europa) an. Verwende das Konto der App, in der dein Auto erscheint. Das Lesen des zuletzt vom Auto gesendeten Zustands weckt es nie, Befehle und erzwungene Abfragen schon. Fernbefehle (Verriegelung, Klimatisierung, Laden) brauchen die 4-stellige PIN des Kontos.
MarkeselectNeinMarke des Kontos (eine Integration pro Marke).
E-Mail-AdressestringJaDie E-Mail-Adresse deines Bluelink- oder Kia-Connect-Kontos.
PasswortsecretJaDas Passwort des Kontos. Wird die Anmeldung trotz richtigem Passwort abgelehnt, füge hier stattdessen ein Refresh-Token ein (siehe Dokumentation).
PIN (4 Ziffern)secretNeinDie 4-stellige PIN des Kontos, die auch die App abfragt. Nötig für Fernbefehle (Verriegelung, Klimatisierung, Laden).
KontospracheselectNeinSprache deines Kontos, die bei der Anmeldung unverändert bleibt (die offizielle App richtet sich danach).
Sprache der GerätenamenselectNeinSprache der Funktionsnamen neuer Geräte (Gladys behält einen Namen, sobald das Gerät erstellt ist).
AbfrageselectNeinWie oft der Zustand gelesen wird, den das Auto zuletzt an die Cloud gesendet hat. Weckt das Auto nie.
Erzwungene AbfrageselectNeinWeckt das Auto, um seinen aktuellen Zustand zu lesen, nie zwischen 22 und 6 Uhr. Das belastet die 12-V-Batterie und zählt zu einem Tageskontingent: Lass es aus, solange du es nicht brauchst.
Dauer der KlimatisierungselectNeinWie lange die Klimatisierung läuft, wenn sie aus Gladys gestartet wird.

So installierst du Hyundai / Kia in Gladys​

  1. Öffne in Gladys Integrationen: Hyundai / Kia erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-hyundai-kia:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-hyundai-kia.

Hyundai / Kia benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Hyundai / Kia ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am