Список SMS команд
1. Сокращения и обозначения
- PIN - четырёхзначный пароль маяка, состоящий из цифр от 0 до 9.
Для того чтобы запросить у маяка информацию или настроить его, используйте команды, указанные в таблице. Их нужно отправлять на номер SIM-карты, установленной в маяке, в виде текстового SMS-сообщения.
По умолчанию все команды SMS доступны с номера владельца M1 без ввода пароля.
Включить запрос пароля с номера владельца можно SMS командой PIN ПАРОЛЬ+
- P - обозначение параметра резервного телефона для оповещения.
- РУС: Р, ЛАТ: P
- Есть следующие способы задания параметра:
- пусто - включить M1, выключить P
- P - включить M1, включить P
- Оповещения на M1 идут всегда, когда они включены. Оповещение на P возможно только как дополнительное
- [ ] - параметр, указанный в квадратных скобках, является необязательным и может быть пропущен. При этом, если он не указывается, то при обработке команды его значение остается неизменным
- "+" - включить
- "-" - выключить
- "?" - запросить состояние
2. Особенности
Соединение с сервером — каждый раз при установке соединения с сервером и в процессе его поддерживания устройство передает сообщение со своим состоянием: баланс, заряд батареи, данные о местоположении
Передача данных на сервер — M25 устанавливает соединение с сервером и передает данные всегда, когда включен GSM. В отсутствии связи с сервером данные сохраняются в черный ящик
GPS мониторинг — включение GPS для определения координат управляется настройкой мониторинга
3. Алгоритм обработки SMS
3. 1 Общие принципы
Регистр букв, а также отсутствие пробелов или наличие лишних пробелов между параметрами команды не влияет на её выполнение.
- Пароль, команда и параметры в SMS могут разделяться пробелами или писаться слитно. Примеры равнозначных записей:
- 1234T12:0025.02.2024+3 и 1234 T 12:00 25.02.2024 +3
- 1234D+ и 1234 D +
- 1234D- и 1234 D -
- 1234D? и 1234 D ?
- Каждый отдельный параметр пишется слитно без пробелов
- В одном SMS могут быть переданы несколько команд, разделенных точкой с запятой
-
Аудиоконтроль включается звонком на устройство. Если вызов выполнен с телефона М1/P, то устройство берет трубку и включает аудиоконтроль, если номер неизвестный, то звонок сбрасывается.
3.2 Требования к вводу пароля
- После установки номера владельца (командой PIN+) все команды доступны только с паролем
- Если для M1 или Р отключить требование пароля (командой PIN P-), то все команды будут доступны для этого номера без пароля. Вариант ввода команды с паролем по-прежнему допускается, при этом проверка пароля на правильность выполняется
- Для гостевых номеров пароль требуется всегда
3.3 Порядок обработки ошибок
- Если неправильно задан пароль с гостевого номера, то ответ не отправляется. После получения трех подряд неправильно введенных паролях обработка входящих SMS блокируется на 10 минут.
- Если неправильно задан пароль с номеров M1 и Р, то в ответ отправляется сообщение "Неправильный пароль". После трех подряд неправильно введенных паролях с любой комбинации M1 и Р (но не с гостевых) на четвертый и далее неправильный пароль ответное SMS не отправляется до тех пор, пока однажды пароль не будет введен правильно
- Если пароль задан верно (или отключен для M1 или Р), а команда задана неверно, то отправляется ответное SMS "Неправильная команда". После трех подряд неправильно введенных командах на четвертую и далее ответные SMS не отправляются до тех пор, пока однажды не будет дана правильная команда
3.4 Несколько команд в одном SMS
В одном SMS могут быть переданы несколько команд. Для этого:
- Команды должны разделяться символом точка с запятой
- Пароль, если требуется (см. 3.2), вводится перед первой командой. Если его нет, то все сообщение считается недействительным и на него формируется ответ в соответствии с порядком обработки ошибок (3.3)
- Команды выполняются последовательно в порядке, указанном в SMS слева направо
- Ответное SMS формируется одно на все команды
- Ответное SMS на команды вместе с 'ПЕРЕЗАГРУЗКА' ('RESTART') не отправляется
3.5 Ответные SMS
- Ответное SMS на команды настройки содержит всю настройку целиком, а не только те поля, которые были изменены командой. Например:
- Отправленное SMS: B1 20:10
-
Ответ:
Активация 20:10 11.03.2024(+3), ожидание команд Будильник 1: 20:10 10.03.2024(+3), период 1Д, ожидание команд Будильник 2: 03:00 01.01.2012, период 7Д, SMS на M1 и Р с GPS/LBS, текст
- Каждое ответное SMS заканчивается текстом "SMS #", с порядковым номером сообщения с момента включения питания.
4. Список SMS
- Параметры в таблице приведены в виде "X (Y)", где X - русская буква, Y - латинская буква
Действие |
Пример команды | Описание |
|
Кириллица | Латиница | ||
Получение сообщения с координатами в стандартном формате |
PIN * | PIN * |
Пример: 1234 * |
Получение сообщения с координатами в расширенном формате |
PIN # PIN ПОЛН |
PIN # PIN FULL |
Ответное SMS содержит:
Пример 1234 ПОЛН Ответное SMS: |
Включение режима тревоги |
PIN ! PIN А PIN ТРЕВОГА |
PIN ! PIN А PIN ALERT |
В устройстве предусмотрено два режима работы:
Пример: 1234 ТРЕВОГА Ответное SMS: Режим тревоги вкл. |
Включение нормального режима |
PIN − PIN Н PIN НОРМ PIN НОРМАЛЬНЫЙ |
PIN − PIN N PIN NORM PIN NORMAL |
Пример: 1234 НОРМ Ответное SMS: Нормальный режим вкл. |
Управление режимом уведомления о движении |
PIN Д |
PIN D |
PIN D [+/-/?] Параметр +/-/? не обязателен
Пример: 1234 Д+ Ответное SMS: Датчик движения: вкл. |
Настройка параметров режима уведомления о движении |
PIN Д СМ |
PIN D SM |
По умолчанию маяк настроен на отправку SMS-сообщений при начале движения без контроля метки и интервал отправки повторного сообщения 15 минут. Формат изменения настроек с помощью SMS-сообщений : PIN D [+/-] [уведомление[!]] [интервал][.уровень] [P][+/-]
[уведомление] — реакция маяка на начало движения • • • • • • • • [интервал] — время в минутах (целое число от 1 до 120): • задержка выдачи повторного SMS-сообщения о начале движения • продолжительность передачи данных на сервер мониторинга после остановки автомобиля P - дублировать оповещение на P [.уровень] (чувствительность датчика движения):
Пример: 1234 Д+ С! М 10.2 Ответное SMS: Датчик движения: вкл. |
Установка номера владельца М1 |
PIN + |
PIN + |
PIN +[номер телефона] [P] P - запись резервного телефона для оповещения Примечание: Установка телефона M1 (т.е. команда без указания P) стирает телефон в ячейке P. Примеры:
|
Установка пароля |
PIN Р PIN ПАРОЛЬ PIN P 5678 PIN P - |
PIN P PIN PASSWORD PIN P 5678 PIN P - |
PIN P [новый пароль] [+/-] + (плюс) — включение пароля для SMS с телефона владельца – (минус) — отключение пароля для SMS с телефона владельца
Пример: 1234 ПАРОЛЬ 4321 - Ответное SMS: Пароль: 4321 |
Установка текущих даты и времени |
PIN Т PIN T 12:00 |
PIN T PIN T 12:00 |
PIN T [время] [дата] [часовой пояс]
Пример: 1234 T 18:45 31.07.2024 +3 Ответное SMS: Дата и время: 18:45 31.07.2024(+3) |
Установка даты, времени и режимов работы будильника |
PIN В1 12:00 PIN В2 4.10.12 |
PIN B1 12:00 PIN B2 4.10.12 |
PIN B1 [время] [дата] [интервал] [формат] [P] PIN B2 [время] [дата] [интервал] [формат] [P] где: B1 - будильник 1, B2 - будильник 2 [дата] — дата начального срабатывания будильника в формате ДД.ММ.ГГГГ (ДД — день, двузначное число от 01 до 31, ММ — месяц, двузначное число от 01 до 12, ГГГГ — год, четырехзначное число от 2024 до 2100). В указанную дату маяк в первый раз перейдет из «спящего» состояния в активное и отправит сообщение с координатами. По умолчанию дата начального срабатывания будильников установлена на 1 января 2024 года; [интервал] — период между пробуждениями маяка в формате минут, часов, дней (без пробелов): • от 01М до 59М (рус., англ.) для интервала в минутах • от 01Ч до 23Ч (рус.), от 01Н до 23H (англ.) для интервала в часах • от 01Д до 30Д (рус.), от 01D до 30D (англ.) для интервала в днях Интервал отсчитывается с момента первого пробуждения, заданного временем и датой начального срабатывания. Допускается указывать интервал, включающий одновременно минуты, часы и дни (в произвольном порядке без пробелов, например, 3Д10Ч) [формат] — вид действий, которые выполняются при пробуждении маяка: • • • • • Может быть комбинация любых из перечисленных действий. Режим ожидания команд подразумевается в любом из остальных действий. P - дублировать оповещение на P Если в SMS указано только время начала, без даты, то принимается ближайшее возможное в будущем время. Например, если сейчас 16:30, а время начала задается как 15:00, то установить время начала на 15:00 следующего дня
Пример: 1234 B1 13:40 22.05.2024 1Д Л Ответное SMS: Активация 13:40 01.08.2024(+3), SMS на M1 с GPS/LBS, интернет-ссылка |
Управление будильником |
PIN В1+ PIN В2- |
PIN В1+ PIN В2- |
PIN B1 [+/-/?] B1 - будильник 1 B2 - будильник 2
Пример: 1234 B2- Ответное SMS: Активация 13:40 01.08.2024(+3), SMS на M1 с GPS/LBS, интернет-ссылка |
Настройка формата сообщений |
PIN Ф ЛТ |
PIN F LT |
PIN F [формат] [формат] — вид сообщений с координатами ГЛОНАСС/ GPS/GSM, высылаемых при пробуждении маяка: • • • Для получения информации о текущих настройках формата сообщений:
Пример: 1234 Ф Т Ответное SMS: Формат SMS с координатами: текст |
Установка номера запроса баланса и порога предупреждения |
PIN М |
PIN М |
PIN M [номер запроса] [порог предупреждения] заводское значение порога предупреждения 50 Пример: 1234 M #100# 30 Ответное SMS: Телефон запроса баланса: #100# |
Запрос баланса |
PIN М PIN М? |
PIN М PIN М? |
Пример: 1234 M? Ответное SMS: Телефон запроса баланса: #100# |
Настройка доступа к Интернету |
PIN И |
PIN I |
PIN I APN [логин] [пароль] 1234 i intermet.mts.ru mts mts Ответное SMS: Настройки мобильного интернета |
Запрос настройки доступа к Интернету |
PIN И PIN И? |
PIN I PIN I? |
Пример: 1234 и? Ответное SMS: Настройки мобильного интернета |
Настройка имени маяка |
PIN ИМЯ MyCar |
PIN NAME MyCar |
Если установлено имя маяка, то каждое SMS сообщение начинается с него. Пример: 1234 имя MyCar Ответное SMS: Имя маяка: MyCar |
Управление режимом мониторинга |
PIN МОН + |
PIN MON + |
PIN MON [статус]
После отправки команды МОН+ пока устройство активно, оно постоянно определяет координаты и передает их на сервер. Если отправили МОН-, то передача работает только по событиям, например по датчику движения. Пример: 1234 МОН+ Ответное SMS: Мониторинг вкл. всегда |
Запрос текущих настроек |
PIN ПАРАМЕТРЫ |
PIN PARAMS |
Отображает данные:
Пример: 1234 Параметры Ответное SMS: Дата и время: 17:50 06.08.2024(+3) |
Сброс настроек на заводские |
PIN СБРОС |
PIN RESET |
Команда сброса настроек восстанавливает заводские значения всех настраиваемых параметров маяка (кроме номера владельца). Отмена результатов проведения данной операции невозможна! После Пример: 1234 Сброс Ответное SMS: Дата и время: 16:37 01.08.2024(+3) |
Обновление прошивки |
PIN ПЕРЕПРОШИВКА |
PIN FWUPDATE |
Пример: 1234 Перепрошивка Ответное SMS: Начато обновление ПО. Выполняется подключение к серверу обновления |
Запрос сервисных данных | PIN ИНФО | PIN INFO |
Отображение информации:
|
Отправка USSD-запроса |
PIN УССД #100# | PIN USSD #100# |
PIN USSD [запрос] Ответ оператора пересылается на номер, с которого была получена команда |
Отправка отчета о работе маяка | PIN ОТЧЕТ |
PIN REPORT PIN LOGLOAD |
После получения команды устройство отправляет SMS ответ о начале выгрузки отчета пользователю, выполняет соединение с сервером и выгружает отчет. Пока процесс не завершен устройство не может перейти в сон. После завершения загрузки устройство отправляет SMS о завершении пользователю и будет активно еще 5 минут
Пример: 1234 Отчет Ответное SMS: Выгрузка логов на сервер начата. Процесс может занять 4 часа. |
Перезагрузка маяка | PIN ПЕРЕЗАГРУЗКА |
PIN RESTART |
|
Получение справки по командам управления | PIN ПОМОЩЬ PIN ? |
PIN HELP |
Пример: 1234 помощь Ответное SMS: Список команд (вместо PIN введите пароль) |
Перевести маяк в режим настройки | PIN НАСТРОЙКА |
PIN SETTING |
PIN SETTING +/-/S
Завершение настройки:
Примечание:
|
Запись телефона SMS-центра |
PIN SMSCENTER xxx |
Пример: 1234 SMSCENTER +79112009993 Ответное SMS: Телефон SMS-центра: +79112009993 |
|
Установить приоритетную SIM-карту |
PIN SIMMAIN |
По умолчанию приоритетная SIM1
|
|
Управление режимом регистрации | PIN РЕГ |
PIN REG |
PIN REG [статус]
Примечание:
Пример: 1234 рег Ответное SMS: Внимание! Выполнен вход в режим регистрации |
Запрос регистрации на сервере |
PIN 00581 PIN ПИНКОД
|
PIN 00581 PIN PINCODE |
Пример: 1234 пинкод Ответное SMS: Код регистрации на сервере starline.online: 12345678 |
Запрос списка телефонов, записанных в память устройства |
PIN ТЕЛ PIN ТЕЛЕФОНЫ |
PIN TEL PIN PHONES |
Пример: 1234 тел Ответное SMS: M1: +79112345678 |
Запись адреса сервера мониторинга | PIN СЕРВЕРМОН | PIN SERVERMON |
PIN SERVERMON [Adr] [Port]
Пример: 1234 сервермон gategen6.starline.ru 9876 Ответное SMS: Сервер мониторинга: gategen6.starline.ru 9876 |
Запись адреса сервера регистрации | PIN СЕРВЕРРЕГ | PIN SERVERREG |
PIN SERVERREG [Adr] [Port]
Пример: 1234 серверрег gategen6.starline.ru 1235 Ответное SMS: Сервер регистрации: gategen6.starline.ru 1235 |
Управление мобильным интернетом |
PIN 00550 PIN GPRS- PIN 00551 PIN GPRS+ PIN GPRS? |
PIN GPRS+/-/?
Пример: 1234 GPRS? Ответное SMS: Качество GSM-сигнала: отл. (29) |
|
Управление мобильным интернетом в роуминге |
PIN 00523 PIN 00524
|
PIN 00523/00524
|
|
Сброс GSM-модема | PIN СБРОСМОДЕМА |
PIN 009900 PIN GSMRESET |
Пример: 1234 сбросмодема Ответное SMS: Команда "Cбросить GSM-модуль" выполнена |
Управление пересылкой входящих SMS | PIN ПЕРЕСЫЛКА |
PIN 0069X PIN FORWARD |
PIN FORWARD X
Установка времени, в течение которого выполняется пересылка всех входящих SMS с незарегистрированных телефонов и USSD от оператора связи на телефон M
Пример: 1234 пересылка 60 Ответное SMS: Команда "Установка времени пересылки входящих сообщений на M1" выполнена |
Управление периодом проверки соединения с сервером | PIN СЕРВЕРПИНГ | PIN SERVERPING |
PIN SERVERPING X/?
Пример: 1234 серверпинг? Ответное SMS: Период проверки соединения с сервером: 60 с |