Android app for HART protocol field devices (Bluetooth SPP / USB CP210x). Kotlin, MVVM, Jetpack Navigation, Material Design. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
11 KiB
Руководство пользователя HART Mobile
1. Общие сведения
HART Mobile — мобильное приложение для Android, предназначенное для работы с промышленными HART-датчиками через Bluetooth или USB.
Что вам понадобится
- Android-смартфон или планшет (Android 6.0+)
- HART Bluetooth-модем (BriC или аналог) или USB-адаптер CP210x с кабелем Type-C
- HART-совместимое полевое устройство, подключённое к токовой петле 4-20 мА
Физическая схема подключения
Смартфон <--Bluetooth--> BriC модем <--токовая петля 4-20 мА--> HART-датчик
или
Смартфон <--USB Type-C--> CP210x адаптер <--токовая петля--> HART-датчик
2. Установка
- Скачайте APK-файл HART Mobile.
- Откройте файл на устройстве.
- Если появится запрос «Установка из неизвестных источников» — разрешите для данного файла.
- Нажмите «Установить».
При первом запуске начинается пробный период (5 дней с полным доступом).
3. Экран подключения
После запуска открывается экран «Подключение к HART-устройству».
Подключение по Bluetooth
- Убедитесь, что BriC-модем сопряжён с вашим телефоном (через настройки Bluetooth Android).
- В списке «Сопряжённые BT устройства» нажмите на имя модема (например,
BRIC_BT_HART_SN_25070088). - Приложение подключится к модему и автоматически отправит команду идентификации (Command 0) к HART-устройству.
- При успешном ответе откроется экран параметров устройства.
Подключение по USB
- Подключите CP210x-адаптер к телефону через кабель USB Type-C.
- При обнаружении адаптера появится секция «Подключение по USB (Type-C)».
- Нажмите «Подключиться по USB».
- Android может запросить разрешение на доступ к USB-устройству — нажмите «ОК».
Обновление списка
Нажмите «Обновить» для повторного поиска Bluetooth-устройств.
4. Экран параметров устройства
Главный экран после подключения. Отображает:
Блок «Устройство»
- Тэг (Tag) — идентификатор устройства на объекте
- Дескриптор — описание устройства
- Дата — дата последней конфигурации
- Производитель — название и код производителя
- Device ID — серийный номер и тип устройства
- HART ревизия — версия протокола HART
- Dev ревизия — версия прошивки устройства
Блок «Переменные»
- PV (первичная переменная) — основное измеряемое значение (температура, давление и т.д.)
- SV (вторичная), TV (третичная), QV (четвертичная) — дополнительные переменные
- Ток петли — ток в контуре 4-20 мА
- % диапазона — процент от настроенного диапазона
Нажатие на любое значение переменной открывает тренд-график.
Кнопки действий
- Прочитать переменные — однократное чтение всех переменных
- Автообновление (2 с) — непрерывное обновление с интервалом 2 секунды
- Loop Test — переход к управлению токовой петлёй
- Поиск (Poll) — поиск устройств на шине
- Переменные устройства (Cmd 9) — расширенное сканирование переменных
- DD файл (меню производителя) — просмотр описания устройства
Меню (три точки справа вверху)
- Адрес HART — просмотр и изменение опросного адреса (0-15)
- Помощь — справочная информация
5. Тренд-график
Нажмите на значение любой переменной на экране параметров.
- График обновляется каждую секунду.
- Ось Y масштабируется автоматически.
- Вверху отображается текущее значение крупным шрифтом.
- Внизу — минимальное и максимальное значения за период наблюдения.
- Очистить — сбросить график и начать заново.
- Кнопка «Назад» — вернуться к экрану параметров.
6. Loop Test (управление токовой петлёй)
Позволяет задать фиксированный ток в петле 4-20 мА для проверки вторичных приборов.
Быстрый выбор
Нажмите одну из кнопок: 3.6, 4.0, 8.0, 12.0, 16.0, 20.0, 21.5 мА.
Ручной ввод
Введите значение в поле «мА» и нажмите «Задать». Диапазон: 3.600 — 21.500 мА. Точность: 0.001 мА.
Выход
Нажмите «СТОП — Выйти из Loop Test». Устройство вернётся к нормальному режиму управления.
Внимание: во время Loop Test устройство не отслеживает реальный технологический параметр. Используйте с осторожностью на действующем оборудовании.
7. Поиск устройств (Poll Scan)
Сканирует адреса 0-15 на HART-шине.
- Нажмите «Начать поиск».
- Приложение последовательно опрашивает каждый адрес.
- Найденные устройства отображаются с указанием адреса, производителя, серийного номера и тэга.
- Нажмите на устройство для подключения к нему.
8. Переменные устройства (Command 9)
Расширенное сканирование переменных по кодам 0-50.
- Нажмите «Сканировать» — приложение перебирает коды переменных пакетами по 4.
- Найденные переменные отображаются в списке с кодом, названием, единицей измерения и значением.
- «Обновить» — повторное чтение уже найденных переменных (без пересканирования).
9. DD файл (меню производителя)
Device Description — файл от производителя с описанием всех переменных, команд и меню устройства.
- При подключении к устройству приложение автоматически ищет подходящий DD-файл.
- Если файл найден, открывается иерархическое меню.
- При входе в подменю с командами — автоматическое чтение всех доступных команд.
- Результаты отображаются под каждым элементом меню.
Импорт DD-файла
Поддерживаемые форматы: .ddl, .dd (текстовый DDL), .sym (таблица символов).
Бинарные форматы .fm8 / .fm6 не поддерживаются.
10. Логирование
На экране параметров нажмите «Отправить логи» — откроется стандартное меню Android для отправки файла лога (email, мессенджер, облако).
Лог содержит все HART-фреймы (отправленные и полученные) с временными метками.
11. Активация лицензии
После окончания пробного периода (5 дней) откроется экран активации.
- Скопируйте Activation ID (формат
XXXX-XXXX), отображённый на экране. - Нажмите «Купить код в Telegram» — откроется бот @HART_Mobile_bot.
- Отправьте Activation ID боту, выберите тариф, оплатите картой.
- Бот автоматически пришлёт код активации.
- Введите полученный код в поле на экране активации и нажмите «Активировать».
Тарифы:
- 1 год — 1 000 руб.
- Навсегда — 5 000 руб.
12. Устранение неполадок
| Проблема | Решение |
|---|---|
| Bluetooth-устройство не в списке | Сначала выполните сопряжение в настройках Android |
| «HART не отвечает — проверьте модем» | Проверьте подключение модема к токовой петле и наличие питания 4-20 мА |
| Потеря связи через 15 секунд | BT-модем разрывает соединение при бездействии — включите автообновление |
| USB не обнаруживается | Убедитесь что адаптер на чипе CP210x, попробуйте другой кабель |
| NaN вместо значения | Устройство не поддерживает данную переменную |
13. Контакты поддержки
- Telegram: @HART_Mobile_bot
- Разработчик: Капцов Александр Александрович