Оборудование «Команды трекера» хранит именованные команды — имя и текст — для отправки на трекер объекта. Администратор или инженер заводит их, чтобы пользователи WALIOT.Навигатор отправляли команды из карточки объекта, а уведомления — по своему действию.
Оборудование добавляется в карточке объекта мониторинга (вкладка Объекты → «Дополнительное оборудование» → «Добавить новое оборудование»): после выбора типа открывается форма оборудования «Команды трекера».
¶ Назначение и влияние на систему
Команды трекеру — механизм удаленного управления устройством. Предустановленные команды хранятся как дополнительное оборудование в виде списка пар «имя — текст команды». Отправка моделируется сессией со своим жизненным циклом статусов, а доставка идет по модели «отправка при подключении»: команда встает в очередь и ждет, пока трекер сам выйдет на связь.
Команда ждет, пока трекер выйдет на связь, и уходит с его ближайшим сообщением; срока ожидания выхода на связь нет, отменить ее нельзя; отправляйте блокировку на трекер, который сейчас на связи. Если команд несколько, первой уходит самая ранняя из ожидающих. Как правило, за раз уходит одна команда: пока команда ожидает ответа, следующая не отправляется. Неавторизованному трекеру (без идентификатора) команды не отправляются. Результат отражается в статусе сессии, видимом пользователю.
¶ Команда трекеру и реле блокировки
Команда трекеру и реле блокировки — два независимых механизма удаленного управления, и работают они по-разному.
| Что сравниваем | Команда трекеру | Реле блокировки |
|---|---|---|
| Оборудование | «Команды трекера»: список заранее заданных текстов | «Реле блокировки»: тексты команд блокировки и разблокировки |
| Канал | Протокол трекера (TCP): команда уходит, когда трекер на связи | SMS на номер SIM трекера |
| Какие трекеры | Протоколы с поддержкой команд (столбец «TCP-команды» на странице «Совместимое оборудование и протоколы») | Любой трекер, у которого указан номер SIM |
| Откуда запускается | Окно «Команды трекера» в Навигаторе, WALIOT.Админ, действие уведомления «Послать команду трекеру» | Только действие уведомления «Заблокировать реле блокировки» или «Разблокировать реле блокировки»: кнопки в карточке объекта нет |
| Что видно после отправки | Статус команды и история отправленных команд | Платформа не подтверждает доставку SMS и исполнение |
Подробнее о реле — на странице «Реле блокировки».
¶ Как платформа считает
Статус отправленной команды трекеру платформа ведет по сессии отправки, расчетных формул нет. В Навигаторе в истории команд показаны подписи: «Ожидает подключения» (команда в очереди, трекер еще не вышел на связь) → «Ожидает ответа» (команда отправлена) → «Выполнена» (трекер ответил) либо «Истекло время ожидания» (ответ не пришел вовремя). Еще два статуса — разные причины: «Неверный протокол» (протокол команды не совпал с протоколом трекера) и «Команда не поддерживается» (трекер ответил, что не поддерживает команду).
«Выполнена» означает, что трекер ответил на команду, а не что устройство ее исполнило: платформа не подтверждает исполнение и не знает, заблокирован ли двигатель.
¶ Статусы в WALIOT.Админ и в Навигаторе
В WALIOT.Админ статус сессии показан кодом на латинице (карточка трекера, «Отправленные команды», раздел «Аудит» → «Команды»). Соответствие подписям Навигатора:
| Статус в WALIOT.Админ | Подпись в Навигаторе |
|---|---|
AWAIT_CONNECTED | Ожидает подключения |
AWAIT_RESPONSE | Ожидает ответа |
OK | Выполнена |
RESPONSE_TIMEOUT | Истекло время ожидания |
WRONG_PROTOCOL | Неверный протокол |
UNSUPPORTED_COMMAND | Команда не поддерживается |
¶ Поля формы
Форма оборудования «Команды трекера» в карточке объекта содержит поля:
- Добавить команду / Список команд — кнопка «Добавить команду» открывает окно «Список команд»; строка — «Имя команды» и «Команда». Список сохраняется в два шага: «Сохранить» в окне «Список команд» переносит команды в форму, а «Сохранить» формы оборудования записывает их. Сохраненные команды показываются двойными чипами (имя и команда) с копированием. Кнопка блокируется и меняет текст на «Трекер не поддерживает отправку команд», если у объекта нет трекера с моделью, чей протокол поддерживает команды.
- Комментарий — многострочное поле.
¶ Нюансы и типовые ошибки
¶ Очередь и статусы
- Доступность добавления команд определяется автоматически по модели трекера и его протоколу: если у объекта нет трекера с поддерживаемой моделью, кнопка блокируется и показывает текст «Трекер не поддерживает отправку команд».
- Команда в статусе «Ожидает подключения» ждет, пока трекер выйдет на связь, и уходит с его ближайшим сообщением; срока ожидания выхода на связь нет, отменить ее нельзя; отправляйте блокировку на трекер, который сейчас на связи.
- Несовпадение протокола команды и трекера дает статус «Неверный протокол»; возможная причина — неверно указанная модель трекера в системе.
- Сессия отправки хранит полный контекст: пользователя, организацию, трекер, сырую команду, время запроса, сырой ответ и время ответа.
¶ Состав и текст команд
- Текст команды платформа не проверяет и отправляет на трекер как есть; вводите латиницу, цифры и обычные знаки препинания: для других символов верная передача не гарантируется.
- Набор команд привязан к протоколу трекера, который задает порт модели. В WALIOT.Админ набор зависит от протокола и включает сервисные команды — перезагрузку, запрос модели и версии, обновление прошивки, удаленное конфигурирование — и команду с произвольным текстом. Для портов 30010 (Фарватер) и 30037 (MiCODUS) доступна только произвольная команда (см. «Совместимое оборудование и протоколы»).
- В Навигаторе уходят только заранее сохраненные тексты из оборудования «Команды трекера» объекта; сервисные команды (перезагрузка, запрос версии и другие) в Навигаторе недоступны и отправляются в WALIOT.Админ.
¶ Предупреждение, история и права
- Перед отправкой из окна «Команды трекера» Навигатор показывает предупреждение: команды, включая блокировку двигателя, могут повлиять на работу транспортного средства, все последствия ложатся на пользователя, применять их нужно только в случае крайней необходимости и при полной остановке автомобиля. Для отправки вводят слово «Отправить»; в окне есть ссылка на оферту. Платформа не проверяет скорость и движение ТС перед отправкой (подробнее — «Отправка команд трекеру»).
- История команд: в Навигаторе в окне «Команды трекера» показаны последние отправленные команды с полями «Время создания», «Команда» и «Статус»; в WALIOT.Админ — кнопка «Отправленные команды» в карточке трекера и раздел «Аудит» → «Команды» (см. «Аудит»).
- Команды можно отправить одному трекеру или нескольким сразу в WALIOT.Админ (см. «Команды трекеру»).
¶ Права
Право «Отправка команд на трекеры» выдается пользователю по умолчанию при создании. Без него кнопки «Отправить команду» и «Отправленные команды» в карточке трекера и пункт меню «Отправить команду трекерам» в WALIOT.Админ неактивны, а пункт «Команды трекера» в карточке объекта Навигатора недоступен. Для Навигатора нужны также оборудование «Команды трекера» на объекте и право «Получение информации о системных и пользовательских метках». Массовая отправка выполняется в WALIOT.Админ при доступе администратора. Добавлять и менять команды в оборудовании «Команды трекера» могут пользователи с ролью «Администратор» и выше.
¶ Что дальше
- Отправка команд трекеру — команды заведены: отправьте нужную из карточки объекта в WALIOT.Навигатор.
¶ Связанные возможности
В зависимости от роли пользователя и назначенного ему набора прав доступ к операциям с оборудованием может быть ограничен.