Daxi

Przegląd

Przeznaczenie urządzenia

Urządzenie Daxi stanowi zaawansowane rozwiązanie do sterowania obwodami elektrycznymi. Wyposażone jest w niezależne wyjścia, które umożliwiają sterowanie różnorodnymi elementami systemu, od prostych obwodów po bardziej skomplikowane moduły. Dzięki możliwości obsługi wielu czujników (np.: temperatury, wilgotności itd), Daxi jest nie tylko narzędziem do kontroli, ale również do monitorowania różnych parametrów w systemie.

Jednym z kluczowych atutów Daxi jest jego zdolność do automatycznego reagowania na sygnały i odczyty z podłączonych czujników i wejść cyfrowych. Użytkownik może zaprogramować urządzenie do wykonywania konkretnych działań (akcje), takich jak sterowanie określonym wyjściem czy wysyłanie powiadomień w odpowiedzi na konkretny sygnał itp.

Daxi może służyć jako narzędzie do planowania zadań czasowych, działając na bazie składni Cron charakterystycznej dla systemów Linux. W tej składni każdy wiersz reprezentuje jedno kryterium czasowe, które, gdy zostanie spełnione, inicjuje wyznaczoną komendę.

Daxi posiada wbudowane możliwości logiczne – Logic, Lua. Dzięki funkcjom logicznym i językowi Lua, urządzenie jest zdolne do przeprowadzania złożonych operacji logicznych bez konieczności korzystania z zewnętrznych kontrolerów. To sprawia, że Daxi jest nie tylko efektywnym, ale i elastycznym narzędziem dla każdego systemu automatyki.

Wreszcie, Daxi wspiera szereg popularnych protokołów komunikacyjnych, takich jak HTTP, HTTPS, MQTT, SNMP v2/v3, SMSApi, Modbus TCP i Modbus RTU, co czyni go kompatybilnym z wieloma innymi urządzeniami i systemami. Możliwość integracji z zewnętrznymi czujnikami Modbus dodatkowo rozszerza zakres jego zastosowania

Changelog

1.2 13 maja 2025

• Wersja oprogramowania v0.33
  • Dodano REST API
  • Zmieniono wygląd ekranu logowania do strony konfiguracyjnej modułu

1.1 31 marca 2025

• Wersja oprogramowania v0.31
  • Poprawiono działanie macierzy działań (Work Matrix)

1.0 7 marca 2025

• Wersja oprogramowania v0.29

Budowa urządzenia

Dane techniczne

Wymiary

Widok ogólny

Opis złącz

Złącza wyjść przekaźnikowych – Umożliwiają podłączenie zewnętrznych urządzeń do obsługiwanych wyjść:

Złącza górne – Poziom 2

1. Przycisk RESET
2. Przełącznik rozdzielacza zasilania PoE:
   • w pozycji górnej – Brak zasilania w switchu ETH1 PoE Out,
   • w pozycji dolnej – Zasilanie w switchu ETH1 PoE Out jest włączone.
3. Port switcha ETH1 – PoE OUT*
4. Port switcha ETH2 PoE 802.3 af*
5. Obsługiwane czujniki – Podłączone poprzez kabel RJ12, maksymalnie 16 czujników (połączone ze sobą w systemie daisy chain lub przy pomocy rozdzielacza BUS Expander)
6. Wejście anteny WiFi (opcja).

*Porty ETH1 i ETH2 są portami switcha, gdzie port ETH2 umożliwia zasilanie urządzenia Daxi za pomocą PoE 802.3af. W przypadku zasilania Daxi przez port ETH2 za pomocą PoE, port ETH1 staje się dostępny do zasilania kolejnego urządzenia. Jest to możliwe poprzez przełączenie switcha 2, co umożliwia przekazywanie zasilania PoE dalej. W takim systemie Daisy chain połączone mogą być maksymalnie dwa urządzenia (np. Daxi + Daxi).

Złącza dolne – Umożliwiają podłączenie obsługiwanych wejść oraz zasilania modułu Daxi (10-24V DC oraz opcjonalnie 230V AC):

Wejścia można podłączyć zarówno w trybie zwiernym jak i napięciowym

Schemat podłączenia w przypadku stosowania wejść typu zwiernego (wstępnie spolaryzowane):

Schemat podłączenia w przypadku stosowania wejść typu optoizolowanego (wejście napięciowe 10-24V DC):

Znaczenie diod LED

1. Stan wyjść
2. Stan wejść
3. Aktywne połączenie Wi-Fi:
   • Zgaszona: WiFi nieaktywne,
   • Świeci: WiFi aktywne,
   • Mruga: błąd w połaczeniu WiFi.
4. Link Ethernet 1
5. Link Ethernet 2
6. Stan magistrali czujników:
   • Zgaszona: magistrala czujników wyłączona,
   • Świeci: magistrala czujników aktywna,
   • Mruga: błąd na magistrali czujników.
7. Zasilanie urządzenia
8. Przycisk funkcyjny
9. Dodatkowe diody LED – ich przyporządkowanie definiuje użytkownik

Opis urządzenia

Urządzenie Daxi łączy w sobie programowalny kontroler I/O i kontroler czujników. Głównym zadaniem tego urządzenia jest zbieranie danych z czujników oraz wejść, ich przetwarzanie i wykonywanie odpowiednich operacji (akcji) wykonawczych.
Konfiguracja urządzenia odbywa się przez przeglądarkę internetową.

Schemat blokowy:

Moduł jest wyposażony w zegar czasu rzeczywistego z podtrzymaniem bateryjnym, który pozwala na wykonywanie funkcji powiązanych z czasem, dzięki czemu można wykonywać akcje cykliczne oraz o ustawionych porach. Dodatkowym udogodnieniem jest zegar astronomiczny, dzięki któremu możliwe jest sterowanie w zależności od godzin wschodu i zachodu słońca w danej lokalizacji. Zegar może być aktualizowany czasem z serwera NTP przez Internet.

Czujniki

Czujniki czynników środowiskowych podłączone są do urządzenia za pośrednictwem 3-przewodowej magistrali w formie kabla płaskiego RJ12, do której może być podłączone maksymalnie 16 czujników. Dla ułatwienia prowadzenia instalacji, czujniki posiadają dodatkowe złącze, służące do podłączenia kolejnego czujnika.

Urządzenie obsługuje następujące czujniki:

• Temperatury,
• Wilgotności,
• Zalania wodą,
• Zaniku fazy/zaniku prądu,
• Jasności światła,
• Ciśnienia powietrza,
• Ciśnienia wody,
• Gazów CO/CO₂/ NOₓ,
• Otwarcia drzwi (kontaktron).
• Inne na specjalne zamówienie.

W formie jednego czujnika może być obsługiwane kilka składowych pomiarów.
Dane z czujników mogą być zapisywane we wbudowanej pamięci i przeglądane w późniejszym czasie. Dane mogą być pobierane w różnych formatach. Dla wygody jest także udostępnione przeglądanie przy użyciu wykresów. Każdy czujnik ma możliwość ustawienia progów, po których przekroczeniu urządzenie wykona określoną czynność (Akcję).

Źródłem sensora może być magistrala 3-przewodowa, urządzenie odpytywane przez protokół Modbus TCP/RTU (np.: mierniki, liczniki, termometry) lub inne urządzenie Inveo obsługujące czujniki. Każdy z wymienionych odczytów z zewnętrznych urządzeń może zostać przypisany jako sensor w urządzeniu Daxi i wykonywać wszystkie funkcje przynależne sensorom.

Akcje

Funkcje wykonywane przez moduł są dostępne w postaci bloków, definiowanych przez użytkownika. Akcja jest zbiorem funkcji wykonywanych przez moduł przy jej wywołaniu.
Akcja jest wywoływana np. przy przekroczeniu temperatury, zmianie wejścia, utracie połączenia, itp. Do każdego z takich zdarzeń można przypisać inną Akcję lub współdzielić Akcję między kilkoma zdarzeniami.

Akcja może zawierać następujące działania (jedno lub wiele):

• Wysterowanie wyjścia,
• Wysłanie żądania HTTP,
• Wysłanie wiadomości E-Mail,
• Wysłanie SNMP Trap,
• Wysłanie SMS,
• Wysłanie komunikatu MQTT,
• Wysłanie danych przez UDP/TCP,
• Wysłanie komunikatu KNX,
• Zapis do zmiennej wewnętrznej,
• Zapis do pamięci logów.

Akcje mogą być wywoływane jednorazowo – np. przy zmianie wejścia lub w ustawionych rygorach czasowych.

Wejścia

Każde wejście wyposażone jest w licznik impulsów, filtr zakłóceń, możliwość odwrócenia stanu.

Wbudowane algorytmy umożliwiają realizację wielu użytecznych funkcji takich jak:

• Proste zależności załącz-wyłącz,
• Wykrywania dłuższego przyciśnięcia – pozwalającą przy użyciu np. jednego przycisku sterować 2 akcjami,
• Zliczania załączeń i dopiero po upłynięciu zadanego czasu wywołaniu odpowiedniej funkcji (nawet do 4 różnych funkcji) – umożliwia sterowanie z jednego przycisku do nawet 4 oddzielnych obwodów/urządzeń,
• Porównywania częstotliwości impulsów do zadanej wartości i wykonanie odpowiedniej akcji przy zmianie,
• Standardowego zliczania impulsów na wejściu i np. wysyłania tych danych do serwera.

Schemat przepływu wejścia:

Poza wejściami fizycznymi, moduł posiada wejścia wirtualne, do których można przekierować dane z innych źródeł, takich jak:

• Urządzenia Modbus,
• Inne urządzenia Inveo,
• Stany wewnętrzne urządzenia tj.: stan alarmowy z czujnika, stan połączenia z brokerem MQTT lub zmiennej wewnętrznej - na podstawie tych wartości można przypisać funkcję, która spowoduje np. wysłanie e-mail informującego, że czujnik jest uszkodzony lub nie ma połączenia z brokerem MQTT.

Wyjścia

Wyjścia urządzenia mogą pracować w następujących trybach:

• Bistabilny – Załącz/wyłącz,
• Astabilny – Ciągłe naprzemienne załączanie/wyłączanie co określony czas,
• Czasowy – Załączenie wejścia powoduje jego aktywację na zadany czas,
• Roletowy – Grupuje 2 wyjścia do pracy z zasłonami/roletami.

Do wyjść mogą być przypisane przekierowania z innego źródła (np. wejścia, stany kanałów zewnętrznych modułów, stany połączeń z zewnętrznymi modułami, zmienne wewnętrzne, stany alarmowe czujników). Wyjścia mogą być dopisane do grup KNX i reagować na przychodzące komunikaty. Dodatkowo udostępnione są wyjścia wirtualne, które umożliwiają przekierowanie wyjścia do zewnętrznych modułów Modbus, Inveo lub zmiennych wewnętrznych np.: stany alarmowe z schematu czujnika, stan połączenia z brokerem MQTT

Moduł logiki

Użytkownik może łączyć dowolną funkcją logiczną stany urządzenia (np. stan wejścia, wyjścia, stan sensora, zmiennych, itp.) i w zależności od wyniku sterować wyjściami lub wywoływać Akcje. Dla zaawansowanych użytkowników został opracowany interpreter Lua który umożliwia nieograniczone sterowanie funkcjami urządzenia.

Integracja z systemami inteligentnych budynków

Wbudowana obsługa protokołu KNX-IP ułatwia integrację urządzenia z automatyką budynkową. Przy użyciu funkcji logicznych i czasowych, jest możliwe zbudowanie dowolnych zależności, które można wykorzystać do sterowania budynków.

Integracja z innymi urządzeniami

Urządzenie obsługuje szereg protokołów sieciowych, które umożliwiają wymianę danych, takich jak HTTP(S), MQTT(S), MODBUS, SNMP, KNX, TCP/UDP, Email, SMS.

Integracja z chmurą

Dostęp z dowolnego miejsca do danych z urządzenia jest możliwy przez aplikacje chmurowe, np. jak CEAppMonitor https://cemonitorapp.com/free/inveo.

Serwer i klient Modbus

Wbudowany moduł odpytywania Modbus odczytuje dane z innych urządzeń i udostępnia je jako źródło danych dla wejść, wyjść i sensorów. Urządzenie może być także odpytywane przez inne urządzenie Modbus, przez co jest możliwość zintegrowania urządzenia z modułami wejść/wyjść, czujnikami, sterownikami PLC, itp.

Integracja z urzązeniami Inveo

Moduł rozpoznaje inne urządzenia produkcji Inveo w sieci i umożliwia dostęp do nich z poziomu urządzenia (integrator). Umożliwia to np. konfigurację czujnika temperatury, który będzie pobierał dane z odległego punktu lub podłączenie wejścia lub wyjścia do zdalnego urządzenia. Urządzenie współpracuje z modułami Nano, Hero, Lantick i Iqio.

Kontrola stanu urzązeń sieciowych

Moduł umożliwia sprawdzanie stanu innych urządzeń podłączonych do sieci LAN/Wifi wysyłając cyklicznie pakiety ICMP (Ping). W zależności od stanu tych urządzeń, moduł może wysłać powiadomienie lub zresetować urządzenie.

Usprawnienia

Do dyspozycji użytkownika jest szereg ułatwień takich jak:

• Centrum Powiadomień (Notifications) – Funkcja szybkiego ustawienia powiadomień, bez konieczności tworzenia akcji i zaawansowanych konfiguracji,
• Kreator Akcji
• Debuger – Konsola systemowa z komunikatami pomocnymi w diagnostyce działania urządzenia,
• Work matrix – Funkcja szybkiego przypisania grup KNX do wszystkich wyjść jednocześnie lub skonfigurowaniu komunikatów HTTP/KNX/UDP/TCP dla wejść,
• Schedule – Funkcje czasowe – cykliczne oraz w formie wyrażenia CRON.

Konfiguracja sieciowa

Przy pierwszym uruchomieniu, konieczne jest skonfigurowanie urządzenia. Można to zrobić na dwa sposoby. Najprostszą metodą jest skorzystanie z programu Discoverer firmy Inveo.

Zmiana adresu IP urządzenia poprzez program Discoverer

Po uruchomieniu programu Discoverer i wyszukaniu odpowiedniego urządzenia należy:

1. Kliknąć urządzenie prawym przyciskiem myszy
2. Wcisnąć przycisk Change settings

Po otwarciu okna dialogowego można:

• Ustawić odpowiedni adres IP, maskę, bramę, DNS1/DNS2,
• Zmienić nazwę Hosta.

W przypadku wyłączonej opcji Remote Config (domyślnie włączona) konieczne jest skonfigurowanie urządzenia poprzez zmianę podsieci komputera (Jak to zrobić zostanie opisane niżej).

Aby włączyć opcję zdalnej konfiguracji:

1. Wejdź w zakładkę Administration,
2. W oknie Access configuration zaznacz opcję Enable Remote Config.

Zmiana podsieci komputera do konfiguracji

Przy konfiguracji urządzenia z pominięciem aplikacji Discoverer należy najpierw zmienić adres podsieci komputera podłączonego do tej samej sieci.

Aby przejść do konfiguracji sieci komputera, wykonaj jedną z poniższych czynności:

• Naciśnij Win + R, wpisz ncpa.cpl, a następnie naciśnij Enter.
• Alternatywnie przejdź do:
  Start → Panel Sterowania → Sieć i Internet → Centrum sieci i udostępniania → Zmień ustawienia karty sieciowej.

Następnie:

1. Wybierz połączenie sieciowe.
2. Kliknij je prawym przyciskiem myszy i wybierz Właściwości.
3. Po wybraniu tej opcji pojawi się ekran konfiguracji połączenia sieciowego.

Następnie należy wybrać ustawienie Protokół internetowy (TCP/IP) i wpisać następujące parametry:

Konfiguracja ustawień sieciowych

Aby dostosować ustawienia sieciowe urządzenia, należy przejść do zakładki Administration / Network. Tutaj możliwe jest skonfigurowanie parametrów takich jak adres IP, maska podsieci, brama, DNS oraz inne specyficzne dla sieci opcje. Zakładka ta umożliwia zarówno konfigurację sieci przewodowej (sekcja Ethernet network configuration), jak i bezprzewodowej (sekcja WLAN network configuration).

• DHCP – załączanie / wyłączanie funkcji serwera DHCP,
• IP – adres IP urządzenia,
• Netmask – maska podsieci IP,
• Gateway – brama sieciowa,
• DNS1, DNS2 – adresy serwerów DNS.

• Wi-Fi – załączanie / wyłączanie obsługi sieci bezprzewodowej Wi-Fi,
• DHCP – załączanie / wyłączanie funkcji serwera DHCP w sieci Wi-Fi,
• IP – adres IP urządzenia,
• Netmask – maska podsieci IP,
• Gateway – brama sieciowa,
• DNS1, DNS2 – adresy serwerów DNS,
• Encryption – wybór rodzaju szyfrowania Wi-Fi:
  • Open,
  • WEP,
  • WPA-PSK,
  • WPA2_PSK,
  • WPA_WPA2_PSK,
  • WPA3_PSK.
• SSID – nazwa sieci,
• Password – hasło dostępu do sieci Wi-Fi.

Instrukcja konfiguracji połączenia Wi-Fi

1. Przez trzy minuty od momentu podłączenia zasilania, istnieje możliwość konfiguracji połączenia Wi-Fi. Należy w tym celu nacisnąć i przytrzymać przycisk RESET (w górnej części urządzenia), aż na panelu urządzenia zacznie migać dioda LED Wi-Fi.
2. Włącz wyszukiwanie dostępnych sieci Wi-Fi na swoim telefonie lub innym urządzeniu.
3. Pojawi się sieć o nazwie "Inveo-wifi-config" – należy się z nią połączyć.
4. Gdy połączenie zostanie nawiązane, wciśnij przycisk scan w interfejsie konfiguracyjnym lub wpisać nazwę SSID sieci Wi-Fi w polu SSID.
5. Wybierz sieć, do której urządzenie ma być podłączone z listy dostępnych.
6. Wprowadź odpowiednie hasło do wybranej sieci.
7. Jeżeli serwer DHCP jest niedostępny, można skonfigurować ustawienia sieci ręcznie po odznaczeniu opcji DHCP.
8. Jeżeli ustawienia zostaną pomyślnie zapisane, pojawi się napis SUCCESS. Moduł zresetuje się automatycznie i przystąpi do normalnej pracy.

Konfiguracja urządzenia

Interfejs www modułu

Interfejs strony internetowej umożliwia intuicyjne zarządzanie urządzeniem. Po wpisaniu adresu IP urządzenia do przeglądarki, otwiera się strona umożliwiająca pełną konfigurację i dostosowanie parametrów pracy urządzenia według indywidualnych potrzeb użytkownika. Po lewej stronie ekranu znajduje się lista zakładek umożliwiających szybki dostęp do różnych funkcji i ustawień. Dostępne zakładki:

W górnej części strony znajduje się pasek informacyjny, dostarczający kluczowych danych o urządzeniu, takich jak model, adres IP, unikalna nazwa nadana przez użytkownika, numer wersji oprogramowania i adres MAC.

Dzięki stronie internetowej użytkownik może modyfikować ustawienia, konfigurować parametry oraz monitorować działanie urządzenia w czasie rzeczywistym. Strona internetowa jest centralnym punktem kontroli, umożliwiającym efektywne zarządzanie i dostosowanie urządzenia do zmiennych potrzeb użytkownika.

Podgląd stanu urządzenia

W zakładce Status można znaleźć wszystkie informacje na temat aktualnie obsługiwanych wyjść, wejść, odczytów z czujników itp.

graph TB
  A[Status] --> B[Sensors]
  A --> C[Outputs]
  A --> D[Inputs]

Okno Sensors

W oknie wyświetlane są aktualne odczyty z czujników zdefiniowanych w zakładce Sensors.

Za pomocą przycisku Enable autorefresh można włączyć automatyczne odświeżanie odczytów.

W poszczególnych kolumnach tabeli z danymi czujników można znaleźć następujące dane:

• Name – Nazwa czujnika określona w zakładce Sensors,
• Type – Graficzne odwzorowanie typu czujnika:
  • – Czujnik temperatury,
  • – Czujnik wilgotności,
  • – Wejście,
  • – Czujnik analogowy prądowy 4-20mA,
  • – Czujnik ciśnienia,
  • – Czujnik analogowy napięciowy 0-10V DC,
  • – Czujnik obecności tlenku węgla (CO),
  • – Czujnik obecności dwutlenku węgla (CO2).
• State – Stan czujnika:
  • Error – Błąd odczytu (uszkodzony czujnik, nieprawidłowo podłączony itp.),
  • Normal – Czujnik dostarcza prawidłowe odczyty, które są w granicach normy,
  • Warn L – Ostrzeżenie niskiego poziomu,
  • Warn H – Ostrzeżenie wysokiego poziomu,
  • Alert L – Stan alarmu niskiego poziomu,
  • Alert H – Stan alarmu wysokiego poziomu.
• Last value – Ostatnia odczytana wartość,
• Last read – Czas, jaki upłynął od ostatniego odczytu (wartość aktualizowana na bieżąco przy włączonym automatycznym odświeżaniu).

Okno Outputs

W oknie wyświetlany jest aktualny stan wyjść obsługiwanych przez urządzenie, zdefiniowanych w zakładce I/O Settings.

W poszczególnych kolumnach tabeli z danymi wyjść można znaleźć dane:

• Name – Nazwa wyjścia (nadawana przez użytkownika w zakładce I/O Settings).

Dostępne są następujące rodzaje wyjść:

• Cyfrowe – DO – Fizyczne wyjście modułu,
• Wirtualne – VO (opcja) – Wyjścia wirtualne stosowane przy tworzeniu powiązań i zależności.

W przypadku, gdy stan wyjścia jest uzależniony od innych czynników pod jego nazwą wyświetlana jest odpowiednia informacja:

• output unavailable – assigned to the shutter – Wyjście przypisane do sterowania roletami,

• output unavailable – output is routed – Wyjście odzwierciedlające stan np.: wejścia, innego wyjścia itp., patrz rozdział Powiązania (Binding).

• Off/On – aktualny stan wyjścia, naciśnięcie lewego przycisku myszy w tym obszarze spowoduje zmianę stanu wyjścia – opcja ta umożliwia ręczne sterowanie wyjściami,

• Coil state – aktualny stan cewki przekaźnika – kolor zielony oznacza włączony przekaźnik.

Załączenie wyjścia (widoczne w kolumnie Off/On w tabeli) nie zawsze jest tożsame ze stanem cewki (widocznym w kolumnie Coil state w tabeli).

Okno Inputs

W oknie wyświetlany jest aktualny stan wejść obsługiwanych przez urządzenie, zdefiniowanych w zakładce I/O Settings.

W poszczególnych kolumnach tabeli z danymi wyjść można znaleźć dane:

• Name – Nazwa wejścia (edytowalna w zakładce I/O Settings),
• In state – Stan wejścia,
• Last action – Ostatnia zarejestrowana akcja wejścia (np. Action On),
• Counter – Licznik, wyświetlający informację o ilości aktywacji wejść od ostatniego zresetowania,
• Clear – Przycisk RESET umożliwia wyzerowanie licznika.

Podgląd stanu urządzenia przy użyciu zasobu JSON

Stan urządzenia można uzyskać odwołując się do zasobu JSON: http://adres_ip/data/status.json

{
"status": {
    "model": "Daxi-8-8",
    "name": "",
    "mac": "00:00:00:00:00:00",
    "output": [
    {
        "name": "DO 0",
        "on": 0,
        "coil": 0
    },
    {
        "name": "VO 8",
        "on": 0,
        "coil": 0
    },
    ],
    "input": [
    {
        "name": "Input 0",
        "state": 1,
        "action": 2,
        "cnt": 1
    },
    ],
    "shutter": [
    {
        "name": "Shutter 0",
        "isTop": 0,
        "isBottom": 0,
        "currentTask": "idle",
        "currentPos": 0
    },
    ],
    "repeat_next": [10961, 10961, 10961, 10961],
    "sensor": [
    {
        "id": 0,
        "name": "",
        "value": 0,
        "unit": "",
        "state": 6,
        "last": 109614
    },
    ],
    "logic": 0,
    "virtstate": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    "sntp_update": 1746510872,
    "mqtt_conn": 0,
    "fw": "0.32",
    "sunrise": "07:54",
    "sunset": "19:59",
    "time": "07:57:08",
    "date": "06-05-2025"
}
}

• model – Model urządzenia,
• name – Nazwa modułu ustawiona przez użytkownika,
• mac – Adres MAC modułu,
• output – Wyjścia:
  • name – Nazwa wyjścia,
  • on – Stan wyjścia,
  • coil – Stan cewki przekaźnika.
• input – Wejścia:
  • name – Nazwa wejścia,
  • state – Stan wejścia – 0 – wejście nieaktywne, 1 – wejście aktywne,
  • action – Ostatnia akcja wejścia – 1 – Action On, 2 – Action Off,
  • cnt – Wartość licznika wejścia.
• shutter – Roleta:
  • name – Nazwa wyjścia rolety,
  • isTop – Roleta w górnym położeniu,
  • isBottom – Roleta w dolnym położeniu,
  • currentTask – Aktualnie wykonywane zadanie,
  • currentPos – Aktualne położenie rolety.
• repeat_next – Czas do wykonania kolejnej akcji periodycznej (jeśli zdefiniowana),
• sensor – Czujnik:
  • id – Numer ID czujnika,
  • name – Nazwa czujnika,
  • value – Wartość zmierzona,
  • unit – Jednostka miary,
  • state – Stan czujnika,
  • last – Ilość czasu od ostatniego odczytu (w sekundach).
• virtstate – Wartości zmiennych wewnętrznych,
• sntp_update – Ostatni czas pobrany z serwera SNTP w formacie Unix,
• mqtt_conn – Stan połączenia z brokerem MQTT,
• fw – Wersja oprogramowania,
• sunrise – Obliczona godzina wschodu słońca,
• sunset – Obliczona godzina zachodu słońca,
• time – Czas urządzenia w momencie wywołania zasobu,
• date – Data.

Konfiguracja wejść / wyjść

W zakładce I/O Settings użytkownik ma dostęp do zaawansowanych opcji konfiguracyjnych, które umożliwiają dokładne zdefiniowanie działania urządzenia. W tym miejscu można określić, jak będą zachowywać się poszczególne wejścia oraz wyjścia. Dodatkowo, dla tych, którzy chcą dostosować sposób prezentacji danych, zakładka ta daje również możliwość konfiguracji wyświetlacza.

graph TB
  A[I/O Settings] --> B[Outputs]
  A --> C[Shutters]
  A --> D[Inputs]
  A --> E[LED]

Outputs

Zakładka umożliwia konfigurację wyjść obsługiwanych przez urządzenie – zarówno fizycznych jaki wirtualnych (opcja). W poszczególnych kolumnach można zmienić następujące ustawienia:

• Name – Pole umożliwia zmianę nazwy wyjścia,

• Mode – Tryb pracy wyjścia:

  • Disable – Wyłączenie obsługi wyjścia,
  • Bistable – Tryb bistabilny,

  

• Astable – Tryb cykliczny – wyjście jest załączane w określonych odstępach czasu (parametr Time on) na określony czas (parametr Time off),

• One-pulse – Tryb jednokrotnego załączenia wyjścia, w którym wyjście zostaje załączone na określony czas (parametr Time on) po upływie określonego czasu (parametr Time off),

• Time on – Czas załączenia wyjścia (parametr wykorzystywany w trybie Astable oraz One-pulse),
• Time off – Czas wyłączenia wyjścia (parametr wykorzystywany w trybie Astable oraz One-pulse).

Naciśnięcie lewego przycisku myszy w obszarze Advanced configuration umożliwia zmianę zaawansowanych ustawień wyjść modułu:

• Name – Pole umożliwia zmianę nazwy wyjścia,
• Power-on state – Stan, który wyjście ma osiągnąć po podłączeniu zasilania modułu:
  • Off – Wyłączone,
  • On – Załączone,
  • Last – Ostatni stan przed odłączeniem zasilania.
• Invert – Zmiana stanu bazowego kanału wyjściowego:
  • NO – Normalnie otwarty,
  • NC – Normalnie zamknięty.
• Text ON – Tekst wyświetlany na wyświetlaczu LED przy wyjściu załączonym,
• Text OFF – Tekst wyświetlany na wyświetlaczu LED przy wyjściu wyłączonym.

Shutters

Zakładka pozwala na konfigurację obsługi rolet. W trybie sterowania roletami, urządzenie Daxi automatycznie przełącza jeden z dwóch przekaźników, co skutkuje otwieraniem lub zamykaniem rolety.

W poszczególnych kolumnach można zmienić następujące ustawienia:

• Shutter name – Definiowana przez użytkownika nazwa rolety,
• Output up – Umożliwia wybór wyjścia obsługującego przekaźnik podnoszący roletę,
• Output down – Umożliwia wybór wyjścia obsługującego przekaźnik opuszczający roletę,
• Time – Czas potrzebny do całkowitego otwarcia / zamknięcia rolety, wyrażony w sekundach,
• KNX read – Przypisanie do grupy KNX.

Inputs

Zakładka umożliwia konfigurację wejść obsługiwanych przez urządzenie. W poszczególnych kolumnach można zmienić następujące ustawienia:

• Name – Pole umożliwia zmianę nazwy wejścia,
• Invert – Zmiana stanu bazowego kanału wejściowego,

• Action type – Tryb wyzwalania akcji przypisanych do wejścia:

  • Standard – Akcja wywoływana jest przez włączenie/wyłączenie wejścia,

  

• Hold – Wywołanie określonej akcji zależne jest od długości impulsu na wejściu. Impuls na wejściu wywołuje zdarzenie opisane jako Action on. Jeśli impuls trwa nadal i przekroczy czas określony w polu Parameter – wywołana zostaje akcja opisana jako Action Hold on. Jeśli przed upłynięciem czasu określonym w polu Parameter nastąpi przerwanie impulsu – wywołana zostanie Action off. Jeśli przerwanie impulsu nastąpi po czasie określonym w polu Parameter – wywołana zostanie akcja Action hold off,

• Cnt – Licznik impulsów w określonym przedziale czasowym – akcję wywołuje określona liczba włączeń występująca w przedziale czasowym zdefiniowanym w polu Parameter,

Akcja zostaje wywołana jedynie w sytuacji, gdy w określonym czasie (wartość wprowadzona w polu Parameter) nie wystąpi kolejny impuls (wejście nie zostanie włączone po raz kolejny). Określona akcja zostaje wywołana po upłynięciu czasu – czas opóźnienia od momentu zakończenia impulsu na wejściu (np.: zwolnienie włącznika). Jeśli w trakcie tego opóźnienia wystąpi nowe zdarzenie (kolejny impuls) to odliczanie opóźnienia jest przerywane.

Wywołanie akcji I:

Wywołanie akcji II:

Wywołanie akcji III:

Wywołanie akcji IV:

• Toggle – Kolejne impulsy na wejściu wywołują naprzemiennie Action I / Action II,

• Freq – Wywołanie akcji zależne jest od częstotliwości impulsów na wejściu. Wartość pożądanej częstotliwości należy wprowadzić w polu Parameter – wyrażone w Hz,

• Parameter – Wartość stosowana w różnych schematach aktywacji działań. Po umieszczeniu kursora myszy nad polem wprowadzania ukazuje się jednostka, w której jest przedstawiony dany parametr, na przykład Hz dla typu Freq,
• Text ON – Tekst wyświetlany na wyświetlaczu LED przy wejściu aktywowanym,
• Text OFF – Tekst wyświetlany na wyświetlaczu LED przy wejściu dezaktywowanym.

Przycisk Go to the input actions umieszczony w prawym górnym rogu umożliwia szybkie przejście do zakładki Action/Inputs.

LED

W zakładce LED można skonfigurować ustawienia sygnalizacji LED na urządzeniu Daxi.

• Power saving mode – Parametr umożliwia załączenie trybu oszczędzania energii – po określonym czasie (wyrażonym w sekundach) diody LED na urządzeniu zostaną wygaszone, ponowne włączenie następuje po naciśnięciu przycisku RESET,
• LED #0 .. LED #3 – Parametr pozwala dostosować dodatkowe diody LED – INFO A/B/C/D, aby reagowały zgodnie z ustawionymi preferencjami działania.

Poniższe komendy można wykorzystać do programowania dodatkowych diod LED (x oznacza numer kanału wyjściowego / wejściowego / czujnika itd.):

• i[x] – Stan kanału wejściowego x,
• o[x] – Stan cewki kanału wyjściowego x,
• o[x].on – Stan kanału wyjściowego x,
• v[x] – Stan zmiennej wirtualnej,
• s[x].aHi – Alarm wysokiego stanu czujnika x,
• s[x].aLo – Alarm niskiego stanu czujnika x,
• s[x].wHi – Stan wysoki ostrzeżenia czujnika x,
• s[x].wLo – Niski stan ostrzeżenia czujnika x,
• s[x].err – Błąd czujnika x,
• s[x].ok – Czujnik x w stanie normalnym,
• ping[x] – Status ping: 0 - błąd, 1- sukces,
• poll[x].y – Wartość pollera,
• Urządzenie zewnętrzne:
  • dev[x].err – Utrata połączenia,
  • dev[x].o[y] – Wyjście zewnętrzne,
  • dev[x].i[y] – Wejście zewnętrzne,
  • dev[x].s[y].err – Błąd czujnika zewnętrznego.
• Negacja i operacje logiczne (|/&/^) np.:
  • !s[0].err
  • !o[0]&v[1]

Konfiguracja czujników

Zakładka umożliwia przypisanie poszczególnych czujników do dedykowanych slotów pamięci oraz dokładną konfigurację ich parametrów. Pozwala na indywidualne zarządzanie każdym czujnikiem, ustawiając specyficzne parametry i tryby działania. Dodatkowo, zapewnia możliwość podglądu historii wcześniejszych odczytów oraz ich pobrania w formatach JSON lub CSV.

graph LR
  A[Sensors] --> B[All]
  A --> C[History]
  A --> D[Chart]

All

Dzięki tej zakładce, użytkownik ma pełną kontrolę nad konfiguracją czujników, korektą pomiarów oraz zarządzaniem powiadomieniami. Możliwe jest dodawanie nowych czujników, które automatycznie integrują się z systemem Daxi. Użytkownik może określić parametry dla każdego czujnika, dostosowując je do swoich indywidualnych potrzeb i warunków pracy. Dodatkowo, zakładka ta oferuje narzędzia do edycji istniejących czujników, umożliwiając bieżące dostosowywanie ich ustawień do zmieniających się warunków lub wymagań użytkownika.

W poszczególnych kolumnach tabeli czujników znajdują się następujące informacje:

• ID – Numer identyfikacyjny czujnika,
• Name – Nazwa czujnika,
• Src – Źródło, z którego pobierane są odczyty czujnika (1-Wire lub Modbus poller),
• Type – typ podłączonego czujnika:
  • – Czujnik temperatury,
  • – Czujnik wilgotności,
  • – Wejście,
  • – Czujnik analogowy prądowy 4-20mA,
  • – Czujnik ciśnienia,
  • – Czujnik analogowy napięciowy 0-10VDC,
  • – Czujnik obecności tlenku węgla (CO),
  • – Czujnik obecności dwutlenku węgla (CO2).
• Log – Informacja, o tym czy czujnik ma aktywny (Yes) czy nieaktywny (No) zapis odczytów do pamięci urządzenia,
• Alarms – Aktywowane alarmy:
  • LL – Włączony próg alarmowy niskiego poziomu,
  • L – Włączony próg alarmowy ostrzeżenia przed niskim poziomem,
  • H – Włączony próg alarmowy ostrzeżenia przed wysokim poziomem,
  • HH – Włączony próg alarmowy wysokiego poziomu,
• Config – Przyciski konfiguracyjne czujników:
  – Przycisk edycji parametrów czujnika,
  – Usuwanie czujnika.

Po kliknięciu w przycisk edycji parametrów czujnika na ekranie wyświetlone zostaje okno dialogowe:

• Source – Źródło czujnika:
  • Bus – Fizycznie połączone z magistralą czujników 1-Wire w urządzeniu Daxi,
  • mbAgent – Czujniki wykorzystujące protokół Modbus, które są odpytywane przez urządzenie Daxi za pośrednictwem funckji Poller,
  • Inveo – Czujniki urządzeń Inveo połączonych z urządzeniem Daxi – patrz rozdział iCluster,
  • Counter – Wejście licznikowe,
• Sensor 1-wire address – Przycisk Scan bus umożliwia odnalezienie i przypisanie podpiętego do urządzenia czujnika,
• Sensor name – Nazwa czujnika,
• Sensor type – Typ czujnika:
  • Temperature – Temperatury,
  • Humidity – Wilgotności,
  • Input – Wejście,
  • Current – Analogowy, prądowy,
  • Pressure – Ciśnienia,
  • Voltage – Analogowy, napięciowy,
  • CO – Tlenku węgla (CO),
  • CO2 – Dwutlenku węgla (CO2).
• Hysteresis – Histereza czujnika (parametr nieaktywny w przypadku wyboru typu czujnika Input) - dotyczy stanów alarmowych i ostrzegawczych. Histereza określa maksymalną dopuszczalną różnicę pomiędzy wartością alarmową / ostrzegawczą a wartością powrotu do stanu normalnego.

• Channel – Wybór kanału – parametr aktywny tylko w przypadku wyboru typu czujnika Input,
• Sensor log – Załączanie / wyłączanie rejestracji danych z czujnika w pamięci urządzenia,
• Notifications – Załączanie / wyłączanie powiadomień,
  • MQTT notification – Załączanie / wyłączanie powiadomień MQTT.

Załączenie funkcji Notifications umożliwia edycję okna reakcji urządzenia na:

• Przejście czujnika w tryb bez alarmu i bez błędów,
• Przejście czujnika w stan błędu,
  Użytkownik ma do wyboru rodzaj powiadomienia, jakie zostanie wysłane w reakcji na powyższe zdarzenia. Aby powiadomienia były wysłane należy wcześniej skonfigurować odpowiednie funkcje w zakładce Services.

Aby przypisać akcję należy kliknąć przycisk +. Wyświetlone zostanie okno dialogowe, w którym można wybrać pożądaną akcję, wcześniej zdefiniowaną w zakładce All.

Procedura przypisania akcji została szczegółowo opisana w rozdziale Inputs.

Konfiguracja alarmów

W sekcji ustawień poświęconej konfiguracji alarmów czujników, użytkownik zyskuje pełną kontrolę nad dostosowaniem parametrów alarmowych do indywidualnych potrzeb. Pozwala to skonfigurować alerty i reakcję na istotne zdarzenia związane z działaniem czujników.

• Low alarm – Włączanie alarmu niskiego poziomu,
  • Low alarm value – Wartość czujnika, przy której czujnik przejdzie w stan alarmu niskiego poziomu.
• Low warning – Włączenie ostrzegania o niskim poziomie, zbliżającym się do stanu alarmowego,
  • Low warning value– Wartość czujnika, przy której czujnik przejdzie w stan ostrzeżenia niskiego poziomu.
• High warning – Włączanie ostrzegania o wysokim poziomie, zbliżającym się do stanu alarmowego,
  • High warning value– Wartość czujnika, przy której czujnik przejdzie w stan ostrzeżenia wysokiego poziomu.
• High alarm – Włączenie alarmu wysokiego poziomu,
  • High alarm value – Wartość czujnika, przy której czujnik przejdzie w stan alarmu wysokiego poziomu.

Po aktywowaniu alarmu pojawia się dodatkowe okno, które umożliwia dostosowanie reakcji urządzenia na daną sytuację alarmową. W tym miejscu użytkownik może skonfigurować powiadomienia oraz przypisać wykonanie konkretnej akcji.

• Sensor preoffset – Pole służy do korekcji wskazania czujnika, wg wzoru funkcji liniowej f(x)=ax*b,
• Sensor multiplication 'a' – Mnożenie wartości czujnika,
• Sensor offset 'b' – Korekta wartości stałej.

History

Zakładka umożliwia załączenie i konfigurację zapisu historii odczytów z czujników:

• History – Załączenie / wyłączenie zapisu odczytów z czujników,
• Wait for SNTP – Załączenie tej opcji spowoduje, że dane z czujników będą rejestrowane tylko wtedy, gdy urządzenie po restarcie pobierze czas z serwera SNTP,
• Przycisk Go to SNTP configuration – Umożliwia przejście do zakładki przeznaczonej do konfiguracji SNTP,
• Period – Częstotliwość zapisu danych z czujnika,
• Remove – Umożliwia załączenie czyszczenia z pamięci zapisów starszych niż określona liczba dni.

Chart

W zakładce widoczne są wykresy odczytów wszystkich czujników, które mają załączoną rejestrację danych (zakładka Sensors / All, parametr Sensor log).

• Refresh data – Ściągnięcie aktualnych odczytów z czujników,
• Clear history – Czyszczenie pamięci urządzenia ze wszystkich zarejestrowanych pomiarów z czujnika,
• Remove X oldest logs – Usunięcie z pamięci urządzenia X najstarszych zarejestrowanych pomiarów z czujnika,
• Download JSON – Pobranie zapisanych odczytów w formacie JSON,
• Download CSV – Pobranie zapisanych odczytów w formacie CSV.

Obsługa czujnika

Dla pewności dokładnych i niezawodnych odczytów z czujnika, zaleca się postępowanie zgodnie z poniższym szczegółowym przewodnikiem krok po kroku, obejmującym podłączenie, przypisanie i konfigurację czujnika.

Przypisanie czujnika

W pierwszej kolejności należy połączyć czujnik z urządzeniem – patrz rozdział Schemat podłączeń.
Następnie, korzystając ze strony internetowej urządzenia, trzeba zlokalizować, przypisać i skonfigurować podstawowe parametry czujnika. Jeśli do urządzenia nie podłączono wcześniej żadnych czujników, można skorzystać z opcji automatycznego ich przypisania. Wystarczy zresetować urządzenie po podłączeniu czujników. Gdy urządzenie uruchomi się ponownie, automatycznie rozpozna i przypisze dostępne czujniki, określając również ich rodzaj.

Poniżej opisany został proces ręcznej konfiguracji czujników krok po kroku.

Krok 1: W zakładce Sensors / All – należy kliknąć przycisk +:

W wyświetlonym oknie dialogowym w pierwszej kolejności należy dokonać wyboru źródła czujnika – parametr Source. W tym przypadku należy wybrać opcję One-wire (czujnik fizycznie podłączony do magistrali).
Przypisanie czujnika należy rozpocząć od ikony Scan bus , która wywołuje okno ukazujące wykryte czujniki:

Należy przypisać wybrany czujnik poprzez kliknięcie przycisku Assign.

Krok 2: Konfiguracja podstawowych parametrów

W oknie konfiguracyjnym czujnika należy ustawić właściwy typ czujnika, można nadać mu nazwę, itp. Wszystkie ustawienia należy zatwierdzić za pomocą przycisku Save.

Krok 3: Podgląd w zakładce Status

Prawidłowo skonfigurowany czujnik spowoduje wyświetlenie odczytów w zakładce Status w oknie Sensors:

Zapis odczytów z czujnika i podgląd wykresu

Przeprowadzenie konfiguracji czujnika zgodnie z instrukcjami z poprzedniego rozdziału nie gwarantuje automatycznego zapisywania odczytów w pamięci urządzenia. Umożliwiają one jedynie bieżący podgląd wartości. Aby dane z czujnika były okresowo rejestrowane, należy postępować zgodnie z kolejnymi wskazówkami:

Krok 1: Włączenie automatycznego zapisu odczytów czujnika

W zakładce Sensors / All, należy kliknąć przycisk edycji parametrów czujnika

Wyświetlony zostanie ekran konfiguracyjny czujnika:

Należy przejść do opcji Sensor log i zaznaczyć parametr Enable. Wszystkie ustawienia należy zatwierdzić za pomocą przycisku Save.

Krok 2: Włączenie automatycznego zapisu odczytów

Zakładka Sensors / History:

Należy przejść do opcji History i załączyć ją za pomocą suwaka.
Gdy urządzenie zostanie zrestartowane lub wystąpi awaria połączenia internetowego, automatycznie przejdzie ono na zapis odczytów z czujników za pomocą wewnętrznego zegara czasu rzeczywistego (RTC). Opcja Wait for SNTP umożliwia urządzeniu oczekiwanie na pobranie aktualnego czasu z serwera czasu sieciowego (SNTP) przed rozpoczęciem zapisywania danych z czujników. Dzięki temu zapewniona jest dokładność czasowa pomiarów, nawet w przypadku braku połączenia z internetem.

Krok 3: Ustawienie aktualnego czasu w urządzeniu

Urządzenie wyposażone jest w wewnętrzny zegar RTC z podtrzymaniem bateryjnym. W przypadku, gdy urządzenie ma stały dostęp do sieci internetowej można załączyć usługę SNTP.
Zakładka Administration / Time - SNTP umożliwia ustawienie serwera czasu SNTP, który gwarantuje, że pomimo braku zasilania aktualny czas urządzenia zostanie utrzymany.

Po skonfigurowaniu urządzenia wg powyższych instrukcji urządzenie rozpocznie zapisywanie danych z czujnika do pamięci wewnętrznej. Moduł pozwala także na podgląd wykresu zmian wartości odczytanych z czujnika w czasie. Można również pobrać zapisane odczyty w formacie JSON lub CSV.

Pobieranie zapisanych odczytów z czujników

Zapisane odczyty z czujników (patrz poprzedni rozdział) można pobrać z urządzenia w formacie JSON lub CSV odwołując się do zasobu pamięci wewnętrznej urządzenia. Należy w tym celu zastosować następującą komendę: http://adres_IP_urządzenia/data/log.json.

Odczyty z czujników można również pobierać bezpośrednio ze strony urządzenia w formacie JSON lub CSV. W tym celu należy skorzystać z odpowiednich przycisków: Download JSON lub Download CSV lub w zakładce Sensors / Chart.

Konfiguracja powiadomień

Zakładka Notifications umożliwia konfigurację różnorodnych powiadomień - włączanie, wyłączanie oraz przypisywanie powiadomień, obejmujących E-mail, SMS, SNMP Trap, MQTT, dotyczących pracy czujników, wejść i wyjść.

Aby powiadomienia mogły być skutecznie przesyłane należy:
Krok 1: Załączyć opcję powiadomień w zakładce wybranych elementów systemu: czujniki wejścia lub wyjścia, określenie rodzaju powiadomień,

Krok 2: W zależności od wybranego rodzaju powiadomień – SMS, e-mail, SNMP Trap, MQTT – dokonać konfiguracji w zakładce Services – patrz rozdział Protokoły komunikacyjne

Krok 3: Włączyć opcję powiadomień w zakładce Configuration.

Sensors

W zakładce Sensors można dostosowywać ustawienia powiadomień związanych z pracą poszczególnych czujników. Powiadomienia dla wybranego czujnika można włączyć na dwa sposoby: w zakładce Sensors, w trakcie konfiguracji czujnika (patrz rozdział Konfiguracja czujników) lub klikając ikonę w zakładce Notifications / Sensors.

Pełną personalizację umożliwia okno konfiguracyjne, które pojawia się po aktywacji funkcji powiadomień:

W wyświetlonej tabeli użytkownik ma możliwość zaznaczenia jakiego rodzaju powiadomienia mają być wysyłane w reakcji na wystąpienie określonych zdarzeń:

• Info – Cykliczna informacja o stanie czujnika,
• OK – Stan powrotu czujnika do normalnej pracy po wcześniejszym błędzie lub stanie alarmowym,
• Error – Stan błędu czujnika,
• Alarm low – Stan wartości alarmowej niskiego poziomu,
• Warning low – Stan wartości ostrzeżenia przez zbliżaniem się do alarmu niskiego poziomu,
• Warning high – Stan wartości ostrzeżenia przez zbliżaniem się do alarmu wysokiego poziomu,
• Alarm high – Osiągniecie przez czujnik wartości alarmowej wysokiego poziomu.

W przypadku, gdy dla czujnika nie zostały wcześniej ustawione wartości graniczne alarmowe można to zrobić w tym miejscu korzystając z ikony , która otwiera okno pozwalające na wprowadzenie żądanej wartości:

Po wprowadzeniu żądanej wartości, należy załączyć funkcje klikając ikonę .
Wprowadzone tu ustawienia będą także widoczne w zakładce Sensors.

Inputs

W zakładce Inputs można skonfigurować ustawienia powiadomień dotyczących pracy podłączonych do urządzenia wejść. Po naciśnięciu ikony , aktywowane zostają powiadomienia dla wybranego wejścia, pozostawiając do skonfigurowania jedynie ich szczegóły. Pełną personalizację umożliwia okno konfiguracyjne, które pojawia się po aktywacji funkcji powiadomień:

Istnieje możliwość załączenia powiadomień MQTT oraz E-mail, SMS, SNMP Trap (zależnie od wersji urządzenia).

W wyświetlonej tabeli użytkownik ma możliwość zaznaczenia jakiego rodzaju powiadomienia mają być wysyłane w reakcji na wystąpienie określonych zdarzeń:

• On change action – Zmiana stanu wejścia (włączony – wyłączony),
• Info – Informacja o stanie wejścia.

Outputs

W zakładce Outputs można skonfigurować ustawienia powiadomień dotyczących pracy podłączonych do urządzenia wyjść. Po naciśnięciu ikony , aktywowane zostają powiadomienia dla wybranego wyjścia, pozostawiając do skonfigurowania jedynie ich szczegóły. Pełną personalizację umożliwia okno konfiguracyjne, które pojawia się po aktywacji funkcji powiadomień:

Istnieje możliwość załączenia powiadomień MQTT oraz E-mail, SMS, SNMP Trap (w zależności od wersji urządzenia).

W wyświetlonej tabeli użytkownik ma możliwość zaznaczenia jakiego rodzaju powiadomienia mają być wysyłane w reakcji na wystąpienie określonych zdarzeń:

• On change action – Zmiana stanu wyjścia (włączony – wyłączony),
• Info – Informacja o stanie wyjścia.

Configuration

W sekcji Configuration istnieje opcja aktywacji funkcji powiadomień, konieczna do wysyłania komunikatów. Dodatkowo, użytkownik ma możliwość dostosowania ogólnych parametrów związanych z przesyłaniem powiadomień.

• Notification – Załączanie / wyłączanie powiadomień,
• E-mail info – Częstotliwość wysyłania wiadomości e-mail z informacją a stanie czujnika / wejścia / wyjścia (tylko IQIO PRO, Sens, Daxi),
• SMS info – Częstotliwość wysyłania wiadomości SMS z informacją a stanie czujnika / wejścia / wyjścia (tylko IQIO PRO, Daxi),
• MQTT info – Częstotliwość wysyłania wiadomości MQTT z informacją a stanie czujnika / wejścia / wyjścia,
• MQTT Retain – Załączenie / wyłączenie funkcji MQTT Retain – włączona opcja oznacza, że brokery będą zachowywały ostatnie komunikaty dla tematów, do których urządzenie wysyła powiadomienia,
• SNMP Trap – Wybrany SNMP Trap,
• IO time – Minimalny czas, jaki musi upłynąć między kolejnymi zmianami stanu na wejściach/wyjściach, aby uniknąć nadmiernego wysyłania powiadomień, zwłaszcza podczas testów lub eksperymentalnego badania wejść/wyjść urządzenia.

W zakładce znajdują się również tabele: Sensor, Input oraz Output.
Każda tabela zawiera predefiniowane komendy, umożliwiające wysyłanie powiadomień e-mail oraz SMS, zawierające aktualne stany urządzenia. Dodatkowo, użytkownik ma możliwość edycji tych komend, co pozwala na dostosowanie ich do własnych preferencji, na przykład dodając nazwę urządzenia. Każda tabela zawiera również topic, którego wykorzystanie jest konieczne przy wysyłaniu powiadomień poprzez protokół MQTT.

Macierz działań

KNX outputs

W zakładce Work matrix/KNX outputs istnieje możliwość zaprogramowania zachowania wyjścia w odpowiedzi na ramki danych przesyłane na określone grupy w systemie KNX. Ta funkcja umożliwia konfigurację Daxi w celu automatycznego sterowania wyjściami w zależności od danych otrzymanych przez system KNX.

Gdy Daxi otrzymuje ramkę danych na wybranej grupie KNX (np. 1/1/1), automatycznie wykonuje przypisane działanie, takie jak włączenie, wyłączenie, zmiana stanu na przeciwny lub czasowe włączenie. Dzięki temu użytkownik może kontrolować zachowanie urządzenia w zależności od sygnałów KNX.

Naciśnięcie przycisku Advanced configuration spowoduje wyświetlenie zmienionego widoku konfiguracji, umożliwiającego w prosty sposób skopiowanie ścieżki z komendą:

Lista komend KNX rozpoznawanych przez Daxi:

• On – Załączenie wyjścia – może przyjmować 2 wartości:
  • 0 – Wysłanie takiej komendy spowoduje wyłączenie wyjścia,
  • 1 – Wysłanie takiej komendy spowoduje włączenie wyjścia,
• Off – Wyłączenie wyjścia – może przyjmować 2 wartości:
  • 0 – Wysłanie takiej komendy spowoduje włączenie wyjścia,
  • 1 – Wysłanie takiej komendy spowoduje wyłączenie wyjścia,
• Invert – Zmiana stanu wyjścia na przeciwny:
  • 0 – Taka komenda nie spowoduje zmiany stanu wyjścia,
  • 1 – Wysłanie takiej komendy spowoduje zmianę stanu wyjścia na przeciwny,
• Time – Czasowe włączenie/wyłączenie wyjścia:
  • 00 – Wyłączenie przekaźnika
  • 01 TonMSB TonLSB ToffMSB ToffLSB – Włączenie przekaźnika na ustalony czas po zakończeniu określonego opóźnienia. Czas ten jest wyrażony w jednostkach równych 0,1 sekundy, zapisanych w systemie szesnastkowym (hex).

KNX/TCP/UDP Inputs

Zakładka umożliwia zaprogramowanie reakcji urządzenia w sygnał otrzymany na wybranym wejściu. Można do tego wykorzystać protokoły KNX, UDP oraz TCP. Istnieje możliwość przypisania wielu reakcji na sygnał z tego samego wejścia.

Po wybraniu protokołu, w zależności od wybranego ustawienia należy wprowadzić dodatkowe informacje:

KNX:

• KNX group – Docelowa grupa KNX np. 1/1/1,
• Frame – Składnia komendy wysyłanej na daną grupę KNX zapisana heksadecymalnie. Przykładowa składnia: 0105.

TCP/UDP:

• Server IP/DNS – Docelowy adres IP dla ramki TCP/UDP,
• Port – Domyślnie 9761,
• Frame – Treść ramki TCP/UDP. Na przykład naruszenie wejscia %i[0]%.

Naciśnięcie przycisku spowoduje usunięcie akcji.

W zależności od rodzaju wejścia (parametr Action type w zakładce I/O Settings / Inputs) dostępna jest różna liczba funkcji:

• Standard:
  • Action Off,
  • Action On.
• Hold:
  • Action Off,
  • Action On,
  • Action Hold On,
  • Action Hold Off.
• Cnt:
  • Action I,
  • Action II,
  • Action III,
  • Action IV.
• Toggle:
  • Action I,
  • Action II.
• Freq:
  • Action Off,
  • Action On.

Przycisk Go to the inputs configuration umieszczony w prawym górnym rogu umożliwia szybkie przejście do zakładki IO Settings/Inputs.

Powiązania

Zakładka Binding umożliwia konfigurację powiązań – przenoszenie stanów wejść/wyjść.

iCluster

Zakładka umożliwia połączenie z innymi urządzeniami Inveo w tej samej sieci LAN. Umożliwia podgląd stanów urządzeń, mierzonych wartości a także sterowanie wyjściami. Można również przenosić stan wejścia podłączonego urządzenia na wybrane wyjście Daxi. Z urządzeniem Daxi możliwe jest połączenie następujących modułów Inveo:

• Moduły z serii IQIO,
• Nano Relay Output,
• Nano Digital Input,
• Nano Temperature Sensor,
• Hero Web Sensor,
• Moduły z serii Lantick.

Aby połączyć urządzenie Daxi z innym modułem Inveo należy kliknąć ikonę - wyświetli się okno dialogowe umożliwiające odnalezienie urządzeń Inveo w sieci LAN. Po kliknięciu ikony Scan urządzenie Daxi wyszuka wszystkie dostępne urządzenia:

Po wybraniu urządzenia za pomocą przycisku Select należy zatwierdzić ustawienia przyciskiem .

Klikając ikonę można sprawdzić szczegóły pracy połączonych urządzeń, przetestować sterowanie wyjściami, przekierować odczyt z czujników zewnętrznych do Daxi itp.

Konfiguracja modułów Lantick

Aby skonfigurować urządzenia Lantick do współpracy z Daxi, wystarczy załączyć opcję Enable Program Access w zakładce Administration.

Oba współpracujące moduły muszą pracować w obrębie tej samej podsieci.

Outputs

Zakładka umożliwia przekierowanie stanu z innych komponentów:

• Name – Umożliwia zmianę nazwy wyjścia,
• Route from – Wskazanie źródła, które ma wpływać na stan wyjścia – zmiana stanu na kanale wskazanym w tym polu spowoduje analogiczną zmianę stanu wyjścia.

Możliwe źródła stanu wyjścia:

• i[x] – Stan kanału wejściowego,
• i[x].act – Ostatnia akcja wejścia,
• o[x] – Stan cewki kanału wyjściowego,
• o[x].on – Stan kanału wyjściowego,
• v[x] – Zmienna wewnętrzna,
• s[x].aHi – Alarm stanu wysokiego czujnika,
• s[x].aLo – Alarm stanu niskiego czujnika,
• s[x].wHi – Ostrzeżenie stanu wysokiego czujnika,
• s[x].wLo – Ostrzeżenie stanu niskiego czujnika,
• s[x].err – Błąd czujnika,
• s[x].ok – Czujnik pracuje poprawnie,
• ping[x] – Status ping: 0 - błąd, 1 - sukces,
• mb[x].y – Wartość mbAgent.
• Urządzenie zewnętrzne:
  • dev[x].err – Utrata połączenia,
  • dev[x].o[y] – Wyjście zewnętrzne,
  • dev[x].i[y] – Wejście zewnętrzne,
  • dev[x].s[y].err – Błąd czujnika zewnętrznego.

• Negacja i operacje logiczne (|/&/^) np.:

  • !s[0].err
  • !o[0]&v[1]

• Route to – Wskazanie zmiennej, na której stan ma wpływać stan wyjścia.
  Możliwe zmienne, na które ma wpływać stan wyjścia:

• v[x] – Zmienna wewnętrzna,

• mb[x].y – Wartość mbAgent,
• Urządzenie zewnętrzne:
  • dev[x].o[y] – Wyjście zewnętrzne.
• Negacja i operacje logiczne (|/&/^) np.:
  • !s[0].err
  • !o[0]&v[1]

Ikona umożliwia przejście do konfiguracji krok po kroku.

Inputs

Zakładka umożliwia ustawienie wejść wirtualnych zgodnie z zewnętrznymi źródłami, np. taki sam stan jak stan wejścia urządzenia połączonego z Daxi lub stan wejścia Daxi zależny od wystąpienia alarmu na określonym czujniku:

• Name - Umożliwia zmianę nazwy wejścia,

• Route from – W tej kolumnie można uzależnić stan wejścia od określonych zdarzeń itp. Służą do tego następujące komendy (lista komend dostępna również po kliknięciu ikony i):

• i[x] – Stan kanału wejściowego,

• o[x] – Stan cewki kanału wyjściowego,
• o[x].on – Stan kanału wyjściowego,
• v[x] – Zmienna wewnętrzna,
• s[x].aHi – Alarm wysoki czujnika,
• s[x].aLo – Alarm niski czujnika,
• s[x].wHi – Stan wysoki ostrzeżenia czujnika,
• s[x].wLo – Niski stan ostrzeżenia czujnika,
• s[x].err – Błąd czujnika,
• s[x].ok – Czujnik w porządku,
• ping[x] – Status ping: 0 – błąd, 1 – sukces,
• poll[x].y – Wartość pollera,
• Urządzenie zewnętrzne:
  • dev[x].err – Utracone połączenie,
  • dev[x].o[y] – Wyjście zewnętrzne,
  • dev[x].i[y] – Wejście zewnętrzne,
  • dev[x].s[y].err – Błąd czujnika zewnętrznego.

Ikona umożliwia przejście do konfiguracji krok po kroku.

mbAgent

Poller to funkcja programu, która regularnie pobiera dane innego systemu, urządzenia lub aplikacji, wykorzystując protokół Modbus TCP lub Modbus RTU. Zasada działania pollera polega na wysyłaniu zapytań do określonego celu i oczekiwaniu na odpowiedź. Kliknięcie przycisku Create a mbAgent instance spowoduje wyświetlenie kolejnych okien dialogowych ze szczegółowymi nastawami:

Device settings:

• mbAgent name – Nazwa pollera,
• Protocol – Protokół komunikacji dla pollera:
  • Modbus TCP
  • Modbus RTU
• Transport:
  • TCP (opcja dla protokołu Modbus TCP),
  • UDP (opcja dla protokołu Modbus TCP),
  • RS485/RS232 (Modbus RTU - Virtus),
• Device PDU – Numer sprawdzanego urządzenia,
• Connection timeout [ms] (opcja tylko dla protokołu Modbus TCP), – limit czasu połączenia [ms],
• Response timeout [ms] – Limit czasu odpowiedzi [ms],
• IP address (opcja tylko dla protokołu Modbus TCP/RTU via TCP) – Adres IP sprawdzanego urządzenia,
• Port (opcja tylko dla protokołu Modbus TCP/RTU via TCP) – Port komunikacji ze sprawdzanym urządzeniem.

Kliknięcie przycisku Next spowoduje przejście do kolejnego okna parametrów.

Data:

• Start register address – Adres rejestru początkowego,
• Number of registers – Liczba rejestrów,
• Register type – Typ rejestru:
  • Coils
  • Input Register 16-bits
  • Holding Register 16-bits
  • Discrete Inputs
• Refresh interval [s] – Interwał odświeżania [s],
• Writable – Możliwość zapisu.

Mappers:

• Mapper name – Nazwa mappera,
• Address – Adres rejestru,

Przycisk Go to the sensor configuration umożliwia szybkie przejścia do zakładki Sensors.

Planowanie działań (grafik)

W zakładce Schedule możemy dostosowywać działanie systemu za pomocą definiowanych harmonogramów pracy lub czasów cron. Ta zaawansowana funkcja pozwala na elastyczne programowanie różnorodnych akcji, takich jak włączanie lub wyłączanie urządzeń, oraz definiowanie szerokości i długości geograficznej dla precyzyjnej synchronizacji z wschodami i zachodami słońca. Ponadto, możliwość przypisywania konkretnych akcji do określonych czasów cron umożliwia skonfigurowanie spersonalizowanego harmonogramu działania systemu.

Weekly

Zakładka daje możliwość ustawienia czterech tygodniowych planów pracy – załączanie wybranych wyjść urządzenia w określonych godzinach w poszczególnych dniach tygodnia.

Change time format – Przycisk umożliwiający zmianę formatu czasu z 24-godzinnego na 12-godzinny.

Programowanie harmonogramu działań należy rozpocząć od wyznaczenia godzin startu oraz końca. Następnie za pomocą przycisku należy przejść do wyboru dni tygodnia oraz wyjść, których harmonogram dotyczy. Nastawy należy zatwierdzić za pomocą przycisku .

Przycisk Enable rule – Umożliwia wyłączenie harmonogramu.

Cron action

Zakładka umożliwia aktywowanie wcześniej zdefiniowanych akcji (patrz rozdział Definiowanie zadań) zgodnie z harmonogramem wykorzystującym czas cron.

W pierwszej kolejności należy załączyć działanie cron:

Po naciśnięciu przycisku + uruchomiona zostanie konfiguracja czasu cron krok po kroku.

Po zatwierdzeniu ustawień czasu cron można przejść do kolejnych kroków konfiguracji:

• Cron expression – Ustawiony czas cron. Ikona umożliwia powrót do konfiguracji czasu cron,
• Comment – Umożliwia wstawienie komentarzy użytkownika,
• Action – Umożliwia przypisanie zdefiniowanych wcześniej akcji – patrz rozdział Definiowanie zadań,
• Config – Umożliwia aktywację konfiguracji, zatwierdzenie wprowadzonych zmian lub opuszczenie sektora edycji.

Cron standard

Zakładka umożliwia zaprogramowanie działania wyjść zgodnie z czasem cron:

• Cron standard – Załączanie / wyłączanie obsługi Cron,
• Missed Cron Replay – Wykonywanie poleceń cron, które zostały pominięte z powodu utraty zasilania. Maksymalny czas odzyskiwania: 7 dni utraty zasilania.

Konfiguracja cron krok po kroku:

Kliknięcie ikony spowoduje przejście do konfiguracji czasu cron. Po dołożeniu czasu cron odblokowana zostaje możliwość konfiguracji komendy – należy zaprogramować w jaki sposób mają się zachować poszczególne wyjścia w ustawionym czasie cron – dla każdego z wyjść dostępne są następujące opcje:

• None – Brak zmiany stanu,
• Not – Zmiana stanu na przeciwny,
• Off – Wyłącz,
• On – Włącz.

Konfigurację należy potwierdzić klikając przycisk Add command.

Dołożenie kolejnych komend jest możliwe po naciśnięciu przycisku +.

Konfiguracja cron zaawansowana:

Przycisk Advanced configuration umożliwia przejście do zaawansowanej konfiguracji cron, która polega na odpowiednim wypełnieniu sześciu kolumn.

Poniższy rysunek przedstawia znaczenie kolejnych kolumn:

* * * * * Komenda sterująca
| | | | |
| | | | ---------- Dzień tygodnia (0-7) (0 i 7 niedziela)
| | | -------------- Miesiąc (1-12)
| | ----------------- Dzień miesiąca (1-31)
| --------------------- Godzina (0-23)
------------------------ Minuta (0-59)

Komenda sterująca składa się z 8 pól przedstawiających stan odpowiednich wyjść.

Każde z pól może przyjmować wartości: - 1 – Załączenie wyjścia, - 0 – Wyłączenie wyjścia, - n – Negacja (jeśli było załączone nastąpi wyłączenie i odwrotnie), - - – Pozostaw wyjście bez zmian.

Sterownik rozpoznaje następujące wpisy:

• Niedziela może być oznaczona jako 0 lub 7
• Dzień wykonania komendy można wpisać na dwa sposoby: podając dzień miesiąca lub dzień tygodnia. Jeśli oba pola są ustawione, to komenda wykona się zarówno w ustawiony dzień miesiąca, jak i w ustawiony dzień tygodnia!
• Wartości liczbowe możemy zapisywać w różnych formatach:
  • 1-3 – Czyli wartości 1, 2, 3,
  • 0-10/2 – Czyli wartość 0, 2, 4, 6, 8 i 10 (co druga wartość ze zbioru od 0 do 10),
  • 1,2,5 – Czyli wartości kolejno 1, 2, 5,
  • */2 – Co 2 dozwolona wartość (np. w pierwszej kolumnie będzie to 0, 2, 4, 6...56, 58),
  • 1-3,5,6 – Czyli 1, 2, 3 oraz 5 i 6,
• SR – odniesienie się do godziny wschodu słońca,
• SS – odniesienie się do godziny zachodu słońca.

Configuration

Zakładka umożliwia konfigurację sterowania wyjściami z wykorzystaniem czasu Cron.

• Twilight – Wybór typu zmierzchu – patrz rozdział Typ zmierzchu,
• Longitude – Długość geograficzna – stopnie (wartość dodatnia dla wschodniej długości, wartość ujemna dla zachodniej),
• Longitude – Długość geograficzna – minuty (wartość dodatnia dla wschodniej długości, wartość ujemna dla zachodniej),
• Latitude – Szerokość geograficzna – stopnie (wartość dodatnia dla szerokości północnej, wartość ujemna dla południowej),
• Latitude – Szerokość geograficzna – minuty (wartość dodatnia dla szerokości północnej, wartość ujemna dla południowej).

Typ zmierzchu

• Civil (-6⁰) – Zmierzch cywilny – faza zachodu Słońca, w której środek tarczy słonecznej jest nie więcej niż 6 stopni kątowych poniżej horyzontu. W tym okresie pojawiają się na niebie najjaśniejsze gwiazdy i planety, zachowując wystarczającą ilość naturalnego światła do normalnej działalności na otwartej przestrzeni.
• Nautical (-12⁰) – Zmierzch nautyczny (zwany również zmrokiem) – czas po zachodzie Słońca, gdy środek tarczy słonecznej znajduje się poniżej 6 stopni kątowych poniżej horyzontu, ale wciąż powyżej 12°. Ta faza umożliwia wyraźne obserwowanie linii horyzontu, co jest istotne w astronawigacji, umożliwiając jednoczesną nawigację opartą na obiektach ziemskich i niebieskich.
• Astromical (-18⁰) – Zmierzch astronomiczny – okres, w którym środek tarczy słonecznej znajduje się między 12 a 18 stopniem kątowym poniżej horyzontu. Kończy się on zaczynającą się nocą astronomiczną. Świt astronomiczny – czas przed wschodem Słońca, gdy promienie Słońca rozświetlają niebo, sprawiając, że najsłabsze gwiazdy przestają być widoczne. Świt astronomiczny trwa od momentu, gdy środek tarczy Słońca znajduje się powyżej 18° poniżej linii horyzontu do chwili, gdy przekracza 12° poniżej linii horyzontu. Świt astronomiczny kończy noc astronomiczną, a następnie zaczyna się świt nautyczny.
• Świt nautyczny – Czas przed wschodem Słońca, gdy horyzont i krajobraz stają się widoczne, umożliwiając nawigację na podstawie oświetlonych obiektów na ziemi lub morzu. W tym czasie na niebie widoczne są jeszcze najjaśniejsze gwiazdy. Świt nautyczny trwa od momentu, gdy środek tarczy Słońca znajduje się powyżej 12° poniżej linii horyzontu, ale ciągle poniżej 6° poniżej linii horyzontu.
• Świt cywilny – Czas przed wschodem Słońca, kiedy środek tarczy Słońca znajduje się już wyżej niż 6° poniżej linii horyzontu.

Urządzenie Daxi oblicza godzinę wschodu oraz zachodu słońca – w tym celu konieczne jest wprowadzenie współrzędnych geograficznych (długość geograficzna oraz szerokość geograficzna w formacie stopnie minuty).

• Twilight - wybór trybu pracy zegara astronomicznego:
  • Sunrise/set (-0,58°),
  • Civil (-6°) – zmierzch cywilny,
  • Nautical (-12°) – zmierzch nautyczny,
  • Astronomical (-18°) – zmierzch astronomiczny.

Ping zdalnych hostów (Watchdog)

Urządzenie posiada funkcję „pingowania” - może odpytywać zdalne hosty (inne urządzenia sieciowe, serwery itp.) i reagować na ich dostępność.

Aby dodać nowe urządzenie do sprawdzania dostępności należy kliknąć w znaczek + w tabeli All ping pong actions – wyświetli się nowe okno dialogowe Create a new ping feature:

• Name – Nazwa ping,
• IP address – Adres IP pingowanego urządzenia,
• Interval – Częstotliwość wysyłania pingów wyrażony w sekundach,
• Timeout – Limit czasu dla odpowiedzi na ping,
• Error tolerance – Maksymalna akceptowalna ilość błędów odpowiedzi na ping przed przejściem do stanu błędu.

W tabeli pojawi się nowo utworzony ping a w kolumnach Actions ping OK oraz Actions ping Error pojawią się przyciski + umożliwiające przypisanie wybranych akcji, które mają być wykonywane w przypadku poprawnej odpowiedzi na ping oraz w przypadku wystąpienia błędu – proces przypisywania akcji opisany został w rozdziale Przypisywanie akcji.

Naciśnięcie ikony załączy dodatkowy wskaźnik statusu przy nazwie żądania, przyjmujący kolor zielony dla poprawnie uzyskanej odpowiedzi na ping lub czerwony w sytuacji wystąpienia błędu odpowiedzi.

Funkcje logiczne

Zakładka Logic umożliwia konfigurację funkcji logicznych – po spełnieniu określonych warunków zostanie wywołana określona reakcja.

Conditions

Aby skonfigurować nową funkcję logiczną należy wykorzystać przycisk Add a condition.

Dostępne zmienne logiczne:

• input – Wejście,
• input cnt – Licznik wejść,
• output – Wyjście,
• sensor – Czujnik,
• sensor state – Stan czujnika:
  • 0 – Błąd czujnika,
  • 1 – Stan normalny,
  • 2 – Ostrzeżenie stanu niskiego czujnika,
  • 3 – Ostrzeżenie stanu wysokiego czujnika,
  • 4 – Alarm stanu niskiego czujnika,
  • 5 – Alarm stanu wysokiego czujnika.
• constant – Stała,
• variable – Zmienna,
• active input action – Akcja wejścia,
• schedule – Grafik.

Result True / Result False – Reakcja na spełnienie warunku / niezrealizowanie warunku:

• None – Brak reakcji,
• Output – Wysterowanie wyjścia,
• Action – Wywołanie zdefiniowanej akcji,
• Variable – Wysterowanie wyjścia / wejścia wirtualnego.

Lua Script

Zakładka Lua Script umożliwia użytkownikowi definiowanie niestandardowych akcji i logiki sterowania wejściami i wyjściami urządzenia przy użyciu języka skryptowegu Lua.

Główna sekcja zakładki zawiera edytor kodu, w którym można pisać i modyfikować skrypty Lua.

• Reload workspace – Ponowne załadowanie edytora,
• Load to module – Wczytanie kodu Lua do urządzenia (bez zapisu w pamięci trwałej),
• Store in FLASH – Zapisanie kodu Lua w pamięci urządzenia (po restarcie skrypt pozostanie aktywny),
• Clear console – Wyczyszczenie konsoli wyjściowej,
• Restore code – Przywrócenie domyślnego kodu Lua.

Dostępne funkcje systemowe

• start() – Funkcja wywoływana przy uruchomieniu systemu,
• timeout() – Funkcja wywoływana po upływie ustawionego czasu set_timeout(ms),
• httpdscript(name,args) – Funkcja wywoływana, gdy żądanie HTTP zaczyna się od /data/script/,
• void set_timeout(ms) – Ustawia wewnętrzny timer i wywołuje funkcję timeout(),
• void clear_timeout() – Kasuje i wyłącza timer,
• void action(name) – Wywołuje akcję o nazwie name.

Biblioteki Lua

System oferuje kilka bibliotek umożliwiających interakcję z urządzeniem. Biblioteka dev jest biblioteką specyficzną dla urządzeń Inveo, pozostałe biblioteki są bibliotekami standardowymi.

Biblioteka dev

• out_default(ch, int) – Sterowanie wyjściem ch w ustawionym trybie:
  • 0 – Wyłącz,
  • 1 – Załącz,
  • 2 – Odwróć stan.
• out_static(ch) – Załączenie wyjścia ch w trybie statycznym,
• out_off(ch) – Wyłącza wyjście na danym kanale ch,
• out_single(ch, ton, toff) – Ustawia pojedynczy impuls o długości ton na wyjściu ch, na czas toff (w ms),
• out_blink(ch, ton, toff, cnt) – Ustawia miganie wyjścia ch impulsami o długości ton z przerwą toff (w ms), w ilości cnt,
• out_get(ch) – Zwraca stan wyjścia ch,
• in_get(ch) – Zwraca stan wejścia ch,
• in_get_cnt(ch) – Zwraca licznik wejścia ch,
• virt_set(id, val) – Ustawienie stanu zmiennej wirtualnej id na wartość val,
• virt_get(id) – Zwraca stan zmiennej wirtualnej id,
• sensor_get(id) – Zwraca stan czujnika id oraz jego wartość (state,value):
  • 0 – Błąd odczytu (uszkodzony czujnik, nieprawidłowo podłączony itp.),
  • 1 – Czujnik dostarcza prawidłowe odczyty, które są w granicach normy,
  • 2 – Stan ostrzeżenia niskiego poziomu,
  • 3 – Stan alarmu niskiego poziomu,
  • 4 – Stan ostrzeżenia wysokiego poziomu,
  • 5 – Stan alarmu wysokiego poziomu.

Komunikacja

E-mail

• email(recipient, subject, text) – Wysyła e-mail:
  • recipient – Adres odbiorcy,
  • subject – Temat wiadomości,
  • text – Treść wiadomości.

HTTP

• http_send(url, data, data_length, method, content_type) – Wysyła żądanie HTTP:
  • url – Adres, na który urządzenie wyśle żądanie. Wprowadzenie null wyśle żądanie na adres zdefiniowany w zakładce HTTP Client,
  • data – Dane, które mają zostać wysłane,
  • data_length – Długość danych,
  • method – Metoda HTTP:
    • 0 – GET,
    • 1 – POST,
    • 2 – PUT,
    • 3 – DELETE.
  • content_type – Typ zawartości:
    • 0 – PLAIN,
    • 1 – JSON,
    • 2 – XML.

MQTT

• mqtt(topic, data, length) – Wysyła powiadomienie MQTT:
  • topic – Temat (topic), na który zostanie wysłane powiadomienie,
  • data – Dane, które mają zostać wysłane,
  • length – Długość danych.

Logowanie i debugowanie

• log(message) – Zapisuje wiadomość o treści message w logu systemowym,
• console(message) – Wysyła wiadomość o treści message w konsoli Lua.

Odpowiedź na żądanie httpdscript()

• httpd_resp() – Ustawia odpowiedź HTTP.

function example()
--pobierz wartosc z czujnika ID=0
    state,value = dev.sensor_get(0)
    if(value>20) then
        dev.console("Wartosc najwieksza " .. value)
    --ustaw channel ID 3 na:
    --0-off,1-on,2-inv
        dev.out_default(3,2)
    elseif (value<10) then
        dev.console("Wartosc mniejsza" .. value)
    else
        dev.console("Wartosc srednia " .. value)
    end
end

--wywołanie funkcji w momencie startu urzadzenia
function start()
    dev.set_timeout(100);
end

--wywolywanie funkcji timeout
function timeout()
    example()
    dev.set_timeout(100);
end

n_cnt = 0 --ustawienie licznika wykonań kodu na 0

function timeout()
    dev.set_timeout(5000) --odstęp między kolejnymi komunikatami, w ms

    text,len = get_data(n_cnt)
    dev.http("http://192.168.11.116/status.xml", text, len, 0, 0) --adres wyświetlacza i zasób, dane do wysłania (text), długość ciągu (len), metoda (GET), typ zawartości (PLAIN)
    n_cnt = n_cnt + 1 --inkrementacja licznika
    if n_cnt>4 then --maksymalna ilość czujników (4)
        n_cnt=0 --ustawienie licznika na 0 po wysłaniu danych ostatniego czujnika
    end
end

function get_data(index)
    state,value = dev.sensor_get(index)
    local label --dodanie zmiennej label
    if index <= 1 then --indeks ostatniego czujnika temperatury
        label = "TMP" .. index --dodanie przedrostka TMP dla czujników 0, 1
    else
        label = "HUM" .. index --dodanie przedrostka HUM dla pozostałych czujników
    end

    text = "texta=1" .. label .. "%20" .. value --składnia żądania wymagana przez wyświetlacz (np. texta=1HUM%2070.0)
    len = string.len(text) --obliczenie długości ciągu danych
    return text, len --zwrócenie danych (text) oraz długości ciągu (len)
end

--wywołanie funkcji w momencie startu urzadzenia
function start()
    dev.set_timeout(5000); --czas inicjalizacji
end

Zarządzanie systemem

Zakładka Administration umożliwia zarządzanie aspektami działania urządzenia, które wpływają na działanie, bezpieczeństwo i konfigurację systemu.

graph TB
  A[Administration] --> B[Access]
  A --> C[Network]
  A --> D[Time]
  A --> E[System events]
  A --> F[Backup]
  A --> G[Update]

Access

W tej sekcji użytkownik może zarządzać dostępem do webserwera urządzenia. Dotyczy to uwierzytelniania, nazwy oraz dostępu z poziomu programu Discoverer.

• Password – Załączanie / wyłączanie hasła,
• Current password – Aktualne hasło,
• New password – Nowe hasło,
• Repeat new password – Powtórz nowe hasło,
• Module name – Nazwa modułu (wyświetlana m.in.: w programie Discoverer) – nadanie indywidualnej nazwy ułatwia identyfikacje urządzenia w systemie,
• Enable remote config – Załączanie / wyłączanie zezwolenia na zmianę konfiguracji poprzez program Discoverer.

API keys

Urządzenie umożliwia użytkownikowi zdefiniowanie pięciu unikalnych kluczy API, używanych do uwierzytelniania i identyfikacji użytkowników lub procesów wywołujących komunikację z urządzeniem.

• Enable – Załączenie/wyłączenie wybranego klucza API,
• Custom name – Nazwa klucza nadawana przez użytkownika,
• Expiry date – Możliwość ustawienia daty wygaśnięcia klucza API,
• HTTP Client, HTTP Server, MQTT, UDP/TCP, REST API – Wybór protokołu komunikacyjnego, który będzie korzystał z danego klucza API
• API key – Pole wprowadzania wartości klucza,
• Generate API key – Przycisk pozwalający na wygenerowanie klucza API. Wygenerowany klucz zostanie automatycznie wklejony w pole API key.

Network

W tej zakładce konfigurowane są ustawienia sieciowe urządzenia. Konfiguracja została opisana w rozdziale Konfiguracja sieciowa.

Time

Sekcja ta pozwala na ręczną konfigurację ustawień czasu i strefy czasowej, oraz pobranie aktualnego czasu z komputera.

• Current time – Podgląd aktualnego czasu w urządzeniu,
• Current date – Podgląd aktualnej daty w urządzeniu,
• Update time in the device – Umożliwia ustawienie czasu w urządzeniu takiego samego w komputerze.

Urządzenie wyposażone jest w obsługę protokołu SNTP, który odpowiada za synchronizację czasu urządzenia z serwerem SNTP. Jest to kluczowe dla prawidłowego logowania danych oraz wykonywania zadań czasowych.

• SNTP – Załączanie / wyłączanie obsługi SNTP,
• Server – Adres serwera SNTP,
• Poll time – Częstotliwość odpytywania serwera (w sekundach).

Dodatkowo, urządzenie wyposażone jest w wewnętrzny zegar RTC z podtrzymaniem bateryjnym. Gdy urządzenie nie ma stałego dostępu do sieci internetowej, może wykorzystać ten zegar do utrzymania dokładnego czasu.

• Daylight saving – Załączanie / wyłączanie czasu letniego,
• Time zone – Wybór strefy czasowej.

System events

Zakładka umożliwia rejestrowanie zdarzeń systemowych w pamięci flash, co umożliwia użytkownikom przeglądanie i analizowanie różnorodnych wydarzeń systemowych. Ten proces pomaga w monitorowaniu działania systemu oraz diagnozowaniu potencjalnych problemów.

• Flash log – Załączanie / wyłączanie zapisu zdarzeń systemowych do pamięci flash,
• Log system events – Załączanie / wyłączanie rejestrowania włączeń, zmian czasu, przywracania ustawień domyślnych, restartów, zmian konfiguracji,
• Log network events – Załączanie / wyłączanie zapisu zdarzeń sieciowych.

Backup

W tej sekcji użytkownicy mogą tworzyć kopie zapasowe aktualnej konfiguracji systemu oraz przywracać system z wcześniejszych kopii zapasowych.

Create a backup file

• Enter password – Umożliwia wpisanie hasła, chroniącego tworzoną kopię zapasową,
• Re-type password – Powtórne wpisanie hasła.

Przycisk Download umożliwia zapis kopii zapasowej na komputerze.

Restore

• Backup password – Hasło dostępu do wgrywanej kopii zapasowej,
• Backup file – Przycisk umożliwiający wyszukanie pliku kopii zapasowej.

Przycisk Upload spowoduje wgranie wybranej kopii zapasowej do urządzenia.
Przycisk Reboot umożliwia ponowne uruchomienie urządzenia.
Przycisk Reset to default umożliwia przywrócenie nastaw fabrycznych w urządzeniu.

Definiowanie akcji

Akcje to zdefiniowane przez użytkownika działania, które urządzenie podejmuje w odpowiedzi na konkretne sygnały lub odczyty z czujników. Mogą one obejmować:

• Sterowanie wyjściami: aktywacja lub dezaktywacja określonego wyjścia na podstawie odczytu z czujnika. Na przykład, włączenie wentylatora, gdy wartość temperatury przekroczy pewien próg.
• Wysyłanie powiadomień w formie SMSa, e-maila, ramki MQTT, HTTP, TCP, UDP, czy SNMP trap i inne: automatyczne wysyłanie alertu czy komunikatu do użytkownika lub innego systemu w odpowiedzi na określone warunki.
• Inne akcje zdefiniowane przez użytkownika: działania specyficzne dla konkretnego systemu czy potrzeb, takie jak zapis danych do bazy, aktywacja alarmu, zmiana ustawień innych urządzeń itp.

Akcje są specyficznymi reakcjami urządzenia na otrzymywane sygnały i dane wejściowe, działając zgodnie z instrukcjami ustawionymi przez użytkownika. Wiele funkcji może być przeprowadzonych na wiele różnych metod, w zależności od preferencji i potrzeb.

graph TB
  A[Actions] --> B[All]
  A --> C[Inputs]
  A --> D[KNX]
  A --> E[System]
  A --> F[Periodic]

All

Zakładka umożliwia podgląd i zarządzanie zdefiniowanymi akcjami, obsługiwanymi przez urządzenie.

Okno Control Actions

• Remove all actions – Przycisk umożliwia usunięcie wszystkich zdefiniowanych na urządzeniu akcji,
• Add a new action – Przycisk umożliwia dołożenie nowych akcji. Po kliknięciu na przycisk wyświetlane jest okno umożliwiające zdefiniowanie poszczególnych parametrów dodawanej akcji:

• Action name – pole, w którym należy wprowadzić nadaną nazwę akcji,

Wciśnięcie przycisku Add entry umożliwi wybór protokołu komunikacji i dalszą konfigurację.

Po skonfigurowaniu szczegółów programowanej akcji należy wcisnąć przycisk Add. Istnieje możliwość konfiguracji kilku akcji dla jednego zdarzenia. Po zdefiniowaniu wszystkich wymaganych nastaw należy zatwierdzić wprowadzone zmiany przyciskiem .

Okno All available actions

W oknie widoczne są wszystkie zdefiniowane akcje oraz akcje systemowe. Każdą z nich można:

• Edytować przyciskiem
• Wypróbować jej działanie, klikając przycisk
• Usunąć, korzystając z przycisku

Konfiguracja protokołów

KNX

• KNX destination group – Grupa docelowa KNX,
• KNX frame – Treść ramki KNX definiowana w wartości heksadecymalnej.

UDP

• Server IP – Docelowy adres IP,
• Port – Port, na którym nasłuchuje urządzenie docelowe,
• Input data – Komenda wysyłana do urządzenia docelowego.

TCP

• Server IP – Docelowy adres IP,
• Port – Port, na którym nasłuchuje urządzenie docelowe,
• Input data – Komenda wysyłana do urządzenia docelowego.

HTTP

Szczegółowa konfiguracja komunikacji przez protokół znajduje się w zakładce Services.

• Server URL address – Docelowy adres URL,

• HTTP method:
  • GET
  • POST
  • PUT
  • DELETE
• Content-type – Wybór trybu zawartości:
  • text/plain
  • application/x-www-urlencoded
  • application/json
  • application/xml
• Input data – Komenda wysyłana do urządzenia docelowego.

MQTT

Szczegółowa konfiguracja komunikacji przez protokół znajduje się w zakładce Services.

• MQTT topic – Topic, na który urządzenie wysyła dane,
• Retain flag – Włączona opcja oznacza, że brokery będą zachowywały ostatnie komunikaty dla tematów, do których urządzenie wysyła powiadomienia,
• Input data – Treść komunikatu.

IO

• Input command – Pole komendy:
  • in_cnt=ch,val – ustawienie licznika kanału ch na wartość val,
  • out_on=ch – załączenie wyjścia o numerze ch,
  • out_off=ch – wyłączenie wyjścia o numerze ch,
  • out_inv=ch – zmiana stanu wyjścia o numerze ch na przeciwny,
  • out_blink=ch,ton,toff,cnt – programowanie cyklicznego sterowania wyjściem o numerze ch. Parametry:
    • ton – czas załączenia (wyrażony w sekundach),
    • toff – czas wyłączenia (wyrażony w sekundach),
    • cnt – ilość cykli załączania (parametr nieobowiązkowy).
  • out_time=ch,ton,toff – załączenie wyjścia o numerze ch na czas określony w parametrze ton, po czasie określonym w parametrze toff. Parametr toff nie jest obowiązkowy – pominięcie tego parametru spowoduje załączenie wyjścia bez opóźnienia,
  • out_all=10n-11100 – komenda definiująca stan wszystkich dostępnych wyjść. Każda cyfra reprezentuje kolejne wyjście:
    • 1 – włączone,
    • 0 – wyłączone,
    • n – zmiana stanu na przeciwny,
    • - – bez zmiany stanu.

Internal log

• Log message – Treść komunikatu,
• Log level – Poziom komunikatu:
  • DEBUG
  • INFO
  • WARNING
  • ERROR

E-mail

Szczegółowa konfiguracja komunikacji przez protokół znajduje się w zakładce Services.

• Receivers (comma separated) – Docelowe adresy e-mail (przedzielone przecinkami),
• E-mail subject – Temat wiadomości e-mail,
• E-mail message – Treść wiadomości e-mail.

SMS

Szczegółowa konfiguracja komunikacji przez protokół znajduje się w zakładce Services.

• SMS sender – Nadawca wiadomości SMS,
• Receivers (comma separated) – Odbiorcy wiadomości SMS (przedzieleni przecinkami),
• SMS message – Treść wiadomości SMS.

SNMP Trap

• Trap message – Składnia wysyłanego powiadomienia.

Inputs

W zakładce można przypisać i skonfigurować zdefiniowane akcje do określonych wejść.

W zależności od rodzaju działania wejścia (parametr ten definiowany jest w zakładce I/O Settings / Inputs) dostępne są różne formy działań wywołujących przypisaną im akcję.

Przycisk Go to the input configuration umożliwia szybkie przejścia do zakładki I/O Settings/Inputs.
Ikona umożliwia przejście do konfiguracji krok po kroku.

Przypisywanie akcji

Aby przypisać akcję do wybranego zdarzenia należy kliknąć przycisk +. Wyświetlone zostanie okno dialogowe, w którym można wybrać pożądaną akcję, wcześniej zdefiniowaną w zakładce All.

Po przypisaniu akcji w tabeli pojawia się okno:

1. Ikona edycji dodatkowych ustawień (repetycji oraz opóźnienia):

   

   • Repetition interval [s] – Odstęp pomiędzy wykonywanymi akcjami, w przypadku zostawienia pustego pola akcja zostanie wykonana tylko raz,
     • Repetiton in a loop – Akcje będą wykonywane w pętli,
     • Specific number of repetitions – Akcje będą powtarzane określoną ilość razy,
       • Number of repetitions – Liczba przeprowadzanych akcji,
   • Delay of action execution [s]:
     • The trigger has to be active – Opóźnienie wykonania akcji, tylko w przypadku wyzwalacza aktywnego.
     • Regardless of trigger status – Opóźnienie wykonania akcji, niezależnie od stanu wyzwalacza, Wprowadzone nastawy należy zatwierdzić za pomocą przycisku Apply.

2. Ikona opóźnienia akcji: szara – opóźnienie wyłączone, zielona – opóźnienie włączone,

3. Ikona repetycji akcji: szara – repetycja wyłączona, zielona – repetycja aktywowana,
4. Nazwa akcji – nadawana przez użytkownika w trakcie dodawania lub edycji ustawień akcji,
5. Wykorzystywany protokół komunikacji,
6. Ikona kosza – kliknięcie w jej obszarze spowoduje usunięcie przypisania akcji,
7. Ikona edycji – kliknięcie w jej obszarze spowoduje edycję ustawień akcji,
8. Ikona testowania działania akcji – kliknięcie w jej obszarze spowoduje wykonanie akcji.

KNX

W zakładce Actions/KNX istnieje możliwość definiowania działań, które mają być podejmowane w odpowiedzi na otrzymane ramki danych na określone grupy w systemie KNX. Dzięki tej funkcji można skonfigurować urządzenia do automatycznego wykonywania określonych czynności w zależności od danych otrzymanych przez system KNX.

Gdy urządzenie otrzyma ramkę danych na wybranej grupie KNX (np. 1/1/1), automatycznie podejmie zdefiniowane działania. Na przykład, w zależności od konfiguracji, może to być wysłanie e-maila na określony adres, uruchomienie określonej procedury lub powiadomienie użytkowników o zdarzeniu.

W pierwszej kolejności należy wprowadzić numer grupy KNX a następnie kliknąć przycisk, co spowoduje wyświetlenie okna dialogowego ze szczegółowymi ustawieniami. Kolejnym krokiem jest wybór protokołu komunikacji:

Wciśnięcie przycisku Add entry umożliwi wybór protokołu komunikacji i dalszą konfigurację.
- Select protocol – Pole wyboru protokołu – parametry poszczególnych protokołów opisane zostały szczegółowo w rozdziale Okno Control Actions.

Po skonfigurowaniu szczegółów programowanej akcji należy wcisnąć przycisk Add. Istnieje możliwość konfiguracji kilku akcji dla jednego zdarzenia. Po zdefiniowaniu wszystkich wymaganych nastaw należy zatwierdzić wprowadzone zmiany przyciskiem .

System

Zakładka umożliwia zdefiniowanie akcji systemowych, jakie urządzenie ma wykonać w momencie następujących zdarzeń:

• Power up – Przywrócenia zasilania urządzenia,
• Ethernet up – Uzyskania dostępu do sieci Ethernet,
• Ethernet down – Utraty dostępu do sieci Ethernet,
• Wi-Fi up – Uzyskania dostępu do sieci Wi-Fi,
• Wi-Fi down – Utraty dostępu do sieci Wi-Fi,
• Modbus safe mode

Aby przypisać akcję do wybranego zdarzenia należy kliknąć przycisk +. Zostanie wyświetlone nowe okno dialogowe:

Wciśnięcie przycisku Add entry umożliwi wybór protokołu komunikacji i dalszą konfigurację.

• Select protocol – pole wyboru protokołu – parametry poszczególnych protokołów opisane zostały szczegółowo w rozdziale Okno Control Actions.

Po skonfigurowaniu szczegółów programowanej akcji należy wcisnąć przycisk Add. Istnieje możliwość konfiguracji kilku akcji dla jednego zdarzenia.
Po zdefiniowaniu wszystkich wymaganych nastaw należy zatwierdzić wprowadzone zmiany przyciskiem .

Periodic

Zakładka umożliwia zdefiniowanie akcji okresowych – wykonywanych w określonych odstępach czasu.

Protokoły komunikacyjne

W zakładce Services prezentowane są opcje umożliwiające szczegółową konfigurację obsługi różnych protokołów komunikacji, co stanowi kluczowy element funkcjonalności urządzenia.

graph LR
  A[Services] --> B[Web]
  A --> C[HTTPc]
  A --> D[MQTT]
  A --> E[E-mail]
  A --> F[SMS]
  A --> G[Modbus]
  A --> H[SNMP]
  A --> I[Syslog]
  A --> J[TCP/UDP]
  A --> K[iCluster]
  A --> L[REST API]

Web

W tej sekcji użytkownik może dostosować ustawienia dotyczące interfejsu sieciowego urządzenia, zarządzać dostępem do zasobów czy też modyfikować parametry dotyczące połączenia z siecią.

• HTTP Port – Port HTTP, z którego wysyłane są żądania,
• HTTPS port – Port HTTPS, z którego wysyłane są żądania,
• API key – Załączenie/wyłączenie wymogu posiadania klucza API do sterowania wejściami/wyjściami,
• SSL/TLS – Załączanie/wyłączanie szyfrowania,
• SSL Key file (pem) – Umożliwia wczytanie klucza serwera SSL (w formacie pem),
• Certificate file (pem) – Umożliwia wczytanie klucza CSR serwera (w formacie pem).

HTTPc

W tej sekcji możliwe jest skonfigurowanie urządzenia tak, by inicjowało połączenia HTTP z określonymi serwerami czy usługami. Można tu zdefiniować adresy URL, parametry żądań oraz inne szczegóły połączeń.
Urządzenie może wysyłać informację o zdarzeniach protokołem HTTP/HTTPS metodą GET lub POST.

• HTTP Client – Załączenie usługi HTTP Client,
• Server – Adres serwera HTTP do którego będą wysyłane informacje,
• HTTP Port – Port, na którym nasłuchuje serwer HTTP,
• HTTP Method – Metoda wysyłania wiadomości GET/POST/PUT/DELETE,
• Content type – Typ zawartości:
  • text/plain
  • json
  • xml
  • form
• Resource – Zasób, do którego moduł będzie się odwoływał,
• API key – Załączenie/wyłączenie wymogu posiadania klucza API do sterowania wejściami/wyjściami,
• User – Nazwa użytkownika,
• Password – Hasło,
• HTTP ping request interval – Częstotliwość wysyłania żądania ping,
• HTTP ping request – Treść żadania ping,
• SSL/TLS – Włączanie / wyłączanie szyfrowania,
• SSL certificate mode – Tryb certyfikatu SSL:
  • Use Certificate Bundle – Użyj pakietu certyfikatów,
  • Use Uploaded Certificate – Użyj certyfikatu wczytanego do urządzenia,
  • Insecure! Disable SSL verification – Wyłącz weryfikację SSL,
• Skip cert CN check – Pomijanie sprawdzania nazwy pospolitej certyfikatu,
• Use Client certificate – Wymaganie przesłania klucza klienta, hasła i certyfikatu,
• Client key password – Hasło do klucza klienta,
• SSL server root certificate – Umożliwia wczytanie certyfikatu serwera SSL,
• Client certificate – Umożliwia wczytanie certyfikatu klienta SSL,
• Client key – Umożliwia wczytanie klucza klienta SSL.

MQTT

Zakładka ta służy do konfiguracji parametrów komunikacji z brokerem MQTT, umożliwiając wymianę danych w modelu publikuj-subskrybuj. Pozwala to na definiowanie kluczowych aspektów takich jak tematy, adres serwera, port oraz inne istotne parametry połączenia.
Urządzenie przesyła informacje na serwer co 1 minutę oraz za każdym razem, gdy następuje zmiana wartości.

Transmisja tych danych może być zabezpieczona szyfrowaniem. Po nawiązaniu połączenia z brokerem MQTT, użytkownicy mogą subskrybować dane wychodzące z urządzenia.

Nie ma ograniczenia w liczbie subskrybentów, którzy mogą jednocześnie odbierać informacje z pojedynczego urządzenia.

• MQTT Client – Załączenie usługi MQTT,
• Server – Adres brokera MQTT,
• MQTT Port – Port, na którym nasłuchuje serwer (najczęściej 1883),
• QoS – Poziom jakości usługi. Może przyjąć jedną z trzech wartości: 0 (At most once), 1 (At least once), 2 (Exactly once),
• Subsribe topic – Temat, na który zostanie wysłana wiadomość (temat musi być w formacie np. /sensor/home – bez znaku „/” na końcu linii),
• Client ID,
• User – (opcjonalnie) nazwa użytkownika MQTT,
• Password – (opcjonalnie) hasło użytkownika MQTT,
• API key – Załączenie/wyłączenie wymogu posiadania klucza API do sterowania wejściami/wyjściami,
• Send test message – Wysłanie do brokera wiadomości testowej o temacie validation i zawartości 1.

• SSL/TLS – Włączanie / wyłączanie szyfrowania,
• SSL certificate mode – Tryb certyfikatu SSL:
  • Use Certificate Bundle – Użyj pakietu certyfikatów,
  • Use Uploaded Certificate – Użyj certyfikatu wczytanego do urządzenia,
  • Insecure! Disable SSL verification – Wyłącz weryfikację SSL,
• Skip cert CN check – Pomijanie sprawdzania nazwy pospolitej certyfikatu,
• Use Client certificate – Wymaganie przesłania klucza klienta, hasła i certyfikatu,
• Client key password – Hasło do klucza klienta.

Urządzenie wyposażone jest w mechanizm LWT, co oznacza Last Will and Testament (Ostatnia Wola i Testament). LWT jest mechanizmem, który umożliwia klientowi MQTT wysłanie wiadomości automatycznie w przypadku, gdy klient ten ulegnie awarii lub utraci połączenie z brokerem MQTT.
Mechanizm LWT pozwala na zdefiniowanie tematu (topic) oraz treści wiadomości, które zostaną opublikowane, gdy klient utraci połączenie.

• LWT – Załączenie / wyłączenie mechanizmu LWT,
• QoS – Poziom jakości dostarczenia wiadomości – odnosi się do tego, jak wiadomość LWT zostanie dostarczona w przypadku utraty połączenia przez klienta. Może przyjąć jedną z trzech wartości: 0 (At most once), 1 (At least once), 2 (Exactly once),
• LWT retain – Flaga informująca broker MQTT, czy ma przechowywać ostatnią wiadomość LWT dla klientów, którzy się z nim zarejestrują po utracie połączenia klienta LWT,
• LWT Topic – Temat, który zostanie użyty do publikacji wiadomości LWT,

• LWT Message – Treść wiadomości, która zostanie opublikowana w temacie LWT po utracie połączenia klienta.

• SSL server root certificate – Umożliwia wczytanie certyfikatu serwera SSL,

• Client certificate – Umożliwia wczytanie certyfikatu klienta SSL,
• Client key – Umożliwia wczytanie klucza klienta SSL.

E-mail

W tej części konfiguruje się parametry połączenia z serwerem poczty elektronicznej, co pozwala na automatyczne wysyłanie e-maili w odpowiedzi na określone zdarzenia czy alarmy.

• E-mail – Załączenie / wyłączenie usługi wysyłania e-maili,
• Server – Adres serwera SMTP,
• Port – Port usługi pocztowej,
• SSL/TLS – Właczenie / wyłączenie szyfrowania,
• User – Nazwa użytkownika,
• Authorization – Metoda autoryzacji:
  • None – Brak,
  • Plain – Hasło,
• Password – Hasło, tylko przy Authorization: plain,
• From – Adres mailowy nadawcy,
• Subject – Temat wysyłanego e-maila,
• Recipients (comma separated) – Lista odbiorców e-maili (oddzielone przecinkami),
• Debug – Włączanie funkcji debugowania wiadomości,
• Send a test e-mail – Wysyłanie testowego e-maila.

SMS

Można tak skonfigurować urządzenie, aby wysyłało SMS-y w odpowiedzi na określone zdarzenia lub z informacją np. o alarmie.

• SMS service – Załączenie / wyłączenie usługi wysyłania SMS,
• Provider – Parametr określa dostawcę usług SMS, z którym zintegrowane jest API:
  • SMSAPI.pl
• Token API – Unikalny klucz autoryzacyjny, który jest używany do weryfikacji dostępu i komunikacji z API dostawcy usługi SMS,
• Limit – Dzienny limit wiadomości SMS, wprowadzenie wartości 0 spowoduje wyłączenie opcje wysyłania wiadomości SMS,
• From – Definiuje nadawcę wiadomości SMS; może to być predefiniowana nazwa, numer telefonu lub inny identyfikator, który będzie widoczny dla odbiorcy wiadomości,
• Recipients (comma separated) – Lista numerów telefonów odbiorców, do których mają być wysyłane wiadomości, numery powinny być oddzielone przecinkami,
• Send a test SMS – Opcja pozwala na wysłanie testowej wiadomości SMS w celu weryfikacji poprawności konfiguracji i działania usługi.

Modbus

Dane z urządzenia można odczytywać i zapisywać przez protokół Modbus TCP. Urządzenie obsługuje następujące funkcje Modbus:

• 0x01 Read Coils
• 0x02 Read Discrete Inputs
• 0x03 Read Holding Register
• 0x04 Read Input Register
• 0x05 Write Single Coil
• 0x06 Write Single Register
• 0x0F Write Multiple Coils
• 0x10 Write Multiple Registers

• Modbus TCP – Załączanie/wyłączanie obsługi protokołu Modbus TCP,
• TCP Port – Port Modbus TCP (domyślnie 502),
• Modbus RTU via TCP – Załączanie/wyłączanie obsługi protokołu Modbus RTU via TCP,
• PDU,
• RTU Baudrate – Szybkośc transmsji RTU,
• RTU Parity – Parzystość RTU,
• RTU Stop bit – "bit stopu".

Zawartość rejestrów przedstawiono w poniższych tabelach:

Adresacja Coils

Adresacja Read Discrete Inputs

Adresacja Holding Registers

Adresacja Read Input Registers

SNMP

Sekcja ta pozwala na konfigurację parametrów protokołu SNMP, używanego do monitorowania i zarządzania urządzeniami w sieci. Moduł wyposażony jest w serwer SNMP v2c oraz v3. W zależności od wyboru wersji SNMP dostępne są różne parametry ustawień.

SNMP v2c

• SNMP – Załączanie / wyłączanie obsługi protokołu SNMP,
• SNMP version – Wersja SNMP: v2c lub v3,
• sysDescr
• sysContact
• sysName
• sysLocation
• Read community – Hasło do odczytu danych (dotyczy tylko SNMP v2c),
• Write community – Hasło do zapisu danych (dotyczy tylko SNMP v2c).

• Write community – Hasło do zapisu danych,
• Trap IP – Adres na jaki będą wysyłane komunikaty trap.

SNMP v3

• Enable – załączanie / wyłączanie obsługi protokołu SNMP,
• SNMP version – wersja SNMP: v2c lub v3,
• sysDescr
• sysContact
• sysName
• sysLocation
• EngineId – Unikalny identyfikator urządzenia (dotyczy tylko SNMP v3).

Parametry, które można ustawić w tym oknie pozwalają na zdefiniowanie uwierzytelniania i mechanizmów prywatności dla różnych użytkowników.

• Username – Nazwa użytkownika,
• Auth Protocol – Wybór protokołu uwierzytelniania komunikatów:
  • no
  • md5
  • sha
• Authorization Key – Klucz autoryzacji,
• Priv Protocol – Protokół prywatności:
  • no
  • des
  • aes
• Private Key – Klucz prywatny,
• Writable – Nadawanie użytkownikowi uprawnień do wysyłania komunikatów do urządzenia.

Parametry ustawialne w tym oknie odnoszą się do konkretnych komunikatów trap generowanych dla lub przez danego użytkownika.

• IP – Adres IP urządzenia lub systemu, który generuje komunikat trap,
• Username – Nazwa użytkownika SNMPv3,
• Secure Level – Poziom bezpieczeństwa używany w komunikacji SNMPv3:
  • noAuthnoPriv – Komunikacja SNMPv3 odbywa się bez żadnych zabezpieczeń,
  • authNoPriv – Komunikacja SNMPv3 uwierzytelniona, ale nieszyfrowana,
  • authPriv – Komunikacja SNMPv3 uwierzytelniona oraz szyfrowana,
• Auth Protocol – Algorytm uwierzytelniania używany do weryfikacji tożsamości użytkownika:
  • no
  • md5
  • sha
• Priv Protocol – Algorytm szyfrowania używany do zapewnienia prywatności komunikatu:
  • no
  • md5
  • sha
• Authorization Key – Klucz używany w procesie uwierzytelniania,
• Private Key – Klucz prywatny,
• Engine ID – Unikalny identyfikator używany do reprezentowania instancji silnika SNMPw urządzeniu.

Download MIB file – Link do pobrania pliku MIB.

Syslog

W tej części można skonfigurować wysyłanie logów systemowych do zewnętrznego serwera syslog, co ułatwia zdalną diagnostykę oraz monitorowanie działania urządzenia.

• Syslog – Załączanie usługi klienta Syslog,
• Server – Adres serwera Syslog wpisany w postaci adresu IP lub domeny o maksymalnej długości 24 znaków,
• Port – Numer portu, na którym serwer nasłuchuje,
• System events – Zdarzenia związane z funkcjonowaniem samego systemu,
• Syslog IO – Zdarzenia związane z wejściami/wyjściami.

TCP/UDP

Zakładka TCP/UDP na stronie internetowej umożliwia załączanie i konfigurowanie obsługi protokołów komunikacyjnych TCP oraz UDP. Wysyłając komendy na adres IP i port urządzenia przy użyciu odpowiedniego protokołu, użytkownik może sterować stanem wyjść modułu. Dostępne komendy – patrz Komendy IO.

• TCP server – Załączenie usługi TCP server,
• TCP port – Numer portu, na którym serwer nasłuchuje,
• UDP server – Załączenie usługi UDP server,
• UDP port – Numer portu, na którym serwer nasłuchuje,
• API key – Załączenie/wyłączenie wymogu posiadania klucza API do sterowania wejściami/wyjściami.

iCluster

Funkcja iCluster umożliwia połączenie różnych urządzeń Inveo w jednej sieci LAN. Urządzenie IQIO może pracować w trybie klienta iCluster, umożliwiając urządzeniu nadzór nad swoimi parametrami, takimi jak: wartości odczytów z czujników, stan wejść i wyjść, sterowanie wyjściami itp.

• Inveo iCluster – Włączanie obsługi iCluster,
• Passphrase – Hasło używane przez klienta Inveo, które umożliwia komunikację między urządzeniami. Hasło ustawione w tym miejscu będzie wymagane w urządzeniu, które będzie chciało nawiązać połączenie z urządzeniem nadrzędnym.

Komendy IO

Zestawienie komend używanych do tworzenia akcji opartych na komendach IO. Warto zaznaczyć, że poniższe komendy są również skuteczne przy użyciu różnych protokołów, takich jak HTTP, MQTT, UDP oraz TCP.

• in_cnt=ch,val – ustawienie licznika kanału ch na wartość val,
• out_on=ch – załączenie wyjścia o numerze ch,
• out_off=ch – wyłączenie wyjścia o numerze ch,
• out_inv=ch – zmiana stanu wyjścia o numerze ch na przeciwny,
• out_blink=ch,ton,toff,cnt – programowanie cyklicznego sterowania wyjściem o numerze ch. Parametry:
  • ton – czas załączenia (wyrażony w sekundach),
  • toff – czas wyłączenia (wyrażony w sekundach),
  • cnt – ilość cykli załączania (parametr nieobowiązkowy).
• out_time=ch,ton,toff – załączenie wyjścia o numerze ch na czas określony w parametrze ton, po czasie określonym w parametrze toff. Parametr toff nie jest obowiązkowy – pominięcie tego parametru spowoduje załączenie wyjścia bez opóźnienia,
• out_all=10n-11100 – komenda definiująca stan wszystkich dostępnych wyjść. Każda cyfra reprezentuje kolejne wyjście:
  • 1 – włączone,
  • 0 – wyłączone,
  • n – zmiana stanu na przeciwny,
  • - – bez zmiany stanu.

Komendy można łączyć znakiem &.

Wbudowane zmienne

Poniżej przedstawiona jest tabela zawierająca przykładowe wewnętrzne zmienne, które umożliwiają przekazywanie danych związanych z działaniem urządzenia. Zmienne te znajdują zastosowania w powiadomieniach mailowych, SMS-owych, HTTP Client itp.

REST API

• REST API – Załączenie funkcji REST API,
• Port – Port, na którym urządzenie nasłuchuje,
• Authentication type – Typ autoryzacji:
  • None – Brak,
  • Basic authentication – Autoryzacja przy użyciu nazwy użytkownika i hasła dostępowego,
  • API KEY – Autoryzacja przy użyciu API KEY utworzonego w zakładce Administration / Access. Klucz należy wprowadzić jako parametr zapytania, poprzedzony apikey=.
• User – Nazwa użytkownika stosowana przy autoryzacji basic,
• Password – Hasło stosowane przy autoryzacji basic,

• SSL/TLS – Włączanie/wyłączanie szyfrowania.

• SSL Key file (pem) – Wskazanie pliku klucza SSL (w formacie pem),

• Certificate file (pem) – Wskazanie pliku certyfikatu (w formacie pem).

Ustawienia fabryczne, backup

Awaryjne wgrywanie oprogramowania / przywracanie ustawień fabrycznych

W przypadku wystąpienia awarii urządzenia uniemożliwiającego normalny dostęp do strony www należy skorzystać z procedury awaryjnej:

1. Odłączyć urządzenie od zasilania,
2. Wcisnąć przycisk RESET,
3. Zasilić urządzenie i podłączyć do sieci LAN,
4. Nie zwalniając przycisku RESET otworzyć stronę urządzenia:
   • Adres IP: 192.168.111.15
   • Maska IP: 255.255.255.0

Odwołując się do podanego adresu IP uzyskamy dostęp do bootloadera urządzenia. Przycisk RESET można zwolnić dopiero po otwarciu strony:

W tym miejscu mamy możliwość wgrania firmware, resetu urządzenia do ustawień fabrycznych oraz jego restartu.

Backup

W tej sekcji użytkownicy mogą tworzyć kopie zapasowe aktualnej konfiguracji systemu oraz przywracać system z wcześniejszych kopii zapasowych.

Create a backup file

• Enter password – Umożliwia wpisanie hasła, chroniącego tworzoną kopię zapasową,
• Re-type password – Powtórne wpisanie hasła.

Przycisk Download umożliwia zapis kopii zapasowej na komputerze.

Restore

• Backup password – Hasło dostępu do wgrywanej kopii zapasowej,
• Backup file – Przycisk umożliwiający wyszukanie pliku kopii zapasowej.

Przycisk Upload spowoduje wgranie wybranej kopii zapasowej do urządzenia.
Przycisk Reboot umożliwia ponowne uruchomienie urządzenia.
Przycisk Reset to default umożliwia przywrócenie nastaw fabrycznych w urządzeniu.

Gwarancja i odpowiedzialność producenta

Producent zobowiązuje się do przestrzegania umowy gwarancyjnej, jeżeli spełnione są następujące warunki:

• Wszystkie naprawy, zmiany, rozszerzenia oraz kalibracje urządzenia wykonywane są przez producenta lub autoryzowany serwis,
• Sieciowa instalacja zasilająca spełnia warunki obowiązujących w tym względzie norm,
• Urządzenie obsługiwane jest zgodnie z zaleceniami przedstawionymi w niniejszej Instrukcji,
• Urządzenie używane jest zgodnie z przeznaczeniem.

Producent nie ponosi żadnej odpowiedzialności za konsekwencje wynikłe z nieprawidłowej instalacji, niewłaściwego użytkowania urządzenia, nieprzestrzegania instrukcji obsługi oraz przeprowadzania napraw przez osoby nieposiadające uprawnień.

Warunki przechowywania, pracy i transportu

Urządzenie powinno być przechowywane w pomieszczeniach zamkniętych, w których atmosfera jest wolna od par i środków żrących oraz:

• Temperatura otoczenia od -30°C do +60°C,
• Wilgotność od 25% do 90% (niedopuszczalne skroplenia),
• Ciśnienie atmosferyczne 700 do 1060 hPa.

Urządzenie przeznaczone jest do pracy w następujących warunkach:

• Temperatura otoczenia od -10°C do +55°C,
• Wilgotność od 30% do 75%,
• Ciśnienie atmosferyczne 700 do 1060 hPa.

Zalecane warunki transportu:

• Temperatura otoczenia od -40°C do +85°C,
• Wilgotność od 5% do 95%,
• Ciśnienie atmosferyczne 700 do 1060 hPa.

Instalacja i użytkowanie urządzenia:

• Moduł powinien być obsługiwany zgodnie z zaleceniami przedstawionymi w dalszej części instrukcji.

Utylizacja i likwidacja

W przypadku, kiedy niezbędna staje się likwidacja urządzenia (np. po upływie czasu jego użytkowania), należy zwrócić się do producenta lub przedstawiciela producenta, którzy zobowiązani są do właściwej reakcji, tzn. odbioru urządzenia od użytkownika. Użytkownik może się również zwrócić do firm zajmujących się utylizacją i/lub likwidacją urządzeń elektrycznych lub sprzętu komputerowego. W żadnym wypadku nie należy umieszczać urządzenia wraz z innymi odpadkami.