Kona a Home Assistant

Bluelink má aplikaci, ale má i cloudové API — a to umí Home Assistant číst i ovládat. Auto se tak stane dalším zařízením v domě: vidíte baterii, předehříváte podle kalendáře, nabíjíte v nízkém tarifu. S několika háčky, které stojí za to znát předem.

Když nemáte čas
  • Oficiální integrace neexistuje. Komunitní Hyundai / Kia Connect (kia_uvo) z HACS funguje pro Evropu na jméno a heslo k účtu Bluelink — po půl roce výpadku zase od května 2026.
  • Dostanete stav baterie, dojezd, nabíjení, polohu, zámky, 12V baterii, tlak pneu — a akce: předehřát, zamknout, nastavit limity, spustit či zastavit nabíjení.
  • Evropské API má strop ~200 volání denně a „force update“ budí auto a vybíjí 12V. Nechte výchozích 30 minut z cache a nevynucujte.
  • Nabíjení v nízkém tarifu: HDO z ČEZ Distribuce je pro HA hotové, ale ovládejte wallbox nebo plán v autě — nikdy Shelly zásuvku na nabíjecím kabelu.
  • Až bude wallbox (nebo fotovoltaika), správný nástroj je evcc vedle Home Assistantu; Konu zná a má pro ni jednu specialitu (min. 8 A).

Co se dá a co ne

Hyundai žádnou integraci pro Home Assistant nevydal a nevydá. Všechno níž stojí na tom, že komunita rozebrala protokol, kterým mluví aplikace Bluelink se servery Hyundai, a napsala knihovnu hyundai_kia_connect_api. Nad ní stojí HACS integrace Hyundai / Kia Connect (v repozitáři pořád pod starým jménem kia_uvo), kterou používají tisíce lidí v Evropě.

Z toho plyne první háček: běží to z dobré vůle Hyundai. V říjnu 2025 Hyundai Europe přepnul účty na nové přihlašování (MyHyundai) a integrace přestala fungovat; půl roku se to obcházelo ručně získávaným tokenem z prohlížeče, od května 2026 (knihovna 4.12) jde zase jméno a heslo, v srpnu 2026 je klid. Počítejte s tím, že se to zase jednou stane. Automatizace stavějte tak, aby bez auta v HA nic důležitého nestálo — připomínka nedorazí, ale nabíjení se nesmí rozbít.

Instalace

  1. V HACS najděte Hyundai / Kia Connect a nainstalujte. Restart HA.
  2. Nastavení → Zařízení a služby → Přidat → „Hyundai / Kia Connect“. Region Europe, značka Hyundai, přihlášení stejným jménem a heslem jako v aplikaci myHyundai, PIN z Bluelinku.
  3. V možnostech integrace nechte cached update 30 minut a vypněte nebo omezte force update (výchozí 4 h, mimo 22–06 h). Proč, viz níže.
  4. Auto se objeví jako zařízení s několika desítkami entit. Pojmenujte si ho krátce — názvy entit se od jména odvozují.
Ojetina

Funguje to jen pro účet, ke kterému je auto přiřazené jako hlavní. Dokud předchozí majitel auto ze svého Bluelinku neodebral a vy ho nemáte ve svém (kapitola 6), Home Assistant uvidí prázdný seznam vozů a nic víc.

Co z auta dostanete

Entity (čtení)Akce (ovládání)
stav baterie %, dojezd, zbývající čas nabíjení, výkon nabíjenístart_climate / stop_climate — teplota, odmrazení, vyhřívání volantu a sedadel, délka
nabíjí se / zapojeno / dvířka portustart_charge / stop_charge
limity nabíjení AC a DCset_charge_limits, set_charging_current
12V baterie %, varování 12Vlock / unlock
poloha (device_tracker), odometr, čas poslední aktualizaceopen_charge_port / close_charge_port
zamčeno, dveře, okna, kufr, kapotaschedule_charging_and_climate — plán nabíjení a odjezdu v autě
tlak pneumatik (varování), klimatizace, teplota v kabiněforce_update — vzbudit auto a přečíst čerstvá data (opatrně)

Předehřev baterie před rychlonabíjením (Battery conditioning) integrace zatím neumí — to zůstává v aplikaci a v navigaci auta.

Dva háčky: limit volání a 12V baterie

Integrace pracuje ve dvou režimech. Cached update se ptá serveru Hyundai na to, co auto naposledy samo nahlásilo — auto se nebudí a limit se skoro nečerpá. Force update pošle do auta příkaz „probuď se a nahlas stav“: auto vzbudí řídicí jednotky, komunikuje přes mobilní síť — a bere to z 12V baterie, která u Kony není silná stránka (kapitola 7).

  • Evropský Bluelink má strop kolem 200 volání denně na účet; při překročení Hyundai účet dočasně zablokuje — a nefunguje ani aplikace v telefonu.
  • Každá akce (předehřát, zamknout) je jedno až dvě volání. Cached update každých 30 minut je 48 volání. Zbývá dost, pokud si to nezkazíte vynucováním.
  • Auto samo nahlašuje stav po zamknutí, po dojezdu, při změně nabíjení — cache tedy bývá aktuální přesně ve chvílích, kdy vás zajímá.
Pravidlo

Force update nikdy v automatizaci. Nejvýš jako tlačítko na dashboardu, které stisknete, když opravdu potřebujete vědět, jestli je auto zamčené. Kdo nastaví vynucené čtení každých 10 minut, má za dva týdny vybitou 12V a zablokovaný účet — na fórech je to nejčastější stížnost.

Automatizace, které dávají smysl

1. Připomínka: zapoj Konu

Nejjednodušší a nejužitečnější. Večer, auto doma, baterie pod 40 %, kabel nezapojený → notifikace do telefonu. Názvy entit jsou ilustrativní, vaše budou podle jména vozu.

alias: Kona – připomínka zapojení
trigger:
  - platform: time
    at: "21:00:00"
condition:
  - condition: state
    entity_id: device_tracker.kona_location
    state: home
  - condition: numeric_state
    entity_id: sensor.kona_ev_battery_level
    below: 40
  - condition: state
    entity_id: binary_sensor.kona_ev_battery_plug
    state: "off"
action:
  - service: notify.mobile_app_telefon
    data:
      message: "Kona má {{ states('sensor.kona_ev_battery_level') }} % a není zapojená."

2. Předehřátí v pracovní dny

Spouštět jen když je auto zapojené v kabelu — jinak topíte z baterie. Podmínka na pracovní den je senzor binary_sensor.workday_sensor z integrace Workday, teplotu venku už v HA máte (senzor na terase).

alias: Kona – předehřát před odjezdem
trigger:
  - platform: time
    at: "06:35:00"
condition:
  - condition: state
    entity_id: binary_sensor.workday_sensor
    state: "on"
  - condition: state
    entity_id: binary_sensor.kona_ev_battery_plug
    state: "on"
  - condition: numeric_state
    entity_id: sensor.terasa_temperature
    below: 8
action:
  - service: kia_uvo.start_climate
    data:
      device_id: "ID zařízení Kona"
      temperature: 22
      defrost: true
      heating: 1
      duration: 15

Přesné názvy parametrů (vyhřívání volantu, sedadel) si zobrazte v Nástroje pro vývojáře → Akce; liší se mezi verzemi. Předehřev z kabelu nestojí dojezd, jen kWh ze zásuvky.

3. Hlídač 12V baterie

Kona hlásí napětí 12V baterie v procentech. Když klesne pod 60 % a auto stojí, je to varování týden dopředu — na rozdíl od rána, kdy neodemknete dveře.

alias: Kona – 12V slabá
trigger:
  - platform: numeric_state
    entity_id: sensor.kona_12v_battery_level
    below: 60
    for: "02:00:00"
action:
  - service: notify.mobile_app_telefon
    data:
      message: "12V baterie Kony je na {{ states('sensor.kona_12v_battery_level') }} %. Projeď se, nebo zapni Utility mode."

4. Nabíjení v nízkém tarifu

Bojler už u vás spíná Shelly podle HDO; auto může jet podle stejného signálu. Signál HDO do HA dostanete integrací ČEZ Distribuce (HACS, hacs_cez_distribuce): přihlásí se do portálu distributora vaším jménem a vyrobí kalendář spínacích oken a binární senzor „nízký tarif právě teď“. Pro jižní Čechy a Moravu existuje totéž pro EG.D (HomeAssistant-EGDdistribuce). Ovládat pak můžete dvěma způsoby:

  • Bez wallboxu: auto nabíjí kabelem ze zásuvky a HA mu při začátku okna pošle start_charge, při konci stop_charge. Dvě volání denně, žádné buzení. Jednodušší je ale nastavit plán přímo v autě — HDO okna u D27d se nemění.
  • S wallboxem: HA spíná wallbox, ne auto. Vyplatí se wallbox s lokálním rozhraním bez cloudu — go-e Charger nebo OpenEVSE mají integraci v jádru HA, Wallbox Pulsar jde přes HACS lokálně, Easee a Zaptec přes cloud. Ptejte se na to při výběru, ne po instalaci.
Nikdy Shelly Plug na nabíjecí kabel

Shelly Plug S je stavěný na 10 A a kabel do zásuvky z něj bere 10 A trvale deset hodin. Zásuvkové relé se přehřívá, kontakty se spékají, nejhorší případ je požár v garáži. Nabíjení se spíná buď v autě, nebo ve wallboxu, případně stykačem dimenzovaným na trvalý proud — ne v chytré zásuvce. Totéž platí pro Shelly 2.5.

5. Přítomnost a odjezd — s výhradou

Poloha auta se obnovuje jen s cached update, tedy jednou za 30 minut a po zamknutí. Na „auto odjelo, zapni Jablotron“ je to pomalé a nespolehlivé — pro přítomnost používejte dál telefon. Poloha z auta se hodí na „kde jsem zaparkoval“ a na podmínku „auto je doma“ v automatizacích výše, kde na minutách nezáleží.

evcc: až bude wallbox nebo fotovoltaika

evcc je otevřený nástroj na řízení nabíjení, který běží vedle Home Assistantu (jako doplněk nebo v Dockeru). Umí nabíjet z přebytků fotovoltaiky, v levných oknech tarifu, na cílové procento do času odjezdu, a k tomu zná stovky wallboxů a měřičů. Konu zná jako vozidlo přes šablonu Hyundai Bluelink — pro Evropu stačí jméno a heslo, data čte jen během nabíjení, takže neplýtvá voláními ani 12V.

  • Specialita Kony: pod 8 A na fázi se auto přepne interně na dvě fáze a výkon poskakuje. V evcc nastavte minCurrent: 8, jinak regulace přebytků kmitá.
  • Do HA se evcc napojí přes HACS integraci ha-evcc — vidíte a ovládáte nabíjení z HA, ale regulační smyčka běží v evcc, kde patří.
  • Pokud fotovoltaiku neplánujete, evcc je zbytečná vrstva. Wallbox s HA integrací a HDO senzor stačí.

Statistiky bez buzení auta

Kdo chce knihu jízd, spotřebu po cestách a graf stavu baterie za rok, ale nechce auto trápit: hyundai_kia_connect_monitor (ZuinigeRijder) jsou python skripty pro Raspberry Pi, které čtou jen serverovou cache, ukládají jízdy a nabíjení do CSV a posílají je přes MQTT do Home Assistantu. Vedle integrace kia_uvo to jde provozovat souběžně; volání sdílejí stejný limit.

Realistický plán pro vás

  1. Nainstalovat Hyundai / Kia Connect, cached 30 min, force update vypnout. Tlačítko force update na dashboard.
  2. Tři automatizace výše: připomínka zapojení, předehřátí v pracovní dny, hlídač 12V.
  3. Integrace ČEZ Distribuce pro HDO — hodí se i pro bojler, kalendář oken uvidíte v HA.
  4. Až přijde wallbox: vybírat podle lokálního API (go-e, OpenEVSE), ne podle designu. Spínat wallbox, ne auto.
  5. Až přijde fotovoltaika: evcc s minCurrent: 8.
  6. Vždycky: auto v HA je bonus. Když Hyundai zase změní přihlašování, nesmí doma přestat fungovat nic než notifikace.

Zdroje