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

Материал из Юпитер-8
Строка 31: Строка 31:
Для этого необходимо:<br>
Для этого необходимо:<br>
* Войти под учетной записью '''Администратор охранного предприятия'''
* Войти под учетной записью '''Администратор охранного предприятия'''
*       Создать прибор.
*   Создать прибор. Указать его наименование и прочие учетные данные. Путь: '''Клиенты – Приборы - Редактировать''' [[File:Edit_blue.png|40px|]] или '''Добавить''' [[file:Add_blue.png|40px]]
* Путь: '''Клиенты – Приборы - Редактировать''' [[File:Edit_blue.png|40px|]] или '''Добавить''' [[file:Add_blue.png|40px]]
** В карточке прибора вкладка '''«Каналы связи»''' выбрать драйвер TCP Surgard или добавить его, нажав [[file:Add_green.png|40px]].
* В карточке прибора вкладка '''«Каналы связи»''' выбрать драйвер TCP Surgard или добавить его, нажав [[file:Add_green.png|40px]].
 
[[File:Device_Channel_Surgard.png|border|600px|]]
[[File:Device_Channel_Surgard.png|border|600px|]]
 
** В поле '''Порт''' указать порт закрепленный за Вашей охранной организацией для TCP Surgard
* В поле '''Порт''' указать порт закрепленный за Вашей охранной организацией для TCP Surgard
<div style="border-left: 4px solid RED; padding-left:8px; border-right: 4px solid RED; padding-right:8px;">
<div style="border-left: 4px solid RED; padding-left:8px; border-right: 4px solid RED; padding-right:8px;">
с версии сервера 2.5.8 порт вводится автоматически. Он берется из списка разрешенных данной ОО портов.<br>
с версии сервера 2.5.8 порт вводится автоматически. Он берется из списка разрешенных данной ОО портов.<br>
Строка 43: Строка 40:
</div>
</div>
* '''Задать идентификатор Contact ID''', по которому будет идентифицироваться передающий прибор из всего входящего потока. Идентификатор должен соответствовать разрядности, используемой в Surgard. Как правило его значение передается администратором ОО с передающего сервера. CID приемника и передатчика должны совпадать.
* '''Задать идентификатор Contact ID''', по которому будет идентифицироваться передающий прибор из всего входящего потока. Идентификатор должен соответствовать разрядности, используемой в Surgard. Как правило его значение передается администратором ОО с передающего сервера. CID приемника и передатчика должны совпадать.
После создания канала необходимо проверить ленту событий в карточке прибора, вкладка "СОБЫТИЯ". При постановке на охрану, снятии и возникновении тревожных событий, в протоколе событий появятся соответствующие записи.<br>
Протокол Surgard передает события только по мере их появления, поэтому периодически будет возникать сообщение '''"Неисправность канала"''' и '''"Потеря связи"''', чтобы исключить данные сообщения, в карточке прибора, вкладка "ОСНОВНЫЕ" допускается включение параметра '''''"Отключить контроль неисправности каналов связи"'''''.
<br clear="both" />
[[#top|В начало статьи]]


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

Версия от 14:19, 18 января 2023

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

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

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

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

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

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

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

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

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

Если в настройках ОО включен параметр Автоматически создавать канал Contact-ID для новых приборов, то при подключении прибора, канал Surgard создаётся автоматически, но его также можно настроить в ручную.
Для этого необходимо:

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

    • В поле Порт указать порт закрепленный за Вашей охранной организацией для TCP Surgard

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

  • Задать идентификатор Contact ID, по которому будет идентифицироваться передающий прибор из всего входящего потока. Идентификатор должен соответствовать разрядности, используемой в Surgard. Как правило его значение передается администратором ОО с передающего сервера. CID приемника и передатчика должны совпадать.

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

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

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

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

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

  • Заходим под учетной записью Администратора охранного предприятия
  • Заходим: Охрана – Реквизиты – Вкладка Параметры
  • В строке Удалять неактивные приборы в инженерном режиме через (минут) устанавливаем значение «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 символов)
  • Нажать «Сохранить»


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