Version 21 (modified by tolix, 14 years ago) (diff)

--

Текстовое управление трекером (версия прошивки v0.83)

Текстовое управление представляет из себя обмен запросами-ответами с трекером в простой текстовой человеко-читаемой форме.

Пример: 

2011-06-05 22:20:44 <-- sys version
2011-06-05 22:20:46 --> Firmware v0.52 (build #479 2011-05-21 23:37:45)
2011-06-05 22:20:46 --> 
2011-06-05 22:20:46 <-- sys diag
2011-06-05 22:20:48 --> Uptime 2232 seconds.
2011-06-05 22:20:48 --> GNSS status: OK
2011-06-05 22:20:48 --> GNSS decision ready: YES (PDOP: 1.4, satellites: 15)
2011-06-05 22:20:48 --> 
2011-06-05 22:20:58 <-- odometer show
2011-06-05 22:21:00 --> Odometer is enabled, value = 1519602.28 m
2011-06-05 22:21:00 -->

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

Синтаксис запроса

[ OPTIONS ] COMMAND

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

COMMAND - команда

Опции

auth PASSWORD

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

noreply

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

trnid TRANSACTION_ID

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

Команды

adc show [ PORT_NUM ]

lin show [ PORT_NUM ]

lout show [ PORT_NUM ]

lout set PORT_NUM { on | off }

Опрос состояния логических/импульсных/аналоговых входов или выходов, установка состояния логических выходов.

sys { diag | version | df | reboot | activate LICENSE_NO }

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

version - версия firmware ("прошивки")

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

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

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

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 | geos1m } ] }

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

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

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

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

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

geodata { show | acquire | set [ period { PERIOD | disable } ] [ distance { DISTANCE | disable } ] [ course { COURSE | disable } ] }

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

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

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

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 запрос с сим-карты трекера