Aller au contenu principal

Intégration domotique Transitous Departures, gratuite et open source

Intégration Transitous Departures pour Gladys Assistant

Départs des transports publics à proximité sur le tableau de bord Gladys, grâce à Transitous.

Voir sur GitHubToutes les intégrations

Ceci est la documentation utilisateur de l'intégration. Gladys ré-héberge ce fichier et affiche un lien Documentation permanent vers lui dans l'écran de configuration (dans la langue de l'utilisateur, avec l'anglais en repli) — c'est au moment de configurer que l'utilisateur en a le plus besoin. Gardez les courtes indications d'accueil dans les blocs section du config_schema du manifest ; mettez ici le pas-à-pas détaillé (captures d'écran, dépannage…).

Ce que vous obtenez​

Six appareils de démonstration apparaissent après l'installation : une station météo (vraies données Open-Meteo), un interrupteur, une lampe variable, une prise connectée avec mesure de puissance, un détecteur de mouvement et une caméra.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Renseignez la latitude et la longitude que la station météo de démonstration doit observer (Paris par défaut), et choisissez votre unité de température. L'intervalle de rafraîchissement règle la fréquence de lecture de la station météo et de la puissance de la prise : toutes les 5 minutes par défaut, toutes les minutes au plus.
  3. Enregistrez : les appareils apparaissent dans l'onglet Découverte, prêts à être ajoutés.

Le réglage Préférer la connexion locale pilote la prise de démonstration : elle affiche en badge le canal réellement utilisé (local ou cloud), avec un point orange quand elle fonctionne en mode dégradé (local refusé, bascule cloud).

Actions​

  • Tester le fournisseur météo — effectue une requête en direct vers Open-Meteo et affiche la température et l'humidité actuelles sous le bouton.
  • Identifier un appareil — choisissez un de vos appareils dans la liste et il se signale (la lampe de démonstration « clignote » dans les logs).

Scènes​

L'intégration ajoute ses propres cartes à l'éditeur de scènes (Gladys 5.1 ou plus récent), dans la catégorie Intégrations :

  • Mouvement détecté (déclencheur) — lance la scène quand un détecteur de démonstration voit bouger quelque chose. Choisissez éventuellement le détecteur et ce qui a bougé (personne, animal) ; laissés vides, toute détection correspond. Les actions suivantes peuvent lire ce qui a bougé avec {{triggerEvent.data.target}}.
  • Identifier un appareil (action) — fait se signaler l'appareil choisi. Elle indique si l'appareil a pu se signaler, pour que les actions suivantes puissent en dépendre.

Tableau de bord​

Ajoutez le widget État de la démo à un tableau de bord : il affiche en direct la température de la station météo et la puissance de la prise du bureau, la connexion utilisée par la prise (en orange si dégradée) et la position observée. Son bouton Identifier la lampe fait se signaler la lampe de démonstration.

Dépannage​

L'intégration journalise tout ce qu'elle fait : consultez les logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte) avec LOG_LEVEL=debug pour le détail complet.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Informations de configuration du widgetsectionNonAvant d’ajouter le widget à votre tableau de bord, déterminez les coordonnées du lieu choisi. Vous avez besoin de la latitude et de la longitude au format décimal, par exemple 49.350 et 8.690. Lors de l’ajout du widget, vous pourrez définir le rayon de recherche, le nombre de départs et l’intervalle d’actualisation. Le rayon de recherche par défaut est de 2 000 mètres.

Comment installer Transitous Departures dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Transitous Departures 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/tomgermany/gladys-transitous-departures:1.0.3), 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/tomgermany/gladys-transitous-departures.

Transitous Departures 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​

Transitous Departures 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 tomgermany, 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