Konfiguration
Der Tab „Konfiguration" ist in zwei Abschnitte unterteilt: Client Konfiguration (Dienst und Client-Name) und Einstellungen (Intervall, Logs, Verspätungsoffset).
| Eigenschaft | Wert |
|---|---|
| Typ | Dropdown (Einzelauswahl) |
| Standard | HAFAS - VBB (Berlin/Brandenburg) |
Wichtig: Service-Typ und Profil werden intern getrennt gespeichert (als eigene Felder serviceType und profile), aber über ein einziges kombiniertes Dropdown ausgewählt. Der kombinierte Wert (z.B. hafas:vbb) ist nur die Anzeige in der UI. Die Auswahl legt gleichzeitig fest, welche API verwendet wird und welche Verkehrsmittel verfügbar sind.
| Anzeigeoption | Interner Wert | Dienst | Profil |
|---|---|---|---|
| HAFAS - VBB (Berlin/Brandenburg) | hafas:vbb |
HAFAS | vbb |
| HAFAS - ÖBB (Österreich) | hafas:oebb |
HAFAS | oebb |
| HAFAS - VBN (Bremen/Niedersachsen) | hafas:vbn |
HAFAS | vbn |
| HAFAS - RMV (Rhein-Main/Mainz) | hafas:rmv |
HAFAS | rmv |
| HAFAS - VMT (Thüringen) | hafas:vmt |
HAFAS | vmt |
| Vendo - Deutsche Bahn (deaktiviert, nicht auswählbar) | vendo:db |
Vendo | db |
| MOTIS - Transitous (DE & Europa) | motis:compat |
MOTIS | compat |
Hinweis: Die Option „Vendo - Deutsche Bahn" ist seit Version 0.10.0 im Dropdown ausgegraut, da der db-vendo-Endpoint der Deutschen Bahn mit
OPS_BLOCKEDantwortet (serverseitige Sperre). Bestehende Instanzen, die noch aufvendo:dbstehen, erhalten keine Daten mehr und müssen auf ein anderes Profil umgestellt werden — siehe Transportdienste.
Welche Verkehrsmittel je Profil verfügbar sind, ist in der Seite Transportdienste beschrieben.
| Eigenschaft | Wert |
|---|---|
| Typ | Textfeld (optional) |
| Standard | leer (Adapter generiert automatisch einen Namen) |
Optionaler Name, der als User-Agent-Bezeichner für die API-Anfragen gesetzt wird (z.B. mein-iobroker). Wird das Feld leer gelassen, verwendet der Adapter einen automatisch generierten Namen (iobroker-public-transport-{zufällig}).
Dieser Wert hat keinen Einfluss auf die abgerufenen Daten.
| Eigenschaft | Wert |
|---|---|
| Typ | Zahleneingabe |
| Standard | 5 |
| Minimum | 5 |
| Maximum | 60 |
| Einheit | Minuten |
Legt fest, wie oft der Adapter die Abfahrten und Verbindungen bei den konfigurierten Stationen und Verbindungen aktualisiert. Ein kürzeres Intervall erhöht die Aktualität der Daten, belastet aber die API stärker.
Hinweis: Das Intervall gilt global für alle Stationen und Verbindungen. Pro Abfragezyklus werden alle aktiven Konfigurationen nacheinander abgefragt.
| Eigenschaft | Wert |
|---|---|
| Typ | Checkbox |
| Standard |
false (nicht unterdrückt) |
Wenn aktiviert, werden detaillierte Info-Logs (z.B. Meldungen über jede einzelne Abfragerunde) nicht ins ioBroker-Log geschrieben. Fehler- und Warnungs-Logs werden weiterhin ausgegeben.
Nützlich bei produktivem Betrieb, um das Log übersichtlich zu halten.
| Eigenschaft | Wert |
|---|---|
| Typ | Zahleneingabe |
| Standard | 2 |
| Minimum | 2 |
| Maximum | 60 |
| Einheit | Minuten |
Definiert die Toleranz für die Anzeige von Pünktlichkeit. Eine Abfahrt gilt noch als pünktlich (DepartureOnTime = true), wenn die Verspätung unterhalb des Offsets liegt.
Beispiel: Bei delayOffset = 2 gilt eine Abfahrt mit 1 Minute Verspätung als pünktlich. Bei exakt 2:00 Minuten gilt sie weiterhin als pünktlich; erst bei mehr als 2 Minuten (> 120 s) wird DepartureDelayed = true gesetzt.
Die Datenpunkte DepartureDelayed und DepartureOnTime (bei Stationen) sowie die entsprechenden Felder bei Verbindungen werden auf Basis dieses Wertes berechnet.
| Eigenschaft | Wert |
|---|---|
| Typ | Zahleneingabe |
| Standard | nicht gesetzt — das Feld zeigt dann die aktuell im js-controller hinterlegte Schwelle |
| Minimum | 5000 |
| Schrittweite | 100 |
Ab dieser Objektanzahl warnt der js-controller im Log, dass diese Instanz ungewöhnlich viele Objekte angelegt hat. Der Adapter erzeugt pro Station und pro Verbindung eine größere Zahl an Datenpunkten (siehe Abfahrten und Verbindungen) — bei umfangreicheren Konfigurationen wird die Standardschwelle des js-controllers überschritten, obwohl der Adapter korrekt arbeitet. Über dieses Feld lässt sich die Schwelle für diese Instanz anheben, statt die Warnung dauerhaft im Log stehen zu haben.
Wirkungsweise: Der Wert wird in native.objectsWarnLimit gespeichert und beim Adapterstart in den State system.adapter.public-transport.<instanz>.objectsWarnLimit übernommen — nur diesen State wertet der js-controller aus. Da das Speichern der Konfiguration die Instanz ohnehin neu startet, ist die neue Schwelle direkt danach wirksam.
Hinweis: Werte unter
5000werden nicht übernommen — die Admin-UI markiert das Feld als Fehler, und der Adapter ignoriert einen zu kleinen Wert beim Start. Bleibt das Feld leer, ändert der Adapter die Schwelle des js-controllers nicht.
Die folgenden Felder existieren in der Adapter-Konfiguration, sind aber nicht über den Admin-Tab erreichbar. Sie können bei Bedarf direkt in der Konfigurationsdatei (io-package.json) oder per ioBroker-Objekteditor gesetzt werden.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
logCompletelyJSON |
Boolean | false |
Vollständige API-Antworten ins Log schreiben (Debug) |
logUnknownTokens |
Boolean | false |
Unbekannte i18n-Übersetzungs-Tokens loggen |
Hinweis: Diese Felder sind nur für Debugging und Entwicklung gedacht. Im Normalbetrieb müssen sie nicht gesetzt werden.
- Profil ↔ Abfahrten/Verbindungen: Nach einer Profiländerung müssen ggf. bestehende Stationen und Verbindungen neu konfiguriert werden, da sich die verfügbaren Verkehrsmittel ändern. Der Adapter löscht vorhandene Datenpunkte dabei nicht automatisch.
- Abfrageintervall ↔ Polling: Alle aktiven Stationen und Verbindungen werden im selben Zyklus abgefragt. Bei sehr vielen Konfigurationen und kurzem Intervall können API-Anfragen gehäuft auftreten.
