Команды управления трекером (версия прошивки v0.307+)

Содержание

Назначение

Микропрограмма трекера (прошивка) позволяет управлять устройством и получать диагностическую информацию в простой текстовой человеко-читаемой форме, что значительно повышает управляемость устройством.

Передача запросов (команд) трекеру и получение ответов возможна различными способами:

Примеры

Получение диагностической информации

По SMS, авторизация по паролю (начальный пароль пустой): 

auth "" sys diag

В командной строке в консоли администратора MonitorServer: 

sys diag

Ответ в консоли администратора MonitorServer: 

2013-04-08 22:26:11 --> imei: 868204003196077
2013-04-08 22:26:11 --> fw: v0.307
2013-04-08 22:26:11 --> uptime: 5637s
2013-04-08 22:26:11 --> GNSS module: OK
2013-04-08 22:26:11 --> GNSS decision: YES (PDOP: 1.4, sats: 14)
2013-04-08 22:26:11 --> GSM signal: 93%
2013-04-08 22:26:11 --> FS errs: 0
2013-04-08 22:26:11 --> microSD errs: 0
2013-04-08 22:26:11 -->

Здесь:

  • fw - версия программного обеспечения ("прошивки");
  • uptime - время, прошедшее после рестарта трекера, в секундах;
  • GNSS module - работоспособность спутникового приемника;
  • GNSS decision - наличие решения навигационной задачи, снижение точности решения, количество спутников;
  • FS errs - количество обнаруженных ошибок в файловой системе на microSD карте;
  • microSD errs - количество аппаратных ошибок, возникших при работе с microSD картой.

Смена адреса сервера

По SMS, авторизация по паролю (начальный пароль пустой): 

auth "" gprs set server 67.234.27.34 port 30003

В командной строке в консоли администратора MonitorServer: 

gprs set server 67.234.27.34 port 30003

Включение передачи расширенной информации (количество спутников, состояние портов ввода-вывода, счетчиков, виртуального одометра)

По SMS, авторизация по паролю (начальный пароль пустой): 

auth "" gprs set datafmt detailed

В командной строке в консоли администратора MonitorServer: 

gprs set datafmt detailed

Занесение своего сотового телефона в список авторизованных для управления по SMS без пароля

По SMS, авторизация по паролю (начальный пароль пустой): 

auth "" sms set authorized 79053060230

В командной строке в консоли администратора MonitorServer: 

sms set authorized 79053060230

Смена адреса сервера по SMS c авторизованного телефона

По SMS: 

gprs set server 67.234.27.34 port 30003

Смена пароля для SMS-управления

По SMS, авторизация по паролю (начальный пароль пустой): 

auth "" sms set password 1234

Запрос текущих настроек SMS-управления

По SMS, авторизация по паролю (пароль 1234): 

auth 1234 sms show

Синтаксис команд

[ OPTIONS ] COMMAND

OPTIONS - необязательные опции запроса

COMMAND - команда

Опции

auth PASSWORD

Аутентификация владельца трекера по паролю. Используется при взаимодействии с трекером по SMS.

noreply

Не высылать результат обработки запроса. Актуально для экономии средств при взаимодействии по SMS (в разработке).

trnid TRANSACTION_ID

Уникальный код транзакции, генерируется отправителем запроса, дублируется в ответе (в разработке).

Команды

lin show [ PORT_NUM ]

Опрос состояния логических входов.

В ответ для каждого логического порта будет выдана пара чисел: текущее состояние (0 или 1) и счетчик импульсов с момента загрузки трекера.

Первые 8 логических портов могут быть использованы для подключения датчиков, остальные - служебные (11-й - тревожная кнопка).

Переключение состояния логического входа в 1 происходит при подаче на него напряжения более порогового. Величина порогового напряжения может быть указана в документации к трекеру, либо определена опытным путем (15-17 Вольт).

adc show [ PORT_NUM ]

Опрос состояния аналоговых входов

lout show [ PORT_NUM ]

Опрос состояния логических выходов

lout set PORT_NUM { on | off }

Установка состояния логических выходов

sys { id | iccid | imei | diag | version | df | reboot | activate LICENSE_NO | mkfs }

id - показать уникальный идентификатор (код) трекера

iccid - показать идентификатор SIM-карты (ICC ID)

imei - показать идентификатор GSM модуля в составе трекера (IMEI)

diag - диагностическая справка

version - версия firmware (втроенной программы, "прошивки")

df - информация об использовании места на энерго-независимом накопителе (microSD)

reboot - перезагрузка устройства

activate LICENSE_NO - активировать устройство с использованием указанной лицензии (выполняется производителем)

mkfs - форматирование встроенной карты памяти трекера.

Внимание: накопленная информация и настройки будут полностью удалены, восстановление данных будет невозможно. Для защиты от случайного использования эта команда не производит реальных действий, а лишь предупреждает о последствиях. Для реального форматирования необходимо использовать sys makefilesystem.

Форматирование может занимать продолжительное время (1-2 минуты, в зависимости от объема встроенной карты памяти), после чего трекер будет перезагружен.

gprs { show | set [ apn APN ] [ username APN_USERNAME ] [ password APN_PASSWORD ] [ server SERVER ] [ port PORT ] [ datafmt { full | detailed } ] }

apn APN - указывает APN. Пуcтой - использовать предопределенный для оператора сим-карты. Пример: 

gprs set apn ''

username APN_USERNAME - пользователь APN

password APN_PASSWORD - пароль APN

server SERVER - мониторинговый сервер, IP адрес или доменное имя.

port PORT - TCP/IP порт на сервере, ожидающий подключения трекера

datafmt FORMAT - формат объемных данных телеметрии. Значения формата:

  • full - формат данных протокола AGISv2 с полными (не приращениями) геоданными
  • detailed - расширенный формат данных, содержащий значения всех АЦП, значения и счетчики логических/импульсных входов

Параметры вступают в действие через некоторое время, либо после перезагрузки устройства (см. sys reboot).

geosensor { show | set [ type { auto | nmea9600 | nmea4800 | geos1m } ] }

Отображает или устанавливает тип используемого ГНСС приемника.

Внимание! Параметр устанавливается производителем, после чего изменение не требуется.

nmea9600 - любой приемник, использующий протокол NMEA0183 на скорости 9600 бод

nmea4800 - любой приемник, использующий протокол NMEA0183 на скорости 4800 бод

geos1m - ГЛОНАСС/GPS приемник Геостар ГеоС-1М

Параметры вступают в действие после перезагрузки устройства (см. sys reboot).

geodata { show | diag | truncate | acquire | set [ period { PERIOD | disabled } ] [ distance { DISTANCE | disabled } ] [ course { COURSE | disabled } ] }

Настройка и диагностика сбора телеметрической информации. Сбор данных для передачи на сервер происходит при выполнении любого из перечисленных условий:

  • истечение заданного периода времени (в секундах)
  • прохождение заданного расстояния (в метрах)
  • изменение азимута на угол более заданного (в градусах)

Все величины отсчитываются относительно момента последней фиксации данных (путевой точки).

diag - вывод диагностической информации о "черном ящике"

truncate - очистка черного ящика

period { PERIOD | disabled } - период времени, в секундах

distance { DISTANCE | disabled } - пробег, в метрах

course { COURSE | disabled } - изменение курса, в градусах. Изменение курса принимается во внимание только при скорости более 5 км/ч, иначе игнорируется из-за низкой достоверности.

acquire - немедленный сбор текущих данных с датчиков и ГНСС приемника

odometer { show | reset | enable | disable }

show - показать текущее значение

reset - сбросить значение в 0

enable, disable - включить/выключить одометр

sms { show | set [ password PASSWORD ] [ server SERVER ] [ authorized PHONE ] [ unauthorized PHONE ] }

password PASSWORD - пароль для авторизации по SMS. Указывается в начале текста SMS в виде auth PASSWORD COMMANDS. Например: 

auth 1234 sys diag
auth 1234 sms set authorized 79053060230

server SERVER - телефонный номер GSM терминала, подключенного к серверу для передачи данных по SMS/CSD

authorized PHONE - авторизовать телефонный номер для возможности подавать с него команды без пароля. Всего может быть задано до 10 номеров.

unauthorized PHONE - отозвать авторизацию телефонного номера

ussd TEXT

Отправить соответствующий USSD запрос с сим-карты трекера

Пример (в командной строке MonitorServer): 

2013-04-08 22:48:01 <-- ussd *100#
2013-04-08 22:48:05 --> USSD request queued
2013-04-08 22:48:05 --> 
2013-04-08 22:48:06 --> 50,16р.

Разрешение проблем

Воспользуйтесь инструкцией.