Hive Thermostat plugin for Homebridge
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
LICENSE Initial commit Jan 1, 2017
README.md
_config.yml
index.js
package.json

README.md

homebridge-hive

This HomeBridge Plugin adds support for the Hive Active Heating thermostat to be controlled in the Home app in iOS and via Siri.

Installation

1. Install HomeBridge

This is a plugin for HomeBridge. In order to use this, you will need to install HomeBridge. You will need a computer which is always turned on. Personally, I use a Raspberry Pi but this may not be for the faint-hearted. Any Windows machine or Mac will do fine.

  1. Install Node.JS - whatever version is currently "Recommended for most users" should be fine, but this was developed on 6.9.
  2. Install HomeBridge by running the commands provided in their documentation (you don't need to download anything - you're using Node's package manager)
  3. Create a config.json file inside your home directory (so on macOS and Linux the path will be ~/.homebridge/config.json) using the sample file provided by HomeBridge.
  4. Start HomeBridge by running the homebridge command
  5. Add HomeBridge to your iOS device in the Home app using the key provided.

2. Install this plugin

Run this command (you don't need to download anything - you're using Node's package manager)

npm install -g homebridge-hive

3. Configure HomeBridge

In your config.json file, add this accessory providing the username and password you use to log into https://my.hivehome.com

    "accessories": [
        {
            "accessory": "HiveThermostat",
            "name": "Hive Thermostat",
            "username": "you@example.com",
            "password": "123456789"
        }
    ],

Then restart homebridge.

Advanced Configuration

If you have more than one thermostat...

If you have multiple thermostats, you will need to do some additional setup. When you run HomeBridge, you will see an output similar to this...

[Hive Thermostat] Logged In
[Hive Thermostat] Fetching data from Hive API
[Hive Thermostat] Found thermostat xxxxx-xxxxxx-xxxxx-xxxxx. Current temperature is 19.56, set to 19
[Hive Thermostat] Found thermostat yyyyy-yyyyyy-yyyyy-yyyyy. Current temperature is 19.20, set to 19

For each thermostat, add an entry to your config.json file with an additional "id" parameter as it shows in that output. For example:

    "accessories": [
        {
            "accessory": "HiveThermostat",
            "name": "Upstairs Thermostat",
            "username": "you@example.com",
            "password": "123456789",
            "id": "xxxxx-xxxxxx-xxxxx-xxxxx"
        },
        {
            "accessory": "HiveThermostat",
            "name": "Downstairs Thermostat",
            "username": "you@example.com",
            "password": "123456789",
            "id": "yyyyy-yyyyyy-yyyyy-yyyyy"
        }
    ],

Known Issues

  • When changing the mode you will see options for Off, Heat, Cool and Auto even though only Off and Heat are supported (because of course, Hive can only heat, there's no aircon). This is because, as far as I can tell (let me know if I'm wrong) HomeKit doesn't have a way to specify that cooling isn't available. If you choose "Cool" it will do the same as "Off" and if you choose "Auto" it will do the same as "Heat". In both cases, the UI will show a bit strange until it next refreshes its status.
  • If you go into the Details in the Home app, you will see an option to change the display to Celsius or Fahrenheit but attempting to change it will immediately change it back because again, Hive doesn't have that option but HomeKit seems to require it.
  • If you go into the Details in the Home app, you will see a blank space next to Serial Number. This is because the Hive API doesn't expose this information but again, HomeKit seems to require it.

Other Hive Products

Currently this plugin only supports the Hive Active Heating thermostat as this is the only Hive product I use myself although I regularly receive requests from people asking me to support other Hive products.

One person has sent me a Hive Active Plug, and so I am hoping to add support for it soon, however I have no plans to expand this plugin to other Hive products. If you desperately need HomeKit support for other Hive products, you are welcome to send me one of whatever product it is you want support for and I might get round to adding support for it (and will be happy to send it back to you after) but I make no promises I will get round to it any time soon.

I hope that Hive will add native HomeKit support soon making this Plugin no longer required (if anyone has any news about this please let me know).