SteffeyDev / homebridge-hyundai-bluelink

Homebridge plugin for Hyundai BlueLink
Apache License 2.0
26 stars 13 forks source link

Homebridge Hyundai Bluelink

verified-by-homebridge npm version Build Status)

This is a Homebridge platform plugin that uses bluelinky to connect your Hyundai or Kia vehicle to HomeKit, which allows you control your vehicle using Siri, shortcuts, or the Home app.

Maintainer Needed

I no longer use Homebridge/HOOBS, and thus cannot maintain this plugin. Reach out if you are interested.

Installation

This plugin can be installed from the Homebridge web console:

  1. Log in to the console and go to the Plugins tab
  2. Search for Bluelink, and install Homebridge Hyundai BlueLink
  3. Edit the settings in the UI, or directly in the config.json file following the schema below

Configuration

Sample

"platforms": [
    {
        "credentials": {
            "username": "your username / email",
            "password": "your password",
            "region": "US / CA / EU",
            "brand": "Hyundai / Kia",
            "pin": "your pin"
        },
        "vehicles": [
            {
                "vin": "your VIN",
                "maxRange": 500
            }
        ],
        "remoteStart": {
            "airCtrl": false,
            "heating1": false,
            "defrost": false,
            "airTempvalue": 72,
            "igniOnDuration": 10
        },
        "platform": "Hyundai"
    }
],

Notes

Known Issues

SSL Key too Small

Log:

[Hyundai] Client Error GotError [RequestError]: write EPROTO 1995553232:error:141A318A:SSL routines:tls_process_ske_dhe:dh key too small:../deps/openssl/openssl/ssl/statem/statem_clnt.c:2158:

This happens because the Bluelink API used has insecure SSL settings.

Workaround: Edit /etc/ssl/openssl.cnf, change the line CipherString = DEFAULT@SECLEVEL=2 to CipherString = DEFAULT@SECLEVEL=1 (change 2 to 1 at end of line)

Source: https://github.com/FreshRSS/FreshRSS/issues/3029

Status Refresh Delay

Due to Hyundai's API Rate Limits, the car status (locked, on/off, range) is only updated once per hour. Actions taken from homebridge get automatically refreshed, but actions taken elsewhere (e.g. bluelink app, key fab) may not display in homebridge for up to an hour.