Руководство пользователя Ajax Translator

Обновлено

Ajax Translator — это программа для коммуникации систем безопасности Ajax со сторонним мониторинговым ПО. Выступая связующим звеном между хабом и пультом централизованного наблюдения, Ajax Translator конвертирует полученные от хаба уведомления в события протокола, поддерживаемого ПЦН.

  • ПО, поддерживающее протокол Sur-Gard (Contact ID)
  • ПО, поддерживающее протокол SIA DC-09
  • Manitou
  • SBN
  • ABsistemDC(NG)v2

Как получить Ajax Translator

Чтобы получить Ajax Translator, заполните форму на сайте. Если форма заполнена корректно, то в течение 48 часов на указанный вами email будет выслана ссылка на актуальную версию Ajax Translator, а также логин и пароль для авторизации.

Ваша компания также будет добавлена в список Охранные компании в приложении Ajax Security System. Это позволит получать запросы пользователей на подключение охранного мониторинга прямо в Ajax Translator: пользователь выбирает вашу компанию из списка в приложении, нажимает Отправить запрос на мониторинг, запрос автоматически направляется на email, закрепленный за охранной компанией.

Системные требования

Характеристика Минимальные Рекомендуемые
Процессор Intel Core I3 (2 ядра) Intel Core I5 ​​(4 и больше ядер)
RAM 4 ГБ 8 ГБ
HDD 128 ГБ свободного места Более 128 ГБ свободного места
ОС MS Windows 7, 8, 10, UNIX системы с Java machine
Version 8 Update 73 (Oracle)
Сеть 100 Mb/s

Установка

Распакуйте исполняемый файл Ajax_Translator.jar в системную папку вашей ОС, следуя подсказкам. Чтобы найти исполняемый файл, распакуйте загруженный по ссылке архив в папку Ajax Translator.

В папке находится:

ajax translator

Ajax_Translator.jar — установочный файл программы Ajax Translator.

clientSettings.properties — файл с настройками по умолчанию для Ajax Translator.

advanced-virtual-com-port.zip, com0com (x86, x64).zip, vspd for example.exe — программы для создания виртуальных COM портов. Учитывайте, что эти программы работают только на ОС Windows.

Translator app RU, Ajax Translator EN — краткие инструкции по использованию программы на двух языках в формате PDF.

В папке, в которой установлен Ajax Translator, находятся исполняемый файл и другие сервисные папки:

ajax translator

log — папка, в которой хранятся логи работы Ajax Translator. При неполадках в работе программы данные из этой папки отправляются в службу поддержки Ajax Systems для анализа.

settings — папка, в которой хранится файл конфигурации Ajax Translator, а также файлы базы данных и их резервные копии.

Не переименовывайте, не меняйте расположение папок и файлов внутри папки Translator Dist! Это приведет к неполадкам в работе программы.

Translator_версия_.jar — приложение Ajax Translator с номером версии в названии файла. Для запуска приложения на компьютере должна быть установлена последняя версия Java, которую можно загрузить с официального сайта.

Не перемещайте исполняемый файл! Он должен оставаться в папке Translator Dist. Для удобства запуска — создайте ярлык на рабочем столе.

После успешной распаковки и запуска исполняемого файла Translator_версия_.jar вы увидите окно входа в учетную запись.

ajax translator

Скопируйте и вставьте логин и пароль, полученный от Службы поддержки. Используйте опцию Включить авто-логин, чтобы не вводить логин и пароль при каждом запуске программы.

Для автозагрузки Ajax Translator создайте ярлык исполняемого файла и настройте автозагрузку согласно инструкциям вашей операционной системы.

Как обновить Ajax Translator

Ajax Translator версии 1.8 и выше регулярно проверяет наличие обновлений на сервере. Если программа обнаруживает новую версию, в приложении становится активна кнопка Обновить.

После нажатия на кнопку Обновить скачивается актуальная версия приложения. Как только загрузка заканчивается, Ajax Translator выводит окно с предложением установить обновление.

Для установки обновления необходимо перезапустить Ajax Translator. Обновление устанавливается в папку, в которой уже установлена программа.

Если активна опция Включить авто-логин, вам будет предложено 2 варианта: автоматическая и ручная установка.

  • При выборе автоматической установки, приложение выключается, а затем обновляется в автоматическом режиме. По завершению установки, Ajax Translator запускается снова.
  • При выборе ручной установки следуйте инструкциям в приложении, чтобы установить обновление. По завершению установки, Ajax Translator запускается снова.

Если опция Включить авто-логин неактивна — обновить Ajax Translator можно только в ручном режиме.

Как обновить приложение, если Ajax Translator ниже версии, чем 1.8

  1. Выключите Ajax Translator.
  2. Скачайте актуальную версию приложения по ссылке.
  3. Распакуйте архив и запустите Ajax_Translator.jar. Это установочный файл программы Ajax Translator.
  4. Установите обновление, следуя инструкциям установщика. Обновление необходимо устанавливать в папку, в которой находится старая версия Ajax Translator. Таким образом вы сохраните все привязанные хабы и настройки программы.
  5. Запустите Ajax Translator.

Как работает Ajax Translator

Все передаваемые хабом данные защищены блочным шифрованием с плавающим ключом. Стороннее пультовое ПО не может самостоятельно расшифровать их. Ajax Translator принимает сообщение от хаба, расшифровывает его, конвертирует в сообщения стандартизированного протокола и транслирует его в ПО ПЦН.

Подключение Ajax Translator к ПЦН

Ajax Translator передает сообщения через приемник событий пульта централизованного наблюдения. Настроить связь с приемником событий ПЦН можно через TCP/IP или COM-порт — виртуальный или физический.

Подключение через Socket (TCP/IP)

Указав в настройках Ajax Translator IP-адрес и порт сервера, можно передавать данные как в пределах одного компьютера (сервера), так и в локальной сети или через интернет.

Прежде чем настраивать Ajax Translator, необходимо создать новый источник событий по TCP/IP в приемнике событий вашего ПЦН. При создании источника событий в поле Порт укажите порт, на который будут приходить события от Ajax Translator (значение по умолчанию 9292). В поле Адрес оставляем значение 0.0.0.0 (localhost). Этот параметр меняется, если компьютер имеет два и более IP-адреса. В таком случае необходимо указать, с какого именно IP-адреса и порта будут приниматься события на ПЦН.

Вариант 1: Ajax Translator и приемник событий на одном компьютере (сервере)

Запустите Ajax Translator. Введите логин, пароль и нажмите Войти. Если при настройке приемника событий вы указали IP-адрес localhost и порт 9292, то Ajax Translator запустится сразу, поскольку эти значения установлены по умолчанию.

ajax translator

Если в приемнике событий или в настройках Ajax Translator был указан другой порт или IP-адрес, вы увидите окно с ошибкой “Не удалось установить соединение с Socket портом” с указанием номера порта и IP-адреса, к которым пытался подключиться Ajax Translator.

ajax translator

В этом случае нажмите OK, чтобы перейти к их настройке. В открывшемся окне введите номер порта и IP-адрес, которые указаны при создании источника событий, и нажмите Сохранить, затем ОК.

ajax translator
ajax translator

После того как настройки сохранятся, появится окно ввода логина и пароля.

ajax translator

Важно: на этом этапе нужно закрыть программу, нажав на крестик в правом верхнем углу, чтобы внесенные настройки применились. Если нажать кнопку Войти, Ajax Translator не применит настройки и запустить программу снова не получится.

Если Ajax Translator был закрыт корректно, то при следующем запуске соединение по TCP/IP будет установлено.

Вариант 2: Ajax Translator и приемник событий в одной локальной сети

Когда Ajax Translator и приемник событий установлены на разных компьютерах, но в одной локальной сети, приемник событий настраивается так же, как описано в предыдущем варианте, различие — в настройке Ajax Translator.

При запуске Ajax Translator выдаст ошибку, что не может подключиться к Socket порту. Нажмите OK, чтобы перейти к настройкам.

ajax translator

В открывшемся окне, в поле Host укажите IP-адрес компьютера (сервера), на котором установлен приемник событий ПЦН. Также укажите номер порта, если он отличается от 9292. Нажмите Сохранить, затем ОК.

ajax translator
ajax translator

После того как настройки сохранятся, появится окно ввода логина и пароля.

ajax translator

Важно: на этом этапе нужно закрыть программу, нажав на крестик в правом верхнем углу, чтобы внесенные настройки применились. Если нажать кнопку Войти, Ajax Translator не применит настройки и запустить программу снова не получится.

Если Ajax Translator был закрыт корректно, то при следующем запуске соединение по TCP/IP будет установлено.

Подключение через COM-порт

Если Ajax Translator и приемник событий ПЦН установлены на одном компьютере (локальном сервере), их можно подключить через пару виртуальных COM-портов. Также можно соединить отдельные компьютеры через два физических COM-порта.

Прежде, чем настраивать подключение через COM-порт, нужно изменить стандартные настройки соединения Ajax Translator.

Изменение стандартных настроек соединения Ajax Translator

Соединение с ПЦН по TCP/IP установлено в Ajax Translator по умолчанию. Изменить параметр соединения можно в файле конфигурации Ajax Translator.

Убедитесь, что Ajax Translator в данный момент не запущен.

Откройте папку с файлами Ajax Translator и перейдите в папку Translator Dist, затем в папку Settings.

ajax translator

Откройте файл clientSetting с помощью стандартного приложения Блокнот.

ajax translator

Найдите через поиск строку senderType = SOC и замените “SOC” на “COM”.

ajax translator

После этого надо обязательно сохранить файл. Зайдите в меню Файл и нажмите Сохранить.

ajax translator

Создание виртуальных COM-портов

Прежде чем настраивать Ajax Translator, необходимо создать пару виртуальных COM-портов. Для создания виртуальных COM-портов подойдет любой эмулятор, например com0com. Инструкцию по настройке эмулятора можно найти у производителя.

Один виртуальный порт укажите как источник событий в приемнике событий вашего ПЦН, а второй — в настройках меню CMS Connection в Ajax Translator.

Настройка виртуальных COM-портов

Изменив файл конфигурации и создав пару виртуальных COM-портов, запустите Ajax Translator. Введите логин, пароль и нажмите Войти. Используйте опцию Включить авто-логин, чтобы не вводить логин и пароль при каждом запуске программы.

По умолчанию в настройках Ajax Translator установлено подключение по COM-порту 3. Если на компьютере есть COM-порт под таким номером и он не занят никакими процессами, то Ajax Translator подключится к нему и запустится. Для корректной передачи событий на ПЦН необходимо изменить настройки COM в настройках Ajax Translator, указав номер созданного вами виртуального порта: Setting —> CMS Connection —> Настройки COM —> Указать COM-порт.

Если на вашем компьютере нет COM-порта с таким номером или он занят другим процессом, вы увидите сообщение “Не удалось установить соединение COM-портом”.

ajax translator

Нажмите ОК, чтобы задать параметры COM-порта.

ajax translator

В открывшемся окне будут доступны настройки:

  • ComNumber — номер COM-порта, на который будут передаваться данные
  • Baud Rate — скорость передачи данных
  • Data Bits — биты данных
  • Stop Bits — стоповые биты
  • Parity — четность

Введите номер второго COM-порта из созданной ранее пары в поле ComNumber и нажмите Сохранить, затем ОК.

ajax translator

Остальные настройки Baud Rate, Data Bits, Stop Bits и Parity должны совпадать с настройками на стороне ПЦН.

После того как настройки сохранятся, появится окно ввода логина и пароля.

ajax translator

На этом этапе нужно закрыть программу, нажав на крестик в правом верхнем углу, чтобы внесенные настройки применились. Если нажать кнопку Войти, Ajax Translator не применит настройки и запустить программу снова не получится.

Если Ajax Translator был закрыт корректно, то при следующем запуске соединение через COM-порт будет установлено.

Настройка Ajax Translator

Меню настроек Ajax Translator находится во вкладке Settings:

ajax translator
CMS connection Настройка параметров подключения к ПЦН.
Network Настройки параметров соединения с сервером Ajax Cloud.
Objects Меню для добавления/удаления охраняемых объектов и привязки их к номерам объектов ПЦН.
Events Меню редактирования кодов событий, отправляемых на ПЦН.

CMS connection

Меню настройки подключения к ПЦН состоит из блоков:

ajax translator

Блок Настройки “пинга” для CMS отвечает за периодическую проверку связи между ПЦН и Ajax Translator.

Отправлять Ping на пульт — включает/выключает отправку проверочных сообщений.

Строка пинга — конфигурация строки, которая будет отправляться на ПЦН.

HEX сообщение — код отправляемого проверочного сообщения.

HEX–сообщение указывается в шестнадцатеричном формате (в логе преобразуется в текст). Например, HEX–сообщение 4444 будет показано как DD. HEX стоит использовать для вывода ASCII символов и дополнительных пробелов в конце сообщения пинга.

Период пинга — задает периодичность отправки проверочных сообщений в секундах.

Ждать ответа на пинг — опция для контроля приема события вашим ПЦН.

ajax translator

Блок Тип подключения к CMS позволяет настроить соединение между ПО ПЦН и Ajax Translator через TCP/IP или COM-порт.

Для подключения через TCP/IP можно отключить Ожидание подтверждения получения сообщения пультом. В этом случае, Ajax Translator не будет ожидать ответ на отправленное событие. При подключении через пару COM-портов Ajax Translator всегда ожидает подтверждение получения сообщения ПЦН. Если Ajax Translator не получает подтверждения, он сообщает, что связь с ПЦН отсутствует.

ajax translator

Блок CMS протокол месседжинга предназначен для настройки протокола передачи событий. Он состоит из:

  1. Выпадающего меню выбора протокола.
  2. Описательного блока с расшифровкой протокола.
  3. Receiver number — задает номер приемника событий. По умолчанию используется 00.
  4. Line number — задает номер линии приемника событий. По умолчанию используется 0.
  5. Номер объекта транслятора — присвоение Ajax Translator номера объекта, который можно использовать для контроля связи с ПЦН.
  6. Тревоги подключения к облаку — задает время (в секундах) отсутствия связи, по истечении которого на ПЦН будет приходить уведомление о потере связи Ajax Translator c Ajax Cloud.
  7. Менеджмент периодиков на трансляторе — включает/отключает тестовые сообщения, которые используются для проверки связи Ajax Translator с хабом. Настройка также позволяет задать их периодичность (в минутах).

Network

В настройках подключения к облачному серверу Ajax Cloud доступны два параметра: Host и Port.

ajax translator

По умолчанию в Ajax Translator установлены три IP-адреса, в зависимости от региона использования. Если у вас указан только один из IP-адресов, укажите два других через «;». Ajax Translator может работать по двум портам: 2020 и 80. Выбранный вами порт должен быть открыт для всех видов трафика.

  • 178.62.38.104
  • 52.57.175.225
  • 52.57.131.150
  • 194.87.103.60
  • 194.87.110.46
  • 82.202.221.20

При отсутствии интернет-подключения на компьютере, Ajax Translator выдаст ошибку:

“Если интернет–подключение есть, но сообщение продолжает появляться, проверьте настройки Translator в меню Network”.

Objects

Меню Objects состоит из двух таблиц и позволяет администрировать подключенные к ПЦН хабы. В таблице слева показаны хабы, с которых пользователи отправили запрос на мониторинг через вкладку Охранные компании в приложении Ajax. В таблице справа — привязка ID хабов к номерам объектов ПЦН.

Если запрос на мониторинг был отправлен впервые, то в строке Состояние, напротив ID хаба отображается статус Не подтвержден. Если хаб уже был привязан к номеру объекта ПЦН, то статус будет Подтвержден. Если пользователь отменил заявку на мониторинг в приложении Ajax, то в строке будет указан статус Ожидает удаления.

ajax translator

Поиск по объектам

В списке объектов хаб можно найти по номеру объекта или ID хаба. Для корректного поиска по ID хаба всегда вводите латинские символы в ВЕРХНЕМ регистре.

По умолчанию поиск происходит по номеру объекта. Чтобы найти хаб, впишите в поле номер объекта и нажмите Поиск:

ajax translator

Чтобы искать хаб по ID, кликните по кнопке ObjNum — она сменит имя на HubId, а затем впишите в поле поиска ID хаба и нажмите Поиск.

Прекращение мониторинга объекта

Чтобы временно приостановить получение событий от объекта, нажмите на него в таблице справа и нажмите Добавить в неактивные. Статус объекта изменится на Неактивен, а сам объект будет отображаться в конце списка. Чтобы возобновить получение событий от хаба, нажмите Добавить в активные.

ajax translator

Чтобы прекратить мониторинг объекта, удалите хаб из Ajax Translator: выделите хаб в правой таблице и нажмите кнопку Удалить из привязанных.

ajax translator

Затем выберите хаб в таблице слева и нажмите иконку корзины.

ajax translator

Events

Меню Events позволяет редактировать коды событий. Ajax Translator может передавать на ПЦН такие типы событий:

  • Тревоги: пожарные, аварийные, охранные, общие, неохранные, по клавиатуре, тампер, фотоподверждения (только Manitou и SBN)
  • Неисправности
  • Проблемы со связью
  • Периодические тесты
  • Постановки и снятия с охраны

Изменение кода события Sur-Gard

Приложение Translator позволяет изменить заданные по умолчанию коды событий Sur-Gard (Contact ID). Например, ваш ПЦН использует код E725 для сообщения о потери связи с централью, а хаб отправляет код E350. Чтобы не менять настройки ПЦН, отредактируйте код в Ajax Translator.

Перейдите в меню Events.

ajax translator

В поле Заменить что впишите требующий корректировки код, а в поле Заменить на — новый код, и нажмите кнопку Добавить.

ajax translator

Редактировать правила замены кодов событий Sur-Gard Contact ID нельзя. Если правило не актуально, удалите его.

Чтобы удалить неактуальное правило, введите в поле Заменить что требующий удаления код и нажмите кнопку Удалить. После корректного удаления вы получите такое уведомление.

ajax translator

Настройка фильтра передачи событий на ПЦН

Ajax Translator может передавать не все события хабов на ПЦН, а только определённые. Таким образом вы можете настроить передачу только пожарных тревог, при этом не получая уведомления о любых других событиях.

Чтобы настроить фильтр:

  1. Войдите в папку, в которой установлен Ajax Translator.
  2. Перейдите в папку Settings и откройте файл clientSetting.properties с помощью стандартного приложения Блокнот или аналогичного текстового редактора.
  3. Добавьте в конец файла: acceptableCodes = XXX;

XXX — это код события, которое вы хотите получать на ПЦН. Не указывайте приставку E или R. Учитывайте, что после кода должна стоять точка с запятой (;). Если вы хотите указать несколько кодов — вводите их через пробел.

Пример строки с одним кодом: acceptableCodes = 111;

Пример строки с несколькими кодами: acceptableCodes = 111; 112; 113; 130;

Протоколы передачи событий от Ajax Translator

Ajax Translator поддерживает протоколы для передачи событий на ПЦН:

  • ANSI/SIA
  • передача тревог и событий
  • передача фотоверификаций тревог
  • передача координат тревожной кнопки, нажатой в приложении Ajax
  • Sur-Gard (шаблон Contact ID)
  • передача тревог и событий
  • Manitou
  • передача тревог и событий
  • передача фотоверификаций тревог
  • передача координат тревожной кнопки, нажатой в приложении Ajax
  • SBN
  • передача тревог и событий
  • передача фотоверификаций тревог
  • передача координат тревожной кнопки, нажатой в приложении Ajax

Передача событий по протоколу SIA DC-09

Сообщение SIA DC-09 предусматривает возможность передавать дополнительную информацию в виде ссылки на веб-ресурс, географических координат или другие стандартизированные данные. Протокол ANSI/SIA можно использовать для передачи на ПЦН фотографий с датчиков движения MotionCam и координат пользователя при нажатии тревожной кнопки в приложении Ajax.

Шаблон сообщения SIA DC-09:
<LF><crc><0LLL><«id»><seq><Rrcvr> <Lpref> <#acct> [<pad> | … data …] [x… data…] <timestamp> < CR>
<LF> Маркер начала сообщения в ASCII, передается в двоичном значении 0x0A.
<crc> Контрольная сумма для проверки целостности сообщения. Передается в виде четырех символов в ASCII.
<0LLL> Длина сообщения, где первый символ всегда 0, а последующие три — это hex-символы в ASCII.
<«id»> Индикатор типа протокола — всегда используется ADM-CID.
<seq> Порядковый номер отправляемого сообщения. Используется диапазон 0001-9999, после чего счет начинается снова с 0001.
<Rrcvr> Номер ресивера — не используется.
<Lpref> Префикс номера объекта — постоянное значение L0.
<#acct> Номер объекта. В начале указывается #, затем от 3 до 16 hex-символов в ASCII.
[<pad>|…data…] Данные о тревоге. В начале указывается #номер объекта, затем разделитель “|”, после которого сообщение, где первая цифра 1 (Тревога) или 3 (Восстановление), трехзначный код события по протоколу Contact ID, номер группы, номер зоны. Сообщение после разделителя может содержать от 3 до 16 hex-символов в ASCII.
[x…data…]

Дополнительные данные. Могут содержать фотоподтверждение c датчиков MotionCam или координаты устройства, на котором пользователь нажал тревожную кнопку в приложении Ajax.

Фотоподтверждение передается в виде веб-ссылки, в начале которой указывается тип данных — буква V (Verification).

Координаты передаются в формате [X30E28.0] [Y50N29.6], где
X — долгота
30 — градусы
E — East/West (восточная/западная)
28.0 — минуты
Y — широта
50 — градусы
N — North/South (южная/северная)
29.6 — минуты

<timestamp> Маркер времени.
<CR>
Маркер конца сообщения в ASCII, передается в двоичном значении 0x0D.

Передача событий по протоколу Sur-Gard

Учитывайте, что протокол Sur-Gard (Contact ID) не поддерживает передачу фотоподтверждений датчика MotionCam и координат тревожной кнопки, которая была нажата в приложении Ajax.

Шаблон сообщения Sur-Gard:
5rrLs18SSSSQXYZGGCCC
5 протокольный номер
rr номер приемника (по умолчанию 00)
L номер линии (по умолчанию 0)
s разделитель (пробел)
18 Идентифицирует формат приемнику и системе
SSSS 4-х значный* номер объекта ПЦН, который привязали к ID хаба
Q Идентификатор события (E — event, R — restore)
YXZ 3-х значный код события
GG Номер группы (физической или логической , 2 цифры)
CCC Зона, номер датчика или пользователя (3 цифры)

* В случаях, когда на ПЦН больше чем 9999 объектов, и номер объекта состоит больше чем из 4 цифр, в Ajax Translator предусмотрена возможность задать номер, состоящий из 8-ми цифр максимум. Для этого откройте файл конфигурации Ajax Translator clientSetting в приложении Блокнот и найдите там пункт objNumLenght. Задайте необходимую длину номера объекта и сохраните файл.

ajax translator command

Также Ajax Translator может передавать события по протоколу Surgard_Ext — расширенный шаблон событий Contact ID для ПЦН. Этот протокол использует ID хаба в качестве номера объекта ПЦН, поэтому не нужно привязывать номер объекта в правой колонке меню Objects.

Шаблон сообщения Surgard_Ext:
5rrLs18SSSSSSSSQXYZGGCCC
5 протокольный номер
rr номер приемника (по умолчанию 00)
L номер линии (по умолчанию 0)
s разделитель (пробел)
18 Идентифицирует формат приемнику и системе
SSSSSSSS 8-х значный ID хаба
Q Идентификатор события (E — event, R — restore)
YXZ 3-х значный код события
GG Номер группы (физической или логической , 2 цифры)
CCC Зона, номер датчика или пользователя (3 цифры)

Если режим групп не используется, все события приходят с идентификатором группы 01 и 02. По умолчанию все устройства добавляются в группу 01, но если устройство реагирует на активацию Ночного режима — все его события будут приходить по группе 02. При постановке на охрану, событие будет приходить по обеим группам — 01 и 02. При использовании режима групп, номер группы в приложении будет соответствовать номеру группы на ПЦН.

Передача событий по протоколу MANITOU

Начиная с версии 1.5, в Ajax Translator появилась поддержка передачи сообщений по протоколу MANITOU. Этот протокол позволяет принимать фотоподтверждения тревог с датчиков MotionCam, а также координаты тревожной кнопки, которая была нажата в приложении Ajax.

Если режим групп не используется, все события приходят с идентификатором группы 01 и 02. По умолчанию все устройства добавляются в группу 01, но если устройство реагирует на активацию Ночного режима — все его события будут приходить по группе 02. При постановке на охрану, событие будет приходить по обеим группам — 01 и 02. При использовании режима групп, номер группы в приложении будет соответствовать номеру группы на ПЦН.

Как настроить передачу событий из Ajax Translator в ПЦН Manitou

Нажмите на вкладку Settings и перейдите в меню CMS connection.

ajax translator

Из выпадающего списка CMS протокол месседжинга выберите Manitou.

ajax translator

Нажмите Сохранить внизу окна.

ajax translator

После сохранения настроек Ajax Translator покажет сообщение об ошибке.

ajax translator

Нажмите ОК, перейдите во вкладку Program и нажмите Выход.

ajax translator

Введите пароль от учетной записи, чтобы выйти из Ajax Translator.

ajax translator

При следующем запуске Ajax Translator начнет использовать для передачи событий протокол Manitou.

Для приема событий также необходимо выбрать правильный протокол в настройках ПЦН Manitou. Необходимо настроить: bold XML multiframe.

Передача событий по протоколу SBN

Начиная с версии 1.6, в Ajax Translator появилась поддержка передачи сообщений по протоколу SBN. Этот протокол позволяет дополнительно принимать фотоподтверждения тревог с датчиков MotionCam, а также координаты тревожной кнопки, которая была нажата в приложении Ajax.

Шаблон события SBN с тревогой:
String: <?xml version=»1.0″ encoding=»UTF-8″?><sbn_rd xmlns=»http://www.ibsiberia.com/schemas/sbn_rd» version=»1″><event id=»1476139372″ protocol=»CID»><account>2034</account><code>E130</code><zone>1</zone><area>1</area></event></sbn_rd>

Event id идентификатор объекта
Protocol формат протокола передаваемого события
Account 4-​значный ​номер ​объекта
Code

код​ ​события ​(​значение ​от​ ​001​ ​до​ ​999)

Каждые ​15​ ​минут отправляются ​тестовые ​пинги ​под​ ​кодом ​E602

Zone Номер ​зоны ​​(отчеты ​о​ ​событиях) ​(​три ​​цифры ​от​ ​000​ ​до​ ​999)
Area Группа ​или​ ​Номер​ раздела​ (​две ​цифры​ от​ ​​00 ​до​ ​99).​ ​00 используется​, чтобы ​указать, ​что​ ​информация ​о​ ​группе​​ или​​ разделе ​не​ ​применяется
Шаблон события SBN с фотоверификацией:
String: <?xml version=»1.0″ encoding=»UTF-8″?>
<sbn_rd xmlns=»http://www.ibsiberia.com/schemas/sbn_rd» version=»1″><event id=»0″ protocol=»CID»><account>2034</account><code>E130</code><zone>1</zone><area>1</area></event><object id=»232454994″ type=»201″ ext=»jpg» event_id=»0″><account>2034</account><device id=»1″ device_descr=»no_descr»/><content>XXXXXXX</content></object></sbn_rd>
Protocol формат протокола передаваемого события
Account ​4-​значный ​номер ​объекта
Code код​ ​события ​(​значение ​от​ ​001​ ​до​ ​999)
Zone Номер ​зоны ​​(отчеты ​о​ ​событиях) ​(​три ​​цифры ​от​ ​000​ ​до​ ​999)
Area Группа ​или​ ​Номер​ раздела​ (​две ​цифры​ от​ ​​00 ​до​ ​99).​ ​00 используется​, чтобы ​указать, ​что​ ​информация ​о​ ​группе​​ или​​ разделе ​не​ ​применяется
type идентификатор формата файла
ext формат файла
event_id идентификатор события, уникальный для хаба
device id идентификатор датчика, соответствует номеру шлейфа устройства
device_descr значение поля не заполняется. Всегда передается “no_descr”
/ХХХХХХ/ массив base64 изображения
Шаблон события SBN с координатами тревожной кнопки:
String: <?xml version=»1.0″ encoding=»UTF-8″?><sbn_rd xmlns=»http://www.ibsiberia.com/schemas/sbn_rd» version=»1″><event id=»573186071″ protocol=»CID»><account>123</account><code>E120</code><zone>502</zone><area>1</area></event><georeference id=»1511819941″ type=»type0″ source=»ext0″ event_id=»573186071″><account>123</account><latitude>50.5153576</latitude><longitude>30.6145326</longitude></georeference></sbn_rd>
Protocol формат протокола передаваемого события
Account 4-​значный ​номер ​объекта
Code код​ ​события

  • E120 — для тревоги
  • R120 — для восстановления
Zone Идентификатор пользователя ​(​три ​​цифры ​от​ ​000​ ​до​ ​999)
Area Группа ​или​ ​Номер​ раздела​ (​две ​цифры​ от​ ​​00 ​до​ ​99).​ ​При передаче координат тревожной кнопки используется 01 группа
type идентификатор формата файла
event_id идентификатор события, уникальный для хаба
georeference id Идентификатор, который генерируется случайным образом
latitude Географические координаты (широта) устройства, на котором была нажата тревожная кнопка в приложении Ajax
longitude Географические координаты (долгота) устройства, на котором была нажата тревожная кнопка в приложении Ajax

Если режим групп не используется, все события приходят с идентификатором группы 01 и 02. По умолчанию все устройства добавляются в группу 01, но если устройство реагирует на активацию Ночного режима — все его события будут приходить по группе 02. При постановке на охрану, событие будет приходить по обеим группам — 01 и 02. При использовании режима групп, номер группы в приложении будет соответствовать номеру группы на ПЦН.

Как настроить передачу событий из Ajax Translator в ПЦН SBN

Нажмите на вкладку Settings и перейдите в меню CMS connection.

ajax translator

Из выпадающего списка CMS протокол месседжинга выберите SBN и нажмите Сохранить внизу окна.

ajax translator

После сохранения настроек Ajax Translator покажет сообщение об ошибке.

ajax translator

Нажмите ОК, перейдите во вкладку Program и нажмите Выход.

ajax translator

Введите пароль учетной записи, чтобы выйти из Ajax Translator.

ajax translator

При следующем запуске Ajax Translator начнет использовать для передачи событий протокол SBN.

Для корректной работы необходимо настроить прием событий в ПЦН SBN.

Подключение хаба к Ajax Translator

Связь хаба с ПО ПЦН можно настроить:

  • через сервер Ajax Cloud
  • напрямую (в обход Ajax Cloud)
  • напрямую и через Ajax Cloud одновременно

Используйте оба канала связи, чтобы обеспечить более стабильное соединение с ПЦН.

Как подключить хаб через Ajax Cloud

Для подключения хаба через облачный сервер нужно, чтобы пользователь с правами администратора отправил запрос на мониторинг, выбрав охранную компанию в приложении Ajax (Хаб —>Настройки —>Охранные компании —>Выбрать компанию —>Отправить запрос на мониторинг). После этого ID хаба появится в перечне доступных объектов в Ajax Translator (таблица слева).

Чтобы привязать хаб к номеру объекта ПЦН, выделите в таблице слева ID хаба, и нажмите кнопку со стрелкой. Хаб будет добавлен в таблицу справа с пультовым номером 0.

ajax translator

Дважды кликните по ячейке в столбце № Объекта в строке вашего хаба в таблице справа. Пропишите свободный номер объекту и нажмите кнопку Ввод/Enter на клавиатуре. Диапазон возможных значений номера объекта 1–9999. Если вводите номер из более чем одного знака, не ставьте нули перед номером объекта: «1» вместо «0001».

ajax translator

Если поменять номер и не нажать Ввод/Enter, то хаб не будет добавлен на ПЦН.
После успешной привязки строка Состояние изменится на Активен.

Создайте в программном обеспечении ПЦН объект с номером, соответствующим присвоенному хабу номеру в Ajax Translator.

Как подключить хаб напрямую

Прежде чем начать подключение хаба к Ajax Translator в обход облачного сервера Ajax Cloud, сделайте проброс произвольного внешнего TCP–порта на внутренний порт 3060. Таким образом вы обеспечите внешний статический IP-адрес для подключения.

Если необходимый порт занят, нужно внести изменения в файл конфигурации Ajax Translator.

Откройте папку с файлами Ajax Translator и перейдите в папку Translator Dist, затем в папку Settings.

ajax translator

Откройте файл clientSetting с помощью стандартного приложения Блокнот.

ajax translator

Найдите через поиск строку directConnectPort = 3060 и замените “3060” на значение свободного порта.

ajax translator

После этого надо обязательно сохранить файл. Зайдите в меню Файл и нажмите Сохранить. Затем перезапустите Ajax Translator.

ajax translator

После настройки соединения со стороны ПЦН, зайдите в меню Пультовой мониторинг в настройках хаба в приложении Ajax. Укажите IP–адрес и номер проброшенного внешнего TCP–порта. Выберите каналы связи, по которым хаб будет подключаться к вашему серверу: Ethernet и/или GPRS.

Если для связи используется только канал GPRS, активируйте настройку Игнорировать ошибки при регистрации в сети в настройках сотовых данных.
(Хаб —>Настройки —>Сотовые данные)

ajax translator

Настроив соединение хаба с Ajax Translator через TCP–порт, необходимо привязать ID хаба к номеру объекта ПЦН.

Перейдите в меню Objects в Ajax Translator и введите в поле ввода восьмизначный ID хаба и нажмите кнопку Создать локальную привязку.

ajax translator

ID хаба можно увидеть в приложении Ajax: перейдите во вкладку Устройства, нажмите на хаб и спуститесь вниз экрана.

ajax translator

После нажатия кнопки Создать локальную привязку должно появиться уведомление.

ajax translator

Хаб будет добавлен в таблицу справа с пультовым номером 0. Дважды кликните по ячейке в столбце № Объекта в строке вашего хаба в таблице справа. Пропишите свободный номер объекту и нажмите кнопку Ввод/Enter на клавиатуре.

Как подключить хаб напрямую и через Ajax Cloud

Чтобы подключить хаб одновременно по двум каналам связи — пройдите процедуру подключения через Ajax Cloud, затем настройте прямое соединение как описано в этом руководстве.

Приоритет прямого соединения выше, чем облачного сервера. Если по каким-либо причинам прямое соединение обрывается, Ajax Translator начинает получать события от хаба через Ajax Cloud. Таким образом вы можете обеспечить более стабильный мониторинг охраняемого объекта.

Нужна помощь?

В этом разделе вы найдете подробные инструкции и обучающие видео обо всех возможностях системы Ajax. А если вам понадобится помощь технического специалиста, мы на связи 24/7.