iHMS Satel Integra INT-RS

1. Program przykładowy

Program demo obsługuje dwie strefy alarmowe oraz 128 linii alarmowych. Odczyt oraz sterowanie odbywa się za pośrednictwem zmiennych zdefiniowanych w liście „LISTA_SATEL”.

Konfiguracja programu

Przed rozpoczęciem pracy z programem demo należy skonfigurować numer port RS na której mamy podłączoną centralę. Zrobimy to poprzez ustawienie zmiennej wejściowej bComPort w głównym bloku funkcyjnym fbSatelAlarmControl.

alarmsControl:fbSatelAlarmControl:=(bComPort:=2,cfFLOW_CONTROL:=0);

Przy wykonywaniu operacji na liniach/strefach potrzebny będzie również 4 cyfrowy kod użytkownika, który ustawiamy w zmiennej USER_CODE.

USER_CODE:STRING(8):=’1111′;

Odczyt stanu linii

Zmienne dotyczące stanu linii alarmowych zostały zdefiniowane następująco:

ZONE_VIOLATION:ARRAY[0..15] OF BYTE; – naruszenie

ZONE_TAMPER:ARRAY[0..15] OF BYTE; – sabotaż

ZONE_ALARM:ARRAY[0..15] OF BYTE; – alarm

ZONE_TAMPER_ALARM:ARRAY[0..15] OF BYTE; – alarm sabotażowy

ZONE_ALARM_MEM:ARRAY[0..15] OF BYTE; – pamięć alarmu

ZONE_TAMPER_ALARM_MEM:ARRAY[0..15] OF BYTE; – pamięć sabotażu

ZONE_BYPASS:ARRAY[0..15] OF BYTE; – blokada

ZONE_NO_VIOL_TROUBLE:ARRAY[0..15] OF BYTE; – brak naruszeń

ZONE_NO_LONG_VIOL_TROUBLE:ARRAY[0..15] OF BYTE; – długie naruszenie

Każda zmienna jest tablicą 16 bajtową. Kolejne bity tablicy odpowiadają kolejnym liniom(16 bajtów * 8 bitów = 128 linii).

Przykład odczytu naruszenia dla linii:

Naruszenie linii nr 1 – ZONE_VIOLATION[0].0;

Naruszenie linii nr 8 – ZONE_VIOLATION[0].7;

Naruszenie linii nr 12 – ZONE_VIOLATION[1].3;

To samo wykonane z pomocą funkcji pomocniczych:

Naruszenie linii nr 1 – getStatusBit(ADR(ZONE_VIOLATION), 0);

Naruszenie linii nr 8 – getStatusBit(ADR(ZONE_VIOLATION), 7);

Naruszenie linii nr 12 – getStatusBit(ADR(ZONE_VIOLATION), 11);

Funkcja pomocnicza getStatusBit oblicza za nas, który bajt ma zostać wybrany do odczytu na podstawie numeru linii. Pierwszy argument to adres tablicy ADR( ZONE_VIOLATION), a drugi to numer linii, którą chcemy odczytać. Linie numerujemy od 0 do 127.

Blokady linii

Sterowanie blokadą linii odbywa się poprzez tablicę ZONE_DO_BYPASS. W celu zablokowania danej linii należy ustawić odpowiedni bit na 1. Wyzerowanie bitu oznacza odblokowanie.

ZONE_DO_BYPASS:ARRAY[0..15] OF BYTE; – sterowanie blokadą linii

Przykład:

Zablokowanie linii nr 1: ZONE_DO_BYPASS[0].0 := TRUE;

Zablokowanie linii nr 8: ZONE_DO_BYPASS[0].7 := TRUE;

Zablokowanie linii nr 12: ZONE_DO_BYPASS[1].3 := TRUE;

Odblokowanie linii nr 1: ZONE_DO_BYPASS[0].0 := FALSE;

Odblokowanie linii nr 8: ZONE_DO_BYPASS[0].7 := FALSE;

Odblokowanie linii nr 12: ZONE_DO_BYPASS[1].3 := FALSE;

To samo z funkcją pomocniczą:

Zablokowanie linii nr 1: setStatusBit(ADR(ZONE_DO_BYPASS), 0, TRUE);

Zablokowanie linii nr 8: setStatusBit(ADR(ZONE_DO_BYPASS), 7, TRUE);

Zablokowanie linii nr 12: setStatusBit(ADR(ZONE_DO_BYPASS), 11, TRUE);

Odblokowanie linii nr 1: setStatusBit(ADR(ZONE_DO_BYPASS), 0, FALSE);

Odblokowanie linii nr 8: setStatusBit(ADR(ZONE_DO_BYPASS), 7, FALSE);

Odblokowanie linii nr 12: setStatusBit(ADR(ZONE_DO_BYPASS), 11, FALSE);

Funkcja pomocnicza setStatusBit oblicza za nas, który bajt ma zostać wybrany do odczytu na podstawie numeru linii. Pierwszy argument to adres tablicy ADR( ZONE_VIOLATION), a drugi to numer linii, którą chcemy odczytać. Linie numerujemy od 0 do 127. Trzecim argumentem jest wartość, którą chcemy ustawić(TRUE lub FALSE).

Odczyt stanu stref

Zmienne dotyczące stanu stref alarmowych zostały zdefiniowane następująco:

PART_ARM_SUPPR:ARRAY[0..3] OF BYTE; – tryb uzbrojenia 0

PART_ARM_REALLY:ARRAY[0..3] OF BYTE; – tryb uzbrojenia 1

PART_ARM_MODE_2:ARRAY[0..3] OF BYTE; – tryb uzbrojenia 2

PART_ARM_MODE_3:ARRAY[0..3] OF BYTE; – tryb uzbrojenia 3

PART_1ST_CODE:ARRAY[0..3] OF BYTE;

PART_ENTRY_TIME:ARRAY[0..3] OF BYTE; – czas na wejście

PART_EXIT_MORE_10:ARRAY[0..3] OF BYTE; – czas na wyjście > 10 s

PART_EXIT_LESS_10:ARRAY[0..3] OF BYTE; – czas na wyjście < 10 s

PART_TEMP_BLOCKED:ARRAY[0..3] OF BYTE; – blokada

PART_GUARD_CTRL:ARRAY[0..3] OF BYTE; – obchód

PART_ALARM:ARRAY[0..3] OF BYTE; – alarm

PART_FIRE_ALARM:ARRAY[0..3] OF BYTE; – pożar

PART_ALARM_MEM:ARRAY[0..3] OF BYTE; – był alarm

PART_FIRE_ALARM_MEM:ARRAY[0..3] OF BYTE; – był pożar

Kolejne bity tablicy odpowiadają kolejnym strefom alarmowym, a stan poszczególnych z nich odczytujemy w taki sam sposób jak w przypadku linii. Tablica składa się z 4 bajtów co odpowiada makysmalnej ilości stref 32.

Kontrola stref

Do kontroli stanu stref służą poniższe tablice:

PART_SET_ARM_MODE:ARRAY[0..31] OF BYTE;

PART_DO_CLEAR_ALARM:ARRAY[0..3] OF BYTE;

Uzbrajanie/rozbrajanie stref

Tablica PART_SET_ARM_MODE składa się z 32 bajtów z których każdy reprezentuje wybrany tryb uzbrojenia danej strefy. Strefy w tablicy numerujemy od indeksu 0. Np. PART_SET_ARM_MODE[0] przechowuje stan strefy pierwszej, a PART_SET_ARM_MODE[20] to stan strefy 21.

W celu uzbrojenia danej strefy należy ustawić wartość odpowiedniego bajtu w zakresie od 1-4. Wartość 0 oznacza rozbrojenie strefy.

0 – strefa rozbrojona

1 – tryb uzbrojenia 0

2 – tryb uzbrojenia 1

3 – tryb zubrojenia 2

4 – tryb uzbrojenia 3

Np.

Uzbrojenie strefy 1 w trybie 1:

PART_SET_ARM_MODE[0] := 2;

Uzbrojenie strefy 4 w trybie 3:

PART_SET_ARM_MODE[0] := 4;

Rozbrojenie strefy 1:

PART_SET_ARM_MODE[0] := 0;

Kasowanie alarmu stref

Kasowanie alarmu strefy odbywa się poprzez ustawienie bitu w tablicy PART_DO_CLEAR_ALARM odpowiadającego danej strefie. Po skasowaniu sterownik ustawia bit z powrotem na zero. Funkcja pomocnicza setStatusBit będzie pomocna przy adresacji tablicy.

Skasowanie alarmu strefy 1:

PART_DO_CLEAR_ALARM[0].0 := TRUE;

lub

setStatusBit(ADR(PART_DO_CLEAR_ALARM), 0, TRUE);

Skasowanie alarmu strefy 12:

PART_DO_CLEAR_ALARM[1].3 := TRUE;

lub

setStatusBit(ADR(PART_DO_CLEAR_ALARM), 11, TRUE);

Opis biblioteki

Biblioteka implementuje funkcje opisane w dokumentacji int-rs_p_pl_1.10.pdf. Poszczególne bloki funkcjne są kolejkowane poprzez sterownik centrali fbSatelAlarmControl, który definuje parametry pracy oraz ustawienia portu COM. Każdy z bloczków posiada zmienną wejściową EN, którą należy ustawić na TRUE w celu wykonania funkcji. Po zakończeniu odczytu/wykonaniu akcji zmienna wyjściowa UPDATE zostanie ustawiona na TRUE.

Struktury danych

1. SatelAlarmPanelCMD

3. SatelUserRights

Struktura przechowuje informacje o uprwnieniach użytkownika odczytywanych bloczkiem fbReadSelfInfoCmd. Więcej informacji w instrukcji Satel.

4. SatelUserType

Typ użytkownika odczytywany bloczkiem fbReadUserCmd.

Bloki funkcyjne

1. fbSatelAlarmControl

Bloczek definujący połączenie z centralą Satel. Wykorzystywany przez pozostałe bloczki do komunikacji z centralą i kolejkowania zadań. Wykorzystanie bloczka tak jak w programie przykładowym.

2. fbZonesStatus

Bloczek do odczytu stanu linii/czujek. Obejmuje funkcje opisane w instrukcji o numerach od 0x00 do 0x08 oraz 0x26

3. fbPartitionsStatus

Bloczek do odczytu stanu stref. Obejmuje funkcje opisane w instrukcji o numerach od 0x09 do 0x16 oraz 0x25 i 0x27

4. fbOutputsStatus

Bloczek do odczytu stanu wyjść.

5. fbDoorsStatus

Bloczek do odczytu stanu „otwarcia drzwi” lub „długiego otwarcia drzwi”.

6. fbRTC_BasicStatus

Bloczek do odczytu podstawowych informacji o centrali.

7. fbTroubles1Status

Bloczek do odczytu informacji o awariach. Strona 1.

8. fbTroubles2Status

Bloczek do odczytu informacji o awariach. Strona 2.

9. fbTroubles3Status

Bloczek do odczytu informacji o awariach. Strona 3.

10. fbTroubles4Status

Bloczek do odczytu informacji o awariach. Strona 4.

11. fbTroubles5Status

Bloczek do odczytu informacji o awariach. Strona 5.

12. fbTroublesMem1Status

Bloczek do odczytu informacji pamięci o awariach. Strona 1.

13. fbTroublesMem2Status

Bloczek do odczytu informacji pamięci o awariach. Strona 2.

14. fbTroublesMem3Status

Bloczek do odczytu informacji pamięci o awariach. Strona 3.

15. fbTroublesMem4Status

Bloczek do odczytu informacji pamięci o awariach. Strona 4.

16. fbTroublesMem5Status

Bloczek do odczytu informacji pamięci o awariach. Strona 5.

17. fbIntegraVersionCmd

Bloczek do odczytu wersji centrali Satel

18. fbStateUpdateCmd

Bloczek do monitorowania stanu centrali. Zwraca tablicę w której kolejne bity odpowiadają numerom funkcji od 0x00 do 0x27(stany linii i stref itd.). Jeżeli dany bit jest ustawiony na TRUE oznacza to zmianę wartości w funkcji od ostatniego odczytu. Po odczycie funkcji bit będzie ustawiony na 0. Przydatny do selektywnego odczytu danych zamiast pollingu po wszystkich funkcjach co znacznie usprawnia monitoring centrali.

19. fbPartitionCmd

Bloczek do wykonywania operacji na strefach:

0x80 – uzbrajanie w trybie 0

0x81 – uzbrajanie w trybie 1

0x82 – uzbrajanie w trybie 2

0x83 – uzbrajanie w trybie 3

0x84 – rozbrajanie

0x85 – kasowanie alarmu stref

20. fbZoneCmd

Bloczek do wykonywania operacji na liniach/czujkach:

0x86 – blokada linii/czujki

0x87 – anulowanie blokady linii/czujki

21. fbOutputsCmd

Bloczek do wykonywania operacji na wyjściach:

0x88 – wysterowanie stanu 1 na wyjściach

0x89 – wysterowanie stanu 0 na wyjściach

22. fbOpenDoorCmd

Bloczek do otwierania drzwi.

23. fbClearTroublesMemCmd

Bloczek kasuje pamięć o usterkach.

24. fbReadEventCmd

Bloczek do odczytu zdarzeń.

25. fbReadSelfInfoCmd

Bloczek do odczytu infromacji o naszym użytkowniku.

26. fbReadUserCmd

Bloczek do odczytu infromacji o innych użytkownikach.

27. fbUsersListCmd

Bloczek do odczytu listy użytkowników.

28. fbReadUserLocksCmd

Bloczek do odczytu „user locks”.

29. fbWriteUserLocksCmd

Bloczek do modyfikacji „user locks” danego użytkownika.

30. fbRemoveUserCmd

Bloczek do usuwania użytkowników.

31. fbCreateUserCmd

Bloczek do tworzenia nowych użytkowników.

32. fbChangeUserCmd

Bloczek do edycji instniejących użytkowników.