Общая характеристика протокола Contact ID
Протокол Contact ID (DCS SurGard) представляет собой открытый протокол передачи извещений охранного, пожарного и технологического мониторинга. CID поддерживается всеми ведущими производителями контрольных панелей и мониторинговых приемников.
Передача данных в формате Contact ID осуществляются сервером STEMAX с помощью приемно-передающих устройств (устройств ПЦН). Взаимодействие между серверным компьютером и устройством ПЦН осуществляется по каналу TCP/IP или по интерфейсу RS-232 (через COM-порт). Передача сообщений Contact ID может выполняться на любой внешний статический IP-адрес.
Формат сообщений в протоколе Contact ID
Сообщение передается строкой определенной структуры. В ПО STEMAX формат сообщения следующий:
5000 18AAAAQXXXYYZZZ
где:
5 = признак, что это сообщение в формате Surgard. Всегда должно быть значение 5.
00 = номер приемника (сервер STEMAX всегда передает значение 00 в качестве номера приемника).
0 = номер входящей линии приемника (сервер STEMAX всегда передает значение 0).
18 = Тип сообщения. Это 2-значная последовательность, используемая для идентификации сообщения Contact ID на приемник. Всегда имеет значение 18.
AAAA = номер устройства или номер объекта. Длина номера переменная, номер может состоять из 4, 6, 8 или 10 цифр.
Q = квалификатор события, который дает конкретную информацию о событии:
E = «новое Событие» или Тревога.
R = «новое Восстановление» или Норма.
XXX = код события (значение от 001 до 999). В ПО STEMAX события формируются в формате MSRV, их перекодировка в протокол Contact ID DCS Sur-Gard осуществляется с помощью таблицы соответствия События Contact ID (передатчик). Создать и заполнить таблицу можно в программе STEMAX Администратор.
YY= Номер раздела (2 цифры от 00 до 99). Используется 00, чтобы указать, что
информация о разделе не применяется.ZZZ = Номер ШС или номер ключа (3 цифры от 000 до 999). Используется 000, чтобы указать, что никакой конкретной информации о ШС или пользователе не применяется.
Заполнение таблицы События Contact ID (передатчик)
Для организации передачи данных из ПО STEMAX в сторонние системы необходимо установить соответствие передаваемых событий из протокола MSRV в протокол Contact ID DCS Sur-Gard. Это осуществляется с помощью таблицы соответствия События Contact ID (передатчик).
Для того чтобы перейти к работе с таблицей, в программе Администратор в Меню выберите События Contact ID (передатчик). В результате откроется соответствующее окно. На иллюстрации ниже представлено окно События Contact ID (передатчик).
Раскрывающийся список Таблица позволяет выбирать между имеющимися таблицами. Можно вносить изменения в таблицу, имеющуюся изначально (По умолчанию) и создавать другие таблицы.
Название таблицы, с которой идет работа в текущий момент, отображается в поле Таблица. Для того чтобы сохранить внесенные изменения, нажмите кнопку ОК, для того чтобы отменить изменения — кнопку Отмена.
Для того чтобы создать новую таблицу, нажмите кнопку "+". В открывшемся окне Имя введите имя новой таблицы и нажмите кнопку ОК. В результате будет создана новая таблица.
Внешний вид таблицы События Contact ID (передатчик) представлен на иллюстрации выше. Таблица содержит описанные ниже столбцы.
Тип события ПЦН: тип события ПО STEMAX.
Подтип события ПЦН: подтип события ПО STEMAX.
Ячейки в столбцах Событие Contact ID, Тип Contact ID, Параметр Contact ID представляют собой раскрывающиеся списки. После щелчка по ним левой кнопкой мыши можно выбрать одно из предложенных значений или отсутствие значения (пустое значение).
Событие Contact ID: номер и описание события, передаваемого по Contact ID.
Тип Contact ID: тип события, передаваемого по Contact ID (событие или восстановление).
Параметр Contact ID: параметр, к которому относится событие (Ключ / Шлейф / Раздел / Канал доставки / не выбран).
Фильтр "Информация с объектов - Сообщение" служит для назначения подмножества событий с устройств, для которых не заведено отдельных системных событий. Например, если с объектовых устройств приходят разные события, которые ПО STEMAX расшифровывает как "Информация с объектов - Сообщение", где сообщения отличаются в зависимости от конкретного события. Для дифференциации таких событий при отправке в протоколе Contact ID выберите дифференцируемое событие в фильтре и нажмите кнопку "+" справа. В таблице События Contact ID (передатчик) появится новая строка, в которой подтипу события можно будет назначить Тип события, Код и Параметр.
Создание устройства ПЦН Contact ID передатчик
Для передачи извещений в формате Contact ID необходимо создать и запустить хотя бы одно приемно-передающее устройство типа Contact ID передатчик.
Параметры устройств типа Contact ID передатчик:
Имя: имя устройства.
Описание: описание устройства.
Транспорт: протокол подключения устройства к серверу STEMAX (TCP/IP или RS-232).
Порт: номер СОМ-порта, к которому подключено устройство.
Для подключения по протоколу TCP/IP:
Адрес сервера: IP-адрес сервера-адресата.
Порт: порт для подключения к серверу-адресату.
Запись логов: если флажок установлен, то будет вестись протокол работы устройства. Он будет записываться в файл MS_ServerCOMX.log (где X — номер COM-порта, через который работает устройство) в папке установки ПО STEMAX. Протокол может быть использован для выявления неисправностей.
Тип протокола: тип протокола DCS Sur-Gard (Contact ID).
Имя таблицы событий: имя таблицы соответствия передаваемых событий событиям ПО STEMAX (см. выже).
Период тестов станции, сек: период отправки на приемную сторону события о том, что сервер STEMAX функционирует и находится на связи.
Период тестов объектов [602], мин: период формирования события Периодический тестовый отчет (602). Событие информирует приемную сторону о том, что объект находится на связи.
Пауза между тестами объектов, мс: пауза между отправкой двух событий Периодический тестовый отчет (функция позволяет распределить по времени отправку событий, если они одновременно формируются для большого количества объектов).
Длина очереди событий (Не ограничено / 10 / 100 / 1000 / 10000): максимальная длина очереди событий, ожидающих передачи устройством Contact ID передатчик. При превышении этой длины старые события удаляются.
Заменять раздел 0 разделом №: номер раздела, в качестве которого будет представлен раздел 0.
Без подтверждения доставки:
если флажок не установлен, то сервер STEMAX будет выполнять попытки повторной доставки событий, пока не получит подтверждения доставки со стороны принимающего сервера;
если флажок установлен, то сервер STEMAX будет выполнять только одну попытку доставки для каждого события.
Выбор объектов мониторинга
Далее следует выбрать карточки объектов мониторинга, данные по которым будет передаваться на сторонний сервер в формате Contact ID.
По умолчанию после запуска хотя бы одного устройства типа Contact ID передатчик все события по всем объектам на сервере STEMAX будут транскодироваться в формат Contact ID и передаваться на сервер сторонней системы или сервера сторонних систем, если запущено несколько устройств типа Contact ID передатчик.
Если требуется передавать на сервер сторонней системы события не по всем объектам, то заполните для всех объектов параметр Имя направления на вкладке Дополнительные параметры в карточке объекта:
оставьте параметр пустым, если извещения по данному объекту должны передаваться с помощью всех запущенных устройств типа Contact ID передатчик;
введите имя устройства типа Contact ID передатчик, если извещения по данному объекту должны передаваться только в одну определенную стороннюю систему;
введите имя несуществующего устройства типа Contact ID передатчик, если извещения по данному объекту не должны передаваться в сторонние системы.
При необходимости на вкладке Дополнительные параметры в карточке объекта для каждого объекта можно задать Номер объекта и Номер раздела, которые будут включаться в Contact ID сообщения по данному объекту.
Контроль передачи данных по протоколу Contact ID
Передача данных по протоколу Contact ID может быть отслежена в окне Устройства ПЦН. Для открытия окна Устройства ПЦН основном окне программы Администратор нажмите кнопку на панели инструментов или в Меню выберите Устройства ПЦН.
В окне Устройства ПЦН отображается список зарегистрированных приемно-передающих устройств, их состояние и параметры. Для приемно-передающего устройства типа Contact ID передатчик выводится следующая информация:
Имя: имя приемно-передающего устройства и его текущее состояние:
— функционирует успешно;
— ошибка функционирования.
Тип: тип устройства приемно-передающего устройства.
Порт: IP-адрес (или COM-порт), на который выполняется передача данных;
Состояние (Работает / Остановлен): состояние приемно-передающего устройства.
Информация:
в очереди: количество сообщений, ожидающих отправки на сервер сторонней системы;
отправлено: количество сообщений, успешно отправленных на сервер сторонней системы;
потеряно: количество сообщений, отправленных на сервер сторонней системы, но не доставленных (подсчет потерянных сообщений ведется, только если в устройстве ПЦН Contact ID передатчик не установлен флаг Без подтверждения доставки;
не транскодировано: количество сообщений в формате MSRV, которые не были переведены в формат Contact ID.
Описание: описание приемно-передающего устройства (введенное пользователем).
Если в параметрах устройства Contact ID передатчик установлен флаг Запись логов, то будет вестись протокол работы устройства, который может быть использован для контроля приема данных и выявления неисправностей. Протокол работы устройства можно посмотреть в файле MS_ServerCOMX.log (где X — номер COM-порта, через который работает устройство) или MS_Server_X.log (где X — IP-адрес сервера-адресата) в папке установки ПО STEMAX.
