Monitor and control your Sunsa blinds wands from Home Assistant.
- Control the position of the blinds.
- Monitor the wands battery level.
- Monitor other wand sensors.
- See wands diagnostic info.
This custom Home Assistant component integrates the Sunsa Smart Blinds Wands by leveraging the public Sunsa REST cloud API. All the wands in your Sunsa account will be added to Home Assistant as cover entities of type blind.
In order to use the integration, activate the Sunsa cloud API for your account:
- Inside the Sunsa app, go to
Setttings
>API Settings
and turn on the toggle. - Take note of the
API Key
andUser ID
.
The recommended method to install this integration is through the Home Assistant Community Store (HACS). Once HACS is setup, you can automatically add the Sunsa integration repository to HACS, then continue on step 6 below after restarting Home Assistant.
Or to add the integration to HACS manually:
- Inside HACS, go to
Integrations
> Click the three-dot overflow menu⋮
on the upper right and clickCustom repositories
. - In the
Custom repositories
dialog add the repository URLhttps://github.com/r01k/ha_sunsa
. ForCategory
selectIntegration
. - Click
ADD
. The integrationSunsa
will be loaded in HACS. - Click on the integration and then
Download
. Select the latest version. Do not selectmaster
. - Do a full restart of Home Assistant.
- Go to
Settings > Devices and services > Integrations
and addSunsa
following theADD INTEGRATION
wizard. You'll need three pieces of information:- Your Sunsa account email. (This is only used in the integration to group the devices and not for authentication).
- Your Sunsa API User ID. See Prerequisites.
- Your Sunsa API Key. See Prerequisites.
Alternatively, you can install the integration manually (advanced). You don't need HACS to do this but then managing integration updates must be done manually too.
- Download the
sunsa.zip
archive from the latest release. (You may have to expandAssets
at the bottom of the release section). - Unpack the zip contents inside the
config/custom_components
folder in your Home Assistant system. You should end up with aconfig/custom_components/sunsa
folder. - Do a full restart of Home Assistant.
- Continue above on step 6 under HACS.
-
The blinds close the wrong way.
Ensure that the
Default Smart Home Direction
setting of the wand in the Sunsa app indicates the default closing direction. -
I added/deleted new wands on my Sunsa account. How do I update Home Assistant?
If you added new wands, reload the integration for them to be added automatically. If wands were removed from your Sunsa account, they'll be marked
unavailable
in Home Assistant and you can delete them manually. -
There is a delay for the wands to move and for Home Assistant to update the status.
This is expected as per the polling interval of 20 seconds recommended by Sunsa. All cloud-polling integrations present some delay.
This integration was developed and tested with several wands of model SUNSA SW1. Correct functionality is not guaranteed with different (maybe older) models. In any case, open an issue if you encounter a problem. Ensure that the wands have up-to-date firmware and always enable debug logging for the integration when troubleshooting:
logger:
default: info
logs:
custom_components.sunsa: debug
Enjoy!