SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02 WEB API a forgalomirányító berendezések távfelügyeletéhez
SWARCO TRAFFIC SYSTEMS GMBH
TARTALOMJEGYZÉK 1
Ezen dokumentumról .................................................................................................................... 3 1.1
A dokumentum célja ................................................................................................................ 3
1.2
Verziókövetés .......................................................................................................................... 3
1.3
Kapcsolódó dokumentumok .................................................................................................... 4
2
Alapvető előfeltételek .................................................................................................................... 5
3
Kommunikációs protokoll ............................................................................................................ 5
4
Komponens kapcsolatok .............................................................................................................. 6
5
Komponensek ................................................................................................................................ 8 5.1
Érzékelő adatok (DetectorReadingData) ................................................................................. 8
5.2
JCS és detektor állapot (SignalStateData) .............................................................................. 9
5.3
Berendezés állapot (DeviceStatus) ....................................................................................... 10
5.4
Csomópont állapot (OperationalStateData) .......................................................................... 11
5.5
Hibaüzenetek (MessageData) ............................................................................................... 13
5.6 Berendezés konfiguráció (Configuration) .............................................................................. 14 5.6.1 Detektor elnevezési szabály .......................................................................................... 14 5.7
Üzemmódváltás (SwitchCommand) ...................................................................................... 15
5.8
Események (Event) ............................................................................................................... 15
5.9
Hibatörlés (TlcReset) ............................................................................................................. 15
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 2/15
SWARCO TRAFFIC SYSTEMS GMBH
1 Ezen dokumentumról A jelen dokumentumban részletezett protokoll az 1.3 Kapcsolódó dokumentumok fejezetben részletezett dokumentumokon alapul. Az 1. számú dokumentumban hivatkozott nyitott protokoll inspirálta a 2. számú dokumentumot, mely a nyitott protokoll részletes specifikációját tartalmazza. A 3. fejezet tárgyalja a kommunikációs protokoll alkalmazás rétegét. Az adatlekérdező metódusokat és a vonatkozó válaszok listáját a 4. fejezet tartalmazza. Az 5 Komponensek fejezet definiálja a fent említett metódusok által használt és a kommunikáció során átadott entitásokat.
1.1 A dokumentum célja Ezen dokumentum egy rövid leírása az egyelőre nem végleges és nem teljes körűen ellenőrzött protokollnak és WEB API-nak, mely az MK1 számára szállított forgalomirányító berendezések távfelügyeletét teszi lehetővé.
1.2 Verziókövetés
1
Verzió
Dátum
A változtatás leírása
1.0 1.1
07..04.2014 09.04.2014
1.2
11.04.2014
1.3
14.07.2014
1.4
15.07.2014
1.5
21.07.2014
1.6
29.08.2014
1.7
04.09.2014
1.8
12.09.2014
kiindulási verzió dokumentum felépítés változtatása OperationalStateData módosítása A Komponens kapcsolatok részletesebb kifejtése Módosítás és részletesebb leírás a Komponensekhez Az Időbélyeg most már ezredmásodpercben van megadva, 01/01/1970 00:00:00 UTC –től számolva. Komponensek bővítése id-kel Komponens kapcsolatok bővítése a registereventurl metódussal Az Események hozzáadása a Komponensekhez A nem specifikált módosítók tömb helyett az OperationalStateData most már két definiált módosítót tartalmaz (HurryUp és LocalTA üzemmód) Az OperationalStateData leírása részletesen tartalmazza mindkét hozzá tartozó adatlekérő metódust Az Időbélyegek másodpercben értelmezendőek ezredmásodperc helyett A DeviceStatus-hoz jelzőcsoport és jelzőfej név és azonosító lett hozzáadva Üzenetek: üzenet szövegek hozzáadva SwitchCommand URL paraméterekkel Üzenet kategóriák hozzáadva Kibővített NodeOperationalMode SwitchRequestType átnevezve DeviceStatus kiegészítése CurrentTime-al SwitchRequestTypes kiegészítése: “AUTO” és “_MAN” “fullData” paraméter hozzáadása a signalstate-hez Konfigurációs erőforrások kiterjesztése
MK = Magyar Közút Nonprofit Zrt. rövidítése
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 3/15
SWARCO TRAFFIC SYSTEMS GMBH konfigurációs adatok eltávolítása az egyéb erőforrásokból tlcreset bővítése “resetPin” paraméterrel “consumerURL” paraméter átnevezése “consumerUrl”-re Nem használt válaszkódok törlése Detektor adat összesítés átállítása 1 percről 15 percre NodeStates eltávolítása az OperationalStateData-ból tlcreset parancs részletes dokumentáció hozzáadása o
1.9
15.09.2014
1.9 A02
17.12.2014
1.3 Kapcsolódó dokumentumok Az alább felsorolt dokumentumokban további és részletes a témához információ található: 1. muszaki_specifikacio_javitott_korrektúrás.pdf - Műszaki specifikáció „Szállítási szerződés forgalomirányító rendszer korszerűsítésére” tárgyú közösségi, hirdetménnyel induló tárgyalásos közbeszerzési eljárásban 2. JTR_protokoll_v6_hu_20140612.pdf - JTR nyitott protokoll - A követelmények megfogalmazása
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 4/15
SWARCO TRAFFIC SYSTEMS GMBH
2 Alapvető előfeltételek Az egynél több központi rendszer és számos forgalomirányító berendezés közötti szinkron és aszinkron kommunikáció előfeltételei a következőek: 1. Minden forgalomirányító berendezéshez egyedi, statikus Internet Protocol (IP) cím legyen beállítva. 2. Minden résztvevőnek képesnek kell lennie Domain Name Server (DNS) implementálására, hogy képes legyen a forgalomirányító berendezések egyedi azonosítóját (Uniform Identifying Name [UIN – lásd Hiba! A hivatkozási forrás nem alálható. Komponens kapcsolatok fejezet]) azok statikus IP címének megfeleltetni. 3. A forgalomirányító berendezések saját órájukat Network Time Protocol (NTP) idő szinkronizáció szolgáltatás segítségével folyamatosan pontosan tartják.
3 Kommunikációs protokoll A felhasznált kommunikációs protokoll a Hypertext Transfer Protocol (HTTP). A HTTP egy, az alkalmazás rétegben megvalósított protokoll, mely adatok hálózaton keresztüli továbbítására szolgál. A HTTP-t leíró szabványokat az Internet Engineering Task Force (IETF) és a World Wide Web Consortium (W3C) koordinálja. A HTTP a http://tools.ietf.org/html/rfc2616. weblapon került specifikálásra: Azt, hogy a HTTP protokoll miként van felhasználva jelen kontextusban, azt következő, 4 Komponens kapcsolatok fejezet tárgyalja.
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 5/15
SWARCO TRAFFIC SYSTEMS GMBH
4 Komponens kapcsolatok Ebben a fejezetben felsoroljuk a http metódusokat, melyeket különböző erőforrások hálózati elérése céljából meg lehet hívni. A forgalomirányító berendezést (FB) az UIN(Uniform Identifying Name) azonosítja. Ez tartalmazza az FB azonosítót, a központ azonosítót és a domain nevet. Példa UIN: c023.cci1.kozut.local. Néhány metódus megfelelő működéséhez paramétereket is meg kell adni. Minden egyes lekérdezéshez a megfelelő http válasz kódot kell visszaadni. Igény esetén a FB automatikus esemény küldésre is felkonfigurálható. Ehhez először a jövőbeli esemény felhasználónak fel kell konfigurálnia azt az URL-t, ahova a FB-nek az eseményeket el kell küldenie. Az 5.3 és 5.4 fejezet tárgyalja az események következményeként elküldendő adatokat. Adat objektumok tömbjének (egyszerre több elemének) lekérdezéséhez a startPosition, startTimeStamp és maxCount paramétereket kell megadni. A startPosition az időbeli lépésekhez használható. A startTimestamp-et akkor kell használni, ha startPosition érvénytelen, illetve ismeretlen. Amennyiben a megadott startPosition érvénytelen, úgy az első startTimeStamp után megtalált bejegyzés lesz az első eleme a visszaadott tömbnek/tartománynak. Amennyiben a startTimeStamp és a startPosition is érvényes egy bejegyzésre, úgy a következő bejegyzést kell visszaküldeni elsőként. Minden időt reprezentáló paramétert UTC (Coordinated Universal Time) szerint kell megadni, ami az 1970.01.01 00:00:00-tól eltelt másodpercek számát jelenti. A forgalmazott adatok konzisztensek az 5 Komponensek fejezetben kifejtett adatstruktúrákkal. HTTPművelet
GET
GET
GET
GET
URN (Uniform Resource name)
UIN/signalstate
Leírás Visszaad maxCount darab jelzésterv rekordot a startPosition és startTimeStamp paraméterek alapján
HTTP válasz kódok
Paraméterek
Válasz adattípus
startPosition
200, 204, 401, 500
startTimeStamp SignalStateData maxCount [fullData]
Visszaad maxCount darab detektor mérési adatot a startPosition and startTimeStamp paraméterek alapján
200, 204, 401, 500
UIN/status
Visszaadja a FB aktuális általános állapotát
200, 204, 401, 500
DeviceStatus
UIN/operationalstate
Visszaadja a FB aktuális üzemi állapotát
200, 204, 401, 500
OperationalStateD ata az aktuális NodeStateData adattípusokkal minden részcsomópontra
UIN/detectorreading
SWARCO TRAFFIC SYSTEMS GMBH
startPosition startTimeStamp
DetectorReadingDa ta
maxCount
MK JTR protokoll V1.9 A02
30.01.2015 6/15
SWARCO TRAFFIC SYSTEMS GMBH
GET
GET
HEAD
UIN/operationalstate
UIN/message
UIN/allok
Visszaad maxCount darab üzemi állapot rekordot a startPosition és startTimeStamp paraméterek alapján Visszaad maxCount darab hibaüzenet rekordot a startPosition és startTimeStamp paraméterek alapján Visszaad egy csak http fejlécet tartalmazó választ http válaszkóddal és időbélyeggel.
startPosition 200, 204, 401, 500
startTimeStamp maxCount
OperationalStateD ata a visszamenőleges NodeStateData adattípusokkal minden részcsomópontra
startPosition 200, 204, 401, 500
startTimeStamp
MessageData
maxCount
200, 500 nodeId
PUT
UIN/switchcommand
Kapcsolási kérés leküldése a FB-nek
200, 400, 401, 403, 500
requestType signalTimingPla nId
UIN/tlcreset/
Hibatörlés kérés leküldése a FB-nek
400, 401, 403, 500
resetPin
PUT
UIN/registereventurl
Beállítja az URLt, ahová az események elküldésre kerülnek. Üres URL megadása törli az előzőleg beállított URL értéket. Ekkor az éppen törölt URLre egy figyelmeztető üzenet kerül elküldésre.
200, 400, 401, 403, 500
consumerUrl
GET
UIN/version
Karakterláncként visszaadja a használt protokoll verziószámát
200, 500
ProtocolVersion
GET
UIN/configuration
Visszaadja a FB konfigurációs adatait
200, 204, 401, 500
Configuration
PUT
1. Táblázat: Komponens kapcsolatok Ez a táblázat összefoglalja, hogy melyik metódushívás milyen választ eredményez az adott erőforráson a megadott paraméterek használata esetén. A metódushívások http kérések.
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 7/15
SWARCO TRAFFIC SYSTEMS GMBH
5 Komponensek A következőkben a 4. fejezetben is hivatkozott adattípusokat soroljuk fel. Az alább felsorolt összes adattípus esetén megvalósul a több csomópontot kezelő gép támogatása. Egy FB kezelhet több részcsomópontot. Mivel minden részcsomópontnak külön jelzéstervei, jelzőcsoportjai és digitális kimenetei vannak, a részcsomópontok képesek egymástól függetlenül különböző jelzésterveket futtatni. Minden időt reprezentáló paramétert UTC (Coordinated Universal Time) szerint kell megadni, ami az 1970.01.01 00:00:00-tól eltelt másodpercek számát jelenti. A bekövetkező események elküldése az előzetesen regisztrált URL-re történik. Az esemény maga is egy URL, amely a változást leíró komponensre mutat. Pl. hibaállapot-változás esetén az előzetesen regisztrált URL-re a DeviceStatus (ld. 5.3 alfejezet) komponensre mutató URL (http://UIN/status) kerül elküldésre.
5.1 Érzékelő adatok (DetectorReadingData) A DetectorReadingData adattípus olyan detektorokon gyűjtött adatokat tartalmaz, mint a százalékban kifejezett foglaltság illetve az óránként mért járműszám. A gyűjtött adatok 15 perces felbontásban kérdezhetők le. Adattípus
Leírás
DetectorReadingData endPosition endTimestamp data o timeStamp o
detectorReadings detectorId occupancy (%)
SWARCO TRAFFIC SYSTEMS GMBH
vehiclesPerHour
Az utolsó visszaküldött adat pozíciója Az utolsó visszaküldött adat időbélyege Mérési periódusok tömbje A mérési periódus időbélyege, amely a 15 perces periódus végét jelzi. Detektor mérési adatok tömbje. Detektorazonosító. Százalékos foglaltság a detektoron (60 mp-es mérési intervallumok átlaga). A detektoron mért járműszám (60 mp-es mérési intervallumok átlaga 1 órás intervallumra normalizálva).
MK JTR protokoll V1.9 A02
30.01.2015 8/15
SWARCO TRAFFIC SYSTEMS GMBH
5.2 JCS és detektor állapot (SignalStateData) A SignalStateData adattípus a jelzőcsoportok, detektorok és digitális kimenetek állapotát (ha a lekérdezés fullData paraméterrel történt) illetve állapotváltozását (fullData paraméter nélkül) tartalmazza másodperces felbontásban. Adattípusok
Leírás
SignalStateData endPosition endTimestamp signalStates timeStamp signalGroupStates o nodeId o signalGroupId o redState CONTINUOUS, FLASHING, DARK
Az utolsó visszaküldött adat pozíciója Az utolsó visszaküldött adat időbélyege Másodperces jelzésterv adatok tömbje Másodperces jelzésterv adat időbélyege Jelzőcsoport állapotok tömbje Részcsomópont azonosító Jelzőcsoport azonosító Piros jelző állapota: CONTINUOUS=folyamatosan bekapcsolt DARK=folyamatosan kikapcsolt FLASHING=villog
o
amberState CONTINUOUS, FLASHING, DARK
Sárga jelző állapota: CONTINUOUS=folyamatosan bekapcsolt DARK=folyamatosan kikapcsolt FLASHING=villog
o
greenState CONTINUOUS, FLASHING, DARK
Zöld jelző állapota: CONTINUOUS=folyamatosan bekapcsolt DARK=folyamatosan kikapcsolt FLASHING=villog
digitalOutputStates
o o o
nodeId digitalOutputId state ON, OFF
detectorStates o detectorId o state OCCUPIED, FREE
nodeStates o nodeId o signalTimingPlanId o cycleCounter o phase o phaseCounter o phaseTransition
SWARCO TRAFFIC SYSTEMS GMBH
Digitális kimenetek állapotának tömbje. Ide tartozik minden olyan kimenet, amely nem vezérel jelzőcsoportot (pl. gyalogos nyomógomb visszajelző, hangosbeszélő stb.) Részcsomópont azonosító Digitális kimenet azonosító Digitális kimenet állapota: ON=bekapcsolt OFF=kikapcsolt Detektorok állapotának tömbje. Detektorazonosító Detektor aktuális állapota: OCCUPIED=foglalt FREE=szabad Részcsomópontok állapotának tömbje. Részcsomópont azonosítója Jelzésterv száma Ciklusszámláló értéke Aktuális fázis száma Fázisszámláló értéke Aktuális fázisátmenet száma
MK JTR protokoll V1.9 A02
30.01.2015 9/15
SWARCO TRAFFIC SYSTEMS GMBH
5.3 Berendezés állapot (DeviceStatus) A DeviceStatus adattípus a FB általános állapotának leírását tartalmazza, az üzemszerű működést érintő illetve részcsomópont specifikus adatok nélkül. Ezen adatok leírását az 5.4 OperationalStateData alfejezet tartalmazza. Adattípusok
Leírás
DeviceStatus currentTime timeSource o QUARTZ_CLOCK, COMMAND_CENTER, RADIO_CLOCK, OTHER
doorOpen o true, false
powerSupplyVoltageOK o true, false
persistenceStorageOK o true, false
defectSignals o signalHeadSectionId
o
o
signalHead id name signalGroup
o
id name nodeId
defectDetectors o id o name asynchronousNodes
o
nodeId
nextSignalTimingPlanState
o o o
nodeId signalTimingPlanId time
SWARCO TRAFFIC SYSTEMS GMBH
A FB aktuális rendszerideje (UTC) A FB rendszeridő forrása: QUARTZ_CLOCK: Belső óra COMMAND_CENTER: Hálózati időforrás (NTP) RADIO_CLOCK: GPS vagy DCF77 OTHER: egyéb FB ajtónyitás érzékelő állapota. o true: nyitva o false: zárva FB tápfeszültség rendben. o true: rendben o false: nincs rendben FB háttértároló egység rendben. o true: rendben o false: nincs rendben Hibás jelzőfejek tömbje. Hibás jelzőfej azonosítója: 0 = piros 1 = sárga 2 = zöld Hibás jelzőfej adatai. Hibás jelzőfej azonosítója. Hibás jelzőfej neve. Hibás jelzőfejhez tartozó jelzőcsoport adatai. Jelzőcsoport azonosítója. Jelzőcsoport neve Hibás jelzőfejhez tartozó részcsomópont azonosítója. Hibás detektorok tömbje. Hibás detektor csatorna száma Hibás detektor neve Hangolásból kiesett részcsomópontok tömbje. Tartalmazza mindazon részcsomópontokat, ahol a hangolt állapottól való eltérés nagyobb, mint 3 mp és az eltérés több mint 10 percig fennáll. Hangolásból kiesett részcsomópont azonosítója Az aktuális PVO szerint következő jelzésterv-váltások tömbje. A tömb elemei az egyes részcsomópontokra érvényes váltások. (A visszaadott adatok csak helyi üzemmód esetén érvényesek.) Részcsomópont azonosítója A következő jelzésterv száma A váltás időpontja (UTC)
MK JTR protokoll V1.9 A02
30.01.2015 10/15
SWARCO TRAFFIC SYSTEMS GMBH
5.4 Csomópont állapot (OperationalStateData) Az OperationalStateData adattípus információkat nyújt a különféle részcsomópont specifikus paraméterek és konfigurációs adatok aktuális állapotáról. Kétfajta lekérdezése lehetséges. Az első – paraméterek nélküli – változat az összes részcsomópont aktuális állapotát adja vissza. Ebben az esetben a visszaadott endPosition illetve endTimestamp paraméterek -1 értéket vesznek fel, míg a timeStamp paraméterek minden részcsomópont esetén a FB aktuális rendszeridejének időbélyegét kapják. A második változat szerint a lekérdezés tartalmazza a startPosition, startTimeStamp illetve maxCount paramétereket. A visszaadott adat ekkor a részcsomópont állapotok tömbje, a megadott paramétereknek megfelelően. Adattípusok
Leírás
OperationalStateData endPosition endTimestamp nodeStateData o timeStamp o nodeId o nodeOnOff ON, AMBER_FLASHING, DARK
Az utolsó visszaküldött adat pozíciója Az utolsó visszaküldött adat időbélyege A részcsomópont állapotok tömbje A részcsomópont állapot időbélyege A részcsomópont azonosítója ON: a részcsomópont normál üzemben van AMBER_FLASHING: a részcsomópont sárga villogó üzemben van DARK: a részcsomópont sötét üzemben van
o
nodeFault
NO_FAULT, SIMPLE_FAULT, SHUTDOWN, PARTIAL_SHUTDOWN, INTERNAL_FAULT
Részcsomópont hiba NO_FAULT: nincs hiba SIMPLE_FAULT: legalább egy hiba van, de a csomópont működik. SHUTDOWN: legalább egy lekapcsolással járó hiba van. PARTIAL_SHUTDOWN: legalább egy olyan hiba van, amely részleges lekapcsolással jár INTERNAL_FAULT: belső kommunikációs hiba van a FB egységei között
o o
currentSignalTimingPlanId operationalMode
SWARCO TRAFFIC SYSTEMS GMBH
A futó jelzésterv száma Üzemmód
MK JTR protokoll V1.9 A02
30.01.2015 11/15
SWARCO TRAFFIC SYSTEMS GMBH
SPECIAL, HANDLATCH, LOCALFIX, LOCALCLOCK, LOCALTA, CENTRAL, HURRY_UP, JTR, JTR_LOCALCLOCK, JTR_LOCALTA
SPECIAL: különleges, más kategóriába nem sorolható (pl. helyszíni karbantartás), vagy egyéb ismeretlen üzemmód. HANDLATCH: kézi léptetéses üzemmód (pl. rendőr). LOCALFIX: Kézi programválasztás (kezelőpanelen) LOCALCLOCK: Helyi programválasztó óra szerinti (PVO) üzemmód. LOCALTA: Helyi forgalomfüggő üzemmód CENTRAL: Központ (kivéve JTR) által választott program. JTR: JTR központ által választott program. A JTR által küldött parancs minden más központnál nagyobb prioritású. JTR_LOCALCLOCK: JTR által választott helyi PVO üzemmód. JTR_LOCALTA: JTR által választott helyi forgalomfüggő üzemmód. HURRY_UP: vasúti, tűzoltó vagy egyéb magasan priorizált üzemmód.
o
desiredMode true false
SWARCO TRAFFIC SYSTEMS GMBH
A csomópont az előírt üzemmódban fut. true: az előírt üzemmódban fut false: nem az előírt üzemmódban fut
MK JTR protokoll V1.9 A02
30.01.2015 12/15
SWARCO TRAFFIC SYSTEMS GMBH
5.5 Hibaüzenetek (MessageData) A MessageData típus a hibaüzenetet kiegészíti a hiba súlyosságára illetve típusára vonatkozó adatokkal. Az üzenetek szövege magyar nyelvű. Az alább felsorolt események eredményeznek hibaüzenetet: bármilyen szoftver vagy hardver hiba a FB-ben detektorhiba részcsomópont hangolásból kiesik FB ajtónyitás / zárás hibás jelzőfej (túlfogyasztás, hamis feszültség, kiégés). Jelzőfej hibák esetén a hibás fej azonosítója. Adattípusok
Leírás
MessageData endPosition endTimestamp messages o timeStamp o messageText o severity INFO WARNING ERROR SEVERE o category Other DeviceHardware PlanedSignalStateViolation SignalStateFault TrafficApplication Communication OperationSystem Firmware Supply Clock Detectors OperationalState
o
subMessages messageText severity
SWARCO TRAFFIC SYSTEMS GMBH
category
Az utolsó visszaküldött adat pozíciója Az utolsó visszaküldött adat időbélyege Hibaüzenetek tömbje Hibaüzenet időbélyege A magyar nyelvű hibaüzenet A hiba súlyossága: INFO: csak információ WARNING: figyelmeztetés ERROR: hiba SEVERE: súlyos hiba A hiba típusa: Other: egyéb hiba DeviceHardware: hardver hiba PlanedSignalStateViol ation: ürítési idő ill. minimálzöld-hiba SignalStateFault: tiltás hiba TrafficApplication: egyéb forgalomtechnikai hiba Communication: kommunikációs hiba OperationSystem: operációs rendszer hiba Firmware: firmware hiba Supply: feltöltési hiba Clock: óra ill. időforrás hibája Detectors: detektorhiba OperationalState: egyéb hiba Csatolt hibaüzenetek tömbje A magyar nyelvű csatolt hibaüzenet A csatolt hiba súlyossága (ld. fent) A csatolt hiba típusa (ld. fent)
MK JTR protokoll V1.9 A02
30.01.2015 13/15
SWARCO TRAFFIC SYSTEMS GMBH
5.6 Berendezés konfiguráció (Configuration) A Configuration adattípus információt ad a részcsomópontok, jelzőcsoportok, jelzőfejek, digitális kimenetek, jelzéstervek illetve detektorok konfigurációjáról. Adattípusok
Leírás
Configuration nodes o id o name o signalGroups
o
id name elements id name digitalOutputs
o
id name signalTimingPlans
id name
detectors o id o name
Részcsomópontok konfigurációs adatai Részcsomópont azonosító Részcsomópont neve A részcsomóponthoz tartozó jelzőcsoportok konfigurációs adatai Jelzőcsoport azonosító Jelzőcsoport neve A jelzőcsoporthoz tartozó jelzőfejek adatai Jelzőfej azonosító Jelzőfej neve A részcsomóponthoz tartozó digitális kimenetek konfigurációs adatai A digitális kimenet azonosítója A digitális kimenet neve A részcsomóponthoz tartozó jelzéstervek konfigurációs adatai A jelzésterv száma A jelzésterv neve A FB detektorainak konfigurációs adatai Detektorazonosító Detektor neve
5.6.1 Detektor elnevezési szabály A detektorok csomóponthoz rendelését a detektor név 1. karaktere alapján dönti el a rendszer. A rendszer maximálisan 3 részcsomópontot kezel. Amennyiben a detektor név első karaktere nem „1”,”2”, vagy „3”, akkor az adott detektor az első csomóponthoz lesz rendelve. Példák: -
1_D2: 1. csomópont D2 érzékelő
-
2_D3: 2. csomópont D3 érzékelő
-
3_D5: 3. csomópont D5 érzékelő
-
4_D1: 1. csomópont 4_D1 érzékelő
-
D1:
1. csomópont D1 érzékelő
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 14/15
SWARCO TRAFFIC SYSTEMS GMBH
5.7 Üzemmódváltás (SwitchCommand) A SwitchCommand adattípus tartalmazza az automatikus, illetve kézi jelzésterv, vagy üzemmód váltás paramétereit: nodeId - a kapcsolandó részcsomópont azonosítója requestType o LOCALCLOCK – helyi programválasztó óra szerinti üzemmód automatikus kapcsolása o LOCALTA – helyi forgalomfüggő üzemmód automatikus kapcsolása o SIGNAL_TIMING_PLAN – adott jelzésterv automatikus kapcsolása o AMBER_FLASHING – sárga villogó üzemmód automatikus kapcsolása o DARK – sötét üzemmód automatikus kapcsolása o NONE – a JTR-ből indított kapcsolási kérés törlése o AUTO – a részcsomópont előírt üzemmódra kapcsolása (a JTR-ből indított kapcsolási kérések, illetve egyéb kézi kapcsolások törlése) o LOCALCLOCK_MAN – helyi programválasztó óra szerinti üzemmód kézi kapcsolása o LOCALTA_MAN – helyi forgalomfüggő üzemmód kézi kapcsolása o SIGNAL_TIMING_PLAN_MAN – adott jelzésterv kézi kapcsolása o AMBER_FLASHING_MAN – sárga villogó üzemmód kézi kapcsolása o DARK_MAN – sötét üzemmód kézi kapcsolása signalTimingPlanId – a kapcsolandó jelzésterv száma (csak SIGNAL_TIMING_PLAN és SIGNAL_TIMING_PLAN_MAN esetén).
5.8 Események (Event) Egy Event akkor kerül elküldésre, ha a FB állapota megváltozik, vagy új hibaüzenet áll rendelkezésre. Adattípusok
Leírás
Event
URL
Az eseménytől függően az OperationalStateData vagy a MessageData.URL-je.
5.9 Hibatörlés (TlcReset) A hibatörlés funkciót csak akkor szabad végrehajtani, ha az eszköz, vagy valamely részcsomópontja hiba állapotban van. Ha a hibatörlés nem hajtható végre, vagy a biztonságos végrehajtás valamely feltétele nem adott, úgy 403-as http válaszkódot kell adni. A resetPin opcionális paraméter egy a berendezésben előre beállított PIN kód (jelszó), melynek meg kell egyezni a kapott jelszóval. A hibatörlés csak megfelelő jelszó esetén hajtható végre, hibás jelszó esetén 401-es http válaszkódot kell adni. A berendezésnek képesnek kell lennie PIN kód nélküli működésre is. Amennyiben a berendezésben nincs definiált PIN kód, úgy a resetPin paraméter értékét figyelmen kívül kell hagynia.
SWARCO TRAFFIC SYSTEMS GMBH
MK JTR protokoll V1.9 A02
30.01.2015 15/15