terminatornl / kia_uvo

A Home Assistant HACS integration that supports Kia Connect(Uvo) and Hyundai Bluelink. The integration supports the EU, Canada and the USA.

I have baked a custom integration for Kia Uvo / Hyundai Bluelink, this will be working for new account types. Thanks for your hard work @wcomartin. This project was mostly inspired by his home assistant integration. This now uses our underlying python package: https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api.

Installation

You can install this either manually copying files or using HACS. Configuration can be done on UI, you need to enter your username and password, (I know, translations are missing, a PR for this would be great!).

• EU, CA and US is supported by this. USA and China support is limited.
• Multiple cars and accounts are supported. To add additional accounts just go through setup a second time.
• update - It will fetch the cached information every 30 minutes from Kia Uvo / Hyundai Bluelink Servers. Now Configurable
• force update - It will ask your car for the latest data every 4 hours. Now Configurable
• It will not force update between 10PM to 6AM. I am trying to be cautios here. Now Configurable
• By default, distance unit is based on HA metric/imperial preference, you need to configure each entity if you would like other units.

Supported entities

• Air Conditioner Status, Defroster Status, Set Temperature
• Heated Rear Window, Heated Steering Wheel
• Car Battery Level (12v), EV Battery Level, Remaining Time to Full Charge
• Tire Pressure Warnings (individual and all)
• Charge Status and Plugged In Status
• Low Fuel Light Status (for PHEV and IC)
• Doors, Trunk, Window and Hood Open/Close Status
• Locking and Unlocking
• Engine Status
• Location/Coordinates (over GPS) and Geocoded Location using OpenStreetMap (optional, disabled by default)
• Last Service and Next Service in Canada
• Odometer, EV Range (for PHEV and EV), Fuel Range (for PHEV and IC), Total Range (for PHEV and EV)
• Latest Update
• cache update interval, force update interval, blackout start and finish hours

Supported services

These can be access by going to the developer menu followed by services.

• update: get latest cached vehicle data
• force_update: this will make a call to your vehicle to get its latest data, do not overuse this!
• start_climate / stop_climate: Starts the ICE engine in some regions or starts EV climate.
• start_charge / stop_charge: You can control your charging using these services
• set_charge_limits: You can control your charging capacity limits using this services
• open_charge_port / close_charge_port: Open or close the charge port.

Service	EU	CA	USA Kia	USA Hyundai	China
Update	✔	✔	✔	✔	✔
Force Update	✔	✔	✔		✔
Lock Unlock	✔	✔	✔	✔	✔
start stop climate	✔	✔	✔	✔	✔
start stop charge	✔	✔	✔
set charge limits	✔	✔	✔
open and close charge port(None functional, needs testing)

I have posted an example screenshot from my own car.

Troubleshooting

If you receive an error while trying to login, please go through these steps;

1. As of now, integration only supports USA, EU and CAD region, so if you are outside, you are more than welcome to create an issue and become a test user for changes to expand coverage. USA coverage isn't complete.
2. If you are in EU, please log out from UVO app and login again. While logging in, if your account was created in legacy UVO servers, they will be migrated to new Kia Uvo / Hyundai Bluelink servers. Related Issue: Hyundai-Kia-Connect#22
3. If you have migrated recently, you might need to wait one day to try again. Related Issue: https://community.home-assistant.io/t/kia-uvo-integration-pre-alpha/297927/12?u=fuatakgun
4. As a last resort, please double check your account credentials or you can create a new account and share your car from main account to new account.
5. You can enable logging for this integration specifically and share your logs, so I can have a deep dive investigation. To enable logging, update your configuration.yaml like this, we can get more information in Configuration -> Logs page

logger:
  default: warning
  logs:
    custom_components.kia_uvo: debug
    hyundai_kia_connect_api: debug