ODTEMP-1: инструкция, ПО и интеграции

ODTEMP Web

Веб-приложение подходит для первого запуска и периодического контроля. Оно подключается к датчику через Web Serial.

Откройте odtemp.unitx.pro, выберите устройство и проверьте показания. Отдельный установщик для этого не нужен.

Для постоянного мониторинга используйте локальную программу: браузер может замедлять фоновые вкладки, выгружать страницу и менять точность таймеров.

odtemp-logger

odtemp-logger — программа для постоянного мониторинга датчиков семейства ODTEMP-1 в Windows, Linux и macOS. Она получает показания через USB HID, поэтому CDC-драйвер виртуального COM-порта не нужен. В оконном режиме удобно следить за показаниями на рабочем месте, а в консольном — запускать программу на сервере или одноплатном компьютере без монитора.

Сборку для своей ОС можно скачать в разделе odtemp-logger, а исходный код посмотреть на GitHub.

Что делает программа

• показывает текущую температуру, а при подключении ODTEMP-1D — температуру и влажность;
• ведёт текстовый журнал: сохраняет дату и время, показания и сообщения о подключении датчика;
• может работать в оконном и консольном режимах;
• сама находит датчик после запуска и восстанавливает соединение после временного обрыва USB-связи;
• позволяет независимо настроить интервалы записи в локальный журнал и передачи данных в UnitX Cloud;
• продолжает опрашивать датчик, если облако временно недоступно.

В оконном режиме текущее значение показано крупным шрифтом и обновляется по мере поступления данных от датчика. Для ODTEMP-1D под температурой отображается влажность. При отключении устройства программа показывает состояние связи и продолжает искать датчик без ручного перезапуска.

Запуск и локальный журнал

Запуск без параметров открывает графическое окно:

./odtemp-logger

На сервере программу можно запустить без окна:

./odtemp-logger -cli

По умолчанию программа раз в 60 секунд записывает данные в файл вида odtemp_11.08.2026_01.31.54.log в текущем каталоге. Журнал — обычный текстовый файл: в него записываются время запуска, сведения о подключении устройства, показания и сообщения об ошибках. Например:

2026/08/11 01:31:55 Устройство успешно открыто
2026/08/11 01:32:00 Температура: 27.68°C
2026/08/11 01:32:05 Температура: 27.68°C

Каталог и период записи можно изменить:

./odtemp-logger -cli -path /var/log/odtemp -period 30

При запуске из Windows PowerShell укажите имя файла с расширением:

.\odtemp-logger.exe -cli -path C:\ODTEMP\logs -period 30

В поле «Объект» ярлыка Windows параметры указывают после пути к программе. Такой ярлык каждый раз запускает логгер с одинаковыми настройками.

Чем короче интервал, тем чаще программа записывает доступные показания. Однако это не повышает точность и не ускоряет обновление чувствительного элемента. Для обычного мониторинга начните с интервала 30–60 секунд.

Передача показаний в UnitX Cloud

odtemp-logger использует постоянно работающий ПК или сервер как шлюз между USB и UnitX Cloud:

ODTEMP → USB HID → odtemp-logger → HTTPS → UnitX Cloud

Сам датчик не подключается к сети. Чтобы показания продолжали поступать в облако, компьютер должен быть включён, а программа — запущена. Температура передаётся для всех моделей семейства, влажность — только для ODTEMP-1D.

1. Создайте пару токенов UnitX Cloud и сохраните оба значения. Программа отправляет данные по write-токену, а read-токен позволяет открыть в браузере панель и историю.
2. Придумайте device_id — имя карточки датчика, например odtemp-office или server-room.
3. Передайте write-токен через переменную окружения и задайте интервал отправки.
4. Откройте cloud.unitx.pro и войдите с read-токеном.

В Linux и macOS:

ODTEMP_CLOUD_TOKEN='utx1_...' ./odtemp-logger \
  -cloud-period 60 \
  -cloud-device odtemp-office

В PowerShell:

$env:ODTEMP_CLOUD_TOKEN = 'utx1_...'
.\odtemp-logger.exe -cloud-period 60 -cloud-device odtemp-office

Обе команды запускают программу с графическим окном. Для сервера без монитора добавьте -cli. Локальный журнал и передача в облако работают одновременно: например, с параметрами -period 30 -cloud-period 60 программа записывает данные в файл каждые 30 секунд и отправляет их в облако раз в минуту.

Если одновременно указаны флаг и переменная окружения, используется флаг. Write-токен лучше передавать через переменную окружения. Если указать его в -cloud-token, значение может быть видно другим пользователям системы в списке процессов.

device_id может содержать не более 64 латинских букв, цифр и символов _ и -. После первой успешной отправки в панели появляется карточка с текущей температурой, состоянием «Онлайн» и временем обновления. Для ODTEMP-1D в той же карточке отображается влажность. Кнопка с графиком открывает историю последних сохранённых точек, откуда данные можно экспортировать.

Логгер отправляет температуру в поле v1, а влажность ODTEMP-1D — в поле v2. Ошибка HTTPS-запроса записывается в локальный журнал, но не останавливает чтение датчика. Программа не накапливает очередь для повторной отправки: пропущенная из-за недоступности сети точка не досылается, а следующая попытка выполняется через заданный интервал. Для обычной пары токенов UnitX Cloud хранит до 100 последних точек каждого устройства.

Подробно о токенах, панели и истории UnitX Cloud

Драйверы

В Windows 8/10/11, Linux и macOS установка CDC-драйвера обычно не нужна. На Windows 7 перед работой через виртуальный COM-порт понадобится отдельный драйвер.

odtemp-logger использует HID и может работать без CDC-драйвера. CDC нужен, если вы хотите читать датчик через COM-порт, терминал, скрипт или собственную программу.

Установка CDC-драйвера