ualex73 / slide

Slide Component for Home Assistant
Apache License 2.0
26 stars 8 forks source link
custom-component home-assistant homeassistant python slide slide-component

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

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

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:

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.

alt text

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:

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: slide@somedomain.com
  password: secret
  scan_interval: 30
  invert_position: False
  verify_ssl: True

Configuration variables:

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

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