Version 35 (modified by tolix, 13 years ago) (diff) |
---|
Команды управления трекером (версия прошивки v0.231+)
Содержание
Назначение
Микропрограмма трекера позволяет управлять устройством и получать диагностическую информацию в простой текстовой человеко-читаемой форме, что значительно повышает управляемость устройством.
Передача запросов (команд) трекеру и получение ответов возможна различными способами:
- внутри двоичного протокола взаимодействия трекера с сервером по TCP/IP?
- SMS сообщениями
- по GSM CSD (data) соединению
- в файле config.sys в корневом каталоге карты памяти устройства (зачитывается при инициализации трекера)
Примеры
Смена адреса сервера по СМС, авторизация по паролю (начальный пароль пустой):
auth "" gprs set server 67.234.27.34 port 30003
Занесение своего сотового телефона в список авторизованных для управления без пароля:
auth "" sms set authorized 79053060230
Смена адреса сервера по СМС c авторизованного телефона:
gprs set server 67.234.27.34 port 30003
Смена пароля для СМС управления:
auth "" sms set password 1234
Запрос текущих настроек управления по SMS:
auth 1234 sms show
Вид в консоли администратора MonitorServer
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 { id | iccid | diag | version | df | reboot | activate LICENSE_NO | mkfs }
id - показать уникальный идентификатор (код) трекера
iccid - показать идентификатор SIM-карты (ICC ID)
diag - диагностическая справка
version - версия firmware (втроенной программы, "прошивки")
df - информация об использовании места на энерго-независимом накопителе (microSD)
reboot - перезагрузка устройства
activate LICENSE_NO - активировать устройство с использованием указанной лицензии (выполняется производителем)
mkfs - форматирование встроенной карты памяти трекера.
Внимание: накопленная информация и настройки будут полностью удалены, восстановление данных будет невозможно. Для защиты от случайного использования эта команда не производит реальных действий, а лишь предупреждает о последствиях. Для реального форматирования необходимо использовать sys makefilesystem.
Внимание: После форматирования настройки трекера будут сброшены к заводским (пустой SMS пароль, отключенный PIN-код, APN - предустановленный для сотового оператора вставленной SIM-карты, адрес сервера demo.monitorserver.ru порт 30003).
Форматирование может занимать продолжительное время (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 запрос с сим-карты трекера