Sunsa Smart Blinds Wand Integration

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.

Prerequisites

In order to use the integration, activate the Sunsa cloud API for your account:

1. Inside the Sunsa app, go to Setttings > API Settings and turn on the toggle.
2. Take note of the API Key and User ID.

Installation

HACS

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 4 below after restarting Home Assistant.

Or to add the integration to HACS manually:

1. Inside HACS, go to Integrations > Click the three-dot overflow menu ⋮ on the upper right and click Custom repositories.
2. In the Custom repositories dialog add the repository URL https://github.com/r01k/ha_sunsa. For Category select Integration.
3. Click ADD. The integration Sunsa will be loaded in HACS.
4. Click on the integration and then DOWNLOAD. Select the latest version. Do not select master.
5. Do a full restart of Home Assistant.
6. Go to Settings > Devices and services > Integrations and add Sunsa following the ADD 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.

Manual Installation (without HACS)

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.

1. Download the sunsa.zip archive from the latest release. (You may have to expand Assets at the bottom of the release section).
2. Unpack the zip contents inside the config/custom_components folder in your Home Assistant system. You should end up with a config/custom_components/sunsa folder.
3. Do a full restart of Home Assistant.
4. Continue above on step 6 under HACS.

FAQ

• 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.

Troubleshooting

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!