Интеграция со сторонними производителями по протоколу SurGard
Surgard в СПИ КРОС
Это протоколы специально разработаны для обмена информацией между производителями ПО, так как на аппаратном уровне каждый производитель ПО и приборов использует свои протоколы и шифрование.
SurGard - этот стандарт устанавливает протокол связи, который был разработан и полностью принадлежит
ADEMCO Group, подразделение Pittway Corporation. Он публикуется в Security Industry Association
(SIA), как промышленный стандарт безопасности де-факто. Ограничений на его использование нет.
- Часовой пояс - часовой пояс в котором работает ОП.
- Адрес (IP или Доменное имя) - В этом поле необходимо указать IP-адрес(IPv4) в формате "aaa.bbb.ccc.ddd" или доменное имя компьютера или маршрутизатора, на который буден транслироваться поток данных.
- TCP порт - Порт по которому будет осуществляться соединение с сервером-приёмником. По-умолчанию используется порт:7000, но можно использовать порт указанный на принимающей стороне или порты заданные в настройках драйвера и ОО.
- Использовать SSL шифрование - если есть SSL сертификат, то система позволяет транслировать данные по зашифрованному каналу.
- TCP таймаут (мс) - максимально допустимое время в миллисекундах, в течении которого должен передаваться пакет информации.
- PING Период (сек) - период проверки доступности сервера, принимающего сообщения.
- Период отправки текстовых сообщений (сек) - По-умолчанию "0" - постоянно. Можно указать периодичность отправки сообщений в секундах.
- Таблица перекодировки - назначение таблицы кодов сообщений, которая должна соответствовать таблице сообщений принимающей системы.
- Блокировать приборы, приостановленные на прогон - не передавать информацию от приборов, которые заблокированы или находятся на техническом обслуживании.
- Блокировать приборы приостановленные на прогон - Информация по заблокированным или находящимся в режиме прогона приборам передаваться не будет.
- Передавать идентификатор в десятичном формате - в комплексе КРОС идентификатор приборов передается в шестнадцатеричном формате, для совместимости с другими производителями можно изменить передачу идентификатора на десятеричный. При этом диапазон идентификаторов в первом случае ограничивается 0..65535, во втором 0..9999. Установка зависит от возможностей внешнего приемника.
- Ожидать подтверждения о получении пакета данных - в основном требуется при использовании нестабильных каналов связи, для проверки целостности, передаваемых данных.По умолчанию драйвер передатчик ожидает подтверждения от внешнего приемника о получении для каждого отправленного пакета. Этим достигается гарантированность доставки данных. Этот параметр позволяет отключить ожидание подтверждений и отправлять поток данных без гарантии доставки.
- Ожидать подтверждения о получении пакета PING - желательно использовать на нестабильных каналах передачи данных, во избежание потерь при их передаче. Данный функционал проверяет наличие стабильного канала связи.
- Кодировать порт и канал источника - позволяет создавать зашифрованный канал передачи данных. Однако существует некоторая опасность того, что на принимающей стороне может не поддерживаться алгоритм шифрования в связи с различием версий драйверов Surgard. Параметр задает способ формирования заголовка SurGard сообщения. По умолчанию номер порта и номер канала станавливаются в 1, и заголовок выглядит как “5011 18”.Если параметр установлен, то в качестве номера порта устанавливается порядковый номер порта охранной организации, на который было принято исходное сообщение, в качестве номера канала - порядковый номер канала передачи данных прибора, по которому было принято исходное сообщение. Параметры заголовка устанавливаются только если существует такая возможность.
- Префикс для кода радиоустройства - параметр, позволяющий отличить проводные приборы от радиоканальных при обработке сообщений.
- Префикс для кода расширителя - параметр, позволяющий отличить расширитель от основного прибора при обработке сообщений.
Вид передаваемой посылки
5011 180290E65404000
Указатель CID – 18
Номер объекта — 0656 в hex 290
Если в настройках трансляции установить параметр "Передавать идентификатор в десятичном формате", то Номер объекта будет передаваться в десятичной системе, а не в hex(шестнадцатиричном)
Тревога\Восстановление — 0\1 или E\R
Код тревоги — 654
Номер раздела — 04
Номер шлейфа — 000
Входящее соединение (в КРОС) для получения данных от сторонних систем
Настройка драйвера на собственном сервере КРОС
- Войти под учетной записью Суперадминистратора
- Активировать драйвер TcpSurgard
- Расположение драйвера: Сервер – Приемники
- Выбрать редактирование драйвера.
- В настройках драйвера выбрать таблицу перекодировки и настроить список портов для входящих сообщений.
- Для активации отметить галочку в поле «Драйвер активен» и перезагрузить сервер.
Если данные принимаются через облачный сервер KPOC (Jupiter8.ru) , то активировать и настраивать приемник не нужно, необходимо знать только порт, закрепленный за Вашей охранной организацией.
Создание карточки прибора.
- Если для трансляции данных с приборов используется протокол Surgard, то на сервере КРОС, принимающем поток событий необходимо создать виртуальный прибор или приборы.
Для этого необходимо:
- Войти под учетной записью Администратор охранного предприятия
- Создать прибор. Указать его наименование и прочие учетные данные. Путь: Клиенты – Приборы - Редактировать или Добавить
- В карточке прибора вкладка «Каналы связи», следует выбрать для редактирования Канал Приема потока данных Surgard TCP или добавить новый канал, нажав и выбрав тип драйвера Канал Приема потока данных Surgard TCP.
- В поле Порт указать порт закрепленный за Вашей охранной организацией для TCP Surgard.
- Задать идентификатор Contact ID, по которому будет идентифицироваться передающий прибор из всего входящего потока. Идентификатор должен соответствовать разрядности, используемой в Surgard, например 1, 10, 100, 4056 и т.п. Как правило его значение передается администратором ОО с передающего сервера. CID приемника и передатчика должны совпадать.
- C версии сервера 2.5.8 порт вводится автоматически. Он берется из списка портов разрешенных для использования в данной ОО. Если для приема используется несколько портов, то подставляться будет первый из списка, разрешенных для использования Surgard.
- После создания канала необходимо проверить ленту событий в карточке прибора, вкладка "СОБЫТИЯ". При постановке на охрану, снятии и возникновении тревожных событий, в протоколе событий появятся соответствующие записи.
- Протокол Surgard передает события только по мере их появления, поэтому периодически будет возникать сообщение "Неисправность канала" и "Потеря связи", чтобы исключить данные сообщения, в карточке прибора, вкладка "ОСНОВНЫЕ" допускается включение параметра "Отключить контроль неисправности каналов связи".
- После завершения процесса регистрации и проверки прибора, можно создать договор, объект и указать прибор в карточке объекта.
Настройка исходящего соединения. Из сервера КРОС в стороннее ПО
Настройка драйвера на сервере КРОС (частный сервер)
- Войти под учетной записью Суперадминистратора
По умолчанию
login: superadmin
pass: superadmin - Активировать драйвер TcpSurgard или TcpSurgard V4. Без активного драйвера приемника не будет работать и передатчик!
- Расположение драйвера: Сервер – Приемники
- Нажать редактирование драйвера
- Активация происходит путем установки галочки «Драйвер активен» с последующей перезагрузкой сервера
Настройка трансляции Surgard
Описание параметров трансляции
Это протоколы специально разработаны для обмена информацией между производителями ПО, так как на аппаратном уровне каждый производитель ПО и приборов использует свои протоколы и шифрование.
SurGard - этот стандарт устанавливает протокол связи, который был разработан и полностью принадлежит
ADEMCO Group, подразделение Pittway Corporation. Он публикуется в Security Industry Association
(SIA), как промышленный стандарт безопасности де-факто. Ограничений на его использование нет.
- Часовой пояс - часовой пояс в котором работает ОП.
- Адрес (IP или Доменное имя) - В этом поле необходимо указать IP-адрес(IPv4) в формате "aaa.bbb.ccc.ddd" или доменное имя компьютера или маршрутизатора, на который буден транслироваться поток данных.
- TCP порт - Порт по которому будет осуществляться соединение с сервером-приёмником. По-умолчанию используется порт:7000, но можно использовать порт указанный на принимающей стороне или порты заданные в настройках драйвера и ОО.
- Использовать SSL шифрование - если есть SSL сертификат, то система позволяет транслировать данные по зашифрованному каналу.
- TCP таймаут (мс) - максимально допустимое время в миллисекундах, в течении которого должен передаваться пакет информации.
- PING Период (сек) - период проверки доступности сервера, принимающего сообщения.
- Период отправки текстовых сообщений (сек) - По-умолчанию "0" - постоянно. Можно указать периодичность отправки сообщений в секундах.
- Таблица перекодировки - назначение таблицы кодов сообщений, которая должна соответствовать таблице сообщений принимающей системы.
- Блокировать приборы, приостановленные на прогон - не передавать информацию от приборов, которые заблокированы или находятся на техническом обслуживании.
- Блокировать приборы приостановленные на прогон - Информация по заблокированным или находящимся в режиме прогона приборам передаваться не будет.
- Передавать идентификатор в десятичном формате - в комплексе КРОС идентификатор приборов передается в шестнадцатеричном формате, для совместимости с другими производителями можно изменить передачу идентификатора на десятеричный. При этом диапазон идентификаторов в первом случае ограничивается 0..65535, во втором 0..9999. Установка зависит от возможностей внешнего приемника.
- Ожидать подтверждения о получении пакета данных - в основном требуется при использовании нестабильных каналов связи, для проверки целостности, передаваемых данных.По умолчанию драйвер передатчик ожидает подтверждения от внешнего приемника о получении для каждого отправленного пакета. Этим достигается гарантированность доставки данных. Этот параметр позволяет отключить ожидание подтверждений и отправлять поток данных без гарантии доставки.
- Ожидать подтверждения о получении пакета PING - желательно использовать на нестабильных каналах передачи данных, во избежание потерь при их передаче. Данный функционал проверяет наличие стабильного канала связи.
- Кодировать порт и канал источника - позволяет создавать зашифрованный канал передачи данных. Однако существует некоторая опасность того, что на принимающей стороне может не поддерживаться алгоритм шифрования в связи с различием версий драйверов Surgard. Параметр задает способ формирования заголовка SurGard сообщения. По умолчанию номер порта и номер канала станавливаются в 1, и заголовок выглядит как “5011 18”.Если параметр установлен, то в качестве номера порта устанавливается порядковый номер порта охранной организации, на который было принято исходное сообщение, в качестве номера канала - порядковый номер канала передачи данных прибора, по которому было принято исходное сообщение. Параметры заголовка устанавливаются только если существует такая возможность.
- Префикс для кода радиоустройства - параметр, позволяющий отличить проводные приборы от радиоканальных при обработке сообщений.
- Префикс для кода расширителя - параметр, позволяющий отличить расширитель от основного прибора при обработке сообщений.
Вкладка Транслятор
- Заходим под учетной записью Администратора охранного предприятия
- Заходим: Охрана – Реквизиты – Вкладка Параметры
- Отключить параметр "Удалять неактивные приборы в инженерном режиме"' и "Период неактивности инженерных приборов до удаления (сек)" устанавливаем значение «0» (Если не привязывать приборы к объектам, то они удалятся через установленное время)
- Заходим: Сервер – Трансляции
- В правом верхнем углу нажимаем «Добавить трансляцию»
- Вводим наименование трансляции (желательно с наименованием организации)
- Выбираем драйвер "Трансляция данных по протоколу TCP Surgard" или "Трансляция данных по протоколу TCP Surgard V4", если требуется передавать IMEI в качестве уникального идентификатора дополнительно к идентификатору CID (расширенный SurGard).
- Устанавливаем галочки: Активен, Инженерный режим (если прибор не привязывается к объекту). Все приборы, находящиеся в "Инженерном режиме" и имеющие канал "TCP Surgard" будут включены в эту трансляцию.
- Вводим Адрес (IP4 или Доменное имя) приемника (адрес компьютера, на который будет передаваться трансляция)
- Вводим TCP Порт приемника (порт по которому будет передаваться трансляция)
- Таблица перекодировки по умолчанию "Базовая". В случае если требуется корректировка соответствий сообщений для передачи в стороннее ПО, например подмена кода Contact ID, то необходимо сначала создать индивидуальную таблицу (Сервер - Таблицы - добавить таблицу) и отредактировать в ней необходимые сообщения
- Передавать идентификатор в десятичном формате - параметр настраивается для конвертации кода объекта в десятичный формат. (Только для драйвера "Трансляция данных по протоколу TCP Surgard")
- Нажимаем «Сохранить»
Вкладка "Зона Ответственности
Все объекты указанные в этой вкладке будут включены в трансляцию.
В том случае, когда необходимо ограничить передачу информации по объектам или, когда есть единый центр охраны и от него настраивается передача информации, не связанным между собой конечным потребителям этой информации, в этом случае можно ограничить передачу данных, задав зону ответственности.
Задать зону ответственности можно несколькими способами:
- Выбор типов объектов - использование фильтра позволит выбрать объекты по типу, который был назначен объекту при заполнении карточки объекта. При этом в окне Результат фильтрации будут отмечены те объекты, которые отвечают, выбранному типу или типам.
- Метки - Несколько объектов, помимо типа, можно объединить в группы используя метки. Если указать эту метку, то объекты с этой меткой попадут в Результат фильтрации.
- Исключения - объекты с указанной здесь меткой будут исключены из списка Результат фильтрации.
- Выбрать зону ответственности, используя редактор зоны. Для этого в левой части окна, там где расположена карта, необходимо нажать пиктограмму с пятиугольником и вызвать редактор, создания зоны. Далее, следуя подсказкам рядом с маркером вы создадите зону, после чего в окне Результат фильтрации будут отмечены те объекты, которые попали в эту зону. Используя знаки + и - можно увеличить или уменьшить масштаб карты. Можно создать несколько зон ответственности.
- Редактировать зону ответственности. Если есть необходимость редактировать зону ответственности, то в этом случае необходимо нажать на значок Редактировать. На карте активируются границы зоны и появятся дополнительные точки, передвигая которые, можно увеличить или уменьшить зону. После окончания редактирования, необходимо нажать надпись "Сохранить" или "Отменить", рядом со значком Редактировать.
- Удалить зону ответственности - если возникла необходимость в удалении зоны ответственности. Необходимо выбрать значок Удалить и указать зону, которую надо удалить. После удаления зоны Результат фильтрации должен измениться.
- Сброс всех фильтров - сбросит все результаты фильтрации.
- Сброс - вернет состояние зоны ответственности на значение по-умолчанию.
При создании зоны ответственности, методы фильтрации можно комбинировать.
После задания фильтров в окне Результаты фильтрации можно дополнительно отметить или снять отметку выделения с объекта.
В результате выполненных действий список объектов отображаемых, в АРМ, трансляциях или у пользователя будет ограничен.
В начало статьи
Настройка прибора
- Настроить прибор через конфигуратор для работы с сервером КРОС (обязательно сбросить ключ шифрации на значение по умолчанию, если прибор подключается в первый раз)
- Зайти: Клиенты-Приборы
- Нажать редактирование прибора
- Открыть вкладку «Каналы связи»
- Проверить наличие канала TcpSurgard. Можно задать автоматическое создание канала для всех приборов, либо создать канал вручную. Для автоматического создания канала необходимо выставить галочку "Охрана" - "Реквизиты" - "Параметры" - Автоматически создавать канал Contact-ID для новых приборов. Для ручного создания канал необходимо нажать на синюю кнопку с плюсом, добавить канал с драйвером "Прием потока данных Surgard TCP", не удаляя при этом канал PK4.
- В настройках канала указать: Идентификатор Contact ID (Идентификатор, который передается в стороннее ПО, например, номер объекта), его разрядность должна соответствовать разрядности, принятой в протоколе Surgard.
- Если используется трансляция TcpSurgard V4, то ввести IMEI (8 символов)
- Нажать «Сохранить»
Примеры интеграции
Для передачи сообщений в КРОС необходимо использовать программу перенаправления COM-портов в TCP-поток, например: VSPE (Virtual serial port emulator)
ПЦН Мираж при трансляции данных использует номер объектового прибора, а не номер объекта из карточки. Номер прибора может быть различной длины и превышать стандартные для протокола Sur-Gard 4 цифры.
В ПЦН Мираж предусмотрена возможность задавать принудительно номер объекта для Contact ID передатчика в карточке объекта на вкладке "Дополнительные параметры"
Stels(Стелс) - ПЦН Мираж
1. Запустить модуль Администратор:
2. Открыть Устройства ПЦН:
3. На списке нажать правой кнопкой мыши, выбрать Создать. В появившемся списке выбрать Contact ID передатчик:
4. В настройках порта задать свободный CОM-порт (если СOM-портов нет физически, то использовать программу эмуляции COM-портов Virtual Serial Ports Emulator), остальные значения можно оставить по умолчанию (9600,8, Нет,1):
Двухсторонняя передача данных
В ПО “Stemax” (Мираж) используется двухсторонняя передача данных по протоколу Sergard. Если Вы планируете использовать в ПО Мираж и приемник и передатчик, то необходимо будет сделать дополнительные настройки с карточкой которая будет принимать информацию от приборов системы Сатурн или Юпитер.
Это карточка объекта, закладка “Дополнительные параметры” в ней делаются настройки по протоколам с которыми будет работать данный объект.
Вы настраиваете два протокола:
1. “Канал GPRS 1/Contact ID”:
• Тип источника устанавливаем - Contact ID;
• Применяется - “Да”;
• Два последних параметра выставляете на свое усмотрение.
2. “Contact ID передатчик”:
• Имя направления - выставляем отличное от того, что мы используем;
• Номер объекта - также не должно соответствовать реальному;
• Номер раздела - аналогично номеру объекта.
Выполнив данные настройки, система Мираж начнет принимать информацию от прибора с ПО Юпитер-КРОС. При этом мы не будем получать ответную информацию от нашего прибора с ПО Мираж.
И начало статьи
Ritm (Ритм) - PCN6
Условия для создания исходящего потока от PCN6
Для стабильной работы системы мониторинга по данному каналу должны быть обеспечены следующие условия:
- используемые TCP-порты должны быть открыты;
- интернет соединение должно иметь скорость не менее 512 кБ/с;
- IP-адрес принимающего сервера должен быть «белый» и статичный.
Настройки исходящего TCP DSC Surgard
Для добавления потоков в InetServer необходимо нажать правой кнопкой мыши на соответствующую папку и выбрать «Новый поток».
Для настройки потока необходимо задать:
- Включить — активирует данный поток,
- Наименование — уникальное название для потока, так как в одном InetServer может быть несколько потоков.
- IP Адрес — адрес ПК, на котором работает сервер КРОС.
- Порт — порт, на который будут отправляться пакеты в КРОС. (На сервере КРОС информацию можно увидеть на главной странице на вкладке Используемые порты - "Прием потока данных Surgard TCP")
- Пауза между подключениями, сек — задержка между переподключениями.
Дополнительно можно указать дополнительные настройки протокола DSC Surgard: номер формата, номер приёмника, линейный блок, префикс АС, таймаут для подтверждения.
В поле «Очередь событий» показано общее количество событий и количество переданных событий.
Информация о работе протоколов в данный момент отображена в поле «Сообщения».
Передача событий из КРОС в PCN6. Настройка входящего DSC Surgard в InetServer
- Выбираем объекты и создаём исходящую трансляцию из сервера КРОС согласно инструкции:"Прием и передача событий в протоколе SurGard"
- В InetServer создаем поток "Сигналы из TCP DSC Surgard". Порт должен соответствовать тому, что указан в исходящей трансляции на сервере КРОС.
Примечание:
рекомендуем в настройках InetServer`a включить автосоздание объектов, для этого необходимо открыть Блокнотом файл Server.ini и в разделе [Global], в настройке AutoCreateObjects установить значение = 1. Сохранить, перезагрузить InetServer.
В начало статьи
Proxyma (Проксима) - ЦС УОП-6 и УОП-5
Центральная станция УОП-6 позволяет выдавать события на СОМ-порт в протоколе SurGard.
Для этого необходимо настроить УОП.
Для передачи сообщений в КРОС необходимо использовать программу перенаправления COM-портов в TCP-поток, например: VSPE (Virtual serial port emulator)
Настройки меняются через интерфейс УОП'а, или с помощью АТ-команд. Подробней описано в инструкции на УОП.
ЦС УОП-5 подключается аналогично.
Охрана и безопасность - ПО Феникс-4
Для приёма сообщений в Феникс-4 необходимо использовать программу перенаправления COM-портов в TCP-поток, например: VSPE (Virtual serial port emulator). Создать COM-порт и связать его с TCP-портом согласно инструкции: Настройка VSPE Выбираем объекты и создаём исходящую трансляцию из сервера КРОС согласно инструкции: "Прием и передача событий в протоколе SurGard"
- В настройках трансляции установить галку "Передавать идентификатор в десятичном формате".
Настройка Феникс-4
1. В «Центре управления» ПО «Феникс» открыть «Настройки», перейти «Источники событий», затем «Станции автодозвона».
2. В появившемся окне в поле «Тип устройства» выбрать «SurGard SG-MLR2», указать в поле «Номер порта» созданный виртуальный Com-порт. Задайте название источника событий "КРОС" и установите V(галочку) Источник событий включён.
3. Перезапустите "Центр управления"
4. Создайте карточки объектов в ПО «Фенкс». Всё готово для приёма событий.
В начало статьи
С.Nord (Си-Норд) - Центр охраны
На компьютере с Центром охраны установить и запустить программу перенаправления COM-портов в TCP-поток, например: VSPE (Virtual serial port emulator). Создать COM-порт и связать его с TCP-портом согласно инструкции: Настройка VSPE
Создаем и настраиваем Источник событий Sur-Gard (см. инструкцию на официальном сайте C.Nord
Выбираем объекты и создаём исходящую трансляцию из сервера КРОС согласно инструкции: "Прием и передача событий в протоколе SurGard"
- В настройках трансляции установить галку "Передавать идентификатор в десятичном формате".
Рубеж НПО - Кобра 8
1. Настроить драйвер программного обеспечения для ПЦН:
Где: [main] ComPort=COM1 ComPortBaudRate=9600 // Данный параметр настраивает скорость работы Com-порта. В зависимости от вида оборудования он может меняться.По умолчанию 9600 n_abs=14 name=14 Attention=00:30:00 PathForSoob= host=localhost FirstNumber=14 // Префикс системы OTS=0 SendK7=0 SendK8=1 HexNum=0 // 0 - не принмать пультовые номера в шестнадцатиричной системе исчисления; 1 - принимать номера в шестнадцатиричной системе исчисления. NotSendToDiskK8=0 LanSh=0 // 0 - отключить прием событий по TCP/IP; 1 - включить прием событий по TCP/IP LanShPort=1026 // - TCP порт для приема событий Caption= [ServerHost]// Адрес и порт Сервера сообщений Address=127.0.0.1 Port=12543 [Razdels] 1_2=1000
2. Настройки сервера сообщений.
В [Drivers] указать: ХХ=29, где ХХ выбранный префикс.
После всех правок перезапустить драйвер и сервер сообщений.
В начало статьи
Предназначена для конвертации из последовательного СОМ-порта в сетевой TСP-порт.
Virtual Serial Port Emulator(VSPE)
Конвертация COM - TCP Подходит для решения задач, когда события нужно передать В или ИЗ COM-порта с трансляцией через TCP-порт.
1. Запустите программу
2. В меню нужно выбрать Устройства-Создать...
3. Выбрать Тип устройства - Connector и нажать Далее
4. В Характеристиках устройства задать COM-порт, по которому будут передаваться данные и нажать Готово
5. Повторить пункт 2
6. Выбрать Тип устройства - TcpClient и нажать Далее
7. Задать такие параметры, как:
- Удаленный TCP хост - IP адрес, на который будут передаваться данные из COM и наоборот из COM в TCP. Если передача осуществляется с КРОС на стороннее ПО, то указывается локальный IP-адрес компьютера.
- Удаленный TCP порт - Порт, закрепленный за Вашей охранной организацией в КРОС, либо порт указанный в трансляции из КРОС.
Пример: Прием потока данных Surgard TCP - 20050
- COM Порт-источник данных - Выбрать порт, который был введен в пункте 4
8. Нажать Готово
9. Запустите эмуляцию, нажав Старт.
Если все верно внизу появится два "OK" (Зеленый цвет).
- Для автоматического запуска VSPE после перезагрузки системы, достаточно создать ярлык для файла с конфигурацией и поместить его в Автозагрузку через Пуск
- Запускать одновременно две конфигурации нельзя. Но можно в одной добавить все необходимые связки и запускать её.