RFID RCP2

Przegląd

Przeznaczenie urządzenia

Urządzenie RCP2 to zaawansowany czytnik RFID, zaprojektowany dla różnych sektorów takich jak przemysł, usługi, handel i logistyka. Może być wykorzystywany do wielu zastosowań, m.in. jako narzędzie logowania dostępu do maszyn, kontrola dostępu do różnych pomieszczeń, element systemu lojalnościowego oraz rejestrator czasu pracy.

Dzięki obsłudze różnych protokołów komunikacyjnych, użytkownik ma możliwość pełnej kontroli nad czytnikiem, włącznie z wyświetlaczem, sygnalizatorem dźwiękowym oraz wejściami i wyjściami. Dodatkowo, dzięki wbudowanej pamięci, urządzenie umożliwia przechowywanie oraz dostęp do listy zapisanych logów. Z uwagi na wbudowaną pamięć, czytnik może pracować autonomicznie, bez konieczności korzystania z serwera zewnętrznego.

Czytnik obsługuje szyfrowanie SSL, HTTPS, kontrolę certyfikatów oraz wysyłanie wiadomości e-mail. Dostępna jest również wersja z funkcją Wi-Fi, co zapewnia elastyczność instalacji i integracji z istniejącymi systemami.

Changelog

1.0 07 kwietnia 2025

• Wersja oprogramowania v0.17

Budowa urządzenia

Dane techniczne

Ze względu na różnorodność instalacji oraz zróżnicowane potrzeby instalatorów urządzenie nie posiada żadnych otworów montażowych w obudowie. Otwory należy wykonać we własnym zakresie w tylnej części obudowy, w dowolnym miejscu – nie ma to wpływu na zachowanie gwarancji. Należy pamiętać o zastosowaniu odpowiedniego przepustu kablowego w celu zachowania szczelności.

Wymiary

• Wersja z klawiaturą:

Opis złącz

1. RS485 – Złącze RS485 - Modbus RTU,
2. LAN – Gniazdo podłączenia sieci LAN,
3. Zworka RESET – Zwarcie pinów na czas pomiędzy 10-15 sekund powoduje powrót urządzenia do nastaw fabrycznych,
4. Gniazdo baterii
5. RelayMode – Zworki do ustawiania trybu pracy przekaźnika. W pozycji 1-2 -styki bezpotencjałowe, w pozycji 2-3 – wyjście PWR,
6. OUT1 – Złącze przekaźnika nr 1,
7. OUT2 – Złącze przekaźnika nr 2,
8. IN1 – Wejście ogólnego przeznaczenia nr 1,
9. IN2 – Wejście ogólnego przeznaczenia nr 2,
10. +12V- – Złącze zasilania modułu 12-24V DC.

Sposób podłączenia wejść

Wyjścia OUT1 i OUT2 mogą działać w dwóch trybach:

• Tryb PWR – Zworki konfiguracyjne ustawione w pozycji 2-3 (patrz rysunek poniżej). W trybie tym po aktywacji przekaźnika na wyjściu pojawi się napięcie zasilania czytnika np. 12V DC. Jeśli czytnik będzie zasilany z 24V DC to pojawi się napięcie 24V DC.

• Tryb Normally Open – Zworki ustawione w pozycji 1-2 (patrz rysunek poniżej). W tym trybie wymagane jest podłączenie zewnętrznego źródła zasilania.

Kanały komunikacji i cechy ogólne

Wygląd ogólny modułu RFID RCP2

Wygląd ogólny modułu RFID RCP2 z klawiszami

Wygląd ogólny modułu RFID RCP2 z klawiaturą numeryczną

Moduł umożliwia komunikację poprzez sieć LAN (WLAN) lub interfejs RS485, a użytkownik ma do wyboru różne protokoły komunikacyjne, które pozwalają na zdalne monitorowanie statusu i kontrolę urządzenia:

• Wbudowany serwer www, przy użyciu standardowej przeglądarki internetowej (zalecana przeglądarka: Google Chrome),
• Protokół HTTP/HTTPS w trybie serwer,
• Protokół HTTP/HTTPS w trybie klient,
• Protokół Modbus TCP,
• Protokół Modbus RTU (RS485 lub opcjonalnie RS232),
• MQTT w trybie klient.

Moduł obsługuje szyfrowanie SSL, HTTPS, weryfikację certyfikatów oraz możliwość wysyłania wiadomości e-mail.

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. 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ń sieci LAN oraz Wi-Fi

Aby dostosować ustawienia sieciowe urządzenia, należy przejść do zakładki Administration / Network. Tutaj możliwe jest skonfigurowanie parametrów LAN (oraz WLAN, jeśli dostępne) takich jak adres IP, maska podsieci, brama, DNS oraz inne specyficzne dla sieci opcje.

• MAC Address – Adres MAC urządzenia,
• DHCP – Załączanie / wyłączanie funkcji klienta DHCP,
• IP – Adres IP urządzenia,
• Netmask – Maska podsieci IP,
• Gateway – Brama sieciowa,
• DNS1, DNS2 – Adresy serwerów DNS.

W wersji urządzenia wyposażonej w moduł Wi-Fi, dostępne są dodatkowe opcje do konfiguracji połączenia bezprzewodowego:

• MAC Address – Adres MAC urządzenia,
• Enable – Załączanie/Wyłączanie Wi-Fi,
• DHCP – Załączanie / wyłączanie funkcji klienta DHCP,
• IP – Adres IP urządzenia,
• Netmask – Maska podsieci IP,
• Gateway – Brama sieciowa,
• DNS1, DNS2 – Adresy serwerów DNS,
• SSID – Nazwa sieci bezprzewodowej,
• Password – Hasło dostępu do sieci bezprzewodowej,
• Encryption – Wybór rodzaju szyfrowania WLAN:
  • Open – Sieć otwarta, bez zabezpieczeń,
  • WEP,
  • WPA-PSK,
  • WPA2_PSK,
  • WPA_WPA2_PSK,
  • WPA3_PSK.

Wprowadzone zmiany należy zapisać przyciskiem Save.

Sprawdzanie stanu sieci

Urządzenie umożliwia kontrolę aktualnych ustawień sieci LAN oraz WLAN. W zakładce Administration / Network należy nacisnąć przycisk Show net status.

Sekcja Interface eth zawiera ustawienia dla sieci LAN:

• MAC – Adres MAC urządzenia,
• IP – Adres IP urządzenia,
• Mask – Maska podsieci,
• Gateway – Brama sieciowa,
• DNS1, DNS2 – Adresy serwerów DNS.

Sekcja Interface wlan zawiera ustawienia dla sieci WLAN (Wi-Fi):

• MAC – Adres MAC urządzenia,
• IP – Adres IP urządzenia,
• Mask – Maska podsieci,
• Gateway – Brama sieciowa,
• DNS1, DNS2 – Adresy serwerów DNS,
• SSID – Nazwa rozgłoszeniowa sieci WLAN, do której urządzenie jest podłączone,
• RSSI – Moc sygnału Wi-Fi wyrażona w dBm. Wartość -110 oznacza brak sygnału.

Konfiguracja urządzenia

Strona tytułowa i status urządzenia

Strona tytułowa urządzenia, dostępna w przeglądarce internetowej, pełni funkcję głównego interfejsu użytkownika, zapewniając dostęp do kluczowych informacji o bieżącym stanie urządzenia. Domyślnie strona ta jest dostępna pod adresem IP: 192.168.111.15, jednak istnieje możliwość zmiany tego adresu w ustawieniach sieciowych urządzenia.

Na stronie tytułowej prezentowane są szczegółowe informacje na temat statusu wejść, wyjść oraz innych parametrów operacyjnych. Interfejs został zaprojektowany w sposób intuicyjny, aby ułatwić użytkownikowi nawigację oraz szybki dostęp do najważniejszych danych.

Po wybraniu zakładki, wyświetlona zostaje tabela Status:

• Input 1 – Aktualny stan wejścia numer 1 (wejście binarne),
• Input 2 – Aktualny stan wejścia numer 2 (wejście binarne),
• Relay 1 – Aktualny stan wyjścia przekaźnikowego nr 1,
• Relay 2 – Aktualny stan wyjścia przekaźnikowego nr 2,
• Last read ID – Ostatni odczytany TAG w formacie HEX,
• Number of read ID – Liczba odczytanych tagów od momentu resetu urządzenia.

Dzięki wbudowanemu serwerowi WWW, użytkownik może uzyskać dostęp do strony tytułowej z dowolnego miejsca w sieci lokalnej, co ułatwia zarządzanie i konfigurację urządzenia.

Zakładka Administration

Zakładka Administration w interfejsie użytkownika urządzenia pozwala na zarządzanie kluczowymi ustawieniami systemowymi, w tym konfigurację usług diagnostycznych, ustawień czasu, ustawień sieciowych, aktualizację oprogramowania oraz zmianę hasła dostępu. Użytkownik ma również możliwość wykonania kopii zapasowej aktualnych ustawień. Zakładka ta jest podzielona na kilka podzakładek, z których każda oferuje specyficzne funkcje.

Nazwa modułu

W sekcji Settings w zakładce Administration użytkownik ma możliwość nadania unikalnej nazwy dla urządzenia, służącej do identyfikacji i ułatwiającej zarządzanie wieloma urządzeniami w sieci. Opcja Enable Remote Config, umożliwiająca zdalną konfigurację, została opisana w rozdziale Konfiguracja sieciowa.

Zmiana hasła

Użytkownik ma możliwość zarządzania bezpieczeństwem dostępu do urządzenia poprzez zmianę hasła. Aby to zrobić:

1. W polu Current Password należy wpisać aktualne hasło,
2. W polach New Password oraz Re-type Password należy wpisać nowe hasło,
3. Zmiany należy zatwierdzić klikając przycisk Save.

Ustawienia czasu

W zakładce Administration / Time dostępne są opcje konfiguracji daty i godziny. Czytnik ma wbudowany zegar czasu rzeczywistego z podtrzymaniem bateryjnym, dlatego nawet w przypadku awarii zasilania czas będzie poprawnie odmierzany.

Przycisk Update Time powoduje synchronizację czasu wewnętrznego zegara z aktualnym czasem ustawionym na komputerze. Strefę czasową można ustawić z poziomu listy rozwijalnej. Zaznaczenie opcji Daylight saving oznacza wymuszenie stosowania czasu letniego i zimowego.

Serwer czasu SNTP

Urządzenie wpiera obsługę klienta SNTP. W celu skonfigurowanie usługi SNTP należy przejść do zakładki Services / SNTP.

• Enable – Włączenie klienta SNTP,
• Server – Adres IP lub nazwa domenowa serwera SNTP,
• Poll time – Częstotliwość odpytywania serwera czasu.

Diagnostyka, zdarzenia

Moduł oferuje zaawansowane opcje diagnostyczne, które pozwalają na logowanie danych oraz wysyłanie ich na serwer Syslog. Ustawienia dostępne są w zakładce Administration / System Events.

Tabela Log Events to flash settings pozwala na skonfigurowanie zdarzeń, które mają być logowane do pamięci flash urządzenia:

• Enable – Włączenie logowania zdarzeń do pamięci flash,
• Log cards events – Ustawienie logowania zdarzeń przyłożenia karty – niezależnie od logowania do pamięci kart,
• Log IO – Ustawienie logowania zmian stanów wejść i wyjść,
• Log system events – Ustawienie logowania zdarzeń systemowych tj.: włączenie modułu, zmiany ustawień czasu, reset, restart oraz zmiany konfiguracji,
• Log network events – Ustawienie logowania zdarzeń sieciowych np.: nawiązanie połączenia Wi-Fi.

Podgląd zapisanych danych jest dostępny po kliknięciu w link System log, natomiast link Realtime diagnostic message prowadzi do strony z logami wyświetlanymi w czasie rzeczywistym.

Syslog

Urządzenie ma możliwość przekazywania danych do serwera Syslog. Użytkownik może wybrać jakie zdarzenia będą wysyłane. Konfiguracji dokonuje się w tabeli Syslog Settings, zlokalizowanej w zakładce Administration / System Events.

• Enable – Włączenie klienta syslog,
• Syslog filter – Ustawienie filtrowania zdarzeń wysyłanych do serwera Syslog:
  • All – Wysyłane są wszystkie zdarzenia zarejestrowane przed urządzenie,
  • Filter – Wysyłane są wyłącznie dane zaznaczone w tabeli Log events to flash settings.

Special

Zakładka Special jest przeznaczona do wprowadzania specjalnych ustawień konfiguracyjnych, które mogą być dostosowane do indywidualnych wymagań klienta. W tej sekcji można wprowadzać niestandardowe parametry i ustawienia zgodnie z wymaganiami projektu.

Zakładka I/O Settings

Zakładka I/O Settings umożliwia konfigurację funkcji związanych z wejściami i wyjściami urządzenia. Czytnik wyposażony jest w dwa wyjścia przekaźnikowe oraz dwa wejścia cyfrowe bezpotencjałowe. Użytkownik ma możliwość dostosowania działania przekaźników i konfiguracji wejść zgodnie z potrzebami aplikacji.

Ustawienia wejść cyfrowych

• Input invert – Programowa zmiana domyślnego stanu wejścia,
• Input action – Określa akcję, która zostanie podjęta w przypadku aktywacji wejścia:
  • No action – Brak akcji,
  • Out 1 – Wysterowanie wyjścia przekaźnikowego nr 1,
  • Out 2 – Wysterowanie wyjścia przekaźnikowego nr 2.
• Input filter – Pozwala ustawić czas (w ms), przez który urządzenie ignoruje krótkotrwałe zmiany sygnału wejściowego, traktując je jako zakłócenia. Wartość 0 wyłącza filtrację, co oznacza brak opóźnień.

Ustawienia wyjść przekaźnikowych

• Out mode – Tryb działania wyjścia przekaźnikowego:
  • None – Programowe wyłączenie sterowania przekaźnikiem. Przekaźnik nie jest aktywowany,
  • Off – Trwałe wyłączenie przekaźnika,
  • On – Trwałe włączenie przekaźnika,
  • Toggle – Zmiana stanu przekaźnika na przeciwny (włączenie, jeśli był wyłączony, lub wyłączenie, jeśli był włączony),
  • On period – Włączenie przekaźnika na czas określony w polu Out Time,
  • On long period – Włączenie przekaźnika na czas określony w polu Out Time Long.
• Out time – Czas załączenia przekaźnika dla trybu On Period. Użytkownik może wprowadzić wartość w sekundach, przez co przekaźnik będzie aktywny przez określony czas,
• Out time long – Czas załączenia przekaźnika dla trybu On Long Period. Ustawia czas działania przekaźnika na dłuższy okres,
• Out invert – Programowa zmiana stanu przekaźnika – domyślnie ustawiony na NO (normalnie otwarty); zaznaczenie opcji Invert zmienia go na NC (normalnie zamknięty).

Analogiczne ustawienia są dostępne zarówno dla wyjścia nr 1 jak i nr 2.

Wyświetlacz LCD

Dla czytnika w wersji z wyświetlaczem jest dostępna konfiguracja domyślnego tekstu LCD oraz reakcji na przyłożenie karty. Ustawienia tekstu wyświetlacza dla stanu standby, dostępne są w zakładce I/O Settings zakładka LCD.

• LCD Backlight – Czas podświetlenia ekranu. Wprowadzenie wartości 0 spowoduje trwałe wyłączenie podświetlenia, wprowadzenie -1 załączy podświetlenie na stałe,
• LCD Default Text – Tekst wyświetlacza dla stanu standby, użytkownik może skorzystać z dostępnej listy zmiennych,
• Show Clock – Opcja włączenia zegara w pierwszej linii wyświetlacza.

Tylko RCP2

Wyświetlacz może zostać skonfigurowany do wyświetlania rodzaju wybranego wejścia/wyjścia.

• Text Entrance – Wejście,
• Text Exit – Wyjście,
• Text Work – Służbowe,
• Text Private – Prywatne.

Klawiatura

Zakładka Button w urządzeniu RCP2 z klawiaturą służy do konfiguracji działania klawiatury oraz dostosowania jej funkcji do indywidualnych potrzeb. Użytkownik ma możliwość wyboru kilku opcji, które mogą wpływać na sposób obsługi klawiszy i komunikacji urządzenia.

• Sound – Umożliwia włączanie lub wyłączanie sygnału dźwiękowego, który pojawi się po naciśnięciu klawisza na klawiaturze,
• Card Emulate – Włącza lub wyłącza funkcję traktowania wprowadzonych na klawiaturze kodów jako zbliżeniowej karty RFID.

Dodatkowe opcje dostępne przy aktywacji funkcji HTTP Client:

• HTTP Client Method – Umożliwia wybór metody komunikacji HTTP, np. GET, POST. Opcja ta pozwala na określenie, w jaki sposób dane będą przesyłane z urządzenia do serwera zewnętrznego,
• HTTP Content Type – Pozwala na określenie typu zawartości przesyłanej w żądaniu HTTP, np. JSON, XML, co ułatwia integrację z różnymi systemami odbierającymi dane,
• HTTP Client Request – Konfiguracja żądania HTTP, które zostanie wysłane po wprowadzeniu kodu na klawiaturze. Dzięki tej opcji możliwe jest np. wysyłanie kodów wprowadzonego przez użytkownika do zewnętrznego serwera w celu weryfikacji lub dalszej obróbki.

Dodatkowe opcje dostępne przy aktywacji funkcji MQTT:

• MQTT – Umożliwia włączanie lub wyłączanie funkcji publikowania danych za pomocą protokołu MQTT,
• MQTT Payload – Konfiguruje zawartość danych przesyłanych w komunikatach MQTT. Użytkownik może dostosować informacje, jakie będą przesyłane do brokerów MQTT po wprowadzeniu kodu lub wykonaniu innych akcji na klawiaturze.

Zmienne predefiniowane

Użytkownik ma dostęp do zestawu zmiennych predefiniowanych, które mogą być używane w konfiguracji tekstu wyświetlacza i innych funkcji:

• %usr_name1% – Pole name z bazy kart (puste, jeśli brak wpisu),
• %usr_name2% – Pole surname z bazy kart (puste, jeśli brak wpisu),
• %usr_id% – Numer ID z bazy kart, wartość -1, jeśli brak wpisu,
• %uid% – Numer UID,
• %time% – Aktualny czas z urządzenia,
• %date% – Aktualna data z urządzenia,
• %ts% – Aktualny timestamp z urządzenia,
• %mod_name% – Nazwa urządzenia,
• %mod_model% – Model urządzenia,
• %eip% – Ethernet adres IP,
• %emac% – Ethernet adres MAC,
• %in1% – Stan wejścia nr 1,
• %in2% – Stan wejścia nr 2,
• %cnt1% – Wartość licznika wejścia nr 1,
• %cnt2% – Wartość licznika wejścia nr 2,
• %out1% – Stan wyjścia nr 1,
• %out2% – Stan wyjścia nr 2,
• %json_cardlogs% – Tabela logów,
• %json_card% – Ostatni stan przyłożonej karty,
• %enter_state% (RFID RCP2)
• %enter_inout% – Przycisk funkcyjny: wejście lub wyjście (RFID RCP2),
• %enter_privwork%– Przycisk funkcyjny: prywatne lub służbowe (RFID RCP2),
• %btn% – Ostatnio wciśnięty klawisz (tylko RFID RCP2 z klawiaturą):
  • cyfry 0 – 9 – Kolejne klawisze numeryczne,
  • C – Klawisz ESC,
  • U – Strzałka w górę,
  • D – Strzałka w dół,
  • L – Strzałka w lewo,
  • R – Strzałka w prawo,
  • X – Klawisz ENTER.

Card action

Sekcja Card Action pozwala na szczegółową konfigurację reakcji czytnika RFID na przyłożenie tagu RFID. Na tej stronie użytkownik może dostosować różne ustawienia, takie jak:

• Sterowanie wyjściami przekaźnikowymi,
• Konfiguracja żądań HTTP,
• Definiowanie treści wiadomości MQTT,
• Ustawienia logowania zdarzeń,
• Wyświetlanie komunikatów na wyświetlaczu i reakcje diody LED,
• Sterowanie sygnalizatorem dźwiękowym.

Action settings

Główna zakładka strony Card action, w której można zdefiniować reakcję czytnika na przyłożenie karty i skonfigurować podstawowe funkcje obsługi karty.

• Enable card log – Włączenie głównej funkcji logowania zdarzeń. Wybór, które zdarzenia mają być zapisywane w pamięci urządzenia, należy zdefiniować oddzielnie,
• Action hold time – Czas, po którym czytnik zacznie wykonywać ustawienia zdefiniowane dla zakładki Action hold card.

• Swap id – Pozwala zamienić kolejność bajtów w numerze UID tagu RFID,
• Remove card timeout – Czas po zabraniu karty z pola odczytu czytnika, po którym zostanie wywołana akcja Action remove card (0.1s),
• Lua script – Załączenie wywoływania skryptu Lua w odpowiedzi na każdą akcję (opcja),
• Lua Editor – Przycisk umożliwiający przejście do edytora skryptu Lua (opcja).
• Mifare Options – Przejście do dodatkowych ustawień odczytu kart Mifare (tylko w wersji Mif):
  • Read Mifare block – Załączenie funkcji czytania bloku,
  • Block – Adres czytanego bloku,
  • Auth key A/B – Wybór klucza autoryzacyjnego A lub B,
  • Key – Klucz uwierzytelnienia w formacie HEX - klucz zostaje zapisany w bezpiecznej pamięci (tylko do zapisu). Należy wpisywać tylko jeżeli jest wymagana zmiana. Klucz domyślny 6xff (FFFFFFFFFFFF),
  • Override UID – Nadpisanie identyfikatora karty przez odczytane dane,
  • Override UID offset – Znak, od którego rozpoczyna się odczyt danych.

Sekcja On new card action określa zachowanie czytnika w momencie wykrycia nowej karty RFID w zasięgu czytnika.

• Search card in database – Opcja pozwala wyłączyć porównywanie przyłożonego tagu i traktować wszystkie karty jako nieznane,
• HTTP Client Method, HTTP Content type oraz HTTP Client request – Patrz rozdział Konfiguracja HTTP Client oraz HTTP Client – żądanie zdarzenia card action,
• MQTT oraz MQTT payload – Patrz rozdział MQTT Client.

• Wait for server reply – Oczekiwanie na odpowiedź serwera:
  • No – Urządzenie sprawdza kartę i w zależności od wcześniejszego ustawienia Search card in database przechodzi do zakładki Action known card lub Action unknown card,
  • Yes – Tylko w przypadku korzystania z HTTP Client urządzenie oczekuje na dane z serwera do 3 sekund (później następuje timeout). Użytkownik może ustawić sygnalizację na czas oczekiwania na odpowiedź serwera np. napis na wyświetlaczu. Po włączeniu tej funkcji, pojawią się dodatkowe ustawienia. Serwer HTTP może w niektórych sytuacjach mieć opóźnienie w wysłaniu odpowiedzi do czytnika.

Sekcja Action on server requests pozwala zdefiniować zachowanie czytnika w momencie oczekiwania na odpowiedź z serwera oraz w momencie uzyskania odpowiedzi:

• Wait for server reply – Włącz opcję oczekiwania na odpowiedź serwera,
• Action by HTTP status code – Opcja automatycznej reakcji w zależności od kodu odpowiedzi HTTP:
  • kod 200: czytnik wykona ustawienia z zakładki Action known card,
  • pozostałe kody: czytnik wykona ustawienia z zakładki Action unknown card.
• HTTP Connection fail action – Czytnik czeka na odpowiedź serwera 3 sekundy:
  • Disable – W przypadku braku odpowiedzi serwera nie rób nic,
  • Enable – W przypadku braku odpowiedzi serwera, przejdź do zakładki Action known card lub Action unknown card w zależności od ustawienia Search card in database.
• LCD text – Wiadomość wyświetlana w momencie przyłożenia karty,
• Sound – Sygnał dźwiękowy:
  • None – Brak,
  • Accept – Sźwięk akceptacji tagu,
  • Reject – Sźwięk odrzucenia tagu,
  • Tick – Krótki sygnał dźwiękowy.
• Out 1/2 – wysterowanie wyjścia przekaźnikowego nr 1/2:
  • None – Pomiń,
  • Off – Wyłącz wyjście przekaźnikowe,
  • On – Włącz wyjście przekaźnikowe,
  • Toggle – Zmień stan wyjścia na przeciwny,
  • On Period – Włącz wyjście przekaźnikowe na czas Out Time zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • On User Period – Włącz wyjście przekaźnikowe na czas Out User Time 1.
• Out User Time 1/2 – Czas włączenia przekaźnika nr 1 dla trybu On User Period,
• LCD backlight – Podświetlenie wyświetlacza:
  • None – Pomiń,
  • Off – Wyłącz podświetlenie wyświetlacza,
  • On – Włącz podświetlenie wyświetlacza,
  • Toggle – Zmień stan podświetlenia na przeciwny,
  • On Period – Włącz podświetlenie na czas Lcd Backlight zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • Blink – Czasowe mruganie podświetleniem.
• LCD Text Timeout – Czas wyświetlania tekstu na wyświetlaczu:
  • 0 – Nie wyświetlaj tekstu,
  • -1 – Wyświetlaj tekst ciągle, do momentu kolejnego wywołania komunikatu,
  • inna wartość – Czas wyświetlania komunikatu na wyświetlaczu wyrażony w sekundach.
• Log event – Włączenie logowania zdarzenia w momencie przyłożenia tagu RFID dla trybu sterowania przez protokoły.

Action known card

Zakładka pozwala zdefiniować reakcje czytnika na przyłożenie karty zapisanej w pamięci urządzenia.

• LCD text – Wiadomość wyświetlana na wyświetlaczu w momencie rozpoznania karty RFID,
• Sound – Sygnał dźwiękowy:
  • None – Brak,
  • Accept – Sźwięk akceptacji tagu,
  • Reject – Sźwięk odrzucenia tagu,
  • Tick – Krótki sygnał dźwiękowy.
• Out 1/2 – wysterowanie wyjścia przekaźnikowego nr 1/2:
  • None – Pomiń,
  • Off – Wyłącz wyjście przekaźnikowe,
  • On – Włącz wyjście przekaźnikowe,
  • Toggle – Zmień stan wyjścia na przeciwny,
  • On Period – Włącz wyjście przekaźnikowe na czas Out Time zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • On User Period – Włącz wyjście przekaźnikowe na czas Out User Time 1.
• Out User Time 1/2 – Czas włączenia przekaźnika nr 1 dla trybu On User Period,
• LCD backlight – Podświetlenie wyświetlacza:
  • None – Pomiń,
  • Off – Wyłącz podświetlenie wyświetlacza,
  • On – Włącz podświetlenie wyświetlacza,
  • Toggle – Zmień stan podświetlenia na przeciwny,
  • On Period – Włącz podświetlenie na czas Lcd Backlight zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • Blink – Czasowe mruganie podświetleniem.
• LCD Text Timeout – Czas wyświetlania tekstu na wyświetlaczu:
  • 0 – Nie wyświetlaj tekstu,
  • -1 – Wyświetlaj tekst ciągle, do momentu kolejnego wywołania komunikatu,
  • inna wartość – Czas wyświetlania komunikatu na wyświetlaczu wyrażony w sekundach.
• Log event – Włączenie logowania zdarzenia w momencie rozpoznania tagu RFID.

Action unknown card

Zakładka pozwala zdefiniować reakcje czytnika na przyłożenie karty niezapisanej lub dezaktywowanej w pamięci urządzenia.

• LCD text – Wiadomość wyświetlana na wyświetlaczu w momencie rozpoznania karty RFID,
• Sound – Sygnał dźwiękowy:
  • None – Brak,
  • Accept – Sźwięk akceptacji tagu,
  • Reject – Sźwięk odrzucenia tagu,
  • Tick – Krótki sygnał dźwiękowy.
• Out 1/2 – wysterowanie wyjścia przekaźnikowego nr 1/2:
  • None – Pomiń,
  • Off – Wyłącz wyjście przekaźnikowe,
  • On – Włącz wyjście przekaźnikowe,
  • Toggle – Zmień stan wyjścia na przeciwny,
  • On Period – Włącz wyjście przekaźnikowe na czas Out Time zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • On User Period – Włącz wyjście przekaźnikowe na czas Out User Time 1.
• Out User Time 1/2 – Czas włączenia przekaźnika nr 1 dla trybu On User Period,
• LCD backlight – Podświetlenie wyświetlacza:
  • None – Pomiń,
  • Off – Wyłącz podświetlenie wyświetlacza,
  • On – Włącz podświetlenie wyświetlacza,
  • Toggle – Zmień stan podświetlenia na przeciwny,
  • On Period – Włącz podświetlenie na czas Lcd Backlight zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • Blink – Czasowe mruganie podświetleniem.
• LCD Text Timeout – Czas wyświetlania tekstu na wyświetlaczu:
  • 0 – Nie wyświetlaj tekstu,
  • -1 – Wyświetlaj tekst ciągle, do momentu kolejnego wywołania komunikatu,
  • inna wartość – Czas wyświetlania komunikatu na wyświetlaczu wyrażony w sekundach.
• Log event – Włączenie logowania zdarzenia w momencie rozpoznania tagu RFID.

Action hold card

Zakładka pozwala zdefiniować reakcje czytnika na przytrzymanie karty w polu zasięgu odczytu przez czas Action Hold time (domyślnie 5 sekund). Konfiguracja opcji Action Hold time jest dostępna w sekcji Main settings w zakładce Card Action / Action settings.

• LCD text – Wiadomość wyświetlana na wyświetlaczu w momencie rozpoznania karty RFID,
• Sound – Sygnał dźwiękowy:
  • None – Brak,
  • Accept – Sźwięk akceptacji tagu,
  • Reject – Sźwięk odrzucenia tagu,
  • Tick – Krótki sygnał dźwiękowy.
• Out 1/2 – wysterowanie wyjścia przekaźnikowego nr 1/2:
  • None – Pomiń,
  • Off – Wyłącz wyjście przekaźnikowe,
  • On – Włącz wyjście przekaźnikowe,
  • Toggle – Zmień stan wyjścia na przeciwny,
  • On Period – Włącz wyjście przekaźnikowe na czas Out Time zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • On User Period – Włącz wyjście przekaźnikowe na czas Out User Time 1.
• Out User Time 1/2 – Czas włączenia przekaźnika nr 1 dla trybu On User Period,
• LCD backlight – Podświetlenie wyświetlacza:
  • None – Pomiń,
  • Off – Wyłącz podświetlenie wyświetlacza,
  • On – Włącz podświetlenie wyświetlacza,
  • Toggle – Zmień stan podświetlenia na przeciwny,
  • On Period – Włącz podświetlenie na czas Lcd Backlight zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • Blink – Czasowe mruganie podświetleniem.
• LCD Text Timeout – Czas wyświetlania tekstu na wyświetlaczu:
  • 0 – Nie wyświetlaj tekstu,
  • -1 – Wyświetlaj tekst ciągle, do momentu kolejnego wywołania komunikatu,
  • inna wartość – Czas wyświetlania komunikatu na wyświetlaczu wyrażony w sekundach.
• HTTP Client Method, HTTP Content type oraz HTTP Client request – Patrz rozdział HTTP Client – żądanie zdarzenia card action,
• MQTT oraz MQTT payload – Patrz rozdział MQTT Client,
• Log event – Włączenie logowania zdarzenia w momencie przytrzymania tagu RFID w zasięgu czytnika.

Action remove card

Zakładka pozwala zdefiniować reakcje czytnika na usunięcie karty z pola zasięgu odczytu.

• LCD text – Wiadomość wyświetlana na wyświetlaczu w momencie rozpoznania karty RFID,
• Sound – Sygnał dźwiękowy:
  • None – Brak,
  • Accept – Sźwięk akceptacji tagu,
  • Reject – Sźwięk odrzucenia tagu,
  • Tick – Krótki sygnał dźwiękowy.
• Out 1/2 – wysterowanie wyjścia przekaźnikowego nr 1/2:
  • None – Pomiń,
  • Off – Wyłącz wyjście przekaźnikowe,
  • On – Włącz wyjście przekaźnikowe,
  • Toggle – Zmień stan wyjścia na przeciwny,
  • On Period – Włącz wyjście przekaźnikowe na czas Out Time zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • On User Period – Włącz wyjście przekaźnikowe na czas Out User Time 1.
• Out User Time 1/2 – Czas włączenia przekaźnika nr 1 dla trybu On User Period,
• LCD backlight – Podświetlenie wyświetlacza:
  • None – Pomiń,
  • Off – Wyłącz podświetlenie wyświetlacza,
  • On – Włącz podświetlenie wyświetlacza,
  • Toggle – Zmień stan podświetlenia na przeciwny,
  • On Period – Włącz podświetlenie na czas Lcd Backlight zdefiniowany w zakładce IO Settings,
  • On Long Period – Włącz wyjście przekaźnikowe na czas Out Time Long zdefiniowany w zakładce IO Settings,
  • Blink – Czasowe mruganie podświetleniem.
• LCD Text Timeout – Czas wyświetlania tekstu na wyświetlaczu:
  • 0 – Nie wyświetlaj tekstu,
  • -1 – Wyświetlaj tekst ciągle, do momentu kolejnego wywołania komunikatu,
  • inna wartość – Czas wyświetlania komunikatu na wyświetlaczu wyrażony w sekundach.
• HTTP Client Method, HTTP Content type oraz HTTP Client request – Patrz rozdział HTTP Client – żądanie zdarzenia card action,
• MQTT oraz MQTT payload – Patrz rozdział MQTT Client,
• Log event – Włączenie logowania zdarzenia w momencie usunięcia tagu RFID z zasięgu pola odczytu.

Zarządzanie kartami i zdarzeniami

Wewnętrzna baza kart

Czytnik RFID wyposażony jest w wbudowaną pamięć, która pozwala na zarządzanie kartami RFID. Użytkownik ma możliwość dodawania kart do pamięci czytnika zarówno ręcznie, jak i poprzez wgranie odpowiedniego pliku CSV. Reakcja urządzenia na przyłożenie tagu RFID może zależeć od tego, czy karta znajduje się w pamięci czytnika.

Zarządzanie tagami RFID z poziomu przeglądarki

Zakładka Card Database w interfejsie użytkownika umożliwia manualne dodawanie, edytowanie oraz usuwanie tagów RFID z pamięci urządzenia.

Dodanie nowego użytkownika wymaga uzupełnienia tabeli Add user card:

• Name 1 – Imię użytkownika,
• Name 2 – Nazwisko użytkownika,
• Card ID – Numer UID odczytanego tagu RFID,
• Get from last read – Funkcja pobiera ostatnio odczytany tag RFID,
• Active – Aktywacja tagu RFID w pamięci czytnika – wyłączenie tej opcji spowoduje pomijanie tagu w czasie przeszukiwania pamięci,
• Add Card – Dodanie rekordu do tymczasowej listy tagów RFID.

Baza tagów RFID z pliku CSV

Na dole strony Card Database znajdują się opcje umożliwiające pobranie aktualnej bazy kart oraz wgranie jej do pamięci czytnika.

Pobieranie i wgrywanie pliku CSV

• Link w sekcji Download Card CSV File umożliwia pobranie pliku CSV zawierającego wszystkie tagi RFID aktualnie zapisane w pamięci wewnętrznej czytnika,
• Aby wgrać bazę kart RFID do urządzenia, należy upewnić się, że struktura pliku CSV jest zgodna z wzorcem (CSV Example File).

uid;name;surname;userId;flag
23456678;Julia;Smith;1;1
12345678;Jack;Smith;2;1

Pierwszy wiersz zawiera nagłówek (ignorowany w czasie wgrywania pliku):

• uid – ID tagu RFID,
• name – Pole name z bazy kart,
• surname – Pole surname z bazy kart,
• userId – Unikalne ID użytkownika,
• flag – Wartość pola active z bazy kart.

Plik tagów RFID (cards.csv):

uid;name;surname;userId;flag
23456678;Julia;Smith;1;1
12345678;Jack;Smith;2;0
23456678;Andrew;Smith;3;1
22345678;Saul;Smith;4;0

Wewnętrzna baza kart RFID po wgraniu powyższego pliku CSV (cards.csv):

Baza tagów RFID w postaci plików JSON oraz XML

Wewnętrzna baza kart może być pobrana w postaci pliku JSON lub XML. Aby uzyskać dostęp do tych plików, należy odwołać się do poniższych zasobów:

• /card.json – W celu pobrania pliku kart w formacie JSON,
• /card.xml – W celu pobrania pliku kart w formacie XML.

{
    "card":[
    {"uid":"12345678",
    "name1":"John",
    "name2":"Smith",
    "userId":"1",
    "flag":"1"}
    ,
    {"uid":"87654321",
    "name1":"Saul",
    "name2":"Smith",
    "userId":"2",
    "flag":"1"}
    ,
    {"uid":"87878787",
    "name1":"Andrew",
    "name2":"Smith",
    "userId":"3",
    "flag":"1"}
    ]
}

<card>
    <entry>
    <uid>12345678</uid>
    <name1>John</name1>
    <name2>Smith</name2>
    <userId>1</userId>
    <flag>1</flag>
    </entry>
    <entry>
    <uid>87654321</uid>
    <name1>Saul</name1>
    <name2>Smith</name2>
    <userId>2</userId>
    <flag>1</flag>
    </entry>
    <entry>
    <uid>87878787</uid>
    <name1>Andrew</name1>
    <name2>Smith</name2>
    <userId>3</userId>
    <flag>1</flag>
    </entry>
</card>

• uid – ID tagu RFID,
• name1 – Pole name ze strony bazy kart,
• name2 – Pole surname ze strony bazy kart,
• userId – Unikalne ID użytkownika,
• flag – Wartość pola active ze strony bazy kart.

Logowanie zdarzeń

Urządzenie może rejestrować zdarzenia związane z przyłożeniem, przytrzymaniem lub usunięciem karty z zasięgu odczytu czytnika. Dziennik zdarzeń jest dostępny przez:

• stronę www,
• w formacie CSV,
• w formacie XML,
• w formacie JSON.

Włączenie obsługi logowania zdarzeń jest dostępne na stronie Card action, zakładka Action settings, tabela Main settings.

• Enable card log – Włącza główną funkcję logowania zdarzeń. Należy również określić, które zdarzenia mają być zapisywane w pamięci urządzenia,
• Action hold time – Czas, po którym czytnik zacznie wykonywać ustawienia zdefiniowane dla funkcji Action hold card.

Rodzaje logowanych zdarzeń

• Action Known Card – Zbliżenie karty RFID zapisanej w pamięci czytnika,
• Action Unknown Card – Zbliżenie karty RFID niezapisanej lub dezaktywowanej w pamięci czytnika,
• Action Hold Card – Przytrzymanie karty RFID w zasięgu czytnika na minimum Action Hold Time,
• Action Remove Card – Usunięcie karty RFID poza zasięg czytnika,
• HTTP/MQTT Communication – Korzystanie i sterowanie przez protokoły komunikacyjne (HTTP, MQTT), opcjonalnie po włączeniu opcji Wait for Server Reply.

Włączenie/wyłączenie logowania: Aby włączyć lub wyłączyć logowanie zdarzeń, należy przejść do odpowiedniej zakładki w Card Action i kliknąć przycisk Show More Options. Wiersz Log Event pozwala na włączenie lub wyłączenie logowania dla wybranego zdarzenia.

Podgląd zdarzeń przez stronę www

Dziennik zdarzeń jest dostępny na stronie Card logs. Logi dostępne przez stronę www mają następującą formę.

Wartość mode jest sumą wartości przypisanej do aktualnego stanu wyjścia / wejścia:

Usunięcie logów jest możliwe poprzez kliknięcie przycisku Remove logs lub komendę HTTP.

Podgląd zdarzeń przez plik CSV, XML lub JSON

Logi mogą zostać pobrane w postaci plików CSV, XML lub JSON, których struktura jest nieco bardziej rozbudowana w porównaniu do podglądu na stronie WWW.

Struktura logów dla pliku CSV – dostęp przez zasób http://<adres_ip>/log.csv:

timestamp;time;date;action;user_id;uid;name1;name2;enter
1744008560;08:49:20;07.04.2025;2;1;61F3911B;John;Smith;1030
1744008563;08:49:23;07.04.2025;2;2;717AA11B;Jan;Kowalski;1030
1744008569;08:49:29;07.04.2025;2;2;717AA11B;Jan;Kowalski;1030

Struktura logów dla pliku XML – dostęp przez zasób http://<adres_ip>/log.xml:

<logs>
        <entry>
        <action>2</action>
        <timestamp>1744008560</timestamp>
        <time>08:49:20</time>
        <date>2025-04-07</date>
        <userId>1</userId>
        <uid>61F3911B</uid>
        <name1>John</name1>
        <name2>Smith</name2>
        <mode>1030</mode>
    </entry>
    <entry>
        <action>2</action>
        <timestamp>1744008563</timestamp>
        <time>08:49:23</time>
        <date>2025-04-07</date>
        <userId>2</userId>
        <uid>717AA11B</uid>
        <name1>Jan</name1>
        <name2>Kowalski</name2>
        <mode>1030</mode>
    </entry>
    <entry>
        <action>2</action>
        <timestamp>1744008569</timestamp>
        <time>08:49:29</time>
        <date>2025-04-07</date>
        <userId>2</userId>
        <uid>717AA11B</uid>
        <name1>Jan</name1>
        <name2>Kowalski</name2>
        <mode>1030</mode>
    </entry>
</logs>

Struktura logów dla pliku JSON – dostęp przez zasób http://<adres_ip>/log.json:

{
  "logs": [
    {
      "action": 2,
      "mode": 1030,
      "ts": 1744008560,
      "time": "08:49:20",
      "date": "2025-04-07",
      "userId": 1,
      "uid": "61F3911B",
      "name1": "John",
      "name2": "Smith"
    },
    {
      "action": 2,
      "mode": 1030,
      "ts": 1744008563,
      "time": "08:49:23",
      "date": "2025-04-07",
      "userId": 2,
      "uid": "717AA11B",
      "name1": "Jan",
      "name2": "Kowalski"
    },
    {
      "action": 2,
      "mode": 1030,
      "ts": 1744008569,
      "time": "08:49:29",
      "date": "2025-04-07",
      "userId": 2,
      "uid": "717AA11B",
      "name1": "Jan",
      "name2": "Kowalski"
    }
  ]
}

Usunięcie logów jest możliwe poprzez kliknięcie przycisku Remove logs lub komendę HTTP.

Cykliczne przesyłanie logów kart

Istnieje możliwość włączenia cyklicznego przesyłu logów kart poprzez protokół HTTP(S). Po włączeniu tej opcji logi – o ile takie wystąpią - będą przesyłane w określonych odstępach czasu.
Należy skonfigurować ustawienia w zakładce Services / HTTP Client:

• Send card log by HTTP(S) – Włączanie / wyłączanie cyklicznego przesyłania rejestrów zdarzeń (logów) przez protokół HTTP(S) (szyfrowany), dane wysyłane w pakietach do 4 kB w jednym requeście,
• Send card log period – Częstotliwość wysyłania logów, wyrażony w minutach,
• Send card log request – Składnia żądania wysyłana przez urządzenie co czas określony w Send card log period. Musi zawierać zmienną %json_cardlogs% wywołującą tabelę zawierającą logi zdarzeń.

W przypadku braku dostępu do Internetu urządzenie w momencie odzyskania połączenia będzie wysyłać zapisane zdarzenia w pakietach do 4kb (około 26 zdarzeń).

Przykładowy pakiet danych:

{
device: 'RFID reader ABCD',
logs: [
{
action: '16',
mode: '0',
ts: '1682334001',
time: '13:00:01',
date: '2023-04-24',
userId: '6',
uid: 'AA81DD9B',
name1: 'Jack',
name2: 'Smith'
},
{
action: '2',
mode: '0',
ts: '1682333999',
time: '12:59:59',
date: '2023-04-24',
userId: '4',
uid: 'AB94DC5A',
name1: 'John',
name2: 'Smith'
}
]
}

Po każdym otrzymanym pakiecie logów serwer zwróci żądanie zdefiniowane przez użytkownika – przykładowa zwrotka poniżej:

{
"lcd_clr":0,
"lcd_text0":"Przesłano pakiet logów",
"cardlog_remove":12
}

W przypadku otrzymania powyższej zwrotki na wyświetlaczu czytnika pojawi się napis „Przesłano pakiet logów”. Komenda "cardlog_remove":12 spowoduje, że po każdym wysłaniu zdarzeń, 12 najstarszych logów zostanie skasowane z pamięci czytnika. W sytuacji, gdy po skasowaniu określonej w komendzie liczby logów w pamięci czytnika zostaną jeszcze jakieś dane zostaną one automatycznie przesłane w kolejnym pakiecie. Przesył danych będzie kontynuowany do momentu, gdy w pamięci czytnika nie będzie już żadnych logów, lub do momentu, gdy w zwrotce nie będzie komendy cardlog_remove (w takiej sytuacji czytnik będzie czekał z przesłaniem kolejnego pakietu logów przez czas określony w parametrze Send card log period).

Protokoły komunikacyjne

Urządzenie obsługuje różne protokoły komunikacyjne, które można dostosować do indywidualnych potrzeb. Konfiguracja ustawień jest dostępna na stronie Services.

HTTP/HTTPS Server

Czytnik można skonfigurować jako serwer HTTP lub HTTPS. W tym trybie zewnętrzny klient (np. komputer) łączy się z czytnikiem i zarządza nim za pomocą żądań HTTP/HTTPS (metodą GET).
Klient regularnie pobiera plik status.xml lub status.json, który zawiera informacje o stanie urządzenia, takie jak:

• UID karty,
• Adres MAC czytnika,
• Stan wejść i wyjść.

Po odczytaniu i zdekodowaniu tych danych, klient może przesłać do czytnika komendy, które wywołają odpowiednie reakcje, takie jak:

• Sygnalizacja dźwiękowa (np. akceptacja/odrzucenie karty),
• Miganie diod,
• Zwolnienie blokady drzwi,
• Wyświetlenie tekstu na ekranie.

Konfiguracja serwera HTTP dostępna jest na stronie Services.

• HTTP port – Ustawienie portu dla serwera HTTP oraz dostępu do strony www urządzenia,
• HTTPS port – Ustawienie portu dla serwera HTTPS i strony www (wymaga włączenia szyfrowania SSL/TLS),
• Block RFID read – Blokada kolejnego odczytu tagu RFID, aż do momentu zresetowania flagi odczytu. Używana przy cyklicznym odczytywaniu statusu urządzenia,
• SSL/TLS – Włączenie obsługi szyfrowanego połączenia HTTPS,
• Select key file (pem) – Wskazanie pliku klucza SSL (w formacie pem),
• Select Certificate file (pem) – Wskazanie pliku certyfikatu (w formacie pem).

HTTP GET – status

Aby uzyskać aktualny stan modułu, należy odwołać się do zasobu pod adresem adresIP/data/status.xml lub adresIP/data/status.json.

W odpowiedzi zostanie wyświetlony zasób w formacie XML lub JSON, który zawiera podstawowe informacje o czytniku, takie jak:

<status>
    <model>RFID IND2</model>
    <name>T</name>
    <mac>00:00:00:00:00:00</mac>
    <id>40005EB4F4</id>
    <newId>1</newId>
    <rfid_enable>1</rfid_enable>
    <cnt>1</cnt>
    <n_logs>1</n_logs>
    <in1>0</in1>
    <in2>0</in2>
    <cnt1>0</cnt1>
    <cnt2>0</cnt2>
    <out1>0</out1>
    <out2>0</out2>
    <time>09:40:23</time>
    <date>06-07-2022</date>
</status>

{
    "model": "RFID IND2",
    "name": "T",
    "mac": "00:00:00:00:00:00",
    "id": "40005EB4F4",
    "newId": "40005EB4F4",
    "rfid_enable": 1,
    "cnt": 1,
    "n_logs": 1,
    "in1": 0,
    "in2": 0,
    "cnt1": 0,
    "cnt2": 0,
    "out1": 0,
    "out2": 0,
    "time": "09:55:33",
    "date": "06-07-2022"
}

HTTP GET – sterowanie

Sterowanie modułem w trybie HTTP server polega na wysłaniu do modułu odpowiedniej komendy HTTP GET.

Zasób http://IPaddress/stat.php

HTTP GET – Obsługa bazy kart RFID

Korzystając z komend HTTP można edytować, dodawać lub usuwać karty RFID.

Zasób: http://IPaddress/card.cmd?

HTTP Client

W trybie HTTP Client czytnik działa podobnie do przeglądarki internetowej. Oznacza to, że inicjuje połączenie z serwerem, wysyłając żądania i oczekując odpowiedzi.

Główne cechy trybu:

• Automatyczne wysyłanie danych: Po odczytaniu tagu RFID moduł automatycznie łączy się z serwerem i przesyła informacje o odczytanym tagu,
• Odbieranie komend z serwera: Serwer może przesyłać polecenia sterujące modułem, takie jak włączanie diod LED, generowanie sygnałów dźwiękowych czy wyświetlanie tekstu na ekranie LCD,
• Łatwa integracja: Tryb umożliwia prostą integrację z różnymi technologiami serwerowymi, takimi jak PHP, Node.js czy MySQL.

Zalety:

• Natychmiastowa komunikacja: Moduł automatycznie inicjuje połączenie po odczytaniu karty, umożliwiając szybkie przesyłanie danych do serwera,
• Elastyczne sterowanie: Serwer może sterować różnymi elementami modułu w odpowiedzi na przesłane komendy.

Konfiguracja HTTP Client

Konfiguracja trybu HTTP Client jest dostępna na stronie Services w zakładce HTTP Client.

• Enable – Włączenie usługi HTTP Client,
• Server – Adres IP serwera,
• HTTP port – Port, na którym serwer nasłuchuje (domyślnie 80 dla HTTP lub 443 dla HTTPS),
• HTTP Method – Metoda HTTP używana do komunikacji: GET, POST, PUT, DELETE,
• Content type – Nagłówek określający typ przesyłanych danych (np. text/plain, json, xml, form),
• Resource – Ścieżka do zasobu na serwerze, z którym komunikuje się moduł,
• User – Nazwa użytkownika (w przypadku uwierzytelniania serwera),
• Password – Hasło użytkownika (w przypadku uwierzytelniania serwera),
• HTTP ping server – Częstotliwość odpytywania serwera (poll time),
• HTTP ping request – Składnia żądania odpytywania serwera (poll request).

• Send card log by HTTP(S) – Włączanie / wyłączanie cyklicznego przesyłania rejestrów zdarzeń (logów) przez protokół HTTP(S) (szyfrowany), dane wysyłane w pakietach do 4 kB w jednym requeście,
• Send card log period – Częstotliwość wysyłania logów, wyrażony w minutach,
• Send card log request – Składnia żądania wysyłana przez urządzenie co czas określony w Send card log period. Musi zawierać zmienną %json_cardlogs% wywołującą tabelę zawierającą logi zdarzeń (patrz rozdział Zmienne predefiniowane).

Aby zapewnić bezpieczeństwo komunikacji, urządzenie wspiera szyfrowanie połączeń.

• SSL/TLS – Włączenie szyfrowania,
• SSL root certificate – Włączenie używania certyfikatu CA ROOT,
• Skip cert CN check – Pominięcie sprawdzania certyfikatu CN,
• Use Client certificate – Certyfikat klienta,
• Client key password – Hasło klienta.

W sekcji SSL Client Certificate można przesłać wszystkie niezbędne pliki certyfikatów wymagane do ustanowienia szyfrowanego połączenia.

HTTP Client – poll request

Czytnik może okresowo wysyłać do serwera żądania typu poll w celu sprawdzenia statusu lub utrzymania połączenia. Treść takiego żądania definiuje się w polu HTTP Ping Request na stronie Services / HTTP Client.
Żądanie może zawierać zarówno statyczny tekst, jak i zmienne predefiniowane, co pozwala na dynamiczne dostosowanie jego treści.

Przykład: Wysyłanie żądania "poll" do zasobu /resource co 6 sekund:

• GET request z wykorzystaniem zmiennych predefiniowanych

ip=%eip%&name=%mod_name%&in1=%in1%

Dane odebrane po stronie serwera:

GET /resource?ip=192.168.0.176&name=T&in1=1 HTTP/1.1
User-Agent: Ind2
Host: 192.168.0.90
Content-Length: 0

Serwer może odesłać dane w postaci pliku JSON (XML):

HTTP/1.1 200 OK
Content-Length: 33
Content-Type: application/json
{"lcd_text1":" Place an RFID tag"}

• POST request z wykorzystaniem zmiennych predefiniowanych:

ip=%eip%
name=%mod_name%
in1=%in1%

Dane odebrane po stronie serwera:

OST / HTTP/1.1
User-Agent: Ind2
Host: 192.168.0.90
Content-Type: application/x-www-form-urlencoded
Content-Length: 33
ip=192.168.0.176
name=T
in1=0

Serwer może odesłać dane w postaci pliku JSON (XML):

HTTP/1.1 200 OK
Content-Length: 14
Content-Type: application/xml
<buzz>3</buzz>

HTTP Client – Żądanie zdarzenia card action

Przyłożenie tagu RFID do czytnika może wywołać wysłanie żądania HTTP na skonfigurowany serwer.

Strona Card Actions umożliwia konfigurację trzech wyzwalaczy wysyłania żądań HTTP:

• On-new – Wysyłanie żądania po każdorazowym przyłożeniu karty RFID do czytnika,
• On-hold – Wysyłanie żądania, jeśli karta znajduje się w polu czytnika przez co najmniej 5 sekund (domyślnie czas oczekiwania hold time wynosi 5 sekund),
• On-remove – Wysyłanie żądania w momencie oddalenia tagu RFID od czytnika.

Użytkownik konfiguruje treść żądania, jego typ oraz metodę dla każdego wyzwalacza oddzielnie.

Parametry konfiguracji żądań HTTP:

• HTTP Client method – Metoda HTTP:
  • Disable – Wyłączenie wysyłania zdarzenia na serwer HTTP,
  • Default – Używanie metody domyślnej zdefiniowanej na stronie Services,
  • GET,
  • POST,
  • PUT,
  • DELETE.
• HTTP Content type – Typ nagłówka content-type:
  • Default – Nagłówek domyślny zdefiniowany na stronie Services,
  • plain/text,
  • json,
  • xml.
• HTTP Client request – Żądanie HTTP.

Przykład 1:

Dla danych z zrzutu ekranu i wyzwalacza On new card action:

HTTP Client request: mac=%emac%&ip=%eip%&id=%uid%

Po przyłożeniu karty dane odebrane po stronie serwera będą wyglądały następująco:

GET /?mac=00:00:00:00:00:00&ip=192.168.0.176&id=12005CB99F HTTP/1.1
User-Agent: Ind2
Host: 192.168.0.90
Content-Type: text/plain
Content-Length: 0

Serwer może odesłać dane w postaci pliku JSON (XML):

HTTP/1.1 200 OK
Content-Length: 41
Content-Type: application/json
{
"lcd_text1":" Welcome!",
"buzz":"3"
}

Przykład 2

Dla żądania w postaci: ip=%eip%&id=%uid%&czas=%time%&state=VARIABLE

Przy czym VARIABLE przyjmuje różne wartości w zależności od wybranego wyzwalacza (zakładki):

• On new card action → VARIABLE = put,
• Action hold card → VARIABLE = hold,
• Action remove card → VARIABLE = away.

Dla powyższego żądania HTTP, po przyłożeniu karty RFID do czytnika na 10 sekund, serwer odbierze następujące dane (pomijając nagłówki):

ip=192.168.0.176&id=12005EE365&czas=12:19:00&state=put  //On new card action
ip=192.168.0.176&id=12005EE365&czas=12:19:05&state=hold //Action hold card
ip=192.168.0.176&id=12005EE365&czas=12:19:11&state=away //Action remove card

Powyższa składnia żądania HTTP umożliwia jednoznaczne sterowanie czytnikiem.

W przypadku wykorzystywania czytnika z obudową slot na kartę, w momencie przyłożenia karty do czytnika (status put) użytkownik zostanie wyłącznie zarejestrowany w systemie. Status hold oznacza umieszczenie karty w slocie, skutkujące uzyskaniem autoryzacji do danego pomieszczenia / uruchomienia urządzenia, natomiast status remove oznacza zabranie karty ze slotu, co może spowodować np. anulowanie autoryzacji.

HTTP Client – sterowanie

Sterowanie modułem w trybie HTTP Client jest możliwe po włączeniu usługi HTTP Client w zakładce Services.

Przykład odpowiedzi nadpisania bazy użytkowników:

{
  userdb_ver: 'test',
  renewUser: [
    {
      uid: '12345678',
      name1: 'John',
      name2: 'Smith',
      userId: -1,
      flag: 1,
      parent: -1
    },
    {
      uid: 'ABCDEF01',
      name1: 'Jan',
      name2: 'Kowalski',
      userId: -1,
      flag: 1,
      parent: -1
    }
  ]
}

Przykład obsługi serwera php:

<?php
if( $_GET["id"] ) // receive id and MAC - $_GET["mac"]
{
$who=$_GET["id"];
// check id in DB and do some action
echo "<root>";
echo "<buzz>1</buzz>"; // sound signal
echo "<text>Card ID: $who</text>" // message ID on LCD
echo "<open1>1</open1>"; // door open
echo "</root>";
}
else // no id – poll request
{
echo "<text> Place an RFID tag</text>"; //standby text
}

MQTT Client

Urządzenie obsługuje protokół MQTT, który pozwala na wymianę danych w architekturze publikacji / subskrypcji. Ustawienia można skonfigurować w zakładce Services, w sekcji MQTT Client.

• Enable – Włączenie usługi MQTT,
• Server – Adres IP lub domena brokera MQTT,
• Port – Port, na którym nasłuchuje serwer MQTT (domyślnie: 1883),

• QoS – Poziom jakości usługi (Quality of Service), obsługiwany przez urządzenie:

  • QoS 0 – At most once (co najwyżej raz),
  • QoS 1 – At least once (co najmniej raz),
  • QoS 2 – Exactly once (dokładnie raz).

• Publish Topic – Topic (temat), na który urządzenie wysyła dane,

• Subscribe Topic – Topic (temat), z którego urządzenie odbiera dane,
• Client ID – Identyfikator klienta MQTT,
• User – Nazwa użytkownika (w przypadku wymaganej autoryzacji),
• Password – Hasło użytkownika (w przypadku wymaganej autoryzacji).

Urządzenie wspiera szyfrowany protokół MQTT. Dostępne ustawienia konfiguracyjne są analogiczne do tych dostępnych dla konfiguracji protokołu HTTP Client.

Publish topic

Po skonfigurowaniu protokołu MQTT należy określić wyzwalacze, które będą powodować wysyłanie danych na zdefiniowany temat (Publish Topic). Podobnie jak w przypadku protokołu HTTP Client, dostępne są trzy wyzwalacze:

• On new card action – Wysyłanie wiadomości MQTT po każdorazowym przyłożeniu karty RFID do czytnika,
• Action hold card – Wysyłanie wiadomości MQTT, jeśli karta pozostaje w polu czytnika przez co najmniej 5 sekund (domyślny czas hold time),
• Action remove card – Wysyłanie wiadomości MQTT w momencie oddalenia tagu RFID od czytnika.

Każdy z wyzwalaczy działa niezależnie, co pozwala na dostosowanie ich działania do własnych potrzeb. Użytkownik może wybrać, które zdarzenia mają wywoływać wysyłanie wiadomości MQTT.

Dla treści MQTT payload:

uid=%uid%&name1=%usr_name1%&name2=%usr_name2%

Dane widoczne po stronie serwera:

uid=87878A4C&name1=John&name2=Smith

Dane widoczne po stronie serwera dla wyłącznej opcji Search card in database:

uid=878A8A4C&name1=&name2=

Subscribe topic

Urządzenie może być sterowane za pomocą protokołu MQTT. Aby to umożliwić, należy skonfigurować temat subskrypcji (Subscribe Topic), z którego urządzenie będzie odbierać komendy sterujące. W tym celu należy wprowadzić odpowiednie ustawienia brokera MQTT na stronie Services / MQTT Client oraz zdefiniować Subscribe Topic.

Przykładowa konfiguracja:

Przykładowa wiadomość wysłana na temat reader/prod2/sec1/c:

lcd_text1= Place an RFID tag&buzz=3

Urządzenie wyświetli komunikat Place an RFID tag w drugiej linii ekranu LCD oraz wyemituje krótki sygnał dźwiękowy (beep). Możliwe jest użycie tego samego tematu dla publikacji i subskrypcji, co pozwala na natychmiastowe sterowanie urządzeniem w momencie wysłania danych na Publish Topic.

Takie rozwiązanie umożliwia sterowanie urządzeniem bezpośrednio po wyzwoleniu wysyłania danych na Publish Topic.

E-mail

Urządzenie obsługuje funkcję wysyłania szyfrowanych wiadomości e-mail, którą można skonfigurować w zakładce Services / E-mail Client.

• E-mail – Aktywacja usługi SMTP,
• Server – Adres serwera SMTP,
• Port – Port serwera SMTP, na którym odbierane są wiadomości,
• SSL/TLS – Konfiguracja szyfrowania:
  • Off – Brak szyfrowania, połączenie nieszyfrowane,
  • SSL/TLS – Szyfrowanie z użyciem SSL/TLS,
  • STARTTLS – Umożliwia użycie STARTTLS w trakcie połączenia.
• User – Nazwa użytkownika, używana do uwierzytelniania w serwerze SMTP,
• Password – Hasło użytkownika,
• From – Pole „Od” widoczne w nagłówku wiadomości e-mail,
• Recipients – Lista odbiorców wiadomości (adresy e-mail oddzielone przecinkami),
• Subject – Temat wiadomości e-mail, a także nazwa pliku załącznika (np. logów),
• Debug – Tryb debugowania pozwalający na diagnozowanie błędów konfiguracji SMTP,
• Sending logs periodically – Rozszerzenie pliku logów wysyłanego jako załącznik,
• Erase logs after send – Opcja usunięcia logów po ich pomyślnym wysłaniu,
• Time – Częstotliwość wysyłania logów w formacie CRON (sekundy, minuty, godziny, dzień miesiąca, miesiąc, dzień tygodnia) – dla składni z powyższego zrzutu ekranu: 0 0 0 ? * * → codziennie o północy.

Testowanie konfiguracji

Po wprowadzeniu ustawień użytkownik może przetestować konfigurację za pomocą przycisku Email test. Urządzenie spróbuje wysłać wiadomość testową, która powinna natychmiast dotrzeć do odbiorcy. W przypadku nieotrzymania wiadomości warto sprawdzić folder SPAM.

Rozwiązywanie problemów

Jeśli występują problemy z wysyłaniem wiadomości, można włączyć tryb Debug w celu diagnozowania błędów:

1. Otwórz stronę debugowania w nowej karcie przeglądarki, wpisując:
   http://<IP urządzenia>/protect/dmesg.html
   lub kliknij przycisk Open debugger here! na stronie konfiguracji,
2. Naciśnij przycisk Send a test e-mail,
3. Szczegóły dotyczące problemów z wysyłaniem wiadomości pojawią się w oknie debugera. Analiza tych informacji pozwoli na zidentyfikowanie i rozwiązanie problemu.

Modbus TCP/RTU

Urządzenie wspiera protokół Modbus TCP oraz RTU. Konfiguracja połączenia jest dostępna na stronie w zakładce Services / Modbus.

• Enable TCP – Aktywacja usługi Modbus TCP,
• TCP port – Port dla protokołu Modbus TCP (domyślnie 502),
• Enable RTU – Aktywacja usługi Modbus RTU,
• PDU – Adres Modbus urządzenia.
• RTU Baudrate – Szybkość transmisji danych. Dostępne wartości:
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
• RTU Parity – Ustawienie parzystości:
  • None
  • Odd
  • Even
• RTU Stop bit – Liczba bitów stopu:
  • 1
  • 2
• Card action – Reakcja czytnika po przyłożeniu karty:
  • Control by modbus – Sterowanie czytnikiem wyłącznie przez Modbus,
  • Reader card action – Reakcja zgodna z ustawieniami z zakładki Card Action.
• Log Card Action – Logowanie zdarzeń podczas poprawnego połączenia z masterem (tylko dla ustawienia Card Action → Reader card action):
  • As card action (if set) – Logowanie zgodne z ustawieniami Card Action,
  • Omit log action – Pominięcie ustawień logowania dla Card Action.
• Block RFID read – Blokowanie odczytu kolejnego tagu:
  • Block – Po odczytaniu tagu w rejestrze Holding Register 1 zapisywana jest wartość 1. Odczyt kolejnego transpondera możliwy po zresetowaniu flagi odczytu (zapis 0 do Holding Register 1),
  • Continuous – Automatyczne kasowanie flagi odczytu, umożliwiające natychmiastowy odczyt kolejnych tagów RFID.
• Safe mode – Reakcja czytnika w przypadku zerwania połączenia Modbus:
  • Disable,
  • No action – Brak reakcji czytnika na zbliżenie tagu,
  • Standalone (Reader Card Action) – Przejście do trybu autonomicznego.
• Safe Timeout – Czas, po którym czytnik przejdzie do trybu Safe mode.

Urządzenie obsługuje następujące funkcje Modbus:

• 0x01 Read Coils
• 0x03 Read Holding Register
• 0x05 Write Single Coil
• 0x06 Write Single Register
• 0x0F Write Multiple Coils
• 0x10 Write Multiple Registers

Adresacja Holding Registers

Logi

Wyświetlacz

Adresacja Single Coil

Ustawienia fabryczne, backup

Przywracanie ustawień fabrycznych

Aby przywrócić ustawienia fabryczne urządzenia należy:

• Włączyć urządzenie.
• Zewrzeć zworkę RESET na czas pomiędzy 10 a 15 sekund.
• W czasie trwania sygnału dźwiękowego należy zdjąć zworkę RESET.

Po wykonaniu powyższych czynności urządzenie ustawi następujące parametry:

• Adres IP: 192.168.111.15
• Maska IP: 255.255.255.0
• Użytkownik: admin
• Hasło: admin

Backup

Wszystkie dane konfiguracyjne mogą zostać zapisane do pliku. Użytkownik może utworzyć/wczytać plik backup’u na stronie Administration / Backup.

Utworzenie zapisu danych konfiguracyjnych wymaga hasła.

Awaryjne przywracanie firmware

W celu przywrócenia firmware po wystąpieniu awarii należy:

• Zewrzeć zworkę RESET.
• Zasilić urządzenie i podłączyć do sieci LAN.

Po wykonaniu powyższych czynności urządzenie ustawi następujące parametry:

• 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.

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

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.