SMS Авто-модуль

§        Краткое описание SMS модуля

§        Установка и настройка SMS модуля

Краткое описание SMS модуль:


В системе «Такси Диспетчер» реализована автоматизированная система отправки и приема СМС. SMS Авто-модуль предназначен для автоматизированной отправки сообщений СМС водителям и клиентам.

Для работы SMS Авто-модуль необходимо:

  • мобильный телефон с поддержкой технологии bluetooth,usb адаптер bluetooth(в том случае если ваш компьютер еще не поддерживает эту технологию) или GSM модем. (тогда ни телефон ни адаптер не требуются)

Принцип работы:

  • Сообщения отправляются через мобильный телефон аналогично тому как будто вручную набрали и отправили СМС, только автоматически.
  • Сам SMS Авто-модуль работает напрямую с COM-портом телефона через беспроводную связь bluetooth или с GSM модемом.

 

Настройка SMS модуля:

 

  1. Настройка соединения bluetooth c мобильным телефоном
  2. Установка SMS Авто-модуль
  3. Настройка конфигурационных файлов SMS Авто-модуль
  4. Протокол обмена, его параметры(для проверки правильности работы модуля).


Для настройки соединения Bluetooth c мобильным телефоном необходимо:

  1. Подключить USB адаптер Bluetooth (например, D-link Bluetooth) к компьютеру и установить все драйвера на него.
    Необходимо задать имя компьютера в сети Bluetooth, для этого нажимаем правой клавишей мыши на Значек активного взаимодействияи выбираем "Bluetooth Configuration", здесь в поле Computer name введем имя компьютера, вводим к примеру Комп.

 

  1. Включить соединение Bluetooth в мобильном телефоне, обычно оно располагается в настройках (например, Настройки/Подключение устройств/Bluetooth), там же можно указать название мобильного телефона которое будет видеться в сети bluetooth (например, Настройки/Подключение устройств/Bluetooth/Настройки Bluetooth/Название телефона).

 

  1. Непосредственно устанавливаем соединение на компьютере. Для этого нажимаем правой клавишей мыши на , и выбираем "Explore My Bluetooth Places".

Поиск bluetooth устройств



Откроется окно "My Bluetooth Places", где будут отображены все устройства беспроводной сети Bluetooth, в данный момент на скриншоте видны два мобильных телефона "Джонни" и "Ика". Выберите имя вашего телефона и установите соединение с ним, для этого на самом значке мобильного телефона нажимаем правую клавишу мыши и выберите "Connect Serial Port". При попытке соединения выйдет окно с просьбой ввести пароль, вводим 1, берем телефон там будет сообщение примерно такого характера "Разрешить соединение с Комп", так как мы имя компьютера выбрали "Комп" то соглашаемся и вводим пароль, именно тот который указали на компьютере, т.е. 1.

 

  1. После установки соединения зайти в сопряженный мобильный телефон. Для этого вам необходимо выбрать иконку с именем телефона, нажать на ней правой клавишей мыши и выбрать "Открыть". В открывшемся окне найдите значок СОМ соединения, нажмите на нем правой клавишей мыши и выберите "Подключиться к последовательному порту Bluetooth". Ваш мобильный телефон выдаст окно с предложением соединиться, примите соединение для обмен информацией с мобильным телефоном.
    Запомните номер СОМ порта, через который ваш телефон соединиться.
    В результате у вас восстановиться соединение и значок изменится как приведено на картинке ниже.

Диспетчер устройств



В правом нижнем углу рабочего стола Windows должен появится значок Значек соединения.
Если эти условия выполнены то установка адаптера Bluetooth прошла успешно в противном случае необходимо обратится на сайт производителя или к продавцу, за разъяснением процесса установки.



ВНИМАНИЕ! Данный пример установки соединения Bluetooth между компьютером и мобильным телефоном носит примерный характер, непосредственно название окон и расположение настроек во вкладках может различаться в зависимости от производителя, но суть настройки везде одинаковая.
Установка SMS Авто-модуль:

Для установки вам необходимы файлы приведенные ниже. Данные файлы могут быть помещены в соответствующие папки каталога Такси Диспетчерили Модуль SMS может быт установлен в любой другой каталог. Взаимодействие будет происходить через AutomationServer.exe

  1. Каталог bin, в котором находятся запускные бинарные файлы
    • AutomationServer.exe
    • Sender.exe
    • sms_gsm.exe
    • sms_gsm_service.exe
  1. Каталог cfg, в котором находятся конфигурационные файлы
    • sms_gps.ini
    • auto_settings.ini
  1. Каталог log, в котором находятся логи, и данные выгружаемые с мобильного телефона
    • sms_gps.txt
  1. Каталог lib, в котором находятся файлы библиотек
    • smscustom.dll


Настройка конфигурационных файлов SMS Авто-модуль:

Сначала вам необходимо настроить конфигурационный файл SMS Авто-модуль. Для этого, вам необходимо прописать СОМ порт соединения с мобильным телефоном в файл sms_gps.ini.
Введите номер своего СОМ порта в файле sms_gps.ini в секции [Thread1], в которой есть параметр ComName=.
Ниже приведен пример:

[Thread1]
Type=com
ComName=COM8
ComRate=12
ComByteSize=3
ComParity=0
ComStopBits=0
ComCountDelay=100
ComModemIniString=AT+CPMS="ME","ME","ME"
ComModemSMSType=0
WGTimerEnabled=0
WGTimerInterval=10000
WGTimerString=AT+CFUN?
WGTimerIniString=AT+WRST=1,"000:15"
CommandType=FABERLIK
TCPLocalHost=127.0.0.1
TCPLocalPort=9022


Затем, установите и запуска сервис SMS Процессор, работающий в фоновом режиме. Для этого необходимо в командной строке (пуск -> выполнить) выполнить следующую команду: "путь к программе\bin\sms_gsm_service.exe" /install
Н
апример, "C:\Progra~1\F-Group\Taxi\bin\sms_gsm_service.exe" /install

Д
алее, откройте программу sms_gsm.exe. Проверить достоверность соединения с СОМ портом мобильного телефона можно выбрав пункт меню "Действия/COM-GSMроверить GSM модем". Если соединение с мобильным телефоном было выполнено неверно, в окне-логе появиться сообщение об ошибке, например, СОМ порт не подключен.

Следующим шагом запустите программу AutomationServer.exe. В данной программе есть кнопка "Начать/закончить работу потоков", с помощью которой вы сможете останавливать и запускать поток отправки СМС.

Вам остается только настроить с программе Такси Диспетчер те СМС сообщения, которые вам необходимо отправлять клиентам/водителям.

Параметры конфигурационных файлов SMS Авто-модуль.

Все настройки SMS Авто-модуль находятся в конфигурационном файле sms_gps.ini, который находится "C:\Program Files\F-Group\SMS\cfg".
Файл sms_gps.ini состоит из параметров которые для удобства логического восприятия разбиты на секции.
Название секции начинается с [ и заканчивается ], параметр имеет формат: имяпараметра=значение.

    • Секция [General] предназначена для задания общих настроек.

      Параметры:

      SaveLog=          -сохранять ли лог событий. Возможные значения : 1- сохранять или 0 - несохранять.
      LogDirPath=     - путь к логам.
      Tray=                - сворачивать ли программу в "трей"озможные значения : 1- сворачивать или 0 - несворачивать.

ServiceName=  - имя сервиса, с которым он регестрируется среди сервисов.

StartNow= - Если значение 1 то программа запускается в первый раз, если 0 то нет.
Country= - Наименование страны использования программы.(rus – Россия, ukr - Украина). От этого параметра зависит преобразование номера телефона. Для России 8 преобразуется в +7, для Украины в +38 , по умолчанию rus - Россия.
BrCharacter= - Символ или последовательность символов, которой будет заменяться символ перевода строки при получении команд по TCP протоколу, по умолчанию < br> .
FIFOTime=- Время в миллисекундах, через которое будет проводиться опрос очереди команд для отправки.


    • Секция [Log] предназначена для задания настроек логгирования.

      Параметры:

      Maxsize= - указывает максимальный размер лога в байтах, если равен 0 то размер неограничен.

      Секция [ThreadX] – где X – номер потока. Настройки потоков обработки.

Вы можете в конфигурационном файле задать несоклько потоков для различных Type и Command - и все потоки будут созданы приложением и работать будут согласно конфигурационному файлу

Параметры:

Type= - Вид интерфейса для подключения, по умолчанию com - через ком порт.
ComName= - номер COM порта.
ComRate= - Скорость СОМ порта. Возможные значения:

      • 0 – 110
      • 1 – 300
      • 2 – 600
      • 3 – 1200
      • 4 – 2400
      • 5 – 4800
      • 6 – 9600
      • 7 – 14400
      • 8 – 19200
      • 9 – 38400
      • 10 – 56000
      • 11 – 57600
      • 12 – 115200
      • 14 – 256000


ComByteSize= - Размер байтаозможные значения:

      • 0 – 5
      • 1 – 6
      • 2 – 7
      • 3 – 8


ComParity= - Паритетозможные значения:

      • 0 – None
      • 1 – Odd
      • 2 – Even
      • 3 – Mark
      • 4 - Space


ComStopBits= - Стоповые битыозможные значения:

      • 0 – 1
      • 1 – 1.5
      • 2 – 2


ComCountDelay= - Время в миллисекундах, внутренний таймер
ComModemIniString= - строка инициализации.
ComModemSMSType=Тип обработки входящих сообщенийозможные значения:

      • FABERLIK – обработка текста СМС и отправка результата обработки через ТСР соединение.
      • EXECSMS – сохранение СМС, вызов скрипта, отправка СМС через ТСР соединение.
      • CSVSMS – сохранение СМС в файле формата CSV, отправка СМС через ТСР соединение.
      • TCPIPSMS - сохранение СМС, отправка СМС через ТСР соединение.
      • SENDSMS - отправка СМС через ТСР соединение.
      • SENDSMTP - отправка СМС на E-mail.
      • BIRTHDAY – обработка даты и времени.
      • TDAUTO – открытие СМС в редакторе отчетов.


WGTimerEnabled= - Включена ли отправка тестовые пакетов в модем через оперд. промежуток времени. Если 1 - включено, если 0 - нет.
WGTimerInterval= - Интервал времени через который будут отправлятся тестовые пакеты, в секундах.
WGTimerString= - Команда отправляемая тестовым пакетом.
WGTimerIniString= - Команда отправляемая тестовым пакетом.
CommandType=
TCPLocalHost= -
Локальный адрес ТСР сервера
TCPLocalPort=-
Порт ТСР сервера

Пример:

[Thread1]
Type=com
ComName=COM13
ComRate=12
ComByteSize=3
ComParity=0
ComStopBits=0
ComCountDelay=100
ComModemIniString=AT+CPMS="ME","ME","ME"
ComModemSMSType=0
WGTimerEnabled=0
WGTimerInterval=10000
WGTimerString=AT+CFUN?
WGTimerIniString=AT+WRST=1,"000:15"
CommandType=FABERLIK
TCPLocalHost=127.0.0.1
TCPLocalPort=9022

 

Протокол обмена (для разработчиков):

Каждая команда посланная на выполнение выполняется поочередно.

Формат запроса:

Count=<количество команд>


<Команда 2><Команда 1>…


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

Count=<количество команд ответов>


<Команда ответ 2><Команда ответ 1>…


Количество ответов равно количеству команд.
Ответы приходят в очередности, указанной в запросе.

Команды:

  • Команда отправки СМС.

    Параметры запроса:

    Command= - номер команды отправки СМС - 1.
    NumTread= - номер потока обработки команды, в зависимости от того какой будет поток и как он будет настроен зависит через "что" будет отсылатся СМС (почта, веб сайт, мобильный телефон).(настраивается в файле sms_gps.ini)
    Destaddr= - номер телефона получателя.
    Msgtext= - текст СМС сообщения. Текст СМС сообщения не должен содержать символов перевода строки. Все символы перевода строки должны быть заменены установленным в настройках символом или последовательностью символов, например, < Br>

    Пример:

    Command=<1>
    NumTread=<1>
    Destaddr=<89069423524>
    Msgtext=<Смена закончена!>

    П
    ри этом запросе будет отправлена СМС на телефон 89069423524 через поток №1 и будет содержать текст "Смена закончена!".

    Параметры ответа:

    Result= - результат выполнения командыозможные значения:

 

    • 0 - Нет ошибок.
    • 4 - Ошибка записи команды в очередь на выполнение.
    • Любое другое число - Ошибка выполнения команды.


SendID= - уникальный номер, который присваивается каждой отсылаемой СМС, для однозначного определения СМС. Используется в команде проверки статуса отправляемой СМС.
Status= - состояние отправляемой СМСозможные значения:

 

    • -1 - СМС отсутствует в списке отосланных.
    • 1 - Команда отправки СМС поставлена в очередь на выполнение.
    • 2 - СМС отослано.
    • 3 - СМС доставлено.


Пример:

Result=<0>
SendID=<2356789>
Status=<2>

Данный ответ говорит о том, что отправка прошла без ошибок, отправляемой смс присвоили уникальный номер 2356789 и СМС отослана.

  • Команда проверки статуса СМС.

    Параметры запроса:

    Command= - номер команды проверки статуса СМС - 2.
    NumTread= - номер потока обработки команды, в зависимости от того какой будет поток и как он будет настроен зависит через "что" будет отсылатся СМС (почта, веб сайт, мобильный телефон).(настраивается в файле sms_gps.ini)
    SENDID= - уникальный номер СМС.
    Пример:

    Command=<2>
    NumTread=<1>
    SENDID=

    <2356789>В
    данном примере будет отправлен запрос проверки статуса СМС с уникальным номером 2356789 через поток №1.

    Параметры ответа:

    Result= - результат выполнения командыозможные значения:

 

    • 0 - Нет ошибок.
    • 4 - Ошибка записи команды в очередь на выполнение.
    • Любое другое число - Ошибка выполнения команды.


SendID= - уникальный номер, который присваивается каждой отсылаемой СМС, для однозначного определения СМС. Используется в команде проверки статуса отправляемой СМС.
Status= - состояние отправляемой СМСозможные значения:

 

    • -1 - СМС отсутствует в списке отосланных.
    • 1 - Команда отправки СМС поставлена в очередь на выполнение.
    • 2 - СМС отослано.
    • 3 - СМС доставлено.


Пример:

Result=<0>
SendID=<2356789>
Status=<3>

Данный ответ говорит о том, что запрос прошел без ошибок и смс с уникальным номером 2356789 была доставлена.

Команда получения всех непрочитанных СМС.

Параметры запроса:

Command= - номер команды получения всех непрочитанных СМС - 3
NumTread= - номер потока обработки команды, в зависимости от того какой будет поток и как он будет настроен зависит через "что" будет отсылатся СМС (почта, веб сайт, мобильный телефон).(настраивается в файле sms_gps.ini)

Пример:

Command=3 NumTread=1

Данный запрос будет направлен на получение всех непрочитанных СМС через поток №1.

Параметры ответа:

PHONE= - Номер телефона отправителя.
TEXT= - Текст СМС сообщения.
SENDID= - Уникальный номер полученной СМС.
STATUS= - Статус запроса.
DATE= - Дата и время получения СМС.
RESULT= - Результат выполнения команды.

Пример:

Count=2
Result=0
SendID=324567
Status=1
PHONE=987654321
TEXT=полученное СМС
SENDID=0
STATUS=3
DATE=01.01.2008 10:10:10
RESULT=0


Данный ответ говорит о том, что запрос прошел без ошибок и и была получена непрочитанная СМС, которая была отправлена с телефона 987654321 в 10:10:10 1 января 2008 года и содержала текст "полученное СМС".

Настройка сообщений



.


Чтобы узнать больше про "Такси Диспетчер" посетите наш сайт: www.taxi-office.ru