ipanel Online informační a ovládací panel pro systém Uživatelská příručka 2004 2010,TECH FASS s.r.o., Plavecká 503, 252 42 Jesenice, www.techfass.cz, techfass@techfass.cz (vydáno dne 8.12.2010, platné pro sestavení 2.1.0.4)
1. Obsah 1. Obsah... 2 2. Popis produktu, instalace, konfigurace... 3 2.1. Popis produktu, požadavky na hardware a operační systém... 3 2.2. Instalace software, instalované součásti... 3 3. Konfigurace... 3 3.1. Struktura konfiguračního souboru... 4 4. Použití programu... 7 4.1. Ikona v oznamovací části panelu systému Windows... 7 4.2. Ovládací panel... 7 4.3. Upozornění na události... 7 Uvedené názvy produktů a společností mohou být ochrannými známkami a/nebo ochranné servisní známky jejich příslušných vlastníků.
2. Popis produktu, instalace, konfigurace 2.1. Popis produktu, požadavky na hardware a operační systém Softwarový produkt ipanel (ipanel) je standardní součástí programového balíku nadministrator. Program je určen pro usnadnění obsluhy systému tam, kde je potřeba z počítače připojeného v síti aktivovat uživatelské funkce, zobrazovat upozornění na vybrané provozní události (lze i s obrazem z asociované IP kamery) nebo graficky znázornit vybrané stavy systému. Hardware IP kamera komunikační server ipanel Obr. 2.1: Připojení programu ipanel Produkt je určen pro operační systém Windows NT (2000, XP), standardně nevykonává žádné složité operace, proto i jeho požadavky na výkon počítače nejsou nijak veliké pokud dobře pracuje operační systém, bude dobře pracovat i ipanel. Jsou-li v konfiguraci využity akustické signály, je vyžadována zvuková karta. Využívá-li se zobrazení signálu z IP kamer, je nutné zajistit dostatečně výkonný hardware. 2.2. Instalace software, instalované součásti Do systému není nutné program nijak instalovat. Stačí do vhodné složky nakopírovat následující soubory: APS400iPanel.exe, APS400iPanel.ini (konfigurační soubor), složku icons se stavovými ikonami (je vhodné, aby byla umístěna ve stejné složce jako spustitelný soubor). Stavové ikony musí být ve formátu ico o velikosti 32x32 bodů. ipanel je připojen ke komunikačnímu serveru prostřednictvím TCP/IP rozhraní (obr. 2.1). Je přitom nutné mít v konfiguraci komunikačního serveru povolené IP adresy, ze kterých se budou klienti připojovat. Zobrazení obrazu z IP kamer je zajištěno vestavěným www prohlížečem. Je tedy nutné použít vhodný typ kamery, zobrazující signál na webové stránce a zajistit správnou konfiguraci jak kamery, tak i klienta. 3. Konfigurace Konfigurace programu je uložena v konfiguračním souboru APS400iPanel.ini. S vytvořením konfiguračního souboru může pomoct administrační program (nadministrator), ručně je nutné konfigurovat jen vazbu zobrazení ikon na číselné registry řídícího modulu, případně URL dokumentu, jehož zobrazení má být dostupné z menu ipanelu. strana 3
3.1. Struktura konfiguračního souboru Přestože s konfigurací pomůže administrační program, je dále jeho struktura popsána celá: [UserEvents] UserEvent01=Otevřít dveře 1 UserEvent02=Otevřít dveře 2 UserEvent03= UserEvent04= UserEvent05= UserEvent63= UserEvent64= Default=2 [Connection] ServerIPAddress=127.0.0.1 ServerIPPort=10700 HWAddress=1 [OnlinePresence] URL=http://server/scripts/aps400op.exe Description=Aktuální přítomnost [Panel] Visible=1 Top=0 Left=0 Locked=1 [Miscellaneous] SystemName=Jméno systému [Buttons] Width=100 [Icons] Icon000=icons\dverezavreny.ico Icon001=icons\dvereotevreny.ico Icon002=icons\zamknuto.ico Icon003=icons\odemknuto.ico [Registers] Register001=Dveře 1,default=Icon000,001=Icon001,UserEvent=1,Col=0 Register002=Dveře 2,default=Icon000,001=Icon001,UserEvent=2,Col=0 Register003=Zámek,default=Icon002,001=Icon003,UserEvent=2,Col=1 [Modules] 0=Řídící modul 1=Čtečka 1 [Alerts] 0000000008=3,Ochranný kontakt,http://192.168.1.25/ 0000000249=1,Ochranný kontakt OK 0000100009=2,Dlouho otevřené dveře 0000100010=3,Vyražené dveře [AlertsWindow] Top=200 Left=0 Width=450 Height=130 Col00=130 Col01=130 Col02=180 FontSize=10 strana 4
3.1.1. Sekce [UserEvents] V sekci [UserEvents] jsou uvedeny popisy uživatelských událostí, které mají být z ipanelu dostupné (parametry UserEvent01,..., UserEvent64). Pokud některý popis uveden není, nelze odpovídající uživatelskou událost ipanelem aktivovat (tlačítko není zobrazeno). Parametr Default definuje číslo uživatelské události, která má být aktivována po poklepání levým tlačítkem myši na ikonu programu v oznamovací oblasti hlavního panelu Windows. A konečně parametr HWAddress definuje HW adresu řídícího modulu, který má uživatelské události aktivovat. 3.1.2. Sekce [Connection] Parametry ServerIPAddress a ServerIPPort definují připojení k nserveru.net, parametr HWAddress HW adresu řídícího modulu, se kterým má být ipanel spojen. 3.1.3. Sekce [OnlinePresence] *) Sekce [OnlinePresence] definuje URL pro zobrazení okamžité přítomnosti osob v objektu (je-li instalována). Obecně však může odkazovat na libovolnou URL, která pak bude dostupná příkazem z lokálního nabídky ipanelu. Parametr Description definuje popisek příkazu. 3.1.4. Sekce [Panel] V sekci [Panel] jsou uloženy informace o viditelnosti (Visible) a poloze (Top, Left) okna ipanelu. V závislosti na hodnotě parametru Locked k nim program přistupuje dvojím způsobem: Je-li jeho hodnota rovna nule, je při spuštění ipanelu okno zobrazeno stejně jako bylo při jeho ukončení. Je-li rovna jedné, aktuální informace se při ukončení neukládá a při spuštění se načtou implicitní parametry definované při konfiguraci. 3.1.5. Sekce [Miscellaneous] Sekci [Miscellaneous] obsahuje jediný parametr SystemName, který definuje jméno systému zobrazené v titulcích oken ipanelu. 3.1.6. Sekce [Buttons] Sekce [Buttons] obsahuje jediný parametr Width, který definuje šířku tlačítek v okně ipanelu (v bodech obrazovky). 3.1.7. Sekce [Icons] *) V sekci [Icons] jsou definovány ikony, které mají být použity pro vizualizaci hodnot registrů. Celkem je možné definovat až 500 různých ikon, které pak lze využít k vizualizaci hodnot registrů. Na každém řádku sekce je definována jedna ikona. Název parametru musí být ve formátu ve formátu IconXXX, kde XXX je pořadové číslo ikony zleva doplněné nulami na tři znaky. strana 5
Hodnota parametru je relativní cesta (vztažená k umístění spustitelného souboru APS400iPanel.exe) k souboru s ikonou. 3.1.8. Sekce [Registers] *) V sekci [Registers] jsou definovány vizualizované registry, na každém řádku jeden. Název parametru musí být ve formátu RegisterXXX, kde XXX je číslo registru zleva doplněné nulami na tři znaky. Hodnota parametru obsahuje následující prvky (oddělené čárkami): Textový popisek registru. Je povinný a musí vždy být prvním prvkem. Odkaz na defaultní ikonu tzn. tu, která bude zobrazena, nebude-li dále uvedena definice pro konkrétní hodnotu registru (prvek default). Je povinný a měl by být vždy druhým prvkem. Odkazy na ikony reprezentující konkrétní hodnoty, například zobrazení ikony 5 pro hodnotu registru 2 má tvar: 002=Icon005. Vertikální umístění napravo od některého z tlačítek aktivujících uživatelské události. Má tvar UserEvent=X, kde X je číslo uživatelské události. Není-li uvedeno, umístí se do nultého napravo od tlačítka pro skrytí panelu. Horizontální pozice ikony v řádku má tvar Col=X, kde X je pořadí ikony v řádku. Není-li uvedeno, zařadí se ikona automaticky za ikonu předcházející. 3.1.9. Sekce [Modules] V sekci [Modules] jsou definovány HW adresy a názvy všech modulů připojených na lince APS Bus k řídícímu modulu MCA 167, na každém řádku jeden. Názvem parametru je HW adresa modulu, hodnota pak jeho jméno. 3.1.10. Sekce [Alerts] V sekci [Alerts] jsou umístěny definice jednotlivých upozornění, na každém řádku jedna. Název parametru musí být ve formátu XXXXXYYYYY, kde: XXXXX je HW adresa modulu na lince APS Bus, YYYYY je kód události. Hodnota parametru obsahuje tři definice (oddělené čárkou): Úroveň upozornění je číslo z intervalu <1;9>, kde 1 má význam upozornění informativního, 2 varovného a 3 poplachového (liší se barvou pozadí). Význam hodnot 4, 5 a 6 je postupně shodný s významem hodnot 1, 2 a 3, jejich zobrazení je navíc jednorázově zdůrazněno akusticky. U hodnot 7, 8 a 9 je akustický signál opakován až do zavření okna nebo utišení příkazem z lokální nabídky seznamu upozornění. Opakovaný akustický signál má přednost před jednorázovým. vlastní text upozornění URL dokumentu, který se má otevřít při zobrazení události **). 3.1.11. Sekce [AlertsWindow] *) V sekci [AlertsWindow] jsou umístěny informace o rozměrech a poloze okna upozornění systému a o velikosti písma, jímž jsou upozornění zobrazována. K jejich změnám se přistupuje identickým způsobem jako k vlastnostem panelu *) Takto označené sekce nejsou generovány programem nadministrator. *) Tato funkce je primárně určena pro zobrazení obrazu z IP kamer. strana 6
4. Použití programu 4.1. Ikona v oznamovací části panelu systému Windows Po spuštění programu se v oznamovací oblasti lišty systému Windows objeví ikona ve tvaru klíče indikující stav spojení programu s serverem.net a stav spojení nserveru.net s řídícím modulem (obr. 3.1). Stav připojení může být následující: Obr. 3.1: Stavová připojení k nserveru.net je navázáno a komunikace s řídícími moduly je bez chyb, ikona připojení k nserveru.net je navázáno, komunikace s řídícími moduly nepracuje správně, připojení k nserveru.net není navázáno. Po klepnutí pravým tlačítkem na ikonu se zobrazí menu nabízející v horní části příkazy pro aktivaci nakonfigurovaných uživatelských událostí a v dolní části příkazy pro otevření okna systémových zpráv, ovládacího panelu a případně okna prohlížeče s URL definovanou v konfiguraci. 4.2. Ovládací panel Ovládací panel (obr. 3.2) obsahuje tlačítka a vizualizační ikony definované v konfiguračním souboru programu, návod pro jeho používání je tedy nutné vytvořit vždy podle konkrétního významu ovládacích prvků. 4.3. Upozornění na události Obr. 3.2: Ovládací panel Upozornění na události systému (obr. 3.3) jsou zobrazovány v pop-up okně (není-li okno zobrazeno, automaticky vyskočí, jakmile obdrží upozornění). Každá zpráva je zobrazena v samostatném řádku, který je v závislosti na naléhavosti zprávy podbarven odpovídající barvou: Informativní modrá, varovné žlutá, poplachové červená. Obr. 3.3: Zprávy systému V tabulce je zobrazeno maximálně 100 upozornění (starší jsou nahrazována novými). strana 7