39662d323a
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>
171 lines
11 KiB
Markdown
171 lines
11 KiB
Markdown
# Руководство пользователя 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. Установка
|
||
|
||
1. Скачайте APK-файл HART Mobile.
|
||
2. Откройте файл на устройстве.
|
||
3. Если появится запрос «Установка из неизвестных источников» — разрешите для данного файла.
|
||
4. Нажмите «Установить».
|
||
|
||
При первом запуске начинается пробный период (5 дней с полным доступом).
|
||
|
||
## 3. Экран подключения
|
||
|
||
После запуска открывается экран **«Подключение к HART-устройству»**.
|
||
|
||
### Подключение по Bluetooth
|
||
1. Убедитесь, что BriC-модем сопряжён с вашим телефоном (через настройки Bluetooth Android).
|
||
2. В списке «Сопряжённые BT устройства» нажмите на имя модема (например, `BRIC_BT_HART_SN_25070088`).
|
||
3. Приложение подключится к модему и автоматически отправит команду идентификации (Command 0) к HART-устройству.
|
||
4. При успешном ответе откроется экран параметров устройства.
|
||
|
||
### Подключение по USB
|
||
1. Подключите CP210x-адаптер к телефону через кабель USB Type-C.
|
||
2. При обнаружении адаптера появится секция «Подключение по USB (Type-C)».
|
||
3. Нажмите **«Подключиться по USB»**.
|
||
4. 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-шине.
|
||
|
||
1. Нажмите **«Начать поиск»**.
|
||
2. Приложение последовательно опрашивает каждый адрес.
|
||
3. Найденные устройства отображаются с указанием адреса, производителя, серийного номера и тэга.
|
||
4. Нажмите на устройство для подключения к нему.
|
||
|
||
## 8. Переменные устройства (Command 9)
|
||
|
||
Расширенное сканирование переменных по кодам 0-50.
|
||
|
||
1. Нажмите **«Сканировать»** — приложение перебирает коды переменных пакетами по 4.
|
||
2. Найденные переменные отображаются в списке с кодом, названием, единицей измерения и значением.
|
||
3. **«Обновить»** — повторное чтение уже найденных переменных (без пересканирования).
|
||
|
||
## 9. DD файл (меню производителя)
|
||
|
||
Device Description — файл от производителя с описанием всех переменных, команд и меню устройства.
|
||
|
||
- При подключении к устройству приложение автоматически ищет подходящий DD-файл.
|
||
- Если файл найден, открывается иерархическое меню.
|
||
- При входе в подменю с командами — автоматическое чтение всех доступных команд.
|
||
- Результаты отображаются под каждым элементом меню.
|
||
|
||
### Импорт DD-файла
|
||
Поддерживаемые форматы: `.ddl`, `.dd` (текстовый DDL), `.sym` (таблица символов).
|
||
Бинарные форматы `.fm8` / `.fm6` не поддерживаются.
|
||
|
||
## 10. Логирование
|
||
|
||
На экране параметров нажмите **«Отправить логи»** — откроется стандартное меню Android для отправки файла лога (email, мессенджер, облако).
|
||
|
||
Лог содержит все HART-фреймы (отправленные и полученные) с временными метками.
|
||
|
||
## 11. Активация лицензии
|
||
|
||
После окончания пробного периода (5 дней) откроется экран активации.
|
||
|
||
1. Скопируйте **Activation ID** (формат `XXXX-XXXX`), отображённый на экране.
|
||
2. Нажмите **«Купить код в Telegram»** — откроется бот @HART_Mobile_bot.
|
||
3. Отправьте Activation ID боту, выберите тариф, оплатите картой.
|
||
4. Бот автоматически пришлёт код активации.
|
||
5. Введите полученный код в поле на экране активации и нажмите **«Активировать»**.
|
||
|
||
Тарифы:
|
||
- 1 год — 1 000 руб.
|
||
- Навсегда — 5 000 руб.
|
||
|
||
## 12. Устранение неполадок
|
||
|
||
| Проблема | Решение |
|
||
|---|---|
|
||
| Bluetooth-устройство не в списке | Сначала выполните сопряжение в настройках Android |
|
||
| «HART не отвечает — проверьте модем» | Проверьте подключение модема к токовой петле и наличие питания 4-20 мА |
|
||
| Потеря связи через 15 секунд | BT-модем разрывает соединение при бездействии — включите автообновление |
|
||
| USB не обнаруживается | Убедитесь что адаптер на чипе CP210x, попробуйте другой кабель |
|
||
| NaN вместо значения | Устройство не поддерживает данную переменную |
|
||
|
||
## 13. Контакты поддержки
|
||
|
||
- Telegram: @HART_Mobile_bot
|
||
- Разработчик: Капцов Александр Александрович
|