Novatek-Electro TR-100E Documentation

Novatek-Electro TR-100E Documentation

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

2026-10-28

Table of Contents

1. 1. Novatek-Electro TR-100E
2. 2. Посібник з експлуатації TR-100E
3. 3. Додаток А: Аварійне відновлення прошивки
4. 4. Додаток Б: Налаштування 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. Сервіс калібрування
27. 27. Підтвердження права власності для Overvis
28. 28. POST /api/service/firmware/apply/
29. 29. Сеанс завантаження прошивки
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/ and 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/ and 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 - цифрове реле температури для контролю до чотирьох температурних зон. Прилад забезпечує релейний захист, журналювання подій і температури, Web-інтерфейс, Modbus TCP та захищений віддалений доступ через VPN WireGuard. Доступна повна документація Переглянути всю документацію на одній сторінці - для друку або читання офлайн. Документація Посібник з експлуатації - монтаж, експлуатація, налаштування, Web-інтерфейс та опис Modbus TCP Додаток А: Аварійне відновлення прошивки - процедура відновлення через завантажувач Додаток Б: Налаштування VPN WireGuard - ручне та автоматичне налаштування VPN через Overvis Довідник HTTP API - автентифікація, стан, налаштування, історія, сервісні та діагностичні кінцеві точки Додаткові ресурси Документація на одній сторінці

Novatek-Electro TR-100E Documentation

Посібник з експлуатації TR-100E ТОВ «НОВАТЕК-ЕЛЕКТРО» інтелектуальна промислова електроніка ЦИФРОВЕ ТЕМПЕРАТУРНЕ РЕЛЕ TR-100E КЕРІВНИЦТВО З ЕКСПЛУАТАЦІЇ (ПАСПОРТ) Керівництво з експлуатації призначене для ознайомлення з пристроєм, принципом дії, правилами експлуатації та налаштування цифрового температурного реле TR-100E. Під час експлуатації та технічного обслуговування необхідно дотримуватися вимог нормативних документів: «Правила технічної експлуатації електроустановок споживачів»; «Правила техніки безпеки під час експлуатації електроустановок споживачів», «Охорона праці під час експлуатації електроустановок». Підключення та технічне обслуговування виробу мають виконувати кваліфіковані фахівці, які вивчили це Керівництво з експлуатації. За умови дотримання правил експлуатації виріб є безпечним у використанні. ОБЕРЕЖНО НА КЛЕМАХ І ВНУТРІШНІХ ЕЛЕМЕНТАХ ВИРОБУ НАЯВНА НЕБЕЗПЕЧНА ДЛЯ ЖИТТЯ НАПРУГА. ДЛЯ ЗАБЕЗПЕЧЕННЯ БЕЗПЕЧНОЇ ЕКСПЛУАТАЦІЇ ВИРОБУ КАТЕГОРИЧНО ЗАБОРОНЯЄТЬСЯ: ВИКОНУВАТИ МОНТАЖНІ РОБОТИ ТА ТЕХНІЧНЕ ОБСЛУГОВУВАННЯ БЕЗ ЗНЕСТРУМЛЕННЯ ВИРОБУ; САМОСТІЙНО ВІДКРИВАТИ ТА РЕМОНТУВАТИ ВИРІБ; ЕКСПЛУАТУВАТИ ВИРІБ ІЗ МЕХАНІЧНИМИ ПОШКОДЖЕННЯМИ КОРПУСУ. ПОТРАПЛЯННЯ ВОДИ НА ВНУТРІШНІ ЕЛЕМЕНТИ ВИРОБУ. УВАГА ВИРІБ НЕ ПРИЗНАЧЕНИЙ ДЛЯ КОМУТАЦІЇ НАВАНТАЖЕННЯ ПРИ КОРОТКИХ ЗАМИКАННЯХ. ТОМУ ВИРІБ ПОВИНЕН ЕКСПЛУАТУВАТИСЯ В ЕЛЕКТРИЧНІЙ МЕРЕЖІ, ЗАХИЩЕНІЙ АВТОМАТИЧНИМ ВИМИКАЧЕМ ІЗ СТРУМОМ ВІДКЛЮЧЕННЯ НЕ БІЛЬШЕ 10 A. ЗАБОРОНЯЄТЬСЯ ПІДКЛЮЧАТИ ДО ВИРОБУ НАВАНТАЖЕННЯ ПОТУЖНІСТЮ ПОНАД 2,5 kW. ТЕРМІНИ ТА СКОРОЧЕННЯ Терміни та скорочення TR-100E – цифрове температурне реле TR-100E; РК-дисплей – рідкокристалічний дисплей, на якому відображається стан роботи TR-100E; Індикатор – світловий елемент на передній панелі, що показує стан каналу, реле або мережевого підключення; Світиться – стан, за якого світлодіодний індикатор постійно увімкнений; Блимає – стан, за якого світлодіодний індикатор періодично вмикається та вимикається; Спалахує – стан, за якого світлодіодний індикатор короткочасно вмикається один раз на секунду; Реле «Вентиляція» – реле, призначене для керування вентиляцією трансформатора; Реле «Тривога» – реле, призначене для сигналізації про перевищення допустимих температур; Реле «Перегрів» – реле, призначене для аварійного вимкнення у разі критичного перегріву; Реле «Відмова» – реле, призначене для сигналізації про несправність TR-100E або датчика; Журнал подій – хронологічний список спрацьовувань реле, несправностей, увімкнень і перезапусків TR-100E; Реєстратор температури – функція періодичного збереження температури вимірювальних каналів; Поріг – задана температура, у разі досягнення якої починається відлік затримки ввімкнення відповідного реле; Уставка – налаштовуване значення порога, гістерезису або затримки; Гістерезис – різниця між температурою ввімкнення та температурою вимкнення реле; Цифровий фільтр – обробка вимірювань, що зменшує вплив короткочасних коливань показань; Енергонезалежна пам’ять – пам’ять, що зберігає налаштування та записи після вимкнення живлення; CH1–CH4 – вимірювальні канали 1–4; TRIP, ALARM, FAN, FAULT – позначення функцій «Перегрів», «Тривога», «Вентиляція» та «Відмова» відповідно; AC, DC – змінний і постійний струм відповідно; SPDT – перемикальний контакт реле; CSV – текстовий формат табличних даних; SCADA – система збору даних і диспетчерського керування; Modbus TCP – протокол обміну даними мережею Ethernet; Web API – програмний інтерфейс для доступу до функцій TR-100E мережею Ethernet; DHCP – протокол автоматичного отримання мережевих налаштувань; DNS – служба перетворення доменних імен на IP-адреси; NTP – протокол синхронізації часу мережею; RTC – годинник реального часу; UTC – всесвітній координований час; DST – сезонне переведення годинника; VPN – захищене мережеве з’єднання; WireGuard – протокол, що використовується TR-100E для створення VPN-з’єднання; CIDR – запис IP-адреси та довжини маски мережі через похилу риску; Час Unix – кількість секунд, що минула з 00:00:00 1 січня 1970 року за UTC. Значення не містить часовий пояс; для відображення місцевого часу TR-100E окремо застосовує налаштоване зміщення відносно UTC та правила DST; $W_{100}$ – відношення опору термодатчика за 100 °C до його опору за 0 °C; $R_{25}$, $R_{100}$ – опір термодатчика за 25 °C і 100 °C відповідно; PTC – додатний температурний коефіцієнт опору; НТС – номінальна температура спрацьовування датчика PTC Minika; Прошивка – програмне забезпечення, що керує роботою TR-100E, яке може бути оновлене для поліпшення функціональності або виправлення помилок; ЗМІСТ ЦИФРОВЕ ТЕМПЕРАТУРНЕ РЕЛЕ TR-100E КЕРІВНИЦТВО З ЕКСПЛУАТАЦІЇ (ПАСПОРТ) ТЕРМІНИ ТА СКОРОЧЕННЯ ЗМІСТ 1 ПРИЗНАЧЕННЯ ТА ТЕХНІЧНІ ХАРАКТЕРИСТИКИ 1.1 Призначення виробу 1.2 Технічні характеристики 1.3 Умови експлуатації 1.4 Зовнішній вигляд і габаритні розміри 1.5 Датчики температури 1.6 Комплект постачання 2 ВИКОРИСТАННЯ ЗА ПРИЗНАЧЕННЯМ 2.1 Підготовка TR-100E до використання 2.1.1 Заходи безпеки 2.2 Використання TR-100E 2.2.1 Принцип дії 2.2.2 Журнал подій 2.2.3 Реєстратор температури 2.2.4 Керування TR-100E 2.2.5 Зміна параметрів (меню налаштувань) 2.2.6 Відновлення заводських установок 2.2.7 Діагностичний режим і тестування TR-100E 2.2.7.1 Перевірка світлодіодної індикації та перегляд мінімальної й максимальної температури каналів 2.2.7.2 Тестування вихідних реле 2.2.8 Оновлення вбудованого програмного забезпечення (прошивки) 2.2.9 Установлення дати, часу та часового поясу 2.3 Програмовані та використовувані параметри TR-100E 2.4 Використання Web-інтерфейсу 2.4.1 Вхід і рівні доступу 2.4.2 Вкладка «Моніторинг» 2.4.3 Вкладка «Реєстратор» 2.4.4 Вкладка «Журнал» 2.4.5 Вкладка «Налаштування» 2.4.6 Вкладка «Сервіс» 2.5 Використання VPN WireGuard 2.5.1 Призначення VPN 2.5.2 Ручне налаштування WireGuard 2.5.3 Автоматичне налаштування через Overvis 2.5.4 Доступ до Web-інтерфейсу та Modbus TCP через VPN 2.6 Використання Modbus TCP 2.7 Мережеві порти 3 ТЕХНІЧНЕ ОБСЛУГОВУВАННЯ 3.1 Заходи безпеки 3.2 Періодичність технічного обслуговування 3.3 Порядок технічного обслуговування: 3.4 Діагностика та усунення несправностей 4 СТРОК СЛУЖБИ ТА ГАРАНТІЯ ВИРОБНИКА 4.1 Строк служби виробу 4.2 Строк зберігання 4.3 Гарантійний строк експлуатації 4.4 Гарантійне обслуговування 4.5 Післягарантійне обслуговування 5 ТРАНСПОРТУВАННЯ ТА ЗБЕРІГАННЯ 1 ПРИЗНАЧЕННЯ ТА ТЕХНІЧНІ ХАРАКТЕРИСТИКИ 1.1 Призначення виробу Цифрове температурне реле TR-100E (далі TR-100E) призначене для вимірювання та контролю температури об’єкта за чотирма датчиками, що підключаються за дво- або трипровідною схемою. TR-100E відображає виміряні значення температури на дисплеї, контролює лінії датчиків на обрив і коротке замикання, формує сигнали керування «Перегрів», «Тривога», «Відмова», «Вентиляція», веде журнал подій (до 2048 записів) і реєстрацію температури із заданим інтервалом (до 16384 записів), а також надає Web-інтерфейс. За потреби TR-100E може бути підключене до системи верхнього рівня (SCADA) за протоколом Modbus TCP або Web API. TR-100E має універсальне живлення: 24–250 V AC/DC. Може застосовуватися для захисту: трифазних сухих трансформаторів із додатковим контролем температури осердя або навколишнього середовища; двигунів і генераторів. Основні можливості: 4 зони контролю (3 — обмотки, 1 — осердя); 4 вихідні реле 8 A, 250 VAC (реле «Перегрів», реле «Тривога», реле «Вентиляція» і реле «Відмова»); Монохромний РК-дисплей 128×64 точки; світлодіодна індикація стану; кнопки керування на передній панелі; Годинник реального часу (RTC) з автономним живленням на 7 днів; Журнал подій на 2048 записів; Реєстратор температури на 16384 записів; порт Ethernet 10/100 Mbit/s; синхронізація часу за NTP; вбудований web-сервер для віддаленого доступу до даних і налаштувань; Підтримка широкого діапазону датчиків температури: Pt100/Pt1000, Ni100/Ni1000, Cu100, Ptc1000/EKS111, KTY83, KTY84, PTC minika. 1.2 Технічні характеристики Основні технічні характеристики наведено в таблиці 1. Таблиця 1 – основні технічні характеристики Параметр Значення Входи Кількість каналів вимірювання 4 Схема підключення датчиків дво- або трипровідна Діапазон вимірюваних температур, °C від мінус 40 до +240 (залежить від типу датчика) Період вимірювання всіх каналів, s не більше 0.5 Клас точності 0.25 Роздільна здатність, °C 0.1 Вимірювальний струм датчика, mA 1.0 Компенсація опору проводів Автоматична за трипровідною схемою (не більше 20 Ω на кожен провід) Довжина проводів, m двопровідна до 5 трипровідна до 10 Контроль обриву/замикання ліній датчиків Так Типи підтримуваних датчиків: --- Pt100/Pt1000 (W₁₀₀=1.3850 / W₁₀₀=1.3910) від мінус 40 до +240 °C Ni100/Ni1000 (W₁₀₀=1.6178) від мінус 40 до +180 °C Cu100 (W₁₀₀=1.4274) від мінус 40 до +200 °C Ptc1000/EKS111 (W₁₀₀=2.0805) від мінус 40 до +100 °C KTY83 (R₂₅=1000 Ω), моделі 110/120/150 від мінус 40 до +175 °C KTY84 (R₁₀₀=1000 Ω), моделі 130/150 від мінус 40 до +200 °C PTC Minika (НТС=60…180 °C) від 60 до 180 °C Виходи Кількість реле, шт. 4 Тип контактів SPDT (перемикальний контакт) Максимальний струм за 250 VAC, A 8 Максимальний струм за 30 VDC, A 3 Максимальна напруга, V 440 AC Максимальна комутована потужність, VA 2500 Строк служби за 8 A 250 VAC, циклів не менше 100000 Строк служби за 3 A 30 VDC, циклів не менше 100000 Категорія використання за IEC 60947-5-1 AC-15 Живлення Номінальна напруга живлення, V 24–250 AC/DC Діапазон напруги живлення, V (DC) 20–100 Діапазон напруги живлення, V (AC) 24–265 Частота змінного струму (AC), Hz 47 - 63 Споживана потужність, VA не більше 10 Журнал подій і реєстрація Ємність журналу подій, записів 2048 Ємність реєстратора, записів 16384 Час реєстрації, s 5–3600 Інтерфейси зв’язку Ethernet 10/100 Mbit/s, RJ-45, Modbus TCP, Web API Індикація та введення/виведення РК-дисплей 128×64 точки Світлодіодна індикація 9 індикаторів Кнопки керування 5 кнопок Додаткові функції Годинник реального часу (RTC) Так, з автономним живленням на 7 днів Синхронізація часу за NTP Так Вбудований вебсервер Так Обмеження доступу до налаштувань Так, з паролем Тест вихідних реле Так Тест індикації Так Оновлення прошивки через Ethernet Так Загальні характеристики Архітектура мікроконтролера 32-бітна ARM Час зберігання даних, років не менше 15 Ступінь захисту корпус IP30, клеми IP20 Клас захисту від ураження електричним струмом II Кліматичне виконання УХЛ3.1 Маса, kg не більше 0.5 Габаритні розміри (ДxШxВ), mm 157×86×58 Категорія перенапруги II Номінальна напруга ізоляції, V 450 Номінальна імпульсна витримувана напруга, kV 2.5 Переріз підключуваних проводів, mm² від 0.5 до 2 Момент затягування клем, N·m 0.4 Тип клем гвинтові, з пружинним затискачем Монтаж на DIN-рейку 35 mm Положення під час монтажу будь-яке 1.3 Умови експлуатації TR-100E призначене для експлуатації в таких умовах: Температура навколишнього середовища: від мінус 20 до +50 °C; Температура зберігання: від мінус 30 до +60 °C; Відносна вологість повітря (при температурі +25 °C): 30 … 80%; Допустимий ступінь забруднення: II; Атмосферний тиск: від 84 до 106,7 kPa. УВАГА TR-100E не призначене для експлуатації в умовах: Значної вібрації або механічних ударів; Високої вологості з конденсацією вологи; Агресивного середовища з умістом у повітрі кислот, лугів, солей або інших корозійно-активних речовин, а також сильних забруднень (жир, олива, пил тощо); 1.4 Зовнішній вигляд і габаритні розміри На рисунку 1 показано зовнішній вигляд і габаритні розміри TR-100E. Світлодіодні індикатори каналів: «Канал 1», «Канал 2», «Канал 3», «Канал 4» (CH1, CH2, CH3, CH4); Світлодіодний індикатор «Відмова» (FAULT); Світлодіодний індикатор «Тривога» (ALARM); Світлодіодний індикатор «Перегрів» (TRIP); Світлодіодний індикатор «Вентиляція» (FAN); Світлодіодний індикатор «Зв’язок Ethernet» (LINK); Клеми для підключення живлення 24–250 V AC/DC; РК-дисплей 128×64 точки; Клеми вихідних реле: «Перегрів», «Тривога», «Вентиляція», «Відмова» (TRIP, ALARM, FAN, FAULT); Кнопка «Вгору» (UP); Кнопка «Вниз» (DOWN); Роз’єм для підключення Ethernet RJ-45; Кнопка «Ввід» (SET); Кнопка «Меню» (MENU); Кнопка «Тест» (TEST); Клеми для підключення датчиків температури. Рисунок 1 – зовнішній вигляд і габаритні розміри 1.5 Датчики температури TR-100E підтримує такі типи датчиків температури: Pt100/Pt1000, Ni100/Ni1000, Cu100, Ptc1000/EKS111, KTY83, KTY84 і PTC minika. Pt100 / Pt1000 — платинові терморезистори з номінальним опором 100 Ω і 1000 Ω за 0 °C відповідно. Характеристика описується коефіцієнтом W₁₀₀=1.3850 (за IEC 60751) або W₁₀₀=1.3910. Діапазон вимірювання: від мінус 40 до +240 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. Ni100 / Ni1000 — нікелеві терморезистори з номінальним опором 100 Ω і 1000 Ω за 0 °C (W₁₀₀=1.6178). Діапазон вимірювання: від мінус 40 до +180 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. Cu100 — мідні терморезистори з номінальним опором 100 Ω за 0 °C (W₁₀₀=1.4274). Діапазон вимірювання: від мінус 40 до +200 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. Ptc1000 / EKS111 — платиновий терморезистор із номінальним опором 1000 Ω за 0 °C і підвищеним температурним коефіцієнтом (W₁₀₀=2.0805). Діапазон вимірювання: від мінус 40 до +100 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. KTY83 — кремнієвий терморезистор із номінальним опором R₂₅=1000 Ω за 25 °C, моделі 110/120/150. Діапазон вимірювання: від мінус 40 до +175 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. KTY84 — кремнієвий терморезистор із номінальним опором R₁₀₀=1000 Ω за 100 °C, моделі 130/150. Діапазон вимірювання: від мінус 40 до +200 °C. Підключаються до каналів 1–4 за дво- або трипровідною схемою. PTC minika — напівпровідникові позистори, що різко збільшують свій електричний опір у разі досягнення номінальної температури спрацьовування (НТС). Датчики випускаються з різними значеннями НТС у діапазоні від 60 до 180 °C з кроком 10 °C. Особливості застосування датчиків PTC minika Датчики PTC minika не є вимірювальними: TR-100E не відображає числове значення температури, доки температура датчика нижча за НТС — на дисплеї відображається символ «< НТС». У разі досягнення НТС і вище на дисплей виводиться значення НТС датчика. Датчики PTC minika можуть з’єднуватися послідовно на один канал (до 6 датчиків), утворюючи ланцюг захисту. Спрацьовування відбувається в разі досягнення НТС будь-яким із датчиків у ланцюгу. Підключення можливе до каналів 1–4 за двопровідною схемою. У параметрі Тип датчика (таблиця 3) для відповідного каналу необхідно вибрати тип PTC Minika, а в параметрі НТС PTC Minika встановити НТС датчика або найменшу НТС у разі послідовного з’єднання датчиків із різними НТС. Пороги реле та участь каналів у керуванні реле налаштовуються відповідними параметрами таблиці 3. TR-100E визначає лише коротке замикання вимірювальної лінії. У разі обриву датчика або ланцюга датчиків реле «Відмова» (FAULT) не спрацьовує — натомість спрацьовує відповідна температурна аварія (реле «Перегрів» (TRIP), «Тривога» (ALARM), «Вентиляція» (FAN)). Холодний опір одного датчика становить 20–250 Ω; у разі послідовного ввімкнення кількох датчиків сумарний холодний опір не повинен перевищувати 1500 Ω. 1.6 Комплект постачання До комплекту постачання входять: цифрове температурне реле TR-100E — 1 шт.; керівництво з експлуатації (паспорт), паперовий примірник — 1 прим.; патч-корд Ethernet — 1 шт.; реєстраційні наклейки з QR/PIN-кодом для реєстрації на сервері Overvis — 2 шт.; індивідуальна картонна коробка — 1 шт. 2 ВИКОРИСТАННЯ ЗА ПРИЗНАЧЕННЯМ 2.1 Підготовка TR-100E до використання 2.1.1 Заходи безпеки Заходи безпеки Усі підключення слід виконувати за знеструмленого TR-100E. Під час проведення випробувань ізоляції трансформаторів на пробій необхідно від’єднувати всі датчики температури від TR-100E. 2.1.2 Підключити TR-100E згідно зі схемою підключення на рисунку 2. УВАГА Усі кабелі, що передають сигнали вимірювання від датчиків температури, обов’язково мають відповідати таким вимогам: виготовлені з екранованого кабелю типу вита пара (трійка) перерізом не менше 0,5 mm²; екрани кабелів датчиків мають бути підключені до заземлення; надійно приєднані до клем приладу; маршрут прокладання кабелів має бути відокремлений від кабелів високої напруги та від кабелів, що живлять індуктивне навантаження; усі кабелі мають бути однакової довжини. Примітка Корпус TR-100E має клас ізоляції II, що не потребує підключення заземлення. Рисунок 2 – схема підключення TR-100E 2.1.3 Увімкнути живлення TR-100E і встановити, за потреби, режими роботи згідно з таблицею 3. 2.2 Використання TR-100E 2.2.1 Принцип дії TR-100E постійно вимірює температуру в 4-х зонах за допомогою підключених датчиків (канали 1–4). Канали 1–3 призначені для контролю температури обмоток трансформатора, а канал 4 — для контролю температури осердя трансформатора або довкілля. Журналювання подій і реєстрація температури здійснюються у фоновому режимі, не впливаючи на основну роботу TR-100E. Збережені дані доступні для перегляду на дисплеї та можуть бути експортовані у файл через Web-інтерфейс. Після увімкнення живлення виконуються контроль цілісності та запуск вбудованого ПЗ, після чого TR-100E переходить на головний екран — основний режим відображення інформації за нормальної роботи (рисунок 3). Рисунок 3 – головний екран TR-100E На головному екрані відображаються: поточний час і дата або IP-адреса TR-100E у мережі Ethernet (чергуються); індикатор роботи реєстратора температури (увімкнений / вимкнений); стан реле: T (TRIP), A (ALARM), F (FAN) (увімкнено / вимкнено, пріоритет відображення T > A > F); індикатор несправності (FAULT); індикатор наявності нових подій у журналі; поточні значення температури каналів КАН-1, КАН-2, КАН-3, КАН-4; тренд зміни температури каналів (зростання / зниження / без змін); Якщо датчик каналу несправний (обрив або коротке замикання), замість значення температури відображається символ помилки: «ОБРИВ» (обрив) або «КЗ» (коротке замикання). Якщо канал налаштований на датчик PTC minika і температура ще не досягла НТС, відображається символ «< НТС». Якщо канал вимкнено (параметр Канал N → Увімкнення = 0, де N — номер каналу; таблиця 3), його поле на екрані залишається порожнім. Окрім головного екрана, для кожного увімкненого каналу доступний екран графіка температури. Графік показує зміну температури каналу за останні 10 хвилин із періодом оновлення 5 s. На екрані відображаються номер каналу, шкала температури та останнє виміряне значення. Масштаб графіка вибирається автоматично. Ця оперативна історія формується після увімкнення TR-100E і не замінює дані реєстратора температури. Для перегляду графіків короткочасно натиснути кнопку «Вгору» (UP) для переходу до наступного екрана або кнопку «Вниз» (DOWN) для переходу до попереднього. Екрани перемикаються циклічно; графіки вимкнених каналів пропускаються. РЕЛЕ «ВЕНТИЛЯЦІЯ» Коли температура одного з датчиків, що беруть участь у керуванні вентиляцією (параметр Вентиляція → Режим, див. табл. 3), перевищить встановлений поріг увімкнення вентиляції Вентиляція → Поріг (див. табл. 3), починається відлік часу Вентиляція → Затримка. При цьому індикатор «Вентиляція» (FAN) починає періодично спалахувати. Після завершення часу затримки Вентиляція → Затримка (див. табл. 3) вмикається реле «Вентиляція» (FAN), а індикатор «Вентиляція» (FAN) починає світитися безперервно. Вимкнення реле «Вентиляція» (FAN) відбудеться у разі зниження температури всіх датчиків, що беруть участь у керуванні вентиляцією, нижче різниці (Вентиляція → Поріг) − (Вентиляція → Гістерезис) (див. табл. 3). При цьому індикатор «Вентиляція» (FAN) гасне. РЕЛЕ «ТРИВОГА» Коли температура одного з датчиків перевищить встановлений поріг увімкнення тривоги Тривога → Поріг (див. табл. 3), починається відлік часу Тривога → Затримка. При цьому індикатор «Тривога» (ALARM) починає періодично спалахувати. Після завершення часу затримки Тривога → Затримка (див. табл. 3) вмикається реле «Тривога» (ALARM), а індикатор «Тривога» (ALARM) починає світитися безперервно. Вимкнення реле «Тривога» (ALARM) відбудеться у разі зниження температури всіх датчиків нижче різниці (Тривога → Поріг) − (Тривога → Гістерезис) (див. табл. 3). При цьому індикатор «Тривога» (ALARM) гасне. РЕЛЕ «ПЕРЕГРІВ» Коли температура одного з датчиків перевищить встановлений поріг увімкнення перегріву Перегрів → Поріг (див. табл. 3), починається відлік часу Перегрів → Затримка. При цьому індикатор «Перегрів» (TRIP) починає періодично спалахувати. Після завершення часу затримки Перегрів → Затримка (див. табл. 3) вмикається реле «Перегрів» (TRIP), а індикатор «Перегрів» (TRIP) починає світитися безперервно. Вимкнення реле «Перегрів» (TRIP) відбудеться у разі зниження температури всіх датчиків нижче різниці (Перегрів → Поріг) − (Перегрів → Гістерезис) (див. табл. 3). При цьому індикатор «Перегрів» (TRIP) гасне. РЕЛЕ «ВІДМОВА» У разі внутрішніх помилок TR-100E або виявлення несправності датчика (обрив або коротке замикання) починається відлік часу Відмова → Затримка (див. табл. 3). Після завершення затримки спрацьовує реле «Відмова» (FAULT), а індикатор «Відмова» (FAULT) починає блимати. На дисплеї відображається стан несправного каналу або код помилки. Вимкнення реле «Відмова» (FAULT) відбудеться після усунення несправності. При цьому індикатор «Відмова» (FAULT) гасне. Стани всіх світлодіодних індикаторів наведено в таблиці 2. Таблиця 2 – Стани світлодіодних індикаторів Індикатор Стан Значення CH1 – CH4 Не світиться Канал справний Блимає Несправність датчика каналу (обрив або коротке замикання) FAULT Не світиться Норма Блимає Виявлено несправність датчика або внутрішню помилку TR-100E ALARM Не світиться Температура всіх каналів нижча за поріг вимкнення, заданий параметрами Тривога → Поріг CH1–CH4 і Тривога → Гістерезис CH1–CH4 Спалахує Температура одного з каналів перевищила відповідний параметр Тривога → Поріг CH1–CH4, триває відлік Тривога → Затримка Світиться Реле «Тривога» увімкнено TRIP Не світиться Температура всіх каналів нижча за поріг вимкнення, заданий параметрами Перегрів → Поріг CH1–CH4 і Перегрів → Гістерезис CH1–CH4 Спалахує Температура одного з каналів перевищила відповідний параметр Перегрів → Поріг CH1–CH4, триває відлік Перегрів → Затримка Світиться Реле «Перегрів» увімкнено FAN Не світиться Реле «Вентиляція» вимкнено Спалахує Температура одного з вибраних каналів перевищила відповідний параметр Вентиляція → Поріг CH1–CH4, триває відлік Вентиляція → Затримка Світиться Реле «Вентиляція» увімкнено LINK Не світиться Немає фізичного підключення до мережі Ethernet Світиться Підключення до мережі Ethernet встановлено Блимає Передавання даних мережею Ethernet 2.2.2 Журнал подій У процесі роботи TR-100E автоматично веде журнал подій у фоновому режимі — жодних дій з боку користувача для цього не потрібно. До журналу записуються значущі події та діагностичні повідомлення про роботу TR-100E. Нижче наведено основні види записів; цей перелік не є вичерпним: спрацювання та вимкнення реле TRIP, ALARM, FAN, FAULT; у разі спрацювання TRIP, ALARM і FAN записуються номер каналу та температура; обрив або коротке замикання вимірювальної лінії, а також відновлення її нормального стану; запуск TR-100E, запланований перезапуск і виявлення попереднього перезапуску сторожовим таймером; результати перевірки пароля під час доступу до налаштувань: успішний вхід, введення неправильного пароля та блокування доступу; збереження налаштувань і помилки під час їх завантаження або збереження; помилки ініціалізації та запису даних реєстратора температури; успішна синхронізація часу за NTP та помилки мережевих служб Web, Modbus TCP, NTP і VPN WireGuard; помилки вимірювання, а також відомості про аварійні збої вбудованого програмного забезпечення. Кожний запис містить дату й час події, її опис і додаткові відомості, що дають змогу з’ясувати причину спрацювання захисту або несправності. Журнал розрахований на 2048 записів. Після досягнення межі нові події продовжують записуватися, витісняючи найстаріші. Дані зберігаються в енергонезалежній пам’яті й не втрачаються у разі вимкнення живлення. Робота з журналом з лицьової панелі: перебуваючи на головному екрані, натиснути й утримувати кнопку «Меню» (MENU) не менше 5 s. За потреби ввести пароль згідно з п. 2.2.5. Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати пункт Журнал подій і натиснути кнопку «Ввід» (SET). Далі виконати потрібну дію: перегляд журналу: вибрати пункт Перегляд списку і натиснути кнопку «Ввід» (SET). Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати запис; для перегляду докладної інформації натиснути кнопку «Ввід» (SET). Для повернення натиснути кнопку «Меню» (MENU); очищення журналу: вибрати пункт Очистити і натиснути кнопку «Ввід» (SET). У вікні підтвердження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Перегляд і експорт через Web-інтерфейс: відкрити Web-інтерфейс TR-100E і перейти на вкладку Журнал. Для збереження журналу у файл events.log натиснути кнопку Експорт LOG. 2.2.3 Реєстратор температури Реєстратор періодично зберігає значення температури всіх чотирьох каналів, що дає змогу аналізувати тепловий режим об’єкта за період, дані якого збережено в пам’яті реєстратора. За замовчуванням реєстратор увімкнено з періодом запису 600 секунд. Період можна змінити в діапазоні від 5 до 3600 секунд параметром Реєстратор → Період запису, а вимкнути реєстратор — параметром Реєстратор → Увімкнення (таблиця 3). Кожний запис містить дату й час вимірювання, температуру всіх чотирьох каналів, а також поточні прапори стану кожного каналу (спрацювання TRIP, ALARM, FAN, несправність датчика). Реєстратор розрахований на 16384 записи. Після досягнення межі нові дані продовжують записуватися, витісняючи найстаріші. Чим менший період запису, тим швидше заповнюється буфер і тим менша глибина збереженої історії. Дані зберігаються в енергонезалежній пам’яті й не втрачаються у разі вимкнення живлення. Приклад глибини зберігання За періоду запису 60 s буфер на 16384 записи вміщує дані приблизно за 11 діб. За періоду 300 s — за 57 діб. За періоду 600 s — за 114 діб. Робота з реєстратором з лицьової панелі: перебуваючи на головному екрані, натиснути й утримувати кнопку «Меню» (MENU) не менше 5 s. За потреби ввести пароль згідно з п. 2.2.5. Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати пункт Реєстратор і натиснути кнопку «Ввід» (SET). Далі виконати потрібну дію: перегляд записів: вибрати пункт Перегляд списку і натиснути кнопку «Ввід» (SET). Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати запис; для перегляду докладної інформації натиснути кнопку «Ввід» (SET). Для повернення натиснути кнопку «Меню» (MENU); очищення записів: вибрати пункт Очистити і натиснути кнопку «Ввід» (SET). У вікні підтвердження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Перегляд і експорт через Web-інтерфейс: відкрити Web-інтерфейс TR-100E і перейти на вкладку Реєстратор. Для збереження записів у файл recorder.csv натиснути кнопку Експорт CSV. 2.2.4 Керування TR-100E Керування TR-100E здійснюється кнопками, розташованими на передній панелі (рис. 1, пп. 10, 11, 13–15): кнопка «Тест» (TEST) – для входу в режим перевірки світлодіодної індикації та перегляду мінімальної й максимальної температури каналів; кнопка «Меню» (MENU) – для входу в режим перегляду та зміни параметрів і виходу з нього; кнопка «Ввід» (SET) – для входу в параметр, підтвердження зміни параметра та переходу назад до меню; кнопки «Вгору» (UP) і «Вниз» (DOWN) – для перегортання параметрів і зміни значення параметра. 2.2.5 Зміна параметрів (меню налаштувань) Для входу в режим зміни параметрів, перебуваючи на головному екрані, натиснути й утримувати кнопку «Меню» (MENU) не менше 5 s. Якщо доступ захищено паролем, ввести пароль згідно з наведеною нижче інструкцією. У разі правильного введення на дисплеї відображається повідомлення Пароль принят, після чого відкривається меню параметрів. У разі неправильного введення відображається кількість спроб, що залишилися. Після п’яти невдалих спроб доступ блокується на 5 хвилин. Заводський пароль зазначено на наклейці з QR-кодом. У меню Доступ можна змінити паролі й незалежно увімкнути або вимкнути їх перевірку. Вимкнення перевірки не видаляє збережений пароль. Пароль локального доступу має містити 4…23 символи, паролі Web і Modbus — 8…23 символи. Поточні паролі не відображаються: у разі вибору пункту Змінити пароль введення починається з порожнього поля, скасування зберігає попереднє значення. Введення пароля Пароль вводиться з екранної клавіатури. Доступні розкладки рядкових і великих латинських літер, цифр і символів ., -, _, :, /, @: Короткочасне натискання UP/DOWN переміщує виділення між клавішами, утримання UP/DOWN — між рядками; Кнопка SET активує виділену клавішу: вводить символ, видаляє попередній символ, перемикає розкладку (abc, ABC, 123, #+=) або підтверджує введення клавішею OK; Скасування введення пароля – кнопка «Меню» (MENU); Під час введення пароля для входу доступна клавіша OK. Під час зміни пароля в меню налаштувань клавіша OK не відображається: перше натискання MENU закриває екранну клавіатуру, повторне — виходить із редактора та пропонує застосувати зміни. Відмова від застосування зберігає попередній пароль. За відсутності натискань будь-якої з кнопок протягом 60 s TR-100E перейде на головний екран. Навігація меню Перегортання параметрів - кнопки «Вгору» і «Вниз» (UP/DOWN); Вхід у параметр – кнопка «Ввід» (SET); Зміна параметра – кнопками «Вгору» і «Вниз» (UP/DOWN); Запис параметра і перехід назад до меню – кнопка «Ввід» (SET); Перехід назад до меню без запису – кнопка «Меню» (MENU). Для рядкових параметрів, наприклад адрес серверів NTP, кнопка SET відкриває екранну клавіатуру. Керування клавіатурою виконується так само, як під час введення пароля; набір доступних символів залежить від параметра. Кнопка MENU закриває клавіатуру. Поза клавіатурою UP/DOWN переміщують курсор по рядку, а повторне натискання MENU завершує редагування та пропонує застосувати зміни. Автоматичний вихід із меню виконується за відсутності натискань будь-якої з кнопок протягом 60 s. 2.2.6 Відновлення заводських установок Існує два способи виконати відновлення заводських установок: Спосіб 1 - скидання налаштувань через меню Увійти в меню параметрів згідно з п. 2.2.5 і вибрати Система → Скидання налаштувань. У вікні підтвердження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Заводські значення буде завантажено до робочої копії налаштувань, але ще не буде записано до flash-пам’яті. Вибрати Система → Зберегти налаштування. У вікні підтвердження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Переконатися, що на дисплеї з’явилося повідомлення про успішне збереження налаштувань. У разі повідомлення про помилку повторити збереження; не перезапускати й не вимикати живлення TR-100E, доки налаштування не буде успішно записано. Перезапустити прилад. Спосіб 2 - відновлення через діагностичний режим Увімкнути діагностичний режим згідно з п. 2.2.7. Після появи головного екрана увійти в меню параметрів: натиснути й утримувати кнопку «Меню» (MENU) не менше 5 s. Введення пароля не потрібне. Вибрати Система → Зберегти налаштування. У вікні підтвердження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Переконатися, що на дисплеї з’явилося повідомлення про успішне збереження налаштувань. У разі повідомлення про помилку повторити збереження; не перезапускати й не вимикати живлення TR-100E, доки налаштування не буде успішно записано. Перезапустити прилад. Після збереження паролі користувача замінюються заводськими паролями, зазначеними на наклейці з QR-кодом. 2.2.7 Діагностичний режим і тестування TR-100E Діагностичний режим призначений для проведення сервісних робіт кваліфікованими фахівцями і не використовується під час штатної експлуатації TR-100E. Під час увімкнення діагностичного режиму заводські значення завантажуються до тимчасової робочої копії налаштувань, але не зберігаються до flash-пам’яті автоматично. До наступного перезапуску локальне меню та Web-інтерфейс доступні без введення пароля, а Web-інтерфейсу надається рівень доступу powerUser. Для увімкнення діагностичного режиму: Вимкнути живлення TR-100E. Натиснути й утримувати одночасно кнопки «Вгору» і «Вниз» (UP/DOWN). Подати живлення і продовжувати утримувати кнопки до появи заголовка DIAGNOSTIC MODE і повідомлення User run device in diagnostic mode, після чого відпустити їх. Під час увімкнення режиму в журнал подій записується повідомлення User run device in diagnostic mode. Поки режим активний, на дисплеї періодично відображається попередження про ввімкнений діагностичний режим. Для запуску TR-100E у штатному режимі перезапустити прилад без утримання кнопок «Вгору» і «Вниз» або вимкнути й повторно подати живлення. Якщо налаштування не були збережені, у разі такого запуску прилад завантажить раніше збережені налаштування та відновить штатну перевірку паролів. ВАЖЛИВО Збереження налаштувань у діагностичному режимі запише завантажені заводські значення до flash-пам’яті й замінить паролі користувача заводськими. Не виконуйте збереження, якщо потрібна лише діагностика приладу. 2.2.7.1 Перевірка світлодіодної індикації та перегляд мінімальної й максимальної температури каналів Для перевірки світлодіодної індикації необхідно, перебуваючи на головному екрані, натиснути кнопку «Тест» (TEST). TR-100E перейде до окремого екрана тестування, увімкне всі світлодіодні індикатори та відобразить для кожного каналу мінімальну й максимальну зареєстровану температуру. Важливо Якщо хоча б один з індикаторів не функціонуватиме, TR-100E вважається несправним і потребує ремонту. Під час тестування індикації TR-100E продовжує своє нормальне функціонування. Для виходу з режиму тестування натиснути кнопку «Меню» (MENU). За відсутності натискань кнопок протягом 60 s тестовий екран закривається автоматично. Максимальна температура Мінімальна й максимальна температури каналів реєструються з моменту останнього увімкнення живлення TR-100E або з моменту останнього скидання максимальної температури. 2.2.7.2 Тестування вихідних реле Увага Тестування реле є потенційно небезпечною операцією. Перед його виконанням необхідно знеструмити навантаження або переконатися, що перемикання реле не призведе до небезпечної ситуації чи пошкодження обладнання. Порядок тестування: Увійти в меню параметрів згідно з п. 2.2.5 і вибрати Система → Тестування реле. У вікні попередження кнопкою «Вгору» (UP) вибрати Так і натиснути кнопку «Ввід» (SET). Відкриється екран зі списком реле TRIP, ALARM, FAN і FAULT та їхнім поточним тестовим станом: Увімк. або Вимк. Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати потрібне реле. Натиснути кнопку «Ввід» (SET). Вибране реле перемкнеться, а його стан на екрані зміниться. Повторне натискання кнопки «Ввід» (SET) поверне реле до попереднього стану. Повторити перевірку для решти реле. Для завершення тестування натиснути кнопку «Меню» (MENU). Тестові стани всіх реле буде вимкнено, після чого TR-100E повернеться до меню параметрів. 2.2.8 Оновлення вбудованого програмного забезпечення (прошивки) TR-100E підтримує два способи оновлення вбудованого програмного забезпечення без використання програматора: штатне оновлення через Web-інтерфейс TR-100E; аварійне оновлення через режим відновлення завантажувача (Recovery mode), якщо штатний Web-інтерфейс недоступний. Для оновлення використовується файл прошивки TR-100E у форматі .ota. Спосіб 1 - штатне оновлення через Web-інтерфейс Переконатися, що TR-100E підключений до мережі Ethernet і доступний через браузер. Увійти до Web-інтерфейсу з рівнем доступу powerUser і відкрити вкладку Сервіс. У блоці Оновлення прошивки натиснути кнопку Завантажити файл і вибрати файл прошивки у форматі .ota. Дочекатися завершення завантаження та перевірки файлу. Після успішної перевірки відобразяться відомості про образ прошивки і стануть доступними кнопки Застосувати та Видалити. Кнопка Видалити видаляє завантажений образ без установлення. Натиснути кнопку Застосувати і підтвердити оновлення. TR-100E перезапуститься, завантажувач встановить прошивку, після чого пристрій запуститься автоматично. Спосіб 2 - аварійне оновлення через завантажувач Підключити TR-100E і комп’ютер до мережі Ethernet. Вимкнути живлення TR-100E, натиснути й утримувати кнопку «Меню» (MENU), потім подати живлення. Після появи меню завантажувача відпустити кнопку. Кнопками «Вгору» / «Вниз» (UP/DOWN) вибрати пункт Recovery mode і натиснути кнопку «Ввід» (SET). Дочекатися появи на дисплеї екрана Recovery mode. У цьому режимі TR-100E використовує статичну IP-адресу 192.168.1.48 і маску мережі 255.255.255.0. Установити на комп’ютері статичну IP-адресу з тієї самої підмережі, наприклад 192.168.1.2 з маскою 255.255.255.0, і відкрити в браузері адресу http://192.168.1.48. На сторінці TR-100E Recovery вибрати файл прошивки у форматі .ota і натиснути кнопку Send. Дочекатися завершення завантаження та перевірки файлу. Після успішної перевірки значення imageValid стане true і стане доступною кнопка Firmware. Натиснути кнопку Firmware. TR-100E перезапуститься, встановить прошивку й запуститься автоматично. Докладний порядок дій, відновлення раніше завантаженого образу та розшифрування повідомлень завантажувача наведено в «Додатку А. Аварійне відновлення прошивки». Увага Використовуйте лише призначений для TR-100E файл прошивки у форматі .ota. Не вимикайте живлення TR-100E після запуску встановлення прошивки. Переривання встановлення може призвести до пошкодження вбудованого програмного забезпечення. Під час перезапуску та встановлення прошивки TR-100E не здійснює контроль температури і не керує реле. Перед початком встановлення переконайтеся, що це не призведе до небезпечної ситуації чи пошкодження обладнання. Версія прошивки Поточна версія прошивки відображається на дисплеї TR-100E під час увімкнення і в блоці Інформація про пристрій на вкладці Сервіс Web-інтерфейсу. 2.2.9 Установлення дати, часу та часового поясу TR-100E використовує годинник реального часу (RTC) для позначення часу в журналі подій і реєстраторі. Дату й час можна встановити вручну з лицьової панелі або через Web-інтерфейс. Також доступна автоматична синхронізація часу за NTP. Установлення дати й часу з лицьової панелі: Увійти в меню параметрів згідно з п. 2.2.5 і вибрати Дата і час → Дата. Кнопками «Вгору» / «Вниз» (UP/DOWN) установити день. Кнопкою «Ввід» (SET) послідовно перейти до місяця й року та встановити їх значення. Після встановлення року натиснути кнопку «Ввід» (SET) для запису дати до годинника реального часу. Вибрати Дата і час → Час. Кнопками «Вгору» / «Вниз» (UP/DOWN) установити години. Кнопкою «Ввід» (SET) послідовно перейти до хвилин і секунд та встановити їх значення. Після встановлення секунд натиснути кнопку «Ввід» (SET) для запису часу до годинника реального часу. Для скасування введення без запису натиснути кнопку «Меню» (MENU). Установлення дати й часу через Web-інтерфейс: Увійти до Web-інтерфейсу з рівнем доступу powerUser і відкрити Налаштування → Дата і час. У блоці Установлення часу вказати місцеві дату й час. Натиснути кнопку Установити вручну. Задане значення буде записано до годинника реального часу одразу; натискання кнопки Зберегти для цього не потрібне. Часовий пояс: У розділі Налаштування → Дата і час у полі Часовий пояс вибрати потрібне зміщення відносно UTC, наприклад UTC+02:00 або UTC+03:00. Вибраний часовий пояс застосовується під час відображення місцевого часу. Для збереження налаштування натиснути кнопку Зберегти. Літній час (DST): У полі Режим DST доступні такі значення: Вимкн — сезонне переведення часу вимкнено; Europe — переведення на одну годину виконується в останню неділю березня, повернення на стандартний час — в останню неділю жовтня; USA — переведення на одну годину виконується в другу неділю березня, повернення на стандартний час — у першу неділю листопада; Вручну — користувач задає Зсув DST, а також місцеві дату й час початку та закінчення його дії. Після зміни режиму DST і пов’язаних із ним параметрів натиснути кнопку Зберегти. Примітка Синхронізація налаштовується окремо в розділі Налаштування → NTP. Якщо NTP увімкнено, вручну встановлений час буде замінено під час наступної успішної синхронізації. Запас ходу RTC RTC забезпечує хід годинника за відсутності основного живлення не більше 7 діб. Після закінчення цього часу показання годинника можуть скинутися. Після тривалого знеструмлення необхідно перевірити й за потреби скоригувати час вручну або переконатися, що синхронізацію за NTP виконано успішно. 2.3 Програмовані та використовувані параметри TR-100E Повний перелік збережуваних параметрів наведено в таблиці 3. У колонці «Адреса Holding-регістру» знак — означає, що параметр не передається через Modbus TCP і налаштовується через меню, Web-інтерфейс або Web API. Таблиця 3 – Програмовані та використовувані параметри Адреса Holding-регістру Параметр Діапазон / значення Заводське налаштування Доступ Modbus Тип — Загальні — — — — 100 Мова 0 англійська; 1 польська; 2 українська; 3 російська 0 (англійська) З+Ч uint16 — Дата й час — — — — 101 Зсув часового поясу, min -720…840 0 З+Ч int16 102 Режим DST 0 вимкнено; 1 ЄС; 2 США; 3 ручний 0 (вимкнено) З+Ч uint8 103 Зсув DST, min 0…180 60 З+Ч int16 104–105 Початок DST, місцевий час Час Unix 1774749600 З+Ч uint32 106–107 Закінчення DST, місцевий час Час Unix 1792897200 З+Ч uint32 — Дисплей — — — — 108 Контраст дисплея 0…64 24 З+Ч uint16 109 Активна підсвітка, % 0…100 50 З+Ч uint16 110 Чергова підсвітка, % 0…100 15 З+Ч uint16 111 Тайм-аут чергової підсвітки, s 30…3600 300 З+Ч uint16 112 Увімкнення чергової підсвітки 0…1 1 З+Ч uint8 — Доступ — — — — — Пароль пристрою — — — — — Захист 0 вимкнено; 1 увімкнено 1 — uint8 — Змінити пароль 4…23 символи Пароль з наклейки — рядок — Пароль WEB користувача — — — — — Захист 0 вимкнено; 1 увімкнено 1 — uint8 — Змінити пароль 8…23 символи Пароль з наклейки — рядок — Пароль WEB адміністратора — — — — — Захист 0 вимкнено; 1 увімкнено 1 — uint8 — Змінити пароль 8…23 символи Пароль з наклейки — рядок — Пароль Modbus — — — — — Захист 0 вимкнено; 1 увімкнено 1 — uint8 — Змінити пароль 8…23 символи Пароль з наклейки — рядок — Реєстратор — — — — 113 Увімкнення 0…1 1 З+Ч uint8 114 Період запису, s 5…3600 600 З+Ч uint16 — TCP/IP — — — — — Увімкнення Ethernet 0…1 1 — uint8 115 DHCP 0…1 1 З+Ч uint8 116–117 DNS 1 IPv4 8.8.8.8 З+Ч uint32 118–119 DNS 2 IPv4 4.4.4.4 З+Ч uint32 120–121 Статична IP-адреса IPv4 192.168.0.100 З+Ч uint32 122–123 Маска мережі IPv4 255.255.255.0 З+Ч uint32 124–125 Шлюз IPv4 192.168.0.1 З+Ч uint32 — Синхронізація часу (NTP) — — — — 126 Увімкнення 0…1 0 З+Ч uint8 127–128 Період синхронізації, s 300…86400 3600 З+Ч uint32 129–144 Сервер 1 DNS-ім’я або IPv4, до 31 символу pool.ntp.org З+Ч str16 145–160 Сервер 2 DNS-ім’я або IPv4, до 31 символу time.google.com З+Ч str16 — VPN WireGuard — — — — — Увімкнення 0…1 0 — uint8 — Автоналаштування через Overvis 0…1 1 — uint8 — URL автоналаштування URL Порожньо — рядок — Приватний ключ 32 байти Не задано — байти — IP-адреса IPv4 з довжиною префікса Не задано — IPv4/CIDR — Публічний ключ вузла 32 байти Не задано — байти — Ім’я вузла DNS-ім’я або IPv4 Порожньо — рядок — Порт вузла 1…65535 51820 — uint16 — Дозволені мережі 1–2 IPv4 з довжиною префікса Не задані — IPv4/CIDR × 2 — Період підтримання з’єднання, s 1…300 25 — uint16 — Web-доступ — — — — 161 Увімкнення 0…1 1 З+Ч uint8 162 Порт 1…65535 80 З+Ч uint16 163 Доступ через VPN 0…1 1 Ч uint8 164 Рівень доступу через VPN 0 гостьовий; 1 звичайний; 2 розширений 0 Ч uint8 — Modbus TCP — — — — 165 Увімкнення 0…1 1 З+Ч uint8 166 UID 0…247; 0 — будь-який UID 48 З+Ч uint8 167 Порт 1…65535 502 З+Ч uint16 168 Тайм-аут, s 0 вимкнено; 1…3600 0 З+Ч uint16 169 Режим захисту 0 немає; 1 запис; 2 читання і запис 1 З+Ч uint8 170 Доступ через VPN 0 заборонено; 1 за загальним захистом; 2 лише читання; 3 читання та запис 0 Ч uint8 — Канал 1 — — — — 171 Увімкнення 0…1 1 З+Ч uint8 172 Тип датчика 0…14, див. примітку до таблиці 3 0 З+Ч uint16 173 Корекція, °C -10…+10 0 З+Ч int16 ×10 174 НТС PTC Minika, °C 60…180 160 З+Ч int16 ×10 175 Пов’язані уставки 0…1 1 З+Ч uint8 — Канал 2 — — — — 176 Увімкнення 0…1 1 З+Ч uint8 177 Тип датчика 0…14, див. примітку до таблиці 3 0 З+Ч uint16 178 Корекція, °C -10…+10 0 З+Ч int16 ×10 179 НТС PTC Minika, °C 60…180 150 З+Ч int16 ×10 180 Пов’язані уставки 0…1 1 З+Ч uint8 — Канал 3 — — — — 181 Увімкнення 0…1 1 З+Ч uint8 182 Тип датчика 0…14, див. примітку до таблиці 3 0 З+Ч uint16 183 Корекція, °C -10…+10 0 З+Ч int16 ×10 184 НТС PTC Minika, °C 60…180 60 З+Ч int16 ×10 185 Пов’язані уставки 0…1 1 З+Ч uint8 — Канал 4 — — — — 186 Увімкнення 0…1 1 З+Ч uint8 187 Тип датчика 0…14, див. примітку до таблиці 3 0 З+Ч uint16 188 Корекція, °C -10…+10 0 З+Ч int16 ×10 189 НТС PTC Minika, °C 60…180 130 З+Ч int16 ×10 190 Пов’язані уставки 0…1 0 З+Ч uint8 — Цифровий фільтр — — — — 191 Загальний рівень фільтра 1…10 4 З+Ч uint8 — Перегрів (TRIP) — — — — 192 Поріг CH1, °C -40…240 155 З+Ч int16 ×10 193 Гістерезис CH1, °C 0…100 10 З+Ч int16 ×10 194 Поріг CH2, °C -40…240 155 З+Ч int16 ×10 195 Гістерезис CH2, °C 0…100 10 З+Ч int16 ×10 196 Поріг CH3, °C -40…240 155 З+Ч int16 ×10 197 Гістерезис CH3, °C 0…100 10 З+Ч int16 ×10 198 Поріг CH4, °C -40…240 155 З+Ч int16 ×10 199 Гістерезис CH4, °C 0…100 10 З+Ч int16 ×10 200 Затримка, s 0…60 5 З+Ч uint16 — Тривога (ALARM) — — — — 201 Поріг CH1, °C -40…240 145 З+Ч int16 ×10 202 Гістерезис CH1, °C 0…100 10 З+Ч int16 ×10 203 Поріг CH2, °C -40…240 145 З+Ч int16 ×10 204 Гістерезис CH2, °C 0…100 10 З+Ч int16 ×10 205 Поріг CH3, °C -40…240 145 З+Ч int16 ×10 206 Гістерезис CH3, °C 0…100 10 З+Ч int16 ×10 207 Поріг CH4, °C -40…240 145 З+Ч int16 ×10 208 Гістерезис CH4, °C 0…100 10 З+Ч int16 ×10 209 Затримка, s 0…60 5 З+Ч uint16 — Вентиляція (FAN) — — — — 210 Поріг CH1, °C -40…240 130 З+Ч int16 ×10 211 Гістерезис CH1, °C 0…100 20 З+Ч int16 ×10 212 Поріг CH2, °C -40…240 130 З+Ч int16 ×10 213 Гістерезис CH2, °C 0…100 20 З+Ч int16 ×10 214 Поріг CH3, °C -40…240 130 З+Ч int16 ×10 215 Гістерезис CH3, °C 0…100 20 З+Ч int16 ×10 216 Поріг CH4, °C -40…240 130 З+Ч int16 ×10 217 Гістерезис CH4, °C 0…100 20 З+Ч int16 ×10 218 Режим 0 вимк.; 1 CH1–3; 2 CH1–4; 3 CH4 0 З+Ч uint16 219 Затримка, s 0…60 5 З+Ч uint16 — Відмова (FAULT) — — — — 220 Затримка, s 0…60 5 З+Ч uint16 Примітка до таблиці 3 Позначення в колонці «Доступ Modbus»: Ч – читання; З – запис; З+Ч – запис і читання. Значення параметра «Тип датчика»: 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. Параметр Пов’язані уставки визначає участь каналу в загальній групі налаштування: 1 — канал пов’язаний, 0 — налаштовується незалежно. У разі зміни порога або гістерезису TRIP, ALARM чи FAN в будь-якого пов’язаного каналу нове значення автоматично встановлюється для всіх пов’язаних каналів. Налаштування затримок та інші параметри каналів не пов’язуються. Зміна самого параметра Пов’язані уставки не вирівнює раніше задані значення; пов’язування застосовується під час наступної зміни порога або гістерезису. У заводських налаштуваннях пов’язані канали CH1–CH3, канал CH4 налаштовується незалежно. Пароль локального доступу та паролі Web/Modbus за замовчуванням збігаються із заводським паролем, зазначеним на наклейці з QR-кодом. Можна задати окремі паролі довжиною 4…23 символи для локального доступу та 8…23 символи для Web/Modbus. Перевірка кожного пароля вмикається окремим параметром захисту. У разі вимкнення захисту пароль зберігається й знову використовується після його увімкнення. 2.4 Використання Web-інтерфейсу Для доступу до Web-інтерфейсу TR-100E потрібен ПК зі встановленим Web-браузером. В адресному рядку Web-браузера введіть поточну IP-адресу TR-100E, що відображається на його дисплеї, і натисніть Enter. 2.4.1 Вхід і рівні доступу Після відкриття Web-інтерфейсу відображається форма введення пароля. TR-100E використовує два незалежні паролі Web-доступу: пароль звичайного користувача — рівень user; пароль розширеного користувача — рівень powerUser. Введений пароль визначає наданий рівень доступу. Користувачу рівня user доступні вкладки Моніторинг, Реєстратор і Журнал. Користувачу рівня powerUser додатково доступні вкладки Налаштування і Сервіс, а також операції очищення журналу та реєстратора. Перевірка Web-паролів user і powerUser вмикається незалежно в розділі Налаштування → Безпека. Якщо перевірку powerUser вимкнено, Web-інтерфейс надає цей рівень без введення пароля. Інакше, якщо перевірку user вимкнено, без пароля надається рівень user. 2.4.2 Вкладка «Моніторинг» Вкладка відображає поточний стан TR-100E: температуру та стан лінії кожного вимірювального каналу; пороги захистів і стан реле TRIP, ALARM, FAN, FAULT; графік історії температури за останні 10 хвилин; поточний час, час роботи, IP-адресу та стан Ethernet; останні події та кількість непрочитаних подій. Непрочитані події можна позначити як переглянуті кнопкою Підтвердити. 2.4.3 Вкладка «Реєстратор» Вкладка відображає кількість збережених записів, період запису, таблицю записів і графіки температур каналів. Доступні: ручне й автоматичне оновлення; вибір порядку записів і кількості записів на сторінці; перехід між сторінками; експорт усіх записів у файл recorder.csv. Очищення реєстратора доступне лише користувачу рівня powerUser. 2.4.4 Вкладка «Журнал» Вкладка відображає події з датою, часом, рівнем важливості та описом. Доступні: ручне й автоматичне оновлення; фільтрація за рівнем важливості; вибір порядку подій і кількості подій на сторінці; перехід між сторінками; підтвердження перегляду непрочитаних подій; експорт журналу в текстовий файл. Очищення журналу доступне лише користувачу рівня powerUser. 2.4.5 Вкладка «Налаштування» Вкладка доступна лише користувачу рівня powerUser. Налаштування подано у вигляді розкривних розділів Канали, Перегрів, Тривога, Вентиляція, Відмова, Мережа, WireGuard, Web-сервер, Modbus TCP, NTP, Дата й час, Реєстратор, Дисплей, Мова і Безпека. Одночасно можна відкрити кілька розділів. Налаштування кожного розділу завантажуються та зберігаються окремо. Кнопка Оновити повторно зчитує налаштування відкритого розділу з TR-100E, кнопка Зберегти записує зміни. Якщо для застосування збережених налаштувань потрібен перезапуск, Web-інтерфейс виводить відповідне попередження; перезапуск автоматично не виконується. У розділі Безпека збережені паролі не відображаються. Щоб залишити пароль без змін, не заповнюйте відповідне поле; щоб замінити пароль, введіть нове значення. 2.4.6 Вкладка «Сервіс» Вкладка доступна лише користувачу рівня powerUser і містить: відомості про пристрій, завантажувач, прошивку, MAC-адресу та ідентифікатори; завантаження, перевірку та застосування файла оновлення прошивки у форматі .ota; програмний перезапуск TR-100E; відновлення заводських налаштувань; примусову синхронізацію часу через NTP; діагностичну інформацію пристрою. 2.5 Використання VPN WireGuard 2.5.1 Призначення VPN TR-100E підтримує VPN-з’єднання за протоколом WireGuard. VPN створює захищений мережевий канал між TR-100E і віддаленим вузлом WireGuard та дає змогу звертатися до мережевих служб пристрою через VPN-інтерфейс. Параметри VPN-з’єднання можуть бути задані вручну або отримані автоматично. Режим налаштування вибирається у Web-інтерфейсі TR-100E. Для роботи VPN TR-100E повинен мати доступ до мережі Internet, коректно налаштовані шлюз і DNS-сервери, а мережа не повинна блокувати з’єднання з віддаленим вузлом WireGuard. 2.5.2 Ручне налаштування WireGuard Параметри VPN розташовані у Web-інтерфейсі в розділі Налаштування → VPN-WireGuard. Ручне налаштування використовується для підключення до самостійно вибраного вузла WireGuard. Для його застосування: Увімкнути параметр Увімкнено. Вимкнути параметр Автоматичне підключення до сервера Overvis. Указати надані адміністратором VPN значення: приватний ключ, адресу інтерфейсу у форматі CIDR, публічний ключ і адресу вузла, порт, дозволені IP-мережі та період підтримання з’єднання. Натиснути кнопку Зберегти. Після збереження змінених параметрів служба WireGuard перезапускається автоматично; перезапуск TR-100E не потрібен. Конфіденційні дані Приватний ключ WireGuard не слід передавати стороннім особам або включати до знімків екрана й діагностичних матеріалів. Докладний порядок ручного налаштування наведено в «Додатку Б. Налаштування VPN WireGuard». 2.5.3 Автоматичне налаштування через Overvis Overvis — хмарна система моніторингу та візуалізації, яка може використовувати VPN WireGuard для доступу до TR-100E. У разі вибору автоматичного режиму TR-100E ідентифікується за заводським PIN-кодом, отримує від Overvis параметри WireGuard і встановлює VPN-з’єднання. Статична зовнішня IP-адреса та перенаправлення вхідних портів на маршрутизаторі при цьому не потрібні. Коли параметр Автоматичне підключення до сервера Overvis увімкнено, поля ручного налаштування не використовуються. Поле URL сервера автоматичної конфігурації слід залишити порожнім, якщо іншу адресу не надано виробником або службою технічної підтримки. Для підключення через Overvis необхідно: Забезпечити TR-100E доступ до мережі Internet. У розділі Налаштування → VPN-WireGuard увімкнути Увімкнено і Автоматичне підключення до сервера Overvis, потім зберегти налаштування. Створити мережу в обліковому записі Overvis і прив’язати до неї TR-100E за заводським PIN-кодом. Дочекатися встановлення VPN-з’єднання й перевірити доступ до потрібних даних TR-100E. Покроковий порядок підключення наведено в «Додатку Б. Налаштування VPN WireGuard». Додаткову інформацію про систему Overvis розміщено на сайті www.overvis.com. Увага За використання системи Overvis може стягуватися плата. Перед підключенням TR-100E рекомендується ознайомитися з чинними тарифами Overvis. 2.5.4 Доступ до Web-інтерфейсу та Modbus TCP через VPN Установлене VPN-з’єднання саме по собі не дозволяє доступ до мережевих служб TR-100E. Потрібні служби й доступ до них через VPN налаштовуються окремо: для Web-інтерфейсу в розділі Налаштування → Web-сервер увімкнути Доступ до Web через VPN і вибрати Рівень доступу через VPN за замовчуванням: Guest, User або PowerUser; для Modbus TCP у розділі Налаштування → Modbus TCP вибрати Доступ до Modbus через VPN: Заборонено, За загальним захистом, Лише читання або Читання та запис. У режимі За загальним захистом VPN-сесії підпорядковуються загальному режиму захисту Modbus і потребують розблокування паролем на тих самих умовах, що й локальні підключення. Режим Лише читання дозволяє читання через VPN без пароля та відхиляє всі команди запису. Режим Читання та запис дозволяє читання й запис через VPN без пароля; локальні підключення й надалі підпорядковуються загальному режиму захисту Modbus. Дозволяйте через VPN лише потрібні служби й призначайте мінімально достатній рівень доступу. 2.6 Використання Modbus TCP TR-100E підключається до локальної мережі через інтерфейс Ethernet. Протокол Modbus TCP використовується для обміну даними між TR-100E і Modbus-клієнтом у мережі TCP/IP. Через Modbus TCP можна: зчитувати виміряні значення та поточний стан TR-100E, наприклад для передавання даних у SCADA-систему; зчитувати й змінювати доступні налаштування TR-100E; виконувати передбачені протоколом службові команди. З міркувань безпеки пряме керування вихідними реле через Modbus TCP не передбачено: реле керуються вбудованими алгоритмами захисту відповідно до результатів вимірювань, установлених порогів, гістерезису та затримок. Це виключає обхід алгоритмів захисту віддаленою командою. TR-100E використовує дві незалежні групи регістрів Modbus: Input-регістри та Holding-регістри. Поточні стани зчитуються з Input-регістрів функцією 0x04; налаштування, службові значення та команди містяться в Holding-регістрах і обслуговуються функціями 0x03, 0x06 і 0x10. Параметр Тайм-аут визначає допустимий час відсутності даних від Modbus-клієнта. Якщо дані не надходять протягом заданого часу, TR-100E закриває TCP-з’єднання. Службові пакети TCP Keepalive не скидають цей тайм-аут. Значення 0 вимикає тайм-аут; у цьому разі TR-100E не закриває неактивне з’єднання. Заводське налаштування — 0 (тайм-аут вимкнено). За замовчуванням механізм захисту Modbus обмежує запис у захищені Holding-регістри. Для розблокування необхідно записати пароль Modbus у регістри 52–63 символами ASCII (по два символи в регістрі, старший байт першим, рядок завершується нульовим байтом). За замовчуванням діє заводський пароль, зазначений на наклейці з QR-кодом. Успішна перевірка розблоковує лише поточну TCP-сесію; стан механізму захисту доступний у регістрі 51. Після п’яти неправильних спроб запити з цієї IP-адреси блокуються на 5 хвилин. У разі зміни пароля Modbus допускається пароль завдовжки 8…23 символи. Перевірка пароля вмикається та вимикається параметром Пароль Modbus → Захист; вимкнення перевірки не видаляє збережений пароль. Режим роботи механізму захисту задається регістром 169: 0 — без захисту, 1 — захищено запис, 2 — захищено читання і запис. Доступ до службових регістрів 0–4, 51, 52–63 і 64–65 не залежить від вибраного режиму захисту та зазначений у таблиці 7. Для VPN-сесій додатково діє рівень доступу, заданий параметром Доступ до Modbus через VPN. Рівні Лише читання та Читання та запис не потребують розблокування паролем через VPN і не змінюють захист локальних Modbus-підключень. Безпека Після успішного введення пароля захищені регістри залишаються розблокованими для поточного TCP-з’єднання. Доступ зберігається до закриття цього з’єднання. Тому після завершення читання або зміни налаштувань необхідно від’єднати Modbus TCP-клієнт від TR-100E. Порядок слів і байтів Кожен 16-бітний регістр передається старшим байтом уперед (big-endian). Значення uint32 і int32 займають два регістри: перший регістр містить біти 31–16, другий — біти 15–0 (high word first). Наприклад, значення 0x12345678 передається як 0x1234, 0x5678. Для IPv4-адреси A.B.C.D перший регістр містить байти D, C, а другий — B, A. Наприклад, статична адреса 192.168.0.100 записується в регістри 120–121 як 0x6400, 0xA8C0. Такий самий порядок використовується для DNS-серверів, маски, шлюзу та поточних мережевих параметрів в Input-регістрах. У полях strN кожен регістр містить два послідовні байти рядка: перший символ — у старшому байті, другий — у молодшому. Рядок завершується нульовим байтом 0x00; решта байтів поля повинні бути нульовими. Складові поля завдовжки два регістри й більше записуються функцією 0x10 повністю, починаючи з першої адреси поля. Частковий запис або запис окремого регістру функцією 0x06 не допускається. Значення часу UTC передаються як кількість секунд, що минули від 00:00:00 01.01.1970 за UTC. Наприклад, значення 0 відповідає початку відліку — 00:00:00 01.01.1970 UTC. Зсув часового поясу та DST до значення регістру не додаються. Температури в Input-регістрах мають формат int16 із масштабом ×10. Значення -32768 (0x8000) зарезервовано як ознака недостовірного вимірювання: прошивка передає його, якщо внутрішнє значення температури не є скінченним числом (NaN, +Inf або -Inf) або отримати вимірювання не вдалося. Це значення не слід перетворювати на температуру -3276,8 °C. Корекція температури каналів, пороги, гістерезиси та НТС PTC Minika у Holding-регістрах також мають формат int16 із масштабом ×10. УВАГА У TR-100E існує обмеження на кількість одночасно підключених Modbus TCP-клієнтів (не більше п’яти). Усі підключення, що перевищують обмеження, закриватимуться автоматично. Таблиця 4 - Перелік підтримуваних функцій (Modbus) Код функції Назва функції Опис 0x03 Читання Holding-регістрів Читання налаштувань і службових регістрів 0x04 Читання Input-регістрів Читання поточних станів і вимірювань 0x06 Запис одного Holding-регістру Запис значення або команди, що займають один регістр 0x10 Запис кількох Holding-регістрів Запис значення, що займає кілька регістрів, або послідовності значень Таблиця 5 - Типи даних Тип Довжина, байт Опис int16 2 Ціле число від -32768 до 32767 uint16 2 Ціле число від 0 до 65535 int32 4 Ціле число від -2147483648 до 2147483647 uint32 4 Ціле число від 0 до 4294967295 strN 2×N Рядок до 2×N байт: старший байт регістру першим, завершення 0x00 Таблиця 6 – Input-регістри (функція 0x04) Адреса Назва Опис Тип 1 Причина перезапуску 0 невідомо; 1 увімкнення живлення; 2 сигнал RESET; 3 програмний перезапуск; 4 скидання сторожовим таймером; 5 вихід із режиму зниженого енергоспоживання uint16 2 Температура мікроконтролера Температура ×10; -32768 (0x8000) — вимірювання недостовірне int16 3–4 Час роботи Секунди з моменту запуску uint32 5–6 Прапори стану Бітова маска загального стану TR-100E. Призначення бітів наведено нижче uint32 7–8 Готовність функцій пристрою Бітова маска стану підсистем TR-100E. Призначення бітів наведено нижче uint32 9–10 Час RTC Кількість секунд з 00:00:00 01.01.1970 UTC uint32 11 Джерело синхронізації RTC 0 немає; 1 резерв RTC; 2 NTP; 3 ручне встановлення uint16 12–13 Остання синхронізація часу через NTP Кількість секунд з 00:00:00 01.01.1970 UTC; 0 — успішної синхронізації часу не було uint32 14–15 Лічильник синхронізацій NTP Кількість успішних синхронізацій uint32 16–17 Лічильник помилок NTP Кількість невдалих синхронізацій uint32 18–19 Поточна IP-адреса Активний IPv4 uint32 20–21 Поточна маска Активна маска IPv4 uint32 22–23 Поточний шлюз Активний шлюз IPv4 uint32 24–27 Стан CH1–CH4 Бітова маска стану кожного каналу. Призначення регістрів і бітів наведено нижче uint16 × 4 28–31 Стан лінії CH1–CH4 0 невідомо; 1 КЗ; 2 нижче діапазону; 3 норма; 4 вище діапазону; 5 обрив uint16 × 4 32–35 Поточна температура CH1–CH4 Температура ×10; -32768 (0x8000) — вимірювання недостовірне int16 × 4 36–39 Мінімальна температура CH1–CH4 Температура ×10; -32768 (0x8000) — вимірювання недостовірне int16 × 4 40–43 Максимальна температура CH1–CH4 Температура ×10; -32768 (0x8000) — вимірювання недостовірне int16 × 4 44–47 Напрям зміни температури CH1–CH4 0 знижується; 1 не змінюється; 2 підвищується uint16 × 4 Розшифрування регістрів 5–6 «Прапори стану» Установлений біт (1) означає, що зазначений стан активний. Скинутий біт (0) означає, що стан неактивний. Біт Стан Значення за встановленого біта (1) 0 FAULT Реле FAULT увімкнено через несправність датчика або внутрішню помилку TR-100E. Біт установлюється після завершення затримки Відмова → Затримка 1 TRIP Реле TRIP увімкнено через перевищення порога перегріву. Біт установлюється після завершення затримки Перегрів → Затримка 2 ALARM Реле ALARM увімкнено через перевищення порога тривоги. Біт установлюється після завершення затримки Тривога → Затримка 3 FAN Реле FAN увімкнено через перевищення порога вентиляції. Біт установлюється після завершення затримки Вентиляція → Затримка 4 Потрібен перезапуск Для застосування частини збережених налаштувань потрібно перезапустити TR-100E 5 Діагностичний режим Режим активовано комбінацією «Вгору» + «Вниз» під час запуску; пароль вимкнено і дозволено захищені діагностичні команди Стан реле Біти 0–3 містять логічні стани захистів, а не результат контролю фізичних контактів реле. Ці стани керують відповідними реле. Під час ручного тестування реле керуються тестовими командами, тому їхній стан може відрізнятися від значень бітів 0–3. Розшифрування регістрів 7–8 «Готовність функцій пристрою» Кожен біт показує готовність відповідної підсистеми: 1 — підсистема готова до роботи; 0 — підсистема не готова або не ініціалізована. Біт Підсистема Значення за встановленого біта (1) 0 Налаштування Дані налаштувань коректні й доступні 1 Службові дані вимірювання Службові дані вимірювального тракту коректні 2 Годинник реального часу RTC налаштовано та вони працюють 3 Кнопки Модуль кнопок готовий 4 Світлодіодні індикатори Модуль світлодіодної індикації готовий 5 Дисплей РК-дисплей готовий 6 Зовнішня пам’ять Зовнішня пам’ять готова 7 Ідентифікаційні дані Сховище ідентифікаційних даних пристрою готове 8 Журнал подій Журнал подій готовий 9 Реєстратор температури Реєстратор температури готовий 10 Оперативна історія температури Історія температури готова 11 Вимірювання температури Вимірювальний модуль готовий 12 Генератор випадкових чисел Апаратний генератор випадкових чисел готовий 13 Ethernet Інтерфейс Ethernet готовий 14 Мережевий стек TCP/IP Мережевий стек готовий 15 Web-інтерфейс Web-сервер готовий 16 NTP Клієнт синхронізації часу готовий 17 WireGuard Служба VPN WireGuard готова 18 Modbus TCP Сервер Modbus TCP готовий Розшифрування регістрів 24–27 «Стан CH1–CH4» Кожному каналу відповідає окремий регістр: 24 — CH1, 25 — CH2, 26 — CH3, 27 — CH4. Біт Стан каналу Значення за встановленого біта (1) 0 Канал увімкнено Канал увімкнено й бере участь в обробленні вимірювань 1 Умова TRIP Температура каналу досягла порога Перегрів або ще не знизилася нижче порога з урахуванням гістерезису 2 Умова ALARM Температура каналу досягла порога Тривога або ще не знизилася нижче порога з урахуванням гістерезису 3 Умова FAN Канал вибрано для керування вентиляцією, а його температура досягла порога Вентиляція або ще не знизилася нижче порога з урахуванням гістерезису Канальні та загальні прапори Біти 1–3 регістрів 24–27 показують виконання температурної умови окремим каналом і встановлюються до завершення затримки ввімкнення реле. Фактичну команду ввімкнення реле після завершення затримки показують відповідні біти регістрів 5–6. Таблиця 7 – Holding-регістри: службові значення та команди Адреса Назва Опис Доступ Тип 0 Код моделі пристрою TR-100E: 48 Ч uint16 1 Версія прошивки Наприклад, 0x0100 для версії 1.0 Ч uint16 2–4 MAC-адреса 6 байт Ч str3 50 Команда 62149 перезапуск; 18252 зберегти робочу копію; 54135 перечитати налаштування; 33421 скинути мінімальні та максимальні температури; 20052 синхронізувати час через NTP З+Ч uint16 51 Стан механізму захисту 0 — захист діє; 1 — захищені операції дозволено для поточної TCP-сесії Ч uint16 52–63 Пароль Modbus Введення чинного пароля; допускається записувати лише потрібну кількість регістрів З str12 64–65 Установлення часу UTC Кількість секунд з 00:00:00 01.01.1970 UTC; значення 0 заборонено; необхідно записати обидва регістри одним запитом З uint32 Робоча копія налаштувань У разі запису регістрів 100–220 зміни накопичуються в робочій копії налаштувань Modbus для поточної TCP-сесії. До виконання команди збереження вони не записуються в енергонезалежну пам’ять і будуть втрачені після закриття з’єднання або перезапуску TR-100E. Призначення команд: 18252 — зберегти налаштування: записує накопичені зміни в енергонезалежну пам’ять. 54135 — скасувати незбережені зміни: повторно завантажує в робочу копію налаштування з енергонезалежної пам’яті. Типова послідовність зміни параметрів через Modbus TCP: Якщо діє захист, записати пароль Modbus у Holding-регістри 52–63 і переконатися за значенням 1 регістру 51, що захищені операції дозволено для поточної TCP-сесії; Записати нові значення в потрібні Holding-регістри таблиці 3 — зміни потрапляють до робочої копії; Виконати команду 18252 — зберегти робочу копію в енергонезалежну пам’ять; Виконати команду 62149 — перезапустити TR-100E для застосування нових налаштувань. 2.7 Мережеві порти Для налаштування маршрутизатора або міжмережевого екрана слід враховувати мережеві з’єднання, наведені в таблиці 8. Таблиця 8 – Мережеві порти TR-100E Функція Протокол і порт Напрямок відносно TR-100E Умови використання Web-інтерфейс і Web API TCP 80 Вхідний Порт за замовчуванням; змінюється параметром Web-доступ → Порт Modbus TCP TCP 502 Вхідний Порт за замовчуванням; змінюється параметром Modbus TCP → Порт DHCP UDP 68 ↔ UDP 67 Вихідний і зворотний TR-100E використовує локальний порт 68, DHCP-сервер — порт 67; використовується за увімкненого DHCP DNS UDP 53 Вихідний і зворотний Запити до налаштованих DNS-серверів; потрібні під час використання DNS-імен серверів NTP, WireGuard або автоконфігурації NTP UDP 123 Вихідний і зворотний Синхронізація часу з налаштованими NTP-серверами за увімкненого NTP WireGuard VPN UDP 51820 Вхідний і вихідний Локальний порт TR-100E; для віддаленого вузла за замовчуванням також використовується 51820, але його можна змінити параметром VPN-WireGuard → Порт peer Автоматичне налаштування WireGuard через Overvis TCP 80 Вихідний і зворотний Порт за замовчуванням; інший порт може бути вказаний в URL сервера автоматичної конфігурації Web-інтерфейс режиму відновлення TCP 80 Вхідний Доступний лише в режимі відновлення завантажувача за адресою 192.168.1.48 Вхідні з’єднання до Web-інтерфейсу та Modbus TCP необхідно дозволяти лише з довірених мереж. Якщо використовуються лише вихідні з’єднання з NTP, DNS і сервером автоконфігурації, перенаправлення портів на маршрутизаторі не потрібне; міжмережевий екран повинен дозволяти зворотний трафік встановлених з’єднань. WireGuard і NAT TR-100E самостійно ініціює обмін із віддаленим вузлом WireGuard. За такої схеми перенаправлення UDP-порту 51820 на маршрутизаторі зазвичай не потрібне. Воно необхідне лише якщо віддалений вузол повинен першим встановлювати з’єднання з TR-100E через NAT. 3 ТЕХНІЧНЕ ОБСЛУГОВУВАННЯ 3.1 Заходи безпеки Заходи безпеки ПІД ЧАС ТЕХНІЧНОГО ОБСЛУГОВУВАННЯ НЕОБХІДНО ЗНЕСТРУМИТИ ВИРІБ І ПІД’ЄДНАНІ ДО НЬОГО ПРИСТРОЇ. 3.2 Періодичність технічного обслуговування Рекомендована періодичність технічного обслуговування - кожні шість місяців. 3.3 Порядок технічного обслуговування: Перевірити надійність під’єднання проводів до клем TR-100E, у разі виявлення послаблених контактів затягнути гвинти клем. У разі виявлення пошкоджених проводів замінити їх на нові; Візуально перевірити цілісність корпусу, у разі виявлення тріщин або сколів виріб зняти з експлуатації та відправити на ремонт; За потреби протерти корпус виробу ганчіркою. Для чищення не використовуйте абразивні матеріали та розчинники. 3.4 Діагностика та усунення несправностей Увага Усі роботи з усунення несправностей виконуються за знеструмленого TR-100E, за винятком випадків, коли явно зазначено інше. Таблиця 9 - Можливі несправності та способи їх усунення Симптом Можлива причина Дія Дисплей не світиться після увімкнення живлення На клемах живлення відсутня напруга; несправність TR-100E Перевірити наявність і відповідність напруги живлення на клемах вимогам таблиці 1. Якщо напруга відповідає вимогам, а дисплей не вмикається - відправити TR-100E на ремонт Індикатор CH1-CH4 блимає, канал показує «ОБРИВ» Обрив лінії датчика або несправність датчика Перевірити цілісність кабелю та надійність підключення датчика до клем TR-100E Індикатор CH1-CH4 блимає, канал показує «КЗ» Коротке замикання лінії датчика Перевірити кабель датчика на наявність замикання; замінити датчик або кабель Індикатор FAULT блимає Несправність датчика; внутрішня помилка TR-100E; збій під час увімкнення Перевірити стан каналів на дисплеї - якщо канали справні, перевірити журнал подій для з’ясування причини. Виконати перезапуск: знеструмити та знову подати живлення або через web-інтерфейс (Система → Перезапуск). Якщо після перезапуску FAULT продовжує блимати без видимих причин - відправити TR-100E на ремонт Реле не спрацьовує в разі перевищення порога Триває відлік затримки; канал вимкнено; поріг задано неправильно Перевірити параметри Затримка, Увімкнення каналу та значення Порога (таблиця 3) Реле не вимикається після зниження температури Гістерезис задано надто великим; неправильний поріг Перевірити параметри Гістерезис і Поріг відповідного реле (таблиця 3) Час скидається після тривалого вимкнення живлення Буферний конденсатор RTC розряджений (понад 7 діб без живлення) Установити час вручну (п. 2.2.9) або увімкнути синхронізацію через NTP Немає доступу до web-інтерфейсу за IP-адресою Неправильна IP-адреса; web-сервер вимкнено; відсутнє мережеве підключення Перевірити IP-адресу на дисплеї TR-100E; переконатися, що параметр Увімкнення web-сервера = 1 (таблиця 3); перевірити кабель Ethernet та індикатор LINK Клієнт Modbus TCP не отримує відповіді Неправильні IP, порт або UID; Modbus вимкнено; перевищено кількість підключень Перевірити параметри Увімкнення, Порт, UID (таблиця 3); переконатися, що кількість одночасних клієнтів не перевищує 5 Немає синхронізації часу через NTP NTP вимкнено; неправильна адреса сервера; немає доступу до мережі Перевірити параметри Увімкнення NTP, Адреса сервера, мережеві налаштування та доступ TR-100E до інтернету (таблиця 3) Дані реєстратора не записуються Реєстратор вимкнено Увімкнути параметр Реєстратор і перевірити значення параметра Період запису температури (таблиця 3) 4 СТРОК СЛУЖБИ ТА ГАРАНТІЯ ВИРОБНИКА 4.1 Строк служби виробу Строк служби виробу становить 15 років. Після закінчення строку служби звернутися до виробника. 4.2 Строк зберігання Строк зберігання виробу становить 3 роки. 4.3 Гарантійний строк експлуатації Гарантійний строк експлуатації виробу становить 10 років від дня продажу. Протягом гарантійного строку експлуатації (у разі відмови виробу) виробник виконує ремонт виробу - безкоштовно. Гарантійні зобов’язання Гарантійні зобов’язання не поширюються на вироби, які були пошкоджені внаслідок експлуатації з порушенням вимог цього Керівництва з експлуатації, а також унаслідок механічних пошкоджень, впливу вологи, корозії, високих температур, хімічних речовин та інших чинників, не пов’язаних з виробничими дефектами виробу. 4.4 Гарантійне обслуговування Гарантійне обслуговування здійснюється за місцем придбання або виробником виробу. 4.5 Післягарантійне обслуговування Післягарантійне обслуговування виробу виконується виробником за чинними тарифами. Важлива інформація Перед відправленням виробу на ремонт його слід упакувати в заводське або інше паковання, що унеможливлює механічні пошкодження. 5 ТРАНСПОРТУВАННЯ ТА ЗБЕРІГАННЯ TR-100E в упаковці виробника дозволяється транспортувати та зберігати за температури від мінус 30 до +60 °C і відносної вологості не більше 98% за 35 °C (без конденсації вологи).

Novatek-Electro TR-100E Documentation

Додаток А: Аварійне відновлення прошивки ДОДАТОК А. АВАРІЙНЕ ВІДНОВЛЕННЯ ПРОШИВКИ Основний документ: «Посібник з експлуатації TR-100E» Цей додаток описує відновлення вбудованого програмного забезпечення TR-100E за допомогою завантажувача. Процедуру застосовують, якщо штатний Web-інтерфейс не відкривається, оновлення завершилося з помилкою або TR-100E повідомляє про недійсний застосунок. Завантажувач надає два способи відновлення: Restore firmware — повторне встановлення раніше завантаженого образу; Recovery mode — завантаження нового файлу прошивки .ota з комп’ютера через Ethernet та його подальше встановлення. Для відновлення необхідні: призначений для TR-100E файл прошивки у форматі .ota — для режиму Recovery mode; комп’ютер з Web-браузером та інтерфейсом Ethernet — для режиму Recovery mode; кабель Ethernet для підключення комп’ютера до TR-100E безпосередньо або через мережевий комутатор. Безпека обладнання У режимі завантажувача TR-100E не контролює температуру та не керує реле. Перед початком відновлення переведіть підключене обладнання в безпечний стан та за потреби організуйте незалежний контроль. Електроживлення Не вимикайте живлення після запуску встановлення прошивки, коли на дисплеї відображається Update firmware. Якщо живлення все ж було перервано, під час наступного ввімкнення завантажувач відобразить Previous update: Interrupted та автоматично повторить встановлення збереженого образу. А.1 Вхід до меню завантажувача Вимкнути живлення TR-100E. Натиснути й утримувати кнопку «Меню» (MENU). Не відпускаючи кнопку, подати живлення на TR-100E. Після появи заставки TR100E BootLoader v1.2 відпустити кнопку. Через кілька секунд відкриється екран Boot menu. Для керування меню використовуються: UP/DOWN — переміщення вказівника; SET — виконання вибраної дії; MENU — скасування та перехід до запуску встановленого застосунку. Меню містить такі пункти: Пункт Призначення Run application Запустити встановлену прошивку. Якщо вона пошкоджена, з’явиться повідомлення Run application: Application invalid Restore firmware Встановити раніше завантажений образ .ota Recovery mode Запустити службовий Web-інтерфейс для завантаження нового образу .ota А.2 Відновлення раніше завантаженого образу Цей спосіб не потребує комп’ютера. Використовуйте його, якщо перед збоєм файл оновлення було повністю завантажено до TR-100E. Увійти до меню завантажувача згідно з п. А.1. Кнопками UP/DOWN вибрати Restore firmware та натиснути SET. Дочекатися завершення перевірки та встановлення прошивки. Перебіг операції відображається індикатором від 0 до 100 %. Після повідомлення Done, start app TR-100E автоматично запустить відновлену прошивку. Якщо з’являється Image not found, Image invalid або Operation failed, завантажити новий файл .ota згідно з п. А.3. Після повідомлення про помилку завантажувач спробує запустити встановлену прошивку. Для повторного входу до меню знову ввімкнути TR-100E, утримуючи кнопку MENU. А.3 Завантаження нового образу через Recovery mode А.3.1 Підключення Від’єднати комп’ютер від інших мереж з адресами 192.168.1.x, щоб уникнути конфлікту маршрутів. З’єднати TR-100E та комп’ютер кабелем Ethernet безпосередньо або через мережевий комутатор. Увійти до меню завантажувача згідно з п. А.1. Вибрати Recovery mode та натиснути SET. Дочекатися екрана Recovery mode. На ньому відображаються IP-адреса та MAC-адреса TR-100E. У режимі відновлення використовуються фіксовані параметри мережі: Параметр Значення IP-адреса TR-100E 192.168.1.48 Маска підмережі 255.255.255.0 Шлюз TR-100E 192.168.1.1 TCP-порт Web-інтерфейсу 80 У властивостях IPv4 інтерфейсу Ethernet комп’ютера вимкнути автоматичне отримання адреси та тимчасово задати, наприклад: IP-адреса — 192.168.1.2; маска підмережі — 255.255.255.0; основний шлюз та DNS-сервер — залишити порожніми. Відкрити у браузері адресу http://192.168.1.48. Має з’явитися сторінка TR-100E Recovery. Режим Recovery не використовує DHCP та налаштування мережі з основної прошивки. Адреса 192.168.1.48 залишається незмінною незалежно від попередньої конфігурації TR-100E. А.3.2 Завантаження та перевірка файлу На сторінці TR-100E Recovery натиснути поле вибору файлу та вказати файл прошивки TR-100E з розширенням .ota. Натиснути Send та дочекатися передавання файлу до TR-100E. Дочекатися значення percent=100%. Після отримання завантажувач перевіряє формат образу, призначення для TR-100E та контрольну суму даних. Переконатися, що в полі стану вказано imageValid=true, lastError=0, а кнопка Firmware стала доступною. Якщо завантаження було перервано до натискання Firmware, встановлена прошивка не змінюється. Не перезавантажуючи TR-100E, виберіть файл та натисніть Send ще раз: незавершене завантаження буде замінено новим. А.3.3 Встановлення прошивки Натиснути Firmware. На сторінці з’явиться повідомлення Rebooting…, після чого TR-100E перезапуститься та почне встановлення. Не вимикати живлення та не натискати кнопки. На дисплеї відображаються етапи перевірки та встановлення прошивки. Дочекатися повідомлення Done та автоматичного запуску TR-100E. Після появи головного екрана перевірити версію прошивки та працездатність вимірювальних каналів і реле. Повернути інтерфейсу Ethernet комп’ютера початкові налаштування IPv4. Перед встановленням завантажувач перевіряє сумісність, цілісність та автентичність файлу. Пошкоджений, змінений після випуску або призначений для іншого пристрою файл встановити неможливо. А.4 Повідомлення завантажувача Повідомлення Причина та дія Image not found Раніше завантажений образ не знайдено. Виконати завантаження згідно з п. А.3 Image invalid Неправильний формат або параметри образу. Отримати справний файл .ota для TR-100E Operation failed Не вдалося перевірити або встановити прошивку. Повторно завантажити заздалегідь перевірений файл; якщо помилка повторюється, звернутися до сервісної організації Previous update: Interrupted Попереднє встановлення було перервано. Завантажувач автоматично повторює його зі збереженого образу Previous update: Failed Попереднє встановлення завершилося помилкою. Увійти до Recovery mode та завантажити справний образ Boot warning: Key not set У TR-100E відсутні дані, необхідні для перевірки файлу прошивки. Звернутися до сервісної організації Run application: Application invalid Вибрано ручний запуск, але встановлена прошивка пошкоджена або відсутня. Виконати відновлення згідно з п. А.2 або А.3 Boot error: Application invalid Встановлена прошивка пошкоджена або відсутня. Виконати відновлення згідно з п. А.2 або А.3 Clock error: HSE start failed Не вдалося запустити системний генератор. TR-100E автоматично перезапуститься; якщо помилка повторюється, звернутися до сервісної організації Ethernet error: MAC read failed Не вдалося прочитати мережеву адресу TR-100E. Перезапустити пристрій; якщо помилка повторюється, звернутися до сервісної організації Ethernet error: ETH config failed Не вдалося налаштувати інтерфейс Ethernet. Перевірити підключення та перезапустити режим Recovery; якщо помилка повторюється, звернутися до сервісної організації Ethernet error: LwIP init failed Не вдалося запустити мережеву службу. Перезапустити режим Recovery; якщо помилка повторюється, звернутися до сервісної організації Якщо сторінка відновлення не відкривається: переконатися, що на дисплеї показано екран Recovery mode та адресу 192.168.1.48; перевірити індикатори з’єднання Ethernet на TR-100E та мережевому адаптері комп’ютера; перевірити, що адреса комп’ютера належить мережі 192.168.1.0/24, але не збігається з 192.168.1.48; тимчасово вимкнути VPN та інші мережеві інтерфейси комп’ютера; відкрити саме http://192.168.1.48, без https; перевірити, що міжмережевий екран не блокує TCP-порт 80 у локальній мережі. Якщо після повторного завантаження справного файлу відновлення не завершується, запишіть текст повідомлення на дисплеї, стан lastError на сторінці Recovery та MAC-адресу пристрою, а потім зверніться до сервісної організації.

Novatek-Electro TR-100E Documentation

Додаток Б: Налаштування VPN WireGuard ДОДАТОК Б. НАЛАШТУВАННЯ VPN WIREGUARD Основний документ: «Посібник з експлуатації TR-100E» Цей додаток описує два режими налаштування VPN WireGuard: статичний — параметри з’єднання задаються вручну для підключення до вибраного вузла WireGuard; автоматичний — TR-100E отримує параметри з’єднання від Overvis після підключення до облікового запису за PIN-кодом. В обох режимах TR-100E самостійно ініціює обмін із віддаленим вузлом. Для налаштування потрібен доступ до Web-інтерфейсу TR-100E з рівнем powerUser. TR-100E повинен мати IP-з’єднання з віддаленим вузлом; у разі використання імені хоста мають бути правильно налаштовані DNS-сервери. Конфіденційні дані Не передавайте стороннім особам PIN-код, паролі, приватний ключ WireGuard та інші ідентифікаційні дані TR-100E. Перед публікацією або передаванням знімків екрана приховайте PIN-код, серійний номер, MAC-адресу та ключі. Б.1 Ручне налаштування WireGuard Б.1.1 Введення параметрів Для статичного налаштування адміністратор VPN повинен надати параметри WireGuard для TR-100E та налаштувати відповідний peer на віддаленому вузлі. Відкрити Web-інтерфейс TR-100E та увійти з рівнем доступу powerUser. Перейти на вкладку Налаштування та розкрити розділ VPN-WireGuard. Увімкнути параметр Увімкнено. Вимкнути параметр Автоматичне підключення до сервера Overvis. Поля статичного налаштування стануть доступними для введення. Ввести параметри, надані адміністратором VPN: Поле Вміст Приватний ключ Приватний ключ TR-100E у форматі Base64 Адреса інтерфейсу Адреса TR-100E всередині VPN у форматі IPv4/CIDR, наприклад 10.8.0.2/24 Публічний ключ peer Публічний ключ віддаленого вузла у форматі Base64 Хост peer DNS-ім’я або IPv4-адреса віддаленого вузла Порт peer UDP-порт віддаленого вузла, від 1 до 65535; значення за замовчуванням — 51820 Allowed IP 1, Allowed IP 2 До двох мереж, трафік до яких спрямовується через peer, у форматі IPv4/CIDR Keepalive (s) Інтервал persistent keepalive від 1 до 300 s; значення за замовчуванням — 25 s Приватний ключ, адреса інтерфейсу, публічний ключ та хост peer є обов’язковими. Для адреси інтерфейсу використовується префікс від /1 до /32. Обидва поля Allowed IP можна залишити порожніми. Якщо не задано жодної дозволеної мережі, TR-100E використовує мережу, задану адресою інтерфейсу. Якщо заповнено одне поле Allowed IP, використовується зазначений у ньому маршрут. У поточній версії прошивки маршрути з префіксом /0 не застосовуються; для Allowed IP слід використовувати префікси від /1 до /32. Натиснути Зберегти в розділі VPN-WireGuard. Служба WireGuard перезапуститься автоматично; перезапуск TR-100E не потрібен. Якщо через статичне VPN-з’єднання потрібен доступ до Web-інтерфейсу або Modbus TCP, додатково виконати налаштування, зазначені в кроках 5–11 п. Б.2.2. Рисунок Б.1 – статичне налаштування WireGuard Б.1.2 Перевірка підключення Перейти на вкладку Сервіс, у блоці Діагностика вибрати Мережа → VPN та увімкнути Автооновлення. Для правильно заповненої статичної конфігурації відображаються: Сервіс — Увімкнено; Режим — Статичний; Конфігурація — Готово; Зв’язок — Налаштовано, Підключено або Активно. Успішний обмін із віддаленим вузлом підтверджується станом Підключено або Активно, часом у полі Рукостискання та збільшенням лічильників пакетів RX/TX. Стан Конфігурація неправильна означає, що не заповнено принаймні один обов’язковий параметр: приватний ключ, адреса інтерфейсу, публічний ключ або хост peer. Рисунок Б.2 – стан статичного підключення WireGuard Якщо статичне підключення не встановлюється: якщо відображається стан Конфігурація неправильна, перевірити заповнення приватного ключа, адреси інтерфейсу, публічного ключа та хоста peer; звірити всі параметри з конфігурацією віддаленого peer; у разі використання DNS-імені перевірити налаштування DNS у розділі Налаштування → Мережа; перевірити доступність хоста та UDP-порту peer з мережі TR-100E; перевірити, що маршрути Allowed IP не перетинаються з локальною мережею непередбаченим чином; переконатися, що віддалений peer налаштований для роботи з ключем та VPN-адресою TR-100E. Б.2 Автоматичне налаштування через Overvis Б.2.1 Перевірка ідентифікаційних даних Відкрити Web-інтерфейс TR-100E та увійти з рівнем доступу powerUser. Перейти на вкладку Сервіс. У блоці Інформація про пристрій переконатися, що індикатори Ключ пристрою та Зареєстровано мають зелений колір, а в полі PIN-код відображається значення. Записати PIN-код (його також зазначено на наклейці пристрою): код буде потрібен для підключення TR-100E до облікового запису Overvis. Рисунок Б.3 – ідентифікаційні дані TR-100E Б.2.2 Увімкнення автоматичного підключення Перейти на вкладку Налаштування та розкрити розділ VPN-WireGuard. Увімкнути параметри Увімкнено та Автоматичне підключення до сервера Overvis. Поле URL сервера автоматичної конфігурації залишити порожнім: у цьому разі використовується адреса, записана виробником. Заповнювати поле слід лише за вказівкою служби технічної підтримки. Натиснути Зберегти в розділі VPN-WireGuard. Рисунок Б.4 – налаштування автоматичного підключення до Overvis Розкрити розділ Web-сервер. Увімкнути параметр Доступ до Web через VPN та встановити для параметра Рівень доступу через VPN за замовчуванням значення PowerUser. Натиснути Зберегти в розділі Web-сервер. Рисунок Б.5 – налаштування доступу до Web-інтерфейсу через VPN Розкрити розділ Modbus TCP. Увімкнути параметр Увімкнено та для параметра Доступ до Modbus через VPN вибрати значення Читання та запис. Цей рівень потрібен, щоб Overvis HMI міг не лише читати, а й змінювати параметри TR-100E. Для параметра Режим захисту вибрати значення Запис. Дозвіл запису через VPN не вимикає захист локального Modbus: локальним клієнтам, як і раніше, буде потрібне розблокування паролем. Натиснути Зберегти в розділі Modbus TCP. Рівень Читання та запис надає доступ без пароля будь-якій сесії Modbus TCP, прийнятій через VPN-інтерфейс. Використовуйте його лише для довіреної конфігурації WireGuard. Якщо віддалена зміна параметрів не потрібна, виберіть Лише читання. Рисунок Б.6 – налаштування доступу до Modbus TCP через VPN Б.2.3 Контроль автоматичного підключення Після збереження налаштувань перейти на вкладку Сервіс, у блоці Діагностика вибрати Мережа → VPN та увімкнути Автооновлення. Дочекатися завершення автоматичного налаштування. Ознаки готовності до підключення через Overvis: Сервіс — Увімкнено; Режим — Авто; Конфігурація — Готово; Зв’язок — Підключено або Активно; у полі Рукостискання відображається час останнього обміну замість риски. Після появи цих станів перейти до підключення TR-100E до облікового запису Overvis HMI. Рисунок Б.7 – готовність WireGuard до підключення через Overvis Б.2.4 Підключення TR-100E до облікового запису Overvis HMI Перед продовженням переконайтеся, що TR-100E підключений до інтернету, а автоматичне налаштування WireGuard завершено відповідно до п. Б.2.3. Підготуйте 8-символьний PIN-код, зазначений на наклейці корпусу. У веббраузері перейдіть на сайт Overvis HMI. На сторінці входу в полі Email введіть адресу електронної пошти та натисніть Send code. У полі, що з’явиться, введіть одноразовий код із листа. Якщо ця адреса використовується вперше, Overvis HMI створить обліковий запис після її підтвердження. Окремий пароль не потрібен. Код діє 10 хвилин і приймається один раз. Новий код можна запросити через хвилину; раніше виданий код після цього припинить діяти. Під час першого входу вкажіть ім’я та назву організації. Overvis HMI створить перший робочий простір із назви організації. Якщо робочий простір уже існує, відкрийте його. Перейдіть до розділу Ручне налаштування → Підключення та натисніть Створити підключення. У полі Тип виберіть PIN. Для цього типу підключення використовується порт 502, тому поле Порт не відображається. У полі Назва замініть текст Нове підключення зрозумілою назвою, наприклад місцем встановлення TR-100E. У полі PIN-код введіть код із наклейки та натисніть Створити. Рисунок Б.8 – створення підключення TR-100E за PIN-кодом Підтвердьте володіння пристроєм: натисніть Так на TR-100E або введіть в Overvis HMI код, показаний на дисплеї пристрою. Дочекайтеся повідомлення Підключення створено. У списку Підключення виберіть створений рядок. На вкладці Підключення переконайтеся, що відображається стан Підключено, а поле Активна адреса заповнено. У рядку списку мають відображатися мітка PIN, виробник і код моделі. Рисунок Б.9 – TR-100E підключено до робочого простору Після створення Тип і прив’язаний пристрій змінити не можна. Якщо PIN зазначено неправильно, підключення видаляють і створюють заново. Температури це підключення саме по собі не показує: параметри TR-100E додають окремо. Б.2.5 Додавання параметрів TR-100E із шаблону Після створення підключення додайте параметри контролера із шаблону Novatek-Electro TR-100E. Адресу та порт підключення повторно вводити не потрібно. У меню налаштування перейдіть до розділу Параметри (Parameters). Натисніть Додати (Add) та виберіть Із шаблону… (From template…). У вікні Додати із шаблону (Add from template) виберіть шаблон Novatek-Electro TR-100E із групи Overvis. Перевірте поле Назва кореневої гілки (Root branch name). За потреби змініть запропоновану назву; залишати поле порожнім не можна. Перевірте поле ID пристрою (Unit ID). Шаблон використовує заводську адресу Modbus TR-100E — 48. Якщо адресу контролера було змінено, зазначте її поточне значення. У полі Підключення (Endpoint) виберіть створене раніше підключення TR-100E. Натисніть Додати (Add). Окремо зберігати зміни не потрібно. Рисунок Б.10 – додавання параметрів TR-100E із шаблону Після застосування шаблону в дереві Параметри з’явиться нова коренева гілка з параметрами TR-100E. Щоб перевірити обмін із контролером, виділіть нову гілку та натисніть Читати (Read). Праворуч від параметрів мають з’явитися отримані значення. Для безперервного опитування увімкніть Онлайн (Live). Рисунок Б.11 – перевірка читання параметрів TR-100E Якщо замість значень відображається помилка, перевірте, що поле ID пристрою відповідає адресі Modbus контролера та що створене підключення має стан Підключено. Додаткові відомості наведено в документації Overvis щодо підключення обладнання.

Novatek-Electro TR-100E Documentation

HTTP API HTTP API для взаємодії з пристроєм TR-100E. Усі шляхи запитів починаються з /api/. Підтримуються методи GET і POST. Загальні принципи API приймає та повертає JSON (Content-Type: application/json), крім бінарних фрагментів OTA й відповідей експорту. Фрагменти OTA передаються з Content-Type: application/octet-stream. Кінцеві точки експорту CSV повертають Content-Type: text/csv. Кінцеві точки експорту звичайного тексту повертають Content-Type: text/plain. Успішні відповіді мають статус 200 OK. У разі помилки повертаються відповідний статус HTTP і JSON: { "error": "ERROR_CODE", "message": "Human readable text" }. Підтримується постійне з’єднання HTTP (keep-alive). Максимальний розмір заголовка HTTP: 1380 байтів. Максимальний розмір тіла HTTP: 4096 байтів. Максимальний загальний розмір HTTP-запиту: 5476 байтів. Рівні доступу Рівень Опис 🟩 guest Неавтентифікований клієнт 🟨 user Звичайний користувач 🟥 powerUser Користувач із розширеними правами guest має доступ лише до GET /api/auth/status/, GET /api/auth/salt/, GET /api/version/ і POST /api/auth/login/. user має доступ до стандартних кінцевих точок, а також до service/time/sync. powerUser має повний доступ до всіх кінцевих точок. Усі запити POST /api/debug/*, крім /api/debug/display/start/ і /api/debug/display/stop/, додатково потребують діагностичного режиму, який активується під час запуску одночасним натисканням кнопок «Вгору» та «Вниз». У звичайному режимі ці запити повертають 403 Forbidden. Це обмеження не застосовується до запитів GET /api/debug/*. Авторизація Отримати salt — GET /api/auth/salt/. Увійти — POST /api/auth/login/, передавши SHA256(username + password + salt). Усі подальші запити мають містити заголовок Authorization: Bearer <token>. Вийти — POST /api/auth/logout/. Для Web-авторизації використовуються два незалежні паролі: один для рівня user, інший — для рівня powerUser. Отримання та зміну налаштувань доступу описано в settings-get.md і settings-set.md. Час Абсолютні позначки часу передаються лише в UTC+0 у форматі ISO 8601: 2026-04-16T12:34:56Z. Інтервали та затримки задаються цілими числами в секундах або хвилинах. Часткове оновлення налаштувань POST /api/settings/set/ використовує семантику злиття: зберігаються лише передані поля; відсутнє поле означає «не змінювати»; масиви замінюються повністю; невідомі ключі → 400 ERROR_INVALID_VALUE. Запити GET Шлях Призначення Доступ /api/version/ Ідентифікація пристрою та версія прошивки 🟩 guest /api/auth/status/ Поточний рівень доступу для запиту 🟩 guest /api/auth/salt/ Отримання salt для хешування пароля 🟩 guest /api/state/get/?... Знімок поточного стану за групою (device, network, relays, leds, protection, recorder, channels, log, ntp, httpd, modbus, wireguard) 🟨 user /api/settings/get/?... Отримання налаштувань за групою 🟨 user /api/reference/sensor-types/ Список підтримуваних типів датчиків 🟨 user /api/history/temperature/info/ Метадані вікна оперативної історії 🟨 user /api/history/temperature/samples/?... Оперативна історія температури для всіх каналів 🟨 user /api/recorder/info/ Метадані реєстратора температури 🟨 user /api/recorder/records/?... Архівні записи реєстратора температури 🟨 user /api/recorder/export.csv/ Експорт даних реєстратора температури у форматі CSV 🟨 user /api/log/info/ Зведені відомості про журнал подій 🟨 user /api/log/events/?... Події журналу 🟨 user /api/log/export.log/ Експорт журналу в текстовому форматі 🟨 user /api/debug/tasks/ Знімок завдань RTOS 🟥 powerUser /api/debug/heap/ Стан купи FreeRTOS/lwIP 🟥 powerUser /api/debug/system/ Системна діагностика 🟥 powerUser /api/debug/settings/ Стан банків постійних налаштувань 🟥 powerUser /api/debug/adc/ Необроблені дані АЦП і вимірювань 🟥 powerUser /api/debug/external-storage/ Відомості про зовнішнє сховище 🟥 powerUser /api/debug/external-storage/dump/ Повний дамп зовнішнього сховища 🟥 powerUser + діагностичний режим /api/debug/network/ Діагностика мережевого стека 🟥 powerUser /api/debug/lwip-stats/ Лічильники lwIP (пули proto + memp) 🟥 powerUser /api/debug/menu/ Стан меню інтерфейсу користувача 🟥 powerUser /api/debug/keyget/ Стан фізичних кнопок 🟥 powerUser /api/service/firmware/upload/status/ Стан сеансу завантаження OTA 🟥 powerUser /api/service/identity/get/ Поточний стан ідентифікаційних даних і стан апаратного блокування 🟥 powerUser /api/service/challenge/status/ Стан перевірки фізичного доступу Overvis WireGuard + 🟨 user /api/service/calibration/report/ Останній збережений звіт про калібрування; апаратний ключ не потрібен 🟥 powerUser /api/service/calibration/status/ Стан і контроль активності поточного сеансу калібрування 🟥 powerUser + апаратний ключ Запити POST Шлях Призначення Доступ /api/auth/login/ Автентифікація користувача 🟩 guest /api/auth/logout/ Завершення сеансу 🟨 user /api/settings/set/ Часткове оновлення налаштувань 🟥 powerUser /api/log/acknowledge/ Підтвердження перегляду подій 🟨 user /api/recorder/clear/ Очищення реєстратора температури 🟥 powerUser /api/log/clear/ Очищення журналу подій 🟥 powerUser /api/service/settings/reset/ Відновлення заводських налаштувань 🟥 powerUser /api/service/reboot/ Планування перезапуску 🟥 powerUser /api/service/time/set/ Установлення системного часу 🟥 powerUser /api/service/time/sync/ Примусова синхронізація SNTP 🟨 user /api/service/identity/set/ Оновлення та збереження ідентифікаційних полів 🟥 powerUser /api/service/challenge/set/ Установлення, заміна або скидання запиту підтвердження Overvis WireGuard + 🟨 user /api/service/calibration/begin/ Початок сеансу калібрування 🟥 powerUser + апаратний ключ /api/service/calibration/range/ Вибір діапазону й точки 🟥 powerUser + апаратний ключ /api/service/calibration/capture/ Зчитування чотирьох необроблених значень АЦП і початок перевірки 🟥 powerUser + апаратний ключ /api/service/calibration/commit/ Збереження точок і чотирьох знімків показників якості 🟥 powerUser + апаратний ключ /api/service/calibration/finish/ Завершення сеансу та звільнення вимірювального тракту 🟥 powerUser + апаратний ключ /api/service/firmware/upload/begin/ Початок завантаження образу OTA 🟥 powerUser /api/service/firmware/upload/chunk/?offset= Запис фрагмента образу OTA 🟥 powerUser /api/service/firmware/upload/finish/ Завершення завантаження та перевірки 🟥 powerUser /api/service/firmware/upload/discard/ Видалення завантаженого образу OTA та скидання сеансу завантаження 🟥 powerUser /api/service/firmware/apply/ Застосування оновлення OTA 🟥 powerUser /api/debug/relay/start/ Перевірка реле — початок 🟥 powerUser /api/debug/relay/stop/ Перевірка реле — завершення 🟥 powerUser /api/debug/led/start/ Перевірка світлодіодів — початок 🟥 powerUser /api/debug/led/stop/ Перевірка світлодіодів — завершення 🟥 powerUser /api/debug/display/start/ Перевірка дисплея — увімкнення примусового керування 🟥 powerUser /api/debug/display/stop/ Перевірка дисплея — вимкнення примусового керування 🟥 powerUser /api/debug/keypress/ Імітація натискання кнопки 🟥 powerUser Помилки та коди стану HTTP error Призначення 400 ERROR_INVALID_ARGUMENT, ERROR_INVALID_VALUE, ERROR_API_PARSING Некоректний запит 401 ERROR_UNAUTHORIZED Немає чинної авторизації 403 ERROR_NO_ACCESS, ERROR_WRITE_PROTECT Недостатньо прав 404 ERROR_NOT_FOUND Ресурс не знайдено 408 ERROR_TIMEOUT Перевищено час очікування операції 429 ERROR_LOCKED Блокування після невдалих спроб входу 500 ERROR, ERROR_IO Внутрішня помилка 503 ERROR_NOT_READY Підсистема не готова 507 ERROR_NO_MEMORY Недостатньо пам’яті Документацію оновлено: 2026-07-30

Novatek-Electro TR-100E Documentation

GET /api/version/ Базова загальнодоступна кінцева точка для ідентифікації пристрою та отримання версії прошивки перед входом у систему. Авторизація: не потрібна. Кінцева точка не повертає конфіденційних налаштувань, паролів, мережевих секретів або діагностичних даних. Відповідь 200 { "deviceId": 48, "deviceName": "TR-100E", "firmwareVersion": "1.0", "bootloaderVersion": "1.0" } Поля відповіді Поле Тип Обов’язкове Опис deviceId число так Числовий ідентифікатор типу пристрою deviceName рядок так Назва пристрою firmwareVersion рядок так Версія прошивки bootloaderVersion рядок | null так Версія завантажувача, яку він записав до резервного регістру RTC; null, якщо завантажувач не повідомив версію

Novatek-Electro TR-100E Documentation

GET /api/auth/status/ Повертає поточний рівень доступу для цього запиту. Авторизація: не потрібна. Відповідь 200 { "accessLevel": "guest" } Поля відповіді Поле Тип Обов’язкове Опис accessLevel рядок так Поточний рівень доступу: guest, user або powerUser Примітки Якщо сеанс Bearer дійсний, кінцева точка повертає рівень доступу цього сеансу. Якщо сеанс Bearer відсутній, кінцева точка повертає рівень анонімного доступу, визначений пристроєм: guest, user або powerUser. Анонімний доступ може надаватися в діагностичному режимі, через довірений VPN-доступ або якщо перевірку відповідного Web-пароля вимкнено. Якщо перевірку powerUser вимкнено, повертається powerUser; інакше, якщо перевірку user вимкнено, повертається user.

Novatek-Electro TR-100E Documentation

GET /api/auth/salt/ Отримує salt, що використовується для обчислення хешу пароля на боці клієнта. Авторизація: не потрібна. Відповідь 200 { "salt": "sFtqKto6hnaURPGQLJOCT1QMx7myDEGLBsCz3a2L" } Поля відповіді Поле Тип Обов’язкове Опис salt рядок так 40-символьний рядок ASCII Вимоги до salt Довжина: 40 символів. Допустимі символи: [A-Za-z0-9]. Сіль стає недійсною після кожної спроби POST /api/auth/login/, незалежно від її результату. Перед кожною спробою входу необхідно запитувати нову сіль.

Novatek-Electro TR-100E Documentation

POST /api/auth/login/ Створює авторизований сеанс. Авторизація: не потрібна. Запит { "username": "tr100e", "passwordHash": "6c2a6f1f6f1edc1c6b7b5d3f7c6c8ce6e1f6bb3f4c1f9c0b0c2d5e8f7a9b3c4d" } Поля запиту Поле Тип Обов’язкове Опис username рядок так Ім’я користувача; має дорівнювати "tr100e" passwordHash рядок так Шістнадцятковий рядок SHA-256 завдовжки 64 символи Формула хешу SHA256(username + password + salt) де salt отримано за допомогою GET /api/auth/salt/. Важливо: сіль одноразова та стає недійсною після кожної спроби входу. Перед повторною спробою входу запитайте нову сіль. Значення passwordHash спочатку звіряється з паролем powerUser, а потім — із паролем user. Значення accessLevel у відповіді відповідає паролю, з яким збігся хеш. Якщо перевірку Web-пароля вимкнено налаштуванням webPwrPassEnable або webUserPassEnable, пристрій може надати відповідний рівень анонімного доступу без запиту на вхід; визначити цей рівень можна за допомогою GET /api/auth/status/. Вимкнена перевірка powerUser має пріоритет над вимкненою перевіркою user. Відповідь 200 { "authType": "Bearer", "token": "ej5k2pVg4Pd8yBdUqFPq8bdaStpeAZhyelpmkhtOivdK8r7E", "ttlSec": 60, "accessLevel": "user" } Поля відповіді Поле Тип Обов’язкове Опис authType рядок так Завжди "Bearer" token рядок так 48-символьний рядок ASCII [A-Za-z0-9] ttlSec число так Тривалість сеансу в секундах accessLevel рядок так "user" або "powerUser" Захист від перебору паролів Спільний лічильник невдалих спроб використовується для всіх інтерфейсів (Web, клавіатури та Modbus). Після 5 невдалих спроб усі інтерфейси блокуються на 300 секунд. Лічильник скидається після 300 секунд бездіяльності або після успішного входу. Стан зберігається в резервних регістрах RTC і не втрачається після вимкнення живлення. Відповідь 401 (неправильний пароль) { "error": "ERROR_UNAUTHORIZED", "message": "3 attempts left" } Відповідь 429 (активне блокування) { "error": "ERROR_LOCKED", "message": "Retry after 247 seconds" }

Novatek-Electro TR-100E Documentation
POST /api/auth/logout/ Завершує поточний сеанс. Авторизація: Bearer. Запит {} Тіло запиту не містить значущих полів. Відповідь 200 {}

Novatek-Electro TR-100E Documentation

GET /api/state/get/?device&network&relays&leds&protection&recorder&channels&log&ntp&httpd&modbus&wireguard Отримує одну або кілька груп верхнього рівня з поточним станом роботи. Авторизація: Bearer. Параметри запиту Кожен ключ запиту є прапорцем, що запитує відповідну групу. Допустимі ключі: device, network, relays, leds, protection, recorder, channels, log, ntp, httpd, modbus, wireguard Потрібен принаймні один ключ. Невідомий ключ → 404 ERROR_NOT_FOUND. Відсутні ключі → 400 ERROR_API_PARSING. Перевищено обсяг доступної пам’яті → 507 ERROR_NO_MEMORY. Відповідь 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" } } } Повертаються лише явно запитані групи. Група device Поле Тип Опис uptimeSec число Час роботи від моменту ввімкнення (секунди) dateTimeUtc рядок Поточний час пристрою у форматі ISO 8601 UTC localOffsetMin число Фактичне зміщення місцевого часу у хвилинах, з урахуванням DST dstActive логічний Чи активний DST deviceNeedReboot логічний Пристрій потребує перезавантаження isDiagnosticMode логічний Режим діагностики активовано під час запуску натисканням кнопок «Вгору» + «Вниз» settingsValid логічний Збережені налаштування коректні calibrationValid логічний Збережене заводське калібрування коректне rebootAfterSec число|null Секунд до запланованого перезавантаження (null = не заплановано) Група network Поле Тип Опис macAddress рядок MAC-адреса isUnique логічний true = унікальна EUI-48, false = резервна ipAddress рядок IP-адреса subnetMask рядок Маска підмережі gateway рядок Шлюз dns масив рядків DNS-сервери dhcp.state рядок Стан DHCP: off, configuring, searching, requesting, bound, renewing, rebinding, retrying dhcp.serverAddress рядок IPv4-адреса DHCP-сервера dhcp.leaseSeconds число Повна тривалість оренди у секундах dhcp.remainingSeconds число Залишок тривалості оренди у секундах Група relays Поле Тип Опис trip логічний Стан реле «Перегрів» alarm логічний Стан реле «Тривога» fan логічний Стан реле «Вентиляція» fault логічний Стан реле «Відмова» inTestMode логічний Активна службова перевірка реле Група leds Поле Тип Опис inTestMode логічний Активна службова перевірка світлодіодів Група protection Поле Тип Опис trip логічний Логічний прапорець захисту «Перегрів» alarm логічний Логічний прапорець захисту «Тривога» fan логічний Логічний прапорець захисту «Вентиляція» fault логічний Логічний прапорець захисту «Відмова» Група recorder Поле Тип Опис enabled логічний Реєстратор увімкнено available логічний Реєстратор доступний total число Кількість доступних записів periodSec число Поточний період записування (секунди) lastError число Код останньої помилки errorCount число Кількість помилок Група channels Масив із 4 елементів (CH1..CH4). Поле Тип Опис enabled логічний Канал увімкнено temperature рядок|null Поточна температура (десяткове число, 1 цифра після крапки), null якщо значення некоректне minTemperature рядок|null Мінімальна температура maxTemperature рядок|null Максимальна температура trend рядок "up", "down", "stable" circuitState рядок "normal", "open", "short" trip логічний Канал у стані «Перегрів» alarm логічний Канал у стані «Тривога» fan логічний Канал у стані «Вентиляція» Група log Поле Тип Опис available логічний Журнал доступний total число Кількість доступних подій lastTimestampUtc рядок|null Мітка часу UTC останньої події; null якщо журнал порожній pending число Кількість непідтверджених подій у поточному сеансі живлення Група ntp Поле Тип Опис enabled логічний NTP увімкнено в налаштуваннях available логічний Клієнт NTP готовий у поточному стані роботи lastSyncUtc рядок|null Час UTC останньої успішної синхронізації; null якщо синхронізації не було syncCount число Кількість успішних синхронізацій від моменту ввімкнення failCount число Кількість невдалих спроб від моменту ввімкнення Група httpd Поле Тип Опис enabled логічний Web-сервер увімкнено в налаштуваннях available логічний HTTPD готовий у поточному стані роботи activeConnections число Активні наразі TCP-з’єднання maxConnections число Максимальна кількість одночасних з’єднань (константа) activeSessions число Авторизовані наразі сеанси maxSessions число Максимальна кількість одночасних сеансів (константа) port число TCP-порт HTTP-сервера connections масив Активні TCP-з’єднання connections[].ip рядок IP-адреса клієнта connections[].port число TCP-порт клієнта Група modbus Поле Тип Опис enabled логічний Modbus TCP увімкнено в налаштуваннях available логічний Сервер Modbus TCP готовий activeConnections число Поточна кількість активних TCP-з’єднань maxConnections число Максимальна кількість одночасних з’єднань blockedIps число Кількість заблокованих IP-адрес після невдалих спроб введення пароля port число Modbus Порт TCP rxPackets число Отримано пакетів через усі з’єднання від моменту запуску txPackets число Надіслано пакетів через усі з’єднання від моменту запуску rxErrors число Помилки отримання через усі з’єднання від моменту запуску txErrors число Помилки передавання через усі з’єднання від моменту запуску exceptionResp число Відповідей Modbus Exception надіслано від моменту запуску rxBytes число Отримано байтів через усі з’єднання від моменту запуску txBytes число Надіслано байтів через усі з’єднання від моменту запуску rxPerSec число Поточна сумарна швидкість отримання, packets/s txPerSec число Поточна сумарна швидкість передавання, packets/s connections масив Активні TCP-з’єднання connections[].ip рядок IP-адреса клієнта connections[].port число TCP-порт клієнта connections[].uptimeSec число Час роботи з’єднання, секунд connections[].unlocked логічний Захищені операції розблоковано для з’єднання connections[].rxPackets число Отримано пакетів через з’єднання connections[].txPackets число Надіслано пакетів через з’єднання connections[].rxErrors число Помилки отримання через з’єднання connections[].txErrors число Помилки передавання через з’єднання connections[].exceptionResp число Відповідей Modbus Exception надіслано через з’єднання connections[].rxBytes число Отримано байтів через з’єднання connections[].txBytes число Надіслано байтів через з’єднання connections[].rxPerSec число Поточна швидкість отримання через з’єднання, packets/s connections[].txPerSec число Поточна швидкість передавання через з’єднання, packets/s Група wireguard Поле Тип Опис enabled логічний WG увімкнено в налаштуваннях mode рядок Режим конфігурації: "auto" або "static" status об’єкт Стислий робочий стан WireGuard endpoint об’єкт Кінцева точка віддаленого вузла interface об’єкт Відповідність налаштованого та фактичного інтерфейсів wireguard.status Поле Тип Опис link рядок Стан з’єднання: "disabled", "netif", "configured", "connected", "up" config рядок Стан конфігурації: "disabled", "staticInvalid", "pause", "serverResolving", "serverConnecting", "discoverWait", "connectWait", "peerResolving", "ready" lastPeerUpUtc рядок|null Час UTC останньої доступності вузла; null якщо ніколи lastHandshakeAgeSec число|null Час від останнього handshake/keepalive вузла у секундах; null якщо немає lastActivityAgeSec число|null Час від останньої активності вузла (handshake/keepalive, RX, або TX) у секундах; null якщо немає rxPackets число Отримано пакетів через тунель WG txPackets число Надіслано пакетів через тунель WG wireguard.endpoint Поле Тип Опис hostname рядок|null Ім’я вузла кінцевої точки address рядок|null Визначена IP-адреса кінцевої точки port число|null Порт кінцевої точки keepaliveSec число|null Поточний інтервал keepalive вузла у секундах peerPublicKey рядок|null Відкритий ключ вузла allowedIps масив Дозволені мережі вузла у форматі IPv4 CIDR wireguard.interface Поле Тип Опис configured рядок|null Налаштована адреса інтерфейсу у нотації CIDR runtime рядок|null Фактична активна адреса інтерфейсу у нотації CIDR devicePublicKey рядок|null Відкритий ключ пристрою

Novatek-Electro TR-100E Documentation

GET /api/settings/get/?meta&general&dateTime&display&access&recorder&network&ntp&web&modbus&vpnWireguard&channels&protection Отримує одну або кілька груп верхнього рівня з постійними налаштуваннями. Авторизація: Bearer. Паролі access доступні лише для запису й не включаються до відповідей за жодного рівня доступу. Закритий ключ vpnWireguard.privateKey повертається лише для powerUser; для user значення поля — null. Параметри запиту Кожен ключ запиту є прапорцем, що запитує відповідну групу. Допустимі ключі: meta, general, dateTime, display, access, recorder, network, ntp, web, modbus, vpnWireguard, channels, protection Потрібен принаймні один ключ. Невідомий ключ → 404 ERROR_NOT_FOUND. Відсутні ключі → 400 ERROR_API_PARSING. Перевищено обсяг доступної пам’яті → 507 ERROR_NO_MEMORY. Відповідь 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 } } } Повертаються лише явно запитані групи. Група meta Поле Тип Опис sequence число Порядковий номер збереження налаштувань fwVersion рядок Версія прошивки, яка створила знімок isDefault логічний Налаштування за замовчуванням savedAt рядок Час останнього збереження (ISO 8601 UTC) dataLength число Довжина даних dataCrc32 рядок CRC32 даних (шістнадцяткове число, 8 символів) headerCrc32 рядок CRC32 заголовка (шістнадцяткове число, 8 символів) Група general Поле Тип Опис language рядок Мова інтерфейсу logDebugMask число Бітова маска модулів журналу налагодження (bit0 = WireGuard) Група dateTime Поле Тип Опис timezoneOffset число Зміщення часового поясу у хвилинах dst об’єкт Налаштування сезонного переведення годинника dst.mode число Режим DST dst.deltaMin число Величина зміщення у хвилинах dst.startLocal рядок Початок DST (місцевий час) dst.endLocal рядок Завершення DST (місцевий час) Група display Поле Тип Опис contrast число Контрастність activeBacklightPercent число Яскравість активного підсвічування, % idleBacklightEnable логічний Чи зменшується яскравість підсвічування під час бездіяльності idleBacklightPercent число Яскравість підсвічування під час бездіяльності, % idleTimeoutSec число Час бездіяльності до зменшення яскравості, секунд Група access Поле Тип Опис devPasswordEnable логічний Вимагати пароль під час входу до локального меню webUserPassEnable логічний Вимагати пароль Web-доступу рівня user webPwrPassEnable логічний Вимагати пароль Web-доступу рівня powerUser modbusPasswordEnable логічний Вимагати пароль для розблокування захищених операцій Modbus TCP Поля devPassword, webUserPass, webPwrPass і modbusPassword навмисно вилучено з відповіді. API не розкриває ані збережені паролі, ані факт установлення власного значення. Клієнти мають визначати стан захисту лише за прапорцями ...PasswordEnable. На рівні user ці прапорці повертаються зі значенням null; їхні значення доступні для powerUser. Група recorder Поле Тип Опис enabled логічний Реєстрацію температури увімкнено periodSec число Період записування у секундах Група network Поле Тип Опис enabled логічний Ethernet увімкнено dhcpEnable логічний DHCP увімкнено dns масив рядків DNS-сервери ipAddress рядок Статична IP-адреса subnetMask рядок Маска підмережі gateway рядок Шлюз Група ntp Поле Тип Опис enabled логічний NTP увімкнено syncPeriodSec число Період синхронізації (секунди) server1 рядок Основний NTP-сервер server2 рядок Резервний NTP-сервер Група web Поле Тип Опис enabled логічний Web-сервер увімкнено port число Порт HTTP vpnTrusted логічний Довіряти Web-доступу через VPN vpnAccessLevel число Доступ через VPN: 0 = стандартна авторизація за паролем, 1 = user, 2 = powerUser Група modbus Поле Тип Опис enabled логічний Modbus TCP увімкнено unitId число Ідентифікатор пристрою port число Порт TCP timeoutSec число Час очікування (секунди) protectMode число Режим захисту: 0 = немає, 1 = захист від запису, 2 = захист від читання та запису vpnAccessLevel число Доступ через VPN: 0 = вимкнено, 1 = використовує загальний захист, 2 = лише читання, 3 = читання й запис Група vpnWireguard Поле Тип Опис enabled логічний WireGuard увімкнено autoConfigEnable логічний Режим автоматичної конфігурації Overvis (параметри отримуються з хмари за ідентифікатором пристрою) autoConfigUrl рядок URL сервера автоматичної конфігурації privateKey рядок Статичний закритий ключ WireGuard у форматі base64 address рядок Адреса локального інтерфейсу у нотації CIDR, наприклад 10.0.0.2/24 peerPublicKey рядок Статичний відкритий ключ вузла WireGuard у форматі base64 peerHostname рядок Ім’я вузла peerPort число Порт вузла allowedIps масив рядків Рівно 2 маршрути вузла у форматі CIDR keepaliveSec число Постійний інтервал keepalive у секундах Коли autoConfigEnable = false, використовуються всі статичні поля vpnWireguard, зокрема ключі та кінцева точка. Коли autoConfigEnable = true, статичні поля vpnWireguard під час роботи ігноруються; WireGuard/Overvis отримує параметри через API службової ідентифікації для автоматичної конфігурації. Група channels Поле Тип Опис filterLevel число Рівень фільтра items масив Масив із 4 каналів channels.items[] Поле Тип Опис enabled логічний Канал увімкнено sensorTypeId число Ідентифікатор типу датчика (see /api/reference/sensor-types/) userOffset число Користувацьке зміщення ptcMinikaNominal число Номінальне значення PTC Minika linked число Належність до спільної групи порогів і гістерезису TRIP/ALARM/FAN: 0 = незалежний, 1 = пов’язаний Група protection protection.trip / protection.alarm Поле Тип Опис delaySec число Затримка спрацювання (секунди) channels масив Уставки для кожного каналу (4 elements) protection.trip.channels[] / protection.alarm.channels[] Поле Тип Опис threshold число Уставка температури hysteresis число Гістерезис protection.fan Поле Тип Опис mode число Режим роботи delaySec число Затримка спрацювання (секунди) channels масив Уставки для кожного каналу (4 elements) protection.fault Поле Тип Опис delaySec число Затримка спрацювання (секунди) Діапазони та обмеження Наведені нижче діапазони відповідають обмеженням прошивки в Application/User/settings.h. general.language: en | pl | ua | ru. general.logDebugMask: 0..65535 (бітова маска). dateTime.timezoneOffset: -720..840 хвилин. dateTime.dst.mode: 0..3 (OFF, EU, US, MANUAL). dateTime.dst.deltaMin: 0..180 хвилин. display.contrast: 0..64. display.activeBacklightPercent: 0..100. display.idleBacklightEnable: true | false. display.idleBacklightPercent: 0..100. display.idleTimeoutSec: 30..3600 секунд. access.devPasswordEnable, access.webUserPassEnable, access.webPwrPassEnable, access.modbusPasswordEnable: true | false. Ця кінцева точка не повертає паролі access; обмеження щодо їх запису описано в POST /api/settings/set/. recorder.enabled: true | false. recorder.periodSec: 5..3600 секунд. ntp.syncPeriodSec: 300..86400 секунд. ntp.server1, ntp.server2: до 31 символів кожен. web.port: 1..65535. web.vpnTrusted: true | false. web.vpnAccessLevel: 0..2 (password, user, powerUser); 0 використовує стандартну авторизацію за паролем. modbus.unitId: 0..247; 0 — приймати запити з будь-яким Unit ID. modbus.port: 1..65535. modbus.timeoutSec: 1..3600 секунд. 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 секунд. channels.filterLevel: 1..10. channels.items[].sensorTypeId: 0..MSR_SENSOR_COUNT-1; допустимі значення опубліковано через 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 секунд. 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/ Частково оновлює збережені налаштування (семантика злиття). Авторизація: Bearer (powerUser). Запит { "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 } } Поля запиту Усі групи верхнього рівня необов’язкові: general, dateTime, display, access, recorder, network, ntp, web, modbus, vpnWireguard, channels, protection. Група meta доступна лише для читання. Вкладені об’єкти оновлюються частково (зливаються). Якщо поле пароля пропущено, пароль не змінюється. Масиви замінюються повністю: network.dns, vpnWireguard.allowedIps, channels.items, protection.trip.channels, protection.alarm.channels, protection.fan.channels. Перевірка Невідомі ключі не допускаються → 400 ERROR_INVALID_VALUE. Тип значення має відповідати схемі. Масиви каналів повинні мати довжину 4. sensorTypeId має відповідати GET /api/reference/sensor-types/. Тіло запиту ≤ 4096 байтів. Обмеження полів, доступних для запису Наведені нижче обмеження відповідають перевірці у прошивці в Application/User/settings.h. general.logDebugMask: 0..65535 (бітова маска, bit0 = WireGuard). dateTime.timezoneOffset: -720..840 хвилин. dateTime.dst.mode: 0..3. dateTime.dst.deltaMin: 0..180 хвилин. display.contrast: 0..64. display.activeBacklightPercent: 0..100. display.idleBacklightEnable: true | false. display.idleBacklightPercent: 0..100. display.idleTimeoutSec: 30..3600 секунд. access.devPasswordEnable, access.webUserPassEnable, access.webPwrPassEnable, access.modbusPasswordEnable: true | false; false вимикає перевірку відповідного пароля, не видаляючи збережене значення. access.devPassword: рядок завдовжки 4..23 символів. access.webUserPass, access.webPwrPass, access.modbusPassword: рядок завдовжки 8..23 символів. Допустимі символи пароля: цифри 0–9, латинські літери A–Z, a–z і символи ., -, _, :, /, @. Пароль null, порожній рядок, закоротке чи задовге значення або недопустимий символ → 400 ERROR_INVALID_VALUE. Щоб залишити пароль без змін, пропустіть поле. Стан захисту змінюється незалежно за допомогою відповідного прапорця ...PasswordEnable. recorder.enabled: true | false. recorder.periodSec: 5..3600 секунд. ntp.syncPeriodSec: 300..86400 секунд. ntp.server1, ntp.server2: до 31 символів кожен. web.port: 1..65535. web.vpnTrusted: true | false. web.vpnAccessLevel: 0..2 (password, user, powerUser); 0 використовує стандартну авторизацію за паролем. modbus.unitId: 0..247; 0 — приймати запити з будь-яким Unit ID. modbus.port: 1..65535. modbus.timeoutSec: 1..3600 секунд. 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: URL сервера автоматичної конфігурації. vpnWireguard.privateKey: Рядок WireGuard у форматі base64 для статичного закритого ключа. Порожній рядок "" очищає ключ. vpnWireguard.address: Рядок IPv4 CIDR, наприклад 10.8.0.2/24. Порожній рядок "" очищає адресу. vpnWireguard.peerPublicKey: Рядок WireGuard у форматі base64 для статичного відкритого ключа вузла. Порожній рядок "" очищає ключ. vpnWireguard.peerHostname: ім’я вузла. vpnWireguard.peerPort: 1..65535. vpnWireguard.allowedIps: масив із 2 рядків IPv4 CIDR. Порожній рядок "" очищає елемент. vpnWireguard.keepaliveSec: 1..300 секунд. 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; під час запису порога або гістерезису TRIP/ALARM/FAN для пов’язаного каналу значення автоматично копіюється до всіх пов’язаних каналів. protection.trip.delaySec, protection.alarm.delaySec, protection.fan.delaySec, protection.fault.delaySec: 0..60 секунд. 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. Відповідь 200 {} Коли vpnWireguard.autoConfigEnable = false, статичні параметри WireGuard із vpnWireguard зберігаються та використовуються. Коли vpnWireguard.autoConfigEnable = true, статичні параметри WireGuard можуть залишатися збереженими в налаштуваннях, але під час роботи ігноруються; у режимі Overvis конфігурація надходить з API службової ідентифікації.

Novatek-Electro TR-100E Documentation

GET /api/reference/sensor-types/ Отримує список підтримуваних типів датчиків. Авторизація: Bearer. Відповідь 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)" } ] } Поля відповіді Поле Тип Обов’язкове Опис items масив так Список типів items[].id число так Числовий ідентифікатор items[].shortName рядок так Коротка назва датчика items[].description рядок так Опис датчика

Novatek-Electro TR-100E Documentation

GET /api/history/temperature/info/ Отримує метадані вікна оперативної історії без масиву вибірок. Авторизація: Bearer. Відповідь 200 { "capacity": 120, "periodSec": 5, "total": 120, "lastSequence": 1236 } Поля відповіді Поле Тип Обов’язкове Опис capacity число так Максимальна місткість кільцевого буфера для кожного каналу periodSec число так Інтервал записування вибірок у секундах total число так Поточна кількість коректних вибірок lastSequence число так Порядковий номер найновішої вибірки

Novatek-Electro TR-100E Documentation

GET /api/history/temperature/samples/?page=1&pageSize=2&direct=desc Отримує сторінку синхронізованих вибірок історії для всіх чотирьох каналів. Авторизація: Bearer. Параметри запиту Параметр Тип Обов’язковий Типове значення Опис page число ні* — Номер сторінки, починаючи з 1. Використовується лише в першому запиті серії. Ігнорується, якщо вказано cursor. pageSize число так — Кількість вибірок на сторінці. Допустимий діапазон: 1..20. direct рядок ні "desc" Напрямок сортування: "asc" — від найстаріших до найновіших; "desc" — від найновіших до найстаріших. cursor число ні* — Курсор для продовження запиту. Див. нижче. *Потрібно вказати page або cursor. cursor Курсор забезпечує стабільну послідовну пагінацію без дублікатів і пропусків. Перший запит серії: клієнт передає page=1 і не передає cursor. Сервер починає запит із lastSequence (desc) або oldestSequence (asc). Відповідь містить nextCursor — позицію, з якої слід продовжити. Наступні запити: клієнт передає cursor із попередньої відповіді; page ігнорується. Кінець запиту: nextCursor: null означає, що доступних даних більше немає. Нова серія (у разі переходу на іншу сторінку інтерфейсу): клієнт скидає cursor і знову починає з page=1. Відповідь 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 } Поля відповіді Поле Тип Опис nextCursor число|null Курсор для наступного запиту. null, якщо досягнуто кінця запиту. periodSec число Інтервал записування історії в секундах. lastSequence число Поточний монотонний порядковий номер на момент запиту. samples масив Вибірки в порядку direct (елементів: 0..pageSize). sampleCount число Кількість вибірок у поточному наборі результатів. Якщо доступних даних більше немає, відповідь містить sampleCount: 0, samples: [] і nextCursor: null. Це не є помилкою. samples[] Поле Тип Опис sequence число Порядковий номер цієї вибірки. channels масив 4 елементи (CH1..CH4). samples[].channels[] Поле Тип Опис state рядок "normal", "open", "short", "invalid" temperature число|null Температура (null, якщо значення некоректне) Сценарій: заповнення вікна інтерфейсу на 60 вибірок (3 запити по 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": [...] } У першому запиті використовується page=1; у наступних — cursor із попередньої відповіді.

Novatek-Electro TR-100E Documentation

GET /api/recorder/info/ Отримує метадані реєстратора без масиву записів. Авторизація: Bearer. Відповідь 200 { "capacity": 16384, "total": 1532, "oldestSequence": 3, "lastSequence": 1534, "period": 30 } Поля відповіді Поле Тип Обов’язкове Опис capacity число так Максимальна місткість кільцевого буфера total число так Кількість доступних архівних записів oldestSequence число так Порядковий номер найстарішого запису lastSequence число так Порядковий номер найновішого запису period число так Налаштований інтервал записування в секундах (1..3600); записування вмикається окремо параметром tempRecordEnable

Novatek-Electro TR-100E Documentation

GET /api/recorder/records/?page=1&pageSize=2&direct=desc Отримує сторінку архівних записів реєстратора. Авторизація: Bearer. Параметри запиту Параметр Тип Обов’язковий Типове значення Опис page число ні* — Номер сторінки, починаючи з 1. Використовується лише в першому запиті серії. Ігнорується, якщо вказано cursor. pageSize число так — Кількість записів на сторінці. Допустимий діапазон: 1..8. direct рядок ні "desc" Напрямок сортування: "asc" — від найстаріших до найновіших; "desc" — від найновіших до найстаріших. cursor число ні* — Курсор для продовження запиту. Див. нижче. *Потрібно вказати page або cursor. cursor Курсор забезпечує стабільну послідовну пагінацію без дублікатів і пропусків. Перший запит серії: клієнт передає page=1 і не передає cursor. Сервер починає запит із lastSequence (desc) або oldestSequence (asc). Відповідь містить nextCursor — позицію, з якої слід продовжити. Наступні запити: клієнт передає cursor із попередньої відповіді; page ігнорується. Кінець запиту: nextCursor: null означає, що доступних даних більше немає. Нова серія (у разі переходу на іншу сторінку інтерфейсу): клієнт скидає cursor і знову починає з page=1. Відповідь 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 } ] } ] } Поля відповіді Поле Тип Опис nextCursor число|null Курсор для наступного запиту. null, якщо досягнуто кінця запиту. recordCount число Кількість записів у поточному наборі результатів (0..pageSize). records масив Записи в порядку direct. Якщо доступних даних більше немає, відповідь містить recordCount: 0, records: [] і nextCursor: null. Це не є помилкою. records[] Поле Тип Опис sequence число Порядковий номер запису timestamp рядок ISO 8601 UTC channels масив 4 елементи (CH1..CH4) records[].channels[] Поле Тип Опис state рядок "normal", "open", "short", "invalid" temperature число|null Температура (null, якщо стан не "normal") enabled логічний Чи ввімкнено канал trip логічний Стан реле «Перегрів» alarm логічний Стан реле «Тривога» fan логічний Стан реле «Вентиляція» Сценарій: заповнення сторінки інтерфейсу на 25 записів (5 запитів по 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": [...] } У першому запиті використовується page=1; у наступних — cursor із попередньої відповіді.

Novatek-Electro TR-100E Documentation

GET /api/recorder/export.csv/ Експортує дані реєстратора у форматі CSV. Авторизація: Bearer. Відповідь 200 Content-Type: text/csv Content-Disposition: attachment; filename="tr100e_recorder.csv" Формат CSV Перший рядок — це рядок заголовків. Роздільник: ;. Кожен рядок відповідає одному запису реєстратора. Температура: десяткове число з однією цифрою після крапки. Якщо значення некоректне, поле залишається порожнім. chN_status: компактне позначення стану каналу (disabled, open, short, normal, trip, alarm, fan, invalid або комбінація значень, розділених знаком +). Порядок колонок 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/ Очищає реєстратор. Авторизація: Bearer (powerUser). Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має дорівнювати true Порожнє або синтаксично некоректне тіло JSON → 400 ERROR_API_PARSING. Відсутнє значення confirm, значення не логічного типу або false → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {}

Novatek-Electro TR-100E Documentation

GET /api/log/info/ Отримує зведені відомості про журнал подій. Авторизація: Bearer. Відповідь 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 } } Поля відповіді Поле Тип Обов’язкове Опис capacity число так Максимальна місткість кільцевого буфера total число так Кількість доступних подій pending число так Кількість непідтверджених подій у поточному сеансі живлення oldestSequence число так Порядковий номер найстарішої доступної події в кільцевому буфері. Для сторінок інтерфейсу, що відображають oldest події, це основна ознака того, що старий край вікна справді змістився через витіснення подій. lastSequence число так Порядковий номер найновішої події. Інтерфейс використовує це поле для виявлення нових подій: якщо значення зросло порівняно з попередньо збереженим, до журналу додано N = lastSequence_new - lastSequence_old нових подій. Отримувати ці N подій доречно, лише якщо поточна сторінка інтерфейсу містить попередньо збережений lastSequence (тобто користувач перебуває на останній сторінці, де з’являються нові записи); на інших сторінках оновлення не потрібне. totalBySeverity об’єкт так Розподіл total за рівнем важливості pendingBySeverity об’єкт так Розподіл pending за рівнем важливості totalBySeverity Поле Тип Опис debug число Кількість доступних подій DEBUG info число Кількість доступних подій INFO warning число Кількість доступних подій WARNING error число Кількість доступних подій ERROR fault число Кількість доступних подій FAULT pendingBySeverity Поле Тип Опис debug число Кількість непідтверджених подій DEBUG info число Кількість непідтверджених подій INFO warning число Кількість непідтверджених подій WARNING error число Кількість непідтверджених подій ERROR fault число Кількість непідтверджених подій FAULT

Novatek-Electro TR-100E Documentation

GET /api/log/events/?page=1&pageSize=1&direct=desc Отримує сторінку подій журналу зі стабільною пагінацією. Авторизація: Bearer. Параметри запиту Параметр Тип Обов’язковий Типове значення Опис page число ні* — Номер сторінки, починаючи з 1. Використовується лише в першому запиті серії. Ігнорується, якщо вказано cursor. pageSize число так — Кількість подій на сторінці. Допустимий діапазон: 1..8. direct рядок ні "desc" Напрямок сортування: "asc" — від найстаріших до найновіших; "desc" — від найновіших до найстаріших. severityMask число ні усі (31) Бітова маска рівнів важливості: bit0=DEBUG, bit1=INFO, bit2=WARNING, bit3=ERROR, bit4=FAULT. cursor число ні* — Курсор для продовження запиту. Див. нижче. *Потрібно вказати page або cursor. cursor Курсор забезпечує стабільну послідовну пагінацію без дублікатів і пропусків. Перший запит серії: клієнт передає page=1 і не передає cursor. Сервер починає запит із lastSequence (desc) або oldestSequence (asc). Відповідь містить nextCursor — позицію, з якої слід продовжити. Наступні запити: клієнт передає cursor із попередньої відповіді; page ігнорується. Кінець запиту: nextCursor: null означає, що доступних даних більше немає. Нова серія (у разі переходу на іншу сторінку інтерфейсу): клієнт скидає cursor і знову починає з page=1. Відповідь 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" } } ] } Поля відповіді Поле Тип Опис nextCursor число|null Курсор для наступного запиту. null, якщо досягнуто кінця запиту. eventCount число Кількість подій у поточному наборі результатів (0..pageSize). events масив Події в порядку direct. Якщо доступних даних більше немає, відповідь містить eventCount: 0, events: [] і nextCursor: null. Це не є помилкою. events[] Поле Тип Обов’язкове Опис sequence число так Порядковий номер події timestamp рядок так ISO 8601 UTC errorCode число так Код помилки pending логічний так true, якщо подію ще не підтверджено в поточному сеансі живлення severity рядок так "DEBUG", "INFO", "WARNING", "ERROR", "FAULT" dataType рядок так "GENERIC", "FAULT", "NETWORK" generic об’єкт ні Наявне, якщо dataType = "GENERIC" fault об’єкт ні Наявне, якщо dataType = "FAULT" network об’єкт ні Наявне, якщо dataType = "NETWORK" generic Поле Тип Опис message рядок Текст події fault Поле Тип Опис taskName рядок Назва завдання registers рядок Один рядок у форматі PC=... LR=... SP=... CFSR=... HFSR=... MMFAR=... BFAR=... R0=... R1=... R2=... R3=... R12=... xPSR=... network Поле Тип Опис message рядок Текст remoteIp рядок Віддалена IP-адреса remotePort число Віддалений порт localPort число Локальний порт lwipError число Код помилки lwIP Сценарій: заповнення сторінки інтерфейсу на 25 подій (5 запитів по 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": [...] } У першому запиті використовується page=1; у наступних — cursor із попередньої відповіді. Завдяки cursor сервер не сканує повторно вже прочитані записи, що особливо важливо під час фільтрування за severityMask.

Novatek-Electro TR-100E Documentation

GET /api/log/export.log/ Експортує журнал у текстовому форматі. Авторизація: Bearer. Відповідь 200 Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename="tr100e_events.log" Перший рядок файлу містить заголовок: {DEVICE_NAME} Sn: {UUID0}-{UUID1}-{UUID2} Fw: v{FW_VERSION} LOGS Далі події розташовано від найновіших до найстаріших. Формат рядка {timestamp} {severity padded to 7} {dataType in brackets padded to 10}{detail} Поле типу даних разом із квадратними дужками та пробілами в кінці займає 10 символів: три пробіли додаються після [FAULT], а один — після [GENERIC] і [NETWORK]. Приклади 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 Вміст поля detail залежно від значення 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} — регістри в шістнадцятковому форматі %08X NETWORK: {message} {remoteIp}:{remotePort}->{localPort} lwip={lwipError}

Novatek-Electro TR-100E Documentation
POST /api/log/acknowledge/ Скидає ознаку непідтверджених подій. Авторизація: Bearer. Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має дорівнювати true Порожнє тіло або некоректний JSON → 400 ERROR_API_PARSING. confirm != true → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {}

Novatek-Electro TR-100E Documentation
POST /api/log/clear/ Очищає журнал подій. Авторизація: Bearer (powerUser). Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має дорівнювати true Порожнє тіло або некоректний JSON → 400 ERROR_API_PARSING. confirm != true → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {}

Novatek-Electro TR-100E Documentation

Сервіс калібрування Заводське калібрування виконується в межах одного спільного для всього пристрою сеансу. Сеанс монопольно використовує вимірювальний тракт, завершується після 30 секунд бездіяльності та зберігає чернетку в оперативній пам’яті до операції commit. Успішні операції status, range, capture і commit подовжують строк дії сеансу. Авторизація GET /api/service/calibration/report/ потребує Bearer powerUser; апаратний сервісний ключ не потрібен. status і всі кінцеві точки, що вносять зміни, потребують Bearer powerUser та збереженого прапорця наявності апаратного сервісного ключа. За відсутності ключа кінцева точка повертає 403 ERROR_NO_ACCESS. Модель даних Передбачено шість незалежних комірок: x24_p1 (50 Ом), x24_p2 (100 Ом), x24_p3 (200 Ом), x2_p1 (500 Ом), x2_p2 (1000 Ом) і x2_p3 (2000 Ом). Кожен збережений знімок містить застосований абсолютний допуск і необроблені значення АЦП для чотирьох каналів. Поточні значення опору та перевірки для вибраної комірки обчислюються лише за її еталонним і зчитаним значеннями АЦП: R = referenceOhm * ADC / capturedAdc. Значення previewOhm, deltaOhm і deltaPercent обчислюються динамічно під час формування відповіді. Інші комірки в обчисленні не беруть участі. Допуск обчислює інструмент виробника. Під час операції commit прошивка отримує два остаточні значення, зберігає їх як історичні дані та не визначає, чи відповідає вимірювання технічним вимогам. Одразу після зчитування відповідний елемент captures уже містить усі поля знімка. Доки не буде опрацьовано десять нових вікон перевірки, поля verifyAdc, previewOhm, deltaOhm і deltaPercent мають нульові значення. До операції commit поле tolerance має значення null. Готовність результату слід визначати за станом: завершений знімок стає доступним після переходу зі стану verify_capture у active. Вихідні дані завершеного знімка не змінюються, доки ту саму комірку не буде зчитано повторно. Зчитування іншої точки не робить завершені знімки недійсними. GET /api/service/calibration/report/ Формує останній повний звіт про якість зі збережених комірок калібрування. Окрема сутність звіту у Flash-пам’яті не зберігається. Відповідь 200, звіт недоступний { "available": false } Відповідь available: false означає, що збережений звіт недоступний. API не вказує причину його недоступності. Відповідь 200, звіт доступний { "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 } ] } } } Повна відповідь містить усі шість ключів знімків і чотири канали в кожному знімку. Карти допусків верхнього рівня немає. Поля scale та offset відсутні. GET /api/service/calibration/status/ Повертає активний сеанс і подовжує строк його дії на 30 секунд. Відповідь 200, стан бездіяльності { "state": "idle" } Відповідь 200, активний стан { "state": "active", "sessionId": "7A19C2E4", "activeGain": "x24", "activePoint": "p1", "committedAt": null, "captures": {}, "live": [ { "channel": 0, "filteredAdc": 123456, "resistanceOhm": 100.01 } ] } Спостережувані активні стани: switching, active і verify_capture. Внутрішня модель також містить стани committing і stopping, але операції збереження та завершення виконуються синхронно, тому status не повертає ці перехідні стани. Інструмент виробника застосовує допуск для поточної процедури зі своєї конфігурації. Для незбережених елементів captures поле tolerance має значення null; після операції commit кожна комірка містить історичний допуск, наданий інструментом. Поле live[].resistanceOhm має тип number|null: для порожньої або неповної чернетки значення опору, яке неможливо обчислити, серіалізується як null. POST /api/service/calibration/begin/ Розпочинає єдиний сеанс калібрування зі збереженого набору точок. Якщо запис у Flash-пам’яті відсутній або недійсний, сеанс починається з порожньої чернетки. Тіло запиту не використовується. Початкова активна комірка — x24_p1. Відповідь 200 { "sessionId": "7A19C2E4" } Повертає 400 ERROR_INVALID_VALUE, якщо інший сеанс уже активний. 503 ERROR_NOT_READY означає, що завдання вимірювання не прийняло команду. POST /api/service/calibration/range/ Вибирає коефіцієнт підсилення і точку. Коли коефіцієнт підсилення змінюється, сеанс переходить у стан switching, доки не буде опубліковано нове вікно вимірювання, яке підтверджує застосування апаратного тракту. { "sessionId": "7A19C2E4", "gain": "x24", "point": "p1" } Відповідь 200 { "state": "switching", "activeGain": "x24", "activePoint": "p1" } POST /api/service/calibration/capture/ Зчитує поточне вікно необроблених значень АЦП для всіх чотирьох каналів і запускає перевірку за десятьма новими вікнами. { "sessionId": "7A19C2E4", "gain": "x24", "point": "p1", "referenceOhm": 1000.01 } Відповідь 200 { "gain": "x24", "point": "p1", "capturedAt": "2026-07-23T11:58:00Z", "state": "verify_capture", "channels": [ { "channel": 0, "referenceOhm": 1000.01, "capturedAdc": 123456 } ] } referenceOhm має бути скінченним додатним числом. Надані коефіцієнт підсилення і точка мають відповідати активній комірці. POST /api/service/calibration/commit/ Зберігає набір точок і всі шість завершених, структурно коректних знімків. Еталонні значення опору та значення АЦП мають зростати від p1 до p3; різниця значень АЦП між кожною парою сусідніх точок має становити щонайменше 5%. Перед викликом кінцевої точки інструмент виробника перевіряє, чи перебувають вимірювання в межах допуску. { "sessionId": "7A19C2E4", "toleranceOhm": { "x24": 0.1875, "x2": 1.875 } } Відповідь 200 { "committedAt": "2026-07-23T12:00:00Z" } Значення toleranceOhm.x24 записується до трьох комірок діапазону x24, а toleranceOhm.x2 — до трьох комірок діапазону x2. Обидва значення мають бути скінченними додатними числами. Повторна операція commit для тієї самої збереженої редакції в межах сеансу є ідемпотентною. Відсутні, неповні або структурно некоректні знімки призводять до відповіді 400 ERROR_INVALID_ARGUMENT. Вихід за межі зазначеного допуску сам по собі не є помилкою прошивки. POST /api/service/calibration/finish/ Завершує сеанс, відкидає незбережену чернетку та звільняє вимірювальний тракт. { "sessionId": "7A19C2E4" } Відповідь 200 { "state": "idle", "finished": true } Обмеження сховища Один запис у внутрішньому секторі 1 Flash-пам’яті містить службове значення magic, версію формату та CRC, а вкладена структура Calibration_t — спільне значення committedAt і шість комірок калібрування. У кожній комірці зберігаються capturedAt, referenceOhm, історичне значення toleranceOhm, надане під час операції commit, а також capturedAdc і verifyAdc для кожного каналу. Похідні результати вимірювань у Flash-пам’яті не зберігаються. Поточна версія формату — 0x0600; записи інших версій не завантажуються та потребують повторного калібрування. Кінцева точка report обчислює похідні поля та серіалізує їх за запитом; окрема сутність звіту не зберігається. Під час звичайного вимірювання опір обчислюється за допомогою кусково-лінійної інтерполяції. Якщо ADC <= ADC(p2), використовуються коефіцієнти, отримані з p1+p2; для більшого значення АЦП — коефіцієнти, отримані з p2+p3. За межами крайніх точок для екстраполяції використовується найближча пара. У разі помилки сховища сеанс в оперативній пам’яті залишається активним для наступної спроби commit або явної операції finish. Збереження попередньої редакції у Flash-пам’яті в разі збою живлення чи помилки програмування під час стирання або запису не гарантується. Для справжньої атомарності за принципом «стара або нова версія» потрібен другий банк стирання або зміна структури Flash-пам’яті. Помилки сеансу Порожнє або синтаксично некоректне тіло JSON → 400 ERROR_API_PARSING. Відсутні поля або поля некоректного типу → 400 ERROR_INVALID_ARGUMENT. Недійсний чи прострочений sessionId або операція в недійсному стані → 400 ERROR_INVALID_VALUE. Вимірювальний тракт не готовий під час операції status або capture → 503 ERROR_NOT_READY. Помилка збереження під час операції commit → 500 ERROR_IO.

Novatek-Electro TR-100E Documentation

Підтвердження права власності для Overvis Запит підтверджує фізичний доступ до TR-100E під час підключення пристрою до Overvis за допомогою PIN-коду. Код відображається на пристрої не більше ніж 5 хвилин. Користувач може ввести цей код в Overvis або підтвердити підключення, вибравши Так на TR-100E. Код є частиною поточного стану: він не зберігається у Flash/EEPROM і не повертається API стану. POST /api/service/challenge/set/ Установлює, замінює або очищає запит на підтвердження. Доступ: лише WireGuard, Bearer/неявна авторизація (user). Запит із локальної мережі повертає 403 ERROR_NO_ACCESS. Установлення { "code": "001274" } Поле code є обов’язковим і має містити від 1 до 12 цифр ASCII. Код передається як рядок, щоб зберегти початкові нулі. Новий запит замінює попередній і перезапускає 300-секундний таймер. Відповідь 200: { "status": "pending", "remainingSec": 300 } Очищення { "code": null } Відповідь 200: { "status": "idle", "remainingSec": 0 } Порожнє тіло або некоректний JSON повертає 400 ERROR_API_PARSING. Відсутнє поле, некоректний тип, порожній рядок, надто довгий код або код із символами, відмінними від цифр, повертає 400 ERROR_INVALID_ARGUMENT. Помилка перевірки не змінює поточний запит на підтвердження. GET /api/service/challenge/status/ Отримує узгоджений знімок стану запиту на підтвердження. Доступ: лише WireGuard, Bearer/неявна авторизація (user). Запит із локальної мережі повертає 403 ERROR_NO_ACCESS. Відповідь 200: { "status": "accepted", "remainingSec": 247 } status Значення idle Запит на підтвердження відсутній або очищений pending Код відображається, але фізичної відповіді ще не отримано accepted Користувач вибрав Так на TR-100E rejected Користувач вибрав Ні на TR-100E Значення remainingSec зменшується від 300 до 1 у станах pending, accepted і rejected; у стані idle воно дорівнює 0. Відповідь користувача не перезапускає і не зупиняє таймер. Після закінчення початкових 300 секунд пристрій автоматично переводить запит на підтвердження у стан idle. Після вибору Так TR-100E відображає екран очікування, доки Overvis не прочитає стан accepted і не надішле code: null. Очищення запиту на підтвердження завершує послідовність дій інтерфейсу користувача та повертає головний екран. Якщо користувач підтверджує право власності, вводячи код в Overvis, хмарний сервіс порівнює його з початковим значенням і після успішної перевірки надсилає code: null, щоб прибрати запит з дисплея.

Novatek-Electro TR-100E Documentation

POST /api/service/firmware/apply/ Застосовує раніше завантажений та перевірений образ OTA. Авторизація: Bearer (powerUser). Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має бути true Порожнє або синтаксично некоректне тіло JSON → 400 ERROR_API_PARSING. Відсутнє поле confirm, значення нелогічного типу або false → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {} Перед викликом цієї кінцевої точки образ OTA потрібно завантажити й підтвердити за допомогою POST /api/service/firmware/upload/finish/. Пристрій почне застосовувати оновлення після перезавантаження.

Novatek-Electro TR-100E Documentation

Сеанс завантаження прошивки Завантаження файлу .ota реалізовано як послідовний сеанс завантаження до розділу OTA. GET /api/service/firmware/upload/status/ Отримує поточний стан сеансу завантаження та дійсність образу OTA. Авторизація: Bearer (powerUser). Відповідь 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" } } Поле Тип Опис uploadInProgress логічний Триває стирання, отримання або перевірка imageValid логічний Образ OTA повністю завантажено та перевірено receivedBytes число Кількість підтверджених байтів totalBytes число Очікуваний розмір образу percent число Перебіг у відсотках lastError число Код помилки (0 = немає) lastInstallState рядок Останній стан установлення: "idle", "ready", "running", "failed", "unknown" meta об’єкт Метадані перевіреного образу; наявні лише за умови imageValid: true meta.fwVersion рядок Версія прошивки з образу OTA, до 15 символів ASCII (наприклад, 1.0 або 1.2.3-rc4) meta.buildTimestamp число Часова позначка складання у форматі Unix meta.deviceStr рядок Мітка цільового апаратного забезпечення; для цього пристрою — TR-100E (48) meta.description рядок Опис образу POST /api/service/firmware/upload/begin/ Відкриває сеанс завантаження, задає розмір образу та готує розділ OTA. Авторизація: Bearer (powerUser). Запит { "size": 524288 } Поле Тип Обов’язкове Опис size число так Ціле число: розмір образу OTA в байтах (> 0 і ≤ розміру розділу OTA) Повторний виклик цієї кінцевої точки скидає незавершений сеанс. Якщо триває erase/verify → 503 ERROR_NOT_READY. Відповідь 200 { "acceptedOffset": 0 } POST /api/service/firmware/upload/chunk/?offset=0 Записує фрагмент образу OTA. Авторизація: Bearer (powerUser). Запит Content-Type: application/octet-stream Параметр запиту offset: зміщення фрагмента в повному образі. Тіло: необроблені байти фрагмента (щонайбільше 1024 байти). Параметр Тип Обов’язковий Опис offset число так Ціле число: невід’ємне зміщення в повному образі OTA offset має відповідати очікуваному зміщенню або вказувати на вже підтверджений фрагмент (ідемпотентна повторна спроба). Пропуск → 400 ERROR_INVALID_VALUE. Фрагмент > 1024 байтів → 400 ERROR_INVALID_VALUE. Відповідь 200 { "acceptedOffset": 1024 } POST /api/service/firmware/upload/finish/ Завершує сеанс завантаження та розпочинає перевірку. Авторизація: Bearer (powerUser). Запит { "confirm": true } Неповний образ або помилка перевірки → 400 ERROR_INVALID_VALUE. Відповідь 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/ Видаляє підготовлений образ OTA та скидає сеанс завантаження. Авторизація: Bearer (powerUser). Запит { "confirm": true } Порожнє або синтаксично некоректне тіло JSON → 400 ERROR_API_PARSING. Відсутнє поле confirm, значення нелогічного типу або false → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 Повертає повний стан у тому самому форматі, що й GET /api/service/firmware/upload/status/.

Novatek-Electro TR-100E Documentation

GET /api/service/identity/get/ Повертає службову інформацію пристрою. Авторизація: Bearer (powerUser). Запит Тіло запиту не використовується. Параметри запиту Параметр Значення Опис includePassword 1 Якщо вказано, до відповіді додається поле devicePassword. Інакше пароль не повертається. Приклад: GET /api/service/identity/get/?includePassword=1 Відповідь 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" } Поля відповіді Поле Тип Опис available логічний Службові дані пристрою доступні donglePresent логічний Апаратний сервісний ключ наявний hasDevicePrivateKey логічний Закритий ключ пристрою задано hasDevicePassword логічний Пароль пристрою задано; значення пароля не розкривається uuid рядок | null Повний унікальний ідентифікатор мікроконтролера у форматі XXXXXXXX-XXXXXXXX-XXXXXXXX devicePublicKey рядок | null Відкритий ключ пристрою у форматі WireGuard base64 macAddress рядок Фактична MAC-адреса у форматі XX:XX:XX:XX:XX:XX, зокрема резервне значення isUnique логічний true, якщо MAC-адресу прочитано з мікросхеми EUI-48; false, якщо використовується резервне значення, отримане з UUID мікроконтролера urlAutoConfig рядок | null URL автоматичної конфігурації manufacturer рядок | null Рядок виробника pinCode рядок | null PIN-код devicePassword рядок | null Пароль пристрою. Наявний лише в разі запиту з ?includePassword=1 Якщо службові дані пристрою ще не готові, API повертає 503 ERROR_NOT_READY.

Novatek-Electro TR-100E Documentation

POST /api/service/identity/set/ Оновлює ідентифікаційні поля, крім закритого ключа пристрою, та зберігає їх в EEPROM. Авторизація: Bearer (powerUser). Запит Тіло запиту має бути об’єктом JSON без додаткової обгортки identity. { "urlAutoConfig": "https://example.invalid", "manufacturer": "Novatek", "pinCode": "123456" } Поля запиту Поле Тип Обов’язкове Опис urlAutoConfig рядок ні URL автоматичної конфігурації manufacturer рядок ні Рядок виробника pinCode рядок ні PIN-код Обмеження довжини: urlAutoConfig: до 63 символів. manufacturer: до 23 символів. pinCode: до 11 символів. Порожнє тіло → 400 ERROR_API_PARSING. Тіло, що не є об’єктом → 400 ERROR_INVALID_ARGUMENT. Якщо не надано жодного підтримуваного поля → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {} Якщо закритий ключ або пароль пристрою ще не ініціалізовано, API повертає 503 ERROR_NOT_READY. Початкове заповнення порожнього ідентифікаційного поля дозволено без апаратного сервісного ключа. Для зміни або очищення вже заповненого поля потрібен ключ; за його відсутності повертається помилка доступу. Надання наявного значення не вважається перезаписуванням.

Novatek-Electro TR-100E Documentation
POST /api/service/reboot/ Запускає відкладене перезавантаження. Авторизація: Bearer (powerUser). Запит { "rebootSec": 3 } Поля запиту Поле Тип Обов’язкове Опис rebootSec число так Ціле число: затримка перед перезавантаженням (3..30 секунд) Відповідь 200 {}

Novatek-Electro TR-100E Documentation

POST /api/service/settings/reset/ Скидає налаштування до заводських значень за замовчуванням. Авторизація: Bearer (powerUser). Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має бути true Порожнє або синтаксично некоректне тіло JSON → 400 ERROR_API_PARSING. Відсутнє поле confirm, значення нелогічного типу або false → 400 ERROR_INVALID_ARGUMENT. Відповідь 200 {} Після успішного скидання вебінтерфейс має повторно отримати налаштування за допомогою GET /api/settings/get/?....

Novatek-Electro TR-100E Documentation

POST /api/service/time/set/ Установлює системний час (RTC) вручну. Авторизація: Bearer (powerUser). Запит { "dateTimeUtc": "2026-04-29T00:00:00Z" } Поля запиту Поле Тип Обов’язкове Опис dateTimeUtc рядок так Дата й час у форматі ISO 8601 UTC, наприклад 2026-04-29T00:00:00Z Перевірка dateTimeUtc має бути рядком ISO 8601 зі зміщенням UTC Z або +00:00; допускаються частки секунди. Синтаксичний аналізатор перевіряє діапазони компонентів, але календарні переповнення, як-от 31 квітня, нормалізуються системною функцією часу. Порожнє тіло → 400 ERROR_API_PARSING. Помилка запису RTC → 500 ERROR_IO. Відповідь 200 {} Клієнт надсилає час у форматі UTC. Часовий пояс і DST застосовуються лише для відображення.

Novatek-Electro TR-100E Documentation

POST /api/service/time/sync/ Запускає примусову синхронізацію часу через SNTP. Авторизація: Bearer. Запит { "confirm": true } Поля запиту Поле Тип Обов’язкове Опис confirm логічний так Має бути true Порожнє тіло → 400 ERROR_API_PARSING. Відповідь 200 {} Фактична синхронізація SNTP виконується асинхронно. Якщо NTP вимкнено, lwIP/SNTP ще не готовий або запит на синхронізацію відхилено, кінцева точка повертає 503 ERROR_NOT_READY.

Novatek-Electro TR-100E Documentation

GET /api/debug/adc/, POST /api/debug/adc/start/, POST /api/debug/adc/stop/ Необроблені дані АЦП і проміжні результати вимірювань для кожного каналу. Призначено для калібрування та діагностики. Авторизація: токен Bearer (powerUser). Для start і stop додатково має бути активним діагностичний режим. Сервісний ключ не потрібен. Відповідь 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" } ] } Поля відповіді Поле Тип Опис diagnostic.active логічний Чи активна тимчасова конфігурація каналів diagnostic.ready логічний Чи отримано свіжі дані зі стабільними станами для всіх каналів diagnostic.sensorTypeId число Тимчасово вибраний тип датчика з GET /api/reference/sensor-types/; наявне, коли active=true diagnostic.gain рядок Розрахований коефіцієнт підсилення; наявне, коли active=true mcuTemperature число|null Температура внутрішнього датчика мікроконтролера (°C) або null, якщо значення некоректне channels масив 4 елементи (CH1..CH4) channels[].filteredAdc число Відфільтроване необроблене значення АЦП channels[].resistance число Розрахований опір (Ом) channels[].temperature число|null Розрахована температура (°C) або null, якщо значення некоректне channels[].gain рядок Коефіцієнт підсилення: "x2" або "x24" channels[].circuitState рядок Стан кола Значення circuitState "NORMAL" "OPEN_CIRCUIT" "SHORT_CIRCUIT" "UNDER_RANGE" "OVER_RANGE" "DISABLED" "UNKNOWN" POST /api/debug/adc/start/ Тимчасово вмикає всі чотири канали із зазначеним типом датчика. Прошивка вибирає коефіцієнт підсилення. Налаштування та флешпам’ять не змінюються. Значення sensorTypeId потрібно взяти з поля items[].id у відповіді GET /api/reference/sensor-types/. { "sensorTypeId": 0 } Повторний виклик цієї кінцевої точки перезапускає накопичення та фільтрування. Відповідь містить об’єкт diagnostic; значення ready=false зберігається, доки не стануть доступними свіжі стабільні дані. POST /api/debug/adc/stop/ Завершує тестування та відновлює конфігурацію каналів із Налаштувань. Тіло запиту ігнорується. Режим також завершується через 30 секунд без запиту GET /api/debug/adc/ або після виходу з діагностичного режиму.

Novatek-Electro TR-100E Documentation

POST /api/debug/display/start/ and POST /api/debug/display/stop/ Тест дисплея, що тимчасово перевизначає звичайне зображення, контрастність і підсвічування. Авторизація: токен Bearer (powerUser). POST /api/debug/display/start/ Вмикає перевизначення параметрів дисплея. Запит { "mode": "checkerboard", "contrast": 34, "backlightPercent": 80 } Поле Тип Обов’язкове Опис mode рядок так Режим дисплея: normal, black, white, grid або checkerboard contrast ціле число так Контрастність дисплея від 0 до 64 backlightPercent ціле число так Яскравість підсвічування у відсотках від 0 до 100 Режими Режим Зображення normal Звичайний вміст екрана з тимчасовими налаштуваннями контрастності та підсвічування black Усі пікселі ввімкнено white Усі пікселі вимкнено grid Сітка з кроком 8 пікселів checkerboard Шахівниця з квадратами розміром 8 x 8 пікселів Повторний виклик start замінює поточний режим і перезапускає захисний тайм-аут. Відповідь 200 {} POST /api/debug/display/stop/ Вимикає перевизначення та відновлює звичайне зображення й керування контрастністю та підсвічуванням. Тіло запиту не потрібне. Відповідь 200 {} Перевизначення автоматично вимикається через 305 секунд, навіть якщо клієнт не викликає stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/external-storage/dump/ Потоково передає доступний лише для читання дамп кожного байта встановленого зовнішнього сховища. Прошивка зчитує фрагменти обмеженого розміру й не виділяє в оперативній пам’яті місце для повного дампа. Авторизація: токен Bearer (powerUser). Режим: має бути активним діагностичний режим. Content-Type: application/octet-stream. Content-Disposition: attachment; filename=tr100e_external_storage.bin. Для завершення потоку використовується закриття з’єднання. Для успішної діагностики потрібно отримати рівно стільки байтів, скільки зазначено в sizeBytes, що повертає GET /api/debug/external-storage/. У разі помилки читання сховища потік закривається достроково, тому дамп має менший розмір. Ця кінцева точка ніколи не записує дані до зовнішнього сховища та не стирає їх.

Novatek-Electro TR-100E Documentation

GET /api/debug/external-storage/ Відомості про зовнішнє сховище: встановлена мікросхема, місткість і повна карта областей. Авторизація: токен Bearer (powerUser). Відповідь 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 } } } Поля відповіді Поле Тип Опис jedecId рядок Шестисимвольний шістнадцятковий рядок (виробник + тип + місткість) chipType рядок Зрозуміла для користувача назва мікросхеми sizeBytes число Загальна місткість зовнішнього сховища (байти) sectorSize число Розмір сектора (байти) regions.logger.startAddress рядок Початкова адреса (шістнадцяткова) regions.logger.sizeBytes число Розмір області (байти) regions.logger.usedEntries число Кількість використаних записів regions.logger.maxEntries число Максимальна кількість записів regions.recorder.startAddress рядок Початкова адреса (шістнадцяткова) regions.recorder.sizeBytes число Розмір області (байти) regions.recorder.usedEntries число Кількість використаних записів regions.recorder.maxEntries число Максимальна кількість записів regions.ota.startAddress рядок Початкова адреса (шістнадцяткова) regions.ota.sizeBytes число Розмір слота OTA (байти) regions.ota.imagePresent логічний Чи наявний образ із коректним заголовком regions.ota.imageSize число Розмір корисного навантаження із заголовка (0, якщо образ відсутній) regions.reserved.startAddress рядок Початкова адреса зарезервованої області (шістнадцяткова) regions.reserved.sizeBytes число Розмір зарезервованої області (байти)

Novatek-Electro TR-100E Documentation

GET /api/debug/heap/ Стан динамічної пам’яті FreeRTOS і lwIP. Авторизація: токен Bearer (powerUser). Відповідь 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 } } Поля відповіді Поле Тип Опис rtos.totalBytes число Загальний розмір динамічної пам’яті FreeRTOS (configTOTAL_HEAP_SIZE) rtos.freeBytes число Поточний обсяг вільного простору (сума всіх вільних блоків) rtos.minEverFreeBytes число Мінімальний обсяг вільного простору за весь час роботи (мінімальна позначка) rtos.largestFreeBlockBytes число Розмір найбільшого вільного блока (показник фрагментації) rtos.smallestFreeBlockBytes число Розмір найменшого вільного блока rtos.freeBlockCount число Кількість вільних блоків rtos.allocCount число Кількість успішних викликів pvPortMalloc після запуску rtos.freeCount число Кількість успішних викликів vPortFree після запуску lwip.totalBytes число Загальний розмір динамічної пам’яті lwIP lwip.freeBytes число Поточний обсяг вільного простору в динамічній пам’яті lwIP lwip.minEverFreeBytes число Мінімальний обсяг вільного простору в динамічній пам’яті lwIP за весь час роботи Коли freeBytes > 0, показник фрагментації динамічної пам’яті FreeRTOS дорівнює 1 - largestFreeBlockBytes / freeBytes. Якщо largestFreeBlockBytes значно менше за freeBytes, виділення великого блока може завершитися невдало попри достатній загальний обсяг вільної пам’яті. Коли freeBytes == 0, вебінтерфейс показує 0% без обчислення за цією формулою.

Novatek-Electro TR-100E Documentation

GET /api/debug/keyget/ Поточний стан фізичних кнопок лицьової панелі. Авторизація: токен Bearer (powerUser). Стани зчитуються безпосередньо з апаратних входів. Віртуальні події, надіслані через POST /api/debug/keypress/, не впливають на відповідь. Відповідь 200 { "up": false, "down": false, "menu": true, "set": false, "test": false } Поля відповіді Поле Тип Опис up логічний Натиснуто кнопку «Вгору» down логічний Натиснуто кнопку «Вниз» menu логічний Натиснуто кнопку «Меню» set логічний Натиснуто кнопку «Ввід» test логічний Натиснуто кнопку «Тест»

Novatek-Electro TR-100E Documentation

POST /api/debug/keypress/ Імітує подію віртуальної кнопки для автоматизованого тестування інтерфейсу та меню. Авторизація: токен Bearer (powerUser). Діагностичний режим має бути активним. Інакше кінцева точка повертає 403 ERROR_NO_ACCESS. Запит { "event": "press", "keys": ["menu"], "duration": 0 } Поля запиту Поле Тип Обов’язкове Опис event рядок так "press", "release", "hold", "combo" keys масив рядків так Кнопки: "up", "down", "menu", "set", "test" duration число ні Ціла тривалість у мс (для hold); відсутнє або неціле значення вважається рівним 0 Відповідь 200 {}

Novatek-Electro TR-100E Documentation

POST /api/debug/led/start/ and POST /api/debug/led/stop/ Сервісний тест світлодіодних індикаторів. Авторизація: токен Bearer (powerUser). Діагностичний режим має бути активним. Інакше кінцеві точки повертають 403 ERROR_NO_ACCESS. POST /api/debug/led/start/ Примусово переводить світлодіодні індикатори в тестові стани. Запит { "state": { "ledTrip": true, "ledAlarm": true, "ledFan": true, "ledFault": true, "ledCh1": true, "ledCh2": true, "ledCh3": true, "ledCh4": true } } Поле Тип Обов’язкове Опис state об’єкт так Стани світлодіодних індикаторів state.ledTrip логічний так Індикатор «Перегрів» state.ledAlarm логічний так Індикатор «Тривога» state.ledFan логічний так Індикатор «Вентиляція» state.ledFault логічний так Індикатор «Відмова» state.ledCh1 логічний так Індикатор каналу 1 state.ledCh2 логічний так Індикатор каналу 2 state.ledCh3 логічний так Індикатор каналу 3 state.ledCh4 логічний так Індикатор каналу 4 Відповідь 200 {} POST /api/debug/led/stop/ Завершує тест і відновлює звичайний режим індикації. Запит Тіло запиту не потрібне. Відповідь 200 {} Основна логіка автоматично відновлює звичайний режим після завершення тайм-ауту, навіть якщо клієнт не викликає stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/lwip-stats/ Знімок внутрішніх лічильників стека lwIP: статистика за протоколами та стан пулів memp. Джерелом даних є глобальна структура lwip_stats (lwip/stats.h). Доступні поля визначаються прапорцями *_STATS у файлі lwipopts.h. Якщо прапорець вимкнено, відповідний ключ не включається у відповідь. Авторизація: токен Bearer (powerUser). Відповідь 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> (структура stats_proto) Кожна група відповідає одному протоколу. Назва включається, лише якщо для відповідного параметра *_STATS у файлі lwipopts.h встановлено значення 1. Поле Тип Опис recv число Кількість отриманих пакетів xmit число Кількість переданих пакетів drop число Кількість відкинутих пакетів chkerr число Помилки контрольної суми lenerr число Помилки довжини memerr число Невдалі операції виділення пам’яті rterr число Помилки маршрутизації proterr число Помилки протоколу opterr число Помилки параметрів err число Інші помилки cachehit число Лише для etharp: кількість влучань у кеш ARP Можливі ключі proto: link, etharp, ip, icmp, udp і tcp. (Вони відповідають прапорцям LINK_STATS, ETHARP_STATS, IP_STATS, ICMP_STATS, UDP_STATS і TCP_STATS.) memp[] (структура stats_mem) Масив, що містить по одному елементу для кожного пулу memp. Поле name містить короткий ідентифікатор пулу з переліку memp_t без префікса MEMP_. Поле Тип Опис name рядок Назва пулу (наприклад, TCP_PCB або PBUF_POOL) avail число Місткість пулу (кількість елементів) used число Поточна кількість використовуваних елементів max число Максимальне значення used за час роботи err число Кількість невдалих виділень пам’яті з пулу Цей блок наявний, лише коли MEMP_STATS = 1.

Novatek-Electro TR-100E Documentation

GET /api/debug/menu/ Поточний стан меню інтерфейсу для автоматизованих тестів навігації. Авторизація: токен Bearer (powerUser). Відповідь 200 { "isActive": 1, "depth": 0, "selectedIndex": 2, "itemCount": 5, "groupId": 1, "mode": 0 } Поля відповіді Поле Тип Опис isActive число Ознака активності меню: 1 — активне, 0 — неактивне depth число Поточна глибина вкладеності selectedIndex число Індекс вибраного пункту itemCount число Кількість пунктів у поточній групі groupId число Ідентифікатор поточної групи меню mode число Режим: 0 = NAV, 1 = EDIT

Novatek-Electro TR-100E Documentation

GET /api/debug/network/ Низькорівнева діагностика мережевого стека: фізичний рівень PHY і MAC-адреса. Стан HTTP-сервера (з’єднання, сеанси та порт) наведено в групі httpd у файлі state-get.md. Авторизація: Bearer (powerUser). Відповідь 200 { "phy": { "linkUp": true, "speed": 100, "fullDuplex": true, "autoNegComplete": true, "mac": "AA:BB:CC:DD:EE:FF", "macSource": "EUI48" } } Поля відповіді Поле Тип Опис phy.linkUp логічний Чи встановлено з’єднання Ethernet phy.speed число Швидкість з’єднання (Мбіт/с): 10 або 100 phy.fullDuplex логічний Чи активний повнодуплексний режим phy.autoNegComplete логічний Чи завершено автоматичне узгодження phy.mac рядок MAC-адреса інтерфейсу (AA:BB:CC:DD:EE:FF) phy.macSource рядок "EUI48" (із флешпам’яті) або "FALLBACK" (із прошивки)

Novatek-Electro TR-100E Documentation

POST /api/debug/relay/start/ and POST /api/debug/relay/stop/ Службова перевірка реле. Авторизація: Bearer (powerUser). Діагностичний режим має бути активним. Інакше кінцеві точки повертають 403 ERROR_NO_ACCESS. POST /api/debug/relay/start/ Примусово переводить реле в тестові стани. Запит { "state": { "trip": true, "alarm": false, "fan": false, "fault": false } } Поле Тип Обов’язкове Опис state об’єкт так Стани реле state.trip логічний так Реле «Перегрів» state.alarm логічний так Реле «Тривога» state.fan логічний так Реле «Вентиляція» state.fault логічний так Реле «Відмова» Відповідь 200 {} POST /api/debug/relay/stop/ Завершує перевірку та повертає керування штатній логіці. Запит Тіло запиту не потрібне. Відповідь 200 {} Основна логіка автоматично відновлює штатне керування після завершення часу очікування, навіть якщо клієнт не викликає stop.

Novatek-Electro TR-100E Documentation

GET /api/debug/settings/ Отримує стан обох банків постійних налаштувань незалежно від джерела поточних налаштувань під час роботи. Авторизація: Bearer (powerUser). Діагностичний режим не потрібен. У діагностичному режимі неявний доступ powerUser дає змогу перевіряти банки без токена Bearer. Відповідь 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" } ] } Поля відповіді Поле Тип Опис runtimeSource рядок Джерело поточних налаштувань під час роботи: builtIn, bank1 або bank2 bootBank число | null Банк, вибраний під час звичайного завантаження: 1, 2 або null, якщо обидва банки недійсні banks масив Стан двох фізичних банків налаштувань banks[].bank число Номер банку: 1 або 2 banks[].valid логічний Результат повної перевірки заголовка, версії прошивки, довжини та CRC даних banks[].sequence число Порядковий номер запису; наявний лише для дійсного банку banks[].isDefault логічний Чи відповідають корисні дані чинним заводським налаштуванням; наявне лише для дійсного банку banks[].savedAt рядок | null Час збереження у форматі ISO 8601 UTC; наявний лише для дійсного банку banks[].dataLength число Довжина корисних даних; наявна лише для дійсного банку banks[].dataCrc32 рядок CRC32 корисних даних у вигляді восьми шістнадцяткових символів; наявне лише для дійсного банку banks[].headerCrc32 рядок CRC32 заголовка у вигляді восьми шістнадцяткових символів; наявне лише для дійсного банку Значення runtimeSource і bootBank можуть відрізнятися. Наприклад, у діагностичному режимі під час роботи використовуються налаштування builtIn, тоді як під час звичайного завантаження вибирається останній дійсний банк флешпам’яті. Якщо обидва банки дійсні, bootBank визначає банк із новішим значенням sequence з урахуванням переповнення uint32_t. Якщо значення sequence однакові, вибирається банк 1. Поля заголовка для недійсного банку не повертаються, оскільки їхні значення не вважаються достовірними. Перевірка заводських налаштувань Збережені налаштування вважаються заводськими, якщо bootBank не дорівнює null, а вказаний банк має valid: true та isDefault: true. Інший, старіший банк може містити користувацькі налаштування й не впливає на результат.

Novatek-Electro TR-100E Documentation

GET /api/debug/system/ Загальна системна діагностика: тактування RTC, причина скидання та стан підсистем. Авторизація: Bearer (powerUser). Відповідь 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 } } Поля відповіді Поле Тип Опис core рядок Архітектура ядра: "ARM32" uptimeSec число Час роботи від моменту ввімкнення живлення (секунди) cpuFreqMHz число Частота ядра (SystemCoreClock / 1000000) resetReason рядок Причина останнього скидання rtcSource рядок Джерело тактування RTC: "LSE", "LSI" або "UNKNOWN" rtcTime рядок Поточний час RTC у форматі UTC (UTC+0) rtcSync рядок Джерело, з якого востаннє встановлено час RTC: "NONE", "BACKUP", "NTP" або "MANUAL" readyFlags об’єкт Логічні прапорці ініціалізації підсистем Значення resetReason Значення Прапорець RCC_CSR Опис "Power on" RCC_CSR_PORRSTF Скидання під час увімкнення живлення "Reset pin" RCC_CSR_PADRSTF Зовнішнє скидання (кнопка RESET) "Watchdog" RCC_CSR_WDGRSTF Скидання сторожовим таймером "Software" RCC_CSR_SFTRSTF Програмне скидання (NVIC_SystemReset()) "Low power" RCC_CSR_LPWRRSTF Скидання в режимі низького енергоспоживання "Unknown" — Невідома причина Значення rtcSource "LSE" — зовнішній кварцовий резонатор 32.768 кГц (висока точність). "LSI" — внутрішній RC-генератор (відхилення ±5%). "UNKNOWN" — джерело не визначено. Значення rtcSync "NONE" — RTC запущено зі стандартним часом; синхронізація або відновлення не виконувалися. "BACKUP" — час відновлено з резервного домену під час запуску. "NTP" — час установлено внаслідок синхронізації SNTP/NTP. "MANUAL" — час установлено вручну через інтерфейс користувача, API або Modbus. Поля 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/ Діагностичний знімок поточних завдань RTOS та мінімальних залишків їхніх стеків. Авторизація: токен Bearer із рівнем доступу powerUser або неявний доступ powerUser у діагностичному режимі. Відповідь 200 { "tasks": [ { "number": 1, "name": "Gate", "priority": 5, "stackMinFreeByte": 780, "stackSizeByte": 1024 }, { "number": 2, "name": "Logic", "priority": 4, "stackMinFreeByte": 1248, "stackSizeByte": 1600 } ] } Поля відповіді Поле Тип Опис tasks масив Список завдань tasks[].number число RTOS xTaskNumber tasks[].name рядок Назва завдання tasks[].priority число Пріоритет RTOS tasks[].stackMinFreeByte число Мінімальний обсяг вільного простору стека за весь час роботи, у байтах tasks[].stackSizeByte число Загальний розмір стека, у байтах Якщо не вдалося виділити пам’ять → 507 ERROR_NO_MEMORY.