# Руководство пользователя 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
- Разработчик: Капцов Александр Александрович