Описание протокола Surgard

Для трансляции событий по стационарным приборам из RITM.LINK (GEO.RITM) в сторонне ПО, используется протокол TCP Surgard. Для получения событий из стороннего ПО в RITM.LINK также используется протокол TCP Surgard. Это очень старый протокол, который изначально был предназначен для передачи событий от центральной мониторинговой станции DSC в компьютер по интерфейсу RS-232. Со временем протокол стал очень популярен и сейчас используется в большинстве пультовых программ. Рассмотрим вариант протокола Surgard для TCP.

Сервер - пультовая программа, которая принимает события, клиент - пультовая программа, которая передаёт события. Клиент подключается к серверу и отправляет события в формате:

5RRLs18AAAAQXYZGGCCC[DC4] 
Где: 

  • 5​ – номер формата; 
  • RR​ – номер приемника;
  • L​ – номер линейного блока;
  • s -​­ пробел;
  • 18​ -­ идентификатор протокола ContactID;
  • AAAA​ – номер объекта - четыре шестнадцатеричные цифры;
  • Q - тип события. Возможные значения - тревога (E) или восстановление (R);
  • XYZ​ – код события в формате ContactID;
  • GG​ – номер раздела события;
  • CCC​ – номер шлейфа или пользователя;
  • [DC4] ​– терминатор (0x14).

Сервер принимает сообщение и отправляет подтверждение о принятых данных клиенту. Подтверждением того, что событие принято, является прием в ответ на событие байта со значением 0x06.

Если после последнего отправленного события прошло 30 секунд, то для поддержания связи, клиент отправляет строку 

1011           @    (0x31,0x30,0x31,0x31,0x20,0x20,0x20,0x20,0x20,0x20,0x20,0x20,0x20,0x20,0x20,0x40,0x20,0x20,0x20,0x20)

Пример посылки в протоколе Surgard

5011 180111R40201004

где

  • 5 - номер формата (Surgard);
  • 01 - номер приёмника (мониторинговая станция);
  • 1 - номер линейного блока (мониторинговая станция);
  • 18​ -­ идентификатор протокола ContactID;
  • 0111 - номер объекта;
  • R - восстановление (взятие);
  • 402 - взятие (постановка) раздела на охрану;
  • 01 - раздел №1;
  • 004 - зона №4 (в случае событий постановки/снятия - это номер пользователя/ключа №4).

  • С помощью любого современного браузера зайдите на страницу вашего сервера RITM.LINK;

    В случае использования виртуальной машины, в адресной строке укажите http://адресвашейвм/idp

  • Введите имя пользователя и пароль;

    Имя пользователя и пароль по умолчанию:

    root

    password

  • Перейдите на страницу "Входящие потоки"
  • Нажмите +"Добавить";
  • Заполните вкладку "Поток":
    • В поле "Наименование" напишите например "Андромеда";
    • Выберите статус "Включен";

  • Перейдите на закладку "Подключение", заполните все поля;
    • Выберите в "Канал связи" - TCP/IP;
    • Протокол - "Input TCP Surgard (Server)";
    • Адрес/IP хоста - "0.0.0.0";
    • Порт - любой свободный TCP порт, например 30001;

  • Нажмите "Сохранить";
  • Перейдите на страницу "Трансляции";
  • Нажмите +"Добавить";
  • Укажите входящий поток, к которому подключается Андромеда и исходящий поток;
  • Нажмите "Сохранить";

Настройка Андромеда «Центр охраны»

  • Щёлкните правой кнопкой мыши в области уведомлений (systray) по "Центр охраны - Менеджер событий";
  • Выберите "Обработчики событий..."

  • Введите пароль;

    По умолчанию для "Администратор" пароль "123456"

  • Откроется окно "Обработчики событий";

  • Нажмите кнопку "Создать группу";
  • Из предложенного списка выберите "Ретранслятор в Sur-Gard", нажмите "OK";

  • Откроется окно "Параметры обработчика (Параметры ...";
  • На вкладке "Общие" заполните поля:
    • "Название обработчика" - введите "RITM.LINK";
    • "Описание обработчика" - введите "Трансляция событий в RITM.LINK";
    • Поставьте флажок "Обработчик включен";

  • На вкладке "Объекты" введите в правое поле номера объектов, через запятую, для трансляции в RITM.LINK;

    Номера объектов должны иметь не более 4 знаков!

    Пример недопустимых номеров объектов: 76302, 238531;

    Пример допустимых номеров: 187, 7623, 42, 9, 3471.

  • Нажмите "<< Добавить" - список объектов заполнится;
  • На вкладке "Классы событий" нажмите "Выделить все";

  • На вкладке "Каналы" поставьте все флажки;

  • Нажмите "OK";
  • Выделите группу "Ретранслятор в Sur-Gard" и нажмите "Свойства";

  • Откроется окно "Параметры группы (Ретранслятор в Su...";
  • На вкладке "Общие" установите флажок "Группа включена";

  • На вкладке "Канал":
    • Выберите "Режим организации соединения" - "Клиент (осуществляет подключение к серверу)";
    • Введите в поле "Адрес сервера" введите адрес ВМ с RITM.LINK или адрес ПК с докер;
    • Введите в поле "Порт" номер TCP порта входящего потока в протоколе Surgard, который предварительно был создан в RITM.LINK;
    • Нажмите "Добавить";

  • На вкладке "Параметры":
    • Введите "Интервал отправки HeartBeat (с)" значение "30";
    • Снимите флажок "Включать дату и время в события";

  • Нажмите "OK";
  • Возле названия группы и названия обработчика отобразится ✅;

Проверка поступления событий

  • Сформируйте события на объектовом приборе, который добавлен в трансляцию;
  • В RITM.LINK на странице "Приборы" в строке поиска введите название входящего потока в протоколе Surgard - отобразятся все объекты, события по которым были приняты в данном входящем потоке.


Связанные статьи: