STAR Rennes Smart-Home-Integration, kostenlos und Open Source
Busse und Metro in Rennes (STAR): Echtzeit-Abfahrten, Verkehrslage, Aufzüge.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Überblick
Diese Integration bringt STAR, das Bus- und Metronetz von Rennes Métropole, in Gladys: die nächsten Abfahrten in Echtzeit an den Haltestellen deiner Wahl (drei im Formular, bis zu 20 weitere per Schaltfläche), gefiltert nach Linie und Richtung, mit der Verspätung des nächsten Busses; die Verkehrslage von bis zu sechs Linien, Bus oder Metro (normal, leichte, erhebliche oder blockierende Störung, Metro gestört, mit den Meldungen von STAR); und den Zustand der Metro: ihre beiden Linien, geschlossene Stationen sowie Aufzüge und Rolltreppen außer Betrieb. Jede Haltestelle und jede Linie wird zu einem Gerät, das du auf einem Dashboard anzeigen und in Szenen verwenden kannst.
Die Daten stammen aus dem offiziellen Open-Data-Portal von STAR (Keolis Rennes, für Rennes Métropole) unter der ODbL-Lizenz: kein Konto, kein Schlüssel. Die Haltestellen werden standardmäßig jede Minute gelesen (alle 10 Minuten, solange eine Haltestelle nichts ankündigt, nachts), Verkehrslage und Metro alle 5 Minuten. Linien und Haltestellen des Netzes behält die Integration und liest sie einmal täglich bzw. wöchentlich neu.
Es ist eine Cloud-Integration: Sie kontaktiert data.explore.star.fr. Sonst verlässt nichts dein Netzwerk.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Sonst nichts: Die Open Data von STAR brauchen weder Konto noch Schlüssel.
Konfiguration
| Feld | Was eintragen |
|---|---|
| Haltestelle 1, 2, 3 | Der Name der Haltestelle („République“, „Gares“) für alle Straßenseiten und die Metrostation, oder eine Kennung („1242“) für eine Seite oder einen Bahnsteig. |
| Linie | Nur diese Linie: „C1“, „11“, „a“ oder „b“ für die Metro. Leer: alle Linien der Haltestelle. |
| Richtung | Nur Ziele, die diese Wörter enthalten: „Chantepie“, „Poterie | Gaîté“. Leer: beide Richtungen. |
| Verfolgte Linien | Die Linien, deren Verkehrslage du verfolgst, bis zu sechs: „a, b, C1, 11“. |
| Abfrage der Haltestellen | Alle 30 Sekunden, jede Minute, alle 2 Minuten oder alle 5 Minuten. |
| Sprache der Texte | Gerätenamen, Szenen-Zusammenfassungen und -Ausgaben. Haltestellennamen und die Meldungen von STAR bleiben auf Französisch. |
Die Schaltfläche Haltestelle suchen liefert die genauen Namen der Haltestellen, die einige Wörter enthalten, mit der Kennung jeder Straßenseite und jedes Metro-Bahnsteigs sowie den dort angekündigten Linien und Zielen („1242 → 11 La Poterie, C1 Chantepie“): Kopiere die Kennung der Seite, an der du einsteigst. Verbindung testen liest das Netz, sofort jede Haltestelle und Linie, und die heute verbleibenden Abrufe.
Mehr Haltestellen als die drei des Formulars (Zuhause, Arbeit…): Haltestelle hinzufügen nimmt dieselben drei Felder — Haltestelle, Linie, Richtung — und verfolgt bis zu 20 weitere Haltestellen. Haltestellen auflisten zeigt alle verfolgten Haltestellen nummeriert an; Haltestelle entfernen nimmt diese Nummer (oder den Namen). Die hinzugefügten Haltestellen werden in der Gladys-Konfiguration gespeichert und sind damit in deren Backups enthalten.
Ohne Schlüssel erlaubt das Portal eine bestimmte Zahl von Abrufen pro Tag und Internetadresse (20.000, als diese Integration geschrieben wurde). Bei vielen Haltestellen liest die Integration sie seltener, um deutlich darunter zu bleiben, und weist in ihrem Status darauf hin.
Verwendung
Geräte
Erstelle im Tab Entdecken die gewünschten Geräte:
- STAR <Haltestelle>: die nächste Abfahrt als Text („C1 → Chantepie · 6 Min. (+1 Min. Verspätung)“), die Wartezeit der nächsten und der folgenden Abfahrt sowie die Verspätung des nächsten Busses gegenüber seinem Fahrplan (Minuten);
- STAR Linie <Linie> oder STAR Metro <Linie>: die Verkehrslage als Text („Erhebliche Störung: Travaux“) und die Zahl der aktuellen erheblichen oder blockierenden Störungen.
Ist ein Bus noch nicht geortet, liefert STAR seine Fahrplanzeit: Die Integration weist darauf hin („Fahrplanzeit“). Nachts, ohne jede Abfahrt, behalten die Wartezeiten ihren letzten Wert.
Dashboard-Widgets
- STAR-Abfahrten: die nächsten Abfahrten einer Haltestelle, kompakt: eine Zeile pro Linie und Ziel mit den nächsten Abfahrten hintereinander („1 · 9 · 27 Min.“, „10:32“), Fahrplanzeiten in Grau. Die Einstellung Angezeigte Fahrten legt die Zahl der Zeilen fest. Wähle eine verfolgte Haltestelle oder gib in den Widget-Einstellungen eine beliebige Haltestelle (und eine Linie) ein. Mit Mehrere Haltestellen zeigt ein Widget mehrere Haltestellen-Geräte: Die Geräte einer Haltestelle werden unter ihrem Namen zusammengefasst; bei verschiedenen Haltestellen beginnt jede Zeile mit ihrer Haltestelle.
- STAR-Verkehrslage: der Zustand jeder Linie, dann die Meldungen von STAR mit ihren Daten; tippe auf eine Karte für den vollständigen Text und den Link zu star.fr. Die verfolgten Linien oder die in den Einstellungen eingegebenen.
- STAR-Metro: die Linien a und b (in Betrieb oder gestört, mit der erwarteten Wiederaufnahme), die geschlossenen Stationen, dann die Aufzüge und Rolltreppen außer Betrieb, Station für Station. Mit der Einstellung Angezeigte Anlagen behältst du zum Beispiel nur die Aufzüge.
Szenen
Auslöser, einmal pro Änderung (die erste Abfrage dient nur als Referenz):
- STAR: Bus oder Metro gleich: Eine Abfahrt an einer verfolgten Haltestelle erfolgt in 2, 3, 5, 10, 15 oder 20 Minuten.
- STAR: Linie gestört: Eine verfolgte Linie erhält eine aktuelle erhebliche oder blockierende Meldung, oder ihre Metro fällt aus.
- STAR: Linie wieder normal: Sie fährt wieder normal.
- STAR: neue Verkehrsmeldung: STAR veröffentlicht eine Meldung zu einer verfolgten Linie (geplant oder aktuell).
- STAR: Metro-Aufzug außer Betrieb und STAR: Metro-Aufzug wieder in Betrieb: ein Aufzug oder eine Rolltreppe einer Metrostation (oder ihres P+R-Parkplatzes), filterbar nach Station und Art. Dafür muss keine Linie verfolgt werden.
Jeder liefert einen fertigen Satz, {{triggerEvent.data.summary}}, und seine Werte (Linie, Ziel, Uhrzeit, Verspätung, Titel, Station…). Die Aktionen STAR: nächste Abfahrten und STAR: Verkehrslage einer Linie geben dieselbe Art von Werten zurück, um sie in eine Nachricht zu setzen oder in einer Bedingung zu prüfen.
Beispiele:
- Wenn die C1 Richtung Chantepie in 5 Minuten an République abfährt → die Lampe im Flur grün einschalten.
- Wenn der Aufzug deiner Metrostation ausfällt → die Zusammenfassung vor dem Losgehen an dein Handy senden.
- Jeden Werktag um 7:30 Uhr → die nächsten Abfahrten deiner Haltestelle lesen und vom Lautsprecher in der Küche ansagen lassen.
Transport
Nur Cloud: Die Daten kommen aus dem Internet. Nur die Haltestellen und Linien, die du verfolgst, werden beim Portal von STAR abgefragt.
Fehlerbehebung
- „Bei STAR unbekannt“: Nutze Haltestelle suchen und kopiere dann den genauen Namen oder eine Kennung; bei einer Linie ihren Namen wie auf den Bussen („C1“, „11“), „a“ oder „b“ für die Metro.
- Nachts keine Abfahrt: Das Netz schläft; die Haltestelle wird alle 10 Minuten gelesen, bis die erste Abfahrt angekündigt wird.
- „Tageskontingent des Open-Data-Portals von STAR für diese Adresse erreicht“: zu viele Abrufe heute von deiner Internetadresse (andere Software kann sie mitnutzen); die Abfragen laufen nach Mitternacht (UTC) weiter. Verfolge weniger Haltestellen oder lies sie seltener.
- „Das Open-Data-Portal von STAR antwortet nicht“: Die Integration versucht es bei jeder Abfrage erneut; die letzten Abfahrten bleiben auf den Widgets.
- Ein Problem melden: Drücke Diagnose und kopiere die Zeilen, die mit „STAR diagnostic“ beginnen, aus dem Tab Protokolle in ein Issue auf GitHub oder eine Antwort im Forum, mit den Versionen von Gladys und der Integration.
Konfigurationseinstellungen
Diese Einstellungen fragt STAR Rennes in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| STAR Open Data | section | Nein | Die Abfahrten, die Verkehrslage und der Zustand der Metro stammen aus dem offiziellen Open-Data-Portal von STAR, dem Bus- und Metronetz von Rennes Métropole (Keolis Rennes). Kein Konto und kein Schlüssel: Trage unten deine Haltestellen und Linien ein und drücke dann „Verbindung testen“. |
| Haltestelle 1 | section | Nein | Die Haltestelle, an der du Bus oder Metro nimmst: Ihre Abfahrten werden in Echtzeit gelesen. Gib ihren Namen („République“) für alle Straßenseiten und die Metrostation ein oder eine Kennung („1242“) für nur eine Seite: Die Schaltfläche „Haltestelle suchen“ liefert sie. Die Linie behält nur ihre Abfahrten („C1“, „11“, „a“ oder „b“ für die Metro). Die Richtung behält nur die Ziele mit diesen Wörtern („Chantepie“, „Poterie | Gaîté“). |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Haltestelle 2 | section | Nein | |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Haltestelle 3 | section | Nein | Weitere Haltestellen (Zuhause, Arbeit…): Die Schaltfläche „Haltestelle hinzufügen“ unter dem Formular verfolgt bis zu 20 weitere, „Haltestellen auflisten“ zeigt alle nummeriert, und „Haltestelle entfernen“ beendet die Verfolgung einer Haltestelle. |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Verkehrslage der Linien | section | Nein | Die Linien, deren Verkehrslage du verfolgst, Bus oder Metro: ein Gerät pro Linie, mit ihrem Zustand (normal, leichte, erhebliche oder blockierende Störung, Metro gestört) und den Meldungen von STAR, alle 5 Minuten gelesen. |
| Verfolgte Linien | string | Nein | Bis zu 6, durch Kommas getrennt. |
| Optionen | section | Nein | |
| Abfrage der Haltestellen | select | Nein | Wie oft die Abfahrten der Haltestellen gelesen werden. Eine Haltestelle ohne Ankündigung (nachts) wird alle 10 Minuten gelesen. Bei vielen Haltestellen wird das Intervall verlängert, um im Tageskontingent des Portals zu bleiben. |
| Sprache der Texte | select | Nein | Gerätenamen, Szenen-Zusammenfassungen und -Ausgaben. Automatisch: die Sprache deines Dashboards, sobald ein STAR-Widget angezeigt wurde. Haltestellennamen und Verkehrsmeldungen bleiben auf Französisch. |
So installierst du STAR Rennes in Gladys
- Öffne in Gladys Integrationen: STAR Rennes erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-star-rennes:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-star-rennes.
STAR Rennes benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
STAR Rennes ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation