Описание протокола 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
- С помощью любого современного браузера зайдите на страницу вашего сервера 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.1 | 861.1 |
ContactID | Андромеда | Именование |
---|---|---|
147.1 | E147 | Тревога: Нет связи с радиодатчиком |
147.3 | R147 | Восст: Нет связи с радиодатчиком |
305.1 | E305 | Внимание: Перезагрузка системы |
656.1 | E656 | TCP/IP объект вышел на связь |
656.3 | R656 | TCP/IP связь с объектом завершена |
761.1 | E761 | GPRS SIM1 связь с объектом завершена |
761.3 | R761 | GPRS SIM1 объект вышел на связь |
762.1 | E762 | GPRS SIM2 связь с объектом завершена |
762.3 | R762 | GPRS SIM2 объект вышел на связь |
763.1 | E763 | LAN связь с объектом завершена |
763.3 | R763 | LAN объект вышел на связь |
764.1 | E764 | WiFi связь с объектом завершена |
764.3 | R764 | WiFi объект вышел на связь |
966.3 | R966 | LAN связь с объектом завершена |
965.3 | R965 | LAN объект вышел на связь |
Связанные статьи: