Intégration domotique CTS Strasbourg, gratuite et open source
Trams et bus de Strasbourg (CTS) : passages en temps réel, trafic et infos des lignes.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration amène dans Gladys les trams et bus de Strasbourg (CTS, Compagnie des Transports Strasbourgeois). Elle donne les prochains passages en temps réel aux arrêts que vous choisissez (trois dans le formulaire, jusqu’à 7 de plus avec un bouton), filtrés par ligne et direction, et le trafic des lignes que vous suivez : trafic normal, perturbé, très perturbé, avec les infos trafic de la CTS (perturbations, travaux, informations). Chaque arrêt et chaque ligne devient un appareil à afficher sur un tableau de bord et à utiliser dans les scènes.
Les données viennent de l’API temps réel officielle de la CTS (SIRI-lite), sous Licence Ouverte 2.0. Elle demande un jeton personnel, gratuit : la CTS ouvre l’accès à son portail open data sur demande. Les noms et codes des arrêts et des lignes viennent des horaires ouverts de la CTS (GTFS), lus une fois par semaine : chercher un arrêt ne consomme aucune requête.
Chaque arrêt suivi est une requête par lecture, toutes les minutes par défaut ; le trafic est lu toutes les 5 minutes. L’intégration garde chaque réponse aussi longtemps que l’API la dit valable, et se met en pause 5 minutes si l’API demande de ralentir. La nuit, tant qu’aucun arrêt n’annonce rien dans les 45 minutes, les arrêts sont lus toutes les 10 minutes.
Un passage est suivi en temps réel quand la CTS sait où est le véhicule ; sinon c’est l’horaire théorique, signalé « (théorique) » (une étoile dans le widget). L’API ne donne ni retard ni course supprimée : l’intégration n’en invente jamais.
C’est une intégration cloud : elle contacte api.cts-strasbourg.eu (avec votre jeton et les codes de vos arrêts) et opendata.cts-strasbourg.eu (les horaires ouverts). Rien d’autre ne quitte votre réseau.
L’intégration a été écrite d’après la description publiée de l’API (swagger.json) ; elle n’a pas encore été testée avec un vrai jeton. Vos retours sont les bienvenus.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Un jeton personnel de l’API de la CTS : demandez l’accès au portail open data par e-mail à
[email protected], avec quelques mots sur votre usage (par exemple « domotique Gladys Assistant »), puis copiez le jeton affiché dans votre compte open data.
Configuration
| Champ | Que saisir |
|---|---|
| Jeton | Le jeton de votre compte open data de la CTS. Enregistré comme secret, jamais écrit dans les journaux. |
| Arrêt 1, 2, 3 | Le nom de l’arrêt (« Homme de Fer », « Gare Centrale ») ou son code : « 275 » pour tout l’arrêt, « 275A » pour un quai. |
| Ligne | Seulement cette ligne : « A », « C1 », « 2 », ou un mode seul : « tram », « bus ». Vide : toutes les lignes. |
| Direction | Seulement les destinations qui contiennent ces mots : « Illkirch », « Illkirch | Lixenbuhl ». Vide : les deux sens. |
| Lignes suivies | Les lignes dont vous suivez le trafic, séparées par des virgules : « A, C, 2, C1 » (jusqu’à 10). Un appareil par ligne. |
| Lecture des arrêts | Toutes les 30 secondes, toutes les minutes (par défaut), toutes les 2 minutes ou toutes les 5 minutes. |
| Langue des textes | Noms des appareils, résumés et sorties des scènes, et langue des infos trafic (français, anglais, allemand). |
Le bouton Chercher un arrêt donne les arrêts contenant quelques mots, avec leurs codes : « Homme de Fer [275] (275A, 275B, 275C, 275D) ». Le nombre désigne tout l’arrêt, dans tous les sens ; avec sa lettre, un seul quai. Tester la connexion lit les arrêts et lignes de la CTS, chaque arrêt suivi et le trafic tout de suite, et dit ce qui a répondu.
Plus d’arrêts que les trois du formulaire (maison, travail, école…) : Ajouter un arrêt prend les trois mêmes champs — arrêt, ligne, direction — et suit jusqu’à 7 arrêts de plus. Lister les arrêts montre tous les arrêts suivis, numérotés ; Retirer un arrêt prend ce numéro (ou le nom). Les arrêts ajoutés sont gardés dans la configuration de Gladys et suivent donc ses sauvegardes.
Utilisation
Appareils
Dans l’onglet Découvrir, créez les appareils voulus :
- CTS <arrêt> : le prochain passage en texte (« A → Illkirch Graffenstaden · 3 min »), l’attente du prochain passage et du suivant (minutes), et le nombre d’infos trafic en cours sur les lignes de l’arrêt (celles de tout le réseau comprises). La nuit, sans passage, les attentes gardent leur dernière valeur.
- CTS tram A, CTS ligne 2 : le trafic de la ligne en texte (« Perturbé : Tram C : accident à Esplanade ») et son nombre d’infos trafic en cours.
Trafic des lignes
L’état d’une ligne est son message en cours le plus grave : une perturbation la rend perturbée (très perturbée quand la CTS la marque urgente), une perturbation prévue perturbée, des travaux perturbée ou très perturbée quand ils dévient ou interrompent la ligne, une information laisse le trafic normal. Un message sur tout le réseau compte pour chaque ligne. Les textes de la CTS existent en français, anglais et allemand.
Widgets du tableau de bord
- Départs : les prochains passages d’un arrêt, en compact. Une rangée par ligne et destination, avec ses prochains passages à la suite (« 3 · 9 min ») ; une étoile signale un horaire théorique. Le réglage Trajets affichés fixe le nombre de rangées. Choisissez un arrêt suivi, ou saisissez n’importe quel arrêt (et une ligne) dans les réglages du widget : un tel arrêt coûte une requête de plus à chaque rafraîchissement, toutes les minutes au plus. Avec Plusieurs arrêts, un seul widget montre plusieurs appareils arrêts.
- Trafic CTS : l’état des lignes suivies (ou des lignes saisies dans les réglages, ou les lignes de tram si aucune n’est suivie), puis leurs messages en cours et à venir. Touchez une carte pour le texte complet.
Scènes
Déclencheurs, une fois par changement (la première lecture sert seulement de référence) :
- CTS : départ bientôt : un tram ou un bus à un arrêt suivi part dans 2, 3, 5, 10, 15 ou 20 minutes.
- CTS : ligne perturbée : une ligne suivie devient perturbée ou très perturbée.
- CTS : fin de perturbation : une ligne suivie qui était perturbée revient à la normale.
- CTS : nouveau message trafic : un nouveau message sur une ligne suivie, les lignes d’un arrêt suivi ou tout le réseau ; filtres par type (perturbation, perturbation prévue, travaux, information) et priorité. Une mise à jour se déclenche à nouveau quand la CTS demande de la notifier.
Chacun donne une phrase toute prête, {{triggerEvent.data.summary}}, et ses valeurs (ligne, destination, heure, titre, texte, période…). Les actions CTS : prochains départs et CTS : trafic d’une ligne renvoient le même genre de valeurs, à mettre dans un message ou à tester dans une condition.
Exemples :
- Quand le tram A vers Illkirch part d’Homme de Fer dans 5 minutes → allumer la lampe de l’entrée en vert.
- Quand le tram C devient perturbé → envoyer le résumé sur votre téléphone avant de partir.
- Chaque jour de semaine à 7 h 30 → lire les prochains passages de votre arrêt et les faire annoncer par l’enceinte de la cuisine.
Transport
Cloud uniquement : les données viennent d’internet. Seuls les arrêts que vous suivez sont demandés à l’API, un par un, et le trafic du réseau toutes les 5 minutes.
Dépannage
- « Saisissez le jeton » : le jeton manque ; demandez l’accès à
[email protected]et collez le jeton de votre compte open data dans la configuration. - « L’API de la CTS refuse le jeton » : vérifiez-le (pas d’espace avant ou après) ; l’intégration ne redemande rien tant que la configuration n’est pas enregistrée.
- « L’API de la CTS demande de ralentir » : l’API a répondu 429 ; les lectures reprennent après 5 minutes. Suivez moins d’arrêts ou choisissez un intervalle plus long.
- « Inconnu ou ambigu » : utilisez Chercher un arrêt, puis copiez le nom exact ou un code.
- « (théorique) » après un passage : la CTS ne suit pas ce véhicule en temps réel ; l’heure est celle des horaires.
- Aucun passage : la nuit, le réseau dort ; les arrêts sont lus toutes les 10 minutes.
- Pour signaler un problème : appuyez sur Diagnostic, puis copiez les lignes commençant par « CTS diagnostic » de l’onglet Journaux (le jeton n’y figure pas) dans une issue GitHub ou une réponse sur le forum, avec les versions de Gladys et de l’intégration.
Paramètres de configuration
Voici les paramètres demandés par CTS Strasbourg dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Jeton de l’API de la CTS | section | Non | Les passages et le trafic viennent de l’API temps réel officielle de la CTS (Compagnie des Transports Strasbourgeois) : trams et bus de Strasbourg et de l’Eurométropole, en temps réel. L’API demande un jeton personnel, gratuit : demandez l’accès au portail open data de la CTS par e-mail à [email protected] (quelques mots sur votre usage, par exemple « domotique Gladys Assistant »), puis copiez le jeton affiché dans votre compte open data. Les noms des arrêts et des lignes viennent des horaires ouverts de la CTS (GTFS) et ne consomment aucune requête. |
| Jeton | secret | Oui | Le jeton de votre compte open data de la CTS. |
| Arrêt 1 | section | Non | L’arrêt où vous prenez le tram ou le bus : ses prochains passages sont lus en temps réel. Saisissez son nom (« Homme de Fer », « Gare Centrale ») ou son code (« 275 » pour tout l’arrêt, « 275A » pour un seul quai) : le bouton « Chercher un arrêt » les donne. La ligne ne garde que ses passages (« A », « C1 », « 2 », ou « tram » pour tous les trams). La direction ne garde que les destinations qui contiennent ces mots (« Illkirch », « Illkirch | Lixenbuhl »). |
| Arrêt | string | Non | |
| Ligne | string | Non | Vide pour toutes les lignes. |
| Direction | string | Non | Des mots de la destination. Vide pour les deux sens. |
| Arrêt 2 | section | Non | |
| Arrêt | string | Non | |
| Ligne | string | Non | Vide pour toutes les lignes. |
| Direction | string | Non | Des mots de la destination. Vide pour les deux sens. |
| Arrêt 3 | section | Non | D’autres arrêts (maison, travail, école…) : le bouton « Ajouter un arrêt », sous le formulaire, en suit jusqu’à 7 de plus, « Lister les arrêts » les montre tous, numérotés, et « Retirer un arrêt » arrête d’en suivre un. Chaque arrêt est une requête à chaque lecture. |
| Arrêt | string | Non | |
| Ligne | string | Non | Vide pour toutes les lignes. |
| Direction | string | Non | Des mots de la destination. Vide pour les deux sens. |
| Trafic des lignes | section | Non | Les lignes dont vous suivez le trafic : un appareil par ligne, avec son état (trafic normal, information, perturbé, très perturbé) déduit des infos trafic de la CTS (perturbations, perturbations prévues, travaux, informations), lues toutes les 5 minutes. Un message sur tout le réseau compte pour chaque ligne. |
| Lignes suivies | string | Non | Jusqu’à 10, séparées par des virgules. |
| Options | section | Non | |
| Lecture des arrêts | select | Non | La fréquence de lecture des passages des arrêts : une requête par arrêt suivi. Tant qu’aucun arrêt n’annonce rien dans les 45 minutes (la nuit), toutes les 10 minutes. Le trafic est lu toutes les 5 minutes. |
| Langue des textes | select | Non | Noms des appareils, résumés et sorties des scènes, et langue des infos trafic de la CTS (français, anglais ou allemand ; français pour l’espagnol). Automatique : la langue de votre tableau de bord, dès qu’un widget CTS a été affiché. Les noms d’arrêts restent tels que la CTS les écrit. |
Comment installer CTS Strasbourg dans Gladys
- Dans Gladys, ouvrez Intégrations : CTS Strasbourg 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/william-de71/gladys-cts-strasbourg:0.1.0), 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/William-De71/gladys-cts-strasbourg.
CTS Strasbourg nécessite Gladys >=5.3.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
CTS Strasbourg 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 William-De71, 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