SMS команды
Формат команд
Все команды, отправляемые не с номера владельца, должны начинаться с пароля.
- Команды вводятся латинскими буквами и нечувствительны к регистру
- Параметры команды перечисляются через пробел
- В одном сообщении может отправляться только одна команда
- Все системные команды должны начинаться с пароля
- Первичная настройка терминала должна начинаться с установки телефона владельца с помощью программы Omnicomm Configurator или SMS
Формат команды:
| Начало команды | Пароль | Команда | Параметры команды | Конец команды |
|---|---|---|---|---|
| * | не обязательное поле | обязательное поле | не обязательное поле | # |
Пример команды: *3245 channel sms#
| Начало команды | Пароль | Команда | Параметры команды | Конец команды |
|---|---|---|---|---|
| * | 3245 | channel | sms | # |
Системные команды
Изменение номера телефона владельца
Для установки или изменения телефона владельца необходимо знать ранее установленный пароль. Пароль по умолчанию: 0000. Ответ отправляется на номер телефона, с которого отправлялась команда.
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *pass tel +yyyyyyyyyy# | где pass – пароль +yyyyyyyyyy – новый номер в международном формате (не более 20 символов) | *1234 tel +79099091122# |
| Ответ на команду | Комментарии |
|---|---|
| tel changed | телефон изменен |
| Возможные ошибки | Комментарии |
| tel. Wrong pass | неверный пароль |
| tel. Wrong number. Start from '+',⇐20digits | неверный формат номера |
Изменение пароля
Изменение пароля производится только с телефона владельца.
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *pass xxxx# | где xxxx – новый пароль. Максимальное количество символов – 8 (латинские буквы, цифры). Пароль регистронезависим. Значение по умолчанию – 0000 | *pass 12345# |
| Ответ на команду | Комментарии |
|---|---|
| pass changed | пароль изменен |
| Возможные ошибки | Комментарии |
| pass. Wrong owner number | неверный номер владельца |
| pass. Wrong pass. Only digits,⇐8digits | неверный формат пароля |
Изменение имени устройства
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** name ИМЯ УСТРОЙСТВА# | где **** – пароль ИМЯ УСТРОЙСТВА – имя устройства до 20 символов без пробелов (латинские буквы, цифры, символы) | *1234 name SuperOBD_22# |
| Ответ на команду | Комментарии |
|---|---|
| name changed | имя устройства изменено |
| Возможные ошибки | Комментарии |
| name. Wrong pass | неверный пароль |
| name. Wrong name. Only ASCII,⇐20 symbols | неверный формат имени |
Установка даты и времени
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** time ДД-ММ-ГГГГ ЧЧ:мм# | где ДД-ММ-ГГГГ ЧЧ:мм – число / месяц / год / часы / минуты | *1234 time 21-07-2018 12:50# |
| Ответ на команду | Комментарии |
|---|---|
| time changed to ДД-ММ-ГГГГ ЧЧ:мм | дата и время изменены |
| Возможные ошибки | Комментарии |
| time. Wrong pass | неверный пароль |
| time. Wrong args | неверный формат даты или времени |
Включение / выключение SMS уведомлений
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** SMS on# * **** SMS off# | где on – включено off – выключено | *1234 SMS on# |
| Ответ на команду | Комментарии |
|---|---|
| SMS on SMS off | где on – включено off – выключено |
| Возможные ошибки | Комментарии |
| SMS. Wrong pass | неверный пароль |
| SMS. Wrong args | неверный формат команды |
Настройка сети
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** net APN login password# | в зависимости от оператора сотовой связи login, password не обязательные параметры | *1234 net internet.mts.ru mts mts#, *1234 net internet.mts.ru# |
| Ответ на команду | Комментарии |
|---|---|
| APN changed to ХХХ | где ХХХ – установленный APN |
| Возможные ошибки | Комментарии |
| net. Wrong pass | неверный пароль |
| net. Wrong args | неверный формат команды |
Настройка КС
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** server адрес КС порт протокол# | значения по умолчанию: cs.omnicomm.ru 9977 Omnicomm | *1234 cs.omnicomm.ru 9977 Omnicomm# |
| Ответ на команду | Комментарии |
|---|---|
| server changed to адрес КС:порт, протокол | настройки изменены |
| Возможные ошибки | Комментарии |
| server. Wrong pass | неверный пароль |
| server. Wrong args | неверный формат команды |
Перезагрузка терминала
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** restart# | перезагрузка терминала | *1234 restart# |
| Ответ на команду | Комментарии |
|---|---|
| restart ОК | терминал перезагружен |
| Возможные ошибки | Комментарии |
| restart. Wrong pass | неверный пароль |
Установка соединения с сервером удаленной настройки
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** update# | соединение с СУН | *1234 update# |
| Ответ на команду | Комментарии |
|---|---|
| update started | |
| Возможные ошибки | Комментарии |
| update. Wrong pass | неверный пароль |
Возврат к заводским установкам
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| * **** default settings# | *1234 default settings# |
| Ответ на команду | Комментарии |
|---|---|
| reset settings ОК | установлены заводские настройки |
| Возможные ошибки | Комментарии |
| reset settings. Wrong pass | неверный пароль |
Настройки
Установка периода отправки данных на сервер
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *period XXXX YYYYZ# | где XXXX – период отправки данных в домашней сети, мин. Значение по умолчанию: 10. YYYY – период отправки данных в роуминге 0 – отправка не производится. Z: min – отправка данных в роуминге по времени, k – отправка данных в роуминге по размеру пакета. Значения по умолчанию: ХХХХ – 10 мин , YYYYmin – 0 мин | *period 100 150k#, *period 50 150min#, *period 1000 0# |
| Ответ на команду | Комментарии |
|---|---|
| period changed to XXXX YYYY min period changed to XXXX YYYY kb period changed to XXXX. Roaming disabled | где XXXX – период отправки данных в домашней сети, мин; YYYY – период отправки данных в роуминге, мин XXXX – период отправки данных в домашней сети, мин; YYYY – размер пакета данных для отправки в роуминге, кБ XXXX – период отправки данных в домашней сети, мин; роуминг запрещен |
| Возможные ошибки | Комментарии |
| period. Wrong pass | неверный пароль |
| period. Wrong args | неверный формат команды |
Установка периода сбора данных
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *interval XXXX# | где XXXX – период сбора данных, сек 0 – блокировка сбора и передачи данных (значение таймера не изменяется). Возможные значения: от 15 до 240 сек | *interval 100# |
| Ответ на команду | Комментарии |
|---|---|
| interval changed to XXХ interval. Block enabled | где XXX – период сбора данных, сек блокировка включена |
| Возможные ошибки | Комментарии |
| interval. Wrong pass | неверный пароль |
| interval. Wrong args | неверный формат команды |
Установка объема топливного бака
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *volume XXX# | где XXX – объем бака, литры. Возможные варианты: от 0 до 65000 | *volume 100# |
| Ответ на команду | Комментарии |
|---|---|
| volume changed to XXХ | где XXX – объем бака, литры |
| Возможные ошибки | Комментарии |
| volume. Wrong pass | неверный пароль |
| volume. Wrong args | неверный формат команды |
Выбор параметров OBD, передаваемых в сообщении
Команда выбора параметров, начинается с obd и далее перечисляются параметры, передачу данных по которым нужно включить в SMS.
Текущий объем топлива рассчитывается в терминале на основании данных, полученных по шине OBD и установленного объема бака
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *obd speed voltage rpm fuel rate temp key engine# | где speed – скорость voltage – напряжение бортовой сети rpm – обороты двигателя fuel – объем топлива в баке (литры) rate – расход топлива temp – температура масла key – зажигание engine – индикации ошибки Check Engine off – отключение отправки всех параметров | *obd speed fuel# и *obd off# |
| Ответ на команду | Комментарии |
|---|---|
| obd. speed on, fuel on obd. Disable all | перечислены только те параметры, по которым будет производиться передача данных Передача производится по всем параметрам |
| Возможные ошибки | Комментарии |
|---|---|
| obd. Wrong pass | неверный пароль |
Включение / выключение отправки сообщения при извлечении терминала OBD из разъема
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *remove on# *remove off# | где on – включено off – выключено | *remove on#, *remove off# |
| Ответ на команду | Комментарии |
|---|---|
| remove on remove off | где on – включено off – выключено |
| Возможные ошибки | Комментарии |
| remove. Wrong pass | неверный пароль |
| remove. Wrong args | неверный формат команды |
Включение автоматической отправки сообщения при изменении положения ТС
Режим autotilt – включает режим tilt через 2 минуты после выключения зажигания без отправки SMS команды. Выключает режим tilt при включении зажигания. SMS отправляется пользователю с задержкой в 2 минуты, если за это время зажигание не было включено.
Команда отправляется только с одним параметром.
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *autotilt X# | где Х – уровень чувствительности off – отправка не производится on – включение отправки 1 – низкий 9 – высокий. При отправке команды без параметров режим будет включен с ранее установленной чувствительностью. Значение по умолчанию: 5 | *autotilt on# |
| Ответ на команду | Комментарии |
|---|---|
| autotilt on X autotilt. SMS on autotilt. SMS off | где Х – уровень чувствительности off – отправка не производится on – отправка включена 1 – низкий 9 – высокий |
Включение отправки сообщения при опасной езде
Опасная езда – последовательность ускорений и торможений в том числе в направлении перпендикулярном движению ТС возможно обусловленная быстрыми перестроениями ТС или резкой сменой направления движения
Команда отправляется только с одним параметром.
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *danger on# *danger off# *danger sms on# *danger sms off# *danger acc 5 или acc on или acc off# *danger turn 5 или turn on или turn off# *danger brake 5 или brake on или brake off# *danger vertacc 5 или vertacc on или vertacc off# | включение контроля опасного вождения выключение контроля опасного вождения включение sms оповещения по выбранным параметрам выключение sms оповещения по выбранным параметрам установка порога разгона установка порога бокового ускорения установка порога торможения установка порога вертикального ускорения пороговые значения от 1 (низкий) до 9 (высокий) | *danger on#, *danger sms off#, *danger acc 1#, *danger turn 1#, *danger brake 1#, *danger vertacc 1# |
| Ответ на команду | Комментарии |
|---|---|
| danger on danger. sms on danger. sms off danger. acc on - 5 danger. brake off | контроль опасной езды включен sms оповещение включено sms оповещение выключено контроль порога разгона включен и установлен равным 5 контроль порога торможения выключен |
Включение отправки сообщения при возникновении аварийной ситуации
Аварийная ситуация – резкое торможение или ускорение возможно в следствии аварии ТС
Команда отправляется только с одним параметром.
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *crash on# *crash off# *crash sms on# *crash sms off# *crash acc X# *crash turn X# *crash brake X# | включение контроля аварий выключение контроля аварий включение sms оповещения по выбранным параметрам выключение sms оповещения по выбранным параметрам установка порога разгона установка порога бокового ускорения установка порога торможения X – пороговые значения от 1 (низкий) до 9 (высокий) | *crash on#, *crash sms off#, *crash acc 1#, *crash turn 1#, *crash brake 1# |
| Ответ на команду | Комментарии |
|---|---|
| crash on crash. sms on crash. sms off crash. acc on - 5 crash. brake off | контроль аварий включен sms оповещение включено sms оповещение выключено контроль порога разгона включен и установлен равным 5 контроль порога торможения выключен |
Запрос настроек параметров
Запрос информации об устройстве
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *info?# | *info?# |
| Ответ на команду | Комментарии |
|---|---|
| info: SW Dev XXXXXXX HW Dev YYYYYY time ДД-ММ-ГГГГ ЧЧ:мм | где XXXXXXX – версия прошивки ДД-ММ-ГГГГ ЧЧ:мм – время в устройстве |
Получение справки о командах
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *?# | Запрос перечня команд | *?# |
| Ответ на команду | Комментарии |
|---|---|
| help: info, period, interval, volume, obd, remove, autotilt, danger, crash, balance, dervice, gps | список команд без параметров |
Запрос установленного периода отправки данных на сервер в домашней сети и в роуминге
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *period?# | *period?# |
| Ответ на команду | Комментарии |
|---|---|
| period: home XXXXmin roam YYYYmin | где XXXX – период отправки данных в домашней сети, мин YYYY – период отправки данных в роуминге, мин |
Запрос установленного периода сбора данных
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *interval?# | *interval?# |
| Ответ на команду | Комментарии |
|---|---|
| interval: XХХХ | где XXXX – период сбора данных, сек |
Запрос установленного объема топливного бака
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *volume?# | *volume?# |
| Ответ на команду | Комментарии |
|---|---|
| volume: XXX | где XXX – объем топливного бака, л |
Запрос параметров OBD, передаваемых в сообщении
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *obd?# | *obd?# |
| Ответ на команду | Комментарии |
|---|---|
| obd speed X voltage X rpm X fuel X rate X temp X key X engine X | где Х – on (включено) / off (выключено) |
Запрос текущих значений
Запрос баланса
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *balance,*100## | где *100# – код запроса баланса, который зависит от оператора | *balance,*102## |
| Ответ на команду | Комментарии |
|---|---|
| balance: ХХХ | ХХХ – текущий баланс активной SIM-карты |
Пробег с момента сброса ошибки, км
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *service# | *service# |
| Ответ на команду | Комментарии |
|---|---|
| service: distance XXXX time YYYY | где XXXX – пробег с момента сброса ошибок, км |
Запрос текущих параметров GPS
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *gps# | *gps# |
| Ответ на команду | Комментарии | Пример |
|---|---|---|
| gps sats X speed YYY point ZZZZ,NNNN | где X – количество спутников YYY – скорость ZZZZ,NNNN – координаты в формате ссылки | GPS: sats - 5, speed - 69, point: http://google.com/maps?q=55.7885,37.5891 |
| Возможные ошибки | Комментарии | |
| GPS. No valid data | не удалось получить данные GPS |
Запрос текущих параметров OBD
| Текст команды в SMS | Комментарии | Пример |
|---|---|---|
| *obd# | *obd# |
| Ответ на команду | Комментарии |
|---|---|
| obd: текущие значения | текущие значения отображаются в зависимости от настроек. Значение объема топлива в процентах от установленного объема бака. Формат отображения объема топлива зависит от типа ТС |
Уведомления по событиям
Сообщения отправляются на телефон владельца после фиксации события.
| Событие | Содержание SMS | Описание события |
|---|---|---|
| remove | remove текущее дата и время GPS координаты в формате ссылки | извлечение терминала из разъема |
| danger | danger текущее дата и время GPS координаты в формате ссылки | опасная езда |
| crash | crash текущее дата и время GPS координаты в формате ссылки | авария |
