SMS и TCP команды для управления терминалами МТ-900
SMS-канал управления используется в случае невозможности локальной или удаленной настройки, а также для дистанционного управления выходами Терминала и контроля состояния Терминала при отсутствии компьютера.
Телефон, с которого отправляются команды, должен быть внесен в список разрешенных номеров в настройках Терминала (раздел «Настройки «Белый список номеров» ).
Все команды вводятся только латинскими буквами, параметры (если есть) отделяются пробелом и перечисляются через запятую.
Список, синтаксис и порядок работы с TCP командами аналогичен SMS командам за исключением того, что TCP команды отправляются из ПО мониторинга, а не с телефона.
| Команда | Назначение | Параметры | Ответ Терминала | Пример запроса | Пример ответа | Примечание |
| Test | проверка связи с Терминалом | отсутствуют | серийный номер(версия), напряжение внешнего питания, напряжение аккумулятора, настройки энергосбережения, настройки APN, настройки Сервера, тип используемого протокола и размер неотправленных данных | test | id(test): 1.1.1.1; Pwr:24.6,4.4; OFF:8.0; APN:internet,,; SRV:1.1.1.1:6600, ScoutData;Unsent:0 | Напряжение передается умноженным на 10, например, 118 означает 11,8 вольт. Для встроенного аккумулятора критическое напряжение – 3,5 вольт |
| Reboot | принудительная перезагрузка Терминала | отсутствуют | reboot | id(reboot): OK | ||
| Portconfig | запрос настроек порта | номер порта согласно описанию | порт: вид сигнала (тип данных) | portconfig 0 | id(portconfig): P0: PeakDetector (VLT) | |
| Getport | запрос состояния порта | номер порта согласно описанию | порт: состояние порта (значение) | getport 0 | Id(getport): P0: PeakDetector=0 | |
| Setport | установка состояния порта (для дискретных выходов) | номер порта согласно описанию | OK*, Invalid params** |
setport 4,1 | id(setport): OK | *если порт поддерживает установку состояния, ** если порт не поддерживает установку состояния |
| Setdefault Settings | установка заводских значений | отсутствуют | OK | setdefaultsettings | id(setdefaultsettings): OK | |
| Setserver1 | установка параметров Сервера 1 |
до прошивки 3.2 протокол, канал (gsm, wifi), IP-адрес Сервера, порт, шифрование, тип подключения. начиная с прошивки 3.2.: протокол, канал (gsm, wifi), IP-адрес Сервера, порт, шифрование, тип подключения, тип идентификатора, пороги подключений |
OK*
Execute Imposible** |
до 3.2: Setserver1 scoutdata,gsm,g7.scout-gps.ru,6700,crypto:0,m начиная с 3.2: Setserver1 scoutdata,gsm,g7.scout-gps.ru,6700,crypto:0,m, или Setserver1 scoutdata,gsm,g7.scout-gps.ru,6700,crypto:0,m, |
id(setserver): OK
|
*параметры изменены
**если параметры Сервера заданы некорректно. Протокол - scoutdata, scoutopen2, wialonips, egts; Канал - gsm, wifi; Шифрование - 1 - вкл., 0 – выкл.; Тип подключения - m – основной, d – дублирующий, r - резервный, c - конфигурационное; Тип идентификатора - id, imei
Пороги подключения последовательно (настраивать необязательно!)
|
| Setserver2 | установка параметров Сервера 2 | |||||
| Setserver3 | установка параметров Сервера 3 | |||||
| Testserver1 | запрос параметров Сервера 1 |
отсутствуют
|
канал передачи данных, номер Сервера, протокол, шифрование, тип Сервера, объем непереданных данных
|
Testserver1 | id(testserver1): WIFI,SRV:1.1.1.1:6600,ScoutData,encryption:0,m,unsent:0 |
Протокол - scoutdata, scoutopen2, wialonips, egts;
Канал - gsm, wifi; Шифрование - 1 - вкл., 0 – выкл.; Тип подключения - m – основной, d – дублирующий, r - резервный. |
| Testserver2 | запрос параметров Сервера 2 | Testserver2 | id(testserver2): WIFI,SRV:1.1.1.1:6600,ScoutData,encryption:0,d,unsent:0 | |||
| Testserver3 | запрос параметров Сервера 3 | Testserver3 | id(testserver3): WIFI,SRV:1.1.1.1:6600,ScoutData,encryption:0,d,unsent:0 | |||
| Setid | установка ID Терминала | ID Терминала | OK | setid 123456 | id(setid): OK | |
| Setcalibration | включение режима калибровки на 5 минут | отсутствуют | OK | Setcalibration | Id(setcalibration):OK | |
| Setapn | установка параметров точки доступа GPRS | логин, пароль, APN | OK | setapn mts,mts,internet.mts.ru | id(setapn): OK | Для установки пустых значений: setapn ,, |
| Connect | немедленное подключение к Серверу и полная выгрузка журнала данных | нет | processing OK failed via … |
connect | Id(connect): SRV1: processing, SRV2: processing, SRV3: off Id(connect): SRVx, connect OK Id(connect): SRVx, connect failed Id(connect): SRVx, connect via SRVy |
|
| SetNetRule | возможность удаленной настройки правил GSM | номер правила, номер SIM-карты, код оператора |
OK | setnetrule 1,1,25002 | id(setnetrule): OK | номер правила (1-6), номер SIM-карты (1), код оператора (0-99999), при этом значение 1 указывает на возможность регистрации только в домашней сети, значение 2 – в любой |
| Clearlog | очищает журнал телеметрии | нет | OK | ClearLog | id(Clearlog): OK | |
| GetImei | запрос Imei-номера модема терминала | нет | id(getimei): imei | GetImei | id(getimei): 123456789012345 | |
| LinearCalibrate | линейная калибровка акселерометра | angle - угол в статистической системе координат. Если угол не задан - Терминал сбрасывает линейную калибровку. | OK Impossible Error |
LinearCalibrate 0 | Id(linearCalibrate): Оk Id(linearCalibrate): impossible |
Если угол задан - линейная калибровка устанавливается в соответствии с заданным углом. |
| GetAcceleration | запрос состояния акселерометра | нет | Id(getacceleration):accel(acc), angle(ang),current(Xc,Yc,Zc), horizon(Xh,Yh,Zh),line(Xl,Yl,Zl) |
getacceleration | ID(getacceleration): angle(4), current (-59,52,1039), horizon(14,-22, 1044), line(not calibrated) |
ID – идентификатор Терминала acc – текущее линейное ускорение (отсутствует, если не проведена линейная калибровка) ang – угол наклона к горизонту (отсутствует, если не установлен горизонт) Xc,Yc,Zc – текущие «сырые» показания акселерометра по трем осям Xh,Yh,Zh – вектор калибровки горизонта по трем осям, если калибровка не произведена = not calibrated Xl,Yl,Zl – вектор калибровки линейного ускорения по трем осям, если калибровка не произведена = not calibrated (отсутствует, если не установлен горизонт) |
| GetAccelgage | запрос значения параметра Порог определения вибрации порта акселерометра | нет | ID(GetAccelgage) state, threshold | getaccelgage | ID(getaccelgage): line detect, 5 | state – состояние калибровки: not calibrate – горизонт не установлен line detect – горизонт установлен, определяется направление линейного ускорения calibrate – горизонт установлен, направление линейного ускорения определено threshold – порог определения вибрации impossible - невозможно выполнить. акселерометр не отвечает или не установлен горизонт, Error - не установлен горизонт |
| SetAccelgage | установка значения параметра Порог определения вибрации порта акселерометра | значение порога | ОК | SetAccelgage 15 | id(setaccelgage): OK | |
|
Setwhitelist |
возможность внести в белый список номер телефона начиная с прошивки 2.8 можно указывать порядковый номер от 1 до 4. |
номер телефона | ОК FAIL |
До 2.8. Setwhitelist +79997170944 После 2.8: Setwhitelist +79997170944,2 |
id(setcalibration):OK Id(setcalibration):fail |
|
|
Начиная с прошивки 2.8. Showwhitelist |
Запрос текущего белого списка |
ОК FAIL |
Showwhitelist |
id(showwhitelist):1: +79997170944; 2: ; 3: ; 4: ; OK Id(showwhitelist):fail |
||
|
Начиная с прошивки 2.8. Clearwhitelist |
Очищает белый список |
ОК FAIL |
Clearwhitelist |
id(clearwhitelist):OK |
||
|
Начиная с прошивки 2.9. SetIndication |
Настройка источника индикации (внешний зуммер, зуммер терминала, driverID) |
SetIndication param, где param:
|
SetIndication DO1; |
id(setindication):OK id(setindication):Invalid params
|
||
| CheckCalibration | проверка калибровки акселерометра | нет | ID(CheckCalibration):horizon: resultH (causeH); linear: resultL (causeL); | CheckCalibration | ID(CheckCalibration): horizon: ок (line 22, side 27); linear: ок(angle 3.25) | resultH, resultL - результаты для калибровки горизонта и линейной калибровки соответственно: ок - калибровка в порядке warning - калибровка на границе допустимого диапазона fault - калибровка вне допустимого диапазона causeH - причина результата калибровки горизонта: not calibrated - калибровка не произведена out of range - вектор горизонта вне допустимого диапазона angle A - угол между вектором горизонта и текущим вектором (если линейная калибровка не произведена) line L, side S - ложная добавка к линейному и боковому ускорениям вносимая вектором гравитации (если линейная калибровка произведена) causeL - причина результата линейной калибровки: not calibrated - калибровка не произведена angle A - угол между вектором линейной калибровки и вектором линейной статистики |
| Horizon | установка уровня горизонта | нет | ОК | Horizon | ID(horizon): OK | |
| Testmemory | тестирование работоспособности страниц памяти | нет | ID(testmemory): Test has been completed in X sec, sectors total: Y, errors detected: Z | testmemory | 806503(testmemory): Processing… 806503(testmemory): Test has been completed in 38 sec, sectors total: 512, errors detected: 0 |
Х – количество проверенных страниц, Y – количество найденных ошибок, Z – затраченное на выполнение команды время |
| Setodm | установка показаний одометра | Целевые показания одометра | ОК | Setodm 167,7 | Id(setodm): OK | |
| SetEnergySave | включение режима энергосбережения | включить(1)/выключить(0) энергосберегающий режим на стоянках, порог включения режима минимального потребления (в вольтах), период пробуждения (в сек, включить (1)/выключить (0) режим работы «маяк» | OK | setenergysave 1,10.5,3600,0 | id(setenergysave): OK | При настройках энергосбережения, разрешающих отключения Терминала, Терминал может уйти со связи (уснуть) после получения смс, если выполнены соответствующие условия. |
| Getregstat | запроса состояния регистрации в сети | нет | Код оператора, состояние регистрации, lac, cid | getregstat | id(getregstat): 25002;GSM:home,lac:0x1E7D,cid:0x16CB;GPRS:home,lac:0x1E7D,cid:0x16CB | состояние регистрации может быть: not registered - нет регистрации, поиск сети неget зарегистрирован в домашней сети searching - нет регистрации, идет поиск сети denied - регистрация отклонена оператором unknown - неизвестное состояние регистрации roaming - зарегистрирован в роуминге |
| Setpassword | установка пароля для защиты Терминала | пароль | ОК | setpassword qwerty123 | id(setpassword): OK | |
| AutoHorizon | установка автоматического горизонта | нет | ОК | AutoHorizon | id(AutoHorizon): OK | |
| SendLogAgain | повторный запрос журнала телеметрии | нет | ОК | sendlogagain | id(sendlogagain): OK | |
| GetModem | запрос строки идентификация модема | нет | строка идентификации модема | getmodem | id(getmodem): Quectel_Ltd | |
| GetSim | запрос информации о sim-карте | нет | строка идентификации sim-карты | getsim | id(getsim): sim0^ imsi:250011784792566,iccid89701012417847925665 | |
| SetDatum | выбор модели Земли в навигационном приемнике | W84/P90 | OK*, Invalid params** |
Setdatum W84 | id(setdatum): OK | |
| CrashSensor | настройка датчика ДТП | 1 значение: столкновение:порог по осям X,Y; 2 значение: столкновение:порог по оси Z; 3 значение: сильное столкновение:порог по осям X,Y; 4 значение: сильное столкновение:порог по оси Z; |
OK*, Invalid params** |
crashsensor 2000,2000,2000,2000 | id(crashsensor): OK |