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