Файл конфигурации сервера сообщений (Архив)
Файл конфигурации СМС-сервера — это файл конфигурации, в котором хранятся настройки СМС-сервера. Этот файл расположен в папке, в которую установлен СМС-сервер, и называется TMComDevs.ini.
Содержимое файла конфигурации может выглядеть так:
[TMComDevs] DatabaseName=LOCALHOST:C:\Program Files\Taxi\Data.gdb UserName=TAXI Password=bCgj4bSr LogFileName=C:\Program Files\Taxi\TMComDevs\Logs\TMComDevs.log RefreshInterval=10 [TMComDevice0] Name=Nokia 32 TypeID=1 Active=1 LogFile=C:\Program Files\Taxi\TMComDevs\Logs\TMCD_Nokia32.log CellLogFile=C:\Program Files\Taxi\TMComDevs\Logs\Nokia32_sms.log CellCOMPort=COM1 SMSRecv=1 SendSMSDelay=5000 CellConfigFile=C:\Program Files\Taxi\TMComDevs\lcell.conf CellDeleteSMS=1 CellHangUpOnRing=1
Содержание
Синтаксис файла конфигурации
Файл конфигурации СМС-сервера содержит данные в формате ini-файла, то есть данные, записанные в виде параметр=значение. Все параметры разбиты на секции, каждая из которых имеет имя и обозначается следующим образом:
[Секция]
Все параметры, которые идут после этого обозначения и до следующей секции, принадлежат текущей секции:
[Секция] Параметр=значение Другой_параметр=Другое значение
Секции могут идти друг за другом:
[Секция1] Параметр=значение [Секция2] Другой_параметр=Другое значение
Комментарии, наличие которых в тексте несет исключительно информационный смысл, не обрабатываются. Они начинаются со знака ; и занимают одну целую строку:
[Секция] ;Если этот параметр принимает значение "Значение", мир, определенно, может достигнуть Нирваны Параметр=Значение
Настройки, хранимые в файле конфигурации
В файле конфигурации СМС-сервера хранятся настройки, отвечающие за подключение СМС-сервера к базе данных, а также параметры устройств, которые опрашивает СМС-сервер. Все настройки делятся на однозначно определенные секции.
Секция общих настроек
Первая секция — [TMComDevs]. В ней присутствует несколько параметров:
- DatabaseName — путь к базе данных в виде компьютер:путь, где компьютер — имя или ip-адрес компьютера, на котором установлен Firebird и работает база, а путь — абсолютный путь к базе данных.
- UserName — имя пользователя, под которым происходит соединение с базой данных. Не требует редактирования в большинстве случаев.
- Password — шифрованный пароль для подключения к базе данных. Не требует редактирования в большинстве случаев.
- LogFileName — важный параметр, который содержит путь к файлу журнала работы СМС-сервера.
- RefreshInterval — время обновления задач для сервера (в секундах). По умолчанию устанавливается значение 10. Это значит, что каждые 10 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
Секции частных настроек устройств
Далее может быть несколько секций [TMComDeviceX] (X — порядковый номер секции и ИД устройства одновременно). Нумерация секций начинается с 0, поэтому первая секция — [TMComDevice0], вторая — [TMComDevice1] и т. д. Нарушение этого правила влечет некорректную работу СМС-сервера. В секции [TMComDeviceX] определяется устройство связи, в зависимости от этого могу меняться параметры:
Сотовый телефон
Ниже указан список параметров, которые могут следовать после секции TMComDeviceX, относящихся к сотовым телефонам и GSM-шлюзам.
- Name — название устройства, например, Name=Nokia 32.
- TypeID — идентификатор устройства (см. ниже). Здесь — TypeID=1
- Active — флаг активности. Если установлено значение Active=1, устройство активно; если Active=0, то задачи этим устройством не обрабатываются.
- CityCode — код вашего города. Например, CityCode=+73412.
- LogFile — журнал работы устройства связи. Например, LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log.
- CellLogFile — журнал отправки и приема СМС-сообщений, содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log.
- CellCOMPort — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
- SMSRecv — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен (SMSRecv=1), то входящие сообщения будут копироваться; если SMSRecv=0, то не будут.
- SendSMSDelay — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение 3000: SendSMSDelay=3000. Это означает, что сообщения отправляются каждые 3 секунды.
- CellDeleteSMS — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен (CellDeleteSMS=1), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
- CellHangUpOnRing — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен (CellHangUpOnRing=1), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.
Пример секции:
[TMComDevice0] Name=Nokia 32 TypeID=1 Active=1 LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log CellCOMPort=COM1 SMSRecv=1 SendSMSDelay=5000 CellConfigFile=C:\TMComDevs\lcell.conf CellDeleteSMS=1 CellHangUpOnRing=1
E-mail-гейт
Для e-mail-гейта существует особый список параметров.
- SMTPServer — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
- Login — логин для авторизации на SMTP-сервере.
- Password — пароль для авторизации на SMTP-сервере.
- FromAddress — адрес отправителя письма.
- FromName — имя отправителя письма.
- Subject — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы СМС-сервера).
- CharSet — кодировка писем (по умолчанию, windows-1251).
- ContentType — mime-тип содержимого писем (по умолчанию, text/plain).
- ConnectionTimeout — время ожидания соединения с сервером (в миллисекундах).
- SendSMSDelay — интервал между отправками сообщений (в миллисекундах).
- MessageTemplate — файл шаблона сообщения.
- ProviderLogin — логин для авторизации у провайдера.
- ProviderPassword — пароль для авторизации у провайдера.
Пример:
[TMComDevice1] SMTPServer=smtp.foo.ru Login=foo Password=bar FromAddress=root@quz.ru FromName=Root Subject=СМС-сообщение CharSet=windows-1251 ContentType=text/plain ConnectionTimeout=5000 SendSMSDelay=500 MessageTemplate=C:\Program Files\Taxi\TMComDevs\EmailMessageTemplate.txt ProviderLogin= ProviderPassword=
Поиск COM-порта, к которому подключен сотовый телефон
Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств (Панель управления → Система → Диспетчер устройств), в дереве устройств найдите пункт Модемы, раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону. Если вы не можете найти пункт Модемы, или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона. Поиск и установка драйвера входит в список задач вашего технического специалиста и в большинстве случаев решается тривиально.
В окне свойств модема найдите вкладку «Модем» и откройте ее. На панели будет написан номер COM-порта (например, “COM1” или “COM4”). Запомните этот порт, чтобы указать его в качестве значения параметра CellCOMPort секции [TMComDeviceX].
