UniLock System 10 Manual til Pollerens web-server interface Software PCS125 Version 1.0 Revision 090513 Polleren har indbygget en web-server, der stiller en række funktioner og data til rådighed for eksterne programmer. Dette muliggør driftsovervågning og fjernkontrol fx via en browser. Via Pollerens web-server kan der løbende hentes aktuel status for døre, DAS, tyverialarmer, indgange og udgange. Ligeledes kan døre og tyverialarmer fjernkontrolleres. SCADAsystemer, browsere mv. kan let kommunikere med web-serveren, da der anvendes standard XML og HTML-kommunikation. 090513-1356 Copyright 2006-2009 by UNITEK
- 2 - PCS125 Ver.: 1.0 Rev.: 090512 Indholdsfortegnelse 1. Beskrivelse... 3 1.1 Systemintegration...3 1.2 Lokalt netværk eller internet...3 2. Login i web-server... 4 2.1 Indbygget login hjemmeside...4 2.2 Login fra eksternt program...4 3. Web-server input... 5 4. Web-server output... 6
Unitek software - 3-1. Beskrivelse Polleren har indbygget en web-server, der stiller en række funktioner og data til rådighed for eksterne programmer. Dette muliggør driftsovervågning og fjernkontrol af en række funktioner fx via en browser. 1.1 Systemintegration Via Pollerens web-server kan man løbende hente aktuel status for døre, DAS, tyverialarmer, indgange og udgange ligeledes kan døre og tyverialarmer fjernkontrolleres. SCADA systemer, browsere mv. kan let kommunikere med web-serveren, da der anvendes standard XML og HTML- kommunikation. 1.2 Lokalt netværk eller internet For at sikre optimal sikkerhed kan web-serveren konfigureres, så den kun kan tilgås fra det lokale pc-netværk og/eller fra internet, og ligeledes kan rettigheder og adgangskriterier være forskellige.
- 4 - PCS125 Ver.: 1.0 Rev.: 090512 2. Login i web-server Web-serveren kan indstilles således at den først udleverer data / udfører funktioner efter at en operatør er logget ind. Den aktuelle rettighed vælges i UniLock Adgangseditoren [Opsætning], [Indstillinger], [Programindstillinger], [Web kontrol], hvor der er tre mulige indstillinger 1. Der skal altid logges ind 2. Tillad visning uden login 3. Tillad visning og ændringer uden login Alle de operatører, der kan logge ind i Adgangseditoren, kan også logge ind i web-serveren. 2.1 Indbygget login hjemmeside Web-serveren her en indbygget login hjemmeside, som hentes med webbrowseren via følgende url: http://[pollerens IP-adresse]/LoginPage.egi Anvendes web-serverens indbyggede Web kontrol, sender web-serveren automatisk den integrerede login hjemmesiden til operatørens webbrowser, hvis login er påkrævet. 2.2 Login fra eksternt program Ønsker man at logge ind i web-serveren fra et eksternt program, som fx et SCADA system, skal nedenstående html form udfyldes med korrekt login data og sendes til web-serveren. <form action='logins.egi' method='post' ID='Form1' > <input type='hidden' name='came_from' value='' ID='Hidden1'/> <table border=0 cellspacing='10px'> <tr> <td width='35px'></td> <td> <b><label for='ac_name'>login navn </label></b></td> <td><input type='' size='15' tabindex='1' name='ac_name' value='' id='ac_name'></td> <td width='35px'></td> </tr> <tr> <td width='35px'></td> <td> <b><label for='ac_password'>adgangskode </label> </b> </td> <td> <input type='password' size='15' tabindex='2' name='ac_password' id='ac_password'></td> <td width='35px'></td> </tr> <tr > <td colspan=4 height="50px" valign="bottom" align="center"><input tabindex='3' type='submit' name='submit' value='log ind' ID='Submit1' class='inputbutton'/></td> </tr> </table> </form>
Unitek software - 5-3. Web-server input Web-serveren kan modtage input fra eksterne programmer, som kan anvendes til at skifte status på døre og tyverialarmer fra webbrowser, SCADA system mv. SCADA systemer mv. kan direkte sende input til web-serverens indbyggede funktion til styring. Kræves der login til at udføre ændringer i web-serveren, skal der være logget ind før web-serveren modtager input. Web-serverens funktion til at skifte status anvendes på følgende måde: http://[pollerens IP-adresse]/KPunktFunc.egi?ID=[xxxx]:[Funktion]:PRef=KPunkt.html ID Funktion PRef Firecifret ID på det k-punkt, som skal fjernkontrolleres. Funktion i web-serverens indbyggede KPunktFunc.egi script. Den indbyggede hjemmeside i web-serveren, der skal returneres til efter at funktionen er udført. Er PRef ikke angivet sender serveren automatisk Web kontrol hjemmesiden. Oplås/lås dør Funktionen oplåser døren i døroplåsningstid, hvorefter døren automatisk låses uanset det aktuelle sikkerhedsniveau. Funktionen kan altså anvendes til både at oplåse og låse døren. Eksempel som oplåser døren i k-punktet med ID 1001 i døroplåsningstiden, hvorefter døren automatisk låses: http://[pollerens IP-adresse]/KPunktFunc.egi?ID=1001:UnLock:PRef=K-Punkt-oversigt.egi DAS frakobling Funktionen frakobler DAS (Decentral Alarm Styring) i det angivne k-punkt. Er det angivne k- punkt del af en DAS-gruppe frakobles denne. Eksempel som frakobler DAS i k-punktet med ID 1001: http://[pollerens IP-adresse]/KPunktFunc.egi?ID=1001:UnArm:PRef=K-Punkt-oversigt.egi DAS tilkobling Funktionen tilkobler DAS (Decentral Alarm Styring) i det angivne k-punkt. Er det angivne k- punkt del af en DAS-gruppe tilkobles denne. Eksempel som tilkobler DAS i k-punktet med ID 1001: http://[pollerens IP-adresse]/KPunktFunc.egi?ID=1001:Arm:PRef=K-Punkt-oversigt.egi DAS tilkobling tidsforskudt Funktionen tilkobler DAS (Decentral Alarm Styring) på det angivne tidspunkt i det angivne k-punkt. Er det angivne k-punkt del af en DAS-gruppe tilkobles denne. Eksempel som tilkobler DAS kl. 22:10 i k-punktet med ID 1001: http://[pollerens IP-adresse]/KPunktFunc.egi?ID=1001:TimedArm:Tid=22:10:PRef=K- Punkt-oversigt.egi
- 6 - PCS125 Ver.: 1.0 Rev.: 090512 4. Web-server output Via Pollerens web-server kan der løbende hentes aktuel status for døre, DAS, tyverialarmer, indgange og udgange. Aktuel status er skrevet i XML dokumenter, som web-serveren returnerer, når en af de indbyggede funktioner aktiveres via HTML. Løbende status kan altså hentes fra SCADA systemer, webbrowsere mv. ved løbende at sende kommandoer via HTML til web-serveren. Kræves der login til at hente status fra web-serveren, skal der være logget ind før webserveren sender output. Med UniLock programmet følger et yderst relevant eksempel på grafisk overvågning på basis af en bygningstegning, som viser hvordan en kundespecifik hjemmeside kan kommunikere med Pollerens web-server. Driftsinformationer for installationen Dette XML dokument indeholder driftsinformationer for døre, DAS og tyverialarmer. Installationens aktuelle status er skrevet i et XML dokument, som web-serveren returnerer når følgende kommando sendes: http://[ Pollerens IP-adresse]/K-Punkts.egi?ID=-1. Nedenstående er et eksempel på et XML dokument med aktuel status, der er returneret fra web-serveren. <?xml version="1.0" encoding="iso-8859-1"?> <?xml-stylesheet type='/css' href='blank.css'?> <DASRoot> <DASGruppe> <kpid>1002</kpid> <navn>kontorfløj og vestfløj</navn> <DelayAllowed>1</DelayAllowed> <status>das er tilkoblet</status> <personer>xxx</personer> <DAS>0</DAS> <tyverialarm>2</tyverialarm> <KPunkter> <KP st="on-line" laas="dør låst" id="1002" sv="dør lukket" login="1"> <navn>indgang vest</navn> </KP> <KP st="on-line" laas="dør låst" id="1004" sv="dør lukket" login="1"> <navn>kontorfløj</navn> </KP> </KPunkter> </DASGruppe> <LokalDAS> <id>1005</id> <navn>værksted</navn> <DelayAllowed>1</DelayAllowed> <status>das er tilkoblet</status> <personer>xxx</personer> <DAS>0</DAS> <tyverialarm>2</tyverialarm> <KPunkter> <KP st="on-line" laas="dør låst" id="1005" sv="dør lukket" login="1"> <navn>værksted</navn> </KP> </KPunkter> </LokalDAS> <NoDAS> <KPunkter> <KP st="on-line" laas="dør låst" id="1001" sv="ingen overvågning af dør" login="1"> <navn>hovedindgang</navn>
Unitek software - 7 - </KP> </KPunkter> </NoDAS> </DASRoot> XML dokumentet indeholder en række XML tags, hvis betydning og mulige værdier er beskrevet i det nedenstående. XML tag Beskrivelse Data værdier XML Type DASRoot Start tag for dokumentet - element DASGruppe Start tag for DAS gruppe - element kpid Firecifret ID for første fx 1002 k-punkt i DAS-gruppen navn Navn for DAS gruppen fx Kontorfløj og vestfløj DelayAllowed Tidsforskudt tilkobling ikke tilladt 0 Tidsforskudt tilkobling tilladt 1 status Status for DAS gruppen DAS er tilkoblet DAS er frakoblet Prealarm udløber om mm:ss LS10 software understøtter Ny funktion i LS10 ikke DAS-grupper. efter 2005-09-28 personer Tilkobler ikke ved tomt område xxx Tilkobler når området er tomt. Der 5 er fem personer i området DAS DAS er tilkoblet 0 DAS er frakoblet 1 tyverialarm Tyverialarm er tilkoblet 0 Tyverialarm er frakoblet 1 Ingen tilbagemelding fra tyverialarm 2 KPunkter Start tag for k-punkter i DAS-gruppen - element KP Start tag for k-punkt - element st Status for k-punkt On-line value Off-line value laas Status for dørlås Dør oplåst value Dør låst value id ID for k-punkt fx 1001 value sv Status for overvågning af dør Dør lukket value Dør åben value Alarm dør ikke lukket value Ingen overvågning af dør value login Tag låst til fremtidig brug 1 value navn Navn på k-punkt fx Indgang vest tekst LokalDAS Start tag for k-punkter med lokal DAS - element id ID for k-punkt med denne lokal DAS fx 1005 NoDAS Start tag for k-punkt uden DAS - element
- 8 - PCS125 Ver.: 1.0 Rev.: 090512 Driftsinformationer for k-punkt Dette XML dokument indeholder en række detaljerede driftsinformationer for et k-punkt. K-punktets aktuelle status er skrevet i et XML dokument, som web-serveren returnerer når følgende kommando sendes: http://[ Pollerens IP-adresse]/K-PunktData.egi?ID=[k-punkt ID]. [k-punkt ID] er fire-cifret ID på det k-punkt man ønsker at hente driftsinformationer fra. Nedenstående er et eksempel på et XML dokument med aktuel status, der er returneret fra web-serveren. <?xml version="1.0" encoding="iso-8859-1"?> <?xml-stylesheet type='/css' href='blank.css'?> <K-Info> <KPunkt> <KName>Hovedindgang</KName> <LIDNumber>1001</LIDNumber> <Status State="1">On-line</Status> <GoneOnline>27-04-2009 11:35:34</GoneOnline> <KPunktCheckTime>27-04-2009 11:36:17</KPunktCheckTime> <NumberOfLogs>0</NumberOfLogs> <MaxNumberOfLogs>467</MaxNumberOfLogs> <NumberOfKeys>15</NumberOfKeys> <MaxNumberOfKeys>2000</MaxNumberOfKeys> <DoorOpenTime>10</DoorOpenTime> <SecurityLevelTimeTable>1 Alle hovedindgange</securityleveltimetable> <DefaultSecurityLevel>3.0</DefaultSecurityLevel> <PinCodeKeypadExists>ja</PinCodeKeypadExists> <CommonPINCode>5057</CommonPINCode> <KPunktSoftware>NIS101-1.2 060203 PAL=02</KPunktSoftware> <KPunktTime>27-04-2009 11:36:16</KPunktTime> <CurrentSpecialDay>0</CurrentSpecialDay> <CurrentSecurityLevel>0.1</CurrentSecurityLevel> <ChecksumDrift State="1">020D (Ok)</ChecksumDrift> <ChecksumKeys State="1">1D91 (Ok)</ChecksumKeys> <ChecksumSecurityLevelTimeTable State="1">053E (Ok)</ChecksumSecurityLevelTimeTable> <ChecksumTimetableAndSpecialdayCalendar State="1">0B9F (Ok)</ChecksumTimetableAndSpecialdayCalendar> <Updateded>Opdateret: 27-04-2009 11:36:20</Updateded> <OUT_1 State="0">Dør</OUT_1> <OUT_2 State="0">Lydgiver</OUT_2> <OUT_3 State="0">Alarmforbikobling</OUT_3> <OUT_4 State="0">Alarm-udgang</OUT_4> <OUT_5 State="0"></OUT_5> <OUT_6 State="0"></OUT_6> <OUT_7 State="1"></OUT_7> <OUT_8 State="1"></OUT_8> <IN_1 State="0"> Åbningstryk lav </IN_1> <IN_1_CNT> 6 </IN_1_CNT> <IN_2 State="0"> Karmkontakt lav </IN_2> <IN_2_CNT> 21 </IN_2_CNT> <IN_3 State="0"></IN_3> <IN_3_CNT> 0 </IN_3_CNT> <IN_4 State="0"></IN_4> <IN_4_CNT> 0 </IN_4_CNT> <IN_5 State="0"></IN_5> <IN_5_CNT> 0 </IN_5_CNT> <IN_6 State="0"></IN_6> <IN_6_CNT> 0 </IN_6_CNT> <IN_7 State="0"></IN_7> <IN_7_CNT> 0 </IN_7_CNT> <IN_8 State="0"></IN_8> <IN_8_CNT> 0 </IN_8_CNT> </KPunkt> </K-Info>
Unitek software - 9 - XML dokumentet indeholder en række XML tags, hvis betydning og mulige værdier er beskrevet i det nedenstående. XML tag Beskrivelse Data værdier XML Type K-Info Start tag for dokumentet - element KPunkt Start tag for k-punkt - element KName Navn for k-punkt Fx hovedindgang LIDNumber ID for k-punkt fx 1001 Status K-punkt status er ukendt Ukendt K-punkt off-line Off-line K-punkt on-line On-line K-punkt skal ikke polles Off-line - polles ikke State K-punkt status er ukendt -1 value K-punkt off-line 0 value K-punkt on-line 1 value K-punkt skal ikke polles 2 value GoneOnline Tid k-punkt sidst gik on-line fx 27-04-2009 11:36:17 KPunktCheckTime Tid for seneste k-punkt status fx 27-04-2009 11:36:17 NumberOfLogs Antal logninger placeret i k-punktet fx 0 MaxNumberOfLogs Maksimalt antal logninger der er fx 467 plads til i k-punktet NumberOfKeys Antal nøgler placeret i k-punktet fx 15 MaxNumberOfKeys Maksimalt antal nøgler der er fx 2000 plads til i k-punktet DoorOpenTime Døroplåsningstid i sekunder fx 10 SecurityLevel- Aktuel sikkerhedsniveautidstabel fx 1 Alle TimeTable hovedindgange DefaultSecurity- Default sikkerhedsniveau fx 3.0 Level PinCodeKeypad- PIN-kode tastatur monteret ja Exists nej CommonPINCode Fælles PIN-kode fx 5057 KPunktSoftware Aktuel software i k-punkt fx NIS101-1.2 060203 PAL=02 KPunktTime Tid i k-punkt fx 27-04-2009 11:36:16 CurrentSpecialDay Aktuel specialdag fx 0 (0 = normal dag, 1 = mandag mv.) CurrentSecurity- Aktuelt sikkerhedsniveau fx 0.1 Level ChecksumDrift Checksum for driftsstatus fx 020D (PC = 01FE) Checksum for driftsstatus ok fx 020D (Ok) State Forskel i checksummer 0 value Checksum ok 1 value ChecksumKeys Checksum for nøgletabel fx 1D91 (PC = 1D95) Checksum for nøgletabel ok fx 1D91 (Ok) State Forskel i checksummer 0 value Checksum ok 1 value ChecksumSecurity- Checksum for fx 053E (PC = 0531) LevelTimeTable sikkerhedsniveautidstabel Checksum for fx 053E (Ok) Sikkerhedsniveautidstabel ok State Forskel i checksummer 0 value Checksum ok 1 value ChecksumTimetable- Checksum for tidstabeller fx 0B9F (PC = 0B90) AndSpecialday- og specialdagskalender Calendar Checksum for tidstabeller fx 0B9F (Ok) og specialdagskalender ok State Forskel i checksummer 0 value Checksum ok 1 value Updateded Tidsstempling af status fx Opdateret: 27-04-2009 11:36:20 PAL=02 KPunktTime Tid i k-punkt fx 27-04-2009 11:36:16 OUT_1 Beskrivelse af udgang 1 fx Dør State Udgang ikke aktiveret 0 value Udgang aktiveret 1 value OUT_2 Beskrivelse af udgang 2 fx Lydgiver State Udgang ikke aktiveret 0 value Udgang aktiveret 1 value OUT_3 Beskrivelse af udgang 3 fx Alarmforbikobling State Udgang ikke aktiveret 0 value Udgang aktiveret 1 value
- 10 - PCS125 Ver.: 1.0 Rev.: 090512 XML tag Beskrivelse Data værdier XML Type OUT_4 Beskrivelse af udgang 4 fx Alarm-udgang State Udgang ikke aktiveret 0 value Udgang aktiveret 1 value OUT_5 Beskrivelse af udgang 5 State Udgang ikke aktiv 0 value Udgang aktiv 1 value OUT_6 Beskrivelse af udgang 6 State Udgang ikke aktiv 0 value Udgang aktiv 1 value OUT_7 Beskrivelse af udgang 7 State Udgang ikke aktiv 0 value Udgang aktiv 1 value OUT_8 Beskrivelse af udgang 8 State Udgang ikke aktiv 0 value Udgang aktiv 1 value IN_1 Beskrivelse af indgang 1 ved lav fx Åbningstryk lav Beskrivelse af indgang 1 ved høj fx Åbningstryk høj IN_1_CNT Tæller for antal lav til høj skift fx 6 IN_2 Beskrivelse af indgang 2 ved lav fx Karmkontakt lav Beskrivelse af indgang 2 ved høj fx Karmkontakt høj IN_2_CNT Tæller for antal lav til høj skift fx 21 IN_3 Beskrivelse af indgang 3 ved lav Beskrivelse af indgang 3 ved høj IN_3_CNT Tæller for antal lav til høj skift fx 0 IN_4 Beskrivelse af indgang 4 ved lav Beskrivelse af indgang 4 ved høj IN_4_CNT Tæller for antal lav til høj skift fx 0 IN_5 Beskrivelse af indgang 5 ved lav Beskrivelse af indgang 5 ved høj IN_5_CNT Tæller for antal lav til høj skift fx 0 IN_6 Beskrivelse af indgang 6 ved lav Beskrivelse af indgang 6 ved høj IN_6_CNT Tæller for antal lav til høj skift fx 0 IN_7 Beskrivelse af indgang 7 ved lav Beskrivelse af indgang 7 ved høj IN_7_CNT Tæller for antal lav til høj skift fx 0 IN_8 Beskrivelse af indgang 8 ved lav Beskrivelse af indgang 8 ved høj IN_8_CNT Tæller for antal lav til høj skift fx 0