Novatek-Electro TR-100E Documentation

Novatek-Electro TR-100E Documentation

https://www.overvis.com/docs/pl/tr-100e/

2026-10-28

Table of Contents

1. 1. Novatek-Electro TR-100E
2. 2. Instrukcja obsługi TR-100E
3. 3. Załącznik A: Awaryjne odzyskiwanie oprogramowania
4. 4. Załącznik B: Konfiguracja VPN WireGuard
5. 5. HTTP API
6. 6. GET /api/version/
7. 7. GET /api/auth/status/
8. 8. GET /api/auth/salt/
9. 9. POST /api/auth/login/
10. 10. POST /api/auth/logout/
11. 11. GET /api/state/get/?device&network&relays&leds&protection&recorder&channels&log&ntp&httpd&modbus&wireguard
12. 12. GET /api/settings/get/?meta&general&dateTime&display&access&recorder&network&ntp&web&modbus&vpnWireguard&channels&protection
13. 13. POST /api/settings/set/
14. 14. GET /api/reference/sensor-types/
15. 15. GET /api/history/temperature/info/
16. 16. GET /api/history/temperature/samples/?page=1&pageSize=2&direct=desc
17. 17. GET /api/recorder/info/
18. 18. GET /api/recorder/records/?page=1&pageSize=2&direct=desc
19. 19. GET /api/recorder/export.csv/
20. 20. POST /api/recorder/clear/
21. 21. GET /api/log/info/
22. 22. GET /api/log/events/?page=1&pageSize=1&direct=desc
23. 23. GET /api/log/export.log/
24. 24. POST /api/log/acknowledge/
25. 25. POST /api/log/clear/
26. 26. Usługa kalibracji
27. 27. Weryfikacja własności w Overvis
28. 28. POST /api/service/firmware/apply/
29. 29. Sesja przesyłania oprogramowania układowego
30. 30. GET /api/service/identity/get/
31. 31. POST /api/service/identity/set/
32. 32. POST /api/service/reboot/
33. 33. POST /api/service/settings/reset/
34. 34. POST /api/service/time/set/
35. 35. POST /api/service/time/sync/
36. 36. GET /api/debug/adc/, POST /api/debug/adc/start/, POST /api/debug/adc/stop/
37. 37. POST /api/debug/display/start/ i POST /api/debug/display/stop/
38. 38. GET /api/debug/external-storage/dump/
39. 39. GET /api/debug/external-storage/
40. 40. GET /api/debug/heap/
41. 41. GET /api/debug/keyget/
42. 42. POST /api/debug/keypress/
43. 43. POST /api/debug/led/start/ i POST /api/debug/led/stop/
44. 44. GET /api/debug/lwip-stats/
45. 45. GET /api/debug/menu/
46. 46. GET /api/debug/network/
47. 47. POST /api/debug/relay/start/ and POST /api/debug/relay/stop/
48. 48. GET /api/debug/settings/
49. 49. GET /api/debug/system/
50. 50. GET /api/debug/tasks/

Novatek-Electro TR-100E Documentation

Novatek-Electro TR-100E TR-100E to cyfrowy przekaźnik temperatury do monitorowania maksymalnie czterech stref temperaturowych. Zapewnia ochronę przekaźnikową, rejestrację zdarzeń i temperatury, interfejs Web, Modbus TCP oraz bezpieczny dostęp zdalny przez VPN WireGuard. Dostępna pełna dokumentacja Wyświetl całą dokumentację na jednej stronie - do drukowania lub czytania offline. Dokumentacja Instrukcja obsługi - montaż, obsługa, ustawienia, interfejs Web i opis Modbus TCP Załącznik A: Awaryjne odzyskiwanie oprogramowania - procedura odzyskiwania przez bootloader Załącznik B: Konfiguracja VPN WireGuard - ręczna i wspomagana przez Overvis konfiguracja VPN Dokumentacja HTTP API - uwierzytelnianie, stan, ustawienia, historia, serwis i diagnostyczne punkty końcowe Zasoby Dokumentacja na jednej stronie

Novatek-Electro TR-100E Documentation

Instrukcja obsługi TR-100E NOVATEK-ELECTRO inteligentna elektronika przemysłowa CYFROWY PRZEKAŹNIK TEMPERATURY TR-100E INSTRUKCJA OBSŁUGI (PASZPORT) Instrukcja obsługi przeznaczona jest do zapoznania się z urządzeniem, zasadą działania, zasadami eksploatacji i konfiguracji przekaźnika temperatury TR-100E. Podczas eksploatacji i obsługi technicznej należy przestrzegać wymagań dokumentów normatywnych: „Przepisy techniczne eksploatacji instalacji elektrycznych odbiorców”; „Przepisy bezpieczeństwa przy eksploatacji instalacji elektrycznych odbiorców”, „Ochrona pracy przy eksploatacji instalacji elektrycznych”. Podłączenie i obsługa techniczna produktu powinny być wykonywane przez wykwalifikowanych specjalistów, którzy zapoznali się z niniejszą Instrukcją obsługi. Przy przestrzeganiu zasad eksploatacji produkt jest bezpieczny w użyciu. OSTROŻNIE NA ZACISKACH I WEWNĘTRZNYCH ELEMENTACH PRODUKTU WYSTĘPUJE NIEBEZPIECZNE DLA ŻYCIA NAPIĘCIE. W CELU ZAPEWNIENIA BEZPIECZNEJ EKSPLOATACJI PRODUKTU KATEGORYCZNIE ZABRANIA SIĘ: WYKONYWAĆ PRACE MONTAŻOWE I OBSŁUGĘ TECHNICZNĄ BEZ ODŁĄCZENIA PRODUKTU OD SIECI ZASILAJĄCEJ; SAMODZIELNIE OTWIERAĆ I NAPRAWIAĆ PRODUKT; EKSPLOATOWAĆ PRODUKT Z MECHANICZNYMI USZKODZENIAMI OBUDOWY. DOSTANIA SIĘ WODY NA WEWNĘTRZNE ELEMENTY PRODUKTU. UWAGA PRODUKT NIE JEST PRZEZNACZONY DO PRZEŁĄCZANIA OBCIĄŻENIA PODCZAS ZWARĆ. DLATEGO PRODUKT POWINIEN BYĆ EKSPLOATOWANY W SIECI ELEKTRYCZNEJ ZABEZPIECZONEJ WYŁĄCZNIKIEM AUTOMATYCZNYM Z PRĄDEM WYŁĄCZENIA NIE WIĘKSZYM NIŻ 10 A. ZABRANIA SIĘ PODŁĄCZAĆ DO PRODUKTU OBCIĄŻENIE O MOCY WIĘKSZEJ NIŻ 2,5 kW. TERMINY I SKRÓTY Terminy i skróty TR-100E – cyfrowy przekaźnik temperatury TR-100E; Wyświetlacz LCD – wyświetlacz ciekłokrystaliczny, na którym wyświetlany jest stan pracy TR-100E; Wskaźnik – element świetlny na panelu przednim, pokazujący stan kanału, przekaźnika lub połączenia sieciowego; Świeci – stan, w którym wskaźnik LED jest stale włączony; Miga – stan, w którym wskaźnik LED okresowo włącza się i wyłącza; Błyska – stan, w którym wskaźnik LED krótkotrwale włącza się raz na sekundę; Przekaźnik „Wentylacja” – przekaźnik przeznaczony do sterowania wentylacją transformatora; Przekaźnik „Alarm” – przekaźnik przeznaczony do sygnalizacji przekroczenia dopuszczalnych temperatur; Przekaźnik „Przegrzanie” – przekaźnik przeznaczony do awaryjnego wyłączenia przy krytycznym przegrzaniu; Przekaźnik „Awaria” – przekaźnik przeznaczony do sygnalizacji niesprawności TR-100E lub czujnika; Dziennik zdarzeń – chronologiczna lista zadziałań przekaźników, niesprawności, włączeń i restartów TR-100E; Rejestrator temperatury – funkcja okresowego zapisywania temperatury kanałów pomiarowych; Próg – zadana temperatura, przy osiągnięciu której rozpoczyna się odliczanie opóźnienia włączenia odpowiedniego przekaźnika; Nastawa – konfigurowalna wartość progu, histerezy lub opóźnienia; Histereza – różnica między temperaturą włączenia a temperaturą wyłączenia przekaźnika; Filtr cyfrowy – przetwarzanie pomiarów, zmniejszające wpływ krótkotrwałych wahań wskazań; Pamięć nieulotna – pamięć zachowująca ustawienia i zapisy po odłączeniu zasilania; CH1–CH4 – kanały pomiarowe 1–4; TRIP, ALARM, FAN, FAULT – oznaczenia funkcji „Przegrzanie”, „Alarm”, „Wentylacja” i „Awaria” odpowiednio; AC, DC – prąd zmienny i stały odpowiednio; SPDT – styk przełączny przekaźnika; CSV – tekstowy format danych tabelarycznych; SCADA – system zbierania danych i zarządzania dyspozytorskiego; Modbus TCP – protokół wymiany danych przez sieć Ethernet; Web API – interfejs programowy do dostępu do funkcji TR-100E przez sieć Ethernet; DHCP – protokół automatycznego uzyskiwania ustawień sieciowych; DNS – usługa przekształcania nazw domenowych na adresy IP; NTP – protokół synchronizacji czasu przez sieć; RTC – zegar czasu rzeczywistego; UTC – uniwersalny czas koordynowany; DST – sezonowa zmiana czasu; VPN – zabezpieczone połączenie sieciowe; WireGuard – protokół używany przez TR-100E do tworzenia połączenia VPN; CIDR – zapis adresu IP i długości maski sieci przez ukośnik; Czas Unix – liczba sekund, które upłynęły od 00:00:00 1 stycznia 1970 roku wg UTC. Wartość nie zawiera strefy czasowej; do wyświetlania czasu lokalnego TR-100E osobno stosuje skonfigurowane przesunięcie względem UTC i zasady DST; $W_{100}$ – stosunek rezystancji czujnika temperatury przy 100 °C do jego rezystancji przy 0 °C; $R_{25}$, $R_{100}$ – rezystancja czujnika temperatury przy 25 °C i 100 °C odpowiednio; PTC – dodatni współczynnik temperaturowy rezystancji; NTC – nominalna temperatura zadziałania czujnika PTC Minika; Oprogramowanie wewnętrzne – oprogramowanie sterujące pracą TR-100E, które może być aktualizowane w celu poprawy funkcjonalności lub naprawy błędów; SPIS TREŚCI CYFROWY PRZEKAŹNIK TEMPERATURY TR-100E INSTRUKCJA OBSŁUGI (PASZPORT) TERMINY I SKRÓTY SPIS TREŚCI 1 PRZEZNACZENIE I CHARAKTERYSTYKI TECHNICZNE 1.1 Przeznaczenie produktu 1.2 Charakterystyki techniczne 1.3 Warunki eksploatacji 1.4 Wygląd zewnętrzny i wymiary gabarytowe 1.5 Czujniki temperatury 2 UŻYTKOWANIE ZGODNE Z PRZEZNACZENIEM 2.1 Przygotowanie TR-100E do użytkowania 2.1.1 Środki bezpieczeństwa 2.2 Użytkowanie TR-100E 2.2.1 Zasada działania 2.2.2 Dziennik zdarzeń 2.2.3 Rejestrator temperatury 2.2.4 Sterowanie TR-100E 2.2.5 Zmiana parametrów (menu ustawień) 2.2.6 Przywracanie ustawień fabrycznych 2.2.7 Testowanie TR-100E 2.2.7.1 Sprawdzenie wskaźników LED i przeglądanie minimalnej i maksymalnej temperatury kanałów 2.2.7.2 Testowanie przekaźników wyjściowych 2.2.8 Aktualizacja wbudowanego oprogramowania (oprogramowania wewnętrznego) 2.2.9 Ustawianie daty, czasu i strefy czasowej 2.3 Programowalne i używane parametry TR-100E 2.4 Korzystanie z interfejsu Web 2.4.1 Logowanie i poziomy dostępu 2.4.2 Zakładka „Monitorowanie” 2.4.3 Zakładka „Rejestrator” 2.4.4 Zakładka „Dziennik” 2.4.5 Zakładka „Ustawienia” 2.4.6 Zakładka „Serwis” 2.5 Korzystanie z VPN WireGuard 2.5.1 Przeznaczenie VPN 2.5.2 Ręczna konfiguracja WireGuard 2.5.3 Automatyczna konfiguracja przez Overvis 2.5.4 Dostęp do interfejsu Web i Modbus TCP przez VPN 2.6 Korzystanie z Modbus TCP 2.7 Porty sieciowe 3 OBSŁUGA TECHNICZNA 3.1 Środki bezpieczeństwa 3.2 Okresowość obsługi technicznej 3.3 Porządek obsługi technicznej: 3.4 Diagnostyka i usuwanie niesprawności 4 OKRES UŻYTKOWANIA I GWARANCJA PRODUCENTA 4.1 Okres użytkowania produktu 4.2 Okres przechowywania 4.3 Okres gwarancyjny eksploatacji 4.4 Obsługa gwarancyjna 4.5 Obsługa pogwarancyjna 5 TRANSPORT I PRZECHOWYWANIE 1 PRZEZNACZENIE I CHARAKTERYSTYKI TECHNICZNE 1.1 Przeznaczenie produktu Cyfrowy przekaźnik temperatury TR-100E (dalej TR-100E) przeznaczony jest do pomiaru i kontroli temperatury obiektu za pomocą czterech czujników, podłączanych w układzie dwu- lub trzyprzewodowym. TR-100E wyświetla zmierzone wartości temperatury na wyświetlaczu, kontroluje linie czujników pod kątem zerwania i zwarcia, generuje sygnały sterujące „Przegrzanie”, „Alarm”, „Awaria”, „Wentylacja”, prowadzi dziennik zdarzeń (do 2048 wpisów) oraz rejestrację temperatury z zadanym interwałem (do 16384 wpisów), a także zapewnia interfejs webowy. W razie potrzeby TR-100E może być podłączony do systemu nadrzędnego (SCADA) za pomocą protokołu Modbus TCP lub Web API. TR-100E ma uniwersalne zasilanie: 24–250 V AC/DC. Może być stosowany do zabezpieczania: trójfazowych transformatorów suchych z dodatkową kontrolą temperatury rdzenia lub otoczenia; silników i generatorów. Główne możliwości: 4 strefy kontroli (3 — uzwojenia, 1 — rdzeń); 4 przekaźniki wyjściowe 8 A, 250 VAC (Przekaźnik „Przegrzanie”, Przekaźnik „Alarm”, Przekaźnik „Wentylacja” i Przekaźnik „Awaria”); Monochromatyczny wyświetlacz LCD 128×64 pikseli; wskaźniki LED stanu; przyciski sterujące na panelu przednim; Zegar czasu rzeczywistego (RTC) z zasilaniem awaryjnym na 7 dni; Dziennik zdarzeń na 2048 wpisów; Rejestrator temperatury na 16384 wpisy; port Ethernet 10/100 Mb/s; synchronizacja czasu przez NTP; wbudowany serwer webowy do zdalnego dostępu do danych i ustawień; Obsługa szerokiego zakresu czujników temperatury: Pt100/Pt1000, Ni100/Ni1000, Cu100, Ptc1000/EKS111, KTY83, KTY84, PTC minika. 1.2 Charakterystyki techniczne Podstawowe charakterystyki techniczne podano w tabeli 1. Tabela 1 – podstawowe charakterystyki techniczne Parametr Wartość Wejścia Liczba kanałów pomiarowych 4 Schemat podłączenia czujników 2- lub 3-przewodowy Zakres mierzonych temperatur, °C od minus 40 do +240 (zależy od typu czujnika) Okres pomiaru wszystkich kanałów, s nie więcej niż 0,5 Klasa dokładności 0,25 Rozdzielczość, °C 0,1 Prąd pomiarowy czujnika, mA 1,0 Kompensacja rezystancji przewodów Automatyczna w układzie 3-przewodowym (nie więcej niż 20 Ω na każdy przewód) Długość przewodów, m 2-przewodowy do 5 3-przewodowy do 10 Kontrola zerwania/zwarcia linii czujników Tak Typy obsługiwanych czujników: --- Pt100/Pt1000 (W₁₀₀=1,3850 / W₁₀₀=1,3910) od minus 40 do +240 °C Ni100/Ni1000 (W₁₀₀=1,6178) od minus 40 do +180 °C Cu100 (W₁₀₀=1,4274) od minus 40 do +200 °C Ptc1000/EKS111 (W₁₀₀=2,0805) od minus 40 do +100 °C KTY83 (R₂₅=1000 Ω), modele 110/120/150 od minus 40 do +175 °C KTY84 (R₁₀₀=1000 Ω), modele 130/150 od minus 40 do +200 °C PTC Minika (NTC=60…180 °C) od 60 do 180 °C Wyjścia Liczba przekaźników, szt. 4 Typ styków SPDT (styk przełączny) Maksymalny prąd przy 250 VAC, A 8 Maksymalny prąd przy 30 VDC, A 3 Maksymalne napięcie, V 440 AC Maksymalna moc łączeniowa, VA 2500 Trwałość przy 8 A 250 VAC, cykli nie mniej niż 100000 Trwałość przy 3 A 30 VDC, cykli nie mniej niż 100000 Kategoria wykorzystania wg IEC 60947-5-1 AC-15 Zasilanie Nominalne napięcie zasilania, V 24–250 AC/DC Zakres napięcia zasilania, V (DC) 20–100 Zakres napięcia zasilania, V (AC) 24–265 Częstotliwość prądu przemiennego (AC), Hz 47 - 63 Pobór mocy, VA nie więcej niż 10 Dziennik zdarzeń i rejestracja Pojemność dziennika zdarzeń, wpisów 2048 Pojemność rejestratora, wpisów 16384 Czas rejestracji, s 5–3600 Interfejsy komunikacyjne Ethernet 10/100 Mb/s, RJ-45, Modbus TCP, Web API Wskazanie i wejście/wyjście Wyświetlacz LCD 128×64 pikseli Wskazanie LED 9 wskaźników Przyciski sterujące 5 przycisków Funkcje dodatkowe Zegar czasu rzeczywistego (RTC) Tak, z zasilaniem awaryjnym na 7 dni Synchronizacja czasu przez NTP Tak Wbudowany serwer webowy Tak Ograniczenie dostępu do ustawień Tak, hasłem Test przekaźników wyjściowych Tak Test wskazania Tak Aktualizacja oprogramowania przez Ethernet Tak Charakterystyki ogólne Architektura mikrokontrolera 32-bitowa ARM Czas przechowywania danych, lat nie mniej niż 15 Stopień ochrony obudowa IP30, zaciski IP20 Klasa ochrony przed porażeniem prądem elektrycznym II Wykonanie klimatyczne UHL3.1 Masa, kg nie więcej niż 0,5 Wymiary gabarytowe (DxSxW), mm 157×86×58 Kategoria przepięcia II Nominalne napięcie izolacji, V 450 Nominalne impulsowe napięcie wytrzymywane, kV 2,5 Przekrój podłączanych przewodów, mm² od 0,5 do 2 Moment dokręcenia zacisków, N·m 0,4 Typ zacisków śrubowe, z zaciskiem sprężynowym Montaż na szynie DIN 35 mm Pozycja przy montażu dowolna 1.3 Warunki eksploatacji TR-100E przeznaczone jest do eksploatacji w następujących warunkach: Temperatura otoczenia: od minus 20 do +50 °C; Temperatura przechowywania: od minus 30 do +60 °C; Wilgotność względna powietrza (przy temperaturze +25 °C): 30 … 80%; Dopuszczalny stopień zanieczyszczenia: II; Ciśnienie atmosferyczne: od 84 do 106,7 kPa. UWAGA TR-100E nie jest przeznaczony do eksploatacji w warunkach: Znaczącej wibracji lub wstrząsów mechanicznych; Wysokiej wilgotności z kondensacją wilgoci; Środowiska agresywnego zawierającego w powietrzu kwasy, zasady, sole lub inne substancje korozyjne, a także silnych zanieczyszczeń (tłuszcz, olej, pył itp.); 1.4 Wygląd zewnętrzny i wymiary gabarytowe Na rysunku 1 pokazano wygląd zewnętrzny i wymiary gabarytowe TR-100E. Wskaźniki LED kanałów: „Kanał 1”, „Kanał 2”, „Kanał 3”, „Kanał 4” (CH1, CH2, CH3, CH4); Wskaźnik LED „Awaria” (FAULT); Wskaźnik LED „Alarm” (ALARM); Wskaźnik LED „Przegrzanie” (TRIP); Wskaźnik LED „Wentylacja” (FAN); Wskaźnik LED „Połączenie Ethernet” (LINK); Zaciski do podłączenia zasilania 24–250 V AC/DC; Wyświetlacz LCD 128×64 pikseli; Zaciski przekaźników wyjściowych: „Przegrzanie”, „Alarm”, „Wentylacja”, „Awaria” (TRIP, ALARM, FAN, FAULT); Przycisk „Do góry” (UP); Przycisk „W dół” (DOWN); Złącze do podłączenia Ethernet RJ-45; Przycisk „Wprowadzenie” (SET); Przycisk „Menu” (MENU); Przycisk „Test” (TEST); Zaciski do podłączenia czujników temperatury. Rysunek 1 – wygląd zewnętrzny i wymiary gabarytowe 1.5 Czujniki temperatury TR-100E obsługuje następujące typy czujników temperatury: Pt100/Pt1000, Ni100/Ni1000, Cu100, Ptc1000/EKS111, KTY83, KTY84 i PTC minika. Pt100 / Pt1000 — platynowe termometry rezystancyjne o rezystancji nominalnej 100 Ω i 1000 Ω przy 0 °C odpowiednio. Charakterystyka opisana jest współczynnikiem W₁₀₀=1,3850 (wg IEC 60751) lub W₁₀₀=1,3910. Zakres pomiaru: od minus 40 do +240 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. Ni100 / Ni1000 — niklowe termometry rezystancyjne o rezystancji nominalnej 100 Ω i 1000 Ω przy 0 °C (W₁₀₀=1,6178). Zakres pomiaru: od minus 40 do +180 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. Cu100 — miedziane termometry rezystancyjne o rezystancji nominalnej 100 Ω przy 0 °C (W₁₀₀=1,4274). Zakres pomiaru: od minus 40 do +200 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. Ptc1000 / EKS111 — platynowy termometr rezystancyjny o rezystancji nominalnej 1000 Ω przy 0 °C i podwyższonym współczynniku temperaturowym (W₁₀₀=2,0805). Zakres pomiaru: od minus 40 do +100 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. KTY83 — krzemowy termometr rezystancyjny o rezystancji nominalnej R₂₅=1000 Ω przy 25 °C, modele 110/120/150. Zakres pomiaru: od minus 40 do +175 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. KTY84 — krzemowy termometr rezystancyjny o rezystancji nominalnej R₁₀₀=1000 Ω przy 100 °C, modele 130/150. Zakres pomiaru: od minus 40 do +200 °C. Podłączane do kanałów 1–4 w układzie dwu- lub trzyprzewodowym. PTC minika — półprzewodnikowe pozystory, gwałtownie zwiększające swoją rezystancję elektryczną po osiągnięciu nominalnej temperatury zadziałania (NTC). Czujniki są produkowane z różnymi wartościami NTC w zakresie od 60 do 180 °C z krokiem 10 °C. Cechy stosowania czujników PTC minika Czujniki PTC minika nie są pomiarowe: TR-100E nie wyświetla wartości liczbowej temperatury, dopóki temperatura czujnika jest niższa od NTC — na wyświetlaczu pokazywany jest symbol „< NTC”. Po osiągnięciu NTC i wyżej na wyświetlacz wyświetlana jest wartość NTC czujnika. Czujniki PTC minika mogą być łączone szeregowo na jeden kanał (do 6 czujników), tworząc łańcuch zabezpieczający. Zadziałanie następuje po osiągnięciu NTC przez którykolwiek z czujników w łańcuchu. Podłączenie jest możliwe do kanałów 1–4 w układzie dwuprzewodowym. W parametrze Typ czujnika (tabela 3) dla odpowiedniego kanału należy wybrać typ PTC Minika, a w parametrze NTC PTC Minika ustawić NTC czujnika lub najmniejszą NTC przy szeregowym połączeniu czujników o różnych NTC. Progi przekaźników i udział kanałów w sterowaniu przekaźnikami konfiguruje się za pomocą odpowiednich parametrów z tabeli 3. TR-100E wykrywa tylko zwarcie linii pomiarowej. Przy zerwaniu czujnika lub łańcucha czujników przekaźnik „Awaria” (FAULT) nie zadziała — zamiast tego zadziała odpowiednia awaria temperaturowa (przekaźnik „Przegrzanie” (TRIP), „Alarm” (ALARM), „Wentylacja” (FAN)). Rezystancja na zimno jednego czujnika wynosi 20–250 Ω; przy połączeniu szeregowym kilku czujników sumaryczna rezystancja na zimno nie powinna przekraczać 1500 Ω. 2 UŻYTKOWANIE ZGODNE Z PRZEZNACZENIEM 2.1 Przygotowanie TR-100E do użytkowania 2.1.1 Środki bezpieczeństwa Środki bezpieczeństwa Wszystkie połączenia muszą być wykonywane przy odłączonym od zasilania TR-100E. Podczas przeprowadzania testów izolacji transformatorów na przebicie należy odłączyć wszystkie czujniki temperatury od TR-100E. 2.1.2 Podłączyć TR-100E zgodnie ze schematem połączeń na rysunku 2. UWAGA Wszystkie kable przenoszące sygnały pomiarowe od czujników temperatury muszą bezwzględnie spełniać następujące wymagania: wykonane z kabla ekranowanego typu skrętka (trójka) o przekroju nie mniejszym niż 0,5 mm²; ekrany kabli czujników muszą być podłączone do uziemienia; trwale przyłączone do zacisków przyrządu; trasa połączeń kablowych musi być oddzielona od kabli wysokiego napięcia oraz od kabli zasilających obciążenie indukcyjne; wszystkie kable muszą mieć jednakową długość. Uwaga Obudowa TR-100E ma klasę izolacji II, nie wymagającą podłączenia uziemienia. Rysunek 2 – schemat połączeń TR-100E 2.1.3 Włączyć zasilanie TR-100E i w razie potrzeby ustawić tryby pracy zgodnie z tabelą 3. 2.2 Użytkowanie TR-100E 2.2.1 Zasada działania TR-100E stale mierzy temperaturę w 4 strefach za pomocą podłączonych czujników (kanały 1–4). Kanały 1–3 przeznaczone są do kontroli temperatury uzwojeń transformatora, a kanał 4 — do kontroli temperatury rdzenia transformatora lub otoczenia. Rejestrowanie zdarzeń i rejestracja temperatury odbywają się w trybie tle, nie wpływając na podstawową pracę TR-100E. Zapisane dane są dostępne do przeglądania na wyświetlaczu i mogą być wyeksportowane do pliku przez interfejs Web. Po włączeniu zasilania TR-100E przeprowadza kontrolę integralności i uruchamia wbudowane oprogramowanie, a następnie przechodzi na ekran główny — podstawowy tryb wyświetlania informacji podczas normalnej pracy (rysunek 3). Rysunek 3 – ekran główny TR-100E Na ekranie głównym wyświetlane są: aktualny czas i data lub adres IP TR-100E w sieci Ethernet (naprzemiennie); wskaźnik pracy rejestratora temperatury (włączony / wyłączony); stan przekaźników: T (TRIP), A (ALARM), F (FAN) (włączony / wyłączony, priorytet wyświetlania T > A > F); wskaźnik niesprawności (FAULT); wskaźnik obecności nowych zdarzeń w dzienniku; aktualne wartości temperatury kanałów KAN-1, KAN-2, KAN-3, KAN-4; trend zmian temperatury kanałów (wzrost / spadek / bez zmian); Jeśli czujnik kanału jest niesprawny (przerwanie lub zwarcie), zamiast wartości temperatury wyświetlany jest symbol błędu: „OBR.” (przerwanie) lub „ZAMK.” (zwarcie). Jeśli kanał skonfigurowany jest na czujnik PTC minika i temperatura jeszcze nie osiągnęła NTC, wyświetlany jest symbol „< NTC”. Jeśli kanał jest wyłączony (parametr Kanał N → Włączenie = 0, gdzie N — numer kanału; tabela 3), jego pole na ekranie pozostaje puste. Oprócz ekranu głównego, dla każdego włączonego kanału dostępny jest ekran wykresu temperatury. Wykres pokazuje zmianę temperatury kanału w ciągu ostatnich 10 minut z okresem aktualizacji 5 s. Na ekranie wyświetlany jest numer kanału, skala temperatury oraz ostatnia zmierzona wartość. Skala wykresu dobierana jest automatycznie. Ta operacyjna historia tworzona jest po włączeniu TR-100E i nie zastępuje danych rejestratora temperatury. Do przeglądania wykresów krótko nacisnąć przycisk „W górę” (UP) do przejścia na następny ekran lub przycisk „W dół” (DOWN) do przejścia na poprzedni. Ekrany przełączają się cyklicznie; wykresy wyłączonych kanałów są pomijane. PRZEKAŹNIK WENTYLACJA Gdy temperatura jednego z czujników uczestniczących w sterowaniu wentylacją (parametr Wentylacja → Tryb, patrz tab. 3) przekroczy ustawiony próg włączenia wentylacji Wentylacja → Próg (patrz tab. 3), rozpoczyna się odliczanie czasu Wentylacja → Opóźnienie. Przy tym wskaźnik „Wentylacja” (FAN) zaczyna okresowo błyskać. Po upływie czasu opóźnienia Wentylacja → Opóźnienie (patrz tab. 3) włącza się przekaźnik „Wentylacja” (FAN), a wskaźnik „Wentylacja” (FAN) zaczyna nieprzerwanie świecić. Wyłączenie przekaźnika „Wentylacja” (FAN) nastąpi po obniżeniu temperatury wszystkich czujników uczestniczących w sterowaniu wentylacją poniżej wartości obliczonej jako różnica (Wentylacja → Próg) − (Wentylacja → Histereza) (patrz tab. 3). Wskaźnik „Wentylacja” (FAN) zgaśnie. PRZEKAŹNIK ALARM Gdy temperatura jednego z czujników przekroczy ustawiony próg włączenia alarmu Alarm → Próg (patrz tab. 3), rozpoczyna się odliczanie czasu Alarm → Opóźnienie. Przy tym wskaźnik „Alarm” (ALARM) zaczyna okresowo błyskać. Po upływie czasu opóźnienia Alarm → Opóźnienie (patrz tab. 3) włącza się przekaźnik „Alarm” (ALARM), a wskaźnik „Alarm” (ALARM) zaczyna nieprzerwanie świecić. Wyłączenie przekaźnika „Alarm” (ALARM) nastąpi po obniżeniu temperatury wszystkich czujników poniżej wartości obliczonej jako różnica (Alarm → Próg) − (Alarm → Histereza) (patrz tab. 3). Wskaźnik „Alarm” (ALARM) zgaśnie. PRZEKAŹNIK PRZEGRZANIE Gdy temperatura jednego z czujników przekroczy ustawiony próg włączenia przegrzania Przegrzanie → Próg (patrz tab. 3), rozpoczyna się odliczanie czasu Przegrzanie → Opóźnienie. Przy tym wskaźnik „Przegrzanie” (TRIP) zaczyna okresowo błyskać. Po upływie czasu opóźnienia Przegrzanie → Opóźnienie (patrz tab. 3) włącza się przekaźnik „Przegrzanie” (TRIP), a wskaźnik „Przegrzanie” (TRIP) zaczyna nieprzerwanie świecić. Wyłączenie przekaźnika „Przegrzanie” (TRIP) nastąpi po obniżeniu temperatury wszystkich czujników poniżej wartości obliczonej jako różnica (Przegrzanie → Próg) − (Przegrzanie → Histereza) (patrz tab. 3). Wskaźnik „Przegrzanie” (TRIP) zgaśnie. PRZEKAŹNIK AWARIA Przy błędach wewnętrznych TR-100E lub wykryciu niesprawności czujnika (przerwanie lub zwarcie) rozpoczyna się odliczanie czasu Awaria → Opóźnienie (patrz tab. 3). Po upływie opóźnienia zadziała przekaźnik „Awaria” (FAULT), a wskaźnik „Awaria” (FAULT) zaczyna migać. Na wyświetlaczu pokazywany jest stan niesprawnego kanału lub kod błędu. Wyłączenie przekaźnika „Awaria” (FAULT) nastąpi po usunięciu niesprawności. Przy tym wskaźnik „Awaria” (FAULT) gaśnie. Stany wszystkich wskaźników LED podano w tabeli 2. Tabela 2 – Stany wskaźników LED Wskaźnik Stan Znaczenie CH1 – CH4 Nie świeci Kanał sprawny Miga Niesprawność czujnika kanału (przerwanie lub zwarcie) FAULT Nie świeci Norma Miga Wykryta niesprawność czujnika lub błąd wewnętrzny TR-100E ALARM Nie świeci Temperatura wszystkich kanałów poniżej progu wyłączenia określonego parametrami Alarm → Próg CH1–CH4 i Alarm → Histereza CH1–CH4 Błyska Temperatura jednego z kanałów przekroczyła odpowiedni parametr Alarm → Próg CH1–CH4, trwa odliczanie Alarm → Opóźnienie Świeci Przekaźnik „Alarm” włączony TRIP Nie świeci Temperatura wszystkich kanałów poniżej progu wyłączenia określonego parametrami Przegrzanie → Próg CH1–CH4 i Przegrzanie → Histereza CH1–CH4 Błyska Temperatura jednego z kanałów przekroczyła odpowiedni parametr Przegrzanie → Próg CH1–CH4, trwa odliczanie Przegrzanie → Opóźnienie Świeci Przekaźnik „Przegrzanie” włączony FAN Nie świeci Przekaźnik „Wentylacja” wyłączony Błyska Temperatura jednego z wybranych kanałów przekroczyła odpowiedni parametr Wentylacja → Próg CH1–CH4, trwa odliczanie Wentylacja → Opóźnienie Świeci Przekaźnik „Wentylacja” włączony LINK Nie świeci Brak fizycznego połączenia z siecią Ethernet Świeci Połączenie z siecią Ethernet nawiązane Miga Transmisja danych przez sieć Ethernet 2.2.2 Dziennik zdarzeń W procesie pracy TR-100E automatycznie prowadzi dziennik zdarzeń w trybie tła — nie są wymagane żadne działania ze strony użytkownika. Do dziennika zapisywane są istotne zdarzenia i komunikaty diagnostyczne o pracy TR-100E. Poniżej przedstawiono główne rodzaje wpisów; ten wykaz nie jest wyczerpujący: zadziałanie i wyłączenie przekaźników TRIP, ALARM, FAN, FAULT; przy zadziałaniu TRIP, ALARM i FAN zapisywane są numer kanału i temperatura; przerwanie lub zwarcie linii pomiarowej, a także przywrócenie jej normalnego stanu; uruchomienie TR-100E, planowany restart i wykrycie poprzedniego restartu przez watchdog; wyniki sprawdzenia hasła przy dostępie do ustawień: pomyślne logowanie, wprowadzenie błędnego hasła i blokada dostępu; zapis ustawień oraz błędy podczas ich wczytywania lub zapisywania; błędy inicjalizacji i zapisu danych rejestratora temperatury; pomyślna synchronizacja czasu przez NTP oraz błędy usług sieciowych Web, Modbus TCP, NTP i VPN WireGuard; błędy pomiaru, a także informacje o awaryjnych awariach wbudowanego oprogramowania. Każdy wpis zawiera datę i czas zdarzenia, jego opis oraz dodatkowe informacje pozwalające ustalić przyczynę zadziałania zabezpieczenia lub niesprawności. Dziennik jest obliczony na 2048 wpisów. Po osiągnięciu limitu nowe zdarzenia nadal są zapisywane, wypierając najstarsze. Dane zachowywane są w pamięci nieulotnej i nie giną przy wyłączeniu zasilania. Praca z dziennikiem z panelu przedniego: znajdując się na ekranie głównym, nacisnąć i przytrzymać przycisk „Menu” (MENU) przez co najmniej 5 s. W razie potrzeby wprowadzić hasło zgodnie z p. 2.2.5. Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać pozycję Dziennik zdarzeń i nacisnąć przycisk „Wprowadź” (SET). Następnie wykonać wymagane działanie: przeglądanie dziennika: wybrać pozycję Przeglądanie listy i nacisnąć przycisk „Wprowadź” (SET). Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać wpis; do przeglądania szczegółowych informacji nacisnąć przycisk „Wprowadź” (SET). Do powrotu nacisnąć przycisk „Menu” (MENU); czyszczenie dziennika: wybrać pozycję Wyczyść i nacisnąć przycisk „Wprowadź” (SET). W oknie potwierdzenia przyciskiem „W górę” (UP) wybrać Tak i nacisnąć przycisk „Wprowadź” (SET). Przeglądanie i eksport przez interfejs Web: otworzyć interfejs Web TR-100E i przejść na zakładkę Dziennik. Do zapisu dziennika do pliku events.log nacisnąć przycisk Eksport LOG. 2.2.3 Rejestrator temperatury Rejestrator okresowo zapisuje wartości temperatury wszystkich czterech kanałów, co pozwala analizować reżim cieplny obiektu za okres, którego dane zachowane są w pamięci rejestratora. Domyślnie rejestrator jest włączony z okresem zapisu 600 sekund. Okres można zmienić w zakresie od 5 do 3600 sekund parametrem Rejestrator → Okres zapisu, a wyłączyć rejestrator — parametrem Rejestrator → Włączenie (tabela 3). Każdy wpis zawiera datę i czas pomiaru, temperaturę wszystkich czterech kanałów, a także aktualne flagi stanu każdego kanału (zadziałanie TRIP, ALARM, FAN, niesprawność czujnika). Rejestrator jest obliczony na 16384 wpisy. Po osiągnięciu limitu nowe dane nadal są zapisywane, wypierając najstarsze. Im mniejszy okres zapisu — tym szybciej wypełnia się bufor i mniejsza głębokość przechowywanej historii. Dane zachowywane są w pamięci nieulotnej i nie giną przy wyłączeniu zasilania. Przykład głębokości przechowywania Przy okresie zapisu 60 s bufor na 16384 wpisy mieści dane z około 11 dni. Przy okresie 300 s — z 57 dni. Przy okresie 600 s — z 114 dni. Praca z rejestratorem z panelu przedniego: znajdując się na ekranie głównym, nacisnąć i przytrzymać przycisk „Menu” (MENU) przez co najmniej 5 s. W razie potrzeby wprowadzić hasło zgodnie z p. 2.2.5. Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać pozycję Rejestrator i nacisnąć przycisk „Wprowadź” (SET). Następnie wykonać wymagane działanie: przeglądanie wpisów: wybrać pozycję Przeglądanie listy i nacisnąć przycisk „Wprowadź” (SET). Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać wpis; do przeglądania szczegółowych informacji nacisnąć przycisk „Wprowadź” (SET). Do powrotu nacisnąć przycisk „Menu” (MENU); czyszczenie wpisów: wybrać pozycję Wyczyść i nacisnąć przycisk „Wprowadź” (SET). W oknie potwierdzenia przyciskiem „W górę” (UP) wybrać Tak i nacisnąć przycisk „Wprowadź” (SET). Przeglądanie i eksport przez interfejs Web: otworzyć interfejs Web TR-100E i przejść na zakładkę Rejestrator. Do zapisu wpisów do pliku recorder.csv nacisnąć przycisk Eksport CSV. 2.2.4 Sterowanie TR-100E Sterowanie TR-100E odbywa się za pomocą przycisków znajdujących się na panelu przednim (rys. 1, poz. 10, 11, 13–15): przycisk „Test” (TEST) – do wejścia w tryb sprawdzania wskazań LED i przeglądania minimalnej i maksymalnej temperatury kanałów; przycisk „Menu” (MENU) – do wejścia w tryb przeglądania i zmiany parametrów oraz wyjścia z niego; przycisk „Wprowadź” (SET) – do wejścia w parametr, potwierdzenia zmiany parametru i przejścia z powrotem do menu; przyciski „W górę” (UP) i „W dół” (DOWN) – do przewijania parametrów i zmiany wartości parametru. 2.2.5 Zmiana parametrów (menu ustawień) Do wejścia w tryb zmiany parametrów, znajdując się na ekranie głównym, nacisnąć i przytrzymać przycisk „Menu” (MENU) przez co najmniej 5 s. Jeśli dostęp jest chroniony hasłem, wprowadzić hasło zgodnie z poniższą instrukcją. Przy prawidłowym wprowadzeniu na wyświetlaczu pokazywany jest komunikat Hasło przyjęte, po czym otwiera się menu parametrów. Przy nieprawidłowym wprowadzeniu wyświetlana jest liczba pozostałych prób. Po pięciu nieudanych próbach dostęp jest blokowany na 5 minut. Hasło fabryczne podane jest na naklejce z kodem QR. W menu Dostęp można zmieniać hasła oraz niezależnie włączać lub wyłączać ich sprawdzanie. Wyłączenie sprawdzania nie usuwa zapisanego hasła. Hasło dostępu lokalnego musi zawierać 4…23 znaki, a hasła Web i Modbus — 8…23 znaki. Bieżące hasła nie są wyświetlane: po wybraniu pozycji Zmień hasło wprowadzanie rozpoczyna się od pustego pola, a anulowanie zachowuje poprzednią wartość. Wprowadzanie hasła Hasło wprowadza się za pomocą klawiatury ekranowej. Dostępne są układy małych i wielkich liter łacińskich, cyfr oraz znaków ., -, _, :, /, @: Krótkie naciśnięcie UP/DOWN przesuwa zaznaczenie między klawiszami, a przytrzymanie UP/DOWN — między wierszami; Przycisk SET aktywuje zaznaczony klawisz: wprowadza znak, usuwa poprzedni znak, przełącza układ (abc, ABC, 123, #+=) albo zatwierdza wprowadzanie klawiszem OK; Anulowanie wprowadzania hasła – przycisk „Menu” (MENU); Podczas wprowadzania hasła logowania dostępny jest klawisz OK. Przy zmianie hasła w menu ustawień klawisz OK nie jest wyświetlany: pierwsze naciśnięcie MENU zamyka klawiaturę ekranową, a drugie wychodzi z edytora i proponuje zastosowanie zmian. Odrzucenie zmian zachowuje poprzednie hasło. Przy braku naciśnięć jakiegokolwiek przycisku w ciągu 60 s TR-100E przejdzie na ekran główny. Nawigacja po menu Przewijanie parametrów - przyciski „W górę” i „W dół” (UP/DOWN); Wejście w parametr – przycisk „Wprowadź” (SET); Zmiana parametru – przyciskami „W górę” i „W dół” (UP/DOWN); Zapis parametru i przejście z powrotem do menu – przycisk „Wprowadź” (SET); Przejście z powrotem do menu bez zapisu – przycisk „Menu” (MENU). Dla parametrów tekstowych, na przykład adresów serwerów NTP, przycisk SET otwiera klawiaturę ekranową. Klawiaturą steruje się tak samo jak podczas wprowadzania hasła; zestaw dostępnych znaków zależy od parametru. Przycisk MENU zamyka klawiaturę. Poza klawiaturą UP/DOWN przesuwa kursor w ciągu, a ponowne naciśnięcie MENU kończy edycję i proponuje zastosowanie zmian. Automatyczne wyjście z menu następuje przy braku naciśnięć jakiegokolwiek przycisku w ciągu 60 s. 2.2.6 Przywracanie ustawień fabrycznych Istnieją dwa sposoby wykonania przywrócenia ustawień fabrycznych: Sposób 1 - reset ustawień przez menu Wejść do menu parametrów zgodnie z p. 2.2.5 i wybrać System → Reset ustawień; W oknie potwierdzenia przyciskiem „W górę” (UP) wybrać Tak i nacisnąć przycisk „Wprowadź” (SET). Wartości fabryczne zostaną wczytane do roboczej kopii ustawień. Sposób 2 - uruchomienie z ustawieniami fabrycznymi przez włączenie zasilania Przy wyłączonym zasilaniu nacisnąć i przytrzymać jednocześnie przyciski „W górę” i „W dół” (UP/DOWN); Podać zasilanie na TR-100E i kontynuować przytrzymywanie przycisków do pojawienia się komunikatu o wczytaniu ustawień fabrycznych, następnie je zwolnić; Po pojawieniu się ekranu głównego wejść do menu parametrów: nacisnąć i przytrzymać przycisk „Menu” (MENU) przez co najmniej 5 s. Wprowadzenie hasła nie jest wymagane. Przy takim uruchomieniu do restartu lokalne menu i interfejs Web są dostępne bez hasła. Interfejs Web zapewnia poziom powerUser, w tym dostęp do ustawień, operacji serwisowych oraz czyszczenia dziennika i rejestratora. Po zapisaniu i restarcie do logowania używane są hasła fabryczne podane na naklejce z kodem QR. Do zakończenia przywracania ustawień fabrycznych którymkolwiek ze sposobów: Wybrać System → Zapisz ustawienia, w oknie potwierdzenia przyciskiem „W górę” (UP) wybrać Tak i nacisnąć przycisk „Wprowadź” (SET). Wybrać System → Restart, potwierdzić restart wyborem Tak i naciśnięciem przycisku „Wprowadź” (SET). Po zapisaniu hasła użytkownika zastępowane są hasłami fabrycznymi podanymi na naklejce z kodem QR. WAŻNE Zapis ustawień i restart są obowiązkowe dla obu sposobów. Jeśli nie zapisać ustawień fabrycznych, przy następnym uruchomieniu zostaną wczytane wcześniej zapisane ustawienia i hasła. 2.2.7 Testowanie TR-100E 2.2.7.1 Sprawdzenie wskaźników LED i przeglądanie minimalnej i maksymalnej temperatury kanałów Do sprawdzenia wskazań LED należy, znajdując się na ekranie głównym, nacisnąć przycisk „Test” (TEST). TR-100E przejdzie na osobny ekran testowania, włączy wszystkie wskaźniki LED i wyświetli dla każdego kanału minimalną i maksymalną zarejestrowaną temperaturę. Ważne Jeśli chociaż jeden ze wskaźników nie będzie funkcjonował, TR-100E uznawany jest za niesprawny i wymaga naprawy. Podczas testowania wskazań TR-100E kontynuuje swoje normalne funkcjonowanie. Do wyjścia z trybu testowania nacisnąć przycisk „Menu” (MENU). Przy braku naciśnięć przycisków w ciągu 60 s ekran testowy zamyka się automatycznie. Temperatura maksymalna Minimalna i maksymalna temperatura kanałów rejestrowane są od momentu ostatniego włączenia zasilania TR-100E lub od momentu ostatniego zerowania temperatury maksymalnej. 2.2.7.2 Testowanie przekaźników wyjściowych Uwaga Testowanie przekaźników jest operacją potencjalnie niebezpieczną. Przed jego wykonaniem należy odłączyć obciążenie lub upewnić się, że przełączanie przekaźników nie doprowadzi do niebezpiecznej sytuacji lub uszkodzenia sprzętu. Kolejność testowania: Wejść do menu parametrów zgodnie z p. 2.2.5 i wybrać System → Testowanie przekaźników. W oknie ostrzeżenia przyciskiem „W górę” (UP) wybrać Tak i nacisnąć przycisk „Wprowadź” (SET). Otworzy się ekran z listą przekaźników TRIP, ALARM, FAN i FAULT oraz ich aktualnym stanem testowym: Wł. lub Wył. Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać wymagany przekaźnik. Nacisnąć przycisk „Wprowadź” (SET). Wybrany przekaźnik przełączy się, a jego stan na ekranie zmieni się. Ponowne naciśnięcie przycisku „Wprowadź” (SET) przywróci przekaźnik do poprzedniego stanu. Powtórzyć sprawdzenie dla pozostałych przekaźników. Do zakończenia testowania nacisnąć przycisk „Menu” (MENU). Stany testowe wszystkich przekaźników zostaną wyłączone, po czym TR-100E powróci do menu parametrów. 2.2.8 Aktualizacja wbudowanego oprogramowania (oprogramowania wewnętrznego) TR-100E obsługuje dwa sposoby aktualizacji wbudowanego oprogramowania bez użycia programatora: standardowa aktualizacja przez interfejs Web TR-100E; awaryjna aktualizacja przez tryb odzyskiwania bootloadera (Recovery mode), jeśli standardowy interfejs Web jest niedostępny. Do aktualizacji używany jest plik oprogramowania wewnętrznego TR-100E w formacie .ota. Sposób 1 - standardowa aktualizacja przez interfejs Web Upewnić się, że TR-100E jest podłączony do sieci Ethernet i dostępny przez przeglądarkę. Zalogować się do interfejsu Web z poziomem dostępu powerUser i otworzyć zakładkę Serwis. W bloku Aktualizacja oprogramowania wewnętrznego nacisnąć przycisk Wczytaj plik i wybrać plik oprogramowania wewnętrznego w formacie .ota. Poczekać na zakończenie wczytywania i sprawdzenia pliku. Po pomyślnym sprawdzeniu wyświetlą się informacje o obrazie oprogramowania wewnętrznego oraz przyciski Zastosuj i Usuń. Przycisk Usuń usuwa wczytany obraz bez instalacji. Nacisnąć przycisk Zastosuj i potwierdzić aktualizację. TR-100E uruchomi się ponownie, bootloader zainstaluje oprogramowanie wewnętrzne, po czym urządzenie automatycznie się uruchomi. Sposób 2 - awaryjna aktualizacja przez bootloader Podłączyć TR-100E i komputer do sieci Ethernet. Wyłączyć zasilanie TR-100E, nacisnąć i przytrzymać przycisk „Menu” (MENU), następnie podać zasilanie. Po pojawieniu się menu bootloadera zwolnić przycisk. Przyciskami „W górę” / „W dół” (UP/DOWN) wybrać pozycję Recovery mode i nacisnąć przycisk „Wprowadź” (SET). Poczekać na pojawienie się na wyświetlaczu ekranu Recovery mode. W tym trybie TR-100E używa statycznego adresu IP 192.168.1.48 i maski sieci 255.255.255.0. Ustawić na komputerze statyczny adres IP z tej samej podsieci, na przykład 192.168.1.2 z maską 255.255.255.0, i otworzyć w przeglądarce adres http://192.168.1.48. Na stronie TR-100E Recovery wybrać plik oprogramowania wewnętrznego w formacie .ota i nacisnąć przycisk Send. Poczekać na zakończenie wczytywania i sprawdzenia pliku. Po pomyślnym sprawdzeniu wartość imageValid stanie się true i stanie się dostępny przycisk Firmware. Nacisnąć przycisk Firmware. TR-100E uruchomi się ponownie, zainstaluje oprogramowanie wewnętrzne i automatycznie się uruchomi. Szczegółową kolejność czynności, ponowną instalację wcześniej wczytanego obrazu oraz objaśnienia komunikatów bootloadera podano w „Załączniku A. Awaryjne odzyskiwanie oprogramowania wewnętrznego”. Uwaga Używajcie tylko przeznaczonego dla TR-100E pliku oprogramowania wewnętrznego w formacie .ota. Nie wyłączajcie zasilania TR-100E po uruchomieniu instalacji oprogramowania wewnętrznego. Przerwanie instalacji może doprowadzić do uszkodzenia wbudowanego oprogramowania. Podczas restartu i instalacji oprogramowania wewnętrznego TR-100E nie kontroluje temperatury i nie steruje przekaźnikami. Przed rozpoczęciem instalacji upewnijcie się, że nie doprowadzi to do niebezpiecznej sytuacji lub uszkodzenia sprzętu. Wersja oprogramowania wewnętrznego Aktualna wersja oprogramowania wewnętrznego wyświetlana jest na ekranie TR-100E przy włączeniu oraz w bloku Informacje o urządzeniu na zakładce Serwis interfejsu Web. 2.2.9 Ustawianie daty, czasu i strefy czasowej TR-100E używa zegara czasu rzeczywistego (RTC) do oznaczania czasu w dzienniku zdarzeń i rejestratorze. Datę i czas można ustawić ręcznie z panelu przedniego lub przez interfejs Web. Dostępna jest również automatyczna synchronizacja czasu przez NTP. Ustawianie daty i czasu z panelu przedniego: Wejść do menu parametrów zgodnie z p. 2.2.5 i wybrać Data i czas → Data. Przyciskami „W górę” / „W dół” (UP/DOWN) ustawić dzień. Przyciskiem „Wprowadź” (SET) kolejno przejść do miesiąca i roku oraz ustawić ich wartości. Po ustawieniu roku nacisnąć przycisk „Wprowadź” (SET) do zapisu daty w zegarze czasu rzeczywistego. Wybrać Data i czas → Czas. Przyciskami „W górę” / „W dół” (UP/DOWN) ustawić godziny. Przyciskiem „Wprowadź” (SET) kolejno przejść do minut i sekund oraz ustawić ich wartości. Po ustawieniu sekund nacisnąć przycisk „Wprowadź” (SET) do zapisu czasu w zegarze czasu rzeczywistego. Do anulowania wprowadzania bez zapisu nacisnąć przycisk „Menu” (MENU). Ustawianie daty i czasu przez interfejs Web: Zalogować się do interfejsu Web z poziomem dostępu powerUser i otworzyć Ustawienia → Data i czas. W bloku Ustawianie czasu podać lokalną datę i czas. Nacisnąć przycisk Ustaw ręcznie. Podana wartość zostanie zapisana w zegarze czasu rzeczywistego natychmiast; naciśnięcie przycisku Zapisz nie jest do tego wymagane. Strefa czasowa: W sekcji Ustawienia → Data i czas w polu Strefa czasowa wybrać wymagane przesunięcie względem UTC, na przykład UTC+02:00 lub UTC+03:00. Wybrana strefa czasowa stosowana jest przy wyświetlaniu czasu lokalnego. Do zapisu ustawienia nacisnąć przycisk Zapisz. Czas letni (DST): W polu Tryb DST dostępne są następujące wartości: Wył — sezonowa zmiana czasu wyłączona; Europe — przesunięcie o jedną godzinę wykonywane jest w ostatnią niedzielę marca, powrót do czasu standardowego — w ostatnią niedzielę października; USA — przesunięcie o jedną godzinę wykonywane jest w drugą niedzielę marca, powrót do czasu standardowego — w pierwszą niedzielę listopada; Ręcznie — użytkownik zadaje Przesunięcie DST, a także lokalną datę i czas początku i zakończenia jego działania. Po zmianie trybu DST i związanych z nim parametrów nacisnąć przycisk Zapisz. Uwaga Synchronizacja konfigurowana jest oddzielnie w sekcji Ustawienia → NTP. Jeśli NTP jest włączony, ręcznie ustawiony czas zostanie zastąpiony przy następnej pomyślnej synchronizacji. Rezerwa chodu RTC RTC zapewnia chód zegara przy braku głównego zasilania nie dłużej niż 7 dni. Po upływie tego czasu wskazania zegara mogą się wyzerować. Po długotrwałym odłączeniu zasilania należy sprawdzić i w razie potrzeby skorygować czas ręcznie lub upewnić się, że synchronizacja przez NTP została wykonana pomyślnie. 2.3 Programowalne i używane parametry TR-100E Pełny wykaz zapisywanych parametrów podano w tabeli 3. W kolumnie „Adres rejestru Holding” znak — oznacza, że parametr nie jest przesyłany przez Modbus TCP i jest konfigurowany przez menu, interfejs Web lub Web API. Tabela 3 – Programowalne i używane parametry Adres rejestru Holding Parametr Zakres / wartości Ustawienie fabryczne Dostęp Modbus Typ — Ogólne — — — — 100 Język 0 angielski; 1 polski; 2 ukraiński; 3 rosyjski 0 (angielski) Z+O uint16 — Data i czas — — — — 101 Przesunięcie strefy czasowej, min -720…840 0 Z+O int16 102 Tryb DST 0 wyłączony; 1 UE; 2 USA; 3 ręczny 0 (wyłączony) Z+O uint8 103 Przesunięcie DST, min 0…180 60 Z+O int16 104–105 Początek DST, czas lokalny Czas Unix 1774749600 Z+O uint32 106–107 Koniec DST, czas lokalny Czas Unix 1792897200 Z+O uint32 — Wyświetlacz — — — — 108 Kontrast wyświetlacza 0…64 24 Z+O uint16 109 Podświetlenie aktywne, % 0…100 50 Z+O uint16 110 Podświetlenie wstrzymania, % 0…100 15 Z+O uint16 111 Limit czasu wstrzymania podświetlenia, s 30…3600 300 Z+O uint16 112 Włączenie podświetlenia wstrzymania 0…1 1 Z+O uint8 — Dostęp — — — — — Hasło urządzenia — — — — — Zabezpieczenia 0 wyłączona; 1 włączona 1 — uint8 — Zmień hasło 4…23 znaki Hasło z naklejki — ciąg — Hasło WEB użytk. — — — — — Zabezpieczenia 0 wyłączona; 1 włączona 1 — uint8 — Zmień hasło 8…23 znaki Hasło z naklejki — ciąg — Hasło WEB admina — — — — — Zabezpieczenia 0 wyłączona; 1 włączona 1 — uint8 — Zmień hasło 8…23 znaki Hasło z naklejki — ciąg — Hasło Modbus — — — — — Zabezpieczenia 0 wyłączona; 1 włączona 1 — uint8 — Zmień hasło 8…23 znaki Hasło z naklejki — ciąg — Rejestrator — — — — 113 Włączenie 0…1 1 Z+O uint8 114 Okres zapisu, s 5…3600 600 Z+O uint16 — TCP/IP — — — — — Włączenie Ethernet 0…1 1 — uint8 115 DHCP 0…1 1 Z+O uint8 116–117 DNS 1 IPv4 8.8.8.8 Z+O uint32 118–119 DNS 2 IPv4 4.4.4.4 Z+O uint32 120–121 Statyczny adres IP IPv4 192.168.0.100 Z+O uint32 122–123 Maska sieci IPv4 255.255.255.0 Z+O uint32 124–125 Brama IPv4 192.168.0.1 Z+O uint32 — Synchronizacja czasu (NTP) — — — — 126 Włączenie 0…1 0 Z+O uint8 127–128 Okres synchronizacji, s 300…86400 3600 Z+O uint32 129–144 Serwer 1 Nazwa DNS lub IPv4, do 31 znaków pool.ntp.org Z+O str16 145–160 Serwer 2 Nazwa DNS lub IPv4, do 31 znaków time.google.com Z+O str16 — VPN WireGuard — — — — — Włączenie 0…1 0 — uint8 — Autokonfiguracja przez Overvis 0…1 1 — uint8 — URL autokonfiguracji URL Puste — ciąg — Klucz prywatny 32 bajty Nie ustawiony — bajty — Adres IP IPv4 z długością prefiksu Nie ustawiony — IPv4/CIDR — Klucz publiczny węzła 32 bajty Nie ustawiony — bajty — Nazwa węzła Nazwa DNS lub IPv4 Puste — ciąg — Port węzła 1…65535 51820 — uint16 — Dozwolone sieci 1–2 IPv4 z długością prefiksu Nie ustawione — IPv4/CIDR × 2 — Okres utrzymania połączenia, s 1…300 25 — uint16 — Dostęp Web — — — — 161 Włączenie 0…1 1 Z+O uint8 162 Port 1…65535 80 Z+O uint16 163 Dostęp przez VPN 0…1 1 O uint8 164 Poziom dostępu przez VPN 0 gość; 1 zwykły; 2 rozszerzony 0 O uint8 — Modbus TCP — — — — 165 Włączenie 0…1 1 Z+O uint8 166 UID 0…247; 0 — dowolny UID 48 Z+O uint8 167 Port 1…65535 502 Z+O uint16 168 Limit czasu, s 0 wyłączony; 1…3600 0 Z+O uint16 169 Tryb ochrony 0 brak; 1 zapis; 2 odczyt i zapis 1 Z+O uint8 170 Dostęp przez VPN 0 zabroniony; 1 według ochrony ogólnej; 2 tylko odczyt; 3 odczyt i zapis 0 O uint8 — Kanał 1 — — — — 171 Włączenie 0…1 1 Z+O uint8 172 Typ czujnika 0…14, patrz uwaga do tabeli 3 0 Z+O uint16 173 Korekcja, °C -10…+10 0 Z+O int16 ×10 174 NTC PTC Minika, °C 60…180 160 Z+O int16 ×10 175 Powiązane nastawy 0…1 1 Z+O uint8 — Kanał 2 — — — — 176 Włączenie 0…1 1 Z+O uint8 177 Typ czujnika 0…14, patrz uwaga do tabeli 3 0 Z+O uint16 178 Korekcja, °C -10…+10 0 Z+O int16 ×10 179 NTC PTC Minika, °C 60…180 150 Z+O int16 ×10 180 Powiązane nastawy 0…1 1 Z+O uint8 — Kanał 3 — — — — 181 Włączenie 0…1 1 Z+O uint8 182 Typ czujnika 0…14, patrz uwaga do tabeli 3 0 Z+O uint16 183 Korekcja, °C -10…+10 0 Z+O int16 ×10 184 NTC PTC Minika, °C 60…180 60 Z+O int16 ×10 185 Powiązane nastawy 0…1 1 Z+O uint8 — Kanał 4 — — — — 186 Włączenie 0…1 1 Z+O uint8 187 Typ czujnika 0…14, patrz uwaga do tabeli 3 0 Z+O uint16 188 Korekcja, °C -10…+10 0 Z+O int16 ×10 189 NTC PTC Minika, °C 60…180 130 Z+O int16 ×10 190 Powiązane nastawy 0…1 0 Z+O uint8 — Filtr cyfrowy — — — — 191 Ogólny poziom filtra 1…10 4 Z+O uint8 — Przegrzanie (TRIP) — — — — 192 Próg CH1, °C -40…240 155 Z+O int16 ×10 193 Histereza CH1, °C 0…100 10 Z+O int16 ×10 194 Próg CH2, °C -40…240 155 Z+O int16 ×10 195 Histereza CH2, °C 0…100 10 Z+O int16 ×10 196 Próg CH3, °C -40…240 155 Z+O int16 ×10 197 Histereza CH3, °C 0…100 10 Z+O int16 ×10 198 Próg CH4, °C -40…240 155 Z+O int16 ×10 199 Histereza CH4, °C 0…100 10 Z+O int16 ×10 200 Opóźnienie, s 0…60 5 Z+O uint16 — Alarm (ALARM) — — — — 201 Próg CH1, °C -40…240 145 Z+O int16 ×10 202 Histereza CH1, °C 0…100 10 Z+O int16 ×10 203 Próg CH2, °C -40…240 145 Z+O int16 ×10 204 Histereza CH2, °C 0…100 10 Z+O int16 ×10 205 Próg CH3, °C -40…240 145 Z+O int16 ×10 206 Histereza CH3, °C 0…100 10 Z+O int16 ×10 207 Próg CH4, °C -40…240 145 Z+O int16 ×10 208 Histereza CH4, °C 0…100 10 Z+O int16 ×10 209 Opóźnienie, s 0…60 5 Z+O uint16 — Wentylacja (FAN) — — — — 210 Próg CH1, °C -40…240 130 Z+O int16 ×10 211 Histereza CH1, °C 0…100 20 Z+O int16 ×10 212 Próg CH2, °C -40…240 130 Z+O int16 ×10 213 Histereza CH2, °C 0…100 20 Z+O int16 ×10 214 Próg CH3, °C -40…240 130 Z+O int16 ×10 215 Histereza CH3, °C 0…100 20 Z+O int16 ×10 216 Próg CH4, °C -40…240 130 Z+O int16 ×10 217 Histereza CH4, °C 0…100 20 Z+O int16 ×10 218 Tryb 0 wył.; 1 CH1–3; 2 CH1–4; 3 CH4 0 Z+O uint16 219 Opóźnienie, s 0…60 5 Z+O uint16 — Awaria (FAULT) — — — — 220 Opóźnienie, s 0…60 5 Z+O uint16 Uwaga do tabeli 3 Oznaczenia w kolumnie „Dostęp Modbus”: O – odczyt; Z – zapis; Z+O – zapis i odczyt. Wartości parametru „Typ czujnika”: 0 – Pt100 ($W_{100}=1{,}3850$); 1 – Pt100 ($W_{100}=1{,}3910$); 2 – Pt1000 ($W_{100}=1{,}3850$); 3 – Pt1000 ($W_{100}=1{,}3910$); 4 – Ni100 ($W_{100}=1{,}6178$); 5 – Ni1000 ($W_{100}=1{,}6178$); 6 – Cu100 ($W_{100}=1{,}4274$); 7 – Ptc1000/EKS111 ($W_{100}=2{,}0805$); 8 – KTY83-110; 9 – KTY83-120; 10 – KTY83-150; 11 – KTY84-130; 12 – KTY84-150; 13 – PTC Minika K; 14 – PTC Minika KD. Parametr Powiązane nastawy określa udział kanału we wspólnej grupie ustawień: 1 — kanał jest powiązany, 0 — jest ustawiany niezależnie. Zmiana progu lub histerezy TRIP, ALARM albo FAN dowolnego powiązanego kanału automatycznie ustawia nową wartość we wszystkich powiązanych kanałach. Opóźnienia i pozostałe parametry kanałów nie są powiązane. Zmiana samego parametru Powiązane nastawy nie wyrównuje wcześniej ustawionych wartości; powiązanie zostanie zastosowane przy następnej zmianie progu lub histerezy. W ustawieniach fabrycznych powiązane są kanały CH1–CH3, a kanał CH4 jest ustawiany niezależnie. Hasło dostępu lokalnego i hasła Web/Modbus domyślnie są zgodne z hasłem fabrycznym wskazanym na naklejce z kodem QR. Można ustawić oddzielne hasła o długości 4…23 znaków dla dostępu lokalnego i 8…23 znaków dla Web/Modbus. Sprawdzanie każdego hasła włącza się oddzielnym parametrem ochrony. Wyłączenie ochrony zachowuje hasło, które zostanie ponownie użyte po jej włączeniu. 2.4 Korzystanie z interfejsu Web Dla dostępu do interfejsu Web TR-100E potrzebny jest komputer z zainstalowaną przeglądarką Web. W pasku adresu przeglądarki Web wprowadzić bieżący adres IP TR-100E wyświetlany na jego wyświetlaczu i nacisnąć Enter. 2.4.1 Logowanie i poziomy dostępu Po otwarciu interfejsu Web wyświetlany jest formularz wprowadzania hasła. TR-100E używa dwóch niezależnych haseł dostępu Web: hasło zwykłego użytkownika — poziom user; hasło rozszerzonego użytkownika — poziom powerUser. Wprowadzone hasło określa przyznany poziom dostępu. Użytkownikowi poziomu user dostępne są zakładki Monitorowanie, Rejestrator i Dziennik. Użytkownikowi poziomu powerUser dodatkowo dostępne są zakładki Ustawienia i Serwis, a także operacje czyszczenia dziennika i rejestratora. Sprawdzanie haseł Web user i powerUser włącza się niezależnie w sekcji Ustawienia → Bezpieczeństwo. Jeśli sprawdzanie powerUser jest wyłączone, interfejs Web udostępnia ten poziom bez hasła. W przeciwnym razie, gdy wyłączone jest sprawdzanie user, bez hasła udostępniany jest poziom user. 2.4.2 Zakładka „Monitorowanie” Zakładka wyświetla bieżący stan TR-100E: temperaturę i stan linii każdego kanału pomiarowego; progi zabezpieczeń i stan przekaźników TRIP, ALARM, FAN, FAULT; wykres historii temperatury z ostatnich 10 minut; bieżący czas, czas pracy, adres IP i stan Ethernet; ostatnie zdarzenia i liczbę nieprzeczytanych zdarzeń. Nieprzeczytane zdarzenia można oznaczyć jako przejrzane przyciskiem Potwierdź. 2.4.3 Zakładka „Rejestrator” Zakładka wyświetla liczbę zapisanych wpisów, okres zapisu, tabelę wpisów i wykresy temperatury kanałów. Dostępne są: ręczne i automatyczne odświeżanie; wybór kolejności wpisów i liczby wpisów na stronie; przechodzenie między stronami; eksport wszystkich wpisów do pliku recorder.csv. Czyszczenie rejestratora dostępne jest tylko dla użytkownika poziomu powerUser. 2.4.4 Zakładka „Dziennik” Zakładka wyświetla zdarzenia z datą, czasem, poziomem ważności i opisem. Dostępne są: ręczne i automatyczne odświeżanie; filtrowanie według poziomu ważności; wybór kolejności zdarzeń i liczby zdarzeń na stronie; przechodzenie między stronami; potwierdzenie przejrzenia nieprzeczytanych zdarzeń; eksport dziennika do pliku tekstowego. Czyszczenie dziennika dostępne jest tylko dla użytkownika poziomu powerUser. 2.4.5 Zakładka „Ustawienia” Zakładka dostępna jest tylko dla użytkownika poziomu powerUser. Ustawienia przedstawione są w rozwijanych sekcjach Kanały, Przegrzanie, Alarm, Wentylacja, Awaria, Sieć, WireGuard, Serwer Web, Modbus TCP, NTP, Data i czas, Rejestrator, Wyświetlacz, Język i Bezpieczeństwo. Jednocześnie można otworzyć kilka sekcji. Ustawienia każdej sekcji są ładowane i zapisywane oddzielnie. Przycisk Odśwież ponownie odczytuje ustawienia otwartej sekcji z TR-100E, przycisk Zapisz zapisuje zmiany. Jeśli dla zastosowania zapisanych ustawień wymagany jest restart, interfejs Web wyświetla odpowiednie ostrzeżenie; restart nie wykonuje się automatycznie. W sekcji Bezpieczeństwo zapisane hasła nie są wyświetlane. Aby pozostawić hasło bez zmian, nie należy wypełniać odpowiedniego pola; aby je zmienić, należy wprowadzić nową wartość. 2.4.6 Zakładka „Serwis” Zakładka dostępna jest tylko dla użytkownika poziomu powerUser i zawiera: informacje o urządzeniu, bootloaderze, oprogramowaniu wewnętrznym, adresie MAC i identyfikatorach; ładowanie, sprawdzanie i zastosowanie pliku aktualizacji oprogramowania wewnętrznego w formacie .ota; programowy restart TR-100E; przywracanie ustawień fabrycznych; wymuszoną synchronizację czasu przez NTP; informacje diagnostyczne urządzenia. 2.5 Korzystanie z VPN WireGuard 2.5.1 Przeznaczenie VPN TR-100E obsługuje połączenie VPN przy użyciu protokołu WireGuard. VPN tworzy zabezpieczony kanał sieciowy między TR-100E a zdalnym węzłem WireGuard i umożliwia dostęp do usług sieciowych urządzenia przez interfejs VPN. Parametry połączenia VPN mogą być ustawione ręcznie lub otrzymane automatycznie. Tryb konfiguracji wybierany jest w interfejsie Web TR-100E. Dla działania VPN TR-100E musi mieć dostęp do sieci Internet, poprawnie skonfigurowaną bramę i serwery DNS, a sieć nie może blokować połączenia ze zdalnym węzłem WireGuard. 2.5.2 Ręczna konfiguracja WireGuard Parametry VPN znajdują się w interfejsie Web w sekcji Ustawienia → VPN-WireGuard. Ręczna konfiguracja używana jest do połączenia z samodzielnie wybranym węzłem WireGuard. Aby ją zastosować: Włączyć parametr Włączone. Wyłączyć parametr Automatyczne połączenie z serwerem Overvis. Wskazać wartości udostępnione przez administratora VPN: klucz prywatny, adres interfejsu w formacie CIDR, klucz publiczny i adres węzła, port, dozwolone sieci IP i okres utrzymania połączenia. Nacisnąć przycisk Zapisz. Po zapisaniu zmienionych parametrów usługa WireGuard restartuje się automatycznie; restart TR-100E nie jest wymagany. Dane poufne Klucz prywatny WireGuard nie powinien być przekazywany osobom postronnym lub umieszczany w zrzutach ekranu i materiałach diagnostycznych. Szczegółową kolejność ręcznej konfiguracji podano w „Załączniku B. Konfiguracja VPN WireGuard”. 2.5.3 Automatyczna konfiguracja przez Overvis Overvis — to chmurowy system monitorowania i wizualizacji, który może używać VPN WireGuard do dostępu do TR-100E. Przy wyborze trybu automatycznego TR-100E identyfikowany jest za pomocą fabrycznego kodu PIN, otrzymuje od Overvis parametry WireGuard i ustanawia połączenie VPN. Statyczny zewnętrzny adres IP i przekierowanie portów przychodzących na routerze nie są wtedy wymagane. Przy włączonym parametrze Automatyczne połączenie z serwerem Overvis pola konfiguracji ręcznej nie są używane. Pole URL serwera automatycznej konfiguracji należy pozostawić puste, jeśli inny adres nie został udostępniony przez producenta lub wsparcie techniczne. Dla połączenia przez Overvis niezbędne jest: Zapewnić TR-100E dostęp do sieci Internet. W sekcji Ustawienia → VPN-WireGuard włączyć Włączone i Automatyczne połączenie z serwerem Overvis, następnie zapisać ustawienia. Utworzyć sieć na koncie Overvis i powiązać z nią TR-100E za pomocą fabrycznego kodu PIN. Poczekać na ustanowienie połączenia VPN i sprawdzić dostęp do wymaganych danych TR-100E. Szczegółową kolejność połączenia podano w „Załączniku B. Konfiguracja VPN WireGuard”. Dodatkowe informacje o systemie Overvis zamieszczono na stronie www.overvis.com. Uwaga Za użytkowanie systemu Overvis może być pobierana opłata. Przed podłączeniem TR-100E zaleca się zapoznanie z obowiązującymi taryfami Overvis. 2.5.4 Dostęp do interfejsu Web i Modbus TCP przez VPN Ustanowione połączenie VPN samo w sobie nie zezwala na dostęp do usług sieciowych TR-100E. Niezbędne usługi i dostęp do nich przez VPN konfigurowane są oddzielnie: dla interfejsu Web w sekcji Ustawienia → Serwer Web włączyć Dostęp do Web przez VPN i wybrać Domyślny poziom dostępu przez VPN: Guest, User lub PowerUser; dla Modbus TCP w sekcji Ustawienia → Modbus TCP wybrać Dostęp do Modbus przez VPN: Zabroniony, Według ochrony ogólnej, Tylko odczyt lub Odczyt i zapis. W trybie Według ochrony ogólnej sesje VPN podlegają ogólnemu trybowi ochrony Modbus i wymagają odblokowania hasłem na takich samych zasadach jak połączenia lokalne. Tryb Tylko odczyt zezwala na odczyt przez VPN bez hasła i odrzuca wszystkie polecenia zapisu. Tryb Odczyt i zapis zezwala na odczyt i zapis przez VPN bez hasła; połączenia lokalne nadal podlegają ogólnemu trybowi ochrony Modbus. Zezwalajcie przez VPN tylko na niezbędne usługi i przyznawajcie minimalnie wystarczający poziom dostępu. 2.6 Korzystanie z Modbus TCP TR-100E podłącza się do sieci lokalnej przez interfejs Ethernet. Protokół Modbus TCP używany jest do wymiany danych między TR-100E a klientem Modbus przez sieć TCP/IP. Przez Modbus TCP można: odczytywać zmierzone wartości i bieżący stan TR-100E, na przykład do przekazania danych do systemu SCADA; odczytywać i zmieniać dostępne ustawienia TR-100E; wykonywać przewidziane protokołem polecenia serwisowe. W celach bezpieczeństwa bezpośrednie sterowanie przekaźnikami wyjściowymi przez Modbus TCP nie jest przewidziane: przekaźniki są sterowane wbudowanymi algorytmami zabezpieczeń zgodnie z wynikami pomiarów, ustawionymi progami, histerezą i opóźnieniami. To wyklucza ominięcie algorytmów zabezpieczeń zdalnym poleceniem. TR-100E używa dwóch niezależnych grup rejestrów Modbus: rejestrów Input i rejestrów Holding. Bieżące stany odczytywane są z rejestrów Input funkcją 0x04; ustawienia, wartości serwisowe i polecenia znajdują się w rejestrach Holding i są obsługiwane funkcjami 0x03, 0x06 i 0x10. Parametr Limit czasu określa dopuszczalny czas braku danych od klienta Modbus. Jeśli dane nie zostaną odebrane w ustawionym czasie, TR-100E zamyka połączenie TCP. Pakiety sterujące TCP Keepalive nie zerują tego limitu czasu. Wartość 0 wyłącza limit czasu; w takim przypadku TR-100E nie zamyka nieaktywnego połączenia. Ustawienie fabryczne to 0 (limit czasu wyłączony). Domyślnie mechanizm ochrony Modbus ogranicza zapis w chronione rejestry Holding. Dla odblokowania niezbędne jest zapisanie hasła Modbus do rejestrów 52–63 w znakach ASCII (dwa znaki w rejestrze, starszy bajt pierwszy, ciąg kończy się bajtem zerowym). Domyślnie obowiązuje hasło fabryczne wskazane na naklejce z kodem QR. Pomyślna weryfikacja odblokuje tylko bieżącą sesję TCP; stan mechanizmu ochrony dostępny jest w rejestrze 51. Po pięciu nieprawidłowych próbach żądania z danego adresu IP są blokowane na 5 minut. Przy zmianie hasła Modbus dopuszczalne jest hasło o długości 8…23 znaków. Sprawdzanie hasła włącza się i wyłącza parametrem Hasło Modbus → Zabezpieczenia; wyłączenie sprawdzania nie usuwa zapisanego hasła. Tryb działania mechanizmu ochrony określany jest rejestrem 169: 0 — bez ochrony, 1 — chroniony zapis, 2 — chroniony odczyt i zapis. Dostęp do rejestrów serwisowych 0–4, 51, 52–63 i 64–65 nie zależy od wybranego trybu ochrony i jest wskazany w tabeli 7. Dla sesji VPN dodatkowo obowiązuje poziom ustawiony parametrem Dostęp do Modbus przez VPN. Poziomy Tylko odczyt i Odczyt i zapis nie wymagają odblokowania hasłem przez VPN i nie zmieniają ochrony lokalnych połączeń Modbus. Bezpieczeństwo Po pomyślnym wprowadzeniu hasła chronione rejestry pozostają odblokowane dla bieżącego połączenia TCP. Dostęp zachowuje się do zamknięcia tego połączenia. Dlatego po zakończeniu odczytu lub zmiany ustawień należy odłączyć klienta Modbus TCP od TR-100E. Kolejność słów i bajtów Każdy 16-bitowy rejestr przesyłany jest starszym bajtem naprzód (big-endian). Wartości uint32 i int32 zajmują dwa rejestry: pierwszy rejestr zawiera bity 31–16, drugi — bity 15–0 (high word first). Na przykład wartość 0x12345678 przesyłana jest jako 0x1234, 0x5678. Dla adresu IPv4 A.B.C.D pierwszy rejestr zawiera bajty D, C, a drugi — B, A. Na przykład statyczny adres 192.168.0.100 zapisywany jest w rejestrach 120–121 jako 0x6400, 0xA8C0. Taka sama kolejność używana jest dla serwerów DNS, maski, bramy i bieżących parametrów sieciowych w rejestrach Input. W polach strN każdy rejestr zawiera dwa kolejne bajty ciągu: pierwszy znak — w starszym bajcie, drugi — w młodszym. Ciąg kończy się bajtem zerowym 0x00; pozostałe bajty pola muszą być zerowe. Pola złożone o długości dwóch rejestrów i więcej zapisywane są funkcją 0x10 w całości, zaczynając od pierwszego adresu pola. Częściowy zapis lub zapis pojedynczego rejestru funkcją 0x06 nie jest dopuszczalny. Wartości czasu UTC przesyłane są jako liczba sekund, które upłynęły od 00:00:00 01.01.1970 wg UTC. Na przykład wartość 0 odpowiada początkowi odliczania — 00:00:00 01.01.1970 UTC. Przesunięcie strefy czasowej i DST do wartości rejestru nie są dodawane. Temperatury w rejestrach Input mają format int16 ze skalą ×10. Wartość -32768 (0x8000) zarezerwowana jest jako oznaczenie pomiaru niewiarygodnego: oprogramowanie wewnętrzne przesyła ją, jeśli wewnętrzna wartość temperatury nie jest liczbą skończoną (NaN, +Inf lub -Inf) lub nie udało się uzyskać pomiaru. Tej wartości nie należy przekształcać na temperaturę -3276,8 °C. Korekcja temperatury kanałów, progi, histerezy i NTC PTC Minika w rejestrach Holding mają również format int16 ze skalą ×10. UWAGA W TR-100E istnieje ograniczenie na liczbę jednocześnie podłączonych klientów Modbus TCP (nie więcej niż pięć). Wszystkie połączenia przekraczające ograniczenie będą zamykane automatycznie. Tabela 4 - Wykaz obsługiwanych funkcji (Modbus) Kod funkcji Nazwa funkcji Opis 0x03 Odczyt rejestrów Holding Odczyt ustawień i rejestrów serwisowych 0x04 Odczyt rejestrów Input Odczyt bieżących stanów i pomiarów 0x06 Zapis jednego rejestru Holding Zapis wartości lub polecenia zajmujących jeden rejestr 0x10 Zapis kilku rejestrów Holding Zapis wartości zajmującej kilka rejestrów lub sekwencji wartości Tabela 5 - Typy danych Typ Długość, bajt Opis int16 2 Liczba całkowita od -32768 do 32767 uint16 2 Liczba całkowita od 0 do 65535 int32 4 Liczba całkowita od -2147483648 do 2147483647 uint32 4 Liczba całkowita od 0 do 4294967295 strN 2×N Ciąg do 2×N bajtów: starszy bajt rejestru pierwszy, zakończenie 0x00 Tabela 6 – Rejestry Input (funkcja 0x04) Adres Nazwa Opis Typ 1 Przyczyna restartu 0 nieznana; 1 włączenie zasilania; 2 sygnał RESET; 3 restart programowy; 4 reset strażnika; 5 wyjście z trybu obniżonego zużycia energii uint16 2 Temperatura mikrokontrolera Temperatura ×10; -32768 (0x8000) — pomiar niewiarygodny int16 3–4 Czas pracy Sekundy od momentu uruchomienia uint32 5–6 Flagi stanu Maska bitowa ogólnego stanu TR-100E. Przeznaczenie bitów podano poniżej uint32 7–8 Gotowość funkcji urządzenia Maska bitowa stanu podsystemów TR-100E. Przeznaczenie bitów podano poniżej uint32 9–10 Czas RTC Liczba sekund od 00:00:00 01.01.1970 UTC uint32 11 Źródło synchronizacji RTC 0 brak; 1 rezerwa RTC; 2 NTP; 3 ustawienie ręczne uint16 12–13 Ostatnia synchronizacja czasu przez NTP Liczba sekund od 00:00:00 01.01.1970 UTC; 0 — nie było pomyślnej synchronizacji czasu uint32 14–15 Licznik synchronizacji NTP Liczba pomyślnych synchronizacji uint32 16–17 Licznik błędów NTP Liczba nieudanych synchronizacji uint32 18–19 Bieżący adres IP Aktywny IPv4 uint32 20–21 Bieżąca maska Aktywna maska IPv4 uint32 22–23 Bieżąca brama Aktywna brama IPv4 uint32 24–27 Stan CH1–CH4 Maska bitowa stanu każdego kanału. Przeznaczenie rejestrów i bitów podano poniżej uint16 × 4 28–31 Stan linii CH1–CH4 0 nieznany; 1 zwarcie; 2 poniżej zakresu; 3 norma; 4 powyżej zakresu; 5 obrywa uint16 × 4 32–35 Bieżąca temperatura CH1–CH4 Temperatura ×10; -32768 (0x8000) — pomiar niewiarygodny int16 × 4 36–39 Minimalna temperatura CH1–CH4 Temperatura ×10; -32768 (0x8000) — pomiar niewiarygodny int16 × 4 40–43 Maksymalna temperatura CH1–CH4 Temperatura ×10; -32768 (0x8000) — pomiar niewiarygodny int16 × 4 44–47 Kierunek zmiany temperatury CH1–CH4 0 obniża się; 1 nie zmienia się; 2 podnosi się uint16 × 4 Rozszyfrowanie rejestrów 5–6 „Flagi stanu” Ustawiony bit (1) oznacza, że wskazany stan jest aktywny. Zresetowany bit (0) oznacza, że stan jest nieaktywny. Bit Stan Znaczenie przy ustawionym bicie (1) 0 FAULT Przekaźnik FAULT włączony z powodu niesprawności czujnika lub błędu wewnętrznego TR-100E. Bit ustawiany jest po zakończeniu opóźnienia Awaria → Opóźnienie 1 TRIP Przekaźnik TRIP włączony z powodu przekroczenia progu przegrzania. Bit ustawiany jest po zakończeniu opóźnienia Przegrzanie → Opóźnienie 2 ALARM Przekaźnik ALARM włączony z powodu przekroczenia progu alarmu. Bit ustawiany jest po zakończeniu opóźnienia Alarm → Opóźnienie 3 FAN Przekaźnik FAN włączony z powodu przekroczenia progu wentylacji. Bit ustawiany jest po zakończeniu opóźnienia Wentylacja → Opóźnienie 4 Wymagany restart Dla zastosowania części zapisanych ustawień wymagany jest restart TR-100E 5 Otwarty dostęp Dostęp do TR-100E jest dozwolony bez wprowadzania hasła Stan przekaźników Bity 0–3 zawierają stany logiczne zabezpieczeń, a nie wynik kontroli fizycznych styków przekaźników. Te stany sterują odpowiednimi przekaźnikami. Podczas ręcznego testowania przekaźniki są sterowane poleceniami testowymi, dlatego ich stan może różnić się od wartości bitów 0–3. Rozszyfrowanie rejestrów 7–8 „Gotowość funkcji urządzenia” Każdy bit pokazuje gotowość odpowiedniego podsystemu: 1 — podsystem gotowy do pracy; 0 — podsystem niegotowy lub niezainicjalizowany. Bit Podsystem Znaczenie przy ustawionym bicie (1) 0 Ustawienia Dane ustawień są poprawne i dostępne 1 Dane serwisowe pomiaru Dane serwisowe toru pomiarowego są poprawne 2 Zegar czasu rzeczywistego RTC skonfigurowany i działa 3 Przyciski Moduł przycisków gotowy 4 Wskaźniki LED Moduł wskaźników LED gotowy 5 Wyświetlacz Wyświetlacz LCD gotowy 6 Pamięć zewnętrzna Pamięć zewnętrzna gotowa 7 Dane identyfikacyjne Magazyn danych identyfikacyjnych urządzenia gotowy 8 Dziennik zdarzeń Dziennik zdarzeń gotowy 9 Rejestrator temperatury Rejestrator temperatury gotowy 10 Historia operacyjna temperatury Historia temperatury gotowa 11 Pomiar temperatury Moduł pomiarowy gotowy 12 Generator liczb losowych Sprzętowy generator liczb losowych gotowy 13 Ethernet Interfejs Ethernet gotowy 14 Stos sieciowy TCP/IP Stos sieciowy gotowy 15 Interfejs Web Serwer Web gotowy 16 NTP Klient synchronizacji czasu gotowy 17 WireGuard Usługa VPN WireGuard gotowa 18 Modbus TCP Serwer Modbus TCP gotowy Rozszyfrowanie rejestrów 24–27 „Stan CH1–CH4” Każdemu kanałowi odpowiada oddzielny rejestr: 24 — CH1, 25 — CH2, 26 — CH3, 27 — CH4. Bit Stan kanału Znaczenie przy ustawionym bicie (1) 0 Kanał włączony Kanał włączony i uczestniczy w przetwarzaniu pomiarów 1 Warunek TRIP Temperatura kanału osiągnęła próg Przegrzanie lub jeszcze nie obniżyła się poniżej progu z uwzględnieniem histerezy 2 Warunek ALARM Temperatura kanału osiągnęła próg Alarm lub jeszcze nie obniżyła się poniżej progu z uwzględnieniem histerezy 3 Warunek FAN Kanał wybrany do sterowania wentylacją, a jego temperatura osiągnęła próg Wentylacja lub jeszcze nie obniżyła się poniżej progu z uwzględnieniem histerezy Flagi kanałowe i ogólne Bity 1–3 rejestrów 24–27 pokazują spełnienie warunku temperaturowego przez pojedynczy kanał i ustawiane są przed zakończeniem opóźnienia włączenia przekaźnika. Faktyczne polecenie włączenia przekaźnika po zakończeniu opóźnienia pokazują odpowiednie bity rejestrów 5–6. Tabela 7 – Rejestry Holding: wartości serwisowe i polecenia Adres Nazwa Opis Dostęp Typ 0 Kod modelu urządzenia TR-100E: 48 O uint16 1 Wersja oprogramowania wewnętrznego Na przykład 0x0100 dla wersji 1.0 O uint16 2–4 Adres MAC 6 bajtów O str3 50 Polecenie 62149 restart; 18252 zapisz kopię roboczą; 54135 odczytaj ponownie ustawienia; 33421 zresetuj minimalne i maksymalne temperatury; 20052 synchronizuj czas przez NTP Z+O uint16 51 Stan mechanizmu ochrony 0 — ochrona działa; 1 — chronione operacje dozwolone dla bieżącej sesji TCP O uint16 52–63 Hasło Modbus Wprowadzenie obowiązującego hasła; dopuszczalne jest zapisywanie tylko niezbędnej liczby rejestrów Z str12 64–65 Ustawienie czasu UTC Liczba sekund od 00:00:00 01.01.1970 UTC; wartość 0 zabroniona; niezbędne jest zapisanie obu rejestrów jednym żądaniem Z uint32 Kopia robocza ustawień Przy zapisie rejestrów 100–220 zmiany gromadzą się w kopii roboczej ustawień Modbus dla bieżącej sesji TCP. Do wykonania polecenia zapisu nie są zapisywane w pamięci energoniezależnej i zostaną utracone po zamknięciu połączenia lub restarcie TR-100E. Przeznaczenie poleceń: 18252 — zapisz ustawienia: zapisuje zgromadzone zmiany w pamięci energoniezależnej. 54135 — anuluj niezapisane zmiany: ponownie ładuje do kopii roboczej ustawienia z pamięci energoniezależnej. Typowa sekwencja zmiany parametrów przez Modbus TCP: Jeśli ochrona jest aktywna, zapisać hasło Modbus do rejestrów Holding 52–63 i upewnić się, że rejestr 51 ma wartość 1, co oznacza zezwolenie na operacje chronione w bieżącej sesji TCP; Zapisać nowe wartości do potrzebnych rejestrów Holding tabeli 3 — zmiany trafiają do kopii roboczej; Wykonać polecenie 18252 — zapisać kopię roboczą w pamięci energoniezależnej; Wykonać polecenie 62149 — zrestartować TR-100E dla zastosowania nowych ustawień. 2.7 Porty sieciowe Dla konfiguracji routera lub zapory sieciowej należy uwzględnić połączenia sieciowe podane w tabeli 8. Tabela 8 – Porty sieciowe TR-100E Funkcja Protokół i port Kierunek względem TR-100E Warunki użycia Interfejs Web i Web API TCP 80 Przychodzące Port domyślny; zmienia się parametrem Dostęp Web → Port Modbus TCP TCP 502 Przychodzące Port domyślny; zmienia się parametrem Modbus TCP → Port DHCP UDP 68 ↔ UDP 67 Wychodzące i odpowiedź TR-100E używa portu lokalnego 68, serwer DHCP — portu 67; używane przy włączonym DHCP DNS UDP 53 Wychodzące i odpowiedź Żądania do skonfigurowanych serwerów DNS; niezbędne przy używaniu nazw DNS serwerów NTP, WireGuard lub autokonfiguracji NTP UDP 123 Wychodzące i odpowiedź Synchronizacja czasu ze skonfigurowanymi serwerami NTP przy włączonym NTP WireGuard VPN UDP 51820 Przychodzące i wychodzące Port lokalny TR-100E; dla węzła zdalnego domyślnie również używany jest 51820, ale można go zmienić parametrem VPN-WireGuard → Port peer Automatyczna konfiguracja WireGuard przez Overvis TCP 80 Wychodzące i odpowiedź Port domyślny; inny port może być wskazany w URL serwera automatycznej konfiguracji Interfejs Web trybu odzyskiwania TCP 80 Przychodzące Dostępny tylko w trybie odzyskiwania bootloadera pod adresem 192.168.1.48 Połączenia przychodzące do interfejsu Web i Modbus TCP należy zezwalać tylko z zaufanych sieci. Przy używaniu tylko połączeń wychodzących z NTP, DNS i serwerem autokonfiguracji przekierowanie portów na routerze nie jest wymagane; zapora sieciowa powinna zezwalać na ruch odpowiedzi ustanowionych połączeń. WireGuard i NAT TR-100E samodzielnie inicjuje wymianę ze zdalnym węzłem WireGuard. Przy takim schemacie przekierowanie portu UDP 51820 na routerze zazwyczaj nie jest wymagane. Jest ono niezbędne tylko jeśli zdalny węzeł ma pierwszy ustanawiać połączenie z TR-100E przez NAT. 3 OBSŁUGA TECHNICZNA 3.1 Środki bezpieczeństwa Środki bezpieczeństwa PODCZAS OBSŁUGI TECHNICZNEJ NALEŻY ODŁĄCZYĆ PRODUKT I PODŁĄCZONE DO NIEGO URZĄDZENIA OD SIECI ZASILAJĄCEJ. 3.2 Okresowość obsługi technicznej Zalecana okresowość obsługi technicznej – co sześć miesięcy. 3.3 Porządek obsługi technicznej: Sprawdzić niezawodność podłączenia przewodów do zacisków TR-100E, w przypadku wykrycia poluzowanych kontaktów dokręcić śruby zacisków. W przypadku wykrycia uszkodzonych przewodów wymienić je na nowe; Wizualnie sprawdzić integralność obudowy, w przypadku wykrycia pęknięć lub odprysków zdjąć produkt z eksploatacji i wysłać do naprawy; W razie potrzeby przetrzeć szmatką obudowę produktu. Do czyszczenia nie należy używać materiałów ściernych i rozpuszczalników. 3.4 Diagnostyka i usuwanie niesprawności Uwaga Wszystkie prace związane z usuwaniem niesprawności wykonywane są przy odłączonym zasilaniu TR-100E, z wyjątkiem przypadków, gdy wyraźnie wskazano inaczej. Tabela 9 – Możliwe niesprawności i sposoby ich usuwania Objaw Możliwa przyczyna Działanie Wyświetlacz nie świeci się po włączeniu zasilania Na zaciskach zasilania brak napięcia; niesprawność TR-100E Sprawdzić obecność i zgodność napięcia zasilania na zaciskach z wymaganiami tabeli 1. Jeśli napięcie odpowiada wymaganiom, a wyświetlacz się nie włącza — wysłać TR-100E do naprawy Wskaźnik CH1–CH4 miga, kanał pokazuje «PRZERW.» Przerwanie linii czujnika lub niesprawność czujnika Sprawdzić integralność kabla i niezawodność podłączenia czujnika do zacisków TR-100E Wskaźnik CH1–CH4 miga, kanał pokazuje «ZW.» Zwarcie linii czujnika Sprawdzić kabel czujnika pod kątem zwarcia; wymienić czujnik lub kabel Wskaźnik FAULT miga Niesprawność czujnika; błąd wewnętrzny TR-100E; awaria podczas włączania Sprawdzić stan kanałów na wyświetlaczu — jeśli kanały są sprawne, sprawdzić dziennik zdarzeń w celu wyjaśnienia przyczyny. Wykonać ponowne uruchomienie: odłączyć i ponownie podać zasilanie, lub przez interfejs Web (Ustawienia → Serwis). Jeśli po ponownym uruchomieniu FAULT nadal miga bez widocznych przyczyn — wysłać TR-100E do naprawy Przekaźnik nie zadziała przy przekroczeniu progu Trwa odliczanie opóźnienia; kanał wyłączony; próg ustawiony nieprawidłowo Sprawdzić parametry Opóźnienie, Włączenie kanału i wartość Progu (tabela 3) Przekaźnik nie wyłącza się po obniżeniu temperatury Histereza ustawiona zbyt duża; nieprawidłowy próg Sprawdzić parametry Histereza i Próg odpowiedniego przekaźnika (tabela 3) Czas resetuje się po długotrwałym odłączeniu zasilania Kondensator buforowy RTC rozładowany (więcej niż 7 dni bez zasilania) Ustawić czas ręcznie (p. 2.2.9) lub włączyć synchronizację przez NTP Brak dostępu do interfejsu Web przez adres IP Nieprawidłowy adres IP; serwer Web wyłączony; brak połączenia sieciowego Sprawdzić adres IP na wyświetlaczu TR-100E; upewnić się, że parametr Włączenie serwera Web = 1 (tabela 3); sprawdzić kabel Ethernet i wskaźnik LINK Klient Modbus TCP nie otrzymuje odpowiedzi Nieprawidłowy IP, port lub UID; Modbus wyłączony; przekroczona liczba połączeń Sprawdzić parametry Włączenie, Port, UID (tabela 3); upewnić się, że liczba jednoczesnych klientów nie przekracza 5 Brak synchronizacji czasu przez NTP NTP wyłączony; nieprawidłowy adres serwera; brak dostępu do sieci Sprawdzić parametry Włączenie NTP, Adres serwera, ustawienia sieciowe i dostęp TR-100E do internetu (tabela 3) Dane rejestratora nie są zapisywane Rejestrator wyłączony Włączyć parametr Rejestrator i sprawdzić wartość parametru Okres zapisu temperatury (tabela 3) 4 OKRES UŻYTKOWANIA I GWARANCJA PRODUCENTA 4.1 Okres użytkowania produktu Okres użytkowania produktu wynosi 15 lat. Po upływie okresu użytkowania należy skontaktować się z producentem. 4.2 Okres przechowywania Okres przechowywania produktu wynosi 3 lata. 4.3 Okres gwarancyjny eksploatacji Okres gwarancyjny eksploatacji produktu wynosi 10 lat od dnia sprzedaży. W okresie gwarancyjnym eksploatacji (w przypadku awarii produktu) producent wykonuje naprawę produktu — bezpłatnie. Zobowiązania gwarancyjne Zobowiązania gwarancyjne nie obejmują produktów, które zostały uszkodzone w wyniku eksploatacji z naruszeniem wymagań niniejszej Instrukcji obsługi, a także w wyniku uszkodzeń mechanicznych, działania wilgoci, korozji, wysokich temperatur, substancji chemicznych i innych czynników niezwiązanych z wadami produkcyjnymi produktu. 4.4 Obsługa gwarancyjna Obsługa gwarancyjna jest wykonywana w miejscu zakupu lub przez producenta produktu. 4.5 Obsługa pogwarancyjna Obsługa pogwarancyjna produktu jest wykonywana przez producenta według obowiązujących taryf. Ważna informacja Przed wysłaniem produktu do naprawy musi on być zapakowany w opakowanie fabryczne lub inne opakowanie wykluczające uszkodzenia mechaniczne. 5 TRANSPORT I PRZECHOWYWANIE TR-100E w opakowaniu producenta dopuszcza się do transportu i przechowywania w temperaturze od minus 30 do +60 °C i wilgotności względnej nie więcej niż 98% przy 35 °C (bez kondensacji wilgoci).

Novatek-Electro TR-100E Documentation

Załącznik A: Awaryjne odzyskiwanie oprogramowania ZAŁĄCZNIK A. AWARYJNE ODZYSKIWANIE OPROGRAMOWANIA WEWNĘTRZNEGO Dokument główny: „Instrukcja obsługi TR-100E” Niniejszy załącznik opisuje odzyskiwanie oprogramowania wewnętrznego TR-100E za pomocą bootloadera. Procedurę stosuje się, jeżeli standardowy interfejs Web nie otwiera się, aktualizacja zakończyła się błędem lub TR-100E zgłasza nieprawidłową aplikację. Bootloader udostępnia dwa sposoby odzyskiwania: Restore firmware — ponowna instalacja wcześniej wgranego obrazu oprogramowania; Recovery mode — wgranie nowego pliku oprogramowania .ota z komputera przez Ethernet i jego późniejsza instalacja. Do odzyskiwania potrzebne są: plik oprogramowania w formacie .ota, przeznaczony dla TR-100E — dla trybu Recovery mode; komputer z przeglądarką internetową i interfejsem Ethernet — dla trybu Recovery mode; przewód Ethernet do bezpośredniego podłączenia komputera do TR-100E lub przez przełącznik sieciowy. Bezpieczeństwo wyposażenia W trybie bootloadera TR-100E nie kontroluje temperatury ani nie steruje przekaźnikami. Przed rozpoczęciem odzyskiwania należy przełączyć podłączone wyposażenie do stanu bezpiecznego i w razie potrzeby zapewnić niezależną kontrolę. Zasilanie Nie odłączać zasilania po uruchomieniu instalacji oprogramowania, gdy na wyświetlaczu widnieje Update firmware. Jeżeli zasilanie mimo to zostało przerwane, przy następnym włączeniu bootloader wyświetli Previous update: Interrupted i automatycznie ponowi instalację zachowanego obrazu. A.1 Wejście do menu bootloadera Wyłączyć zasilanie TR-100E. Nacisnąć i przytrzymać przycisk „Menu” (MENU). Nie zwalniając przycisku, podać zasilanie na TR-100E. Po pojawieniu się ekranu powitalnego TR100E BootLoader v1.2 zwolnić przycisk. Po kilku sekundach otworzy się ekran Boot menu. Do obsługi menu służą: UP/DOWN — przemieszczanie wskaźnika; SET — wykonanie wybranego działania; MENU — anulowanie i przejście do uruchomienia zainstalowanej aplikacji. Menu zawiera następujące pozycje: Pozycja Przeznaczenie Run application Uruchamia zainstalowane oprogramowanie. Jeżeli jest uszkodzone, pojawi się komunikat Run application: Application invalid Restore firmware Instaluje wcześniej wgrany obraz .ota Recovery mode Uruchamia serwisowy interfejs Web do wgrania nowego obrazu .ota A.2 Odzyskiwanie wcześniej wgranego obrazu Ta metoda nie wymaga komputera. Należy jej użyć, jeżeli przed awarią plik aktualizacji został w pełni wgrany do TR-100E. Wejść do menu bootloadera zgodnie z p. A.1. Przy pomocy przycisków UP/DOWN wybrać Restore firmware i nacisnąć SET. Poczekać na zakończenie sprawdzania i instalacji oprogramowania. Przebieg operacji jest pokazywany wskaźnikiem od 0 do 100%. Po komunikacie Done, start app TR-100E automatycznie uruchomi odzyskane oprogramowanie. Jeżeli pojawi się Image not found, Image invalid lub Operation failed, należy wgrać nowy plik .ota zgodnie z p. A.3. Po wyświetleniu komunikatu o błędzie bootloader spróbuje uruchomić zainstalowane oprogramowanie. Aby ponownie wejść do menu, należy jeszcze raz włączyć TR-100E z wciśniętym przyciskiem MENU. A.3 Wgrywanie nowego obrazu przez Recovery mode A.3.1 Podłączenie Odłączyć komputer od innych sieci z adresami 192.168.1.x, aby wykluczyć konflikt tras. Połączyć TR-100E i komputer przewodem Ethernet bezpośrednio albo przez przełącznik sieciowy. Wejść do menu bootloadera zgodnie z p. A.1. Wybrać Recovery mode i nacisnąć SET. Poczekać na ekran Recovery mode. Wyświetlane są na nim adres IP i adres MAC TR-100E. W trybie odzyskiwania używane są stałe parametry sieciowe: Parametr Wartość Adres IP TR-100E 192.168.1.48 Maska podsieci 255.255.255.0 Brama TR-100E 192.168.1.1 Port TCP interfejsu Web 80 We właściwościach IPv4 interfejsu Ethernet komputera wyłączyć automatyczne pobieranie adresu i tymczasowo ustawić na przykład: adres IP — 192.168.1.2; maska podsieci — 255.255.255.0; bramę domyślną i serwer DNS — pozostawić puste. Otworzyć w przeglądarce adres http://192.168.1.48. Powinna pojawić się strona TR-100E Recovery. Tryb Recovery nie używa DHCP ani ustawień sieciowych z głównego oprogramowania. Adres 192.168.1.48 pozostaje niezmienny niezależnie od wcześniejszej konfiguracji TR-100E. A.3.2 Wgrywanie i sprawdzanie pliku Na stronie TR-100E Recovery nacisnąć pole wyboru pliku i wskazać plik oprogramowania TR-100E z rozszerzeniem .ota. Nacisnąć Send i poczekać na przesłanie pliku do TR-100E. Poczekać na wartość percent=100%. Po odebraniu pliku bootloader sprawdza format obrazu, przeznaczenie dla TR-100E oraz sumę kontrolną danych. Upewnić się, że w polu stanu widnieje imageValid=true, lastError=0, a przycisk Firmware stał się dostępny. Jeżeli wgrywanie zostało przerwane przed naciśnięciem Firmware, zainstalowane oprogramowanie nie ulega zmianie. Bez restartowania TR-100E należy ponownie wybrać plik i jeszcze raz nacisnąć Send: nieukończone wgrywanie zostanie zastąpione nowym. A.3.3 Instalacja oprogramowania Nacisnąć Firmware. Na stronie pojawi się komunikat Rebooting…, po czym TR-100E uruchomi się ponownie i rozpocznie instalację. Nie odłączać zasilania i nie naciskać przycisków. Na wyświetlaczu będą pokazywane etapy sprawdzania i instalacji oprogramowania. Poczekać na komunikat Done i automatyczne uruchomienie TR-100E. Po pojawieniu się ekranu głównego sprawdzić wersję oprogramowania oraz działanie kanałów pomiarowych i przekaźników. Przywrócić pierwotne ustawienia IPv4 interfejsu Ethernet komputera. Przed instalacją bootloader sprawdza zgodność, integralność i autentyczność pliku. Nie można zainstalować pliku uszkodzonego, zmienionego po wydaniu lub przeznaczonego dla innego urządzenia. A.4 Komunikaty bootloadera Komunikat Przyczyna i działanie Image not found Wcześniej wgrany obraz nie został znaleziony. Wykonać wgrywanie zgodnie z p. A.3 Image invalid Nieprawidłowy format lub parametry obrazu. Uzyskać poprawny plik .ota dla TR-100E Operation failed Nie udało się sprawdzić lub zainstalować oprogramowania. Ponownie wgrać sprawdzony, poprawny plik; jeżeli sytuacja się powtórzy, skontaktować się z organizacją serwisową Previous update: Interrupted Poprzednia instalacja została przerwana. Bootloader automatycznie ponawia ją z zachowanego obrazu Previous update: Failed Poprzednia instalacja zakończyła się błędem. Wejść do Recovery mode i wgrać poprawny obraz Boot warning: Key not set W TR-100E brak danych niezbędnych do sprawdzenia pliku oprogramowania. Skontaktować się z organizacją serwisową Run application: Application invalid Wybrano ręczne uruchomienie, ale zainstalowane oprogramowanie jest uszkodzone lub nieobecne. Wykonać odzyskiwanie zgodnie z p. A.2 lub A.3 Boot error: Application invalid Zainstalowane oprogramowanie jest uszkodzone lub nieobecne. Wykonać odzyskiwanie zgodnie z p. A.2 lub A.3 Clock error: HSE start failed Nie udało się uruchomić generatora systemowego. TR-100E automatycznie uruchomi się ponownie; jeżeli sytuacja się powtórzy, skontaktować się z organizacją serwisową Ethernet error: MAC read failed Nie udało się odczytać adresu sieciowego TR-100E. Uruchomić urządzenie ponownie; jeżeli sytuacja się powtórzy, skontaktować się z organizacją serwisową Ethernet error: ETH config failed Nie udało się skonfigurować interfejsu Ethernet. Sprawdzić połączenie i ponownie uruchomić tryb Recovery; jeżeli sytuacja się powtórzy, skontaktować się z organizacją serwisową Ethernet error: LwIP init failed Nie udało się uruchomić usługi sieciowej. Ponownie uruchomić tryb Recovery; jeżeli sytuacja się powtórzy, skontaktować się z organizacją serwisową Jeżeli strona odzyskiwania się nie otwiera: upewnić się, że na wyświetlaczu widnieje ekran Recovery mode i adres 192.168.1.48; sprawdzić wskaźniki połączenia Ethernet na TR-100E i karcie sieciowej komputera; sprawdzić, czy adres komputera należy do sieci 192.168.1.0/24, ale nie jest równy 192.168.1.48; tymczasowo wyłączyć VPN i inne interfejsy sieciowe komputera; otworzyć dokładnie http://192.168.1.48, bez https; sprawdzić, czy zapora sieciowa nie blokuje portu TCP 80 w sieci lokalnej. Jeżeli po ponownym wgraniu poprawnego pliku odzyskiwanie nadal nie kończy się powodzeniem, należy zapisać treść komunikatu na wyświetlaczu, stan lastError na stronie Recovery oraz adres MAC urządzenia, a następnie skontaktować się z organizacją serwisową.

Novatek-Electro TR-100E Documentation

Załącznik B: Konfiguracja VPN WireGuard ZAŁĄCZNIK B. KONFIGURACJA VPN WIREGUARD Dokument główny: „Instrukcja obsługi TR-100E” Niniejszy załącznik opisuje dwa tryby konfiguracji VPN WireGuard: statyczny — parametry połączenia są wprowadzane ręcznie w celu połączenia z wybranym węzłem WireGuard; automatyczny — TR-100E otrzymuje parametry połączenia od Overvis po połączeniu z kontem za pomocą kodu PIN. W obu trybach TR-100E samodzielnie inicjuje wymianę danych ze zdalnym węzłem. Do konfiguracji wymagany jest dostęp do interfejsu Web TR-100E z poziomem powerUser. TR-100E musi mieć połączenie IP ze zdalnym węzłem; w przypadku korzystania z nazwy hosta serwery DNS muszą być poprawnie skonfigurowane. Dane poufne Nie należy udostępniać osobom postronnym kodu PIN, haseł, klucza prywatnego WireGuard ani innych danych identyfikacyjnych TR-100E. Przed opublikowaniem lub przekazaniem zrzutów ekranu należy ukryć kod PIN, numer seryjny, adres MAC i klucze. B.1 Ręczna konfiguracja WireGuard B.1.1 Wprowadzanie parametrów W przypadku konfiguracji statycznej administrator VPN powinien przekazać parametry WireGuard dla TR-100E i skonfigurować odpowiedni peer na zdalnym węźle. Otworzyć interfejs Web TR-100E i zalogować się z poziomem dostępu powerUser. Przejść do zakładki Ustawienia i rozwinąć sekcję VPN-WireGuard. Włączyć parametr Włączone. Wyłączyć parametr Automatyczne połączenie z serwerem Overvis. Pola konfiguracji statycznej staną się dostępne do edycji. Wprowadzić parametry przekazane przez administratora VPN: Pole Zawartość Klucz prywatny Klucz prywatny TR-100E w formacie Base64 Adres interfejsu Adres TR-100E wewnątrz VPN w formacie IPv4/CIDR, na przykład 10.8.0.2/24 Klucz publiczny peer Klucz publiczny zdalnego węzła w formacie Base64 Host peer Nazwa DNS lub adres IPv4 zdalnego węzła Port peer Port UDP zdalnego węzła, od 1 do 65535; wartość domyślna — 51820 Allowed IP 1, Allowed IP 2 Maksymalnie dwie sieci, do których ruch jest kierowany przez peer, w formacie IPv4/CIDR Keepalive (s) Interwał persistent keepalive od 1 do 300 s; wartość domyślna — 25 s Klucz prywatny, adres interfejsu, klucz publiczny i host peer są obowiązkowe. Dla adresu interfejsu używany jest prefiks od /1 do /32. Oba pola Allowed IP można pozostawić puste. Jeżeli nie określono żadnej dozwolonej sieci, TR-100E używa sieci określonej przez adres interfejsu. Jeżeli wypełniono jedno pole Allowed IP, używana jest wskazana w nim trasa. W bieżącej wersji oprogramowania układowego trasy z prefiksem /0 nie są stosowane; dla Allowed IP należy używać prefiksów od /1 do /32. Nacisnąć Zapisz w sekcji VPN-WireGuard. Usługa WireGuard zostanie automatycznie uruchomiona ponownie; ponowne uruchomienie TR-100E nie jest wymagane. Jeżeli przez statyczne połączenie VPN wymagany jest dostęp do interfejsu Web lub Modbus TCP, należy dodatkowo wykonać ustawienia opisane w krokach 5–11 p. B.2.2. Rysunek B.1 – statyczna konfiguracja WireGuard B.1.2 Sprawdzanie połączenia Przejść do zakładki Serwis, w bloku Diagnostyka wybrać Sieć → VPN i włączyć Autoodświeżanie. Dla poprawnie wypełnionej konfiguracji statycznej wyświetlane są: Usługa — Włączone; Tryb — Statyczny; Konfiguracja — Gotowe; Połączenie — Skonfigurowane, Połączone lub Aktywne. Pomyślna wymiana danych ze zdalnym węzłem jest potwierdzana stanem Połączone lub Aktywne, czasem w polu Handshake oraz wzrostem liczników pakietów RX/TX. Stan Nieprawidłowa konfiguracja oznacza, że co najmniej jeden parametr obowiązkowy nie został wypełniony: klucz prywatny, adres interfejsu, klucz publiczny lub host peer. Rysunek B.2 – stan statycznego połączenia WireGuard Jeżeli połączenie statyczne nie zostaje ustanowione: jeżeli wyświetlany jest stan Nieprawidłowa konfiguracja, sprawdzić, czy wypełniono klucz prywatny, adres interfejsu, klucz publiczny i host peer; porównać wszystkie parametry z konfiguracją zdalnego peer; w przypadku korzystania z nazwy DNS sprawdzić ustawienia DNS w sekcji Ustawienia → Sieć; sprawdzić dostępność hosta i portu UDP peer z sieci TR-100E; sprawdzić, czy trasy Allowed IP nie nakładają się w niezamierzony sposób na sieć lokalną; upewnić się, że zdalny peer jest skonfigurowany do pracy z kluczem i adresem VPN TR-100E. B.2 Automatyczna konfiguracja przez Overvis B.2.1 Sprawdzanie danych identyfikacyjnych Otworzyć interfejs Web TR-100E i zalogować się z poziomem dostępu powerUser. Przejść do zakładki Serwis. W bloku Informacje o urządzeniu upewnić się, że wskaźniki Klucz urządzenia i Zarejestrowano mają kolor zielony, a w polu Kod PIN jest wyświetlana wartość. Zapisać kod PIN (jest on również podany na naklejce urządzenia): kod będzie potrzebny do połączenia TR-100E z kontem Overvis. Rysunek B.3 – dane identyfikacyjne TR-100E B.2.2 Włączanie automatycznego połączenia Przejść do zakładki Ustawienia i rozwinąć sekcję VPN-WireGuard. Włączyć parametry Włączone i Automatyczne połączenie z serwerem Overvis. Pole URL serwera automatycznej konfiguracji pozostawić puste: w takim przypadku używany jest adres zapisany przez producenta. Pole należy wypełniać wyłącznie na polecenie pomocy technicznej. Nacisnąć Zapisz w sekcji VPN-WireGuard. Rysunek B.4 – konfiguracja automatycznego połączenia z Overvis Rozwinąć sekcję Serwer Web. Włączyć parametr Dostęp do Web przez VPN i ustawić parametr Domyślny poziom dostępu przez VPN na PowerUser. Nacisnąć Zapisz w sekcji Serwer Web. Rysunek B.5 – konfiguracja dostępu do interfejsu Web przez VPN Rozwinąć sekcję Modbus TCP. Włączyć parametr Włączone i dla parametru Dostęp do Modbus przez VPN wybrać wartość Odczyt i zapis. Ten poziom jest wymagany, aby Overvis HMI mógł nie tylko odczytywać, lecz także zmieniać parametry TR-100E. Dla parametru Tryb ochrony wybrać wartość Zapis. Zezwolenie na zapis przez VPN nie wyłącza ochrony lokalnego Modbus: klienci lokalni nadal będą wymagali odblokowania hasłem. Nacisnąć Zapisz w sekcji Modbus TCP. Poziom Odczyt i zapis zapewnia dostęp bez hasła każdej sesji Modbus TCP przyjętej przez interfejs VPN. Należy go używać wyłącznie z zaufaną konfiguracją WireGuard. Jeżeli zdalna zmiana parametrów nie jest wymagana, należy wybrać Tylko odczyt. Rysunek B.6 – konfiguracja dostępu do Modbus TCP przez VPN B.2.3 Kontrola automatycznego połączenia Po zapisaniu ustawień przejść do zakładki Serwis, w bloku Diagnostyka wybrać Sieć → VPN i włączyć Autoodświeżanie. Poczekać na zakończenie automatycznej konfiguracji. Oznaki gotowości do połączenia przez Overvis: Usługa — Włączone; Tryb — Auto; Konfiguracja — Gotowe; Połączenie — Połączone lub Aktywne; w polu Handshake wyświetlany jest czas ostatniej wymiany zamiast kreski. Po pojawieniu się tych stanów należy przejść do łączenia TR-100E z kontem Overvis HMI. Rysunek B.7 – gotowość WireGuard do połączenia przez Overvis B.2.4 Łączenie TR-100E z kontem Overvis HMI Przed kontynuowaniem należy upewnić się, że TR-100E jest połączony z Internetem, a automatyczna konfiguracja WireGuard została zakończona zgodnie z p. B.2.3. Przygotować 8-znakowy kod PIN podany na naklejce obudowy. W przeglądarce internetowej przejść do witryny Overvis HMI. Na stronie logowania w polu Email wprowadzić adres e-mail i nacisnąć Send code. W wyświetlonym polu wprowadzić jednorazowy kod z wiadomości e-mail. Jeżeli ten adres jest używany po raz pierwszy, Overvis HMI utworzy konto po jego potwierdzeniu. Oddzielne hasło nie jest wymagane. Kod jest ważny przez 10 minut i można go użyć tylko raz. Nowy kod można zamówić po minucie; wcześniej wydany kod przestanie wówczas działać. Podczas pierwszego logowania podać imię i nazwę organizacji. Overvis HMI utworzy pierwszy obszar roboczy na podstawie nazwy organizacji. Jeżeli obszar roboczy już istnieje, należy go otworzyć. Przejść do sekcji Konfiguracja ręczna → Połączenia i nacisnąć Utwórz połączenie. W polu Typ wybrać PIN. Dla tego typu połączenia używany jest port 502, dlatego pole Port nie jest wyświetlane. W polu Nazwa zastąpić tekst Nowe połączenie zrozumiałą nazwą, na przykład miejscem instalacji TR-100E. W polu Kod PIN wprowadzić kod z naklejki i nacisnąć Utwórz. Rysunek B.8 – tworzenie połączenia TR-100E za pomocą kodu PIN Potwierdzić posiadanie urządzenia: nacisnąć Tak na TR-100E lub wprowadzić w Overvis HMI kod wyświetlony na ekranie urządzenia. Poczekać na komunikat Połączenie utworzone. Na liście Połączenia wybrać utworzony wiersz. Na zakładce Połączenie upewnić się, że wyświetlany jest stan Połączono, a pole Aktywny adres jest wypełnione. W wierszu listy powinny być wyświetlane etykieta PIN, producent i kod modelu. Rysunek B.9 – TR-100E połączony z obszarem roboczym Po utworzeniu połączenia nie można zmienić Typu ani powiązanego urządzenia. Jeżeli kod PIN podano nieprawidłowo, połączenie należy usunąć i utworzyć ponownie. Samo to połączenie nie wyświetla temperatur: parametry TR-100E dodaje się oddzielnie. B.2.5 Dodawanie parametrów TR-100E z szablonu Po utworzeniu połączenia należy dodać parametry sterownika z szablonu Novatek-Electro TR-100E. Nie jest wymagane ponowne wprowadzanie adresu ani portu połączenia. W menu konfiguracji przejść do sekcji Parametry (Parameters). Nacisnąć Dodaj (Add) i wybrać Z szablonu… (From template…). W oknie Dodaj z szablonu (Add from template) wybrać szablon Novatek-Electro TR-100E z grupy Overvis. Sprawdzić pole Nazwa gałęzi głównej (Root branch name). W razie potrzeby zmienić proponowaną nazwę; pola nie można pozostawić pustego. Sprawdzić pole ID urządzenia (Unit ID). Szablon używa fabrycznego adresu Modbus TR-100E — 48. Jeżeli adres sterownika został zmieniony, należy podać jego bieżącą wartość. W polu Połączenie (Endpoint) wybrać utworzone wcześniej połączenie TR-100E. Nacisnąć Dodaj (Add). Nie jest wymagane oddzielne zapisywanie zmian. Rysunek B.10 – dodawanie parametrów TR-100E z szablonu Po zastosowaniu szablonu w drzewie Parametry pojawi się nowa gałąź główna z parametrami TR-100E. Aby sprawdzić wymianę danych ze sterownikiem, należy zaznaczyć nową gałąź i nacisnąć Odczytaj (Read). Po prawej stronie parametrów powinny pojawić się odebrane wartości. Aby włączyć ciągłe odpytywanie, należy włączyć Online (Live). Rysunek B.11 – sprawdzanie odczytu parametrów TR-100E Jeżeli zamiast wartości wyświetlany jest błąd, należy sprawdzić, czy pole ID urządzenia odpowiada adresowi Modbus sterownika oraz czy utworzone połączenie ma stan Połączono. Dodatkowe informacje podano w dokumentacji Overvis dotyczącej podłączania urządzeń.

Novatek-Electro TR-100E Documentation

HTTP API Interfejs HTTP API umożliwia komunikację z urządzeniem TR-100E. Wszystkie ścieżki żądań rozpoczynają się od /api/. Obsługiwane są metody GET i POST. Zasady ogólne Interfejs API przyjmuje i zwraca dane w formacie JSON (Content-Type: application/json), z wyjątkiem binarnych fragmentów aktualizacji OTA oraz odpowiedzi eksportu. Fragmenty aktualizacji OTA są przesyłane z nagłówkiem Content-Type: application/octet-stream. Punkty końcowe eksportu do formatu CSV zwracają nagłówek Content-Type: text/csv. Punkty końcowe eksportu do zwykłego tekstu zwracają nagłówek Content-Type: text/plain. Pomyślne odpowiedzi mają kod stanu 200 OK. W przypadku błędu zwracany jest odpowiedni kod stanu HTTP oraz obiekt JSON: { "error": "ERROR_CODE", "message": "Human readable text" }. Obsługiwane są trwałe połączenia HTTP. Maksymalny rozmiar nagłówka HTTP: 1380 bajtów. Maksymalny rozmiar treści żądania HTTP: 4096 bajtów. Maksymalny całkowity rozmiar żądania HTTP: 5476 bajtów. Poziomy dostępu Poziom Opis 🟩 guest Klient nieuwierzytelniony 🟨 user Użytkownik standardowy 🟥 powerUser Użytkownik zaawansowany Poziom guest zapewnia dostęp wyłącznie do GET /api/auth/status/, GET /api/auth/salt/, GET /api/version/ oraz POST /api/auth/login/. Poziom user zapewnia dostęp do standardowych punktów końcowych, a także do service/time/sync. Poziom powerUser zapewnia pełny dostęp do wszystkich punktów końcowych. Wszystkie żądania POST /api/debug/*, z wyjątkiem /api/debug/display/start/ i /api/debug/display/stop/, wymagają dodatkowo trybu diagnostycznego. Tryb ten włącza się podczas uruchamiania urządzenia przez jednoczesne naciśnięcie przycisków Góra i Dół. W trybie normalnym żądania te zwracają 403 Forbidden. Ograniczenie nie dotyczy żądań GET /api/debug/*. Autoryzacja Pobierz wartość salt — GET /api/auth/salt/. Zaloguj się — wyślij wartość SHA256(username + password + salt) w żądaniu POST /api/auth/login/. Do wszystkich kolejnych żądań dołącz nagłówek Authorization: Bearer <token>. Wyloguj się — POST /api/auth/logout/. Uwierzytelnianie WWW używa dwóch niezależnych haseł: jednego dla poziomu user i jednego dla poziomu powerUser. Pobieranie i modyfikowanie ustawień dostępu opisano w settings-get.md i settings-set.md. Czas Bezwzględne znaczniki czasu są przesyłane wyłącznie w UTC+0, w formacie ISO 8601: 2026-04-16T12:34:56Z. Przedziały czasu i opóźnienia są liczbami całkowitymi wyrażonymi w sekundach lub minutach. Częściowe aktualizacje ustawień Żądanie POST /api/settings/set/ scala ustawienia według następujących zasad: zapisywane są tylko podane pola; pominięcie pola oznacza, że jego wartość nie zostanie zmieniona; tablice są zastępowane w całości; nieznane klucze powodują błąd 400 ERROR_INVALID_VALUE. Żądania GET Ścieżka Przeznaczenie Dostęp /api/version/ Identyfikacja urządzenia i wersja oprogramowania sprzętowego 🟩 guest /api/auth/status/ Bieżący poziom dostępu dla danego żądania 🟩 guest /api/auth/salt/ Pobranie wartości salt używanej do haszowania hasła 🟩 guest /api/state/get/?... Migawka stanu urządzenia podczas pracy, według grupy (device, network, relays, leds, protection, recorder, channels, log, ntp, httpd, modbus, wireguard) 🟨 user /api/settings/get/?... Pobranie ustawień według grupy 🟨 user /api/reference/sensor-types/ Lista obsługiwanych typów czujników 🟨 user /api/history/temperature/info/ Metadane okna historii bieżącej 🟨 user /api/history/temperature/samples/?... Bieżąca historia temperatury dla wszystkich kanałów 🟨 user /api/recorder/info/ Metadane rejestratora 🟨 user /api/recorder/records/?... Zarchiwizowane wpisy rejestratora 🟨 user /api/recorder/export.csv/ Eksport danych rejestratora do formatu CSV 🟨 user /api/log/info/ Podsumowanie dziennika zdarzeń 🟨 user /api/log/events/?... Zdarzenia zapisane w dzienniku 🟨 user /api/log/export.log/ Eksport dziennika w formacie tekstowym 🟨 user /api/debug/tasks/ Migawka zadań systemu RTOS 🟥 powerUser /api/debug/heap/ Stan sterty FreeRTOS/lwIP 🟥 powerUser /api/debug/system/ Diagnostyka systemu 🟥 powerUser /api/debug/settings/ Stan banku ustawień przechowywanych w pamięci trwałej 🟥 powerUser /api/debug/adc/ Surowe dane przetwornika ADC i dane pomiarowe 🟥 powerUser /api/debug/external-storage/ Informacje o pamięci zewnętrznej 🟥 powerUser /api/debug/external-storage/dump/ Pełny zrzut pamięci zewnętrznej 🟥 powerUser + tryb diagnostyczny /api/debug/network/ Diagnostyka stosu sieciowego 🟥 powerUser /api/debug/lwip-stats/ Liczniki lwIP (protokoły i pule memp) 🟥 powerUser /api/debug/menu/ Stan menu interfejsu użytkownika 🟥 powerUser /api/debug/keyget/ Stan przycisków fizycznych 🟥 powerUser /api/service/firmware/upload/status/ Stan sesji przesyłania aktualizacji OTA 🟥 powerUser /api/service/identity/get/ Bieżący stan danych identyfikacyjnych i blokady sprzętowej 🟥 powerUser /api/service/challenge/status/ Stan weryfikacji fizycznego dostępu przez Overvis WireGuard + 🟨 user /api/service/calibration/report/ Ostatnio zapisany raport kalibracji; klucz sprzętowy nie jest wymagany 🟥 powerUser /api/service/calibration/status/ Stan aktywnej sesji kalibracji i sygnał aktywności 🟥 powerUser + klucz sprzętowy Żądania POST Ścieżka Przeznaczenie Dostęp /api/auth/login/ Uwierzytelnienie użytkownika 🟩 guest /api/auth/logout/ Zakończenie sesji 🟨 user /api/settings/set/ Częściowa aktualizacja ustawień 🟥 powerUser /api/log/acknowledge/ Potwierdzenie wyświetlenia zdarzeń 🟨 user /api/recorder/clear/ Wyczyszczenie rejestratora 🟥 powerUser /api/log/clear/ Wyczyszczenie dziennika 🟥 powerUser /api/service/settings/reset/ Przywrócenie ustawień fabrycznych 🟥 powerUser /api/service/reboot/ Zaplanowanie ponownego uruchomienia 🟥 powerUser /api/service/time/set/ Ustawienie czasu systemowego 🟥 powerUser /api/service/time/sync/ Wymuszenie synchronizacji SNTP 🟨 user /api/service/identity/set/ Aktualizacja i zapis pól identyfikacyjnych 🟥 powerUser /api/service/challenge/set/ Ustawienie, zastąpienie lub wyzerowanie wyzwania Overvis WireGuard + 🟨 user /api/service/calibration/begin/ Rozpoczęcie sesji kalibracji 🟥 powerUser + klucz sprzętowy /api/service/calibration/range/ Wybór zakresu i punktu 🟥 powerUser + klucz sprzętowy /api/service/calibration/capture/ Zarejestrowanie czterech surowych wartości ADC i rozpoczęcie weryfikacji 🟥 powerUser + klucz sprzętowy /api/service/calibration/commit/ Zapisanie punktów i czterech migawek jakości 🟥 powerUser + klucz sprzętowy /api/service/calibration/finish/ Zakończenie sesji i zwolnienie toru pomiarowego 🟥 powerUser + klucz sprzętowy /api/service/firmware/upload/begin/ Rozpoczęcie przesyłania obrazu aktualizacji OTA 🟥 powerUser /api/service/firmware/upload/chunk/?offset= Zapisanie fragmentu obrazu aktualizacji OTA 🟥 powerUser /api/service/firmware/upload/finish/ Zakończenie przesyłania i weryfikacji 🟥 powerUser /api/service/firmware/upload/discard/ Usunięcie przesłanego obrazu aktualizacji OTA i wyzerowanie sesji przesyłania 🟥 powerUser /api/service/firmware/apply/ Zastosowanie aktualizacji OTA 🟥 powerUser /api/debug/relay/start/ Uruchomienie testu przekaźnika 🟥 powerUser /api/debug/relay/stop/ Zatrzymanie testu przekaźnika 🟥 powerUser /api/debug/led/start/ Uruchomienie testu diod LED 🟥 powerUser /api/debug/led/stop/ Zatrzymanie testu diod LED 🟥 powerUser /api/debug/display/start/ Uruchomienie testu wyświetlacza i przejęcie nad nim sterowania 🟥 powerUser /api/debug/display/stop/ Zatrzymanie testu wyświetlacza i zwolnienie sterowania 🟥 powerUser /api/debug/keypress/ Symulowanie naciśnięcia przycisku 🟥 powerUser Błędy i kody stanu HTTP błąd Przeznaczenie 400 ERROR_INVALID_ARGUMENT, ERROR_INVALID_VALUE, ERROR_API_PARSING Nieprawidłowe żądanie 401 ERROR_UNAUTHORIZED Brak prawidłowego uwierzytelnienia 403 ERROR_NO_ACCESS, ERROR_WRITE_PROTECT Niewystarczające uprawnienia 404 ERROR_NOT_FOUND Nie znaleziono zasobu 408 ERROR_TIMEOUT Przekroczono limit czasu operacji 429 ERROR_LOCKED Blokada po nieudanych próbach logowania 500 ERROR, ERROR_IO Błąd wewnętrzny 503 ERROR_NOT_READY Podsystem nie jest gotowy 507 ERROR_NO_MEMORY Niewystarczająca ilość pamięci Dokumentacja zaktualizowana: 2026-07-30

Novatek-Electro TR-100E Documentation

GET /api/version/ Podstawowy publiczny punkt końcowy służący do identyfikacji urządzenia i pobrania wersji oprogramowania układowego przed logowaniem. Uwierzytelnianie: niewymagane. Punkt końcowy nie zwraca poufnych ustawień, haseł, danych uwierzytelniających do sieci ani danych diagnostycznych. Odpowiedź 200 { "deviceId": 48, "deviceName": "TR-100E", "firmwareVersion": "1.0", "bootloaderVersion": "1.0" } Pola odpowiedzi Pole Typ Wymagane Opis deviceId liczba tak Numeryczny identyfikator typu urządzenia deviceName ciąg znaków tak Nazwa urządzenia firmwareVersion ciąg znaków tak Wersja oprogramowania układowego bootloaderVersion ciąg znaków | null tak Wersja programu rozruchowego opublikowana przez niego w rejestrze zapasowym RTC; null, jeśli program rozruchowy nie zgłosił wersji

Novatek-Electro TR-100E Documentation

GET /api/auth/status/ Zwróć bieżący poziom dostępu dla tego żądania. Uwierzytelnianie: niewymagane. Odpowiedź 200 { "accessLevel": "guest" } Pola odpowiedzi Pole Typ Wymagane Opis accessLevel ciąg znaków tak Bieżący poziom dostępu: guest, user lub powerUser Uwagi Jeśli sesja Bearer jest prawidłowa, punkt końcowy zwraca poziom dostępu tej sesji. Jeśli sesja Bearer nie jest obecna, punkt końcowy zwraca poziom dostępu anonimowego wyznaczony przez urządzenie: guest, user lub powerUser. Dostęp anonimowy może wynikać z trybu diagnostycznego, zaufanego dostępu przez VPN lub wyłączonej weryfikacji odpowiedniego hasła Web. Jeśli weryfikacja powerUser jest wyłączona, zwracana jest wartość powerUser; w przeciwnym razie, gdy wyłączona jest weryfikacja user, zwracana jest wartość user.

Novatek-Electro TR-100E Documentation

GET /api/auth/salt/ Pobiera wartość salt używaną do obliczenia skrótu hasła po stronie klienta. Uwierzytelnianie: niewymagane. Odpowiedź 200 { "salt": "sFtqKto6hnaURPGQLJOCT1QMx7myDEGLBsCz3a2L" } Pola odpowiedzi Pole Typ Wymagane Opis salt ciąg znaków tak 40-znakowy ciąg znaków ASCII Wymagania dotyczące wartości salt Długość: 40 znaków. Dozwolone znaki: [A-Za-z0-9]. Sól traci ważność po każdej próbie POST /api/auth/login/, niezależnie od jej wyniku. Przed każdą próbą logowania należy pobrać nową sól.

Novatek-Electro TR-100E Documentation

POST /api/auth/login/ Utwórz uwierzytelnioną sesję. Uwierzytelnianie: niewymagane. Żądanie { "username": "tr100e", "passwordHash": "6c2a6f1f6f1edc1c6b7b5d3f7c6c8ce6e1f6bb3f4c1f9c0b0c2d5e8f7a9b3c4d" } Pola żądania Pole Typ Wymagane Opis username ciąg znaków tak Nazwa użytkownika; musi mieć wartość "tr100e" passwordHash ciąg znaków tak Szesnastkowy skrót SHA-256 o długości 64 znaków Wzór skrótu SHA256(username + password + salt) gdzie wartość salt jest pobierana za pomocą GET /api/auth/salt/. Ważne: wartość salt jest jednorazowa i traci ważność po każdej próbie logowania. Przed ponowną próbą logowania należy pobrać nową wartość. Wartość passwordHash jest najpierw porównywana z hasłem powerUser, następnie z hasłem user. Pole accessLevel w odpowiedzi odpowiada pasującemu hasłu. Jeśli weryfikacja hasła interfejsu Web jest wyłączona za pomocą ustawienia webPwrPassEnable lub webUserPassEnable, urządzenie może przyznać odpowiedni poziom dostępu anonimowego bez żądania logowania. Poziom ten można ustalić za pomocą GET /api/auth/status/. Wyłączenie weryfikacji powerUser ma pierwszeństwo przed wyłączeniem weryfikacji user. Odpowiedź 200 { "authType": "Bearer", "token": "ej5k2pVg4Pd8yBdUqFPq8bdaStpeAZhyelpmkhtOivdK8r7E", "ttlSec": 60, "accessLevel": "user" } Pola odpowiedzi Pole Typ Wymagane Opis authType ciąg znaków tak Zawsze "Bearer" token ciąg znaków tak 48-znakowy ciąg znaków ASCII [A-Za-z0-9] ttlSec liczba tak Czas trwania sesji w sekundach accessLevel ciąg znaków tak "user" lub "powerUser" Ochrona przed atakami siłowymi Jeden licznik nieudanych prób jest współdzielony przez wszystkie interfejsy (Web, klawiaturę i Modbus). Po 5 nieudanych próbach wszystkie interfejsy zostają zablokowane na 300 sekund. Licznik jest zerowany po 300 sekundach bezczynności lub po pomyślnym logowaniu. Stan jest przechowywany w rejestrach zapasowych RTC i zachowywany po wyłączeniu zasilania. Odpowiedź 401 (nieprawidłowe hasło) { "error": "ERROR_UNAUTHORIZED", "message": "3 attempts left" } Odpowiedź 429 (aktywna blokada) { "error": "ERROR_LOCKED", "message": "Retry after 247 seconds" }

Novatek-Electro TR-100E Documentation
POST /api/auth/logout/ Zamknij bieżącą sesję. Uwierzytelnianie: Bearer. Żądanie {} Treść żądania nie zawiera istotnych pól. Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation

GET /api/state/get/?device&network&relays&leds&protection&recorder&channels&log&ntp&httpd&modbus&wireguard Pobierz jedną albo więcej grup najwyższego poziomu stanu roboczego. Uwierzytelnianie: Bearer. Parametry zapytania Każdy klucz zapytania jest flagą żądającą odpowiedniej grupy. Prawidłowe klucze: device, network, relays, leds, protection, recorder, channels, log, ntp, httpd, modbus, wireguard Wymagany jest co najmniej jeden klucz. Nieznany klucz → 404 ERROR_NOT_FOUND. Brak kluczy → 400 ERROR_API_PARSING. Przekroczenie limitu pamięci → 507 ERROR_NO_MEMORY. Odpowiedź 200 { "device": { "uptimeSec": 123456, "dateTimeUtc": "2026-04-16T12:21:36Z", "localOffsetMin": 240, "dstActive": true, "deviceNeedReboot": false, "isDiagnosticMode": false, "settingsValid": true, "calibrationValid": true, "rebootAfterSec": null }, "network": { "macAddress": "00:11:22:33:44:55", "isUnique": true, "ipAddress": "192.168.1.50", "subnetMask": "255.255.255.0", "gateway": "192.168.1.1", "dns": ["8.8.8.8", "8.8.4.4"], "dhcp": { "state": "bound", "serverAddress": "192.168.1.1", "leaseSeconds": 86400, "remainingSeconds": 43120 } }, "relays": { "trip": false, "alarm": false, "fan": false, "fault": false, "inTestMode": false }, "leds": { "inTestMode": false }, "protection": { "trip": false, "alarm": false, "fan": false, "fault": false }, "recorder": { "enabled": true, "available": true, "total": 1532, "periodSec": 600, "lastError": 0, "errorCount": 0 }, "channels": [ { "enabled": true, "temperature": "72.4", "minTemperature": "68.1", "maxTemperature": "74.9", "trend": "up", "circuitState": "normal", "trip": false, "alarm": false, "fan": false } ], "log": { "available": true, "total": 250, "lastTimestampUtc": "2026-04-16T12:00:00Z", "pending": 0 }, "ntp": { "enabled": true, "available": true, "lastSyncUtc": "2026-04-16T12:00:05Z", "syncCount": 15, "failCount": 0 }, "httpd": { "enabled": true, "available": true, "activeConnections": 2, "maxConnections": 5, "activeSessions": 1, "maxSessions": 5, "port": 80, "connections": [ { "ip": "192.168.1.10", "port": 50122 } ] }, "modbus": { "enabled": true, "available": true, "activeConnections": 1, "maxConnections": 5, "blockedIps": 0, "port": 502, "rxPackets": 120, "txPackets": 118, "rxErrors": 2, "txErrors": 0, "exceptionResp": 1, "rxBytes": 2048, "txBytes": 4096, "rxPerSec": 3, "txPerSec": 3, "connections": [ { "ip": "192.168.1.10", "port": 50123, "uptimeSec": 120, "unlocked": true, "rxPackets": 120, "txPackets": 118, "rxErrors": 2, "txErrors": 0, "exceptionResp": 1, "rxBytes": 2048, "txBytes": 4096, "rxPerSec": 3, "txPerSec": 3 } ] }, "wireguard": { "enabled": true, "mode": "auto", "status": { "link": "up", "config": "ready", "lastPeerUpUtc": "2026-05-21T10:00:00Z", "lastHandshakeAgeSec": 12, "lastActivityAgeSec": 2, "rxPackets": 1234, "txPackets": 567 }, "endpoint": { "hostname": "wg.example.net", "address": "1.2.3.4", "port": 51820, "keepaliveSec": 25, "peerPublicKey": "base64-public-key", "allowedIps": ["0.0.0.0/0", "10.20.0.0/16"] }, "interface": { "configured": "10.0.0.2/24", "runtime": "10.0.0.2/24", "devicePublicKey": "base64-device-public-key" } } } Zwracane są wyłącznie jawnie żądane grupy. Grupa device Pole Typ Opis uptimeSec liczba Czas pracy od włączenia zasilania (w sekundach) dateTimeUtc ciąg znaków Bieżący czas urządzenia w formacie ISO 8601 UTC localOffsetMin liczba Rzeczywiste przesunięcie czasu lokalnego w minutach, z uwzględnieniem czasu letniego dstActive wartość logiczna Określa, czy obowiązuje czas letni deviceNeedReboot wartość logiczna Określa, czy urządzenie wymaga ponownego uruchomienia isDiagnosticMode wartość logiczna Określa, czy podczas uruchamiania włączono tryb diagnostyczny przez naciśnięcie przycisków Up + Down settingsValid wartość logiczna Określa, czy zapisane ustawienia są prawidłowe calibrationValid wartość logiczna Określa, czy zapisana kalibracja fabryczna jest prawidłowa rebootAfterSec liczba|null Liczba sekund do zaplanowanego ponownego uruchomienia (null = nie zaplanowano) Grupa network Pole Typ Opis macAddress ciąg znaków Adres MAC isUnique wartość logiczna true = unikatowy EUI-48, false = adres zastępczy ipAddress ciąg znaków Adres IP subnetMask ciąg znaków Maska podsieci gateway ciąg znaków Brama dns ciąg[] Serwery DNS dhcp.state ciąg znaków Stan DHCP: off, configuring, searching, requesting, bound, renewing, rebinding, retrying dhcp.serverAddress ciąg znaków Adres IPv4 serwera DHCP dhcp.leaseSeconds liczba Pełny czas dzierżawy w sekundach dhcp.remainingSeconds liczba Pozostały czas dzierżawy w sekundach Grupa relays Pole Typ Opis trip wartość logiczna Stan przekaźnika wyłączenia awaryjnego alarm wartość logiczna Stan przekaźnika alarmu fan wartość logiczna Stan przekaźnika wentylatora fault wartość logiczna Stan przekaźnika usterki inTestMode wartość logiczna Określa, czy aktywny jest test serwisowy przekaźników Grupa leds Pole Typ Opis inTestMode wartość logiczna Określa, czy aktywny jest test serwisowy diod LED Grupa protection Pole Typ Opis trip wartość logiczna Logiczna flaga zabezpieczenia wyłączenia awaryjnego alarm wartość logiczna Logiczna flaga zabezpieczenia alarmowego fan wartość logiczna Logiczna flaga zabezpieczenia wentylatora fault wartość logiczna Logiczna flaga zabezpieczenia przed usterką Grupa recorder Pole Typ Opis enabled wartość logiczna Rejestrator jest włączony available wartość logiczna Rejestrator jest dostępny total liczba Liczba dostępnych rekordów periodSec liczba Bieżący okres rejestrowania (w sekundach) lastError liczba Kod ostatniego błędu errorCount liczba Liczba błędów Grupa channels Tablica 4 elementów (CH1..CH4). Pole Typ Opis enabled wartość logiczna Kanał jest włączony temperature ciąg|null Bieżąca temperatura (liczba dziesiętna z 1 cyfrą po przecinku), null, jeśli wartość jest nieprawidłowa minTemperature ciąg|null Temperatura minimalna maxTemperature ciąg|null Maksymalna temperatura trend ciąg znaków "up", "down", "stable" circuitState ciąg znaków "normal", "open", "short" trip wartość logiczna Kanał znajduje się w stanie wyłączenia awaryjnego alarm wartość logiczna Kanał znajduje się w stanie alarmu fan wartość logiczna Kanał znajduje się w stanie wentylatora Grupa log Pole Typ Opis available wartość logiczna Dziennik jest dostępny total liczba Liczba dostępnych zdarzeń lastTimestampUtc ciąg|null Znacznik czasu UTC ostatniego zdarzenia; null, jeśli dziennik jest pusty pending liczba Liczba niepotwierdzonych zdarzeń w bieżącej sesji zasilania Grupa ntp Pole Typ Opis enabled wartość logiczna NTP jest włączony w ustawieniach available wartość logiczna Klient NTP jest gotowy w bieżącym stanie roboczym lastSyncUtc ciąg|null Czas UTC ostatniej udanej synchronizacji; null, jeśli synchronizacja jeszcze nie nastąpiła syncCount liczba Liczba udanych synchronizacji od włączenia zasilania failCount liczba Liczba nieudanych prób od włączenia zasilania Grupa httpd Pole Typ Opis enabled wartość logiczna Serwer WWW jest włączony w ustawieniach available wartość logiczna Serwer HTTPD jest gotowy w bieżącym stanie roboczym activeConnections liczba Aktualnie aktywne połączenia TCP maxConnections liczba Maksymalna liczba jednoczesnych połączeń (stała) activeSessions liczba Aktualnie autoryzowane sesje maxSessions liczba Maksymalna liczba jednoczesnych sesji (stała) port liczba Port TCP serwera HTTP connections tablica Aktywne połączenia TCP connections[].ip ciąg znaków Adres IP klienta connections[].port liczba Port TCP klienta Grupa modbus Pole Typ Opis enabled wartość logiczna Modbus TCP jest włączony w ustawieniach available wartość logiczna Serwer Modbus TCP jest gotowy activeConnections liczba Bieżąca liczba aktywnych połączeń TCP maxConnections liczba Maksymalna liczba jednoczesnych połączeń blockedIps liczba Liczba adresów IP zablokowanych po nieudanych próbach podania hasła port liczba Port Modbus TCP rxPackets liczba Pakiety odebrane we wszystkich połączeniach od uruchomienia txPackets liczba Pakiety wysłane we wszystkich połączeniach od uruchomienia rxErrors liczba Błędy odbioru we wszystkich połączeniach od uruchomienia txErrors liczba Błędy transmisji we wszystkich połączeniach od uruchomienia exceptionResp liczba Odpowiedzi wyjątków Modbus wysłane od uruchomienia rxBytes liczba Bajty odebrane we wszystkich połączeniach od uruchomienia txBytes liczba Bajty wysłane we wszystkich połączeniach od uruchomienia rxPerSec liczba Bieżąca łączna szybkość odbioru w pakietach/s txPerSec liczba Bieżąca łączna szybkość transmisji w pakietach/s connections tablica Aktywne połączenia TCP connections[].ip ciąg znaków Adres IP klienta connections[].port liczba Port TCP klienta connections[].uptimeSec liczba Czas trwania połączenia w sekundach connections[].unlocked wartość logiczna Określa, czy chronione operacje są odblokowane dla połączenia connections[].rxPackets liczba Pakiety odebrane w ramach połączenia connections[].txPackets liczba Pakiety wysłane w ramach połączenia connections[].rxErrors liczba Błędy odbioru w ramach połączenia connections[].txErrors liczba Błędy transmisji w ramach połączenia connections[].exceptionResp liczba Odpowiedzi wyjątków Modbus wysłane w ramach połączenia connections[].rxBytes liczba Bajty odebrane w ramach połączenia connections[].txBytes liczba Bajty wysłane w ramach połączenia connections[].rxPerSec liczba Bieżąca szybkość odbioru dla połączenia w pakietach/s connections[].txPerSec liczba Bieżąca szybkość transmisji dla połączenia w pakietach/s Grupa wireguard Pole Typ Opis enabled wartość logiczna WG jest włączony w ustawieniach mode ciąg znaków Tryb konfiguracji: "auto" albo "static" status obiekt Skrócony stan działania WireGuard endpoint obiekt Punkt końcowy zdalnego partnera interface obiekt Odwzorowanie skonfigurowanego i roboczego interfejsu wireguard.status Pole Typ Opis link ciąg znaków Stan łącza: "disabled", "netif", "configured", "connected", "up" config ciąg znaków Stan konfiguracji: "disabled", "staticInvalid", "pause", "serverResolving", "serverConnecting", "discoverWait", "connectWait", "peerResolving", "ready" lastPeerUpUtc ciąg|null Czas UTC, gdy partner był ostatnio aktywny; null, jeśli nigdy nie był aktywny lastHandshakeAgeSec liczba|null Czas od ostatniego uzgodnienia lub pakietu podtrzymującego partnera w sekundach; null, jeśli brak lastActivityAgeSec liczba|null Czas od ostatniej aktywności partnera (handshake/keepalive, RX albo TX) w sekundach; null, jeśli brak rxPackets liczba Pakiety odebrane przez tunel WG txPackets liczba Pakiety wysłane przez tunel WG wireguard.endpoint Pole Typ Opis hostname ciąg|null Nazwa hosta punktu końcowego address ciąg|null Rozpoznany adres IP punktu końcowego port liczba|null Port punktu końcowego keepaliveSec liczba|null Bieżący interwał podtrzymywania połączenia z partnerem w sekundach peerPublicKey ciąg|null Klucz publiczny partnera allowedIps tablica Dozwolone sieci partnera w formacie IPv4 CIDR wireguard.interface Pole Typ Opis configured ciąg|null Skonfigurowany adres interfejsu w notacji CIDR runtime ciąg|null Rzeczywisty aktywny adres interfejsu w notacji CIDR devicePublicKey ciąg|null Klucz publiczny urządzenia

Novatek-Electro TR-100E Documentation

GET /api/settings/get/?meta&general&dateTime&display&access&recorder&network&ntp&web&modbus&vpnWireguard&channels&protection Pobierz jedną albo więcej grup najwyższego poziomu ustawień trwałych. Uwierzytelnianie: Bearer. Hasła grupy access są przeznaczone wyłącznie do zapisu i nie są uwzględniane w odpowiedziach na żadnym poziomie dostępu. Klucz prywatny vpnWireguard.privateKey jest zwracany tylko użytkownikowi powerUser; dla użytkownika user pole ma wartość null. Parametry zapytania Każdy klucz zapytania jest flagą żądającą odpowiedniej grupy. Prawidłowe klucze: meta, general, dateTime, display, access, recorder, network, ntp, web, modbus, vpnWireguard, channels, protection Wymagany jest co najmniej jeden klucz. Nieznany klucz → 404 ERROR_NOT_FOUND. Brak kluczy → 400 ERROR_API_PARSING. Przekroczenie limitu pamięci → 507 ERROR_NO_MEMORY. Odpowiedź 200 { "meta": { "sequence": 1, "fwVersion": "1.0", "isDefault": false, "savedAt": "2026-04-16T15:00:00Z", "dataLength": 512, "dataCrc32": "075bcd15", "headerCrc32": "3ade68b1" }, "general": { "language": "en", "logDebugMask": 0 }, "dateTime": { "timezoneOffset": 180, "dst": { "mode": 0, "deltaMin": 60, "startLocal": "2026-03-29T03:00:00", "endLocal": "2026-10-25T03:00:00" } }, "display": { "contrast": 50, "activeBacklightPercent": 80, "idleBacklightEnable": false, "idleBacklightPercent": 20, "idleTimeoutSec": 300 }, "access": { "devPasswordEnable": true, "webUserPassEnable": true, "webPwrPassEnable": true, "modbusPasswordEnable": true }, "recorder": { "enabled": false, "periodSec": 600 }, "network": { "enabled": true, "dhcpEnable": true, "dns": ["8.8.8.8", "8.8.4.4"], "ipAddress": "192.168.1.50", "subnetMask": "255.255.255.0", "gateway": "192.168.1.1" }, "ntp": { "enabled": true, "syncPeriodSec": 3600, "server1": "pool.ntp.org", "server2": "time.google.com" }, "web": { "enabled": true, "port": 80, "vpnTrusted": false, "vpnAccessLevel": 1 }, "modbus": { "enabled": false, "unitId": 1, "port": 502, "timeoutSec": 90, "protectMode": 0, "vpnAccessLevel": 0 }, "vpnWireguard": { "enabled": false, "autoConfigEnable": false, "autoConfigUrl": "https://overvis.io:4359/api/handshake/", "privateKey": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "address": "10.0.0.2/24", "peerPublicKey": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "peerHostname": "vpn.example.com", "peerPort": 51820, "allowedIps": ["0.0.0.0/0", "0.0.0.0/0"], "keepaliveSec": 25 }, "channels": { "filterLevel": 1, "items": [ { "enabled": true, "sensorTypeId": 1, "userOffset": 0, "ptcMinikaNominal": 0, "linked": 0 } ] }, "protection": { "trip": { "delaySec": 1, "channels": [{ "threshold": 120, "hysteresis": 5 }] }, "alarm": { "delaySec": 1, "channels": [{ "threshold": 100, "hysteresis": 5 }] }, "fan": { "mode": 1, "delaySec": 1, "channels": [{ "threshold": 80, "hysteresis": 5 }] }, "fault": { "delaySec": 1 } } } Zwracane są tylko jawnie żądane grupy. Grupa meta Pole Typ Opis sequence liczba Numer sekwencyjny zapisu ustawień fwVersion ciąg znaków Wersja oprogramowania układowego, które utworzyło migawkę isDefault wartość logiczna Określa, czy są to ustawienia domyślne savedAt ciąg znaków Czas ostatniego zapisu (ISO 8601 UTC) dataLength liczba Długość danych dataCrc32 ciąg znaków Suma CRC32 danych (zapis szesnastkowy, 8 znaków) headerCrc32 ciąg znaków Suma CRC32 nagłówka (zapis szesnastkowy, 8 znaków) Grupa general Pole Typ Opis language ciąg znaków Język interfejsu logDebugMask liczba Maska bitowa modułów dziennika debugowania (bit0 = WireGuard) Grupa dateTime Pole Typ Opis timezoneOffset liczba Przesunięcie strefy czasowej w minutach dst obiekt Ustawienia czasu letniego dst.mode liczba Tryb czasu letniego dst.deltaMin liczba Wartość przesunięcia w minutach dst.startLocal ciąg znaków Początek czasu letniego (czas lokalny) dst.endLocal ciąg znaków Koniec czasu letniego (czas lokalny) Grupa display Pole Typ Opis contrast liczba Kontrast activeBacklightPercent liczba Jasność aktywnego podświetlenia, % idleBacklightEnable wartość logiczna Określa, czy podświetlenie jest przyciemniane w stanie bezczynności idleBacklightPercent liczba Jasność podświetlenia w stanie bezczynności, % idleTimeoutSec liczba Czas bezczynności przed przyciemnieniem w sekundach Grupa access Pole Typ Opis devPasswordEnable wartość logiczna Wymaga hasła przy wejściu do menu lokalnego webUserPassEnable wartość logiczna Wymaga hasła dostępu WWW na poziomie user webPwrPassEnable wartość logiczna Wymaga hasła dostępu WWW na poziomie powerUser modbusPasswordEnable wartość logiczna Wymaga hasła do odblokowania chronionych operacji Modbus TCP Pola devPassword, webUserPass, webPwrPass i modbusPassword są celowo pomijane w odpowiedzi. Interfejs API nie ujawnia ani zapisanych haseł, ani informacji o ustawieniu wartości niestandardowej. Klienci muszą używać wyłącznie flag ...PasswordEnable jako informacji o stanie ochrony. Na poziomie user flagi te są zwracane jako null; ich wartości są dostępne dla powerUser. Grupa recorder Pole Typ Opis enabled wartość logiczna Rejestrowanie temperatury jest włączone periodSec liczba Okres rejestrowania w sekundach Grupa network Pole Typ Opis enabled wartość logiczna Ethernet jest włączony dhcpEnable wartość logiczna DHCP jest włączony dns ciąg[] Serwery DNS ipAddress ciąg znaków Statyczny adres IP subnetMask ciąg znaków Maska podsieci gateway ciąg znaków Brama Grupa ntp Pole Typ Opis enabled wartość logiczna NTP jest włączony syncPeriodSec liczba Okres synchronizacji (w sekundach) server1 ciąg znaków Główny serwer NTP server2 ciąg znaków Zapasowy serwer NTP Grupa web Pole Typ Opis enabled wartość logiczna Serwer WWW jest włączony port liczba Port HTTP vpnTrusted wartość logiczna Zezwala na zaufany dostęp WWW przez VPN vpnAccessLevel liczba Dostęp przez VPN: 0 = standardowa autoryzacja hasłem, 1 = user, 2 = powerUser Grupa modbus Pole Typ Opis enabled wartość logiczna Modbus TCP jest włączony unitId liczba Identyfikator jednostki port liczba Port TCP timeoutSec liczba Limit czasu (w sekundach) protectMode liczba Tryb ochrony: 0 = brak, 1 = ochrona zapisu, 2 = ochrona odczytu i zapisu vpnAccessLevel liczba Dostęp przez VPN: 0 = wyłączony, 1 = korzysta z ochrony ogólnej, 2 = tylko odczyt, 3 = odczyt i zapis Grupa vpnWireguard Pole Typ Opis enabled wartość logiczna WireGuard jest włączony autoConfigEnable wartość logiczna Tryb automatycznej konfiguracji Overvis (parametry są pobierane z chmury przy użyciu tożsamości urządzenia) autoConfigUrl ciąg znaków Adres URL serwera automatycznej konfiguracji privateKey ciąg znaków Statyczny klucz prywatny WireGuard w formacie base64 address ciąg znaków Adres lokalnego interfejsu w notacji CIDR, na przykład 10.0.0.2/24 peerPublicKey ciąg znaków Statyczny klucz publiczny elementu równorzędnego WireGuard w formacie base64 peerHostname ciąg znaków Nazwa hosta partnera peerPort liczba Port partnera allowedIps ciąg[] Dokładnie 2 trasy CIDR partnera keepaliveSec liczba Stały interwał podtrzymywania połączenia w sekundach Gdy autoConfigEnable = false, używane są wszystkie statyczne pola vpnWireguard, w tym klucze i punkt końcowy. Gdy autoConfigEnable = true, statyczne pola vpnWireguard są ignorowane podczas działania; WireGuard/Overvis pobiera parametry za pośrednictwem interfejsu API tożsamości usługi na potrzeby automatycznej konfiguracji. Grupa channels Pole Typ Opis filterLevel liczba Poziom filtrowania items tablica Tablica 4 kanałów channels.items[] Pole Typ Opis enabled wartość logiczna Kanał jest włączony sensorTypeId liczba Identyfikator typu czujnika (patrz /api/reference/sensor-types/) userOffset liczba Przesunięcie użytkownika ptcMinikaNominal liczba Wartość nominalna PTC Minika linked liczba Przynależność do wspólnej grupy progu i histerezy TRIP/ALARM/FAN: 0 = niezależny, 1 = połączony Grupa protection protection.trip / protection.alarm Pole Typ Opis delaySec liczba Opóźnienie aktywacji (w sekundach) channels tablica Wartości zadane poszczególnych kanałów (4 elementy) protection.trip.channels[] / protection.alarm.channels[] Pole Typ Opis threshold liczba Wartość zadana temperatury hysteresis liczba Histereza protection.fan Pole Typ Opis mode liczba Tryb pracy delaySec liczba Opóźnienie aktywacji (w sekundach) channels tablica Wartości zadane poszczególnych kanałów (4 elementy) protection.fault Pole Typ Opis delaySec liczba Opóźnienie aktywacji (w sekundach) Zakresy i ograniczenia Poniższe zakresy odpowiadają ograniczeniom oprogramowania układowego w Application/User/settings.h. general.language: en | pl | ua | ru. general.logDebugMask: 0..65535 (maska bitowa). dateTime.timezoneOffset: -720..840 minut. dateTime.dst.mode: 0..3 (OFF, EU, US, MANUAL). dateTime.dst.deltaMin: 0..180 minut. display.contrast: 0..64. display.activeBacklightPercent: 0..100. display.idleBacklightEnable: true | false. display.idleBacklightPercent: 0..100. display.idleTimeoutSec: 30..3600 sekund. access.devPasswordEnable, access.webUserPassEnable, access.webPwrPassEnable, access.modbusPasswordEnable: true | false. Hasła grupy access nie są zwracane przez ten punkt końcowy; ograniczenia ich zapisu opisano w POST /api/settings/set/. recorder.enabled: true | false. recorder.periodSec: 5..3600 sekund. ntp.syncPeriodSec: 300..86400 sekund. ntp.server1, ntp.server2: maksymalnie 31 znaków każdy. web.port: 1..65535. web.vpnTrusted: true | false. web.vpnAccessLevel: 0..2 (password, user, powerUser); 0 używa standardowej autoryzacji hasłem. modbus.unitId: 0..247; 0 — akceptuje żądania z dowolnym identyfikatorem jednostki. modbus.port: 1..65535. modbus.timeoutSec: 1..3600 sekund. modbus.protectMode: 0..2 (none, write-protect, read-write-protect). modbus.vpnAccessLevel: 0..3 (disabled, password, read-only, read-write). vpnWireguard.peerPort: 1..65535. vpnWireguard.keepaliveSec: 1..300 sekund. channels.filterLevel: 1..10. channels.items[].sensorTypeId: 0..MSR_SENSOR_COUNT-1; prawidłowe wartości są udostępniane przez GET /api/reference/sensor-types/. channels.items[].userOffset: -10.0..10.0 °C. channels.items[].ptcMinikaNominal: 60.0..180.0 °C. channels.items[].linked: 0..1. protection.trip.delaySec, protection.alarm.delaySec, protection.fan.delaySec, protection.fault.delaySec: 0..60 sekund. protection.trip.channels[].threshold, protection.alarm.channels[].threshold, protection.fan.channels[].threshold: -40.0..240.0 °C. protection.trip.channels[].hysteresis, protection.alarm.channels[].hysteresis, protection.fan.channels[].hysteresis: 0.0..100.0 °C. protection.fan.mode: 0..3.

Novatek-Electro TR-100E Documentation

POST /api/settings/set/ Częściowo zaktualizuj zapisane ustawienia (semantyka scalania). Uwierzytelnianie: Bearer (powerUser). Żądanie { "access": { "devPasswordEnable": true, "devPassword": "Ab12", "webUserPassEnable": true, "webPwrPassEnable": true, "modbusPasswordEnable": true }, "network": { "dhcpEnable": false, "ipAddress": "192.168.1.77", "subnetMask": "255.255.255.0", "gateway": "192.168.1.1" }, "vpnWireguard": { "enabled": true, "autoConfigEnable": false, "privateKey": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "address": "10.8.0.2/24", "peerPublicKey": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "peerHostname": "vpn.example.com", "peerPort": 51820, "allowedIps": ["0.0.0.0/0", "10.20.0.0/16"], "keepaliveSec": 25 }, "recorder": { "enabled": true, "periodSec": 120 } } Pola żądania Wszystkie grupy najwyższego poziomu są opcjonalne: general, dateTime, display, access, recorder, network, ntp, web, modbus, vpnWireguard, channels, protection. Grupa meta jest przeznaczona tylko do odczytu. Obiekty zagnieżdżone są aktualizowane częściowo (scalane). Pominięcie pola hasła oznacza „nie zmieniaj hasła”. Tablice są zastępowane w całości: network.dns, vpnWireguard.allowedIps, channels.items, protection.trip.channels, protection.alarm.channels, protection.fan.channels. Walidacja Nieznane klucze są niedozwolone → 400 ERROR_INVALID_VALUE. Typ wartości musi być zgodny ze schematem. Tablice kanałów muszą mieć długość 4. sensorTypeId musi odpowiadać wartości z GET /api/reference/sensor-types/. Treść żądania ≤ 4096 bajtów. Ograniczenia pól zapisywalnych Poniższe ograniczenia odpowiadają walidacji oprogramowania układowego w Application/User/settings.h. general.logDebugMask: 0..65535 (maska bitowa, bit0 = WireGuard). dateTime.timezoneOffset: -720..840 minut. dateTime.dst.mode: 0..3. dateTime.dst.deltaMin: 0..180 minut. display.contrast: 0..64. display.activeBacklightPercent: 0..100. display.idleBacklightEnable: true | false. display.idleBacklightPercent: 0..100. display.idleTimeoutSec: 30..3600 sekund. access.devPasswordEnable, access.webUserPassEnable, access.webPwrPassEnable, access.modbusPasswordEnable: true | false; false wyłącza weryfikację odpowiedniego hasła bez usuwania zapisanej wartości. access.devPassword: ciąg o długości 4..23 znaków. access.webUserPass, access.webPwrPass, access.modbusPassword: ciąg o długości 8..23 znaków. Dozwolone znaki hasła: cyfry 0–9, litery alfabetu łacińskiego A–Z, a–z oraz znaki ., -, _, :, /, @. Hasło null, pusty ciąg, wartość zbyt krótka lub zbyt długa albo nieprawidłowy znak → 400 ERROR_INVALID_VALUE. Aby pozostawić hasło bez zmian, pomiń to pole. Stan ochrony zmienia się niezależnie za pomocą odpowiedniej flagi ...PasswordEnable. recorder.enabled: true | false. recorder.periodSec: 5..3600 sekund. ntp.syncPeriodSec: 300..86400 sekund. ntp.server1, ntp.server2: maksymalnie 31 znaków każdy. web.port: 1..65535. web.vpnTrusted: true | false. web.vpnAccessLevel: 0..2 (password, user, powerUser); 0 używa standardowej autoryzacji hasłem. modbus.unitId: 0..247; 0 — akceptuje żądania z dowolnym identyfikatorem jednostki. modbus.port: 1..65535. modbus.timeoutSec: 1..3600 sekund. modbus.protectMode: 0..2 (none, write-protect, read-write-protect). modbus.vpnAccessLevel: 0..3 (disabled, password, read-only, read-write). vpnWireguard.autoConfigEnable: true | false. vpnWireguard.autoConfigUrl: adres URL serwera automatycznej konfiguracji. vpnWireguard.privateKey: ciąg base64 WireGuard dla statycznego klucza prywatnego. Pusty ciąg "" usuwa klucz. vpnWireguard.address: ciąg IPv4 CIDR, na przykład 10.8.0.2/24. Pusty ciąg "" usuwa adres. vpnWireguard.peerPublicKey: ciąg base64 WireGuard dla statycznego klucza publicznego partnera. Pusty ciąg "" usuwa klucz. vpnWireguard.peerHostname: nazwa hosta partnera. vpnWireguard.peerPort: 1..65535. vpnWireguard.allowedIps: tablica 2 ciągów IPv4 CIDR. Pusty ciąg "" usuwa element. vpnWireguard.keepaliveSec: 1..300 sekund. channels.filterLevel: 1..10. channels.items[].userOffset: -10.0..10.0 °C. channels.items[].ptcMinikaNominal: 60.0..180.0 °C. channels.items[].linked: 0..1; gdy próg albo histereza TRIP/ALARM/FAN zostaną zapisane dla kanału połączonego, wartość jest automatycznie kopiowana do wszystkich połączonych kanałów. protection.trip.delaySec, protection.alarm.delaySec, protection.fan.delaySec, protection.fault.delaySec: 0..60 sekund. protection.trip.channels[].threshold, protection.alarm.channels[].threshold, protection.fan.channels[].threshold: -40.0..240.0 °C. protection.trip.channels[].hysteresis, protection.alarm.channels[].hysteresis, protection.fan.channels[].hysteresis: 0.0..100.0 °C. protection.fan.mode: 0..3. Odpowiedź 200 {} Gdy vpnWireguard.autoConfigEnable = false, statyczne parametry WireGuard z vpnWireguard są zapisywane i używane. Gdy vpnWireguard.autoConfigEnable = true, statyczne parametry WireGuard mogą pozostać zapisane w ustawieniach, ale są ignorowane podczas działania; konfiguracja jest pobierana z interfejsu API tożsamości usługi w trybie Overvis.

Novatek-Electro TR-100E Documentation

GET /api/reference/sensor-types/ Pobierz listę obsługiwanych typów czujników. Uwierzytelnianie: Bearer. Odpowiedź 200 { "items": [ { "id": 0, "shortName": "PT100_13850", "description": "Pt100 (W100=138.5 ohm ref)" }, { "id": 1, "shortName": "PT100_13910", "description": "Pt100 (W100=139.1 ohm ref)" } ] } Pola odpowiedzi Pole Typ Wymagane Opis items tablica tak Lista typów items[].id liczba tak Identyfikator liczbowy items[].shortName ciąg znaków tak Skrócona nazwa czujnika items[].description ciąg znaków tak Opis czujnika

Novatek-Electro TR-100E Documentation

GET /api/history/temperature/info/ Pobiera metadane okna bieżącej historii bez tablicy próbek. Uwierzytelnianie: Bearer. Odpowiedź 200 { "capacity": 120, "periodSec": 5, "total": 120, "lastSequence": 1236 } Pola odpowiedzi Pole Typ Wymagane Opis capacity liczba tak Maksymalna pojemność bufora cyklicznego na kanał periodSec liczba tak Interwał rejestrowania próbek w sekundach total liczba tak Bieżąca liczba prawidłowych próbek lastSequence liczba tak Numer sekwencyjny najnowszej próbki

Novatek-Electro TR-100E Documentation

GET /api/history/temperature/samples/?page=1&pageSize=2&direct=desc Pobiera stronę zsynchronizowanych próbek historii dla wszystkich czterech kanałów. Uwierzytelnianie: Bearer. Parametry zapytania Parametr Typ Wymagane Domyślnie Opis page liczba nie* — Numer strony, począwszy od 1. Używany tylko w pierwszym żądaniu serii. Ignorowany, jeśli podano cursor. pageSize liczba tak — Liczba próbek na stronę. Prawidłowy zakres: 1..20. direct ciąg znaków nie "desc" Kierunek sortowania: "asc" — od najstarszych do najnowszych; "desc" — od najnowszych do najstarszych. cursor liczba nie* — Kursor służący do kontynuowania zapytania. Zobacz poniżej. *Wymagany jest parametr page albo cursor. cursor Kursor zapewnia stabilną, sekwencyjną paginację bez duplikatów ani luk. Pierwsze żądanie w serii: klient wysyła page=1 i pomija cursor. Serwer rozpoczyna zapytanie od lastSequence (desc) albo oldestSequence (asc). Odpowiedź zawiera nextCursor, czyli pozycję, od której należy kontynuować. Kolejne żądania: klient wysyła cursor z poprzedniej odpowiedzi; parametr page jest ignorowany. Koniec zapytania: nextCursor: null oznacza, że nie ma więcej dostępnych danych. Nowa seria (podczas przechodzenia do innej strony interfejsu): klient resetuje cursor i ponownie rozpoczyna od page=1. Odpowiedź 200 { "nextCursor": 1234, "periodSec": 5, "lastSequence": 1236, "samples": [ { "sequence": 1236, "channels": [ { "state": "normal", "temperature": 72.5 }, { "state": "normal", "temperature": 72.7 }, { "state": "invalid", "temperature": null }, { "state": "normal", "temperature": 68.2 } ] }, { "sequence": 1235, "channels": [ { "state": "normal", "temperature": 72.4 }, { "state": "normal", "temperature": 72.6 }, { "state": "invalid", "temperature": null }, { "state": "normal", "temperature": 68.1 } ] } ], "sampleCount": 2 } Pola odpowiedzi Pole Typ Opis nextCursor liczba|null Kursor dla następnego żądania. null, jeśli osiągnięto koniec zapytania. periodSec liczba Interwał rejestrowania historii w sekundach. lastSequence liczba Bieżący monotoniczny numer sekwencyjny w chwili wysłania żądania. samples tablica Próbki w kolejności określonej przez direct (0..pageSize elementów). sampleCount liczba Liczba próbek w bieżącym zestawie wyników. Jeśli nie ma więcej dostępnych danych, odpowiedź zawiera sampleCount: 0, samples: [] oraz nextCursor: null. Nie jest to błąd. samples[] Pole Typ Opis sequence liczba Numer sekwencyjny tej próbki. channels tablica 4 elementy (CH1..CH4). samples[].channels[] Pole Typ Opis state ciąg znaków "normal", "open", "short", "invalid" temperature liczba|null Temperatura (null, jeśli wartość jest nieprawidłowa) Scenariusz: wypełnienie okna interfejsu 60 próbkami (3 żądania po 20) GET /api/history/temperature/samples/?page=1&pageSize=20&direct=desc → { "nextCursor": 1216, "sampleCount": 20, "samples": [...] } GET /api/history/temperature/samples/?cursor=1216&pageSize=20&direct=desc → { "nextCursor": 1196, "sampleCount": 20, "samples": [...] } GET /api/history/temperature/samples/?cursor=1196&pageSize=20&direct=desc → { "nextCursor": null, "sampleCount": 20, "samples": [...] } Pierwsze żądanie używa page=1; kolejne używają parametru cursor z poprzedniej odpowiedzi.

Novatek-Electro TR-100E Documentation

GET /api/recorder/info/ Pobiera metadane rejestratora bez tablicy rekordów. Uwierzytelnianie: Bearer. Odpowiedź 200 { "capacity": 16384, "total": 1532, "oldestSequence": 3, "lastSequence": 1534, "period": 30 } Pola odpowiedzi Pole Typ Wymagane Opis capacity liczba tak Maksymalna pojemność bufora cyklicznego total liczba tak Liczba dostępnych zarchiwizowanych rekordów oldestSequence liczba tak Numer sekwencyjny najstarszego rekordu lastSequence liczba tak Numer sekwencyjny najnowszego rekordu period liczba tak Skonfigurowany interwał rejestrowania w sekundach (1..3600); rejestrowanie włącza się niezależnie za pomocą ustawienia tempRecordEnable

Novatek-Electro TR-100E Documentation

GET /api/recorder/records/?page=1&pageSize=2&direct=desc Pobiera stronę zarchiwizowanych wpisów rejestratora. Uwierzytelnianie: Bearer. Parametry zapytania Parametr Typ Wymagane Domyślnie Opis page liczba nie* — Numer strony, począwszy od 1. Używany tylko w pierwszym żądaniu serii. Ignorowany, jeśli podano cursor. pageSize liczba tak — Liczba rekordów na stronę. Prawidłowy zakres: 1..8. direct ciąg znaków nie "desc" Kierunek sortowania: "asc" — od najstarszych do najnowszych; "desc" — od najnowszych do najstarszych. cursor liczba nie* — Kursor służący do kontynuowania zapytania. Zobacz poniżej. *Wymagany jest parametr page albo cursor. cursor Kursor zapewnia stabilną, sekwencyjną paginację bez duplikatów ani luk. Pierwsze żądanie w serii: klient wysyła page=1 i pomija cursor. Serwer rozpoczyna zapytanie od lastSequence (desc) albo oldestSequence (asc). Odpowiedź zawiera nextCursor, czyli pozycję, od której należy kontynuować. Kolejne żądania: klient wysyła cursor z poprzedniej odpowiedzi; parametr page jest ignorowany. Koniec zapytania: nextCursor: null oznacza, że nie ma więcej dostępnych danych. Nowa seria (podczas przechodzenia do innej strony interfejsu): klient resetuje cursor i ponownie rozpoczyna od page=1. Odpowiedź 200 { "nextCursor": 1532, "recordCount": 2, "records": [ { "sequence": 1534, "timestamp": "2026-04-16T12:01:00Z", "channels": [ { "state": "normal", "temperature": 72.6, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 68.3, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 65.1, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 63.8, "enabled": true, "trip": false, "alarm": false, "fan": false } ] }, { "sequence": 1533, "timestamp": "2026-04-16T12:00:00Z", "channels": [ { "state": "normal", "temperature": 72.4, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 68.1, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 64.9, "enabled": true, "trip": false, "alarm": false, "fan": false }, { "state": "normal", "temperature": 63.6, "enabled": true, "trip": false, "alarm": false, "fan": false } ] } ] } Pola odpowiedzi Pole Typ Opis nextCursor liczba|null Kursor dla następnego żądania. null, jeśli osiągnięto koniec zapytania. recordCount liczba Liczba rekordów w bieżącym zestawie wyników (0..pageSize). records tablica Rekordy w kolejności określonej przez direct. Jeśli nie ma więcej dostępnych danych, odpowiedź zawiera recordCount: 0, records: [] oraz nextCursor: null. Nie jest to błąd. records[] Pole Typ Opis sequence liczba Numer sekwencyjny rekordu timestamp ciąg znaków ISO 8601 UTC channels tablica 4 elementy (CH1..CH4) records[].channels[] Pole Typ Opis state ciąg znaków "normal", "open", "short", "invalid" temperature liczba|null Temperatura (null, jeśli stan jest inny niż "normal") enabled wartość logiczna Określa, czy kanał jest włączony trip wartość logiczna Stan wyłączenia awaryjnego alarm wartość logiczna Stan alarmu fan wartość logiczna Stan wentylatora Scenariusz: wypełnienie strony interfejsu 25 rekordami (5 żądań po 5) GET /api/recorder/records/?page=1&pageSize=5&direct=desc → { "nextCursor": 1529, "recordCount": 5, "records": [...] } GET /api/recorder/records/?cursor=1529&pageSize=5&direct=desc → { "nextCursor": 1524, "recordCount": 5, "records": [...] } GET /api/recorder/records/?cursor=1524&pageSize=5&direct=desc → { "nextCursor": 1519, "recordCount": 5, "records": [...] } GET /api/recorder/records/?cursor=1519&pageSize=5&direct=desc → { "nextCursor": 1514, "recordCount": 5, "records": [...] } GET /api/recorder/records/?cursor=1514&pageSize=5&direct=desc → { "nextCursor": null, "recordCount": 5, "records": [...] } Pierwsze żądanie używa page=1; kolejne używają parametru cursor z poprzedniej odpowiedzi.

Novatek-Electro TR-100E Documentation

GET /api/recorder/export.csv/ Eksportuje dane rejestratora w formacie CSV. Uwierzytelnianie: Bearer. Odpowiedź 200 Content-Type: text/csv Content-Disposition: attachment; filename="tr100e_recorder.csv" Format CSV Pierwszy wiersz jest wierszem nagłówka. Separator: ;. Każdy wiersz reprezentuje jeden wpis rejestratora. Temperatura: liczba dziesiętna z jedną cyfrą po kropce dziesiętnej. Wartość jest pusta, jeśli temperatura jest nieprawidłowa. chN_status: skrócony stan kanału (disabled, open, short, normal, trip, alarm, fan, invalid albo kombinacja wartości rozdzielonych znakiem +). Kolejność kolumn date_time;ch1_temp;ch1_status;ch2_temp;ch2_status;ch3_temp;ch3_status;ch4_temp;ch4_status

Novatek-Electro TR-100E Documentation
POST /api/recorder/clear/ Czyści rejestrator. Uwierzytelnianie: powerUser. Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta lub niepoprawna składniowo treść JSON → 400 ERROR_API_PARSING. Brak wartości confirm, wartość innego typu niż logiczny albo wartość false → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation

GET /api/log/info/ Pobiera podsumowanie dziennika zdarzeń. Uwierzytelnianie: Bearer. Odpowiedź 200 { "capacity": 4096, "total": 250, "pending": 3, "oldestSequence": 0, "lastSequence": 250, "totalBySeverity": { "debug": 12, "info": 180, "warning": 40, "error": 15, "fault": 3 }, "pendingBySeverity": { "debug": 0, "info": 1, "warning": 1, "error": 1, "fault": 0 } } Pola odpowiedzi Pole Typ Wymagane Opis capacity liczba tak Maksymalna pojemność bufora cyklicznego total liczba tak Liczba dostępnych zdarzeń pending liczba tak Liczba niepotwierdzonych zdarzeń w bieżącej sesji zasilania oldestSequence liczba tak Numer sekwencyjny najstarszego dostępnego zdarzenia w buforze cyklicznym. Na stronach interfejsu wyświetlających najstarsze zdarzenia (oldest) jest to główny wskaźnik, że granica okna po stronie starszych zdarzeń faktycznie się przesunęła wskutek usunięcia zdarzeń z bufora. lastSequence liczba tak Numer sekwencyjny najnowszego zdarzenia. Interfejs używa tego pola do wykrywania nowych zdarzeń: jeśli wartość wzrosła względem poprzednio zapisanej, do dziennika dodano N = lastSequence_new - lastSequence_old nowych zdarzeń. Pobranie tych N zdarzeń jest właściwe tylko wtedy, gdy bieżąca strona interfejsu zawiera poprzednio zapisane lastSequence (czyli użytkownik znajduje się na najnowszej stronie, na której pojawiają się nowe wpisy); na pozostałych stronach aktualizacja nie jest potrzebna. totalBySeverity obiekt tak Podział wartości total według poziomu ważności pendingBySeverity obiekt tak Podział wartości pending według poziomu ważności totalBySeverity Pole Typ Opis debug liczba Liczba dostępnych zdarzeń DEBUG info liczba Liczba dostępnych zdarzeń INFO warning liczba Liczba dostępnych zdarzeń WARNING error liczba Liczba dostępnych zdarzeń ERROR fault liczba Liczba dostępnych zdarzeń FAULT pendingBySeverity Pole Typ Opis debug liczba Liczba oczekujących zdarzeń DEBUG info liczba Liczba oczekujących zdarzeń INFO warning liczba Liczba oczekujących zdarzeń WARNING error liczba Liczba oczekujących zdarzeń ERROR fault liczba Liczba oczekujących zdarzeń FAULT

Novatek-Electro TR-100E Documentation

GET /api/log/events/?page=1&pageSize=1&direct=desc Pobiera stronę zdarzeń dziennika przy użyciu stabilnej paginacji. Uwierzytelnianie: Bearer. Parametry zapytania Parametr Typ Wymagane Domyślnie Opis page liczba nie* — Numer strony, począwszy od 1. Używany tylko w pierwszym żądaniu serii. Ignorowany, jeśli podano cursor. pageSize liczba tak — Liczba zdarzeń na stronę. Prawidłowy zakres: 1..8. direct ciąg znaków nie "desc" Kierunek sortowania: "asc" — od najstarszych do najnowszych; "desc" — od najnowszych do najstarszych. severityMask liczba nie wszystkie (31) Maska bitowa poziomów ważności: bit0=DEBUG, bit1=INFO, bit2=WARNING, bit3=ERROR, bit4=FAULT. cursor liczba nie* — Kursor służący do kontynuowania zapytania. Zobacz poniżej. *Wymagany jest parametr page albo cursor. cursor Kursor zapewnia stabilną, sekwencyjną paginację bez duplikatów ani luk. Pierwsze żądanie w serii: klient wysyła page=1 i pomija cursor. Serwer rozpoczyna zapytanie od lastSequence (desc) albo oldestSequence (asc). Odpowiedź zawiera nextCursor, czyli pozycję, od której należy kontynuować. Kolejne żądania: klient wysyła cursor z poprzedniej odpowiedzi; parametr page jest ignorowany. Koniec zapytania: nextCursor: null oznacza, że nie ma więcej dostępnych danych. Nowa seria (podczas przechodzenia do innej strony interfejsu): klient resetuje cursor i ponownie rozpoczyna od page=1. Odpowiedź 200 { "nextCursor": 249, "eventCount": 1, "events": [ { "sequence": 250, "timestamp": "2026-04-16T12:00:00Z", "errorCode": 0, "pending": true, "severity": "WARNING", "dataType": "GENERIC", "generic": { "message": "Channel 1 open circuit" } } ] } Pola odpowiedzi Pole Typ Opis nextCursor liczba|null Kursor dla następnego żądania. null, jeśli osiągnięto koniec zapytania. eventCount liczba Liczba zdarzeń w bieżącym zestawie wyników (0..pageSize). events tablica Zdarzenia w kolejności określonej przez direct. Jeśli nie ma więcej dostępnych danych, odpowiedź zawiera eventCount: 0, events: [] oraz nextCursor: null. Nie jest to błąd. events[] Pole Typ Wymagane Opis sequence liczba tak Numer sekwencyjny zdarzenia timestamp ciąg znaków tak ISO 8601 UTC errorCode liczba tak Kod błędu pending wartość logiczna tak true, jeśli zdarzenie nie zostało jeszcze potwierdzone w bieżącej sesji zasilania severity ciąg znaków tak "DEBUG", "INFO", "WARNING", "ERROR", "FAULT" dataType ciąg znaków tak "GENERIC", "FAULT", "NETWORK" generic obiekt nie Obecne, jeśli dataType = "GENERIC" fault obiekt nie Obecne, jeśli dataType = "FAULT" network obiekt nie Obecne, jeśli dataType = "NETWORK" generic Pole Typ Opis message ciąg znaków Treść zdarzenia fault Pole Typ Opis taskName ciąg znaków Nazwa zadania registers ciąg znaków Pojedynczy ciąg znaków w postaci PC=... LR=... SP=... CFSR=... HFSR=... MMFAR=... BFAR=... R0=... R1=... R2=... R3=... R12=... xPSR=... network Pole Typ Opis message ciąg znaków Tekst remoteIp ciąg znaków Zdalny adres IP remotePort liczba Port zdalny localPort liczba Port lokalny lwipError liczba Kod błędu lwIP Scenariusz: wypełnienie strony interfejsu 25 zdarzeniami (5 żądań po 5) GET /api/log/events/?page=1&pageSize=5&direct=desc&severityMask=31 → { "nextCursor": 245, "eventCount": 5, "events": [...] } GET /api/log/events/?cursor=245&pageSize=5&direct=desc&severityMask=31 → { "nextCursor": 240, "eventCount": 5, "events": [...] } GET /api/log/events/?cursor=240&pageSize=5&direct=desc&severityMask=31 → { "nextCursor": 235, "eventCount": 5, "events": [...] } GET /api/log/events/?cursor=235&pageSize=5&direct=desc&severityMask=31 → { "nextCursor": 230, "eventCount": 5, "events": [...] } GET /api/log/events/?cursor=230&pageSize=5&direct=desc&severityMask=31 → { "nextCursor": null, "eventCount": 5, "events": [...] } Pierwsze żądanie używa page=1; kolejne używają parametru cursor z poprzedniej odpowiedzi. Parametr cursor zapobiega ponownemu przeszukiwaniu przez serwer już odczytanych rekordów, co jest szczególnie ważne podczas filtrowania za pomocą parametru severityMask.

Novatek-Electro TR-100E Documentation

GET /api/log/export.log/ Eksportuje dziennik w formacie tekstowym. Uwierzytelnianie: Bearer. Odpowiedź 200 Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename="tr100e_events.log" Pierwszy wiersz pliku zawiera nagłówek: {DEVICE_NAME} Sn: {UUID0}-{UUID1}-{UUID2} Fw: v{FW_VERSION} LOGS Następnie podane są zdarzenia, od najnowszego do najstarszego. Format wiersza {timestamp} {severity padded to 7} {dataType in brackets padded to 10}{detail} Pole typu danych wraz z nawiasami kwadratowymi i końcowymi spacjami zajmuje 10 znaków: po [FAULT] dodawane są trzy spacje, a po [GENERIC] i [NETWORK] — jedna. Przykłady 2026-04-16T12:00:00Z WARNING [GENERIC] Channel 1 open circuit 2026-04-16T12:01:00Z FAULT [FAULT] HardFault in Logic PC=08012345 LR=08012340 SP=20001000 CFSR=00000000 HFSR=00000000 MMFAR=00000000 BFAR=00000000 R0=00000000 R1=00000000 R2=00000000 R3=00000000 R12=00000000 xPSR=00000000 2026-04-16T12:02:00Z ERROR [NETWORK] Connection refused 192.168.1.100:502->502 lwip=-1 Szczegóły według dataType GENERIC: {message} FAULT: {taskName} PC={pc} LR={lr} SP={sp} CFSR={cfsr} HFSR={hfsr} MMFAR={mmar} BFAR={bfar} R0={r0} R1={r1} R2={r2} R3={r3} R12={r12} xPSR={xpsr} — rejestry w formacie szesnastkowym %08X NETWORK: {message} {remoteIp}:{remotePort}->{localPort} lwip={lwipError}

Novatek-Electro TR-100E Documentation
POST /api/log/acknowledge/ Czyści flagę niepotwierdzonych zdarzeń. Uwierzytelnianie: Bearer. Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta treść lub nieprawidłowy kod JSON → 400 ERROR_API_PARSING. confirm != true → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation
POST /api/log/clear/ Czyści dziennik zdarzeń. Uwierzytelnianie: powerUser. Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta treść lub nieprawidłowy kod JSON → 400 ERROR_API_PARSING. confirm != true → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation

Usługa kalibracji Kalibracja fabryczna jest obsługiwana w ramach jednej sesji obejmującej całe urządzenie. Sesja przejmuje ścieżkę pomiarową, wygasa po 30 sekundach bezczynności i przechowuje w pamięci RAM wersję roboczą do czasu wykonania operacji commit. Pomyślne operacje status, range, capture i commit przedłużają czas trwania sesji. Autoryzacja GET /api/service/calibration/report/ wymaga powerUser; klucz serwisowy nie jest wymagany. Operacja status i wszystkie punkty końcowe wprowadzające zmiany wymagają powerUser oraz zapisanej flagi wskazującej, że klucz serwisowy jest podłączony. Jeśli klucz nie jest podłączony, punkt końcowy zwraca 403 ERROR_NO_ACCESS. Model danych Dostępnych jest sześć niezależnych pozycji: x24_p1 (50 Ω), x24_p2 (100 Ω), x24_p3 (200 Ω), x2_p1 (500 Ω), x2_p2 (1000 Ω) i x2_p3 (2000 Ω). Każda zapisana migawka zawiera zastosowaną tolerancję bezwzględną i surowe wartości ADC czterech kanałów. Bieżąca rezystancja oraz wartości weryfikacyjne dla aktualnej pozycji są obliczane wyłącznie na podstawie jej rezystancji wzorcowej i zarejestrowanej wartości ADC: R = referenceOhm * ADC / capturedAdc. Pola previewOhm, deltaOhm i deltaPercent są obliczane dynamicznie podczas generowania odpowiedzi. Pozostałe pozycje nie uczestniczą w obliczeniach. Narzędzie producenta oblicza tolerancję. Podczas operacji commit oprogramowanie układowe otrzymuje dwie wartości końcowe i zapisuje je jako dane historyczne, ale nie określa, czy pomiar jest zgodny ze specyfikacją. Bezpośrednio po rejestracji odpowiedni element captures zawiera już wszystkie pola migawki. Dopóki nie zostanie przetworzonych dziesięć nowych okien weryfikacyjnych, pola verifyAdc, previewOhm, deltaOhm i deltaPercent mają wartości zerowe. Przed operacją commit pole tolerance ma wartość null. Gotowość wyniku należy określać na podstawie stanu: ukończona migawka jest dostępna po przejściu ze stanu verify_capture do active. Dane źródłowe ukończonej migawki nie zmieniają się do czasu ponownego zarejestrowania tej samej pozycji. Rejestracja innego punktu nie unieważnia ukończonych migawek. GET /api/service/calibration/report/ Generuje najnowszy kompletny raport jakości na podstawie zapisanych pozycji kalibracji. W pamięci Flash nie jest przechowywany oddzielny obiekt raportu. Odpowiedź 200, raport niedostępny { "available": false } Odpowiedź available: false oznacza, że zapisany raport jest niedostępny. API nie określa przyczyny jego niedostępności. Odpowiedź 200, raport dostępny { "available": true, "committedAt": "2026-07-23T12:00:00Z", "snapshots": { "x2_p1": { "capturedAt": "2026-07-23T11:58:00Z", "tolerance": { "ohm": 1.875 }, "channels": [ { "channel": 0, "referenceOhm": 500.0, "capturedAdc": 123456, "verifyAdc": 123460, "previewOhm": 500.0162, "deltaOhm": 0.0162, "deltaPercent": 0.00324 } ] } } } Pełna odpowiedź zawiera wszystkie sześć kluczy migawek oraz cztery kanały w każdej migawce. Nie ma nadrzędnej mapy tolerancji ani pól scale lub offset. GET /api/service/calibration/status/ Zwraca aktywną sesję i przedłuża jej 30-sekundowy czas trwania. Odpowiedź 200, bezczynność { "state": "idle" } Odpowiedź 200, sesja aktywna { "state": "active", "sessionId": "7A19C2E4", "activeGain": "x24", "activePoint": "p1", "committedAt": null, "captures": {}, "live": [ { "channel": 0, "filteredAdc": 123456, "resistanceOhm": 100.01 } ] } Obserwowalne stany aktywnej sesji to switching, active i verify_capture. Model wewnętrzny obejmuje również stany committing i stopping, jednak operacje zatwierdzania i kończenia są przetwarzane synchronicznie, dlatego operacja status nie zwraca tych stanów przejściowych. Narzędzie producenta stosuje tolerancję określoną w konfiguracji dla bieżącej procedury. W niezatwierdzonych elementach captures pole tolerance ma wartość null; po operacji commit każda pozycja zawiera historyczną tolerancję podaną przez narzędzie. Pole live[].resistanceOhm ma typ number|null: w przypadku pustej lub niekompletnej wersji roboczej rezystancja, której nie można obliczyć, jest serializowana jako null. POST /api/service/calibration/begin/ Rozpoczyna pojedynczą sesję kalibracji na podstawie zapisanego zestawu punktów. Jeśli rekord w pamięci Flash nie istnieje lub jest nieprawidłowy, sesja rozpoczyna się z pustą wersją roboczą. Treść żądania nie jest używana. Początkową aktywną pozycją jest x24_p1. Odpowiedź 200 { "sessionId": "7A19C2E4" } Jeśli inna sesja jest już aktywna, zwraca 400 ERROR_INVALID_VALUE. Kod 503 ERROR_NOT_READY oznacza, że zadanie pomiarowe nie przyjęło polecenia. POST /api/service/calibration/range/ Wybiera wzmocnienie i punkt. Po zmianie wzmocnienia sesja przechodzi w stan switching, w którym pozostaje do czasu opublikowania nowego okna pomiarowego potwierdzającego zastosowanie sprzętowej ścieżki pomiarowej. { "sessionId": "7A19C2E4", "gain": "x24", "point": "p1" } Odpowiedź 200 { "state": "switching", "activeGain": "x24", "activePoint": "p1" } POST /api/service/calibration/capture/ Rejestruje bieżące okno surowych wartości ADC dla wszystkich czterech kanałów i rozpoczyna weryfikację na podstawie dziesięciu nowych okien. { "sessionId": "7A19C2E4", "gain": "x24", "point": "p1", "referenceOhm": 1000.01 } Odpowiedź 200 { "gain": "x24", "point": "p1", "capturedAt": "2026-07-23T11:58:00Z", "state": "verify_capture", "channels": [ { "channel": 0, "referenceOhm": 1000.01, "capturedAdc": 123456 } ] } Wartość referenceOhm musi być skończoną liczbą dodatnią. Podane wzmocnienie i punkt muszą odpowiadać aktywnej pozycji. POST /api/service/calibration/commit/ Zapisuje zestaw punktów oraz wszystkie sześć ukończonych, poprawnych strukturalnie migawek. Rezystancje wzorcowe i wartości ADC muszą rosnąć od p1 do p3; różnica ADC między każdą parą sąsiednich punktów musi wynosić co najmniej 5%. Przed wywołaniem punktu końcowego narzędzie producenta sprawdza, czy pomiary mieszczą się w granicach tolerancji. { "sessionId": "7A19C2E4", "toleranceOhm": { "x24": 0.1875, "x2": 1.875 } } Odpowiedź 200 { "committedAt": "2026-07-23T12:00:00Z" } Wartość toleranceOhm.x24 jest zapisywana w trzech pozycjach zakresu x24, a toleranceOhm.x2 — w trzech pozycjach zakresu x2. Obie wartości muszą być skończonymi liczbami dodatnimi. Powtórzenie operacji commit dla tej samej zapisanej wersji w ramach sesji jest idempotentne. Brakujące, niekompletne lub nieprawidłowe strukturalnie migawki powodują zwrócenie 400 ERROR_INVALID_ARGUMENT. Przekroczenie podanej tolerancji nie jest samo w sobie błędem oprogramowania układowego. POST /api/service/calibration/finish/ Kończy sesję, odrzuca niezatwierdzoną wersję roboczą i zwalnia ścieżkę pomiarową. { "sessionId": "7A19C2E4" } Odpowiedź 200 { "state": "idle", "finished": true } Ograniczenia pamięci Pojedynczy rekord w wewnętrznym sektorze 1 pamięci Flash zawiera serwisową wartość magic, wersję formatu i sumę kontrolną CRC, natomiast zagnieżdżona struktura Calibration_t zawiera wspólną wartość committedAt oraz sześć pozycji kalibracji. Każda pozycja przechowuje capturedAt, referenceOhm, historyczną wartość toleranceOhm podaną przy operacji commit, a dla każdego kanału także capturedAdc i verifyAdc. Pochodne wyniki pomiarów nie są przechowywane w pamięci Flash. Bieżąca wersja formatu to 0x0600; rekordy w innych wersjach nie są wczytywane i wymagają ponownej kalibracji. Punkt końcowy report oblicza pola pochodne i serializuje je na żądanie; oddzielny obiekt raportu nie jest przechowywany. Podczas zwykłego pomiaru rezystancja jest obliczana metodą interpolacji odcinkowo-liniowej. Gdy ADC <= ADC(p2), używane są współczynniki wyznaczone z p1+p2; w przypadku wyższej wartości ADC używane są współczynniki wyznaczone z p2+p3. Poza skrajnymi punktami do ekstrapolacji używana jest najbliższa para. Błąd zapisu pozostawia sesję w pamięci RAM aktywną, umożliwiając kolejną próbę wykonania operacji commit lub jawne wywołanie operacji finish. Nie ma gwarancji, że poprzednia wersja w pamięci Flash przetrwa awarię zasilania lub błąd programowania podczas kasowania albo zapisu. Rzeczywista atomowość typu „stara lub nowa wersja” wymaga drugiego banku kasowania lub zmiany układu pamięci Flash. Błędy sesji Pusta treść żądania lub nieprawidłowy składniowo kod JSON → 400 ERROR_API_PARSING. Brakujące pola lub pola nieprawidłowego typu → 400 ERROR_INVALID_ARGUMENT. Nieprawidłowy lub wygasły identyfikator sessionId albo operacja wykonana w nieprawidłowym stanie → 400 ERROR_INVALID_VALUE. Ścieżka pomiarowa nie jest gotowa podczas operacji status lub capture → 503 ERROR_NOT_READY. Błąd zapisu podczas operacji commit → 500 ERROR_IO.

Novatek-Electro TR-100E Documentation

Weryfikacja własności w Overvis Weryfikacja potwierdza fizyczny dostęp do urządzenia TR-100E podczas łączenia go z Overvis za pomocą kodu PIN. Kod jest wyświetlany na urządzeniu przez maksymalnie 5 minut. Użytkownik może wprowadzić ten kod w Overvis albo potwierdzić połączenie, wybierając opcję Tak na urządzeniu TR-100E. Kod stanowi część stanu roboczego: nie jest zapisywany w pamięci Flash/EEPROM ani zwracany przez interfejs API stanu. POST /api/service/challenge/set/ Ustawia, zastępuje lub usuwa weryfikację. Dostęp: wyłącznie WireGuard, Bearer/implicit (user). Żądanie z sieci LAN zwraca 403 ERROR_NO_ACCESS. Ustawienie { "code": "001274" } Pole code jest wymagane i musi zawierać od 1 do 12 cyfr ASCII. Kod jest przekazywany jako ciąg znaków, aby zachować zera wiodące. Nowe żądanie zastępuje poprzednią weryfikację i ponownie uruchamia 300-sekundowy licznik czasu. Odpowiedź 200: { "status": "pending", "remainingSec": 300 } Usunięcie { "code": null } Odpowiedź 200: { "status": "idle", "remainingSec": 0 } Pusta treść żądania lub nieprawidłowy kod JSON powoduje zwrócenie 400 ERROR_API_PARSING. Brakujące pole, nieprawidłowy typ, pusty ciąg znaków albo kod, który jest zbyt długi lub zawiera znaki inne niż cyfry, powoduje zwrócenie 400 ERROR_INVALID_ARGUMENT. Błąd walidacji nie zmienia bieżącej weryfikacji. GET /api/service/challenge/status/ Pobiera spójną migawkę stanu weryfikacji. Dostęp: wyłącznie WireGuard, Bearer/implicit (user). Żądanie z sieci LAN zwraca 403 ERROR_NO_ACCESS. Odpowiedź 200: { "status": "accepted", "remainingSec": 247 } status Znaczenie idle Weryfikacja jest nieaktywna lub została usunięta pending Kod jest wyświetlany, ale nie otrzymano jeszcze fizycznej odpowiedzi accepted Użytkownik wybrał opcję Tak na urządzeniu TR-100E rejected Użytkownik wybrał opcję Nie na urządzeniu TR-100E Wartość remainingSec zmniejsza się od 300 do 1 w stanach pending, accepted i rejected; w stanie idle wynosi 0. Odpowiedź użytkownika nie uruchamia ponownie ani nie zatrzymuje licznika czasu. Po upływie pierwotnych 300 sekund urządzenie automatycznie przywraca stan weryfikacji idle. Po wybraniu opcji Tak urządzenie TR-100E wyświetla ekran oczekiwania do czasu, gdy Overvis odczyta stan accepted i wyśle code: null. Usunięcie weryfikacji kończy przepływ interfejsu użytkownika i przywraca ekran główny. Jeśli użytkownik potwierdzi własność, wprowadzając kod w Overvis, usługa chmurowa porównuje go z pierwotną wartością i po pomyślnej weryfikacji wysyła code: null, aby usunąć monit z wyświetlacza.

Novatek-Electro TR-100E Documentation

POST /api/service/firmware/apply/ Stosuje wcześniej przesłany i zweryfikowany obraz OTA. Uwierzytelnianie: powerUser Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta treść żądania lub nieprawidłowy składniowo kod JSON → 400 ERROR_API_PARSING. Brak pola confirm, wartość inna niż logiczna lub false → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {} Przed wywołaniem tego punktu końcowego obraz OTA musi zostać przesłany i zatwierdzony za pomocą POST /api/service/firmware/upload/finish/. Urządzenie rozpocznie stosowanie aktualizacji po ponownym uruchomieniu.

Novatek-Electro TR-100E Documentation

Sesja przesyłania oprogramowania układowego Przesyłanie pliku .ota odbywa się w ramach sekwencyjnej sesji przesyłania do obszaru OTA. GET /api/service/firmware/upload/status/ Pobiera bieżący stan sesji przesyłania oraz informację o poprawności obrazu OTA. Uwierzytelnianie: powerUser Odpowiedź 200 { "uploadInProgress": false, "imageValid": true, "receivedBytes": 524288, "totalBytes": 524288, "percent": 100, "lastError": 0, "lastInstallState": "ready", "meta": { "fwVersion": "1.0", "buildTimestamp": 1785412800, "deviceStr": "TR-100E (48)", "description": "Production firmware" } } Pole Typ Opis uploadInProgress wartość logiczna Trwa kasowanie, odbieranie lub weryfikacja imageValid wartość logiczna Obraz OTA został w całości przesłany i zweryfikowany receivedBytes liczba Liczba potwierdzonych bajtów totalBytes liczba Oczekiwany rozmiar obrazu percent liczba Postęp wyrażony w procentach lastError liczba Kod błędu (0 = brak) lastInstallState ciąg znaków Ostatni stan instalacji: "idle", "ready", "running", "failed", "unknown" meta obiekt Metadane zweryfikowanego obrazu; obecne tylko wtedy, gdy imageValid: true meta.fwVersion ciąg znaków Wersja oprogramowania układowego z obrazu OTA, maksymalnie 15 znaków ASCII (na przykład 1.0 lub 1.2.3-rc4) meta.buildTimestamp liczba Uniksowy znacznik czasu kompilacji meta.deviceStr ciąg znaków Oznaczenie docelowego sprzętu; TR-100E (48) dla tego urządzenia meta.description ciąg znaków Opis obrazu POST /api/service/firmware/upload/begin/ Otwiera sesję przesyłania, ustawia rozmiar obrazu i przygotowuje obszar OTA. Uwierzytelnianie: powerUser Żądanie { "size": 524288 } Pole Typ Wymagane Opis size liczba tak Liczba całkowita: rozmiar obrazu OTA w bajtach (> 0 i ≤ rozmiar obszaru OTA) Ponowne wywołanie tego punktu końcowego zeruje nieukończoną sesję. Jeśli trwa operacja erase/verify → 503 ERROR_NOT_READY. Odpowiedź 200 { "acceptedOffset": 0 } POST /api/service/firmware/upload/chunk/?offset=0 Zapisuje fragment obrazu OTA. Uwierzytelnianie: powerUser Żądanie Content-Type: application/octet-stream Parametr zapytania offset: przesunięcie fragmentu w pełnym obrazie. Treść: surowe bajty fragmentu (maksymalnie 1024 bajty). Parametr Typ Wymagane Opis offset liczba tak Liczba całkowita: nieujemne przesunięcie w pełnym obrazie OTA Wartość offset musi odpowiadać oczekiwanemu przesunięciu lub wskazywać już potwierdzony fragment (idempotentne ponowienie). Luka → 400 ERROR_INVALID_VALUE. Fragment większy niż 1024 bajty → 400 ERROR_INVALID_VALUE. Odpowiedź 200 { "acceptedOffset": 1024 } POST /api/service/firmware/upload/finish/ Kończy sesję przesyłania i rozpoczyna weryfikację. Uwierzytelnianie: powerUser Żądanie { "confirm": true } Niekompletny obraz lub błąd weryfikacji → 400 ERROR_INVALID_VALUE. Odpowiedź 200 { "uploadInProgress": false, "imageValid": true, "receivedBytes": 524288, "totalBytes": 524288, "percent": 100, "lastError": 0, "lastInstallState": "ready", "meta": { "fwVersion": "1.0", "buildTimestamp": 1785412800, "deviceStr": "TR-100E (48)", "description": "Production firmware" } } POST /api/service/firmware/upload/discard/ Usuwa przygotowany obraz OTA i zeruje sesję przesyłania. Uwierzytelnianie: powerUser Żądanie { "confirm": true } Pusta treść żądania lub nieprawidłowy składniowo kod JSON → 400 ERROR_API_PARSING. Brak pola confirm, wartość inna niż logiczna lub false → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 Zwraca pełny stan w takim samym formacie jak GET /api/service/firmware/upload/status/.

Novatek-Electro TR-100E Documentation

GET /api/service/identity/get/ Zwraca informacje serwisowe urządzenia. Uwierzytelnianie: powerUser Żądanie Treść żądania nie jest używana. Parametry zapytania Parametr Wartość Opis includePassword 1 Jeśli zostanie podany, pole devicePassword jest dodawane do odpowiedzi. W przeciwnym razie hasło nie jest zwracane. Przykład: GET /api/service/identity/get/?includePassword=1 Odpowiedź 200 { "available": true, "donglePresent": true, "hasDevicePrivateKey": true, "hasDevicePassword": true, "uuid": "002B003A-3234510F-38383235", "devicePublicKey": "base64...", "macAddress": "00:11:22:33:44:55", "isUnique": true, "urlAutoConfig": "https://example.invalid", "manufacturer": "Novatek", "pinCode": "123456", "devicePassword": "Ab12Cd34" } Pola odpowiedzi Pole Typ Opis available wartość logiczna Dane serwisowe urządzenia są dostępne donglePresent wartość logiczna Sprzętowy klucz serwisowy jest podłączony hasDevicePrivateKey wartość logiczna Klucz prywatny urządzenia jest ustawiony hasDevicePassword wartość logiczna Hasło urządzenia jest ustawione; wartość hasła nie jest ujawniana uuid ciąg znaków | null Pełny unikatowy identyfikator MCU w formacie XXXXXXXX-XXXXXXXX-XXXXXXXX devicePublicKey ciąg znaków | null Klucz publiczny urządzenia w formacie base64 protokołu WireGuard macAddress ciąg znaków Efektywny adres MAC w formacie XX:XX:XX:XX:XX:XX, w tym wartość zastępcza isUnique wartość logiczna true, jeśli adres MAC odczytano z układu EUI-48; false, jeśli używana jest wartość zastępcza wyprowadzona z identyfikatora UUID MCU urlAutoConfig ciąg znaków | null Adres URL automatycznej konfiguracji manufacturer ciąg znaków | null Nazwa producenta pinCode ciąg znaków | null Kod PIN devicePassword ciąg znaków | null Hasło urządzenia. Obecne tylko wtedy, gdy zażądano go za pomocą ?includePassword=1 Jeśli dane serwisowe urządzenia nie są jeszcze gotowe, API zwraca 503 ERROR_NOT_READY.

Novatek-Electro TR-100E Documentation

POST /api/service/identity/set/ Aktualizuje pola tożsamości inne niż klucz prywatny urządzenia i zapisuje je w pamięci EEPROM. Uwierzytelnianie: powerUser Żądanie Treść żądania musi być obiektem JSON bez dodatkowego obiektu nadrzędnego identity. { "urlAutoConfig": "https://example.invalid", "manufacturer": "Novatek", "pinCode": "123456" } Pola żądania Pole Typ Wymagane Opis urlAutoConfig ciąg znaków nie Adres URL automatycznej konfiguracji manufacturer ciąg znaków nie Nazwa producenta pinCode ciąg znaków nie Kod PIN Ograniczenia długości: urlAutoConfig: maksymalnie 63 znaki. manufacturer: maksymalnie 23 znaki. pinCode: maksymalnie 11 znaków. Pusta treść żądania → 400 ERROR_API_PARSING. Treść żądania, która nie jest obiektem → 400 ERROR_INVALID_ARGUMENT. Jeśli nie podano żadnego z obsługiwanych pól → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {} Jeśli klucz prywatny lub hasło urządzenia nie zostały jeszcze zainicjowane, API zwraca 503 ERROR_NOT_READY. Pierwsze wypełnienie pustego pola tożsamości jest dozwolone bez klucza serwisowego. Zmiana lub wyczyszczenie wypełnionego już pola wymaga klucza serwisowego, a w razie jego braku zwracany jest błąd dostępu. Przesłanie istniejącej wartości nie jest uznawane za nadpisanie.

Novatek-Electro TR-100E Documentation
POST /api/service/reboot/ Rozpoczyna opóźnione ponowne uruchomienie. Uwierzytelnianie: powerUser Żądanie { "rebootSec": 3 } Pola żądania Pole Typ Wymagane Opis rebootSec liczba tak Liczba całkowita: opóźnienie przed ponownym uruchomieniem (3..30 sekund) Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation

POST /api/service/settings/reset/ Przywraca ustawienia fabryczne. Uwierzytelnianie: powerUser Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta treść żądania lub nieprawidłowy składniowo kod JSON → 400 ERROR_API_PARSING. Brak pola confirm, wartość inna niż logiczna lub false → 400 ERROR_INVALID_ARGUMENT. Odpowiedź 200 {} Po pomyślnym przywróceniu ustawień interfejs WWW musi pobrać je ponownie za pomocą GET /api/settings/get/?....

Novatek-Electro TR-100E Documentation

POST /api/service/time/set/ Ręcznie ustawia czas systemowy (RTC). Uwierzytelnianie: powerUser Żądanie { "dateTimeUtc": "2026-04-29T00:00:00Z" } Pola żądania Pole Typ Wymagane Opis dateTimeUtc ciąg znaków tak Data i czas w formacie UTC zgodnym z ISO 8601, na przykład 2026-04-29T00:00:00Z Walidacja Pole dateTimeUtc musi być ciągiem znaków zgodnym z ISO 8601 z przesunięciem UTC Z lub +00:00; dozwolone są ułamki sekund. Parser sprawdza zakresy poszczególnych składowych, ale przepełnienia kalendarzowe, takie jak 31 kwietnia, są normalizowane przez systemową funkcję czasu. Pusta treść żądania → 400 ERROR_API_PARSING. Błąd zapisu RTC → 500 ERROR_IO. Odpowiedź 200 {} Klient wysyła czas w UTC. Strefa czasowa i czas letni są uwzględniane wyłącznie podczas wyświetlania.

Novatek-Electro TR-100E Documentation

POST /api/service/time/sync/ Rozpoczyna wymuszoną synchronizację czasu przez SNTP. Uwierzytelnianie: Bearer. Żądanie { "confirm": true } Pola żądania Pole Typ Wymagane Opis confirm wartość logiczna tak Musi mieć wartość true Pusta treść żądania → 400 ERROR_API_PARSING. Odpowiedź 200 {} Właściwa synchronizacja SNTP jest wykonywana asynchronicznie. Jeśli NTP jest wyłączony, lwIP/SNTP nie jest jeszcze gotowy albo żądanie synchronizacji zostanie odrzucone, punkt końcowy zwraca 503 ERROR_NOT_READY.

Novatek-Electro TR-100E Documentation

GET /api/debug/adc/, POST /api/debug/adc/start/, POST /api/debug/adc/stop/ Surowe dane ADC i pośrednie wyniki pomiarów każdego kanału. Punkt końcowy jest przeznaczony do kalibracji i diagnostyki. Uwierzytelnianie: Bearer (powerUser). Operacje start i stop wymagają ponadto aktywnego trybu diagnostycznego. Klucz serwisowy nie jest wymagany. Odpowiedź 200 { "diagnostic": { "active": true, "ready": true, "sensorTypeId": 0, "gain": "x24" }, "mcuTemperature": 42.3, "channels": [ { "filteredAdc": 69020, "resistance": 109.73, "temperature": 25.1, "gain": "x24", "circuitState": "NORMAL" }, { "filteredAdc": 130000, "resistance": 206.68, "temperature": null, "gain": "x24", "circuitState": "OPEN_CIRCUIT" }, { "filteredAdc": 320, "resistance": 0.51, "temperature": null, "gain": "x24", "circuitState": "SHORT_CIRCUIT" }, { "filteredAdc": 0, "resistance": 0.0, "temperature": null, "gain": "x24", "circuitState": "DISABLED" } ] } Pola odpowiedzi Pole Typ Opis diagnostic.active wartość logiczna Określa, czy tymczasowa konfiguracja kanałów jest aktywna diagnostic.ready wartość logiczna Określa, czy odebrano świeże dane ze stabilnymi stanami wszystkich kanałów diagnostic.sensorTypeId liczba Tymczasowo wybrany typ czujnika z GET /api/reference/sensor-types/; pole jest obecne, gdy active=true diagnostic.gain ciąg znaków Obliczone wzmocnienie; pole jest obecne, gdy active=true mcuTemperature liczba|null Temperatura wewnętrznego czujnika mikrokontrolera (°C) albo null, jeśli wartość jest nieprawidłowa channels tablica 4 elementy (CH1..CH4) channels[].filteredAdc liczba Filtrowana surowa wartość ADC channels[].resistance liczba Obliczona rezystancja (Ω) channels[].temperature liczba|null Obliczona temperatura (°C) albo null, jeśli wartość jest nieprawidłowa channels[].gain ciąg znaków Wzmocnienie: "x2" albo "x24" channels[].circuitState ciąg znaków Stan obwodu Wartości circuitState "NORMAL" "OPEN_CIRCUIT" "SHORT_CIRCUIT" "UNDER_RANGE" "OVER_RANGE" "DISABLED" "UNKNOWN" POST /api/debug/adc/start/ Tymczasowo włącza wszystkie cztery kanały z określonym typem czujnika. Oprogramowanie układowe dobiera wzmocnienie. Ustawienia ani pamięć flash nie są modyfikowane. Wartość sensorTypeId należy pobrać z pola items[].id odpowiedzi na żądanie GET /api/reference/sensor-types/. { "sensorTypeId": 0 } Ponowne wywołanie tego punktu końcowego uruchamia od nowa akumulację i filtrowanie. Odpowiedź zawiera obiekt diagnostic; wartość ready=false jest zwracana do chwili udostępnienia świeżych, stabilnych danych. POST /api/debug/adc/stop/ Kończy test i przywraca konfigurację kanałów z ustawień. Treść żądania jest ignorowana. Tryb kończy się również po 30 sekundach bez żądania GET /api/debug/adc/ albo po wyjściu z trybu diagnostycznego.

Novatek-Electro TR-100E Documentation

POST /api/debug/display/start/ i POST /api/debug/display/stop/ Test wyświetlacza, który tymczasowo zastępuje zwykły obraz oraz ustawienia kontrastu i podświetlenia. Uwierzytelnianie: Bearer (powerUser). POST /api/debug/display/start/ Włącza zastępczą konfigurację wyświetlacza. Żądanie { "mode": "checkerboard", "contrast": 34, "backlightPercent": 80 } Pole Typ Wymagane Opis mode ciąg znaków tak Tryb wyświetlacza: normal, black, white, grid albo checkerboard contrast liczba całkowita tak Kontrast wyświetlacza od 0 do 64 backlightPercent liczba całkowita tak Jasność podświetlenia w procentach, od 0 do 100 Tryby Tryb Obraz normal Zwykła zawartość ekranu z tymczasowymi ustawieniami kontrastu i podświetlenia black Wszystkie piksele włączone white Wszystkie piksele wyłączone grid Siatka o odstępach 8 pikseli checkerboard Szachownica z pól o wymiarach 8 × 8 pikseli Ponowne wywołanie operacji start zastępuje bieżący tryb i rozpoczyna od nowa odliczanie limitu czasu zabezpieczenia. Odpowiedź 200 {} POST /api/debug/display/stop/ Wyłącza konfigurację zastępczą i przywraca zwykłe sterowanie obrazem, kontrastem i podświetleniem. Treść żądania nie jest wymagana. Odpowiedź 200 {} Konfiguracja zastępcza jest automatycznie wyłączana po 305 sekundach, nawet jeśli klient nie wywoła operacji stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/external-storage/dump/ Przesyła strumieniowo zrzut każdego bajtu zainstalowanej pamięci zewnętrznej tylko do odczytu. Oprogramowanie układowe odczytuje fragmenty o ograniczonym rozmiarze i nie przydziela w pamięci RAM miejsca na cały zrzut. Uwierzytelnianie: Bearer (powerUser). Tryb: musi być aktywny tryb diagnostyczny. Content-Type: application/octet-stream. Content-Disposition: attachment; filename=tr100e_external_storage.bin. Strumień jest kończony przez zamknięcie połączenia. Podczas pomyślnej diagnostyki należy odebrać dokładnie tyle bajtów, ile wynosi wartość sizeBytes zwracana przez GET /api/debug/external-storage/. Błąd odczytu pamięci powoduje wcześniejsze zamknięcie strumienia, a tym samym utworzenie krótszego zrzutu. Punkt końcowy nigdy nie zapisuje danych w pamięci zewnętrznej ani jej nie kasuje.

Novatek-Electro TR-100E Documentation

GET /api/debug/external-storage/ Informacje o pamięci zewnętrznej: zainstalowany układ, pojemność i pełna mapa obszarów. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "jedecId": "EF4015", "chipType": "W25Q16", "sizeBytes": 2097152, "sectorSize": 4096, "regions": { "logger": { "startAddress": "0x000000", "sizeBytes": 262144, "usedEntries": 124, "maxEntries": 2048 }, "recorder": { "startAddress": "0x040000", "sizeBytes": 524288, "usedEntries": 8530, "maxEntries": 16384 }, "ota": { "startAddress": "0x0C0000", "sizeBytes": 1048576, "imagePresent": false, "imageSize": 0 }, "reserved": { "startAddress": "0x1C0000", "sizeBytes": 262144 } } } Pola odpowiedzi Pole Typ Opis jedecId ciąg znaków Sześcioznakowy ciąg szesnastkowy (producent + typ + pojemność) chipType ciąg znaków Czytelna dla człowieka nazwa układu sizeBytes liczba Całkowita pojemność pamięci zewnętrznej (bajty) sectorSize liczba Rozmiar sektora (bajty) regions.logger.startAddress ciąg znaków Adres początkowy (szesnastkowy) regions.logger.sizeBytes liczba Rozmiar obszaru (bajty) regions.logger.usedEntries liczba Liczba używanych wpisów regions.logger.maxEntries liczba Maksymalna liczba wpisów regions.recorder.startAddress ciąg znaków Adres początkowy (szesnastkowy) regions.recorder.sizeBytes liczba Rozmiar obszaru (bajty) regions.recorder.usedEntries liczba Liczba używanych wpisów regions.recorder.maxEntries liczba Maksymalna liczba wpisów regions.ota.startAddress ciąg znaków Adres początkowy (szesnastkowy) regions.ota.sizeBytes liczba Rozmiar miejsca na obraz OTA (bajty) regions.ota.imagePresent wartość logiczna Określa, czy jest dostępny obraz z prawidłowym nagłówkiem regions.ota.imageSize liczba Rozmiar ładunku określony w nagłówku (0 w przypadku braku obrazu) regions.reserved.startAddress ciąg znaków Adres początkowy obszaru zarezerwowanego (szesnastkowy) regions.reserved.sizeBytes liczba Rozmiar obszaru zarezerwowanego (bajty)

Novatek-Electro TR-100E Documentation

GET /api/debug/heap/ Stan stert FreeRTOS i lwIP. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "rtos": { "totalBytes": 30720, "freeBytes": 18240, "minEverFreeBytes": 12800, "largestFreeBlockBytes": 14336, "smallestFreeBlockBytes": 16, "freeBlockCount": 7, "allocCount": 1234, "freeCount": 1200 }, "lwip": { "totalBytes": 51200, "freeBytes": 38400, "minEverFreeBytes": 28000 } } Pola odpowiedzi Pole Typ Opis rtos.totalBytes liczba Całkowity rozmiar sterty FreeRTOS (configTOTAL_HEAP_SIZE) rtos.freeBytes liczba Bieżąca ilość wolnego miejsca (suma wszystkich wolnych bloków) rtos.minEverFreeBytes liczba Najmniejsza ilość wolnego miejsca od uruchomienia (dolny limit) rtos.largestFreeBlockBytes liczba Rozmiar największego wolnego bloku (wskaźnik fragmentacji) rtos.smallestFreeBlockBytes liczba Rozmiar najmniejszego wolnego bloku rtos.freeBlockCount liczba Liczba wolnych bloków rtos.allocCount liczba Liczba pomyślnych wywołań pvPortMalloc od uruchomienia rtos.freeCount liczba Liczba pomyślnych wywołań vPortFree od uruchomienia lwip.totalBytes liczba Całkowity rozmiar sterty lwIP lwip.freeBytes liczba Bieżąca ilość wolnego miejsca na stercie lwIP lwip.minEverFreeBytes liczba Najmniejsza ilość wolnego miejsca na stercie lwIP od uruchomienia Gdy freeBytes > 0, wskaźnik fragmentacji sterty FreeRTOS wynosi 1 - largestFreeBlockBytes / freeBytes. Jeśli wartość largestFreeBlockBytes jest znacznie mniejsza niż freeBytes, przydzielenie dużego bloku może się nie powieść pomimo wystarczającej łącznej ilości wolnej pamięci. Gdy freeBytes == 0, interfejs WWW wyświetla 0% bez obliczania tego wzoru.

Novatek-Electro TR-100E Documentation

GET /api/debug/keyget/ Bieżące stany fizycznych przycisków na panelu przednim. Uwierzytelnianie: Bearer (powerUser). Stany są odczytywane bezpośrednio z wejść sprzętowych. Zdarzenia wirtualne przesłane za pomocą POST /api/debug/keypress/ nie wpływają na odpowiedź. Odpowiedź 200 { "up": false, "down": false, "menu": true, "set": false, "test": false } Pola odpowiedzi Pole Typ Opis up wartość logiczna Przycisk w górę jest naciśnięty down wartość logiczna Przycisk w dół jest naciśnięty menu wartość logiczna Przycisk menu jest naciśnięty set wartość logiczna Przycisk ustawiania jest naciśnięty test wartość logiczna Przycisk testu jest naciśnięty

Novatek-Electro TR-100E Documentation

POST /api/debug/keypress/ Wstrzykuje wirtualne zdarzenie przycisku na potrzeby automatycznego testowania interfejsu i menu. Uwierzytelnianie: Bearer (powerUser). Tryb diagnostyczny musi być aktywny. W przeciwnym razie punkt końcowy zwraca 403 ERROR_NO_ACCESS. Żądanie { "event": "press", "keys": ["menu"], "duration": 0 } Pola żądania Pole Typ Wymagane Opis event ciąg znaków tak "press", "release", "hold", "combo" keys ciąg[] tak Przyciski: "up", "down", "menu", "set", "test" duration liczba nie Czas trwania w ms wyrażony liczbą całkowitą (dla hold); brakująca wartość lub wartość niebędąca liczbą całkowitą jest traktowana jako 0 Odpowiedź 200 {}

Novatek-Electro TR-100E Documentation

POST /api/debug/led/start/ i POST /api/debug/led/stop/ Test serwisowy diod LED. Uwierzytelnianie: Bearer (powerUser). Tryb diagnostyczny musi być aktywny. W przeciwnym razie punkty końcowe zwracają 403 ERROR_NO_ACCESS. POST /api/debug/led/start/ Wymusza stany testowe diod LED. Żądanie { "state": { "ledTrip": true, "ledAlarm": true, "ledFan": true, "ledFault": true, "ledCh1": true, "ledCh2": true, "ledCh3": true, "ledCh4": true } } Pole Typ Wymagane Opis state obiekt tak Stany diod LED state.ledTrip wartość logiczna tak Dioda LED zadziałania state.ledAlarm wartość logiczna tak Dioda LED alarmu state.ledFan wartość logiczna tak Dioda LED wentylatora state.ledFault wartość logiczna tak Dioda LED usterki state.ledCh1 wartość logiczna tak Dioda LED kanału 1 state.ledCh2 wartość logiczna tak Dioda LED kanału 2 state.ledCh3 wartość logiczna tak Dioda LED kanału 3 state.ledCh4 wartość logiczna tak Dioda LED kanału 4 Odpowiedź 200 {} POST /api/debug/led/stop/ Zatrzymuje test i przywraca normalny tryb sygnalizacji. Żądanie Treść żądania nie jest wymagana. Odpowiedź 200 {} Logika rdzenia automatycznie przywraca normalny tryb po upływie limitu czasu, nawet jeśli klient nie wywoła stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/lwip-stats/ Migawka wewnętrznych liczników stosu lwIP: statystyki poszczególnych protokołów i stan pul memp. Źródłem danych jest globalna struktura lwip_stats (lwip/stats.h). Dostępne pola zależą od flag *_STATS w pliku lwipopts.h. Jeśli flaga jest wyłączona, odpowiedni klucz jest pomijany w odpowiedzi. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "proto": { "link": { "recv": 1234, "xmit": 1100, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0 }, "etharp": { "recv": 200, "xmit": 180, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0, "cachehit": 950 }, "ip": { "recv": 1000, "xmit": 950, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0 }, "icmp": { "recv": 4, "xmit": 4, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0 }, "udp": { "recv": 50, "xmit": 50, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0 }, "tcp": { "recv": 800, "xmit": 760, "drop": 0, "chkerr": 0, "lenerr": 0, "memerr": 0, "rterr": 0, "proterr": 0, "opterr": 0, "err": 0 } }, "memp": [ { "name": "RAW_PCB", "avail": 0, "used": 0, "max": 0, "err": 0 }, { "name": "UDP_PCB", "avail": 8, "used": 1, "max": 1, "err": 0 }, { "name": "TCP_PCB", "avail": 16, "used": 2, "max": 5, "err": 0 }, { "name": "TCP_PCB_LISTEN", "avail": 4, "used": 2, "max": 2, "err": 0 }, { "name": "TCP_SEG", "avail": 20, "used": 0, "max": 8, "err": 0 }, { "name": "PBUF", "avail": 4, "used": 0, "max": 2, "err": 0 }, { "name": "PBUF_POOL", "avail": 40, "used": 0, "max": 12, "err": 0 } ] } proto.<name> (struct stats_proto) Każda grupa reprezentuje jeden protokół. Nazwa jest uwzględniana tylko wtedy, gdy odpowiednia opcja *_STATS = 1 jest ustawiona w pliku lwipopts.h. Pole Typ Opis recv liczba Odebrane pakiety xmit liczba Wysłane pakiety drop liczba Odrzucone pakiety chkerr liczba Błędy sumy kontrolnej lenerr liczba Błędy długości memerr liczba Nieudane przydziały pamięci rterr liczba Błędy routingu proterr liczba Błędy protokołu opterr liczba Błędy opcji err liczba Pozostałe błędy cachehit liczba Tylko etharp: trafienia w pamięci podręcznej ARP Możliwe klucze obiektu proto: link, etharp, ip, icmp, udp i tcp. (Odpowiadają one flagom LINK_STATS, ETHARP_STATS, IP_STATS, ICMP_STATS, UDP_STATS i TCP_STATS). memp[] (struct stats_mem) Tablica zawierająca po jednym elemencie dla każdej puli memp. Pole name jest krótkim identyfikatorem puli z wyliczenia memp_t, bez prefiksu MEMP_. Pole Typ Opis name ciąg znaków Nazwa puli (na przykład TCP_PCB lub PBUF_POOL) avail liczba Pojemność puli (liczba elementów) used liczba Bieżąca liczba używanych elementów max liczba Szczytowa wartość used podczas działania err liczba Liczba nieudanych przydziałów z puli Ten blok jest obecny tylko wtedy, gdy MEMP_STATS = 1.

Novatek-Electro TR-100E Documentation

GET /api/debug/menu/ Bieżący stan menu interfejsu na potrzeby automatycznych testów nawigacji. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "isActive": 1, "depth": 0, "selectedIndex": 2, "itemCount": 5, "groupId": 1, "mode": 0 } Pola odpowiedzi Pole Typ Opis isActive liczba Określa, czy menu jest aktywne (1) albo nie (0) depth liczba Bieżący poziom zagnieżdżenia selectedIndex liczba Indeks wybranego elementu itemCount liczba Liczba elementów w bieżącej grupie groupId liczba Identyfikator bieżącej grupy menu mode liczba Tryb: 0 = NAV, 1 = EDIT

Novatek-Electro TR-100E Documentation

GET /api/debug/network/ Diagnostyka niskopoziomowego stosu sieciowego: warstwa PHY i adres MAC. Informacje o stanie serwera HTTP (połączeniach, sesjach i porcie) znajdują się w grupie httpd opisanej w pliku state-get.md. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "phy": { "linkUp": true, "speed": 100, "fullDuplex": true, "autoNegComplete": true, "mac": "AA:BB:CC:DD:EE:FF", "macSource": "EUI48" } } Pola odpowiedzi Pole Typ Opis phy.linkUp wartość logiczna Określa, czy nawiązano połączenie Ethernet phy.speed liczba Prędkość połączenia (Mbit/s): 10 albo 100 phy.fullDuplex wartość logiczna Określa, czy tryb pełnego dupleksu jest aktywny phy.autoNegComplete wartość logiczna Określa, czy automatyczna negocjacja została ukończona phy.mac ciąg znaków Adres MAC interfejsu (AA:BB:CC:DD:EE:FF) phy.macSource ciąg znaków "EUI48" (z pamięci flash) albo "FALLBACK" (z oprogramowania układowego)

Novatek-Electro TR-100E Documentation

POST /api/debug/relay/start/ and POST /api/debug/relay/stop/ Test serwisowy przekaźników. Uwierzytelnianie: Bearer (powerUser). Tryb diagnostyczny musi być aktywny. W przeciwnym razie punkty końcowe zwracają 403 ERROR_NO_ACCESS. POST /api/debug/relay/start/ Wymuś stany testowe przekaźników. Żądanie { "state": { "trip": true, "alarm": false, "fan": false, "fault": false } } Pole Typ Wymagane Opis state obiekt tak Stany przekaźników state.trip wartość logiczna tak Przekaźnik wyzwalający state.alarm wartość logiczna tak Przekaźnik alarmowy state.fan wartość logiczna tak Przekaźnik wentylatora state.fault wartość logiczna tak Przekaźnik sygnalizacji usterki Odpowiedź 200 {} POST /api/debug/relay/stop/ Zatrzymaj test i przywróć sterowanie standardowej logice. Żądanie Treść żądania nie jest wymagana. Odpowiedź 200 {} Główna logika automatycznie przywraca standardowe sterowanie po upływie limitu czasu, nawet jeśli klient nie wywoła operacji stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/settings/ Pobiera stan obu banków ustawień trwałych niezależnie od źródła bieżących ustawień używanych w czasie pracy. Uwierzytelnianie: Bearer (powerUser). Tryb diagnostyczny nie jest wymagany. W tym trybie niejawne uprawnienia powerUser umożliwiają sprawdzanie banków bez tokena Bearer. Odpowiedź 200 { "runtimeSource": "builtIn", "bootBank": 2, "banks": [ { "bank": 1, "valid": false }, { "bank": 2, "valid": true, "sequence": 15, "isDefault": true, "savedAt": "2026-09-18T10:05:00Z", "dataLength": 512, "dataCrc32": "87654321", "headerCrc32": "10fedcba" } ] } Pola odpowiedzi Pole Typ Opis runtimeSource ciąg znaków Źródło bieżących ustawień używanych w czasie pracy: builtIn, bank1 albo bank2 bootBank liczba | null Bank wybrany podczas zwykłego rozruchu: 1, 2 albo null, jeśli oba banki są nieprawidłowe banks tablica Stan dwóch fizycznych banków ustawień banks[].bank liczba Numer banku: 1 albo 2 banks[].valid wartość logiczna Wynik pełnej weryfikacji nagłówka, wersji oprogramowania układowego, długości i CRC danych banks[].sequence liczba Numer sekwencji rekordu; obecny tylko dla prawidłowego banku banks[].isDefault wartość logiczna Określa, czy dane odpowiadają obowiązującym ustawieniom fabrycznym; obecne tylko dla prawidłowego banku banks[].savedAt ciąg znaków | null Czas zapisu w formacie ISO 8601 UTC; obecny tylko dla prawidłowego banku banks[].dataLength liczba Długość danych użytkowych; obecna tylko dla prawidłowego banku banks[].dataCrc32 ciąg znaków Suma kontrolna CRC32 danych użytkowych zapisana jako osiem znaków szesnastkowych; obecna tylko dla prawidłowego banku banks[].headerCrc32 ciąg znaków Suma kontrolna CRC32 nagłówka zapisana jako osiem znaków szesnastkowych; obecna tylko dla prawidłowego banku Wartości runtimeSource i bootBank mogą się różnić. Na przykład w trybie diagnostycznym środowisko wykonawcze używa builtIn, natomiast zwykły rozruch wybiera najnowszy prawidłowy bank pamięci flash. Jeśli oba banki są prawidłowe, bootBank wskazuje bank z nowszą wartością sequence, z uwzględnieniem zawinięcia uint32_t. Jeśli wartości sequence są równe, wybierany jest bank 1. Pola nagłówka nie są zwracane dla nieprawidłowego banku, ponieważ ich wartości nie są uznawane za wiarygodne. Walidacja ustawień fabrycznych Zapisane ustawienia są uznawane za fabryczne, jeśli bootBank nie jest null, a wskazany bank ma valid: true i isDefault: true. Drugi, starszy bank może zawierać ustawienia niestandardowe i nie wpływa na wynik.

Novatek-Electro TR-100E Documentation

GET /api/debug/system/ Ogólna diagnostyka systemu: taktowanie zegara RTC, przyczyna resetu i stan podsystemów. Uwierzytelnianie: Bearer (powerUser). Odpowiedź 200 { "core": "ARM32", "uptimeSec": 86421, "cpuFreqMHz": 168, "resetReason": "Power on", "rtcSource": "LSE", "rtcTime": "2026-07-09T12:34:56Z", "rtcSync": "NTP", "readyFlags": { "settings": true, "calibration": true, "rtc": true, "button": true, "led": true, "lcd": true, "extmem": true, "identity": true, "logger": true, "temprec": true, "temphistory": true, "msr": true, "random": true, "eth": true, "lwip": true, "httpd": true, "sntp": false, "wireguard": false, "modbus": true } } Pola odpowiedzi Pole Typ Opis core ciąg znaków Architektura rdzenia: "ARM32" uptimeSec liczba Czas pracy od włączenia zasilania (w sekundach) cpuFreqMHz liczba Częstotliwość rdzenia (SystemCoreClock / 1000000) resetReason ciąg znaków Przyczyna ostatniego resetu rtcSource ciąg znaków Źródło zegara RTC: "LSE", "LSI" albo "UNKNOWN" rtcTime ciąg znaków Bieżący czas zegara RTC w UTC (UTC+0) rtcSync ciąg znaków Źródło, które ostatnio ustawiło czas zegara RTC: "NONE", "BACKUP", "NTP" albo "MANUAL" readyFlags obiekt Wartości logiczne wskazujące stan inicjalizacji podsystemów Wartości resetReason Wartość Flaga RCC_CSR Opis "Power on" RCC_CSR_PORRSTF Reset po włączeniu zasilania "Reset pin" RCC_CSR_PADRSTF Reset zewnętrzny (przycisk RESET) "Watchdog" RCC_CSR_WDGRSTF Reset przez układ nadzorujący "Software" RCC_CSR_SFTRSTF Reset programowy (NVIC_SystemReset()) "Low power" RCC_CSR_LPWRRSTF Reset w trybie niskiego poboru energii "Unknown" — Nieznana przyczyna Wartości rtcSource "LSE" — zewnętrzny rezonator kwarcowy 32.768 kHz (dokładny). "LSI" — wewnętrzny oscylator RC (dryft ±5%). "UNKNOWN" — źródło nie zostało określone. Wartości rtcSync "NONE" — zegar RTC został uruchomiony z czasem domyślnym; nie przeprowadzono synchronizacji ani przywracania czasu. "BACKUP" — podczas uruchamiania przywrócono czas z domeny zapasowej. "NTP" — czas ustawiono w wyniku synchronizacji SNTP/NTP. "MANUAL" — czas ustawiono ręcznie za pomocą interfejsu użytkownika, API lub Modbus. Pola readyFlags settings, calibration, rtc, button, led, lcd, extmem, identity, logger, temprec, temphistory, msr, random, eth, lwip, httpd, sntp, wireguard, modbus

Novatek-Electro TR-100E Documentation

GET /api/debug/tasks/ Migawka diagnostyczna bieżących zadań systemu RTOS i minimalnego zapasu wolnego miejsca na ich stosach. Uwierzytelnianie: token Bearer z poziomem dostępu powerUser albo niejawny dostęp powerUser w trybie diagnostycznym. Odpowiedź 200 { "tasks": [ { "number": 1, "name": "Gate", "priority": 5, "stackMinFreeByte": 780, "stackSizeByte": 1024 }, { "number": 2, "name": "Logic", "priority": 4, "stackMinFreeByte": 1248, "stackSizeByte": 1600 } ] } Pola odpowiedzi Pole Typ Opis tasks tablica Lista zadań tasks[].number liczba RTOS xTaskNumber tasks[].name ciąg znaków Nazwa zadania tasks[].priority liczba Priorytet w systemie RTOS tasks[].stackMinFreeByte liczba Najmniejsza ilość wolnego miejsca na stosie w całym okresie działania, w bajtach tasks[].stackSizeByte liczba Całkowity rozmiar stosu, w bajtach Jeśli przydzielenie pamięci nie powiedzie się → 507 ERROR_NO_MEMORY.