AlarmViewer - AlarmViewer ”Ett larmmottagningsprogram” Installations och Användarmanual Version 1.1 1 Innehåll Innehållsförteckning 1 ALLMÄNT................................................................................................................................................. 4 1.1 VAD ÄR ALARMVIEWER? .........................................................................................................................4 1.2 VILKA KAN HA ANVÄNDNING FÖR ALARMVIEWER?.................................................................................4 1.3 MANUALENS DISPOSITION ........................................................................................................................4 1.4 INSTALLERA PROGRAMMET ......................................................................................................................5 1.4.1 Nödvändiga systemkrav och utrustning .........................................................................................5 1.4.2 Hårdvarulås ...................................................................................................................................5 1.4.3 Installera programmet ...................................................................................................................5 1.4.4 Starta programmet .........................................................................................................................5 1.4.5 Installerade kataloger och filer......................................................................................................6 2 PROGRAMÖVERSIKT – OPERATÖR ................................................................................................ 7 2.1 BESKRIVNING AV FLIKAR..........................................................................................................................7 2.1.1 Nya larm (Unacked.dat).................................................................................................................7 2.1.2 Gamla larm (Acked.dat).................................................................................................................9 2.1.3 Logg (yyyy-mm-dd.log) ................................................................................................................10 2.1.4 Debug (Debug.txt)........................................................................................................................10 2.1.5 ID-koder (IDCodes.skv) ...............................................................................................................10 2.1.6 Karaktärer (Types.skv).................................................................................................................14 2.2 HANDHAVANDE VID LARM .....................................................................................................................16 2.2.1 Tysta varningsljud........................................................................................................................16 2.2.2 Larmåtgärd ..................................................................................................................................16 2.2.3 Kvittera larm ................................................................................................................................16 2.2.4 Färdighanterade larm..................................................................................................................16 2.2.5 Sortera larm .................................................................................................................................17 2.3 ANVÄNDNING AV MENY-VAL .................................................................................................................17 2.3.1 Arkiv .............................................................................................................................................17 Visa...............................................................................................................................................17 2.3.2 Redigera .......................................................................................................................................17 2.3.3 3 OLIKA TYPER AV LARMKODER..................................................................................................... 18 3.1 LARMKODER OCH DESS UPPBYGGNAD ....................................................................................................18 3.1.1 Robofonkoder och övriga 8-ställiga koder ..................................................................................18 3.1.2 Övriga, icke 8-ställiga larmkoder ................................................................................................18 3.1.3 SMS och övriga larmkoder i klartext ...........................................................................................19 3.1.4 PRINT-strängar ...........................................................................................................................19 4 MOTTAGARENHETER........................................................................................................................ 20 4.1 RBM-600 ...............................................................................................................................................20 4.1.1 Specifika inställningar .................................................................................................................20 4.2 ROBOFONT1 (GOOGOLT1) .....................................................................................................................21 4.2.1 Specifika inställningar .................................................................................................................21 4.3 GSM-MODUL – SMS..............................................................................................................................22 4.3.1 Specifika inställningar .................................................................................................................22 5 EGENSKAPER / MODIFIERINGAR .................................................................................................. 24 5.1.1 5.1.2 5.1.3 5.1.4 5.1.5 5.1.6 2 Beskrivning av INI-filen ...............................................................................................................24 Ljudfilshänvisning ........................................................................................................................24 8-ställiga larmkoders uppbyggnad ..............................................................................................25 Språkfil .........................................................................................................................................25 Reserverade Koder, Karaktärer och Priosiffror ..........................................................................25 Tidstämpling.................................................................................................................................26 6 PRAKTISKT EXEMPEL PÅ ANVÄNDNING.................................................................................... 28 6.1 FÖRBERED FÖR MOTTAGNING AV LARM ..................................................................................................28 6.1.1 Larmmottagartyp och inställningar .............................................................................................28 6.1.2 Karaktär och ID-kod ....................................................................................................................28 6.1.3 Knyt larminformation till larmobjektet ........................................................................................29 6.2 SKICKA OCH HANTERA ETT INKOMMET LARM .........................................................................................30 6.2.1 Handhavande vid inkommet larm ................................................................................................31 7 REFERENS A – INSTÄLLNINGAR I INI-FIL................................................................................... 32 8 SKICKA VIDARE LARM MED NIMBUS .......................................................................................... 38 9 FAQ .......................................................................................................................................................... 39 9.1 INSTÄLLNINGAR .....................................................................................................................................39 9.1.1 INI-filen........................................................................................................................................39 9.1.2 ID-koder och Karaktärer .............................................................................................................39 3 AlarmViewer 1 ALLMÄNT Inledande beskrivning av programmet, dess användningsfunktioner och manualens upplägg. 1.1 Vad är AlarmViewer? AlarmViewer är ett larmmottagningsprogram som kan ta emot larm från flera slags mottagare samtidigt, via datorns olika serieportar. Följande mottagare kan användas: • • • RBM-600 RobofonT1 / GoogolT1 GSM-modul Via dessa mottagare så kan AlarmViewer ta emot och presentera en mängd olika protokoll. Bland dessa finns t.ex. de ofta förekommande Robofon-koderna och standardmässiga SMS-meddelanden. Till detta finns även möjlighet att ta emot mer produktspecifika protokoll som GoogolProtokollet. 1.2 Vilka kan ha användning för AlarmViewer? AlarmViewer är utvecklat för att ta emot larm och presentera dessa på ett enkelt och ändamålsenligt sätt. Programmet är framför allt framtaget för installatörer, kommuner, förvaltningar, m.m., som vill kunna föra en central loggning av händelser från olika larmobjekt. Det kan även med fördel användas av jourfirmor och mindre larmcentraler som vill kunna ta emot flera olika typer av larm på ett smidigt och kostnadseffektivt sätt. 1.3 4 Manualens disposition AlarmViewer - Utgåva 1.0 1.4 1.4.1 Installera programmet Nödvändiga systemkrav och utrustning Vi rekommenderar att programmet körs på en dator med Windows NT, 2000 eller XP för mest stabil drift. Fungerar även på Windows 95/98. 1.4.2 Hårdvarulås Alarm Viewer kräver att du installerar ett hårdvarulås av typen Rainbow Sentinel SuperPro på skrivar- eller USB-porten. Detta hårdvarulås medföljer vid leveransen av programmet. Vissa operativsystem (Windows NT 4) kräver att en drivrutin installeras för att hårdvarulåset skall fungera. Denna drivrutin finner du på Rainbow Technologies webbsida www.rainbow.com. Hårdvarulåset som ansluts på skrivarporten tillåter att du installerar en skrivare efter hårdvarulåset. 1.4.3 Installera programmet Sätt i CD-skivan i CD-rom läsaren och kör filen install.exe. Programmet kommer att föreslå målkatalogen ”C:\Program\Alarm Viewer”, men du kan givetvis välja en annan katalog om du så önskar. Vid installationen skapas automatiskt en genväg under startmenyn. 1.4.4 Starta programmet För att starta programmet används ikonen AlarmViewer som ligger under Startmenyn – Program – AlarmViewer Om hårdvarulåset ej är korrekt installerat eller saknas kommer nedanstående ruta upp. I annat fall startas programmet direkt. Demoläge Välj ’Ignorera’ för att köra programmet i demoläge. Programmet kommer då att kunna köras med full funktionalitet i 30 minuter. 5 AlarmViewer 1.4.5 Installerade kataloger och filer Här beskrivs kortfattat vilka filer som installeras var. Du som inte skall administrera programmet kan gå direkt till avsnitt 2. Installationen sker normalt till katalogen ”C:\Program\Alarm Viewer” KATALOGER • AlarmFiles Här lagras de larm som finns med i ’Nya larm’ • Comments Här skapas filer som innehåller åtgärdsinformation kring varje larm • Data Här lagras ’Nya Larm’, ’Gamla Larm’, ’ID-koder’ och ’Karaktärer’ • Information Information som är knutet till en viss larmkod, t.ex. kontaktperson, adressuppgifter och liknande. • LogFiles Loggfiler över vad som hänt – sorterat på datum • Sound Innehåller ljudfiler som kan användas i samband med att larm kommer in. FILER • AW_Lang.044 Engelsk språkfil • AW_Lang.046 Svensk språkfil • AlarmView.dll • AlarmViewer.exe Programexekveringsfil – används för att starta programmet • AlarmView.ini Inställningsfil för att göra specifika inställningar för programmet • St6unst.log Bör inte röras! – Innehåller nödvändiga upplysningar för att kunna avinstallera programmet TIPS! Gör en kopia på INI-filen och lägg på ett säkert ställe innan Du börjar modifiera den. Det är lätt att tappa bort tidigare inställningar och kan vara bra att ha möjligheten att flytta tillbaka en fil med ursprungsinställningar. Alternativt rekommenderas att förändringar dokumenteras noggrant. 6 AlarmViewer - Utgåva 1.0 2 PROGRAMÖVERSIKT – OPERATÖR Efter uppsart av programmet finns den bild som operatören använder. Där finns även olika menyer flikar som tillsammans skapar hela programmets funktionalitet. Vilka flikar som ska visas kan antingen väljas under menyvalet ’Visa’ eller ställas in i inställningsfilen AlarmView.ini. 2.1 Beskrivning av flikar Under flikarna ’Nya larm’ och ’Gamla larm’ så kan du sortera larmen genom att klicka på de olika kolumnerna, antigen stigande (+) eller fallande (-). 2.1.1 Nya larm (Unacked.dat) De senast inkomna larmen samlas under fliken ’Nya larm’. (Undantaget de larm som har prioritet -1 (provlarm) som hamnar direkt under ’Gamla larm’.) Om programmet är minimerat då ett nytt larm kommer in så lägger sig AlarmViewer automatiskt överst på skärmen. (Går att ställa in, se punkt 7) Tysta varningsljud Då ett nytt larm kommer in så aktiveras normalt ett varningsljud i datorns högtalare. Detta varningsljud tystas genom att klicka någonstans i fönstret för ’Nya larm’ eller genom att tycka ’F12’. Om inget varningsljud spelas så beror detta förmodligen på att larmet har för låg prioritet eller att varningsljudet har stängts av helt i inställningsfilen ”AlarmView.ini”. 7 AlarmViewer Åtgärda larm Om du högerklickar på ett larm så får du upp en ruta med objektsinformation samt möjlighet för åtgärdsnoteringar. Objektsinformationen (den övre delen) är endast editerbar från fliken ’ID-koder’, se punkt 2.1.5. Åtgärdsnoteringar gör du i den nedre delen. Dessa noteringar tidstämplas automatiskt och sparas sedan i en fil som är specifikt knuten till larmet. Kvittera larm Genom att dubbelklicka på raden för ett larm så kvitterar du larmet, det röda krysset ändrar då färg till grönt. Okvitterade larm markeras med ett rött kryss och kvitterade med ett grönt. Färdigbehandlade larm När du anser att ett larm är färdigbehandlat så rekommenderar vi att flytta över det till ’Gamla larm’. Innan detta kan ske måste larmet först vara kvitterat, sedan kan du flytta det genom att ännu en gång dubbelklicka på det. Samtliga larm under ’Nya larm’ kan enkelt flyttas till ’Gamla larm’ genom att välja meny-valet ’Kvittera Alla’ under ’Arkiv’-menyn eller trycka ’F9’. 8 AlarmViewer - Utgåva 1.0 Larminformation För varje larm som kommer in presenteras alltid: datum och tid då larmet kom in, protokolltyp, och den larmkod eller larmtext som skickades från larmsändaren. Om larmkoden är 8-ställig delas den automatiskt upp i ID-kod, prioritet samt karaktär enligt de inställningar som är gjorda i inställningsfilen ”AlarmView.ini”. ID-kod och karaktär kan översättas till objektsnamn och larmtyp i klartext om koderna har fördefinierats i programmet. Se punkt 2.1.5 och 2.1.6. F9 - kvitterar alla larm och flyttar även över dessa direkt till ’Gamla larm’ Enkelklick – tystar varningsljudet Dubbelklick på aktivt larm – kvitterar aktuellt larm Högerklicka – gör en åtgärdskommentar för larmet Nytt dubbelklick – flyttar över larmet till ’Gamla larm’ 2.1.2 Gamla larm (Acked.dat) Här lagras larmhistoriken på de larm upp som redan är kvitterade och överförda från ’Nya larm’. Antalet larm som loggas i denna lista är ställbart från ini-filens inställningar. 9 AlarmViewer 2.1.3 Logg (yyyy-mm-dd.log) I loggen syns programmets händelser. Portar som öppnas och stängs, om programmet avslutas, när det startas och om det finns ett fungerande hårdvarulås, är några exempel på händelser som visas i loggen. Uppstår fel kan loggen ibland vara till hjälp för att hitta vad som orsakat felet. 2.1.4 Debug (Debug.txt) Beskriver all kommunikation som sker på serieportarna både in och ut. Avmarkera rutan för hex-kod för att se kommunikationen i klartext. Debug-listan används främst vid felsökning. Den rensas alltid då programmet avslutas, men kan sparas om så önskas. Det är då alltid den aktiva debuglistan som sparas i filen debug.txt (under mappen ’Data’). All tidigare information i filen skrivs över. 2.1.5 ID-koder (IDCodes.skv) ID-koder är den del av larmkoden som avslöjar vilket objekt som larmet kommer ifrån. Larmkoden börjar alltid med ID-koden. Antalet ID-kodsiffror är ställbart i inställningsfilen (AlarmView.ini). 10 AlarmViewer - Utgåva 1.0 Antalet siffror som ska upptas av ID-koden anges i ini-filen. I nuläget är det endast 8-ställiga koder (t.ex. Robofon) som kan delas upp med ID-kod, prioritet och larmkaraktär. Standard är att ID-koden upptas av fem tecken. Den sjätte siffran är prio och de två sista är larmkaraktärsiffror. Att lägga upp ett nytt objekt / ny ID-kod Välj ’ID-koder’ under menyn ’Redigera’ för att lägga upp en ny ID-kod / nytt objekt. Filen ”IDCodes.skv” startas då… Här anger du ID-kod, objektsnamn och eventuellt intervallet för ’Alivetest’-koder (dessa koder beskrivs lite senare i manualen). Dessa data skall skiljas åt med ett semikolon ”;”. OBS! ID-koden ”00001” är en systemkod och är därför upptagen! 11 AlarmViewer Koppla objektsinformation till ID-koden Genom att dubbelklicka på en specifik ID-kod kan objektsinformation kopplas till den ID-koden. Det skapas en textfil med det specifika larmets nummer som namn. Dubbelklicka på raden för det specifika larmet Ange kontaktinformation, åtgärdsplan eller annan valfri text knuten till objektet. Denna information kan operatören sedan nytta av genom att högerklicka på ett inkommet larm, se punkt 2.1.1. Alivetest-funktion Då ID-koder redigeras kan även anges vilka objekt som ska rapportera in ett ’Alive’-meddelande. Ett ’Alive’-meddelande är en larmkod som skickas från objektet med jämna intervaller, detta för att testa att larmsändaren fungerar som den ska. Om detta meddelande inte kommer in automatiskt inom inställd tid så genererar programmet automatiskt ett fellarm. Detta tidsintervall ställer du in genom att välja ”ID-koder” under menyn ”Redigera”. Tidsintervallet anges i minuter efter objektsnamnet skilt med ett semikolon. 12 AlarmViewer - Utgåva 1.0 Ex. Här har vi ställt in ett provlarmsintervall på 100 minuter för objektet ”Olles mekaniska”: Detta resulterar i att en räknare startar på det specifika objektet som räknar ner 100 minuter och förväntar sig en larmkod från Olles mekaniska inom det givna intervallet. En ’Alive räknare’ anger hur lång tid det är kvar innan tiden gått ut för provlarmsändningen. Så fort ett larm kommer in så återställs räknaren till ursprungsvärdet. Provlarmskoden ska ha karaktär ”99” för att inte hamna under ’Nya larm’. Dessa larm hamnar då direkt under fliken ’Gamla larm’. Om en annan karaktär än ”99” önskas så går detta att editera under fliken ”karaktärer”. OBS! Du måste välja ”Uppdatera” under menyn ”Redigera” för att dina ändringar skall registreras av programmet. 13 AlarmViewer 2.1.6 Karaktärer (Types.skv) Karaktärer anger larmets typ, t.ex. ’Pumplarm’ eller ’Inbrott’ samt dess prioritet. Att lägga upp en ny karaktär Genom att välja ’Karaktärer’ under menyn ’Redigera’ så kan du lägga upp nya karaktärer eller ändra på redan befintliga. Så här kan det se ut… Följande uppgifter anges i nämnd ordning; Karaktärskod (normalt 2 siffror), eventuell prio-siffra och karaktärstext. Det är viktigt att du skiljer de olika uppgifterna med ett semikolon ”;”! Prioritetssiffrans funktion Priosiffrans position i larmkoden är alltid mellan ID-koden och larmkaraktären. Priosiffrans huvudfunktion är att påkalla uppmärksamhet då ett viktigt larm kommer in genom att starta varningsljudet i högtalarna. På det sättet behöver inte datorn vara bemannad hela tiden utan det räcker om någon ”finns i närheten”. Vilken prioritet på larm som skall aktivera varningsljudet i högtalarna ställs in i inställningsfilen ”AlarmView.ini”. Prioritet ”-1” Om ”–1” anges under ’Prio’ för en viss karaktär så presenteras inte larmkoder med denna karaktär under ’Nya larm’ utan hamnar direkt under ’Gamla larm’. Denna funktion är framförallt tänkt att användas för så kallade ’Alive’-meddelanden, se punkt 2.1.5, men kan även användas för larm som endast skall loggas. På så vis stör man inte operatören med för denne oväsentliga larm. 14 AlarmViewer - Utgåva 1.0 Antalet karaktärstecken Antalet karaktärstecken bestäms i filen ”AlarmView.ini”. Standard är två tecken karaktär och ett tecken prioritet. Vissa karaktärer är upptagna av systemfunktioner, se punkt 5.1.5. Om en karaktärs prioritet anges i programmet så är den ’hårdkodad’. Med det menar vi att det inte spelar någon roll vilken priosiffra som följer med sändarens larmkod, prioriteten tas i alla fall från inställningarna för aktuell karaktär. Anges ingen siffra är det den inkommande larmkodens prio-siffra som gäller! Om prio –1 knyts till en karaktär så presenteras inte larmkoder med denna karaktär under ’Nya larm’ utan hamnar direkt under ’Gamla larm’. 15 AlarmViewer 2.2 2.2.1 Handhavande vid larm Tysta varningsljud Då ett nytt larm kommer in till AlarmViewer så kan ett varningsljud aktiveras i högtalarna. Detta kan tystas genom att klicka någonstans i fönstret under fliken ’Nya larm’ eller genom att trycka ’F12’. 2.2.2 Larmåtgärd Genom att högerklicka på ett larm så får du upp ett objektsfönster där du får upp objektsinformation så som objektsnamn, telefonnummer, nyckelposition mm och eventuellt en åtgärdsplan vid larm. Här kan du även notera eventuella åtgärder som du har gjort, t.ex. ringt objektets jourpersonal och meddelat att ett larm är utlöst. 2.2.3 Kvittera larm För att kvittera ett larm så dubbelklickar du på raden med det aktuella larmet. Genom att kvittera larmet så visar du att du har uppmärksammat larmet. Okvitterade larm är markerade med ett rött kryss och kvitterade med ett grönt. 2.2.4 Färdighanterade larm Färdighanterade larm bör flyttas till ’Gamla larm’, detta gör du genom att dubbelklicka på larmet. Observera att larmet måste vara kvitterat innan du kan flytta det till ’Gamla larm’. 16 AlarmViewer - Utgåva 1.0 2.2.5 Sortera larm Genom att klicka på rubrikerna för respektive kolumn under ’Nya larm’ respektive ’Gamla larm’ sorteras dessa kolumner antingen stigande (+) eller fallande (-). Se även 2.1.1 för handhavande vid nya larm 2.3 2.3.1 Användning av Meny-val Arkiv Under Arkiv finner du följande menyval. Kvittera alla: Flyttar samtliga larm i ’Nya larm’ till ’Gamla larm’. Stäng av ljudsignal: Tystar varningsljudet som spelas då larm inkommer. Visa alltid sista larmet: Det senaste larmet ligger alltid synligt i listan. Avsluta: Avslutar programmet AlarmViewer. 2.3.2 Visa Visa anger vilka av användarflikarna som ska vara synliga för användaren. Vilka flikar som ska visas kan även bestämmas i inställningsfilen ”AlarmView.ini”. 2.3.3 Redigera Med hjälp av Redigera kommer Du åt att skapa/ändra ’ID-koder’ och ’Karaktärer’ för att få specifika larmkoder som knyts till respektive objekt. Se punkt 2.1.5 och 2.1.6 för vidare information! 17 AlarmViewer 3 OLIKA TYPER AV LARMKODER 3.1 3.1.1 Larmkoder och dess uppbyggnad Robofonkoder och övriga 8-ställiga koder Hur ska en Robofonkod (8-ställig) byggas upp för att hanteras riktigt av programmet. Programmet tolkar det åtta-siffriga meddelandet i block där ID-kod, prioritet på larmet och larmtyp utgör de tre byggstenarna. För att larmkodens prioritetssiffra ska beaktas ska ingen priosiffra anges i Karaktärsinställningsfilen. Om det där anges en siffra är det den prioriteten som kommer att vara överordnad, se punkt 2.1.6. I inställningsfilen AlarmView.ini bestäms dessa tre byggstenarnas längd och position. Inställningen gäller för alla åttaställiga larmkoder som kommer in. Exempel på protokoll med normalt åttaställiga koder är: Robofonkod, P100 och LA100. 3.1.2 Övriga, icke 8-ställiga larmkoder Övriga protokoll (t.ex. Ademco ContactID) där larmkoden är 15 tecken lång översätts ej i huvudtaget av AlarmViewer! Dessa larmkoder presenteras helt utan objekts och karaktärsinformation, dock sker tidsstämpling och protokollspecifiering precis som vanligt. Om intresse finns kommer förmodligen även dessa protokoll att presenteras med samma information som de 8-ställiga koderna i en senare version av AlarmViewer. 18 AlarmViewer - Utgåva 1.0 3.1.3 SMS och övriga larmkoder i klartext SMS-meddelanden kan skickas in antingen som rena texter eller med åtta inledande siffror som då bildar en larmkod. Om larmbeskedet inleds med åtta siffror kommer de att tolkas på samma sätt som andra åttaställiga larmkoder. Med andra ord så kan även dessa larmbesked knytas till för definierad objekts och karaktärsinformation. Hela larmbeskedet med klartext och eventuell larmkod visas helt oöversatt i kolumnen ’Larmkod’. 3.1.4 PRINT-strängar En ansluten RobofonT1 kan skicka ”utskriftsträngar” till AlarmViewer. Dessa används främst för att förmedla statusmeddelanden från RobofonT1-mottagaren, t.ex. telelinjestatus. PRINT-strängarna som programmeras in i RobofonT1 skall förses med ett starttecken och ett stopptecken för att programmet skall ”bry sig om” dem. Starttecken: STX (02h) Stopptecken: ETX (03h) Prioritet för PRINT-strängar och larm med endast klartext bestäms i inställningsfilen ”AlarmView.ini”. 19 AlarmViewer 4 MOTTAGARENHETER AlarmViewer har möjlighet att hantera upp till fyra samtidiga mottagare av tre olika typer. Dessa är RBM-600, RobofonT1 (GoogolT1) och GSMmodul. De GSM-moduler som vi har utprovat i nuläget är Siemens M20T och Wavecom WMOD 2. 4.1 RBM-600 RBM-600 är en larmmottagare, vilken hanterar ett stort antal protokoll och kan bestyckas med 1-28 inkommande telefonlinjer. Ansluts till en serieport. Observera att AlarmViewer endast kan uttolka ID-kod och Karaktär vid 8-ställiga larmkoder. Övriga koder som ej är 8-ställiga presenteras helt utan objektsinformation! 4.1.1 Specifika inställningar Här visas hur ini-filen kan ställas in vid mottagartypen RBM-600. [Port_1] ; ; Port Types ; ; RS232=RS-232 Com-port ; TCPC=TCP Client ; TCPS=TCP Server ; NONE=Not used ; PortType=RS232 ; ; Description of port, if not used, the section name will be used ; PortDescription=RBM-600 ; 0=Robofon (RBM600) ; 1=Googol (GoogolT1) ; 2=Text ; 3=GSM ProtocolType=0 ; COM-port number (for COM) or TCP port (for TCPS/TCPC) PortNumber=1 (eller 2,3 eller 4) ; 9600,n,8,1 (for COM) or remote IP address for (TCPC) PortSetting=300,o,7,1 (=300 baud, udda paritet, 7 databitar, 1 stoppbit) ; Set to 1 to use the timestamp from the originator, otherwise the timestamp will ; come from the PC clock TimeStampFromRBM=1 (eller 0) 20 AlarmViewer - Utgåva 1.0 ; The interval in seconds within we assumes that we will receive any valid ; telegram or a test telegram (only for RBM600 and GoogolT1) ; If set to -1, we don't expect any test telegrams TestTelegramInterval=60 (max antal sekunder mellan testtelegram – vid uteblivet telegram inom tidsramen genererar programmet automatiskt ett larm för ”ej kontakt med RBM” och vid ny kontakt ”ny kontakt med RBM”) 4.2 RobofonT1 (GoogolT1) En RobofonT1 kan anslutas direkt på en serieport och fungera som en mottagare. T1:an måste först programmeras med filen ”AlarmView.GT1” där protokolltyp måste ställas in. T1:an kan ta emot och presentera följande protokoll: Robofonkod och P100 eller GoogolProtokollet 4.2.1 Specifika inställningar Här visas hur ini-filen kan ställas in vid mottagartypen RobofonT1. [Port_2] ; ; Port Types ; RS232=RS-232 Com-port ; TCPC=TCP Client ; TCPS=TCP Server ; NONE=Not used ; PortType=RS232 ; ; Description of port, if not used, the section name will be used ; PortDescription=RobofonT1 larmmottagare ; ; 0=Robofon (RBM600) ; 1=Googol (GoogolT1) ; 2=Text ; 3=GSM ProtocolType=1 ; COM-port number (for COM) or TCP port (for TCPS/TCPC) PortNumber=2 (eller 1, 3 eller 4) ; 9600,n,8,1 (for COM) or remote IP address for (TCPC) PortSetting=9600,n,8,1 (=9600 baud, ingen paritet, 8 databitar, 1 stoppbit) ; 0=None, 1 = Xon/Xoff, 2 = RTS/CTS, 3 = Both (for COM) HandShaking=0 ; Determines re-open attempts if port cannot be opened (seconds) ReopenInterval=60 21 AlarmViewer ; Determines the interval to set the GoogolT1 clock ; (if ProtocolType=1), the interval is in minutes ; Set to -1 to disable the function ;SetTimeInterval=1440 (Klockan ställs 1 ggr/per dygn) SetTimeInterval= 1440 (Ange tidsintervall i mínuter) ; Set to 1 to use the timestamp from the originator, otherwise the timestamp will ; come from the PC clock TimeStampFromRBM=1 ; The interval in seconds within we assumes that we will receive any valid ; telegram or a test telegram (only for RBM600 and GoogolT1) ; If set to -1, we don't expect any test telegrams TestTelegramInterval= 60 (max antal sekunder mellan testtelegram) 4.3 GSM-modul – SMS Utprovade och fungerande GSM-moduler för anslutning till en serieport: Siemens M20T Wavecom WMOD2 4.3.1 Specifika inställningar Här visas hur ini-filen kan ställas in vid mottagartypen GSM-modul. [Port_3] ; ; Port Types ; ; RS232=RS-232 Com-port ; TCPC=TCP Client ; TCPS=TCP Server ; NONE=Not used ; PortType=RS232 ; ; Description of port, if not used, the section name will be used ; PortDescription=GSM M20T via RS-232 ; 0=Robofon (RBM600) ; 1=Googol (GoogolT1) ; 2=Text ; 3=GSM ProtocolType=3 ; COM-port number (for COM) or TCP port (for TCPS/TCPC) PortNumber=3 (eller 1, 2 eller 4) ; 9600,n,8,1 (for COM) or remote IP address for (TCPC) PortSetting=9600,n,8,1 (=9600 baud, ingen paritet, 8 databitar, 1 stoppbit) ; 0=None, 1 = Xon/Xoff, 2 = RTS/CTS, 3 = Both (for COM) HandShaking=0 ; Determines re-open attempts if port cannot be opened (seconds) ReopenInterval=60 22 AlarmViewer - Utgåva 1.0 ; ; GSM-SMS Modem specific settings ; SMSCNumber= (Bör lämnas tomt! Centralnumret för SMS bör finnas på SIM-kortet..) PIN= #### (Aktuell PIN-kod för SIM-kortet! Glöm ej!!!) FO=17 – Rör ej! VP=169 – Rör ej! PID=0 – Rör ej! DCS=240 – Rör ej! CharSet=8859-1 – Rör ej! ; ; Interval used for SMS modem inits ; InitInterval=600 (hur ofta SMS-modulen ska ominitieras i minuter) ; ; Interval used for extra SMS polling (seconds) ; PollInterval= 600 (extra SMS-pollning på SIM-kortet var x:te sekund) 23 AlarmViewer 5 EGENSKAPER / MODIFIERINGAR 5.1.1 Beskrivning av INI-filen Grundinställningar för AlarmViewer sker i filen ”AlarmView.ini”, denna filen är belägen direkt under den katalog där programmet installerades, normalt ”C:\Program\Alarm Viewer”. De vanligaste egenskaperna som kan behöva modifieras beskrivs här. Då du vill ändra någon av nedanstående inställningar så gör du det genom att öppna filen ”Alarm View.ini” med ett enkelt textredigeringsprogram. Vi rekommenderar att du använder programmet ”Anteckningar.exe” (eller om du har ett engelskspråkigt operativsystem, ”NOTEPAD.exe”). Sök efter programmet om du är osäker på var det ligger! 5.1.2 Ljudfilshänvisning Om inget ljud spelas så är det troligen sökvägen till ljudfilen som inte är korrekt. Den hänvisas i filen AlarmView.ini. Se så att wav-filen som spelas vid larm verkligen ligger där sökvägen anger. Hur ljudet ska spelas upp kan också bestämmas genom att ange olika uppspelningsmöjligheter. 0 – spela inte, 1 – kort pip 2 – spela filen en gång 3 – spela kontinuerligt. ; 0=Don't play, 1 = Beep, 2 = Play file, 3 = Play file continous AlarmSound=3 AlarmSoundFile=C:\Program\Alarm Viewer\Sound\warning.wav 24 AlarmViewer - Utgåva 1.0 5.1.3 8-ställiga larmkoders uppbyggnad För att larmkodens prioritetssiffra ska beaktas ska ingen priosiffra anges i Karaktärsinställningsfilen. Om det där anges en siffra är det den prioriteten som kommer att vara överordnad. En åttaställig larmkod kan anpassas med följande parametrar; • • • Längden på ID-kod (startposition och längd) Längden på Prioritetsordningen (startposition och längd) Längden på Karaktärssiffrorna (startposition och längd) ; Startposistion and length of the Id Code in the 8 byte message IdcodeFormat=1,5 ; Startposistion and length of the priority in the 8 byte message PrioFormat=6,1 ; Startposistion and length of the type in the message TypeFormat=7,2 Summan av längderna ska bli åtta och startpositionerna anpassas så att de inte överlappar varandra. 5.1.4 Språkfil Standard vid leverans är att AlarmViewer är på svenska. Det finns dock även med en engelskspråkig fil (AW_Lang.044). Inställningen för vilket språk som ska användas ligger i inställningsfilen: AlarmView.ini ; The language file that is used ; 046 = Sverige ; 044 = England Language=046 5.1.5 Reserverade Koder, Karaktärer och Priosiffror Följande ID-koder är reserverade som systemkoder • 00001 – Larm som skapats internt av programmet har denna ID-kod. Följande Karaktärer är reserverade för systemhändelser • 97 – Alivetest-larm har utteblivit från ett objekt • 98 – Kommunikationsfel med mottagaren RBM-600 25 AlarmViewer 5.1.6 Tidstämpling Tidstämplingen kan göras antingen från datorns klocka eller mottagare om det är en RBM-600. Det går också att använda datorns klocka för att ställa klockan RobofonT1 (GoogolT1) som mottagare. I ini-filen går det att ställa in om valet att ställa klockan ska aktiveras/inaktiveras och med vilket intervall det ska göras. ; Determines the interval to set the RobofonT1 clock ; (if ProtocolType=1), the interval is in minutes ; Set to -1 to disable the function ;SetTimeInterval=1440 SetTimeInterval=1440 ; Set to 1 to use the timestamp from the originator, otherwise the timestamp will ; come from the PC clock TimeStampFromRBM=1 Vi rekommenderar att AlarmViewer ställer klockan då Du har en RobofonT1 som mottagare. 26 AlarmViewer - Utgåva 1.0 Ett övningsexempel… Pannlarm hos Elektronikmannen AB Förbered för larmet • Lägg upp ett nytt objekt med nödvändig info • Lägg upp larmkaraktärer och ev. prioritet • Ställ in eventuellt provlarms/alivetest-intervall Behandla larmet • • • • Hantera ett inkommet larm som operatör Kvittera och åtgärda larm Gör åtgärdsanteckningar Avsluta larmet då det är färdighanterat 27 AlarmViewer 6 PRAKTISKT EXEMPEL PÅ ANVÄNDNING 6.1 Förbered för mottagning av larm Vi ska här i exemplet visa hur ett larm förbereds för att tas emot. Först ska vi bestämma ID-kod, Prio och Karaktär och sedan komplettera ID-koden med kontakt- och åtgärdsuppgifter. Men innan vi sätter igång med detta behöver det ju finnas något som kan ta emot larmen. Antag här att det sitter en RBM-600-mottagare på COMport 1. Inkopplingsanvisningen finns i manualen för respektive produkt. Förutsättningar: Kund: Elektronikmannen AB Typ av larm: Pannlarm – temperaturlarm Larmåtgärd: Då larm går ska en operatör ringa upp Folke Folkesson på Elektronikmannen och meddela att larm gått i pannrummet. Prioritet: 1 Alivetest: För att veta så att larmsändaren ”lever” ska den rapportera in ett provlarm en gång per vecka. 6.1.1 Larmmottagartyp och inställningar Vad behöver ställas in i inställningsfilen ”AlarmView.ini”? Korrekta inställningar för en RBM-600 ställs in i ini-filen för den aktuella porten (COM1). För inställningar hänvisas till mottagarenheternas specifika inställningar, se punkt 4.1.1. 6.1.2 Karaktär och ID-kod LÄGG TILL EN NY ID-KOD Välj ’ID-koder’ under ’Redigera’-menyn. Lägg in ID-kod, Objektsnamn och eventuellt Alivetestintervall (se punkt 2.1.5). 28 AlarmViewer - Utgåva 1.0 LÄGG TILL EN NY KARAKTÄR Välj ’Karaktärer’ under ’Redigera’-menyn Lägg till Karaktärskod, Prioritet och Karaktärstext (se punkt 2.1.6). 6.1.3 Knyt larminformation till larmobjektet Vilken information ytterligare finns att knyta till larmobjektet? Gå in på fliken ID-koder och dubbelklicka på ID-koden 10101, välj att skapa en ny text-fil knuten till den specifika koden. Skriv in önskad information… Spara filen och välj att Uppdatera i Redigera-menyn… 29 AlarmViewer ….Vilket resulterar i ett färdigt objekt under ’ID-koder’ Nu är vi klara för att ta emot ett larm som kommer att bestå av larmkoden: 10101101. 6.2 Skicka och hantera ett inkommet larm *** LARM *** LARM *** LARM *** LARM *** LARM *** Pannan larmar och larmsändaren skickar iväg ett larm som är 10101101 Larmet kommer in i AlarmViewer. Programmet och varningsljudet aktiveras (om det inte angivits att ljudet inte ska spelas upp). 30 AlarmViewer - Utgåva 1.0 6.2.1 Handhavande vid inkommet larm TYSTA VARNINGSLJUDET Varningsljudet tystnar genom en av två åtgärder: • Klicka på valfritt larm i ’Nya larm’-listan • Tryck F12 KOLLA OCH NOTERA ÅTGÄRD För att se vad som ska göras, högerklicka på larmet. Där kan utläsas vilka åtgärder som ska göras och eventuella åtgärder kan noteras i den nedre halvan av åtgärdsfönstret. KVITTERING OCH ÖVERFLYTT TILL ’GAMLA LARM’ Då åtgärd är klar och larmet uppfattat gör ett dubbelklick på larmet att larmindikatorn färgas grön. Ytterligare två snabba klick på larmet flyttar över larmet till fliken ’Gamla larm’ och förväntas vara helt avklarat. 31 AlarmViewer 7 REFERENS A – INSTÄLLNINGAR I INI-FIL Här tar vi upp alla inställningar som går att göra i inställningsfilen ”AlarmView.ini”. Om du är osäker på vilket program du ska använda för att ändra inställningar i filen eller inte vet var du ska hitta den, se punkt 5.1.1. ANTAL DAGAR FÖR ATT BEHÅLLA LOGGFILEN Hur länge ska loggfilen behållas. En loggfil beskriver vad som hänt med programmet och hårdvara under ett dygn. ; Number of days to keep log file, set to -1 to never delete log files LogFileSavePeriod=30 ANTAL GAMLA LARM I ’GAMLA LARM’ Redan kvitterade och åtgärdade larm. ; Number of old alarms in the Acked Alarms view ; The list will be cleaned every hour ; Older Acked Alarms are available in the log files ; This parameter also determines the size of the SysLog and Debug list LogViewSize=200 MAXIMALA ANTALET ’NYA LARM’ Hur många larm ska finnas med under fliken ’Nya larm’ ; Max number of unacked alarms in the unacked alarm view MaxUnacked=20000 VISA ALARMVIEWER PÅ PROGRAMRADEN Avgör om programmet ska visas på aktivitetsraden eller i notifieringsarean. ; Set to 1 to show the AlarmViewer in the TaskBar (otherwise it will be in the ; notify area) ShowInTaskBar=0 POP-UP FUNKTION Ska programmet lägga sig längst fram och maximeras då nya larm kommer in? ; Set to 1 to indicate a new alarm by maximizing the window and set it flashing AlarmPopup=1 VARNINGSLJUD Sökvägen till varningsljudfilen samt hur eller om ljudfilen ska spelas upp 32 AlarmViewer - Utgåva 1.0 ; 0=Don't play, 1 = Beep, 2 = Play file, 3 = Play file continous AlarmSound=3 AlarmSoundFile=C:\Program\Alarm Viewer\Sound\Warning.WAV PRIORITET FÖR VARNINGSLJUD Bestämmer vilken prio som ska göra så att varningsljud spelas upp. ; Determines the priority when to play sound/beep, set to -1 to play sound/beep for ; all incoming alarms SoundPrio=1 PRIORITET FÖR TEXTMEDDELANDEN Endast text ges en specifik prioritet ; Priority set to alarms that only contains a text, i.e no prio is sent DefaultPrio=1 ID / PRIORITET / MEDDELANDETYP Bestämmer uppbyggnaden av larmkoden som kommer in. Startpositioner och längd bestäms för ID-kod, Prioritet och Meddelandetyp (Karaktär) för 8-ställig kod. ; Startposistion and length of the Id Code in the 8 byte message IdcodeFormat=1,5 ; Startposistion and length of the priority in the 8 byte message PrioFormat=6,1 ; Startposistion and length of the type in the message TypeFormat=7,2 ANTAL RADER I DEBUGGEN Hur många rader ska finnas i Debuggen? ; Number of lines in the debug view DebugViewSize=200 SPRÅKFIL Engelsk- eller svenskspråkiga programmenyer och flikar. För att enkelt kunna ändra språket som används, så finns alla förekommande texter sparade i en språkresursfil. Dessa texter kan fritt översättas till andra språk och sparas om med ett nytt namn. Resursfilen består av t.ex. AW_Lang.046 där de sista siffrorna syftar till landsnumret. ; The language file that is used ; 046 = Sverige ; 044 = England Language=046 33 AlarmViewer VISA FLIKAR Bestämmer vilka flikar som ska vara synliga för användaren ; Show System Log tab ShowSysLog=1 ; Show Debug tab ShowDebug=1 ; Show Alarm Codes tab ShowAlarmCodes=0 ; Show ID Codes tab ShowIdCodes=1 ; Show Types tab ShowTypes=1 ; If debug codes should be in hex and of last row should always be visible Check_Debug_HexCode=1 Check_Debug_ShowLastRow=1 APPLIKATION FÖR EDITERING Den applikation som används för att redigera ID-koder, Karaktärer och Larminformation. ; Applikation used for translation edits ;EditApp=C:\Program Files\Microsoft Office\Office\EXCEL.EXE EditApp=notepad.exe TILLÅT EDITERING Ska Redigering av ID-koder och Karaktärer tillåtas? Om 0 väljs kommer inte Redigera-alternativet att finnas med på menyraden. ; Set to 1 to allow edit of types and IdCodes AllowEdit=1 ALIVETEST-FUNKTION Bestämmer hur Alive-test kollas av. Ska automatlarm utställas en gång eller ska det ske cykliskt? ; Behaviour, 0=Cyclic test (new alarm every period without alive message), 1 = One shot ; (alarm only when the period expires the first time) AliveTestBehaviour=0 Här ställer du in den felkod som skall skapas då en sändares Alivetest-kod inte har kommit i i tid. Felkoden som genereras då Alivetesten inte genomförts är alltså normalt XXXXXX97 där XXXXX är objektets ID-kod och karaktärens prioritet. ; The type (which is translated) used for Alive Test failures AliveTestType=97 34 AlarmViewer - Utgåva 1.0 KOMMUNIKATIONSFEL MOTTAGARE Om datorn tappar kontakt med någon av mottagartyperna RBM-600 och RobofonT1 så genererar programmet automatiskt den felkod som här kan ställas in. ; The alarmcode (which is translated) used for GoogolT1 watchdog trigger failures TestTelegramAlarmCode=00001198 VISA ALLTID SISTA RADEN I DEBUGGEN Här kan man ställa in att valet “Visa alltid sita raden” under debuggfliken skall vara ibockad som default. CheckDebug_ShowLastRow=1 NIMBUS-KOMPATIBILITET [Nimbus] ; The TCP/IP port that AlarmViewer use for Nimbus. Set to -1 to ; disable TCP/IP Port=14000 [ListView_Unacked] Column1= 1214.929 Column2= 1005.165 Column3= 1635.024 Column4= 794.8347 Column5= 1980.284 Column6= 2429.858 Column7= 44.7874 [ListView_Acked] Column1= 1349.858 Column2= 975.1182 Column3= 975.1182 Column4= 947.9056 Column5= 1620.284 Column6= 1260.284 Column7= 1976.315 [ListView_SysLog] Column1= 1170.142 Column2= 1065.26 Column3= 6869.48 [ListView_IDCodes] Column1= 1005.165 Column2= 3899.906 Column3= 4199.811 Column4= 1890.142 [ListView_Types] Column1= 720.0001 Column2= 624.189 Column3= 7760.693 35 AlarmViewer PORT 1 - INSTÄLLNINGAR Olika inställningar specifika för mottagare på serieporten. Den fungerar på samma sätt för samtliga fyra serieportar, men har olika parametrar. Exemplet nedan visar en port konfigurerad för en RobofonT1 som mottagare. Se punkt 4.1.1-4.3.1 för vidare information. För larmmottagare på flera portar kopieras hela nedanstående paketet och modifieras för den aktuella mottagartypen. [Port_1] PORTTYP ; ; Port Types ; ; RS232=RS-232 Com-port ; TCPC=TCP Client ; TCPS=TCP Server ; NONE=Not used ; PortType=RS232 ÅHär skall det stå RS232 i normala fall ; ; Description of port, if not used, the section name will be used ; PortDescription=GoogolT1 Å Här anger du namnet som mottagren skall benämnas med i loggen ; 0=Robofon (RBM600) ; 1=Googol (GoogolT1) ; 2=Text ; 3=GSM ProtocolType=1 Å Här anger du vilken typ av mottagare du har anslutit till aktuell port ; COM-port number (for COM) or TCP port (for TCPS/TCPC) PortNumber=1 Å Här anger du normalt vilken com-port som aktuell mottagare är ansluten till KOMMUNIKATION ; 9600,n,8,1 (for COM) or remote IP address for (TCPC) PortSetting=9600,n,8,1 Å Här anger du: Baudhastighet,paritet,antal bitar,antal stoppbitar ; 0=None, 1 = Xon/Xoff, 2 = RTS/CTS, 3 = Both (for COM) HandShaking=0 Å Skall normalt vara 0 ; Determines re-open attempts if port cannot be opened (seconds) ReopenInterval=60 Å Anger hur ofta programmet skall försöka öppna porten om den är upptagen 36 AlarmViewer - Utgåva 1.0 STÄLLA KLOCKAN ; Determines the interval to set the GoogolT1 clock ; (if ProtocolType=1), the interval is in minutes ; Set to -1 to disable the function ;SetTimeInterval=1440 SetTimeInterval=1440 Å intervallet för klockinställningen på en RobofonT1 i minuter ; Set to 1 to use the timestamp from the originator, otherwise the timestamp will ; come from the PC clock TimeStampFromRBM=1 Å Tid från mottagare / dator. Normalt 1 vid RBM-600, annars 0. TESTTELEGRAM ; The interval in seconds within we assumes that we will receive any valid ; telegram or a test telegram (only for RBM600 and GoogolT1) ; If set to -1, we don't expect any test telegrams TestTelegramInterval=60 Å Intervall för kommunikationstest mellan mottagare och dator, ej GSM GSM-MODUL ; ; GSM Modem specific settings ; SMSCNumber= Å Om SMS-centralnumret saknas på SIM-kortet kan du ange det här PIN= Å Viktigt! Här skall SIM-kortets PIN-kod anges! FO=17 VP=169 PID=0 DCS=240 CharSet=8859-1 ; ; Interval used for SMS modem inits ; InitInterval=600 Å Initieringsintervall för GSM-modul ; ; Interval used for extra SMS polling (seconds) ; PollInterval=600 Å Intervall för extra SMS-pollning 37 AlarmViewer 8 SKICKA VIDARE LARM MED NIMBUS Om du inte nöjer dig med att ta emot larm utan även vill skicka vidare larm från AlarmViewer så kan du åstadkomma detta med programmet ”Nimbus”. Nimbus tillhandahåller en metod för att vidarebefordra händelser i ett system till ett antal olika larmmottagare baserat på datum/tid och övriga villkor baserade på information från systemet. Med ”Nimbus” så kan du skicka vidare larm som SMS till GSM-telefoner, Minicall Text och E-post meddelanden. Det går även att lägga till information och göra olika utskicksprofiler för olika larm. Kontakta din återförsäljare för vidare information. 38 AlarmViewer - Utgåva 1.0 9 FAQ 9.1 9.1.1 Inställningar INI-filen Fråga: Jag får inget ljud fast programmet aktiveras då ett larm kommer in. Svar 1: Se så att sökvägen till ljudfilen verkligen är rätt inställd i filen AlarmView.ini Svar 2: Är det angivet att alla larm ska spela upp ljudfilen, eller är det endast prioriterade larm. Den inställningen går att göra i ini-filen. Var det i så fall ett högprioriterat larm som kom in? 9.1.2 ID-koder och Karaktärer Fråga: Jag redigerar inställningar för ID-koder och Karaktärer men ändringarna syns ej under flikarna ID-koder och Karaktärer! Svar: Välj uppdatera under menyn ’Redigera’. 39
© Copyright 2024