HommiePeter / homebridge-toon-platform

Homebridge Platform to disclose Toon Thermostat and its connected devices (Smoke Detectors, Wallplugs, Huelights) to homekit
GNU General Public License v3.0
5 stars 4 forks source link
homebridge homebridge-plugin homebridge-toon-platform

This plugin enables homebridge to communicate with Toon and its connected devices via HomeKit.

npm install -g homebridge-toon-platform

Configuration

The configuration file consists of the following options to configure

    {
    "platforms": [
        {
            "name": "<Put your Toons name>",
            "apiToken": "<Put your API token from Eneco here>",
            "switch_hue": false,
            "switch_smoke": true or false,
            "switch_wallplug": true or false,
            "AgreementIndex": number,
            "refreshRate": number, 
            "platform": "Toon-Platform"
        },
      ], 
    }

API TOKEN:

To make the plugin work you need to obtain a consumer_key from developer.toon.eu The following should be added to the homebridge config.json:

An API token which is valid for 10 years can be obtained via https://api.toon.eu/toonapi-accesstoken?tenant_id=eneco&client_id=<consumer_key>

SWITCHES:

The config identifies 3 diffent swithes that can be set to make connected devices to your Toon visible in Apple Homekit. Switches can be set true of false. (Only Hue Lights are defaulted to false). False results in not importing connected devices / True results in importing (if any) connected devices

AGREEMENT SELECTION:

The plugin automatically selects the first agreement in the list, however if agreement selection is necessary, add the following config parameter. "AgreementIndex": . Default this numbus is 0.

The plugin automatically lists the available options in the Homebridge log.

REFRESH RATE

Although events are handeld directly, retrieving consumption data from Eneco's service is done at an interval. Default this interval is set to 300 seconds (300.000 msecs) to aviod limit rate errors in your Homebridge setup. Limit rate erros with lead to up losing the ability to retrieve consumption data and switch connected devices for a certain time. You can customize the interval to your liking by specifing a interval period in msecs at

TO DO: