Как отправить USSD запрос и управлять устройством через SMS-команды АвтоГРАФ

Что такое USSD запрос и зачем его отправлять с бортового контроллера

USSD (Unstructured Supplementary Service Data) — это протокол для передачи коротких текстовых сообщений в реальном времени, работающий напрямую с сетью оператора. В отличие от SMS, USSD-запрос не хранится на телефоне, а сессия длится только во время обмена данными. Для систем мониторинга транспорта возможность отправить USSD запрос с трекера критически важна, когда нет уверенного GPRS-соединения. Например, при выезде за город или в зоне плохого покрытия интернета вы всё ещё можете проверить баланс SIM-карты, остаток пакетов или активировать услугу «Интернет на день». Команда выполняется мгновенно, и ответ приходит в виде SMS на ваш мобильный телефон. В контроллерах АвтоГРАФ поддержка USSD появилась, начиная с прошивок, совместимых с серийными номерами 10020 и выше. Инструкция подходит для всех моделей: AD-400, AD-500, Galileo, GT.

Полный список SMS-команд для управления устройством

Все команды отправляются на номер SIM-карты, установленной в контроллере. Ответ приходит на номер отправителя. Пароль (8 символов) задаётся в программе GSMConf.exe. Если пароль короче — дополните пробелами.

1. GET — получить текущие координаты

Ответ: 10020@ A,4805.8021,N,01132.2243,E,1.9,183.8,270302 (широта, долгота, скорость, направление, дата).

2. SET — установить периоды записи и отправки

Первый параметр — период записи в секундах (данные в память), второй — период отправки по GPRS. Ответ: 10020@5,30.

3. CHG — полное изменение настроек

Устанавливает IP сервера, порт, период записи, период отправки, режим адаптивной записи (0 — адаптивный, 1 — по времени).

4. USSD — отправить USSD запрос (баланс, услуги)

Ответ: 10020@ussd:125.18 или текст ответа оператора. Команда работает для всех операторов РФ.

5. Дополнительные команды для устройств с серийными номерами 11253 и выше

• SOUT [пароль] [0/1] — управление выходом «открытый коллектор» (0 — закрыт, 1 — открыт).
• PULSE [пароль] [сек] — выдать импульс длительностью 1–10 секунд.
• SANI [пароль] [сек] — установить период записи аналоговых данных (5–3600 с).
• SCOUNT [пароль] [сек] — период записи счётчиков.
• GANI [пароль] — получить значения аналоговых входов.

6. Команды для серийных номеров 17925 и выше

• RESET [пароль] — аппаратный сброс контроллера (перезагрузка процессора, GSM, GPS).
• APN [пароль] "APN","USER","PWD" — изменить настройки GPRS (точка доступа, логин, пароль).

Формат SMS-команды и общие правила

Команды GET, SET, CHG, USSD и перечисленные выше дополнительные инструкции относятся к устройствам с ранними прошивками. Начиная с прошивки v.5.0 (серийные номера от 32500) набор команд расширен, а большинство из них имеет вид password COMMAND=параметры;. Ответ устройства совпадает с самой командой, а запрос текущего значения выполняется той же командой с префиксом G — например, GPERIODWR. Исключение составляют команды GET и RESETUSSD: они отправляются без знака равенства.

Правила, без которых команда не выполнится:

• Пароль. Задаётся в устройстве программой GSMConf.exe. Длина поля пароля в SMS-команде обязательно должна быть 8 символов — если при настройке пароль был короче, дополните его пробелами.
• Регистр. Все команды набираются только заглавными латинскими буквами.
• Разрешённый номер. Устройство принимает команды лишь с номера, внесённого в список разрешённых в настройках контроллера. Сообщения с посторонних номеров игнорируются.
• Ответ. Ответное SMS отправляется только при полном совпадении команды с форматом и паролем прибора. В любом другом случае сообщение не обрабатывается.

Если базовая станция оператора поддерживает GPRS, в ответе после серийного номера появляется индикатор GPRS:. Например, 33200#GPRS:PERIODWR=5; — передача данных возможна, а 33200#PERIODWR=5; — GPRS недоступен. Если прибору присвоено имя (alias), оно выводится между серийным номером и знаком #: 33200(Kamaz)#GPRS:PERIODWR=5;.

Полный перечень команд АвтоГРАФ (прошивка v.5.0)

Ниже приведены основные команды прошивки v.5.0 и выше с кратким назначением — они сгруппированы по задачам настройки.

Основные команды управления

• GET — запросить текущее местоположение и направление движения.
• RESET — выполнить аппаратный сброс устройства (перезагрузка).
• USSD — отправить USSD-запрос оператору сотовой связи.
• GCHANGE — получить лог последних изменений настроек, выполненных через SMS.

Настройка периодов передачи данных

• PERIODWR — интервал записи данных в память.
• PERIODCOUNT12 — период записи для счётчиков 1 и 2.
• PERIODCOUNT34 — период записи для счётчиков 3 и 4.
• PERIODANALOG — интервал записи аналоговых данных.
• PERIODSEND — периодичность отправки данных на сервер.

Сетевые и общие параметры

• IP — IP-адрес сервера мониторинга.
• PORT — порт подключения к серверу.
• ALIAS — имя прибора для идентификации.
• APNFULL — настройки точки доступа (APN) для GPRS-соединения.
• RESIP, RESPORT — резервный адрес и порт сервера.

Контакты и оповещения

• TELSMS1 (2, 3, 4) — номера телефонов для экстренных SMS-оповещений.
• INALIAS1 (2, 3, 4) — имена входов для отправки уведомлений.
• TELAKN — номер для оповещения о разряде аккумулятора.
• TELUP1, TELUP2 — номера для автоматического поднятия трубки.

Входы, выходы и контрольные точки

• INPFLAGS1 (2, 3, 4) — параметры дискретных входов.
• CONTROLFLAGS1 (2, 3) — действия при срабатывании контрольной точки.
• CONTROLPOINT1, 2, 3 — координаты центра геозоны.
• RADIUS1, 2, 3 — радиус контрольной точки в метрах.
• CPALIAS1, 2, 3 — имя геозоны.
• CPTELNUM1, 2, 3 — номера для уведомлений о входе и выходе из зоны.
• PULSE1, PULSE2 — импульс на управляемый выход.
• OUT1, OUT2 — состояние реле (включено/выключено).
• MOUT1, MOUT2 — переключение выхода с сохранением состояния в памяти.
• RINGOUT — активация выхода при входящем звонке.

Настройки режимов работы

• MODEWR — режим записи данных.
• MODE1 — статический режим работы.
• MODEWIDE — расширенная запись параметров.
• ONLYBUTTON — управление только через шину 1-Wire.
• MODEANALOG — режим записи аналоговых данных при адаптивной работе.

Параметры аналоговых входов и аудио

• MODEAD1 (2) — перевод аналогового входа в цифровой режим.
• ALEVEL1, ALEVEL2 — порог срабатывания для аналоговых каналов.
• PERIODUSR1, PERIODUSR2 — период усреднения аналоговых значений.
• POROG1 (2) — порог переключения для аналоговых входов в цифровом режиме.
• MICAMP — усиление встроенного микрофона.
• DYNAMP — громкость динамика.

ALIAS — установить имя прибора

Команда задаёт имя прибора, которое отображается в SMS-сообщениях от контроллера. Вместо серийного номера в ответах появляется понятное название — марка или госномер автомобиля, что упрощает разбор входящих сообщений, когда в парке несколько десятков устройств.

Формат команды:

Параметры:

• [SPACE] — пробел;
• password — пароль, записанный в устройство программой GSMConf.exe, длиной ровно 8 символов;
• alias — имя прибора, не более 8 символов.

Формат ответа:

Пример. Посылаемая команда 123ZXCVB ALIAS=Kamaz; — полученный ответ 33200(Kamaz)#ALIAS=Kamaz;. У прибора с серийным номером 33200 установлено имя «Kamaz».

Запрос текущего имени. Команда GALIAS возвращает уже установленное имя: на 123ZXCVB GALIAS; устройство отвечает 33200(Kamaz)#ALIAS=Kamaz;.

Внимание! Имя прибора не должно превышать 8 символов — это могут быть цифры либо заглавные и строчные буквы латинского алфавита. Кириллица не поддерживается.

PULSE1 и PULSE2 — импульс на выход прибора

Команды выдают импульс заданной длительности на первый и второй выход устройства (открытый коллектор). Так можно удалённо сработать внешним устройством, подключённым к контроллеру: включить исполнительный механизм или подать сигнал на оборудование объекта.

Формат команды:

Параметры:

• [SPACE] — пробел;
• password — пароль устройства длиной ровно 8 символов;
• time — длительность импульса в секундах, от 1 до 10.

Формат ответа: Serial#PULSE1=time; или Serial#PULSE2=time; — серийный номер прибора и длительность выданного импульса.

Пример. Посылаемая команда 123ZXCVB PULSE1=7; — полученный ответ 33200#PULSE1=7;. У прибора с серийным номером 33200 выдан импульс на первый выход длительностью 7 секунд.

Важно. Команда подаёт короткий импульс, а не удерживает выход включённым: после её выполнения открытый коллектор закрывается. Для длительного управления выходом используйте команду SOUT с указанием состояния выхода.

MICAMP — усиление микрофона

Команда задаёт усиление микрофона в условных единицах — от 1 до 8. Она востребована, когда нужно настроить громкость обратной связи в салоне: например, при голосовом оповещении водителя или прослушивании кабины.

Формат команды:

Параметры:

• [SPACE] — пробел;
• password — пароль устройства длиной ровно 8 символов;
• param — усиление микрофона в условных единицах (от 1 до 8).

Формат ответа: Serial#MICAMP=param; — серийный номер прибора и установленное значение усиления.

Пример. Посылаемая команда 123ZXCVB MICAMP=3; — полученный ответ 33200#MICAMP=3;. Для прибора с серийным номером 33200 установлено усиление микрофона 3 единицы.

Запрос параметра. Команда GMICAMP возвращает текущее значение: на 123ZXCVB GMICAMP; устройство отвечает 33200#MICAMP=3;.

Автоматические SMS-сообщения от системы

Контроллер АвтоГРАФ не только принимает команды, но и сам отправляет уведомления на заданные номера:

• срабатывание цифрового входа — открытие двери, включение зажигания и другие события;
• разряд аккумулятора резервного питания;
• въезд или выезд транспортного средства из заданной контрольной точки (геозоны).

Номера для таких оповещений задаются командами TELSMS1–TELSMS4 и TELAKN, а имена входов — командами INALIAS1–INALIAS4. Доставка и выполнение команд может занимать некоторое время, особенно в зонах со слабым или неустойчивым сигналом сотовой связи.

Примеры практического использования USSD-запросов

Оператор МТС: отправить USSD запрос *100# для проверки баланса. Ответ: баланс 250.50 руб. Оператор Tele2: команда *105# для управления услугами. В контроллере АвтоГРАФ достаточно отправить USSD mypass "*105#", и ответ придёт в SMS. Для проверки остатка GPRS-пакета у МегаФона используйте *558#. Эти команды незаменимы при эксплуатации автопарка в удалённых районах, где нет возможности зайти в личный кабинет оператора.

Что означают коды в ответных SMS от контроллера

При срабатывании дискретных входов (настроенных в GSMConf) приходит сообщение с подробными параметрами: серийный номер, номер входа, время срабатывания в UTC, координаты, скорость, курс, дата. Например: 10020@input 1:092510:092516.000,A,4805.8021,N,01132.2243,E,1.9,183.8,270302. В новых версиях (с номера 10806) дополнительно указывается статус GPRS: 10820@GPRS:5,100 или 10820@5,100 если GPRS недоступен.

Возможности бортовых контроллеров АвтоГРАФ

• Контроль расхода топлива (ДРТ, VZO, ДУТ, LLS, CAN-шина).
• Учёт моточасов и пассажиропотока.
• Подключение до 8 датчиков температуры по 1-Wire.
• Шина RS-485 для датчиков уровня топлива.
• Чтение параметров FMS/J1939: обороты, скорость, расход топлива, уровень в баках, температура масла и др.
• Работа с GPS/ГЛОНАСС, накопление данных при потере связи и автоматическая отправка по GPRS.
• Бесплатное диспетчерское ПО.