Управление продуктами
Обзор страницы
Точка входа и рекомендуемый процесс
- Перейдите в Управление устройствами → Управление продуктами и сначала определите категорию продукта, тип устройства, транспортный протокол, протокол связи и способ аутентификации.
- После добавления продукта откройте детали продукта и настройте по возможностям устройства модель вещи, Modbus, SIP, подпродукты, конфигурацию приложения или SCADA-приложение.
- После завершения настройки опубликуйте продукт, затем перейдите в управление устройствами и добавьте или импортируйте устройства.
- После выхода устройств в сеть вернитесь на страницы продукта и модели вещи и проверьте, что данные, команды, события, правила и оповещения взаимодействуют нормально.
1. Введение в управление продуктами
Продукт — это набор устройств, обычно описание физических устройств одного типа и модели. Из этой статьи вы узнаете о функциях, связанных с продуктами.
1.1. Общие сведения
Продукт позволяет централизованно управлять транспортным протоколом, протоколом связи, моделью вещи и настройкой Modbus для однотипных устройств: одинаковые устройства принадлежат одному продукту, что реализует единое управление устройствами. На основе продукта также можно настраивать сценарную автоматизацию, SCADA-экраны и др.
1.2. Параметры продукта
| Параметр | Описание |
|---|---|
| Название продукта | Обязательное, имя продукта, произвольное |
| Категория продукта | Обязательное, выпадающий список с одиночным выбором; настраивается в меню категорий продуктов, несколько продуктов можно отнести к одной категории |
| Тип устройства | Обязательное, выпадающий список с одиночным выбором; для видеонаблюдения выбирайте «видеоустройство», остальные типы устройств см. в документе о шлюзах и подчинённых устройствах (на кит.) |
| Протокол связи | Обязательное, выпадающий список с одиночным выбором; кодирование/декодирование данных, отправляемых устройством, — необходимо выбрать подходящий; имеющиеся протоколы см. в меню управления протоколами |
| Транспортный протокол | Обязательное, выпадающий список с одиночным выбором; способ подключения устройства к IoT-платформе — необходимо выбрать подходящий |
| Тип прошивки | Обязательное, выпадающий список с одиночным выбором; выберите подходящий, см. документ об OTA-обновлении устройств (на кит.) |
| Способ подключения к сети | Опциональное, выпадающий список с одиночным выбором; по сути метка — выбирайте по способу подключения устройства к сети |
| Приватный продукт | Переключатель; после включения подчинённые организации не могут просматривать |
| Авторизация устройств | Переключатель; функция авторизации устройств, по умолчанию выключена; если для продукта включён код авторизации устройств, каждому устройству нужно назначить код авторизации, используемый при аутентификации |
| Способ аутентификации | Обязательное, способ аутентификации подключения устройства, выпадающий список с одиночным выбором; см. документы о подключении устройств по разным протоколам в разделе подключения устройств |
| Способ позиционирования | Обязательное, выпадающий список с одиночным выбором Автоматическое позиционирование: при аутентификации устройства платформа автоматически получает его позицию; Позиционирование устройства: устройство само отправляет координаты (долготу и широту) в топик /info/post; Пользовательская позиция: координаты настраиваются вручную в деталях устройства |
| Номер продукта | Генерируется системой автоматически |
| Аккаунт аутентификации | Обязательное, генерируется системой при создании, можно изменить |
| Пароль аутентификации | Обязательное, генерируется системой при создании, можно изменить |
| Ключ аутентификации | Обязательное, генерируется системой при создании, можно изменить |
| Изображение продукта | Опциональное, можно изменить |
| Примечание | Необязательное поле ввода |
1.3. Список продуктов
1.3.1. Добавление
Нажмите кнопку "+ Добавить", откроется окно добавления продукта; после нажатия «OK» продукт появится в списке.
提示
Примечание: если тип устройства продукта — шлюзовое устройство, а протокол связи — ModbusRtu, протокол разбора Modbus в Json — Hezhou IoT, ModbusTcp или протокол разбора JSON-шлюза, появится кнопка настройки подпродуктов, через которую можно напрямую импортировать подпродукты; подробная настройка см. в документе о шлюзах и подчинённых устройствах (на кит.)
1.3.2. Копирование
Нажмите кнопку "Копировать", откроется окно выбора продукта; выберите нужный продукт и нажмите «OK» — будет создана полностью идентичная копия продукта. 
1.3.3. Импорт
Нажмите кнопку "Импорт", откроется окно импорта продукта: сначала скачайте json-шаблон, затем отредактируйте json-файл, затем нажмите «Загрузить файл» и, наконец, нажмите «OK» для импорта.
1.3.4. Показывать продукты вышестоящей организации
Если флажок установлен, в выборку попадут продукты вышестоящей организации, но их редактирование не поддерживается.
1.4. Детали продукта
Страница деталей продукта включает основную информацию, модель продукта, настройку Modbus, авторизацию устройств, SCADA-приложение, конфигурацию приложения и др.
提示
Примечание: кроме подпродуктов, задач опроса и конфигурации приложения, для редактирования остальных функций продукт нужно сначала снять с публикации
1.4.1. Основная информация
Можно изменить часть основной информации.
1.4.2. Модель продукта
Модель вещи — это описание устройства в облаке, определяющее реальное устройство по четырём измерениям: свойства, функции, события и метки.
- Импорт файла модели вещи: нажмите, чтобы перейти в окно пакетного импорта; сначала скачайте шаблон импорта модели вещи продукта, отредактируйте его, нажмите «Загрузить файл» и, наконец, «OK» для импорта
- Импорт общей модели вещи: нажмите, чтобы перейти в окно импорта общей модели вещи, выберите подходящую общую модель вещи и нажмите «Импорт»
- Просмотр модели вещи: нажмите, чтобы перейти в окно модели вещи, где можно просмотреть всю структуру данных модели вещи
1.4.3. Конфигурация приложения
Интерфейс режима состояния мобильного приложения поддерживает кастомизацию: нажмите «Настроить» в конфигурации приложения продукта, настройте интерфейс под свои задачи на экране конфигурации и после настройки нажмите «Включить».
1.4.4. Авторизация устройств
Опциональная функция; после включения используется в основном для аутентификации устройств — каждому устройству нужно назначить код авторизации.
1.4.5. Настройка SIP
Параметры протокола SIP, соответствующие государственному стандарту GB28181 (национальный стандарт для систем видеонаблюдения общественной безопасности); основное назначение — дать продукту (обычно видеоустройству, например камере) возможность подключаться по протоколу SIP к платформе видеонаблюдения GB28181 и реализовать регистрацию устройства, передачу видеопотока, управление устройством и другие функции.
1.4.6. Подпродукты
Для шлюзового типа устройства часть протоколов связи поддерживает настройку подпродуктов.
- Добавить: нажмите, чтобы перейти в окно выбора продукта, выберите нужный подпродукт и нажмите «OK» для привязки
- Задать адрес: нажмите, чтобы отредактировать адрес подчинённого устройства по умолчанию для подпродукта; адреса не должны повторяться
1.4.7. Настройка Modbus
Требуется для продуктов с протоколами семейства Modbus: настройка собственных свойств шлюза или подчинённых устройств шлюза в Modbus-устройствах; подробная настройка см. в документе о шлюзах и подчинённых устройствах (на кит.).
1.4.8. Задачи опроса
Для протоколов семейства Modbus необходимо настроить задачи опроса для активного сбора данных: в настройке Modbus продукта — настройка шлюза/подчинённого устройства — способ сбора обязательно отметьте опрос из облака; при создании устройство наследует настройку.
1.4.9. Отправка команд
Если протоколом связи продукта выбран ModbusTcp, настройте команды; при создании устройство наследует их, и отправку можно выполнить на стороне устройства.
1.4.10. SCADA-приложение
Проектирование SCADA-экрана для продукта: все устройства этого продукта могут просматривать экран, на котором в реальном времени отображаются отправляемые устройством данные и выполняется отправка команд.
1.5. Публикация продукта
Новый продукт по умолчанию находится в состоянии «Не опубликован». После завершения определения продукта по деталям продукта нажмите кнопку "Опубликовать продукт"; после включения можно создавать устройства этого продукта.
提示
Примечание: если продукт не опубликован, аутентификация устройства завершится ошибкой
1.6. Мультитенантность
Изоляция арендаторов: вышестоящая организация может использовать и редактировать продукты подчинённых организаций; подчинённая организация может просматривать и использовать, но не редактировать продукты вышестоящей организации.
1.7. Таблица выбора конфигурации
При создании продукта проще всего ошибиться в типе устройства, протоколе связи, транспортном протоколе и способе аутентификации. Рекомендуется сначала определить их по таблице ниже, а затем создавать продукт.
| Сценарий | Тип устройства | Транспортный протокол | Протокол связи | Примечание |
|---|---|---|---|---|
| Обычный MQTT-датчик | Устройство прямого подключения | MQTT | Разбор JSON или пользовательский протокол | Самый распространённый способ подключения, подходит для быстрого старта |
| Устройство с активной отправкой по HTTP | Устройство прямого подключения | HTTP | Разбор JSON или пользовательский протокол | Подходит для редкой отправки и устройств с готовой поддержкой HTTP |
| Устройство с частным протоколом TCP | Устройство прямого подключения | TCP | Пользовательский протокол | Требуется адаптация кодирования/декодирования на сервере |
| Шлюз Modbus RTU | Шлюзовое устройство | По линии связи на объекте | ModbusRtu или протокол шлюза | Требуется настройка подпродуктов, регистров и задач опроса |
| Устройство Modbus TCP | Устройство прямого подключения или шлюзовое устройство | Modbus TCP | Протокол ModbusTcp | Нужно определить, выступает ли устройство клиентом или сервером |
| Камера GB28181 | Видеоустройство | SIP/GB28181 | SIP/видеопротокол | Требуется настройка SIP и сервиса потокового медиа |
| Автомобильный терминал позиционирования | Устройство прямого подключения | TCP/JT808 | Протокол JT808 | Нужно спланировать сопоставление номера терминала и номера устройства |
Контрольный список перед публикацией
Перед публикацией продукта рекомендуется проверить каждый пункт:
| Проверяемый пункт | Нормальное состояние |
|---|---|
| Основная информация продукта | Подтверждены название, категория, тип устройства, протоколы, способ аутентификации |
| Модель вещи | Идентификаторы свойств, функций, событий уникальны, типы данных верны |
| Данные аутентификации | Сгенерированы аккаунт, пароль и ключ MQTT/HTTP/TCP |
| Авторизация устройств | Если авторизация включена, подготовлен способ назначения кодов авторизации |
| Настройка Modbus | Подтверждены регистры, адреса ведомых устройств, коды функций, задачи опроса |
| Подпродукты | К продукту-шлюзу привязаны управляемые подпродукты |
| Настройка SIP | Для видеопродукта настроены SIP-информация и сервис потокового медиа |
| Конфигурация приложения | Режим состояния мобильного приложения или SCADA-приложение включены по необходимости |
| Статус публикации | Итоговый статус продукта — «Опубликован» |
Часто задаваемые вопросы
Ошибка публикации продукта
Проверьте полноту обязательных полей, отсутствие дубликатов идентификаторов модели вещи и полноту настройки протоколов. Для изменения части настроек продукт нужно сначала снять с публикации.
Ошибка аутентификации устройства
В первую очередь проверьте, опубликован ли продукт, а также совпадают ли ID продукта, номер устройства, аккаунт аутентификации и пароль аутентификации, используемые на стороне устройства, с текущим продуктом.
После отправки данных устройством страница их не отображает
Проверьте, что идентификаторы модели вещи полностью совпадают с id в отправляемом сообщении, что типы данных соответствуют, и что продукт был опубликован до создания устройства.
Подчинённая организация не видит продукт
Проверьте, не является ли продукт приватным, права на данные организации, права текущей роли, а также установлен ли флажок «Показывать продукты вышестоящей организации».
Точки входа для вторичной разработки
| Тип | Путь или интерфейс | Описание |
|---|---|---|
| Страница Vue3 | vue3/src/views/iot/product | Список продуктов, детали продукта, модель продукта и конфигурация приложения |
| API Vue3 | vue3/src/api/iot | Обёртки интерфейсов продуктов, моделей, протоколов |
| Backend-интерфейс | /iot/product | Интерфейс управления продуктами |
| Backend-интерфейс | /iot/model | Интерфейс модели вещи продукта |
| Backend-интерфейс | /iot/protocol | Интерфейс управления протоколами |
| Модуль протоколов | springboot/fastbee-protocol | Кодирование/декодирование протоколов устройств |
| Бизнес-модуль | springboot/fastbee-open-api | Controller, связанные с продуктами |
| SQL-скрипты | springboot/sql | Структуры таблиц продуктов, моделей вещей, протоколов и скрипты обновления |