= Команды управления трекером (версия прошивки v0.307+) = == Содержание == * [#Назначение Назначение] * [#Примеры Примеры] * [#Синтаксискоманд Синтаксис команд] * [#Опции Опции] * [#Команды Команды] * [#Разрешениепроблем Разрешение проблем] == Назначение == Микропрограмма трекера (прошивка) позволяет управлять устройством и получать диагностическую информацию в простой текстовой человеко-читаемой форме, что значительно повышает управляемость устройством. Передача запросов (команд) трекеру и получение ответов возможна различными способами: * внутри [wiki:FirmwareProtocol двоичного протокола взаимодействия трекера с сервером по TCP/IP] * SMS сообщениями * по GSM CSD (data) соединению (в разработке) * в файле config.cmd в корневом каталоге карты памяти устройства (зачитывается при инициализации трекера, применяется, после чего удаляется) == Примеры == === Получение диагностической информации === По 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 } === #sys '''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р. }}} == Разрешение проблем == Воспользуйтесь [wiki:Troubleshooting инструкцией].