Warszawa 16.09.2013



BACnet_Aper WER. 1.0

INSTRUKCJA












Mrówcza 243

04-697 Warszawa

tel./fax (+48 22) 615-89-84

e-mail: tiger-soft@tiger-soft.com.pl

www: www.tiger-soft.com.pl






Spis treści

1) Wstęp
2) Instalacja programu
3) Rejestracja programu
4) Konfiguracja BACnet_Aper
5) Konfiguracja serwisu ASP.NET TSAper
6) Konfiguracja BMS
7) Uruchamianie i zatrzymywanie BACnet_Aper






1) Wstęp

    BACnet_Aper wer. 1.0 to program komunikacyjny umożliwiający połączenie systemu klasy BMS z oprogramowaniem Aper do obsługi kamer. Program może zostać podłączony do Aperu za pomocą sieci komputerowej.

Podstawowe cechy programu to:

  1. Bardzo efektywna metoda komunikacji, która używa tradycyjnej sieci komputerowej.
  2. Program pracuje jako usługa (service).Działa nawet po wylogowaniu się z systemu.
  3. Wielowątkowość umożliwiającą efektywne wykonywanie zadań komunikacyjnych bez znacznego obciążania procesora.
  4. Obsługa wszystkich istotnych komend i zdarzeń występujących w serwerze Aperu.
  5. Efektywna współpraca z nadrzędnym systemem komputerowym przez wykorzystanie BACnet/IP.
  6. Łatwa konfiguracja.
  7. Monitorowanie procesu komunikacji.
  8. Automatyczne wznawianie komunikacji po jej przerwaniu.


2) Instalacja programu

W celu zainstalowania programu należy uruchomić program BACnet_Aper_INSTALACJA. Program instalacyjny umieszcza pliki programu BACnet_Aper w katalogu domyślnym C:\Program Files\TIGER_SOFT\BACnet_Aper_1_0 lub w innym wybranym przez użytkownika w trakcie instalacji. Skróty do programu rejestracyjnego i instrukcji BACnet_Aper dostępne są z poziomu menu Start w grupie BACnet_Aper wer. 1.0. Główny program driver-a jest instalowany jako usługa (service).
W podkatalogu ASP znajduje się aplikacja ASP.NET, która pozwala na wyświetlenie obrazu z kamery w oknie przeglądarki internetowej Internet Explorer lub odtworzenie nagranego wcześniej obrazu.



3) Rejestracja programu

Po zainstalowaniu oprogramowania należy je zarejestrować wykorzystując w tym celu serwis internetowy firmy TIGER-SOFT. Najpierw trzeba uruchomić program REJESTRACJA PROGRAMU znajdujący się w grupie BACnet_Aper wer. 1.0. Program ten wygeneruje plik gen_lic.lic i umieści go w katalogu, w którym jest zainstalowany program. W następnym kroku należy połączyć się ze stroną http://www.tiger-soft.com.pl/Rejestracja/rejestracja.html, wypełnić formularz i uzyskać kod rejestracji. Kod ten należy skopiować do okienka edycyjnego w programie REJESTRACJA PROGRAMU i wcisnąć OK



4) Konfiguracja BACnet_Aper

Do konfigurowania driver-a służy plik Konfiguracja.kba umieszczony w tym samym katalogu co główny program BACnet_Aper.exe. Przykładowy plik przedstawiony jest poniżej.

# BACnet_Aper - plik konfiguracyjny

# KANAL - numer kanału
# AKTYWNY - aktywność kanału. Możliwe wartości TAK,NIE


# *****BACnet*****
# D_ID numer urządzenia(DEVICE) w BACnet.
# EVC numer obiektu typu Event Class.
# D_N nazwa urządzenia(DEVICE) w BACnet.
# EVC_N nazwa obiektu typu Event Class.
# L_IP lokalny adres ip.
# L_PORT port używany przez BACnet_Aper do komunikacji z systemem BMS.
# D_PORT - port używany przez komputery w sieci, dedykowany dla BACnet. Zwykle jest to port 47808.
# BACnet_TIMEOUT - Czas po którym w przypadku braku komunikacji BACnet zgłaszany jest błąd.
# Możliwe wartości z zakresu 1-9999 [s]
# N_P_ID - Numer procesu do którego będą wysyłane powiadomienia.
# N_P_A LUB N_P_F - priorytety powiadomień dla alarmów i uszkodzeń.
# N_P_N priorytet powiadomień potwierdzających, po potwierdzeniu przez użytkownika alarmu lub uszkodzenia.
# N_R_UDP - adres ip odbiorcy powiadomień (klienta UDP).
# ROUTER - adres ip router-a (UDP->ETHERNET)
# DNET - Local Network Number numer lokalnej sieci BACnet
# N_R_ETH - numer MAC odbiorcy powiadomień (klienta ETHERNET).

# *****Aper*****
# Aper_IP adres ip Aper (DVR)
# Aper_PORT port Aper (DVR)
# Aper_U nazwa uzytkownika
# Aper_P hasło
# Aper_KAMERY nazwy 16 kamer rozdzielonych znakiem $



# Lista punktów, które powinny być odczytywane z Aper, skonfigurowane w następującym formacie:
# dla typu 1,2
# Ttt$aa$A[al%al...]$F[f%f...]$EVCA[ALARM TEKST]$EVCF[FAULT TEKST]$EVCN[NORMAL TEKST]$MV
# ,gdzie tt-typ=1-2, aa-adres elementu (numer kanału) z zakresu 1-16,
# al - wartość punktu, która powinna być zgłaszana przez system jako alarm,
# f - wartość punktu, która powinna być zgłaszana przez system jako uszkodzenie,
# ALARM TEKST,FAULT TEKST,NORMAL TEKST - teksty, które będą używane w powiadomieniach.
# MV - numer objektu typu MV(Multi-state value). Dozwolone są wartości z zakresu 2-999999

# dla typu 5
# Ttt$aa$dd$TT$mp$pp$MV
# ,gdzie tt-typ=5, aa-adres elementu (numer kanału) z zakresu 1-16,
# dd-urządzenie BACnet wyzwalające alarm, TT-typ punkty,
# mp-numer punktu, pp-numer presetu na który będzie ustawiona kamery po przyjściu alarmu
# MV - numer objektu typu MV(Multi-state value). Dozwolone są wartości z zakresu 2-999999

# dla typów 6-9
# Ttt$aa$MV
# ,gdzie tt-typ=6-9, aa-adres elementu (numer kanału) z zakresu 1-16,
# MV - numer objektu typu MV(Multi-state value). Dozwolone są wartości z zakresu 2-999999


#******************************1******************************
KANAL=1
AKTYWNY=TAK

D_ID=1265
EVC=21
D_N=Aper1
EVC_N=AVI-EVC1
#L_IP=192.168.1.52
L_IP=10.10.1.140
#L_IP=192.168.2.140
L_PORT=47808
D_PORT=47808
BACnet_TIMEOUT=20
N_P_ID=1
N_P_A=100
N_P_F=120
N_P_N=150
#N_R_UDP=192.168.1.51
#N_R_UDP=192.168.1.3
N_R_UDP=10.10.1.141
#N_R_UDP=192.168.2.141
#ROUTER=192.168.1.220
DNET=19999
#N_R_ETH=00:05:1B:00:41:67
#N_R_ETH=00:07:E9:B0:7C:70

Aper_IP=77.252.226.51
Aper_PORT=7000
Aper_U=admin
Aper_P=000000
Aper_KAMERY=K1$K2$K3$K4$K5$K6$K7$K8$K9$K10$K11$K12$K13$K14$K15$K16


KOMUNIKACJA$EVCA[K1 Aper ALARM KOMUNIKACJI]$EVCN[K1 Aper NORMALNA KOMUNIKACJA]
#Stan połączenia z kamerą
T1$1$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$2
T1$2$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$3
T1$3$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$4
T1$4$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$5
T1$5$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$6
T1$6$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$7
T1$7$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$8
T1$8$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$9
T1$9$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$10
T1$10$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$11
T1$11$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$12
T1$12$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$13
T1$13$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$14
T1$14$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$15
T1$15$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$16
T1$16$A[]$F[]$EVCA[]$EVCF[BRAK KOMUNIKACJI Z KAMERA 1]$EVCN[]$17

#Stan nagrywania
T2$1$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$21
T2$2$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$22
T2$3$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$23
T2$4$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$24
T2$5$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$25
T2$6$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$26
T2$7$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$27
T2$8$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$28
T2$9$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$29
T2$10$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$30
T2$11$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$31
T2$12$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$32
T2$13$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$33
T2$14$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$34
T2$15$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$35
T2$16$A[]$F[]$EVCA[ALARM1]$EVCF[]$EVCN[]$36

#ALARMY
T5$1$1253$1$15$2$41

#STEROWANIA
#Ustawienie preset
T6$1$61
T6$2$62
T6$3$63
T6$4$64
T6$5$65
T6$6$66
T6$7$67
T6$8$68
T6$9$69
T6$10$70
T6$11$71
T6$12$72
T6$13$73
T6$14$74
T6$15$75
T6$16$76


#Ustawienie PTZ
T7$1$81
T7$2$82
T7$3$83
T7$4$84
T7$5$85
T7$6$86
T7$7$87
T7$8$88
T7$9$89
T7$10$90
T7$11$91
T7$12$92
T7$13$93
T7$14$94
T7$15$95
T7$16$96

#Nagrywanie zdalne
T8$1$98

#Nagrywanie lokalne
T9$1$99



#*************************************************************

 

5) Konfiguracja serwisu ASP.NET TSAper

W celu poprawnej pracy konieczne jest zainstalowanie i skonfigurowanie następujących elementów:

  1. Serwer IIS (internetowe usługi informacyjne) z rozszerzeniami(usługi WWW) ASP.NET i ISAPI
  2. Microsoft .NET Framework v.4.0.
    Należy zarejestrować go w IIS wykonując polecenie C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
    Trzeba również pozwolić na wykonywanie skryptów w inetmgr w korzeniu drzewa obiektów wybrać Ograniczenia ISAPI i CGI i pozwolić na ASP.NET v4.0.30319
  3. Dodać witrynę sieci Web i wskazać na katalog ASP w BACnet_Aper z odpowiednią pulą aplikacji obsługującą ASP.NET v4.0


Serwis internetowy jest konfigurowany za pomocą pliku Web.config. W sekcji appSettings można ustawić następujące parametry:
a) Aper_IPx, gdzie x-numer kanału. W polu value podaje się adres ip rejestratora.
b) Aper_PORTx, gdzie x-numer kanału. W polu value podaje się port rejestratora.
c) Aper_Ux, gdzie x-numer kanału. W polu value podaje się nazwę użytkownika dla rejestratora.
d) Aper_Px, gdzie x-numer kanału. W polu value podaje się hasło dla rejestratora.
e) Aper_KAMERYx, gdzie x-numer kanału. W polu value podaje się rozdzielone znakiem $ nazwy kamer dla danego kanału.
f) Aper_DDIRx, gdzie x-numer kanału. W polu value podaje się katalog na dysku lokalnym, gdzie będzie zapisywany obraz kamer przy nagrywaniu lokalnym.
g) rec_proc_idx, recordingx, gdzie x-numer kanału. Są to parametry wewnętrzne używane w procesie nagrywania.

Przykładowa konfiguracja przedstawiona jest poniżej:
<appSettings>
<add key="rec_proc_id1" value=""/>
<add key="Aper_IP1" value="77.252.226.51"/>
<add key="Aper_PORT1" value="7000"/>
<add key="Aper_U1" value="admin"/>
<add key="Aper_P1" value="000000"/>
<add key="Aper_KAMERY1" value="K1$K2$K3$K4$K5$K6$K7$K8$K9$K10$K11$K12$K13$K14$K15$K16"/>
<add key="Aper_DDIR1" value="D:\\Aper\\Download"/>
<add key="recording1" value=""/>


W katalogu ASP znajduje się również program Aper_rec biorący udział w procesie nagrywania lokalnego. Jego konfiguracja znajduje się w pliku Aper_rec.exe.CONFIG. Praktycznie jedynym parametrem, który należy dostosować jest adres serwisu REC.asmx. Przykładowy fragment pliku znajduje się poniżej.
<setting name="Aper_rec_TSAper_WS_REC" serializeAs="String">
<value>http://localhost:83/REC.asmx</value>
</setting>


Po poprawnym ustawieniu wszystkich elementów należy w przeglądarce Internet Explorer wywołać stronę Aper.aspx wprowadzając adres np. http://localhost:83/Aper.aspx?KANAL=1&K=4&S=1. Itnieją trzy parametry:
a) KANAL - numer kanału,
b) K - numer kamery,
c) S - podział ekranu pozwalający na wyświetlanie obrazu z wielu kamer(splite). S=1 - jedna kamera, 8 - 16 kamer.

W przypadku wywołania strony Aper.aspx bez parametrów strona użyje domyślnych parametrów tzn. KANAL=1, K=1, S=1
Strona oprócz wyświetlania obrazu z kamer pozwala na wykonywanie następujących operacji zdalnych na DVR:
a) Przesuwanie obrazu,
b) Start/stop nagrywania,
c) Start/stop odtwarzania.

i operacji lokalnych (z katalogu określonego w Aper_DDIRx):
d) Start/stop nagrywania,
e) Start/stop odtwarzania.

Sekcja Ustawienie czasu rozpoczęcia odtwarzania służy do ustawienia momentu od którego ma rozpocząć się odtwarzanie zdalne lub lokalne. Przykładowy wygląd serwisu prezentuje poniższy obraz.



6)Konfiguracja BMS.

Komunikacja z systemem BMS używa protokołu BACnet/IP. Każde oprogramowanie, które może przesyłać dane poprzez BACnet/IP powinno dobrze działać z BACnet-Aper. BACnet-Aper pojawia się w sieci jako urządzenie(device) skonfigurowane w Konfiguracja.kba (D_ID, D_N). Używa lokalnego adresu ip(L_IP) i portu zdefiniowanego w L_PORT. Wszystkie powiadomienia o alarmach i uszkodzeniach będą wysyłane do zdefiniowanych odbiorców UDP(D_PORT,N_R_UDP,N_P_ID) i odbiorców ETHERNET przez router BACnet(ROUTER, DNET, N_R_ETH) przez obiekt typu EVC. Każdy punkt powinien być widoczny w systemie BMS jako obiekty typu Multi-state Value.
Istnieje możliwość korzystania z BACnet_Aper i systemu BMS na tym samym komputerze z jedną kartą sieciową. Należy przypisać dwa adresy ip do zainstalowanej karty ethernet, np.: 10.10.1.121 i 10.10.1.122. Jeden z adresów powinien być wpisany do Konfiguracja.kba (L_IP). Drugi powinien być używany przez system BMS. BACnet-Aper i system BMS powinien używać tego samego portu, np. 47808.
Dodatkowo istnieje jeden obiekt powiadomień typu EVC, o nazwie skonfigurowanej w EVC_N, który odpowiada za wysyłanie powiadomień. Punkt KOMUNIKACJA podaje informację dotyczącą statusu komunikacji pomiędzy BACnet-Aper a centralą Aper central unit. Istnieją następujące, możliwe do skonfigurowania punkty:

Punkt

Typ

Nazwa BACnet

Możliwe wartości

KOMUNIKACJA

0 KOMUNIKACJA

1 - NIE
2 - TAK

Status połączenia z kamerą

1

T1_A0001 - T1_A9999

1- N
2 - PODŁĄCZONA
3 - ODŁĄCZONA

Status nagrywania

2

T2_A0001 - T2_A9999

1- N
2 - NAGRYWA
3 - NIE_NAGRYWA

Ustawienie alarmu

5

T5_A0001 - T5_A9999

1 - STOP
2 - START

Ustawienie kamery na Presecie

6

T6_A0001 - T6_A9999

1 - N
2 - PRESET 0
3 - PRESET 1
4 - PRESET 2
5 - PRESET 3
6 - PRESET 4
7 - PRESET 5
.
.
.
16 - PRESET 14

Ruch kamerą

7

T7_A0001 - T7_A9999

1 - N
2 - DÓŁ
3 - GÓRA
4 - DÓŁ_PRAWO
5 - DÓŁ_LEWO
6 - PRAWO
7 - LEWO
8 - GÓRA_PRAWO
9 - GÓRA_LEWO
10 - ZOOM+
11 - ZOOM-
12 - IRIS+
13 - IRIS-
14 - FOCUS+
15 - FOCUS-

Ustawienie nagrywania zdalnego na DVR

8

T8_A0001 - T8_A9999

1 - STOP
2 - START

Ustawienie nagrywania lokalnego

9

T9_A0001 - T9_A9999

1 - STOP
2 - START


 

Poniższy przykład prezentuje przykładowy ekran z oprogramowania klasy BMS Delta Controls Orca



Istnieje urządzenie(device) Aper1. Punkt KOMUNIKACJA pokazuje status komunikacji z centralą Aper. Obiekty typu multi-state value pokazuje statusy poszczególnych punktów.


 

7) Uruchamianie i zatrzymywanie BACnet_Aper

Program komunikacyjny można uruchomić i zatrzymać z poziomu menedżera usług systemu Windows. Można również skonfigurować usługę w ten sposób aby startowała automatycznie przy starcie systemu operacyjnego wybierając automatyczny tryb jej uruchamiania. Poprawność uruchomienia można kontrolować sprawdzając tekstowy plik Info.inf znajdujący się w głównym katalogu programu komunikacyjnego.