Integracja centrali INTEGRA z zewnętrznym programem – protokół integracji ETHM-1

Moduł ethernetowy ETHM-1 Plus oprócz standardowych funkcji i możliwości, udostępnia specjalny protokół integracyjny.

ETHM-1 plus – ethernetowy moduł komunikacyjny

Protokół integracyjny został stworzony po to, aby móc wymieniać dane pomiędzy centralą INTEGRA a zewnętrzną aplikacją lub urządzeniem. Te zewnętrzne aplikacje lub urządzenia to wyroby firm trzecich, które chcąc podnieść atrakcyjność swoich produktów, dokonali integracji swoich urządzeń z urządzeniami SATEL.

Takim przykładem jest np. kontrola dostępu ROGER. Tutaj integracja polega na współbieżnym przezbrajaniu stref. Jako moduł integrujący wykorzystano nie ETHM-1, ale specjalne urządzenie o nazwie „INT-RS” (obowiązuje ten sam protokół). Innym przykładem są systemy automatyki FIBARO. Tam również dokonano integracji pewnych funkcji, więc oba systemy (INTEGRA i FIBARO) mogą sterować sobą nawzajem.

Protokół integracyjny jest publicznie dostępny i można go ściągnąć ze strony producenta (dokumentacja PDF). W artykule pokażę ciekawy przykład zastosowania protokołu integracji. Przygotowałem aplikację, którą można pobrać na dole strony (niebieska belka). Aplikacja jest zbliżona wyglądem do znanego ekspandera wyjść INT-ORS. Jak łatwo się domyślić, program będzie miał za zadanie prezentowanie stanu 8 wyjść centrali. Dodatkowo, program umożliwia sterowanie tymi wyjściami (przyciski „On” i „Off”).

Tutaj należy pamiętać, że sterowanie będzie efektywne tylko wtedy, kiedy wyjście centrali jest zaprogramowane jako: Przełącznik MONO, Przełącznik BI, Roleta w górę, Roleta w dół.

Przygotowana aplikacja jest tylko przykładem użycia protokołu integracji. Pomimo swojej prostoty, może to być ciekawy program serwisowy to testowania urządzeń automatyki, które zostały podłączone do centrali INTEGRA. Odpytywanie centrali o stan jej wyjść odbywa się co 350 ms.

konfiguracja ETHM-1 plus z programu DLOADX?

Zakładam, że podstawowa konfiguracja modułu ETHM-1 już wcześniej została przeprowadzona (ustawiony adres IP, maska, brama, klucze itp.). W celu uruchomienia możliwości integrowania systemu INTEGRA z zewnętrznym oprogramowaniem, należy tylko włączyć opcję „Integracja” (dostępna w oknie konfiguracyjnym modułu ETHM-1). To jedyna czynność, którą należy wykonać po stronie centrali INTEGRA. Ze względu na prostotę programu, opcja „Kodowanie integracji” ma pozostać wyłączona. Warto jeszcze sprawdzić, jaki port sieciowy dotyczy integracji (domyślnie 7094) – przyda się później do konfiguracji prezentowanego programu ORSi.

Konfiguracja programu ORSi Montersi

W zakładce „Ustawienia” należy podać parametry takie jak:

• Adres IP modułu ETHM-1
• Port integracji
• Hasło użytkownika lub administratora
• Zakres wyjść centrali do sterowania

Po włączeniu programu, zostaje on automatycznie uzupełniony następującymi danymi:

• Adres IP: brak
• Port: 7094
• Hasło: 1111
• Wyjścia: 17 – 24

Z powyższego wynika, że wystarczy tylko wpisać adres IP modułu ETHM-1. Istnieje również możliwość zdefiniowania własnych parametrów, w tym możliwe jest również podanie adresu IP publicznego (jeśli na routerze zostanie ustawione przekierowanie portu).

Dostępny przycisk „Zapisz dane” umożliwia zapisanie wprowadzonych parametrów (oprócz hasła) do pliku „prefs.XML”. Plik jest tworzony na dysku twardym – w tej samem lokalizacji co plik programu. Kolejne uruchomienie programu ORSi automatycznie pobierze wcześniej zapisane dane. Dzięki temu nie ma konieczności każdorazowego uzupełniania danych.

Pobierz program   ORSi

Program został skompilowany dla .NET framework 4.5. Jeżeli nie chce się otworzyć, być może konieczna będzie aktualizacja .NET framework. Jeśli aplikacja przypadnie do gustu, warto w centrali stworzyć osobnego użytkownika (osobne hasło) na potrzeby tego programu.

Czy kod źródłowy jest dostępny?

Kod źródłowy tego programu nie jest udostępniony. Artykuł ma na celu zaprezentowanie możliwości użycia protokołu. Program jest darmowy. Jeśli takie zastosowanie przypadnie Wam do gustu, to w miarę możliwości powstaną kolejne artykuły opisujące możliwość integracji (i kolejne ciekawe programy).

Zmiany w programie:

15 października 2015 – nowa wersja 1.02. Dołożono przycisk do podglądu wprowadzonego hasła (zakładka ustawienia). Drobny lifting loga oraz kilku napisów. Optymalizacja funkcji liczenia sumy kontrolnej CRC oraz funkcji wymiany danych po TCP/IP (połączenie jest cały czas podtrzymywane, a nie nawiązywane z każdą transmisją). Nowa wersja dostępna cały czas pod tym samym linkiem (powyżej).

19 czerwca 2015 – wydano nową wersję aplikacji o numerze 1.01. Poszerzono przyciski On/Off oraz usprawniono funkcje komunikujące się po protokole TCP z modułem ETHM-1.