Bluelink binding (Hyundai/Kia/Genesis) [5.0.0.0;5.2.0.0)

marcusb · December 23, 2025, 1:53am

logo

This binding integrates these telematics systems for connected vehicles:

Hyundai Bluelink (CA, EU, and US regions)
Kia Connect (CA and EU, also formerly known as UVO)
Genesis Connected Services (CA, EU, US)

It allows you to monitor your vehicle’s status and control various features remotely.

NOTE: Due to regional differences, only the above brand/region combinations are supported.
Not all combinations have been tested.

Changelog

Version 0.4.0

Support for EU region

Version 0.3.0

[alpha] Support for Canada region (Hyundai, Kia, Genesis) - testing needed!

Version 0.2.0

Fixes, sync with latest PR

Version 0.1.0

initial release

Resources

org.openhab.binding.bluelink-5.2.0-SNAPSHOT.jar

README.md

Sources

Ben_Douglas · December 23, 2025, 7:19pm

I would love to test this out for you but unfortunately I live in Canada. If you do make a Canadian version, I can be a tester for you.

marcusb · December 26, 2025, 1:59am

Hi,
I have made a branch here that you can test: GitHub - marcusb/openhab-addons at canada

Are you comfortable with building from git sources? After checking out the source tree, build the jar with

mvn -pl /bundles/org.openhab.binding.bluelink package

You can then drop in the resulting jar file in your addons/ folder. This will probably require openHAB 5.1.0.

Bump up the log level to DEBUG (in Settings → Add-on settings → Bluelink binding) and send me any logs from the binding. It’s not easy to get this right without being able to test it, so I will push updates to the branch when I get your feedback.

marcusb · January 1, 2026, 4:13pm

The version for CA is now available through the Marketplace (v0.3.0) - considered alpha quality since I’m not able to test it myself - testers appreciated.

(The US region should work, that has already been merged into the openhab repo.)

Matt_Schin · January 14, 2026, 3:47pm

I am in Austria and could test if i get a jar!

marcusb · February 16, 2026, 3:47pm

Hi, the latest snapshot (v0.4.0) has EU support so you can give it a try.

Andy_Co · February 16, 2026, 7:50pm

Hi, how I can get EU refresh token ?

marcusb · February 17, 2026, 12:16am

I believe the instructions are here but haven’t tried myself.

Andy_Co · February 17, 2026, 6:35am

ok, thank you, I will try.

florian-h05 · February 18, 2026, 3:43pm

I used the following script to get an refresh token:

cd-tronic · February 20, 2026, 8:34am

Tried KIA EU right now. Looks good!

Thanks for the Binding!

bram_dirriwachter · February 21, 2026, 7:07am

Thanks for this! Using the EU version for a Hyundai, all working well.

tailor09 · February 22, 2026, 9:08pm

Thank you for this project!

A while ago I tried myself to get a Hyundai/KIA/Genesis Binding working. I could not finish the project due to limited time and also Hyundai Motor Group launched https://pleos.ai/playground.

Hope you can finish and I can use this someday meanwhile I can put this unfinished project on GitHub: GitHub - t09/org.openhab.binding.hyundaibluelink

I put a working JAR file here: org.openhab.binding.hyundaibluelink/JAR/org.openhab.binding.hyundaibluelink-5.1.2-SNAPSHOT.jar at main · t09/org.openhab.binding.hyundaibluelink · GitHub

Untested for newer car models after 2023!

BrettLHolmes · February 25, 2026, 2:00pm

@marcusb i was looking for the github location to log an issue _ I hgave a Kia 9 that connects for a few seconds and then gives an error as blow - I have the Debug Logs

CCU/CCS2 protocol support hasn’t been implemented yet. Report this on GitHub and provide debug logs.

florian-h05 · February 25, 2026, 2:54pm

If you are in EU, that’s actually “my part” of the binding.
You can PM me the debug logs, they should contain the API responses. I need them to implement the data mapping. Note they contain sensitive data such as geo location, so please only PM me (you can change the number values if you want, but don’t touch the structure) and don’t post publicly.

BrettLHolmes · February 25, 2026, 2:55pm

Hi @florian-h05 - have two vehicles - two accounts - with two different errors

florian-h05 · February 25, 2026, 2:56pm

What regions, brands and car models?

BrettLHolmes · March 11, 2026, 9:06pm

Hi Florian

I am getting a strange message on the Kia EV9 the one with the CCU/CCS2

The polling stops and i seem to get this message in the loggs

openhab.log:2026-03-11 21:55:51.113 [WARN ] [.core.thing.binding.BaseThingHandler] - Handler BluelinkVehicleHandler of thing bluelink:vehicle:ca5baf8699:026fdeeffd tried accessing its bridge although the handler was already disposed.openhab.log:2026-03-11 21:56:24.420 [DEBUG] [ernal.handler.BluelinkVehicleHandler] - Disposing Bluelink vehicle handler

After this happens i have to stop the bridge thing and the restart and it gets data again

Ps still not been able to get the owner to test the actions - but scheduled for Friday

Sysiphus · May 1, 2026, 2:59pm

Hi @marcusb, hi @florian-h05,

i built an Widget for SemanticHomeMenu for my Cars showing and making settable the available Data from my Cars in a compact form.

I stumpled upon that for my Ioniq5 the AC- and DC-Limit are created as :

type: number:dimensionless - Point > Status > Energy

This doesn’t allow to change the setting, what is possible with the Hyundai App.
Changing the item to a setpoint doesn’t help, so i think the binding isn’t able the treat this datapoint as setpoint.

Could you have a look into this ?
The binding is working really great and helped me circumvent the situation that my OpenWB WallBox stopped the support for SoC-Data for Kia/Hyundai and also node-red with bluelinky is more a pain as a working solution.
So many thanks for this great Binding.

Greetings
Stephan Sandmann

florian-h05 · May 3, 2026, 3:39pm

Setting the charge limits is already supported on the API layer of the binding, see:

github.com/openhab/openhab-addons

bundles/org.openhab.binding.bluelink/src/main/java/org/openhab/binding/bluelink/internal/api/AbstractBluelinkApi.java

15dc1993a


      
          /**
           * Set DC charge limit (EV only).
           *
           * @param vehicle the vehicle
           * @param limit charge limit percentage (0-100)
           * @return true if the command was sent successfully
           * @throws BluelinkApiException if the request fails
           */
          public abstract boolean setChargeLimitDC(IVehicle vehicle, int limit) throws BluelinkApiException;
          
          /**
           * Set AC charge limit (EV only).
           *
           * @param vehicle the vehicle
           * @param limit charge limit percentage (0-100)
           * @return true if the command was sent successfully
           * @throws BluelinkApiException if the request fails
           */
          public abstract boolean setChargeLimitAC(IVehicle vehicle, int limit) throws BluelinkApiException;

… and for the different regions (CA, EU,US) these methods are implemented.

We just need to expose that functionality and make the related Items read-write.