Aller au contenu principal

Intégration domotique ISS Overhead, gratuite et open source

Intégration ISS Overhead pour Gladys Assistant

Prédit les passages visibles de l'ISS au-dessus de chez vous et peut déclencher une scène.

Voir sur GitHubToutes les intégrations

Présentation​

Prédit les prochains passages visibles de la Station Spatiale Internationale au-dessus de votre maison, les affiche sur un widget de dashboard, et peut déclencher une scène juste avant qu'un passage commence — parfait pour une automatisation "va voir dehors".

Ce qui est affiché​

Le widget Passages ISS affiche :

  • une photo de la station, et dans combien de temps aura lieu le prochain passage, avec son élévation maximale ;
  • les prochains passages, avec leur heure, leur durée et la direction depuis laquelle l'ISS se lève (à l'heure locale, dans la langue de votre Gladys) ;
  • si l'ISS est visible ce soir, et si les données orbitales utilisées pour le calcul sont à jour.

Un passage n'est affiché comme visible que si l'ISS est au-dessus de l'horizon, que votre maison est dans le noir, et que l'ISS elle-même est encore éclairée par le soleil — les conditions qui en font une "étoile" brillante et rapide dans le ciel du soir ou du petit matin.

Automatisations​

  • Déclencheur « Passage ISS en cours de démarrage » — se déclenche peu avant le début d'un passage visible. Filtrable par direction de lever. Utile pour une notification "regarde le ciel !", ou pour éteindre un éclairage extérieur qui gênerait l'observation.
  • Action « Obtenir le prochain passage ISS » — récupère le prochain passage prédit à la demande, pour une scène qui veut l'annoncer (message vocal, par exemple) plutôt que réagir à son démarrage.

Les deux exposent le passage sous forme de variables. Pour un message, préférez celles prêtes à lire, écrites dans la Langue des scènes de la configuration et à l'heure locale : start_date (ex. « lundi 28 septembre »), start_hour (ex. « 19:49 ») et direction_name (ex. « ouest »). direction (code cardinal, ex. « W ») reste disponible pour les scènes qui le comparent. Par exemple « L'ISS passe start_date à start_hour, direction direction_name. » donne « L'ISS passe lundi 28 septembre à 19:49, direction ouest. », aussi bien pour une notification que pour un message vocal.

Prérequis​

  • Gladys 5.2 ou supérieur. Le choix de la maison dans la configuration nécessite Gladys 5.2 (le widget de dashboard et le déclencheur/action de scène sont livrés avec Gladys 5.1) ; sur une version antérieure, l'intégration ne peut pas être installée.
  • Une maison localisée dans Gladys (paramètres de la maison, carte) : les passages sont calculés pour ses coordonnées.
  • Un accès à internet depuis le serveur Gladys, pour télécharger les données orbitales sur Celestrak.

Aucune clé API nécessaire​

Les données orbitales (TLE) sont récupérées sur Celestrak, une source publique gratuite — rien à créer comme compte.

Configuration​

CléDéfautDescription
Maison(vide)Maison pour laquelle les passages sont prédits (voir ci-dessous).
Élévation minimale10°Les passages ne dépassant jamais cette élévation sont ignorés.
Fenêtre de prédiction5 joursSur combien de jours prédire les passages (3, 5 ou 7).
Anticipation des scènes5 minutesCombien de temps avant un passage le déclencheur « Passage ISS en cours de démarrage » part (≤ 60).
Langue des scènesFrançaisLangue de la date, de l'heure et de la direction transmises aux scènes.

L'intégration a besoin de la localisation de votre maison, accordée automatiquement à l'installation (aucune adresse à saisir).

Si vous avez plusieurs maisons dans Gladys, choisissez dans Maison celle depuis laquelle observer le ciel. Laissé vide, ou si la maison choisie est supprimée ou n'a plus de localisation, la première maison (par ordre alphabétique) qui a une localisation est utilisée. Vérifiez que la maison est bien localisée dans Gladys (paramètres de la maison, carte) : une maison sans localisation ne peut pas être utilisée.

Dépannage​

  • Statut « L'initialisation a échoué, consultez les logs de l'intégration. » : l'intégration n'a pas pu lire la localisation de votre maison ou télécharger les données orbitales. Elle réessaie d'elle-même, en attendant un peu plus à chaque fois (jusqu'à 30 minutes). Ouvrez l'onglet Logs de l'intégration pour en connaître la cause :
    • No house with a known location : aucune maison n'est localisée dans Gladys. Placez votre maison sur la carte dans ses paramètres.
    • Celestrak request failed with status …, ou un délai dépassé : Celestrak n'a pas pu être joint. Vérifiez l'accès à internet du serveur Gladys.
  • Le widget n'affiche que « Visible bientôt : Non » : aucun passage visible n'a été trouvé dans la fenêtre de prédiction. L'ISS n'est visible que dans les conditions décrites plus haut : plusieurs jours d'affilée sans passage visible, c'est normal. Vous pouvez baisser l'Élévation minimale ou élargir la Fenêtre de prédiction à 7 jours. Le widget a aussi cet aspect tant que l'intégration n'a pas encore de localisation ou de données orbitales (voir le point précédent).
  • « Données orbitales : Périmé » sur le widget : les données orbitales ont plus de 24 heures, car Celestrak n'a pas pu être joint. L'intégration continue de calculer les passages avec les dernières données obtenues et réessaie toutes les 6 heures. Si cela dure, vérifiez l'accès à internet du serveur Gladys.
  • Les passages sont calculés pour la mauvaise maison : la maison choisie dans Maison n'existe plus ou n'est plus localisée. Les logs indiquent alors The chosen house "…" is unknown or has no location, using "…" instead. Choisissez une maison localisée dans Maison, ou placez celle choisie sur la carte.
  • La maison a été déplacée, mais les passages n'ont pas changé : la localisation est lue au démarrage de l'intégration et à chaque enregistrement de sa configuration. Enregistrez de nouveau la configuration.
  • Le déclencheur « Passage ISS en cours de démarrage » ne s'est pas déclenché : il ne part que pour les passages visibles qui dépassent l'Élévation minimale et, si des directions sont cochées dans son filtre, uniquement pour celles-ci. Un passage dont l'heure de déclenchement (début moins l'Anticipation des scènes) est déjà dépassée au démarrage de l'intégration ou à l'enregistrement de la configuration est ignoré.
  • « Obtenir le prochain passage ISS » renvoie des variables vides : aucun passage visible n'est prévu dans la fenêtre de prédiction. La variable Un passage a été trouvé vaut alors faux : testez-la dans votre scène avant d'utiliser les autres.

Paramètres de configuration​

Voici les paramètres demandés par ISS Overhead dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
MaisonselectNonMaison pour laquelle les passages sont prédits. Laissé vide, la première maison localisée est utilisée.
Élévation minimale (°)numberNonLes passages ne dépassant pas cette élévation sont ignorés.
Fenêtre de prédictionselectNonNombre de jours à l'avance pour lesquels prédire les passages.
Anticipation des scènes (minutes)numberNonCombien de temps avant le début d'un passage le déclencheur « Passage ISS en cours de démarrage » se déclenche.
Langue des scènesselectNonLangue de la date, de l'heure et de la direction transmises à vos scènes (notifications, messages vocaux).

Comment installer ISS Overhead dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : ISS Overhead apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/cicoub13/gladys-iss:0.5.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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/cicoub13/gladys-iss.

ISS Overhead nécessite Gladys >=5.2.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​

ISS Overhead 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 cicoub13, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le