Intégration domotique Slide curtains, gratuite et open source
Moteurs de rideaux Slide (Innovation in Motion) par leur API locale. Non officiel.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à vos moteurs de rideaux Slide (Innovation in Motion) par leur API locale. Chaque Slide devient un rideau dans l'onglet Découverte de Gladys : ouverture, fermeture, arrêt, position, et un bouton de calibrage. Tout reste sur votre réseau local : le cloud de Slide n'est pas utilisé. Non officiel, sans lien avec Innovation in Motion.
Version de développement (0.1). Écrite d'après l'API locale publiée par le fabricant et la bibliothèque goslide-api, et testée contre des Slides simulés seulement : elle n'a jamais été testée avec un vrai Slide pour l'instant. Vos retours sont les bienvenus sur le dépôt GitHub.
Ce que vous obtenez
| Fonctionnalité | Dans Gladys |
|---|---|
| Ouverture / fermeture | ouvrir, fermer, arrêter le rideau |
| Position | 0 % = fermé, 100 % = ouvert ; lue à l'intervalle choisi, et pilotable |
| Calibrer | un bouton qui lance le calibrage du Slide, désactivé par défaut (voir Options) |
Le Slide n'est jamais un interrupteur : une scène « tout éteindre » ne le ferme pas. Il est classé « rideau » : un « ferme les rideaux » d'une scène, de Google, d'Alexa, de HomeKit ou d'un assistant (MCP) le ferme, comme attendu.
Prérequis
- Un ou plusieurs Slides sur le même réseau local que Gladys, avec leur API locale activée dans l'application Slide.
- L'adresse IP de chaque Slide, de préférence fixe (réservée dans votre box internet).
- Pour un Slide au micrologiciel ancien (API v1) : son code d'appareil de 8 caractères, imprimé sur le Slide. Les Slides récents (API v2) n'ont pas de mot de passe : n'importe qui sur votre réseau peut s'en servir, avec ou sans Gladys. Gardez-les sur un réseau de confiance.
Installation
- Dans Gladys, ouvrez l'intégration Rideaux Slide, onglet Configuration.
- Saisissez les adresses de vos Slides, séparées par des virgules (8 au
plus), par exemple
192.168.1.40, 192.168.1.41. - Seulement pour des Slides en API v1 : saisissez leurs codes en couples
adresse=code, séparés par des virgules ; rien pour un Slide en API v2. Par exemple, avec les adresses ci-dessus et un seul Slide en API v1 (le second) :192.168.1.41=ABCD1234. Un code est rattaché à son adresse, jamais à sa place dans la liste : si vous changez une adresse, saisissez de nouveau son couple. Ce champ est gardé par Gladys dans sa base, jamais réaffiché ; il sert seulement à répondre au défi Digest du Slide à cette adresse (le code lui-même ne circule pas). - Enregistrez, puis cliquez sur Tester la connexion : l'état de chaque Slide s'affiche.
- Ouvrez l'onglet Découverte et ajoutez vos Slides.
Options
- Intervalle de lecture (30 s par défaut, 10 à 3600 s) : fréquence de lecture de la position de chaque Slide. Après une commande, le Slide est aussi relu quelques fois pendant que le rideau bouge (2, 8, 20 et 45 s).
- Autoriser le calibrage (désactivé par défaut) : le bouton « Calibrer » fait aller le rideau d'un bout à l'autre pour réapprendre sa course. Tant que l'option est désactivée, le bouton est refusé ; elle est relue juste avant l'envoi.
- Langue des noms des fonctionnalités : français ou anglais.
Comment les commandes sont envoyées
- Ouvrir, fermer, une position, calibrer : Gladys lit d'abord l'identité (adresse MAC) du Slide à cette adresse. Si un autre Slide y répond (une adresse donnée à un autre par votre box), la commande est refusée sans rien envoyer. La commande part en moins de 3,5 s, ou elle est refusée.
- Arrêter part toujours tout de suite : sans attendre, même pendant une pause demandée par le Slide, et même juste après un redémarrage de l'intégration. Il annule les mouvements de ce Slide pas encore envoyés.
- Une commande qui a pu partir sans réponse claire est annoncée « envoyée, sans confirmation », et le Slide est relu ; jamais renvoyée d'elle-même.
- Une position n'est confirmée que par une lecture égale à la position demandée. Si le rideau ne l'atteint pas (un obstacle, une main sur le rideau), le badge du Slide passe à l'orange.
Sécurité et vie privée
- Gladys ne parle qu'aux adresses saisies, en HTTP simple sur votre réseau local ; les redirections ne sont jamais suivies, aucun cloud n'est utilisé.
- Les codes d'appareil ne sont jamais écrits dans les journaux, dans
/datani dans un message. Un code refusé arrête ce Slide pour de bon : Gladys ne le réessaie jamais d'elle-même. Corrigez le code puis enregistrez, ou appuyez sur Tester la connexion pour un seul nouvel essai. - Un « 429 » ou une erreur serveur d'un Slide le met en pause (1 minute à 6 heures), et la pause survit à un redémarrage. Après un échec, Gladys n'interroge jamais un Slide plus souvent que l'intervalle de lecture.
Dépannage
- « Injoignable » : vérifiez l'adresse IP (pas de nom en
.local, le conteneur ne les résout pas), le Wi-Fi du Slide, et que son API locale est activée. - « Demande son code d'appareil » : ce Slide est en API v1 ; saisissez son
couple
adresse=codedans « Codes des appareils ». - « Introuvable aux adresses saisies » : l'adresse d'un Slide a changé ; saisissez la nouvelle, son appareil et son historique sont gardés.
- Position inversée : dites-le-nous sur le dépôt GitHub.
Crédits
Logique reprise de goslide-api (Apache-2.0), la bibliothèque de l'intégration Slide de Home Assistant. Slide est une marque d'Innovation in Motion ; ce projet est sans lien avec Innovation in Motion.
Paramètres de configuration
Voici les paramètres demandés par Slide curtains dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos rideaux Slide dans Gladys | section | Non | Chaque Slide devient un rideau dans l'onglet Découverte : ouverture, fermeture, arrêt, position, et un bouton de calibrage. Tout reste sur votre réseau local, par l'API locale du Slide (HTTP simple) : activez d'abord son API locale dans l'application Slide (micrologiciel récent : API v2, sans mot de passe ; plus ancien : API v1, avec le code d'appareil imprimé sur le Slide). Le cloud de Slide n'est pas utilisé. Jamais testée avec un vrai Slide pour l'instant. Non officiel, sans lien avec Innovation in Motion. |
| Adresses des Slides | string | Oui | L'adresse IP locale de chaque Slide, séparées par des virgules (8 au plus), par exemple 192.168.1.40, 192.168.1.41. Donnez à chacun une adresse fixe dans votre box (réservation DHCP) : si l'une change, saisissez la nouvelle, son appareil et son historique sont gardés. |
| Codes des appareils (API v1 seulement) | secret | Non | Seulement pour les Slides en API v1 (micrologiciel ancien) : son adresse, un signe égal et le code d'appareil de 8 caractères imprimé dessus, en couples adresse=code séparés par des virgules, par exemple 192.168.1.41=ABCD1234. Rien pour un Slide en API v2. Gardé par Gladys dans sa base, jamais réaffiché ; il sert seulement à répondre au défi Digest du Slide à cette adresse (le code lui-même ne circule pas). Si vous changez une adresse, saisissez de nouveau son couple. |
| Intervalle de lecture (s) | number | Non | Fréquence de lecture de la position de chaque Slide (10 à 3600 s). Après une commande, le Slide est aussi lu quelques fois pendant que le rideau bouge. |
| Autoriser le calibrage | boolean | Non | Désactivé par défaut. Activé, le bouton « Calibrer » de chaque Slide lance son calibrage : le rideau va d'un bout à l'autre pour réapprendre sa course. Rarement utile (après avoir déplacé le Slide sur son rail). |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des Slides ajoutés désormais. |
Comment installer Slide curtains dans Gladys
- Dans Gladys, ouvrez Intégrations : Slide curtains apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-slide:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-slide.
Slide curtains nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Slide curtains est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation