Описание протокола 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).

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

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

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

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

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

  • Нажмите "Добавить...";
  • Выберите "Источники событий по TCP/IP", нажмите "OK";

  • В окне "Источники событий" выберите искомый источник, нажмите "Свойства";

  • На вкладке "Общие" в поле "Описание источника событий" напишите "RITM.LINK";
  • На вкладке "Общие" включите флажок "Источник событий включен";

  • На вкладке "Приемник событий" укажите адрес интерфейса 0.0.0.0 (все сетевые интерфейсы ПК) и любой свободный TCP порт, например 10003;

  • Нажмите "OK".


Настройка брандмауэра защитника Windows

Если RITM.LINK установлен на ВМ, которая запущена на том же ПК, что и Андромеда, то настраивать firewall (брандмауэр, межсетевой экран) не нужно. Если же Андромеда запущена на одном ПК, а ВМ RITM.LINK - на другом, то на ПК с Андромедой в "Брандмауэр защитника Windows" в "Правила для входящих подключений" добавьте ещё одно правило, разрешающее подключение на порт TCP, который вы указали в источнике событий.

Другой способ - запустите командную строку (cmd.exe или Windows PowerShell) "Запуск от имени администратора".

И выполните:

netsh advfirewall firewall add rule name="RITM.LINK" dir=in action=allow protocol=TCP localport=10003

Если у вас установлен дополнительный межсетевой экран, то настройте его соответствующим образом.



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

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

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

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

root

password

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

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

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

Если у вас несколько входящих потоков, данные по которым нужно транслировать  в Андромеда, то для каждого входящего потока создайте трансляцию.


Соответствие событий в приборах РИТМ и в Андромеда "Центр охраны".

RITM.LINK формирует события, описания которых отсутствует в "Центр охраны" или они именованы по другому. Добавьте или измените события в Андромеда "Настройка системы" (SysSetUp). Полный список событий приборов РИТМ вы можете увидеть в приложении GEO.RITM: "Настройки"  "Справочник событий".

Также вы можете подменять события в RITM.LINK при трансляции. В настройках трансляции на вкладке "События" укажите искомое событие и то событие, на которое хотите его заменить. Пример: заменить событие "GPRS SIM1 связь с объектом завершена" на новое событие для Андромеды E861, чтобы не редактировать уже созданное в Андромеде событие 761.1.

ВходящееИсходящее
761.1861.1


ContactIDАндромедаИменование
147.1E147Тревога: Нет связи с радиодатчиком
147.3R147Восст: Нет связи с радиодатчиком
305.1E305Внимание: Перезагрузка системы
656.1E656TCP/IP объект вышел на связь
656.3R656TCP/IP связь с объектом завершена
761.1E761GPRS SIM1 связь с объектом завершена
761.3R761GPRS SIM1 объект вышел на связь
762.1E762GPRS SIM2 связь с объектом завершена
762.3R762GPRS SIM2 объект вышел на связь
763.1E763LAN связь с объектом завершена
763.3R763LAN объект вышел на связь
764.1E764WiFi связь с объектом завершена
764.3R764WiFi объект вышел на связь
966.3R966LAN связь с объектом завершена
965.3R965LAN объект вышел на связь

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