Zum Hauptinhalt springen

Slide curtains Smart-Home-Integration, kostenlos und Open Source

Slide curtains-Integration für Gladys Assistant

Slide curtain motors (Innovation in Motion) over their local API. Unofficial.

Auf GitHub ansehenAlle Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

This integration connects Gladys to your Slide curtain motors (Innovation in Motion) through their local API. Each Slide becomes a curtain in the Discovery tab of Gladys: open, close, stop, position, and a calibration button. Everything stays on your local network: the cloud of Slide is not used. Unofficial, not affiliated with Innovation in Motion.

Development version (0.1). Written from the local API published by the maker and the goslide-api library, and tested against simulated Slides only: it has never been tested with a real Slide yet. Your feedback is welcome on the GitHub repository.

What you get​

FeatureIn Gladys
Open / closeopen, close, stop the curtain
Position0 % = closed, 100 % = open; read at the interval you choose, and commanded
Calibratea button that starts the calibration, off by default (see Options)

A Slide is never a switch: a "turn everything off" scene does not close it. It is a "curtain": a "close the curtains" of a scene, Google, Alexa, HomeKit or an assistant (MCP) closes it, as expected.

Requirements​

  • One or more Slides on the same local network as Gladys, with their local API turned on in the Slide app.
  • The IP address of each Slide, preferably fixed (reserved in your router).
  • For a Slide on an older firmware (API v1): its 8-character device code, printed on the Slide. Recent Slides (API v2) have no password: anyone on your network can use them, with or without Gladys. Keep them on a trusted network.

Installation​

  1. In Gladys, open the Slide curtains integration, Configuration tab.
  2. Type the addresses of your Slides, separated by commas (8 at most), like 192.168.1.40, 192.168.1.41.
  3. Only for Slides on API v1: type their codes as address=code pairs, separated by commas; nothing for a Slide on API v2. For example, with the addresses above and only the second Slide on API v1: 192.168.1.41=ABCD1234. A code is matched by its address, never by its place in the list: when you change an address, type its pair again. This field is kept by Gladys in its database, never shown again; it only serves to answer the Digest challenge of the Slide at that address (the code itself is never sent).
  4. Save, then press Test the connection: the state of each Slide is shown.
  5. Open the Discovery tab and add your Slides.

Options​

  • Read interval (30 s by default, 10 to 3600 s): how often the position of each Slide is read. After a command, the Slide is also read a few times while the curtain moves (2, 8, 20 and 45 s).
  • Allow calibration (off by default): the "Calibrate" button runs the curtain from one end to the other to learn its travel again. While the option is off, the button is refused; it is read again right before sending.
  • Language of the feature names: French or English.

How the commands are sent​

  • Open, close, a position, calibrate: Gladys first reads the identity (MAC address) of the Slide at that address. If another Slide answers there (an address given to another one by your router), the command is refused and nothing is sent. The command leaves within 3.5 s, or it is refused.
  • Stop always leaves at once: without waiting, even during a pause asked by the Slide, and even right after a restart of the integration. It cancels the moves of that Slide not sent yet.
  • A command that may have left without a clear answer is reported "sent, without confirmation", and the Slide is read again; never sent again by itself.
  • A position is confirmed only by a read equal to the position asked. If the curtain does not reach it (an obstacle, a hand on the curtain), the badge of the Slide turns orange.

Security and privacy​

  • Gladys only talks to the addresses typed, in plain HTTP on your local network; redirects are never followed, no cloud is used.
  • The device codes are never written to the logs, to /data nor to a message. A refused code stops that Slide for good: Gladys never tries it again by itself. Fix the code then save, or press Test the connection for one new try.
  • A "429" or a server error of a Slide pauses it (1 minute to 6 hours), and the pause outlives a restart. After a failure, Gladys never asks a Slide more often than the read interval.

Troubleshooting​

  • "Unreachable": check the IP address (no .local name, the container does not resolve them), the Wi-Fi of the Slide, and that its local API is on.
  • "Asks for its device code": this Slide is on API v1; type its pair address=code in "Device codes".
  • "Not found at the addresses typed": the address of a Slide changed; type the new one, its device and history are kept.
  • Position reversed: tell us on the GitHub repository.

Credits​

Logic ported from goslide-api (Apache-2.0), the library of the Slide integration of Home Assistant. Slide is a trademark of Innovation in Motion; this project is not affiliated with Innovation in Motion.

Konfigurationseinstellungen​

Diese Einstellungen fragt Slide curtains in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Your Slide curtains in GladyssectionNeinEach Slide becomes a curtain in the Discovery tab: open, close, stop, position, and a calibration button. Everything stays on your local network, through the local API of the Slide (plain HTTP): turn on its local API in the Slide app first (recent firmware: API v2, no password; older firmware: API v1, with the device code printed on the Slide). The cloud of Slide is not used. Never tested with a real Slide yet. Unofficial, not affiliated with Innovation in Motion.
Addresses of the SlidesstringJaThe local IP address of each Slide, separated by commas (8 at most), like 192.168.1.40, 192.168.1.41. Give each one a fixed address in your router (DHCP reservation): if one changes, type the new one, its device and history are kept.
Device codes (API v1 only)secretNeinOnly for Slides on the API v1 (older firmware): its address, an equals sign and the 8-character device code printed on it, as address=code pairs separated by commas, like 192.168.1.41=ABCD1234. Nothing for a Slide on API v2. Kept by Gladys in its database, never shown again; it only serves to answer the Digest challenge of the Slide at that address (the code itself is never sent). When you change an address, type its pair again.
Read interval (s)numberNeinHow often the position of each Slide is read (10 to 3600 s). After a command, the Slide is also read a few times while the curtain moves.
Allow calibrationbooleanNeinOff by default. On, the "Calibrate" button of each Slide starts its calibration: the curtain runs from one end to the other to learn its travel again. Rarely needed (after moving the Slide on its rail).
Language of the feature namesselectNeinUsed for the names of the features of the Slides added from now on.

So installierst du Slide curtains in Gladys​

  1. Öffne in Gladys Integrationen: Slide curtains erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/lm1lc3n7/gladys-slide:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-slide.

Slide curtains benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Slide curtains ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am