UnitX-L: настольная программа

Настольная программа нужна для действий, которые нельзя выполнить через обычное сообщение BTHome: изменить расписание UnitX-L, включить журнал, синхронизировать часы, прочитать накопленную историю и настроить дополнительные режимы.

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

Подключение к устройству

1. Включите Bluetooth на компьютере и запустите программу UnitX-L.
2. Если устройство спит, поднесите магнит к зоне геркона на корпусе. При включённом быстром режиме это открывает окно связи.
3. Нажмите Сканировать.
4. Выберите устройство с коротким именем вида UTXxxxxx и нажмите Подключить.

Полное имя в службе устройства имеет вид UnitX-L-XXXXXXXX. Короткий идентификатор помогает различать несколько логгеров рядом и остаётся удобным на macOS, где программа не получает настоящий BLE MAC-адрес.

Если UnitX-L передаёт BTHome, но подключиться не удаётся, повторите поиск во время следующего цикла. После подключения откройте Dashboard → Конфигурация и включите Быстрый режим геркона, чтобы в дальнейшем открывать окно магнитом.

Что проверить при первом подключении

В разделе Dashboard последовательно проверьте:

• Информация — модель, идентификатор, версия прошивки и доступные функции;
• Статус — заряд батареи, состояние памяти и режим записи;
• Датчики — текущие показания установленных датчиков;
• Время — часы устройства;
• Конфигурация — расписание передачи и записи;
• Система — служебные команды перезагрузки, обновления и выключения.

Сначала откройте Время и нажмите Синхронизировать. Это особенно важно перед включением журнала: программа строит графики и экспортирует строки CSV по временным меткам устройства.

Настройка таймеров и журнала

На странице Dashboard → Конфигурация находятся параметры самого UnitX-L. Не путайте их с общими настройками программы. В названиях полей beacon означает цикл передачи, flash — внутреннюю флеш-память, а Burst — серию частых измерений.

Основные параметры

Параметры длительности и частоты передачи Bluetooth определяют, сколько времени устройство остаётся видимым после пробуждения. Их имеет смысл менять только при настройке расхода батареи или если приёмник не успевает обнаружить UnitX-L.

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

Выгрузка журнала

Откройте История → История устройства и нажмите Обновить, чтобы увидеть число занятых и доступных записей. Затем:

1. Выберите порядок — сначала старые или сначала новые записи.
2. Нажмите Выгрузить. Ограничение и период используются для просмотра и экспорта уже полученных данных.
3. При необходимости нажмите Сохранить в базу, чтобы данные остались на компьютере после отключения логгера.
4. Для передачи данных в другую систему используйте Экспорт CSV.

Во время выгрузки программа проверяет порядковые номера страниц. Если передача или подтверждение прервались из-за временной занятости Bluetooth, она повторно запрашивает ту же страницу и не переходит к следующей раньше времени.

Кнопка Очистить удаляет историю из устройства без возможности восстановления. Сначала сохраните выгрузку на компьютере.

Графики и данные акселерометра

Вкладка Графики строит отдельные ряды температуры, влажности и ускорения из журнала. График напряжения батареи строится по снимкам состояния, которые программа сохранила в локальной базе. Источником данных может быть только что выгруженный журнал или ранее сохранённая база.

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

Профили и защита настроек

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

Защиту паролем включают в конфигурации устройства. При первой установке пароля поднесите магнит к геркону и удерживайте его до сообщения об успешном завершении. Без физического подтверждения устройство отклонит команду. После этого изменение или отключение пароля требует авторизации с текущим паролем.

Изменение настроек, очистка истории и другие защищённые операции выполняются только в авторизованном соединении. Пароль хранится в JSON-файле профиля на компьютере; при его утрате программа не сможет автоматически авторизоваться на устройстве. Сохраните резервную копию профиля в защищённом месте.

Определение местоположения

Раздел FindMy относится к дополнительному режиму определения местоположения через Apple Offline Finding. Здесь создаётся пара ключей, в устройство записывается открытый ключ маяка, а закрытый остаётся на компьютере.

Вкладки Account, Reports и Tracking получают и обрабатывают отчёты, а раздел Карта показывает доступные точки.

UnitX-L не является сертифицированным аксессуаром Apple и не добавляется в штатное приложение «Локатор». В нём также нет GPS: наличие и частота точек зависят от совместимых устройств Apple, оказавшихся рядом.

Настройки самой программы

Раздел Настройки изменяет поведение программы, а не прошивки UnitX-L:

• фильтр имени при поиске;
• длительность сканирования и таймаут подключения;
• таймаут команд;
• язык интерфейса и автообновление;
• адрес служебного Anisette-сервиса для режима определения местоположения.

Запуск программы из репозитория

Исходный код программы находится в каталоге utils/gui репозитория progerstar/unitx-l. Для запуска из исходников нужны Python 3 и Bluetooth на компьютере:

git clone https://github.com/progerstar/unitx-l.git
cd unitx-l/utils/gui
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python3 app.py

В Windows команда активации виртуального окружения отличается; остальные шаги те же. Консольные инструменты для разработчиков находятся в том же репозитории, но для обычной настройки они не нужны.

Локальные файлы

CSV и JSON-файлы профилей сохраняются в каталог, который пользователь выбирает в диалоге программы.

Профили, ключи и временные расшифрованные данные программа создаёт с доступом только для владельца файла (0600) и заменяет атомарно. Временный расшифрованный файл удаляется как после успешной операции, так и после ошибки.