VDV-Schrift 301-2-8 - Verband Deutscher Verkehrsunternehmen

service
VDV-Schrift
301-2-8
07/2016
IBIS-IP Beschreibung der Dienste
Dienst PassengerCountingService
Gesamtbearbeitung
Ausschuss für Telematik und Informationssysteme (ATI)
Das dieser VDV-Schrift zugrundeliegende Vorhaben IP-KOM-ÖV wurde mit Mitteln
des Bundesministeriums für Wirtschaft und Energie unter dem Förderkennzeichen
19P10003 gefördert. Die Verantwortung für den Inhalt dieser Veröffentlichung liegt
bei den Autoren.
VDV-Schrift 301-2-8
07/2016
IBIS-IP Beschreibung der Dienste
Dienst PassengerCountingService
Sachbearbeitung
Unterausschuss für Telematik
(UA Telematik)
Autorenverzeichnis
Dipl.-Ing. Dirk Weißer, INIT, Karlsruhe
Dr. Torsten Franke, IVU, Aachen
Dr. Holger Bandelin, Scheidt & Bachmann,
Mönchengladbach
Dipl.-Ing. Berthold Radermacher, VDV, Köln
Dipl.-Ing. (FH) Andreas Wehrmann, VDV, Köln
Dipl.-Ing. ETH Walter Meier-Leu, we, Schaffhausen
Dipl.-Ing. René Fischli, Trapeze, Neuhausen
© Verband Deutscher Verkehrsunternehmen e. V. Köln 2015 | Alle Rechte, einschließlich
des Nachdrucks von Auszügen, der fotomechanischen oder datenverarbeitungstechnischen
Wiedergabe und der Übersetzung, vorbehalten.
VDV-Schrift 301-2-8 | 07/2016 | 3
Vorwort
Auf Initiative des VDV und gefördert durch das BMWi begann im September 2010 das
Forschungs- und Standardisierungsprojekt Internet Protokoll basierte Kommunikationsdienste im
öffentlichen Verkehr (IP-KOM-ÖV).
Das Projekt wird von 14 Partnern aus Industrie, Universitäten und Verkehrsunternehmen
getragen. Es dient der Erarbeitung moderner Kommunikationskonzepte für die umfassende und
kontinuierliche Fahrgastinformation.
Die Ergebnisse des Projektes flossen in die VDV 301-1 „Internetprotokoll basiertes integriertes
Bordinformationssystem IBIS-IP Teil 1: Systemarchitektur“ und VDV301-2 „Internetprotokoll
basiertes integriertes Bordinformationssystem IBIS-IP Teil 2: Schnittstellenspezifikation v1.0“, die
im Januar 2014 veröffentlicht wurden, ein
Die vorliegende VDV-Schrift 301-2-8 wurde aus der VDV-301-2 01/2014 separiert, um zukünftige
Anpassungen an einzelnen IBIS-IP-Diensten unabhängig von anderen IBIS-IP-Diensten vornehmen
zu können.
In der VDV-301-2 werden die technischen Grundlagen wie auch die Basisdienste, welche die
Grundlagen eines IBIS-IP-Systems bilden, beschrieben.
In der vorliegenden VDV-Schrift 301-2-8 sind der PassengerCounterService und seine spezifischen
Datenstrukturen beschrieben.
VDV-Schrift 301-2-8 | 07/2016 | 4
Inhaltsverzeichnis
Vorwort
Versionshistorie
4
6
1
Dienst PassengerCountingService
7
1.1
Einleitung
7
1.2
Operationen des PassengerCountingService
7
1.3
Datenstrukturen der Operation GetAllData
8
1.3.1
Request
8
1.3.2
Response
8
1.4
Datenstrukturen der Operation SubscribeAllData
8
1.5
Datenstrukturen der Operation UnsubscribeAllData
8
1.6
Datenstruktur der Operation RetrieveSpecificDoorData
8
1.6.1
Request
9
1.6.2
Response
9
1.7
Datenstruktur der Operation SetCounterData
9
1.7.1
Request
9
1.7.2
Response
9
Regelwerke – Normen und Empfehlungen
Tabellenverzeichnis
Impressum
VDV-Schrift 301-2-8 | 07/2016 | 5
10
11
12
Versionshistorie
Datum
Verfasser
Änderung
VDV-Schrift 301-2-8 | 07/2016 | 6
1
Dienst PassengerCountingService
1.1
Einleitung
Der Dienst PassengerCountingService ist die Umsetzung der Fachkomponente
Fahrgastzählung innerhalb der IBIS-IP-Kommunikationsarchitektur. Da die Fahrgastzähldaten für
betriebliche Auswertungen von erheblicher Relevanz sind, steht bei diesem Dienst die sichere
Übertragung der Information im Vordergrund, was dazu führt, dass dieser Dienst ein sogenannter
HTTP-Dienst ist.
Dieser Dienst kann innerhalb der IBIS-IP Infrastruktur mehrfach vorhanden sein und stellt daher –
ähnlich dem Dienst DeviceManagementService – eine Besonderheit dar.. Zur
Unterscheidung der Zähldaten an den unterschiedlichen Türen dienen dann die Angaben zu der
jeweiligen Tür.
1.2
Operationen des PassengerCountingService
Der PassengerCountingService kann über die in Tabelle 1 dargestellten Operationen
angesprochen werden, die Beschreibung der Strukturen befindet sich dann anschließend in den
Kapiteln 1.3ff.
Operation
Request/
Verwendeter Datentyp, Datenstruktur
Response
GetAllData
Req.
-
Resp.
PassengerCountingService.
GetAllDataResponseStructure
SubscribeAllData
UnsubscribeAllData
RetrieveSpecificDoorData
Req.
SubscribeRequestStructure
Resp.
SubscribeResponseStructure
Req.
UnsubscribeRequestStructure
Resp.
UnsubscribeResponseStructure
Req.
PassengerCountingService.
RetrieveSpecificDoorDataRequestStructure
Resp.
PassengerCountingService.
RetrieveSpecificDoorDataResponseStructure
SetCounterData
Req.
PassengerCountingService.
SetCounterDataRequestStructure
Resp.
Tabelle 1
DataAcceptedResponseStructure
Beschreibung von Operationen des PassengerCountingService
VDV-Schrift 301-2-8 | 07/2016 | 7
1.3
Datenstrukturen der Operation GetAllData
1.3.1
Request
Da es sich um eine Get-Operation handelt, gibt es bei dieser Operation keine Request-Struktur.
1.3.2
Response
PassengerCountingService.GetAllDataRes
ponse
a AllData
–1:1
b ErrorMessage
Tabelle 2
TimeStamp
CountingData
1.4
Antwortstruktur des PassengerCountingService
choice
eine der beiden folgenden Strukturen
+PassengerC
ountingServic
e.AllData
ausführliche Antwortstruktur (siehe Tabelle unten)
IBIS-IP.string
Rückmeldung von Fehlern
Beschreibung von PassengerCountingService.GetAllDataResponse
PassengerCountingService.AllData
Tabelle 3
+Structure
1:1
0:*
+Structure
Struktur zur Beschreibung der Dateninhalte des
PassengerCountingService
IBISIP.dateTime
Angabe des Zeitpunkts der Antwort
+DoorInformat
ion
Struktur zur Beschreibung der Zähldaten und
sonstiger Informationen an einer Fahrzeugtür (siehe
VDV 301-2-1)
Beschreibung von PassengerCountingService.AllData
Datenstrukturen der Operation SubscribeAllData
Für die Einrichtung von Abonnements werden die in der VDV 301-2-1 beschriebenen
Datenstrukturen verwendet.
1.5
Datenstrukturen der Operation UnsubscribeAllData
Für das Beenden von Abonnements werden die in der VDV 301-2-1 beschriebenen
Datenstrukturen verwendet.
1.6
Datenstruktur der Operation RetrieveSpecificDoorData
Um gesondert die Daten einer oder mehrerer Türen abzufragen, steht die Operation
RetrieveSpecificDoorData zur Verfügung. Mit der Anfrage übergibt man die Tür, von der
man die Zähldaten wissen möchte. Mit der Antwortstruktur erwählt man die entsprechenden
Daten.
VDV-Schrift 301-2-8 | 07/2016 | 8
1.6.1
Request
PassengerCountingService.RetrieveSpecifi
cDoorDataRequest
1:1
DoorID
Tabelle 4
1.6.2
–1:1
b OperationErrorMes
sage
ID zur eindeutigen Identifikation einer Tür
+Structure
Struktur für die Beantwortung eine Anfrage nach
Zähldaten einer bestimmten Tür
Choice
eine der beiden folgenden Strukturen
+PassengerC
ountingServic
e.SpecificDoor
Data
ausführliche Antwortstruktur (siehe Tabelle unten)
IBIS-IP.string
Rückmeldung von Fehlern
Beschreibung von PassengerCountingService.RetrieveSpecificDoorDataResponse
PassengerCountingService.
SpecificDoorData
1.7
IBISIP.NMTOKEN
Response
a SpecificDoorData
Tabelle 6
Struktur für die Beantwortung eine Anfrage nach
Zähldaten einer bestimmten Tür
Beschreibung von PassengerCountingService.RetrieveSpecificDoorDataRequest
PassengerCountingService.RetrieveSpecifi
cDoorDataResponse
Tabelle 5
+Structure
+Structure
Struktur zur Beschreibung der Zähldaten einer
bestimmten Tür
TimeStamp
1:1
IBISIP.dateTime
Angabe der Zeitpunkts, für den die Antwort gültig ist
CountingData
1:1
+DoorInformat
ion
Struktur zur Beschreibung der Zähldaten und
sonstiger Informationen an einer Fahrzeugtür (siehe
VDV 301-2-1)
Beschreibung von PassengerCountingService. SpecificDoorData
Datenstruktur der Operation SetCounterData
Um ggf. Zähldaten einer (oder mehrerer) Tür auf einen bestimmten Wert zu setzen, steht in IBISIP bei Dienst PassengerCountingService die Operation SetCounterData zur
Verfügung.
1.7.1
Request
PassengerCountingService.SetCounterDat
aRequest
DoorSetList
Tabelle 7
1.7.2
1:*
+Structure
Struktur für die Übermittlung von Informationen an den
PassengerCountingService
+DoorCountin
gList
Liste an Türen, für die Zähldaten gesetzt werden
sollen (siehe auch VDV 301-2-1)
Beschreibung von PassengerCountingService.SetCounterDataRequest
Response
Da es sich um eine Übermittlung von Informationen an einen Dienst handelt, wird die Antwort
mit der dafür vorgesehenen allgemeinen Struktur gegeben (siehe VDV 301-2-1).
VDV-Schrift 301-2-8 | 07/2016 | 9
Regelwerke – Normen und Empfehlungen
(1) CEN/TS 13149-7
Öffentlicher Verkehr - Planungs- und Steuerungssysteme für
Straßenfahrzeuge - Teil 7: IP-basierende Vernetzung in einem
Fahrzeug, Netzwerk- und Systemarchitektur (FprCEN/TS 131497:2015)
(2) CEN/TS 13149-8
Öffentlicher Verkehr - Planungs- und Steuerungssysteme für
Straßenfahrzeuge - Teil 8: Physikalische Schicht für IP-Kommunikation;
Englische Fassung CEN/TS 13149-8:2013
(3) VDV 301-1
Internetprotokoll basiertes integriertes Bordinformationssystem IBISIP - Teil 1: Systemarchitektur
(4) VDV 301-2
Internetprotokoll basiertes integriertes Bordinformationssystem IBISIP - Teil 2: Schnitstellenspezifikation
(5) VDV 301-2-1
IBIS-IP Beschreibung der Dienste
Gemeinsame Datenstrukturen und Aufzählungstypen
VDV-Schrift 301-2-8 | 07/2016 | 10
Tabellenverzeichnis
Tabelle 1
Beschreibung von Operationen des PassengerCountingService
7
Tabelle 2
Beschreibung von PassengerCountingService.GetAllDataResponse
8
Tabelle 3
Beschreibung von PassengerCountingService.AllData
8
Tabelle 4
Beschreibung von
PassengerCountingService.RetrieveSpecificDoorDataRequest
9
Beschreibung von
PassengerCountingService.RetrieveSpecificDoorDataResponse
9
Tabelle 6
Beschreibung von PassengerCountingService. SpecificDoorData
9
Tabelle 7
Beschreibung von PassengerCountingService.SetCounterDataRequest 9
Tabelle 5
VDV-Schrift 301-2-8 | 07/2016 | 11
Impressum
Verband Deutscher Verkehrsunternehmen e. V. (VDV)
Kamekestraße 37-39 · 50672 Köln
T 0221 57979-0 · F 0221 57979-8000
[email protected] · www.vdv.de
Ansprechpartner
Dipl.-Ing. Berthold Radermacher
T 0221 57979-141
F 0221 57979-8141
[email protected]
VDV-Schrift 301-2-8 | 07/2016 | 12
Verband Deutscher Verkehrsunternehmen e. V. (VDV)
Kamekestraße 37-39 · 50672 Köln
T 0221 57979-0 · F 0221 57979-8000
[email protected] · www.vdv.de