Home-Assistant Custom Component for Slide

This custom component home-assistant (http://www.home-assistant.io) can control the Slide (https://slide.store). NOTE: slide has stopped their business and it is unknown when the Cloud API stops working (currently paid until 30-June-2024)

Slide

Requirements

• Home Assistant 2024.01+

Custom Component vs Integration

The slide integration is included into the Home Assistant and it is based on this custom component. The custom component will contain newer features then the standard integrated one, until it is hopefully merged into Home Assistant. At this moment the local API will only be available in the custom component. Also Home Assistant dictates that integrations should move to the GUI integration instead of the YAML file, which is difficult/impossible with the local API configuration.

Installation

• Copy directory slide <config dir>/custom_components directory.
• Configure with config below.
• Restart Home-Assistant.

Switch between Cloud and Local API

By default the Slide connects to the cloud API, but it is possible to use the local API too (only 1 of them can be active). To switch between the cloud and local API, do the following step:

• Press the reset button 2x

LED flashes 5x fast: cloud API disabled, local API enabled
LED flashes 2x slow: local API disabled, cloud API enabled

NOTE: If a new Slide is installed, it could be the firmware is too old. Configure it via the cloud API and wait a few days.

Local API Usage

To use this component in your installation With the Local API, add the following to your configuration.yaml file for each Slide:

# Example yaml entry

cover:
  - platform: slide
    host: 192.168.1.1
    password: 12345678
    api_version: 2

Configuration variables:

• host (Required): The IP address or hostname of your local Slide
• password (Required): The device code of your Slide (inside of the Slide or in the box, length is 8 characters). NOTE: With api_version: 2 you can fill in anything here, it is not used by the local API
• invert_position (Optional): If the position should be inverted e.g. 0% -> 100% and 100% -> 0% (default = False)
• api_version (Optional): The local API version, this is 1 or 2. Firmware version 0.13.8 and 2.0 are using API version 2, all other are using API version 1. (default = 2)

NOTE: You cannot determine the firmware yourself. If API version 2 does not work, try API version 1. In the following reddit there is a spreadsheet with all known slides and their firmeware version: https://www.reddit.com/r/slidecurtains/comments/1cwc5u2/which_firmware_version_does_your_slide_have/

Cloud API Usage

To use this component in your installation for the Cloud API, add the following to your configuration.yaml file:

# Example configuration.yaml entry

slide:
  username: [email protected]
  password: secret
  scan_interval: 30
  invert_position: False
  verify_ssl: True

Configuration variables:

• username (Required): The e-mail used to register your account with api.goslide.io, with your iPhone/Android App
• password (Required): The password of your account with api.goslide.io
• scan_interval (Optional): Number of seconds between polls (default = 30)
• invert_position (Optional): If the position should be inverted e.g. 0% -> 100% and 100% -> 0% (default = False)
• verify_ssl (Optional): If the SSL certificate should be checked (default = True)

Device visibility in Home Assistant

The Slide integration device, local or cloud, is not shown in Settings -> Devices & Services -> Devices. To see the Slide device information go to Developer tools -> States and search for cover.

Services

• slide.calibrate - It is possible to call this service to calibrate your Slide
• slide.touchgo - Enable or disable the Slide TouchGo feature

Setup Instructions

Setup video Slide with curtain opening both side: https://www.youtube.com/watch?v=i4TPknt7yqU
Setup video Slide with curtain opening single side: https://www.youtube.com/watch?v=iJg2V_yjXv8

There is also a Reddit community created, with usefull Slide information. The URL to it is: https://www.reddit.com/r/slidecurtains/

Reset to factory defaults

The reset button is placed in an opening on the bottom of Slide, opposite the opening with the light. Use something like a paperclip to push and hold the reset button for at least 10 seconds. Slide will return to factory settings and the light will start pulsating (going on and off slowly). The hard reset is now complete.

Debugging

It is possible to debug the Slide component and API library, this can be done by adding the following lines to the configuration.yaml file:

logger:
  logs:
    goslideapi: debug
    custom_components.slide: debug
    homeassistant.components.slide: debug