Шаблон:Интеграция со сторонним ПО по протоколу Surgard

Вид передаваемой посылки

5011 180290E65404000
Указатель CID – 18
Номер объекта — 0656 в hex 290

Если в настройках трансляции установить параметр "Передавать идентификатор в десятичном формате", то Номер объекта будет передаваться в десятичной системе, а не в hex(шестнадцатиричном)

Тревога\Восстановление — 0\1 или E\R
Код тревоги — 654
Номер раздела — 04
Номер шлейфа — 000

Входящее соединение (в КРОС) для получения данных от сторонних систем

Настройка драйвера на собственном сервере КРОС

• Войти под учетной записью Суперадминистратора
• Активировать драйвер TcpSurgard

• Расположение драйвера: Сервер – Приемники
• Выбрать редактирование драйвера.
• В настройках драйвера выбрать таблицу перекодировки и настроить список портов для входящих сообщений.
• Для активации отметить галочку в поле «Драйвер активен» и перезагрузить сервер.

Если данные принимаются через облачный сервер KPOC (Jupiter8.ru) , то активировать и настраивать приемник не нужно, необходимо знать только порт, закрепленный за Вашей охранной организацией.

Создание карточки прибора.

Если для трансляции данных с приборов используется протокол Surgard, то на сервере КРОС, принимающем поток событий необходимо создать виртуальный прибор или приборы.

Для этого необходимо:

• Войти под учетной записью Администратор охранного предприятия
• Создать прибор. Указать его наименование и прочие учетные данные. Путь: Клиенты – Приборы - Редактировать или Добавить
  • В карточке прибора вкладка «Каналы связи» выбрать драйвер TCP Surgard или добавить его, нажав .
  • В поле Порт указать порт закрепленный за Вашей охранной организацией для TCP Surgard.
  • Задать идентификатор Contact ID, по которому будет идентифицироваться передающий прибор из всего входящего потока. Идентификатор должен соответствовать разрядности, используемой в Surgard. Как правило его значение передается администратором ОО с передающего сервера. CID приемника и передатчика должны совпадать.
    

C версии сервера 2.5.8 порт вводится автоматически. Он берется из списка портов разрешенных для использования в данной ОО. Если для приема используется несколько портов, то подставляться будет первый из списка, разрешенных для использования Surgard.

После создания канала необходимо проверить ленту событий в карточке прибора, вкладка "СОБЫТИЯ". При постановке на охрану, снятии и возникновении тревожных событий, в протоколе событий появятся соответствующие записи.

Протокол Surgard передает события только по мере их появления, поэтому периодически будет возникать сообщение "Неисправность канала" и "Потеря связи", чтобы исключить данные сообщения, в карточке прибора, вкладка "ОСНОВНЫЕ" допускается включение параметра "Отключить контроль неисправности каналов связи".

После завершения процесса регистрации и проверки прибора, можно создать договор, объект и указать прибор в карточке объекта.

В начало статьи

Настройка исходящего соединения. Из сервера КРОС в стороннее ПО

Настройка драйвера на сервере КРОС (частный сервер)

• Войти под учетной записью Суперадминистратора
  По умолчанию
  login: superadmin
  pass: superadmin
• Активировать драйвер TcpSurgard или TcpSurgard V4. Без активного драйвера приемника не будет работать и передатчик!
• Расположение драйвера: Сервер – Приемники
• Нажать редактирование драйвера
• Активация происходит путем установки галочки «Драйвер активен» с последующей перезагрузкой сервера

Настройка трансляции Surgard

Это протоколы специально разработаны для обмена информацией между производителями ПО, так как на аппаратном уровне каждый производитель ПО и приборов использует свои протоколы и шифрование.

SurGard - этот стандарт устанавливает протокол связи, который был разработан и полностью принадлежит ADEMCO Group, подразделение Pittway Corporation. Он публикуется в Security Industry Association (SIA), как промышленный стандарт безопасности де-факто. Ограничений на его использование нет.

SurGard V4 - это дальнейшее развитие протокола SurGard. В настоящее время поддерживается не всеми производителями.

• Часовой пояс - часовой пояс в котором работает ОП.
• Адрес (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).
• Устанавливаем галочки: Активен, Инженерный режим (если прибор не привязывается к объекту)
• Вводим Адрес (IP4 или Доменное имя) приемника (адрес компьютера, на который будет передаваться трансляция)
• Вводим TCP Порт приемника (порт по которому будет передаваться трансляция)
• Таблица перекодировки по умолчанию "Базовая". В случае если требуется корректировка соответствий сообщений для передачи в стороннее ПО, например подмена кода Contact ID, то необходимо сначала создать индивидуальную таблицу (Сервер - Таблицы - добавить таблицу) и отредактировать в ней необходимые сообщения
• Передавать идентификатор в десятичном формате - параметр настраивается для конвертации кода объекта в десятичный формат. (Только для драйвера "Трансляция данных по протоколу TCP Surgard")
• Нажимаем «Сохранить»

В начало статьи

Настройка прибора

• Настроить прибор через конфигуратор для работы с сервером КРОС (Не забыть сбросить ключ шифрации По-умолчанию, если прибор подключается в первый раз)
• Зайти: Клиенты-Приборы
• Нажать редактирование прибора
• Открыть вкладку «Каналы связи»
• Проверить наличие канала TcpSurgard. Можно задать автоматическое создание канала для всех приборов, либо создать канал вручную. Для автоматического создания канала необходимо выставить галочку "Охрана" - "Реквизиты" - "Параметры" - Автоматически создавать канал Contact-ID для новых приборов. Для ручного создания канал необходимо нажать на синюю кнопку с плюсом, добавить канал с драйвером "Прием потока данных Surgard TCP", не удаляя при этом канал PK4.
• В настройках канала указать: Идентификатор Contact ID (Идентификатор, который передается в стороннее ПО\номер объекта)
• Если используется трансляция TcpSurgard V4, то ввести IMEI (8 символов)
• Нажать «Сохранить»

В начало статьи