Integracja rejestratorów parametrów powietrza HiOne z oprogramowaniem ADAPS ONLINE
Rejestratory parametrów powietrza HiOne wyposażone są w moduł Wi-Fi, umożliwiający bezprzewodową transmisję danych. Co ważne, nowe przetworniki są w pełni kompatybilne z innymi, dostępnymi systemami monitoringu APONE. Wychodząc na przeciw oczekiwaniom Klientów urządzenia te mogą pracować w kilku trybach, pełniąc różne role w systemach monitoringu parametrów powietrz. Więcej informacji na temat trybów pracy dostępnych w rejestratorach z rodziny HiOne – www.apautomatyka.pl/nowa-rodzina-rejestratorow-z-wi-fi-od-apone-seria-hione/.
W tym artykule szczegółowo zostanie opisany sposób transmisji danych pomiarowych w sieci Wi-Fi oraz możliwości ich wykorzystania w systemach monitoringu. Przesyłanie danych pomiarowych na serwer dostępne jest zarówno dla rejestratorów w wersji bateryjnej, jak i wersji zasilanej sieciowo (tryby pracy Praca w sieci + skrypt oraz Tylko skrypt). Na rysunku poniżej przedstawiono uproszczony schemat komunikacji rejestratora HiOne z serwerem.
Rys. 1. Komunikacja rejestratora HiOne z serwerem – schemat
Przygotowanie serwera do pracy
Serwer oraz rejestrator HiOne muszą być połączone do tej same sieci Wi-Fi. Do samej komunikacji HiOne – Serwer, nie jest wymagane, by ta sieć bezprzewodowa miała dostęp do Internetu. Serwer, którego rolę może pełnić nawet zwykły komputer PC, powinien posiadać możliwość wykonywania skryptów PHP.
Skrypt PHP ma za zadanie odebranie danych przesłanych z rejestratora HiOne za pomocą metody HTTP POST, zinterpretowanie, a następnie przekazanie ich do innego, istniejącego w zakładzie systemu, np. systemu BMS lub systemu HVAC (poprzez zapisanie danych do dedykowanej bazy danych MySQL lub plików tekstowych). Taka opcja sprawia, że rozwiązanie zyskuje prawie nieograniczone możliwości. Poniżej przedstawiono fragment kodu, który zbiera oraz interpretuje dane przesłane z rejestratora HiOne.
Więcej informacji na temat pakietu danych wysłanych z rejestratora HiOne przedstawiono z sekcji Wysyłanie danych.
Przygotowanie rejestratora do pracy
Oprócz standardowej konfiguracji rejestratora HiOne z poziomu oprogramowania APConfig PC [HiOne] dotyczącej konfiguracji sieci Wi-Fi, interwału pomiarów, trybu pracy czy nazewnictwa punktu pomiarowego, należy pamiętać o odpowiednim ustawieniu adresu serwera oraz lokalizacji skryptu na serwerze. Dodatkowo należy ustalić, czy dane mają być wysyłane w formie niezaszyfrowanej, zaszyfrowanej algorytmem AES256 lub zabezpieczone certyfikatem SSL.
Wysyłanie danych
Rejestrator HiOne wykonuje pomiar i formuje pakiet informacji, który zostanie wysłany metodą POST na serwer. Opcjonalnie, rejestrator HiOne umożliwia zabezpieczanie transmisji certyfikatem SSL, w takim przypadku należy wgrać odpowiedni certyfikat (CA Root) do pamięci rejestratora HiOne. Transmisja do i z serwera będzie wówczas w pełni szyfrowana. Przykładowa wiadomość POST:
http://192.168.10.2/add_data.php?post_version=1.0&dev_ip=192.168.10.101&sensor=SENS&sensorCNT=2&rssi=-43&systemtime=30&httpcompress=1&type=d&valueType=T,H&value=22.99,53.46&valueName=V_1,V_2
W tym przykładzie adres IP serwera to 192.168.10.2. Na serwerze znajduje się skrypt add_data.php, który interpretuje przesłane dane pomiarowe. Wysłana wiadomość POST zawiera wszelkie niezbędne informacje dotyczące aktualnego pomiaru – szczegółowy opis znajduje się w tabeli poniżej.
| Parametr | Opis | Uwagi |
| post_version | wersja skryptu | 1.0 – standard 1.0-AES – szyfrowanie AES26 |
| dev_ip | adres IP rejestratora HiOne | |
| sensor | kod urządzenia | |
| sensorCNT | liczba pomiarów | |
| rssi | jakość sygnału Wi-Fi | dla rejestratora HiOne |
| systemtime | interwał pomiarów | wartość w sekundach |
| httpcompress | kompresja danych | |
| type | rodzaj przesyłanych danych | d – dane aktualne |
| valueType | typ mierzonych wielkości | |
| value | wartości zmierzone | |
| valueName | kod wartości |
Tabela 1. Dane wychodzące w wiadomości POST z rejestratora HiOne
Istnieje również możliwość przesyłania na serwer ramki zaszyfrowanej algorytmem AES-256. Wówczas fragment wiadomość POST zawierający dane dot. pomiaru jest zaszyfrowany danym kluczem. Skrypt PHP na serwerze ma za zadanie rozszyfrować przesłaną wiadomość do standardowej postaci. Przykładowa wiadomość POST, w przypadku włączonej opcji szyfrowania AES256 wygląda następująco:
http://192.168.10.2/add_data.php?post_version=1.0-AES&encryptedData=[wiadomosc_szyfrowana_kluczem_aes256]
Prezentacja danych – ADAPS Online
ADAPS ONLINE umożliwia wizualizację danych pomiarowych (danych aktualnych, ale również archiwalnych (bez ograniczeń czasowych)), rejestrację danych pomiarowych (dane pomiarowe przechowywane w bazie danych), generowanie raportów (również raportów PDF; raporty mogą być generowane ręcznie, jak i automatycznie (wysyłane cyklicznie na wskazane adresy e-mail); raporty generowane są z dowolnego okresu czasu) oraz alarmowanie w przypadku zaistnienia sytuacji awaryjnych w systemie (np. związanych z przekroczeniem zadanych progów alarmowych).
Rys. 2. Okno Wskazania ADAPS ONLINE
ADAPS ONLINE wykorzystuje pliki tekstowe oraz wpisy do bazy danych generowane przez skrypt PHP znajdujący się na serwerze, z którym komunikują się rejestratory HiOne.
Więcej na temat ADAPS ONLINE – https://apautomatyka.pl/system-zdalnego-monitorowania-wilgotnosci-temperatury-co2-innych-parametrow-powietrza-z-powiadomieniami-adaps-online/
Prezentacja danych – system Klienta
W wolnym dostępie, do dyspozycji jest skrypt pobierający i interpretujące dane wysyłane z rejestratora HiOne, który może stanowić podstawę do rozbudowania o wymagane funkcjonalności – np. dodawanie pomiarów do wybranej bazy danych lub generowanie plików tekstowych o określonej strukturze. Jest to uniwersalne podejście znacznie ułatwiające integrację rejestratorów HiOne z istniejącymi już systemami.
