Файл конфигурации сервера сообщений (Архив) — различия между версиями
Материал из TaxiMaster
м (→Синтаксис файла конфигурации) |
(→Секции частных настроек устройств) |
||
| Строка 73: | Строка 73: | ||
В секции <tt>[TMComDeviceX]</tt> определяется устройство связи, в зависимости от этого могу меняться параметры: | В секции <tt>[TMComDeviceX]</tt> определяется устройство связи, в зависимости от этого могу меняться параметры: | ||
| − | + | ==== Сотовый телефон ==== | |
| − | + | Ниже указан список параметров, которые могут следовать после секции <tt>TMComDeviceX</tt>, относящихся к сотовым телефонам и GSM-шлюзам. | |
| − | + | ||
| − | + | # <tt>Name</tt> — название устройства, например, <tt>Name=Nokia 32</tt>. | |
| − | + | # <tt>TypeID</tt> — идентификатор устройства (см. ниже). Здесь — <tt>TypeID=1</tt> | |
| − | + | # <tt>Active</tt> — флаг активности. Если установлено значение <tt>Active=1</tt>, устройство активно; если <tt>Active=0</tt>, то задачи этим устройством не обрабатываются. | |
| − | + | # <tt>CityCode</tt> — код вашего города. Например, <tt>CityCode=+73412</tt>. | |
| − | + | # <tt>LogFile</tt> — [[журнал работы устройства связи]]. Например, <tt>LogFile=C:\TMComDevs\Logs\TMCD_Nokia32.log</tt>. | |
| − | + | # <tt>CellLogFile</tt> — [[журнал отправки и приема СМС-сообщений]], содержащий команды, вызываемые для работы сотового телефона, а точнее — встроенного в него модема. Например, <tt>CellLogFile=C:\TMComDevs\Logs\Nokia32_sms.log</tt>. | |
| − | + | # <tt>CellCOMPort</tt> — важный параметр, определяющий, к какому COM-порту подключен сотовый телефон. О том, как это узнать, читайте ниже. | |
| − | + | # <tt>SMSRecv</tt> — флаг, включающий или отключающий сбор входящих сообщений с сотового телефона. Если флаг выставлен (<tt>SMSRecv=1</tt>), то входящие сообщения будут копироваться; если <tt>SMSRecv=0</tt>, то не будут. | |
| − | + | # <tt>SendSMSDelay</tt> — интервал между отправками сообщений (в миллисекундах). По умолчанию устанавливается значение <tt>3000</tt>: <tt>SendSMSDelay=3000</tt>. Это означает, что сообщения отправляются каждые 3 секунды. | |
| + | # <tt>CellDeleteSMS</tt> — флаг, отвечающий за автоматическое удаление всех сообщений с устройства. Если флаг установлен (<tt>CellDeleteSMS=1</tt>), то сообщения удаляются автоматически после отправки 25 сообщений и при инициализации СМС-сервера. | ||
| + | # <tt>CellHangUpOnRing</tt> — флаг, отвечающий за автоматический сброс входящего звонка. Если флаг установлен (<tt>CellHangUpOnRing=1</tt>), то все входящие звонки будут сбрасываться, чтобы не было препятствий для отправки и приема сообщений. | ||
| + | |||
| + | Пример секции: | ||
| + | |||
| + | <pre> | ||
| + | [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 | ||
| + | </pre> | ||
| + | |||
| + | ==== E-mail-гейт ==== | ||
| + | Для e-mail-гейта существует особый список параметров. | ||
| + | |||
| + | # <tt>SMTPServer</tt> — IP-адрес или DNS-имя SMTP-сервера, принимающего e-mail-сообщения и преобразующего их в СМС-сообщения. | ||
| + | # <tt>Login</tt> — логин для авторизации на SMTP-сервере. | ||
| + | # <tt>Password</tt> — пароль для авторизации на SMTP-сервере. | ||
| + | # <tt>FromAddress</tt> — адрес отправителя письма. | ||
| + | # <tt>FromName</tt> — имя отправителя письма. | ||
| + | # <tt>Subject</tt> — тема отправляемого письма (задается в параметрах и не может быть изменена в ходе работы [[СМС-сервер]]а). | ||
| + | # <tt>CharSet</tt> — кодировка писем (по умолчанию, <tt>windows-1251</tt>). | ||
| + | # <tt>ContentType</tt> — mime-тип содержимого писем (по умолчанию, <tt>text/plain</tt>). | ||
| + | # <tt>ConnectionTimeout</tt> — время ожидания соединения с сервером (в миллисекундах). | ||
| + | # <tt>SendSMSDelay</tt> — интервал между отправками сообщений (в миллисекундах). | ||
| + | # <tt>MessageTemplate</tt> — [[файл шаблона сообщения]]. | ||
| + | # <tt>ProviderLogin</tt> — логин для авторизации у провайдера. | ||
| + | # <tt>ProviderPassword</tt> — пароль для авторизации у провайдера. | ||
| + | |||
| + | Пример: | ||
| + | |||
| + | <pre> | ||
| + | [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\messages.txt | ||
| + | ProviderLogin= | ||
| + | ProviderPassword= | ||
| + | </pre> | ||
=== Поиск COM-порта, к которому подключен сотовый телефон === | === Поиск COM-порта, к которому подключен сотовый телефон === | ||
Версия 10:21, 16 июня 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 секунд СМС-сервер собирает задачи по отправке и приему сообщений и выполняет их.
Секции частных настроек устройств
Далее может быть несколько секций [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\messages.txt ProviderLogin= ProviderPassword=
Поиск COM-порта, к которому подключен сотовый телефон
Чтобы узнать, к какому COM-порту подключен сотовый телефон, откройте диспетчер устройств (Панель управления → Система → Диспетчер устройств), в дереве устройств найдите пункт Модемы, раскройте его и откройте свойства модема, соответствующего вашему сотовому телефону. Если вы не можете найти пункт Модемы, или модем вашего сотового телефона отсутствует в этом списке, возможно, вы не установили драйвер для телефона. Поиск и установка драйвера входит в список задач вашего технического специалиста и в большинстве случаев решается тривиально.
В окне свойств модема найдите вкладку «Модем» и откройте ее. На панели будет написан номер COM-порта (например, “COM1” или “COM4”). Запомните этот порт, чтобы указать его в качестве значения параметра CellCOMPort секции [TMComDeviceX].
Ссылки
- http://www.winpedia.ru/content/view/484/45/ — о диспетчере устройств на WinPedia.
