¶ 1. Интеграция с NBIOT устройствами
Для интеграции с NBIOT устройствами используется модуль NBIOT, который принимает трафик от NBIOT по MQTT протоколу.
Важно! Поскольку формат данных NBIOT устройств не стандартизован, то каждый тип устройства требует проверки на совместимость с модулем.
Список совместимых устройств NBIOT сопровождается на сайте компании.
¶ 1.1. Установка в качестве демона линукс
- Создать директорию /opt/nbiot-gate и поместить в нее nbiot-gate.jar, application.yml
mkdir /opt/nbiot-gate
cp nbiot-gate.jar /opt/nbiot-gate
cp application.yml /opt/nbiot-gate
- Создать символьную ссылку в директории /etc/init.d
cd /etc/init.d
chmod +x /opt/nbiot-gate/nbiot-gate.jar
ln -s /opt/nbiot-gate/nbiot-gate.jar nbiot-gate
- Перечитать список сервисов linux
systemctl daemon-reload
- Запуск и остановку сервиса можно осуществлять стандартными командами, т.е.
service nbiot-gate start
service nbiot-gate status
service nbiot-gate stop
¶ 1.2. Настройки
Настройки содержатся в файле application.yml который должен располагаться в директории запуска (т.е. рядом с nbiot-gate.jar).
Прежде всего следует настроить способ логирования (для докеров принято логировать в консоль, для standalone установок в файлы):
spring:
# профили логирования, console - вывод в консоль, file - вывод в файл
profiles:
active: console
Параметры подключения к БД - нужно задать урл, пользователя и пароль
spring:
datasource:
# подключение к БД (урл, пользователь, пароль)
url: jdbc:postgresql://192.168.1.13:5432/semdb?currentSchema=sem
username: postgres
password: postgres
Параметры подключения к JMS брокеру артемис - нужно задать урл, пользователя и пароль
artemis:
url: tcp://localhost:61616
user: artemis
password: artemis
Параметры подключения к MQTT брокеру - нужно задать урл, пользователя и пароль
mqtt:
url: tcp://localhost:1883
user: admin
password: admin
¶ 1.3. Метрики производительности
Метрики публикуются в формате прометеус экспортер по адресу http://localhost:8739/metrics
Порт можно поменять в конфиге application.yml (server.port).
Доступны метрики:
- commands_count - Количество команд полученных из очереди JMS NbiotCommand
- commands{quantile=«0.95»,} - Квантили времени обработки команд полученных из очереди JMS NbiotCommand (секунд, квантили можно настраивать)
- commands_not_valid_total - Количество не корректных команд (из общего числа полученных)
- commands_failed_total - Количество не отправленных по каким-то причинам (сеть не доступна, что-то еще) комманд.
- mqtt_measures_count - Количество полученных mqtt-сообщений с измерениями
- mqtt_measures{quantile=«0.95»,} - Квантили времени обработки полученных mqtt-сообщений с измерениями (секунд)
- jms_measures_total - Количество измерений, отправленных в очередь JMS Measure
¶ 1.4. Описание работы модуля
Прием измерений от устройств
Измерения от NBIOT устройства приходят в топики измерений (up), пример:
/ASUNO-NBIOT/0100112233445566/up
Где:
ASUNO-NBIOT - префик шлюза nbiot
0100112233445566 - серийный номер устройства
up - признак поступивших от устройства данных
Для того чтобы получать данные от устройства, приведенного в примере нужно:
-
создать запись в таблице device_gate (username = „ASUNO-NBIOT“)
-
создать устройство с нужными каналами в Device с типом DeviceType = NBIOT, документ по каналам для умной лампы ATB-LAMP v1
-
создать контроллер с типовой конфигурацией, содержащей созданное устройство
-
связать схему подключения устройства DeviceConnect с записью device_gate где username = „ASUNO-NBIOT“
-
задать устройству на контроллере (Unit) серийный номер (в этом примере serialnumber = 0100112233445566)
Отправка команд устройствам
Команды устройствами принимаются в топиках команд (down), пример:
/ASUNO-NBIOT/0100112233445566/down
{"bright": 100, "mode": 1}
Для отправки команд нужно:
- сконфигурировать устройство так же как описано выше для получения измерений.
- cоздать запись внешней команды ext_command где cmd=down, data=
- связать команду с устройством
- отправить команду устройству через интерфейс ЛК
¶ 2. Модуль прогноза погоды
Модуль прогноза погоды представляет собой отдельный серверный компонент, который устанавливается в отдельном экземпляре сервера приложений. Этот компонент эмулирует поведение метеодатчиков с использованием внешнего сервиса погоды. На стороне ядра платформы реализован виртуальное метеоустройство (метео-контроллер), который запрашивает погоду у модуля прогноза.
¶ 2.1. Требования к модулю погоды
- На сервере должен быть установлен пакет Docker и Docker-compose
- Минимальное кол-во vCPU: 0,5
- Минимальное кол-во RAM: 256 Мб
- Должен быть доступен провайдер погоды в сети Интернет
- Должен быть достпен реестр докеров registry.infsys.ru
¶ 2.2. Инструкция по развертыванию
¶ 2.2.1. Запуск докер-экземпляра
Пуск докер сервера осуществляется следующим образом:
- Подключитесь в репозиторию
docker login registry.infsys.ru - Если нет выхода в Инет, предварительно скачайте образ сервера отчетов
` docker pull registry.infsys.ru/iss/weather - Запустите докер север
docker run -d --name weather -p 8080:8080 registry.infsys.ru/iss/weather
¶ 2.2.2. Запуск сервера отчетности в среде K8
- helm скрипт развертывания сервера отчетности доступен в репозитории registry.infsys.ru/stable
- Подключите репозиторий
helm repo add sem-next http://registry.infsys.ru/stable/
-
выполните обновление скриптов helm
helm repo update -
Внесите все необходимые параметры в файл переменных, либо используйте опцию --set
| Параметр | Значение в value.yaml | Коммментарии |
|----------|-----------------------|--------------|
| images.repository| registry.infsys.ru/iss/weather| образ weather |
| images.tag | latest | тег для контейнеров |
| images.pullPolicy | Always | иногда полезно ставить Always, не всегда измененные контейнеры имеют новый тег
|
| service.port | 8080 | порт http для обращения клиентов к weather|
| providers| openweathermap | В текущей версии используется только провайдер погоды openweathermap. Для этого провайдера можно внести любое кол-во AppID, по которым сервис будет запрашивать погоду |
| max-requests-per-minute | 58 | максимальное количество запросов в минуту к провайдеру | -
Запустите сервер в K8
helm install <имя инстанса> [-f <имя файла yaml >] sem-next/weather -n <имя namespace>
, где
- <имя инстанса> - любое имя. имя инстанса будет участвовать в формирвоании имен Pod-ов b services
- <имя файла yaml > - путь к файлу с начальными значениями
- sem-next - репозиторий, предварительно подключенный (см. описание на первой странице проекта)
- weather - имя пакета
Пример:
helm install oras sem-next/weather -n inspark
При изменении начальных значений необхдимо провести upgrade инстанса:
helm upgrade <имя инстанса> [-f <имя файла yaml >] sem-next/weather -n <имя namespace>
Удаление инстанса выполняется командой:
helm uninstall <имя инстанса> -n <имя namespace>
¶ 2.3. Настройка платформы для работы с модулем погоды
Для запуска модуля прогноза погоды, в конфигурационном файле sem-next.xml пропишите секцию запуска приложений при старте сервера приложений:
<weather>
<uri>http://127.0.0.1:8085/weather/api</uri>
</weather>
В секции настройки указывается TCP/IP адрес хоста, где запускается модуль погоды. Если модуль погоды запускается для конкретного инстанса платформы, вместе с остальными модулями ядра, то указывается адрес основного хоста.