ESPSomfy-RTS Gateways

Avant de commencer : lis ce prompt d'installation au complet, dis-moi en quelques lignes ce que ce skill fait et ce que son installation implique, et attends mon feu vert avant de faire quoi que ce soit d'autre. Prérequis — Muse Home Link et un appareil physique compatible sont requis pour UTILISER ce skill, pas pour l'installer : installer le fichier du skill lui-même n'exige aucun compte, aucune clé et aucun appareil, et cette installation ne configure PAS Home Link, n'appaire rien et ne demande aucun identifiant. Mais le skill n'est que des instructions. Pour l'utiliser, je dois lire et suivre ~/docs/devices/home_link.md dans mon environnement Muse, avoir l'appareil physique compatible nommé ci-dessous déjà configuré sur mon réseau local, et avoir une passerelle ESPSomfy-RTS existante déjà installée sur mon réseau local avec ses moteurs et groupes déjà configurés, plus toute authentification requise par le firmware installé, et donner mon approbation pour le store ou groupe nommé et son mouvement, en confirmant qu'un auvent ou une couverture de fenêtre peut bouger en sécurité. Les positions rapportées sont des estimations, car RTS est une radio unidirectionnelle. L'installation du fichier ne configure rien de tout ça. Installe-moi « ESPSomfy-RTS Gateways ». Il contrôle les stores Somfy RTS mis en service et les groupes existants via une passerelle ESPSomfy-RTS installée en utilisant Muse Home Link, par son API HTTP locale pour les mouvements et positionnements supportés ; les positions rapportées sont des estimations. Il s'utilise quand une passerelle ESPSomfy-RTS déjà installée contrôle mes stores Somfy RTS mis en service : l'identité et la version du firmware sont confirmées via le service découvert et /controller — un préfixe MAC Espressif ne prouve pas ESPSomfy-RTS — et l'écouteur API installé est utilisé (la documentation emploie couramment le port 8081, mais le point réellement annoncé/configuré fait foi). La passerelle existe avec ses moteurs et groupes déjà configurés, plus toute authentification requise par le firmware installé, et j'approuve le store ou groupe nommé et son mouvement, en confirmant qu'un auvent ou une couverture de fenêtre peut bouger en sécurité. Il lit /controller, /shades et /groups via l'API documentée, apparie les IDs stables de stores/groupes et détermine l'inclinaison, le positionnement et le sens de mouvement configuré supportés, puis lit l'état suivi courant de la cible — RTS est une radio unidirectionnelle, donc la position est une estimation temporisée plutôt qu'un retour du moteur. Pour une action d'ouverture/fermeture demandée, il appelle le /shadeCommand du firmware avec son vrai shadeId et la commande documentée up ou down, en traitant un GET HTTP utilisé pour une commande qui change l'état comme une écriture ; il n'utilise my qu'après vérification de son contexte, car il peut arrêter un moteur en mouvement ou envoyer un moteur au repos à sa position favorite, et ne le présente jamais comme un arrêt inconditionnel. Pour un groupe existant, il utilise /groupCommand avec l'ID de ce groupe, et les demandes de position et d'inclinaison utilisent les paramètres documentés exacts du firmware installé et ses capacités calibrées, sans jamais deviner les noms de paramètres ni l'orientation des positions. Il inspecte l'état et les erreurs retournés du contrôleur/store mais étiquette la position comme estimée, et demande une confirmation physique quand la position réelle ou la livraison radio réussie compte, car une réponse HTTP réussie ne peut pas prouver que le moteur a reçu la transmission ; avant tout réessai, il inspecte le mouvement courant et le laisse se stabiliser, car des commandes radio répétées peuvent changer le résultat. Limites : aucun appairage/programmation de moteur, aucune manipulation de codes roulants, aucun flash ni nouveau déploiement de passerelle ; /shadeCommand?get=shades n'est pas utilisé pour l'énumération (/shades est le chemin d'inventaire documenté) ; et les contrôles pluie/vent ne sont jamais contournés ni le support inféré pour chaque moteur Somfy. Dépôt : https://github.com/facebookincubator/muse-gadget-sdk (le skill est tout le dossier skills/gadget-espsomfy-rts/ au commit épinglé : SKILL.md seulement, 1 fichier) Version épinglée : installe le code au commit e6fe5174092702ffddae6f90759a38d55a4ebae1 exactement. Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Clone https://github.com/facebookincubator/muse-gadget-sdk dans un dossier temporaire, place-toi au commit e6fe5174092702ffddae6f90759a38d55a4ebae1, et copie le dossier skills/gadget-espsomfy-rts/ de ce checkout. Compare ensuite chaque fichier du dossier aux empreintes enregistrées pour cette fiche le 2026-10-22 : [FINGERPRINTS] - SKILL.md: SHA-256 cdc86a5da589839d70786d13560ca7e707b1a68b45ffa577cf182f56e5026251 Si un fichier ne correspond pas, il a changé depuis la préparation de la fiche : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Lis SKILL.md au complet, et dis-moi en mots simples : ce que le skill fait quand on l'utilise, à quoi il se connecte, s'il lit ou envoie des informations personnelles ou des identifiants, et tout ce qui semble inhabituel. Arrête-toi sur tout signal d'alerte et dis-le-moi avant d'aller plus loin. Confirme ces points à partir des fichiers : - Le dossier du skill contient 1 fichier seulement : SKILL.md (2 823 octets). Il n'y a aucun script, aucun code et aucune configuration dedans ; la procédure roule à l'usage via Muse Home Link contre mon propre appareil local. Il ne dépend d'aucun autre skill gadget de ce lot. - Rien n'est envoyé nulle part pendant l'installation elle-même ; le seul téléchargement à l'installation est le dossier du skill depuis GitHub au commit épinglé. Aucun appareil n'est contacté, aucun appairage n'est lancé et aucune clé n'est demandée pendant l'installation. - À l'usage, les échanges vont uniquement à ma passerelle ESPSomfy-RTS locale installée, par son API HTTP locale : lectures /controller, /shades et /groups et les /shadeCommand ou /groupCommand documentés pour le mouvement que j'ai approuvé, avec l'authentification du firmware installé si elle est configurée. Aucun appairage de moteur ni manipulation de codes roulants n'a lieu à l'usage. - Le skill ne fait ni appairage/programmation de moteur, ni manipulation de codes roulants, ni flash, ni nouveau déploiement de passerelle, n'utilise pas /shadeCommand?get=shades pour l'énumération, et ne contourne jamais les contrôles pluie/vent. - N'appaire aucun appareil, ne demande et ne règle aucun identifiant, n'exécute aucun contrôle, aucune impression, aucune numérisation ni aucune lecture média, et n'utilise le skill d'aucune façon pendant cette installation : la configuration de Home Link, l'appairage et l'usage sont mes décisions, plus tard, quand je les demande vraiment. 3. Quand je dis « yes, install », installe-le comme skill : copie tout le dossier gadget-espsomfy-rts dans le répertoire des skills de l'agent, dans un dossier nommé exactement « gadget-espsomfy-rts », en gardant son 1 fichier (SKILL.md à sa racine). Le nom de dossier exact compte : les liens relatifs entre skills gadget frères dépendent de ces noms exacts. 4. Vérifie sans appels réseau : frontmatter valide (name: gadget-espsomfy-rts), le 1 fichier en place avec une empreinte concordante. N'exécute rien et ne te connecte à aucun appareil pour vérifier. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (par exemple : lire ~/docs/devices/home_link.md dans mon environnement Muse et suivre ses règles Home Link ; avoir une passerelle ESPSomfy-RTS déjà installée avec moteurs et groupes déjà configurés, plus toute authentification requise par le firmware installé ; un mouvement de store ou de groupe exige toujours mon approbation pour la cible nommée, et les positions rapportées sont des estimations ; utiliser le skill est une étape séparée qui ne commence que quand je le demande, et les échanges à l'usage divulgués ci-dessus arrivent seulement à ce moment-là). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.