MK JTR protokoll V1.9 A02 WEB API a forgalomirányító berendezések távfelügyeletéhez SWARCO TRAFFIC SYSTEMS GMBH

SWARCO TRAFFIC SYSTEMS GMBH

MK JTR protokoll V1.9 A02 WEB API a forgalomirányító berendezések távfelügyeletéhez


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


MK JTR protokoll V1.9 A02

30.01.2015 2/15


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



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



30.01.2015 4/15


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.



30.01.2015 5/15


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


startPosition startTimeStamp

DetectorReadingDa ta

maxCount


30.01.2015 6/15


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.



30.01.2015 7/15


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 (%) 


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).


30.01.2015 8/15


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


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


30.01.2015 9/15


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


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)


30.01.2015 10/15


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


A futó jelzésterv száma Üzemmód


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


A csomópont az előírt üzemmódban fut.  true: az előírt üzemmódban fut  false: nem az előírt üzemmódban fut


30.01.2015 12/15


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 


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)


30.01.2015 13/15


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ő

-


-


-

4_D1: 1. csomópont 4_D1 érzékelő

-

D1:

1. csomópont D1 érzékelő



30.01.2015 14/15


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.



30.01.2015 15/15

MK JTR protokoll V1.9 A02 WEB API a forgalomirányító berendezések távfelügyeletéhez SWARCO TRAFFIC SYSTEMS GMBH

Recommend Documents