Файл конфигурации сервера сообщений (Архив) — различия между версиями

Версия 13:37, 30 сентября 2009

Файл конфигурации СМС-сервера — это файл конфигурации, в котором хранятся настройки СМС-сервера. Этот файл расположен в папке, в которую установлен СМС-сервер, и называется «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 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
• «UseNokiaDevices» — глобальный флаг, включающий (если =«1») или отключающий («0») работу с Nokia PC Suite.
• «NokiaDllFolder» — путь к папке, в которую установлен Nokia PC Suite (если «UseNokiaDevices»=«1»). Если Nokia PC Suite установлен в папку по умолчанию, то путь — такой: «C:\Program Files\PC Connectivity Solution».

Секции частных настроек устройств

Далее может быть несколько секций «[TMComDeviceX]» («X» — порядковый номер секции и ИД устройства одновременно). Нумерация секций начинается с 0, поэтому первая секция — «[TMComDevice0]», вторая — «[TMComDevice1]» и т. д. Нарушение этого правила влечет некорректную работу СМС-сервера. В секции «[TMComDeviceX]» определяется устройство связи, в зависимости от этого могу меняться параметры:

Сотовый телефон

Ниже указан список параметров, которые могут следовать после секции «TMComDeviceX», относящихся к сотовым телефонам и GSM-шлюзам.

1. «Name» — название устройства, например, «Name»=«Nokia 32».
2. «TypeID» — идентификатор устройства (см. ниже). Здесь — «TypeID»=«1»
3. «Active» — флаг активности. Если установлено значение «Active»=«1», устройство активно; если «Active»=«0», то задачи этим устройством не обрабатываются.
4. «CityCode» — код вашего города. Например, «CityCode»=«+73412».
5. «LogFile» — журнал работы устройства связи. Например, «LogFile»=«C:\TMComDevs\Logs\TMCD_Nokia32.log».
6. «CellLogFile» — журнал отправки и приема СМС-сообщений, содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, «CellLogFile»=«C:\TMComDevs\Logs\Nokia32_sms.log».
7. «CellCOMPort» — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже.
8. «SMSRecv» — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен («SMSRecv»=«1»), то входящие сообщения будут копироваться; если «SMSRecv»=«0», то не будут.
9. «SendSMSDelay» — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение «3000»: «SendSMSDelay»=«3000». Это означает, что сообщения отправляются каждые 3 секунды.
10. «CellDeleteSMS» — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен («CellDeleteSMS»=«1»), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера.
11. «CellHangUpOnRing» — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен («CellHangUpOnRing»=«1»), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений.

Пример секции:

[TMComDevice0]
IsNokiaDevice=0
Name=SonyEricsson Walkman
TypeID=1
Active=1
LogFile=C:\TMComDevs\Logs\TMCD_SEW.log
CellLogFile=C:\TMComDevs\Logs\SEW_sms.log
CellCOMPort=COM1
SMSRecv=1
SendSMSDelay=5000
CellConfigFile=C:\TMComDevs\lcell.conf
CellDeleteSMS=1
CellHangUpOnRing=1

Сотовый телефон + Nokia PC Suite

СМС-сервер поддерживает работу с Nokia PC Suite, поэтому если вы располагаете сотовым телефоном Nokia, то для вас настройка упрощена максимально. Чтобы отправлять и принимать СМС-сообщения через телефон Nokia, нужны следующие компоненты:

1. Модуль СМС
2. СМС-сервер
3. Nokia PC Suite

Практически вся настройка (за исключением фильтров и шаблонов) происходит в файле «TMComDevs.ini».

Наряду с параметрами сотового телефона как модема, имеются особые параметры, которые указывают на то, что данный сотовый телефон обслуживается ПО Nokia PC Suite:

1. «IsNokiaDevice» — флаг, указывающий на то, что данный телефон обслуживается средствами Nokia PC Suite. «1» > обслуживается, «0» — работает как стандартный GSM-модем.

Следующее добавить к предыдущему пункту, чтобы сообщения отправлялись с телефона средствами Nokia PC Suite:

1. Установите Nokia PC Suite и СМС-сервер на компьютер, к которому подключен телефон.
2. Откройте файл конфигурации («TMComDevs.ini», о нем и идет речь во всей статье).
3. В секцию «[TMComDevs]» добавьте запись «UseNokiaDevices»=«1».
4. Туда же добавьте запись «NokiaDllFolder»=«путь-к-NPCS», где «путь-к-NPCS» — это путь к папке, в которую установлен Nokia PC Suite (по умолчанию, «C:\Program Files\PC Connectivity Solution»).
5. В секцию, относящейся к телефону Nokia (например, «[TMComDevice0]»), добавьте запись «IsNokiaDevice»=«1».
6. Сохраните файл и перезапустите СМС-сервер.

После этого СМС-сервер будет считать устройство с ИД, равным «0», телефоном, к которому нужно обращаться средствами Nokia PC Suite.

Пример секции:

[TMComDevice0]
IsNokiaDevice=1
Name=Nokia 5800
TypeID=1
Active=1
LogFile=C:\TMComDevs\Logs\TMCD_N5800.log
CellLogFile=C:\TMComDevs\Logs\N5800_sms.log
CellCOMPort=COM1
SMSRecv=1
SendSMSDelay=5000
CellConfigFile=C:\TMComDevs\lcell.conf
CellDeleteSMS=1
CellHangUpOnRing=1

E-mail-гейт

Для e-mail-гейта существует особый список параметров.

1. «SMTPServer» — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения.
2. «Login» — логин для авторизации на SMTP-сервере.
3. «Password» — пароль для авторизации на SMTP-сервере.
4. «FromAddress» — адрес отправителя письма.
5. «FromName» — имя отправителя письма.
6. «Subject» — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы СМС-сервера, но может содержать особый тег, см. ниже).
7. «CharSet» — кодировка писем (по умолчанию, «windows-1251»).
8. «ContentType» — mime-тип содержимого писем (по умолчанию, «text/plain»).
9. «ConnectionTimeout» — время ожидания соединения с сервером (в миллисекундах).
10. «SendSMSDelay» — интервал между отправками сообщений (в миллисекундах).
11. «MessageTemplate» — файл шаблона сообщения.
12. «ProviderLogin» — логин для авторизации у провайдера.
13. «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=

Параметр Subject

Для параметра «Subject» могут быть использованы теги, которые используются в файле шаблона сообщения (не путать с тегами, используемыми в шаблонах СМС-сообщений!).

Поиск COM-порта, к которому подключен сотовый телефон

Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств («Панель управления» → «Система» → «Диспетчер устройств»), в дереве устройств найдите пункт «Модемы», раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону. Если вы не можете найти пункт «Модемы», или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона. Поиск и установка драйвера входит в список задач вашего технического специалиста и в большинстве случаев решается тривиально.

В окне свойств модема найдите вкладку «Модем» и откройте ее. На панели будет написан номер COM-порта (например, “COM1” или “COM4”). Запомните этот порт, чтобы указать его в качестве значения параметра «CellCOMPort» секции «[TMComDeviceX]» («X» → порядковый ИД устройства).

Ссылки

• Модуль СМС
• СМС-сервер
• Фильтр сотовых телефонов