Skip to content

machina86/homebridge-sunsa

Repository files navigation

Homebridge Sunsa

verified-by-homebridge

homebridge-sunsa is a Homebridge plugin that makes Sunsa Wands available to Apple's HomeKit smart home platform.

This plugin will allow you to open/close your blinds and view the battery status in homekit.

Configuration

You will need two pieces of information for the config settings of this plugin. The apiKey and idUser.

You will need to enable the API key in your Sunsa app by going to Settings->API Settings and setting the Active toggle to on.

You will need to use your User ID from your Sunsa app by going to Settings->API Settings and copying the idUser to use in this plugin.

You can use the settings button in the plugins tab of homebridge to enter this information or use the following for a manual entry in the config.json.

The number for "polling" in the config is for how many seconds you want to wait between getting the status of your devices from the sunsa api. Default is every 10 seconds.

Use true for "showTemp" in order to show the temperature sensors in homekit. Use false to hide. You will need to hide the temperature sensors if you want to group together blinds. Otherwise you will need to use scenes to control groups of blinds.

"platforms": [
    {
        "apiKey": "Your API Key",
        "idUser": 0,
        "showTemp": true,
        "polling": 20,
        "platform": "Sunsa"
    }
]

Using the plugin

Currently this plugin only allows you to close your blinds in one direction. This direction can be set under "Default Smart Home Direction" in your Sunsa app under each device that you have.