Manual - AlarmViewer

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