Navtelecom
Пример на GitHub >>> (opens in a new tab)
Модель
Задача: Предположим, у вас есть трекер для мониторинга транспорта, подключенный к самокату и работающий по протоколу Navtelecom. Известно, что он передает следующие параметры.
| Параметр | Номер параметра в протоколе | FLEX |
|---|---|---|
| Код события | 2 | 1.0 |
| Время события | 3 | 1.0 |
| Статус функциональных модулей 1 | 5 | 1.0 |
| Статус функциональных модулей 2 | 6 | 1.0 |
| Уровень GSM | 7 | 1.0 |
| Количество спутников | 8 | 1.0 |
| Навигационный приемник включен | 8 | 1.0 |
| Валидная навигация | 8 | 1.0 |
| Широта | 10 | 1.0 |
| Долгота | 11 | 1.0 |
| Скорость | 13 | 1.0 |
| Курс | 14 | 1.0 |
| Пробег | 15 | 1.0 |
| Напряжение батареи | 20 | 1.0 |
| Самокат разблокирован | 31, 1-й выход | 1.0 |
| Состояние виртуальных датчиков акселерометра | 139 | 3.0 |
| Угол наклона относительно местной вертикали | 140 | 3.0 |
| Угол тангажа | 141 | 3.0 |
| Угол крена | 141 | 3.0 |
Также в описании трекера сказано, что он обеспечивает реакцию на следующие команды.
| Команда | Описание |
|---|---|
| Запрос модели и версии устройства | Системная команда |
| Запрос информации о прошивке | Системная команда |
| Разблокировать | Включить выход 1 |
| Заблокировать | Выключить выход 1 |
| Включить фару | Включить выход 2 |
| Выключить фару | Выключить выход 2 |
| Перезапуск устройства | Системная команда |
Для подключения трекера самоката к платформе создайте для него модель Navtelecom.
В шаблонной модели есть все параметры из разделов протокола FLEX 1.0, 2.0 и некоторые параметры из раздела FLEX 3.0. С помощью поиска по модели можно понять, какие параметры уже присутствуют, а какие нужно добавить самостоятельно.
В данном случае все необходимые параметры уже присутствуют в модели. Остается только удалить или скрыть из отображения лишние параметры, а нужные параметры сгруппировать.
Подробнее о формировании аргументов Navtelecom >>>
Также в шаблонной модели заранее определены все возможные для отправки команды. Команды для включения и выключения выходной линии 1 в данном случае отвечают за блокировку самоката, а выходной линии 2 - за фару. Переименуйте данные команды. Другие необходимые команды можно оставить без изменения, а все лишние действия удалить или скрыть из отображения.
Подробнее о формировании действий Navtelecom >>>
Посмотрите превью объекта с моделью, которую вы создали, нажав кнопку Показать превью.
При желании выберите иконку для отображения объекта на карте или загрузите свое изображение.
Модель для импорта >>> (opens in a new tab)
Объект
Создайте объект для вашего самоката. Выберите модель, которую только что создали. Затем введите идентификатор, соответствующий IMEI блока мониторинга, с префиксом ntcb:. Укажите имя объекта.
После сохранения откроется инструкция по настройке устройства на платформу.
Подключение
Для подключения самоката к платформе в настройках конфигуратора блока мониторинга укажите
- хост dev.rightech.io
- порт 21400
Убедитесь, что после сохранения настроек данные от устройства присылаются и отображаются в интерфейсе. После получения пакета с координатами объект должен отобразиться на карте.
Отправьте команды и проверьте, что подключенное устройство на них реагирует.
Подробнее о подключении устройств >>>
Логика
В качестве примера по комплексному контролю геозон рассмотрим следующую задачу.
Задача: Предположим, что нужно отправлять разные уведомления в платформу, если самокат покинул допустимую геозону для катания и если самокат заехал в геозону, строго запрещенную для катания. Получается, что в данном примере есть две геозоны, по которым контроль движения самоката отличается.
Автомат будет содержать три состояния:
-
ожидание срабатывания события по пересечению геозон;
-
вне разрешенной геозоны;
-
в запрещенной геозоне.
Переходы между этими состояниями будут происходить при получении событий входа и выхода из соответствующих геозон. Однако если в одном из прошлых примеров использовались события по умолчанию Вход/выход из геозоны, то в данном случае вам нужно дополнить модель своими событиями, по которым затем будут происходить переходы в автомате. Если этого не сделать и использовать события по умолчанию, то, например, событие Выход из геозоны будет срабатывать при выходе как из разрешенной геозоны, так и из запрещенной геозоны, и вы не сможете отличить их в автомате.
Перейдите в модель и создайте дополнительные события. Вам нужно создать как минимум два события: выход из разрешенной геозоны и вход в запрещенную геозону. Однако лучше создать полный комплект событий для геозон обоих типов, то есть четыре события.
Создайте новый автомат.
Так как по логике работы сценария автоматизации предусматривается цикличный контроль за входом и выходом из геозон, автомат будет бесконечным, конечное состояние можно отодвинуть из поля зрения и не использовать. Создайте три состояния автомата.
Переходы между состояниями будут происходить при получении событий о входе или выходе из геозоны. Проверка дополнительных условий в данном случае не требуется. Обратите внимание, что выбирать нужно именно те события, которые вы создали, а не события для геозон, присутствующие по умолчанию.
Теперь добавьте команды для отправки уведомлений.
Автомат готов. Выберите объект самоката и запустите его.
Автомат запущен, однако для перехода между состояниями должны поступать события о входе и выходе из контролируемых геозон.
Геозоны
Создайте геозоны, определяющие разрешенную и запрещенную область для использования самоката.
Добавьте геозоны на объект самоката. После получения актуальных координат появится статус нахождения в геозонах In/Out.
Добавьте для этих геозон соответствующие события, которые вы создали ранее. Тогда они будут генерироваться при входе и выходе из геозоны. Именно они использовались в автомате.
Теперь при входе и выходе из геозон происходит переход между состояниями и отправляются уведомления.
