Saltar al contenido principal

Integración domótica Hyundai / Kia, gratuita y de código abierto

Integración Hyundai / Kia para Gladys Assistant

Coches Hyundai Bluelink y Kia Connect (Europa): batería, carga, climatización, cierres.

Ver en GitHubTodas las integraciones externas
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

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.

Parámetros de configuración​

Estos son los parámetros que Hyundai / Kia te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Antes de empezarsectionNoEsta integración inicia sesión en su cuenta Hyundai Bluelink o Kia Connect (Europa), como la aplicación oficial. Utilice la cuenta de la aplicación en la que aparece su coche. Leer el último estado enviado por el coche nunca lo despierta; los comandos y las actualizaciones forzadas, sí. Los comandos remotos (cierres, climatización, carga) requieren el PIN de 4 dígitos de la cuenta.
MarcaselectNoMarca de la cuenta (una integración por marca).
Correo electrónicostringSíLa dirección de correo electrónico de su cuenta Bluelink o Kia Connect.
ContraseñasecretSíLa contraseña de la cuenta. Si se rechaza el inicio de sesión aunque la contraseña sea correcta, pegue aquí un token de actualización (consulte la documentación).
PIN (4 dígitos)secretNoEl PIN de 4 dígitos de la cuenta, el que pide la aplicación. Necesario para los comandos remotos (cierres, climatización, carga).
Idioma de la cuentaselectNoIdioma de su cuenta, que el inicio de sesión conserva tal cual (la aplicación oficial lo sigue).
Idioma de los nombresselectNoIdioma de los nombres de las funciones de los nuevos dispositivos (Gladys conserva un nombre una vez creado el dispositivo).
ActualizaciónselectNoFrecuencia de lectura del último estado que el coche envió a la nube. Nunca despierta el coche.
Actualización forzadaselectNoDespierta el coche para leer su estado actual, nunca entre las 22:00 y las 6:00. Consume la batería de 12 V y cuenta en una cuota diaria: déjelo desactivado salvo que lo necesite.
Duración de la climatizaciónselectNoTiempo de funcionamiento de la climatización iniciada desde Gladys.

Cómo instalar Hyundai / Kia en Gladys​

  1. En Gladys, abre Integraciones: Hyundai / Kia aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-hyundai-kia:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-hyundai-kia.

Hyundai / Kia requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Hyundai / Kia es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en