UPDATE 31.10.: Amazon Alexa - ioBroker Skill läuft aus ?

[AggroRalf]

Aktuelle Test Version	0.1.12
Veröffentlichungsdatum	29.08.2020
Github Link	https://github.com/gaudes/ioBroker.fahrplan

Adapter ioBroker.Fahrplan 0.1.12

Hallo zusammen,

nachdem ich bisher ein Javascript hatte, welches die mobile Webseite der Deutschen Bahn nach meinem täglichen Zug abfrägt, habe ich nun meinen ersten Adapter gebaut.

Hierzu verwende ich den HAFAS-Client. Dieser frägt das unter anderem von der Deutschen Bahn verwendete Programm HAFAS ab.

Der Adapter beherrscht aktuell Deutsche Bahn und ÖBB.

Der Adapter ist aktuell recht einfach. Man definiert in den Einstellungen die gewünschten Routen mit Optionen. Als Optionen kann man z.B. Zwischenhalte, Anzahl Umstiege, Verkehrsmittel (S-Bahn, Regio, etc.) angeben. Start, Ziel und eventuell Zwischenhalte müssen mit Ihrer e-Bahnhofs-ID angegeben werden. Der Adapter bietet hierfür in den Einstellungen eine Suche.

Als Ergebnis werden Objekte angelegt. Pro Route (erste Ebene) gibt es einen Kanal, darunter dann jeweils drei "Reisen" (zweite Ebene), also Fahrten. Darunter gibt es dann die jeweiligen Reiseabschnitte (dritte Ebene). Zusätzlich gibt es Informationen zu den Start- und Zielbahnhöfen sowie zur jeweiligen Linie.

Hier mal ein Beispiel:

Ihr wollt von A nach C. Das ist die Route. Hierfür werden in HAFAS die nächsten drei Fahrten gesucht, z.B. 12:00 Uhr, 13:00 Uhr und 14:00 Uhr. Das sind die Reisen.
Um 12:00 Uhr müsst Ihr von A nach B mit Linie S1 fahren, dann von B nach C mit Linie RB45. Das sind die Reiseabschnitte.

Es werden diverse Objekte zur jeweiligen Fahrt erzeugt:

Neben den Objekten wird optional eine HTML-Tabelle pro Route erzeugt, in dieser Tabelle werden z.B. Verspätungen farblich markiert. Das Inhalt der Tabelle ist konfigurierbar.
Zusätzlich gibt es optional eine HTML-Tabelle pro Reise mit allen Reiseabschnitten.

Außerdem gibt es nun einen Verspätungsalarm. Zu den eingestellten Routen lassen sich nun Verspätungsalarme für eine geplante Abfahrtszeit oder für alle Verbindungen einstellen.

ALPHA-RELEASE
Es ist das erste Release, quasi eine Alpha-Version. Hafas und die Auskünfte der Bahn sind sehr komplex. Ich kann daher nicht 100%ig sagen, dass ich alle Möglichkeiten (Verspätungen, Zugausfall, etc.) korrekt identifiziere. Daher bin ich hier auf Rückmeldungen angewiesen. Vergleicht bitte das Ergebnis des Adapters z.B. mit der Webseite der Deutschen Bahn. Natürlich kann ich auch nur Informationen anzeigen, die HAFAS auch rausgibt. Wenn eine Information also in den Rückgaben von HAFAS, welche in den JSON-Objekten gespeichert werden, nicht enthalten sind kann ich leider auch nicht viel tun.

Was tun bei Fehlern oder Problemen?
Bei Fehlern sollte zuerst das Log in ioBroker geprüft werden. Ich habe versucht, möglichst treffende Fehlermeldungen inklusive Route, Reise oder Reiseabschnitt mitzugeben.

Bitte lasst die Option "JSON-Elemente speichern" aktiviert. Bei einem Fehler bei einer bestimmten Route, Reise oder Reiseabschnitt sendet bitte immer die aktuellen JSON-Objektinhalte mit.

Dies ist notwendig, da der Fehler wirklich nur für eine bestimmte Reise zu einem bestimmten Zeitpunkt auftreten kann. Sonst kann ich Fehler oft nicht nachvollziehen.

Weiteres
Es ist, wie gesagt, die erste Version meines ersten Adapters. Seit also bitte etwas nachsichtig mit mir, wenn nicht alles auf Anhieb klappt.
Konstruktive Verbesserungsvorschläge nehme ich gerne entgegen, z.B. welche Werte eine erweiterte HTML-Tabelle enthalten sollte.
Zuletzt geht mein Dank noch an ein paar Unterstützer hier im Forum und im Teamspeak: @Dutchman , @J-A-R-V-I-S und @Jey-Cee haben mich hier auf die richtige Spur gebracht.

So, und nun viel Spass beim Testen.

[Kuddel]

@AggroRalf erstmal vielen Dank, dass du diesen Adapter erstellt hast.

Habe ihn mir installiert und werde jetzt testen.

Bei der Eingabe der Routen ist mir aufgefallen, dass die Anzeige ein wenig unvorteilhaft ist, da die Auswahlliste der Verkehrsmittel nicht komplett angezeigt wird, sonder immer nur eine Zeile

Spoiler

Ist es möglich, feste Verbindungen, also mit festen Uhrzeiten einzugeben, sodass Pendler, die immer die gleichen Verbindungen nutzen, automatisch per Adapter über Verspätungen informiert werden ?

[AggroRalf]

@Kuddel : Der Erste, ich danke dir :)

Benutzt du Firefox als Webbrowser ? Da hatte ich das Problem auch. Es ist aber nicht, was ich direkt steuern kann, da diese Tabelle automatisch erstellt wird. Kannst es ja mal mit Chrome versuchen, da klappts bei mir.

Verspätungsalarm hatte ich auch schon überlegt. Einerseits bin ich jetzt morgens nicht der, der immer den gleichen Zug erwischt :) Das hängt von ab wann ich aus dem Bett komme :)
Daher würde ich es ungern fix in die Routen einbauen.

Grundsätzlich finde ich die Idee aber gut. Eine Möglichkeit wäre, es wirklich bei der jeweiligen Route zu integrieren. Dann kommen aber in der Tabelle noch Spalten dazu. Man sollte ja mindestens einen Zeitraum (z.B. zwischen 7 und 8 Uhr) eingeben können und noch ein Haken für den Verspätungsalarm. Dann wird die Tabelle sehr voll :(

Alternativ könnte ich ein neues Register "Verspätungsalarm" einbauen. Dort könnte ich die Nummer der Route einfach nur einlesen und dort dann die Optionen für "Zeit ab" und "Zeit bis" eintragen.

Die Frage ist halt, über welche Kanäle dann die Benachrichtigung laufen soll. Soll ich was einbauen, z.B. einen Alexa-Datenpunkt, in den der Adapter dann einen Text "<Verkehrmittel> von <Start> nach <Ziel> ...." schreibt ? Soll es immer über den gleichen Kanal laufen oder je nach Route ?

Oder willst einfach einen speziellen Status haben und den Rest dann selbst auswerten ? Dann kann ichs aber aus dem Adapter fast rauslassen, weil dann muss man ja eh irgendwas mir Skripten machen...

Wie gesagt, ich erweitere den Adapter gerne noch bei Bedarf.

[sigi234]

@AggroRalf

Läuft wunderbar. :+1: Erstelle gerade eine View:
Teste gerade.

[htrecksler]

@AggroRalf sagte in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

https://github.com/gaudes/ioBroker.fahrplan

gerade ohne Probleme installiert. Intuitiv einzurichten. Sehr geil.

Einen Wunsch hätte ich allerdings auch (Pendler)
Man müsste eine Route als Pendlerstrecke einrichten können. Also fester Route immer zur gleichen Zeit, damit ich genau diese Verspätung (oder pünktliche Abfahrt) morgens "Groß" auf dem VIS anzeigen kann.

Aber unabhängig davon gefällt mir der Adapter sehr gut. Danke dafür.

[htrecksler]

@AggroRalf sagte in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

Alternativ könnte ich ein neues Register "Verspätungsalarm" einbauen. Dort könnte ich die Nummer der Route einfach nur einlesen und dort dann die Optionen für "Zeit ab" und "Zeit bis" eintragen.

das würde wahrscheinlich schon völlig reichen

[siggi85]

Sieht sehr gut aus, vielen Dank schon Mal dafür! :) :+1:
Das Eintragen einer festen Abfahrt wäre auf jeden Fall nützlich, gerade für feste Pendler.

[siggi85]

@AggroRalf sagte in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

Konstruktive Verbesserungsvorschläge nehme ich gerne entgegen, z.B. welche Werte eine erweiterte HTML-Tabelle enthalten sollte.

Hier mal ein erster Versuch (in Excel Form) als Basis für weitere Vorschläge.
Für Pendler sind in der Regel nur ein paar Kerninfos wichtig und dass auf den ersten Blick Änderungen an diesen Parametern erkennbar sind.

[derhuerst]

Verspätungsalarm hatte ich auch schon überlegt. Einerseits bin ich jetzt morgens nicht der, der immer den gleichen Zug erwischt 🙂 Das hängt von ab wann ich aus dem Bett komme 🙂
Daher würde ich es ungern fix in die Routen einbauen.

Grundsätzlich finde ich die Idee aber gut. Eine Möglichkeit wäre, es wirklich bei der jeweiligen Route zu integrieren. Dann kommen aber in der Tabelle noch Spalten dazu. Man sollte ja mindestens einen Zeitraum (z.B. zwischen 7 und 8 Uhr) eingeben können und noch ein Haken für den Verspätungsalarm. Dann wird die Tabelle sehr voll 😞

Alternativ könnte ich ein neues Register "Verspätungsalarm" einbauen. Dort könnte ich die Nummer der Route einfach nur einlesen und dort dann die Optionen für "Zeit ab" und "Zeit bis" eintragen.

hafas-client-Entwickler hier. Dafür habe ich mal https://github.com/derhuerst/hafas-monitor-journeys gebaut, das müsste man mal auf den neuesten Stand bringen, aber prinzipiell wäre es klug, die Verbindungsüberwachungslogik in einer Bibliothek zu haben, damit andere Projekte sie auch nutzen können.

[gender]

Habe den Adapter auch gerade einmal getestet.
Super. Funktioniert und ist auch intuitiv einzurichten.

Eine Rückfrage: Ich habe jetzt bei einer Route die Parameter "Bus" und "max. 0 Umstiege" eingestellt.
Trotzdem liefert er mir bei dieser Route Ergebnisse, bei welcher das Ziel über eine "Tram" bzw. außerdem mit "Walking" erreicht werden (also andere als das gewählte Produkt "Bus" und auch mehr als 0 Umstiege).

Habe es auch separat getestet. Es wird scheinbar weder die Art noch die Anzahl der Umstiege berücksichtigt. Kann das jemand bei seinen Routen bestätigen oder ist es nur bei mir so?!

[AggroRalf]

Hallo zusammen,

vorab: Ich habe gerade Version 0.1.2 released. Sichtbar sind aktuell neue Optionen. Man kann auswählen, ob man die detailierten Objekte haben will, also ob jede Reise und jeder Reiseabschnitt als Objekte in ioBroker gespeichert werden sollen. Manchen reicht ja vielleicht die HTML-Tabelle aus. Außerdem kann man die HTML-Tabelle nun auf Basis des Vorschlags von @sigi234 etwas konfigurieren (Nur Zeiten, Zeiten + Verspätungen sowie Zeiten + Verspätungen + Bahnsteige).

Daher bitte die Konfig nach Update nochmal prüfen!

Außerdem habe ich den Code nochmal fast komplett überarbeitet (für Interessierte):

Spoiler

Ich habe alles in eine objektorientierte Klassenstruktur umgebaut. Es gibt also Linien, Stationen, Reiseabschnitte, Reisen und Route nun als Klassen mit entsprechender Verschachtelung und Klassen-Funktionen. Das macht den Code für mich deutlich einfacher und übersichtlicher, man muss nur etwas "rekursiv" denken :)
Ich hatte die Idee schon zu Beginn, habe es initial aber nicht hinbekommen. Jetzt tut's aber :). Funktional ist es aber gleich geblieben.

@sigi234 : Sehr schicke VIS :)

@derhuerst : Cool :) Vielen Dank noch für den hafas-Client :)

@htrecksler, @derhuerst :
Ich würde den Verspätungsalarm nicht gesondert, also auch nicht über eine extra Bibliothek einbauen.

Ich würde es gerne intern in Abhängigkeit zu den Routen lösen.

Ich denke noch nach, hier mal für Interessierte meine aktuelle Ideen und Probleme:

Spoiler

Aktuell würde ich es so machen, dass man auf einer extra Registerseite in der Konfig zu seinen Routen "Pendlereinträge" erstellen kann.

Zusätzlich muss man ein Zielobjekt angeben, z.B. Speak-Objekt von Alexa oder reponse-Objekt von Telegramm oder ein eigenes Objekt. Hierüber würde dann eine Text- oder Sprachausgabe erfolgen.

Nehmen wir als Beispiel einen Zug um 8:00 planmäßige Abfahrt. Nun erhalte ich aktuell ja immer die nächsten 3 Verbindungen. Bei einer stündlichen Verbindung würde dieser Zug dann z.B. schon um 6 Uhr "auftauchen". Wann soll benachrichtigt werden ? Gleich um 6 Uhr macht es wohl wenig Sinn.

Soll man die planmäßige Abfahrt angeben, also hier 8:00 Uhr ? Wann soll dann benachrichtigt werden ? Feste X Minuten vorher ?

Oder soll man einen Zeitraum angeben, in dem man über alles benachrichtigt werden will ? In dem Fall hier könnte man sagen Benachrichtigung zwischen 7:30 und 8:00. Da der Adapter aber z.B. alle 5 Minuten läuft will man ja nicht alle 5 Minuten eine Ansage. Sonst müsste diese nur bei Verspätungen und danach bei Änderungen der Verspätungen kommen. Kann trotzdem nervig werden.

Während ich das hier grad so überlege und schreibe komme ich zum Schluss, dass letzteres vermutlich das beste ist. Oder wie sind die Meinungen ?

@gender : Lustig, genau das gleich ist mir gerade auch aufgefallen. Ich habe eine Route mit nur S-Bahn und 0 Umstiegen konfiguriert, trotzdem erscheint eine Verbindung mit Bus und 1x umsteigen. Vielleicht hat @derhuerst eine Idee ? Ich übergebe die Routen-Optionen korrekt ... Es tritt auch nur in Ausnahmefällen auf, nicht permanent.

So, das wars erstmal.

[sigi234]

@AggroRalf

Super, ich würde mir noch eine Ausgabe als Table wünschen, oder zumindest die Wichtigsten Daten als DP im Format:

Datum: Mo. 20.Jul. 2020
Abfahrt: 07:00 Uhr
Ankunft: 09:00 Uhr
Verspätung: X Minuten
Gleis: XYZ

Ich finde die HTML jetzt unübersichtlich und man kann da ja nichts ändern darum wäre eine Ausgabe als Table besser.

[RandyAndy]

@AggroRalf

Hallo,

den Adapter werde ich geich mal testen. Wenn der funktioniert das wäre cool.
Habe bis jetzt das Skript verwendet, das hat aber z.B. bei Garmisch-Partenkirchen nicht wirklich funktioniert. Warum habe ich nicht verstanden habe mich aber mit logs nicht rumgeärgert um das herauszubekommen.
Ich schließe mich der Meinung von sigi123 an, dass es günstiger wäre alle Daten auch als Datenpunkt zu haben. Dann kann man die Daten auch für andere Routinen weiterverwenden.

Andreas

[AggroRalf]

@sigi234 @RandyAndy

Die einzelnen Datenpunkte mit allen Werten sind ja alle noch da, aber nun optional. Wer sie braucht, hat sie. Wer sie nicht braucht, kann sie abschalten.

Oder hab ich Euch falsch verstanden ?

[sigi234]

@AggroRalf sagte in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

Die einzelnen Datenpunkte mit allen Werten sind ja alle noch da, aber nun optional.

Wo in diesen Format?

Datum: Mo. 20.Jul. 2020
Abfahrt: 07:00 Uhr
Ankunft: 09:00 Uhr

[AggroRalf]

@sigi234 Ah, jetzt versteh ich dich.

Ich kann alle Datums- und Uhrzeitsdatenpunkte in diesem Format machen, das ist kein Problem. Ich kann es auch wählbar in den Adaptereinstellungen machen, ob man die Werte als "schönes format" oder Standard haben will ... Je nachdem wie der Bedarf ist :)

[derhuerst]

@AggroRalf said in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

Ich habe eine Route mit nur S-Bahn und 0 Umstiegen konfiguriert, trotzdem erscheint eine Verbindung mit Bus und 1x umsteigen. Vielleicht hat @derhuerst eine Idee ? Ich übergebe die Routen-Optionen korrekt ... Es tritt auch nur in Ausnahmefällen auf, nicht permanent.

Mach dazu bitte mal ein Issue in https://github.com/public-transport/db-hafas oder https://github.com/public-transport/hafas-client auf, mit konkreten Beispielen. Dann kann ich das leichter im Auge behalten.

Gleiches gilt übrigens für andere Probleme, bei denen ihr vermutet, dass es an db-hafas/hafas-client/HAFAS liegt.

[derhuerst]

@AggroRalf said in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

@htrecksler, @derhuerst :
Ich würde den Verspätungsalarm nicht gesondert, also auch nicht über eine extra Bibliothek einbauen.

Mach das, wie du willst. Gründe, warum ich es in eine Bibliothek bewegen würde:

• Das Problem des "Pendleralarms", wenn man es benutzerfreundlich umsetzen möchte, ist recht komplex. Es gibt da vieles zu beachten, um zum richtigen Zeitpunkt hilfreiche und nicht zu viele Benachrichtigungen zu verschicken.
• Eine Funktion wie ein "Pendleralarm" wäre in vielen anderen Apps, Tools, Backends, etc. nützlich.

Nehmen wir als Beispiel einen Zug um 8:00 planmäßige Abfahrt.

Es gibt in diesem Szenario unterschiedliche Anforderungen:

• Manche Menschen wollen, angesichts fester Arbeitszeiten, so spaet wie möglich losfahren, solange sie noch sicher zu einer bestimmten Zeit ankommen.
• Manche Menschen arbeiten zeitlich flexibel, und wollen daher in einem bestimmten Zeitbereich die beste (nach gewaehlten Kriterien, z.b. Zeit, Umstiege, etc) Verbindung nehmen.
• Manche Menschen wollen einfach die erste geeignete Verbindung nehmen, auch wenn sie nicht die beste oder verspaetet ist.

Es gibt sicherlich noch weitere Szenarien, da sollten wir in einem Extra-Thread mal drüber reden. Ich würde dafür https://github.com/public-transport/ideas/issues vorschlagen, weil das wieder ein Problem unabhaengig der Oberflaeche (also hier Smart-Home-System) ist.

Nun erhalte ich aktuell ja immer die nächsten 3 Verbindungen.

Das ist so nicht immer richtig. Du erhaelst 3 nach den Suchkriterien optimale Verbindungen. HAFAS versucht aber manchmal, je nach Konfiguration, 3 sinnvolle Alternativen zu zeigen, die dann eben nicht einfach die frühesten Verbindungen sind. Das ist ein subtiler Unterschied, der bei einem "Pendleralarm" relevant wird.

Bei einer stündlichen Verbindung würde dieser Zug dann z.B. schon um 6 Uhr "auftauchen". Wann soll benachrichtigt werden ? Gleich um 6 Uhr macht es wohl wenig Sinn.

Ich als Pendler würde eine Benachrichtigung erwarten, wenn die aktuell beste Verbindung (siehe oben) von meiner üblichen Verbindung abweicht, denn die kenne ich ja in- und auswendig.

[htrecksler]

@derhuerst sagte in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

Ich als Pendler würde eine Benachrichtigung erwarten, wenn die aktuell beste Verbindung (siehe oben) von meiner üblichen Verbindung abweicht, denn die kenne ich ja in- und auswendig.

so unterschiedlich ist das. Ich möchte einfach nur wissen ob der Zug den ich jeden Morgen nehme pünktlich ist bzw. wieviel Verspätung er hat. Fertig. Alternativen oder andere Verbindungen interessieren mich nicht. Wenn es relevant wird würde ich selber schauen.
In der Regel ist mein Zug morgens pünktlich (max. 3 Min Verspätet) zu 80 %.
In dem Fall ist der Status OK.
Alle anderen Verspätungen will ich einfach nur wissen.

[derhuerst]

@htrecksler said in Test Adapter Fahrplan v0.1.x GitHub (ALPHA-Version):

so unterschiedlich ist das. Ich möchte einfach nur wissen ob der Zug den ich jeden Morgen nehme pünktlich ist bzw. wieviel Verspätung er hat.

Steigst du denn um? Dann handelt es sich ja nicht mehr um eine simple Zahl (die Verspätung).

Wir haben offenbar unterschiedliche Situationen. Auf meinen bisherigen Arbeitswegen gab es immer >1 sinnvolle Möglichkeit zum Ziel, d.h. es war relevant zu wissen, ob ich mit einer der mehreren pünktlich ankomme.