Посібник користувача Ajax Translator

Оновлено

Ajax Translator — це програма для комунікації систем безпеки Ajax зі стороннім моніторинговим ПЗ. Виступаючи сполучною ланкою між хабом і пультом централізованого спостереження, Ajax Translator конвертує отримані від хаба сповіщення у події протоколу, який підтримується ПЦС.

Як отримати Ajax Translator

Щоб отримати Ajax Translator, заповніть форму на сайті. Якщо форму заповнено коректно, то протягом 48 годин на вказаний вами email буде надіслано посилання на актуальну версію Ajax Translator, логін та пароль для авторизації.

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

Системні вимоги

Характеристика Мінімальні Рекомендовані
Процесор Intel Core I3 (2 ядра) Intel Core I5 ​​(4 та більше ядер)
RAM 4 ГБ 8 ГБ
HDD 128 ГБ вільного місця Понад 128 ГБ вільного місця
ОС macOS Big Sur версії 11.0.1 і вище
Windows 7, 8, 10
Java machine
Version 8 Update 73 (Oracle) і вище
Мережа 100 Мб/сек

Не підключайте більш ніж 5000 об’єктів через один Translator. Якщо ви обслуговуєте понад 5000 об’єктів, встановіть ще один Translator в іншу папку та запускайте їх паралельно. Враховуйте, що облікові записи у двох Translator повинні бути різними. Створити ще один обліковий запис можна через нашу службу підтримки.

Встановлення

Розпакуйте виконуваний файл 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 був закритий коректно, то під час наступного запуску з’єднання через СОМ-порт буде встановлено.

Налаштування 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 з Ajax Cloud.
  7. Менеджмент періодиків на трансляторі — вмикає/вимикає тестові повідомлення, які використовуються для перевірки зв’язку Ajax Translator із хабом. Налаштування також дозволяє задати їх періодичність (у хвилинах).

Network

У налаштуваннях підключення до хмарного сервера Ajax Cloud доступні два параметри: Host і Port.

ajax translator

За замовчуванням в Ajax Translator встановлені три IP-адреси, залежно від регіону використання. Якщо у вас вказана лише одна з IP-адрес, вкажіть дві інших через «;». Ajax Translator може працювати по двох портах: 2020 і 80. Обраний вами порт має бути відкритим для всіх видів трафіку.

Ajax Translator працює з використанням DNS по 443 порту (за замовченням). Весь трафік, який передається по цьому порту, зашифрований. Для коректної роботи Ajax Translator необхідно відкрити цей порт для всіх видів трафіку.

Адреса для підключення Ajax Translator: hts.prod.ajax.systems.

У разі відсутності інтернет-з’єднання на комп’ютері, 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 може передавати на ПЦС такі типи подій:

  • Тривоги: пожежні, аварійні, охоронні, загальні, неохоронні, по клавіатурі, тампер, фотопідтвердження (лише SIA, Sentinel, Kronos, Manitou, Listener, MASXML та SBN)
  • Несправності
  • Проблеми зі зв’язком
  • Періодичні тести
  • Встановлення та зняття з-під охорони
  • Натискання тривожної кнопки в застосунку Ajax (разом із координатами)

Зміна коду події 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 підтримує протоколи для передавання подій на ПЦС:

  • SIA DC-09 (ADM-CID)
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • Sur-Gard (шаблон Contact ID)
  • передавання тривог і подій
  • Sur-Gard Extended
  • передавання тривог і подій
  • ABsistemDC(NG)v2
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • Patriot Systems
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • Manitou
  • передавання тривог і подій
  • передавання фотоверифікаціі тривог
  • передавання координат тривожної кнопки, натиснутої у застосунку Ajax
  • SBN
  • передавання тривог і подій
  • передавання фотоверифікаціі тривог
  • передавання координат тривожної кнопки, натиснутої у застосунку Ajax
  • Sentinel
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • Kronos
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • MASXML
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax
  • Listener
  • передавання тривог і подій
  • передавання фотоверифікацій тривог
  • передавання координат тривожної кнопки, натиснутої в застосунку Ajax

Передавання фотоверифікацій тривог відбувається через сервер Ajax Cloud. У разі використання прямого підключення (в обхід сервера) серії фото з MotionCam/MotionCam Outdoor надходити на ПЦС не будуть. При цьому фото буде передано в застосунки Ajax і на PRO Desktop (якщо застосунок використовують).

Повідомлення SIA DC-09 (ADM-CID) передбачає можливість передавати додаткову інформацію у вигляді посилання на веб-ресурс, географічні координати або інші стандартизовані дані. Протокол SIA DC-09 (ADM-CID) можна використовувати для передавання на ПЦС фотографій з датчиків руху MotionCam/MotionCam Outdoor та координат користувача в разі натискання тривожної кнопки у застосунку Ajax.

Шаблон повідомлення SIA DC-09 (ADM-CID):
<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/MotionCam Outdoor або координати пристрою, на якому користувач натиснув тривожну кнопку в додатку 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.

Враховуйте, що серії фото передаються окремою подією. Фото будуть доступні відразу після передавання на сервер Ajax Cloud. Посилання на фото будуть дійсні упродовж 7 днів після передавання на пульт охоронної компанії.

Зразок події з двома фото:

CB640375″ADM-CID”0086L0#1234[#1234|1130 02 001][Vhttps://ajax-sample.com/first_photo.jpg,https://ajax-sample.com/second_photo.jpg]_16:43:06,10-07-2020

Посилання у зразку події актуальні. Тому ви можете використовувати його, щоб протестувати роботу пультового ПЗ з Translator.

Враховуйте, що протокол Sur-Gard (Contact ID) не підтримує передавання фотопідтвердження датчиків MotionCam/MotionCam Outdoor і координат тривожної кнопки, яка була натиснута у застосунку 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. У разі використання режиму груп номер групи у застосунку відповідатиме номеру групи на ПЦС.

Починаючи з версії 1.5, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом MANITOU. Цей протокол дозволяє приймати фотопідтвердження тривог з датчиків MotionCam/MotionCam Outdoor, а також координати тривожної кнопки, яка була натиснута у застосунку 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.

Починаючи з версії 1.6, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом SBN. Цей протокол дозволяє додатково приймати фотопідтвердження тривог з датчиків MotionCam/MotionCam Outdoor, а також координати тривожної кнопки, яка була натиснута у застосунку 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.

Починаючи з версії 1.9, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом Sentinel. Цей протокол дає змогу приймати фотопідтвердження тривог із датчиків MotionCam/MotionCam Outdoor, а також координати тривожної кнопки, яка була натиснута в застосунку Ajax.

Якщо режим груп не використовують, всі події надходять з ідентифікатором групи 01 і 02. За замовчуванням всі пристрої додано до групи 01, але якщо пристрій реагує на активацію Нічного режиму — всі його події будуть надходити за групою 02. Після встановлення під охорону подія надходитиме за обома групами — 01 і 02. У разі використання режиму груп номер групи у застосунку відповідатиме номеру групи на ПЦС.

Як налаштувати передавання подій з Ajax Translator до ПЦС Sentinel

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

ajax translator

З випадаючого переліку CMS протокол меседжингу виберіть Sentinel.

ajax translator

Натисніть Зберегти внизу вікна.

ajax translator

Після збереження налаштувань Ajax Translator покаже повідомлення про помилку.

ajax translator

Натисніть ОК, перейдіть на вкладку Program і натисніть Вихід.

ajax translator

Введіть пароль від облікового запису, щоб вийти з Ajax Translator.

ajax translator

При наступному запуску Ajax Translator почне використовувати для передавання подій протокол Sentinel.

Для коректної роботи необхідно налаштувати приймання подій у ПЦС Sentinel.

Починаючи з версії 1.9, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом Kronos. Цей протокол дає змогу приймати фотопідтвердження тривог із датчиків MotionCam/MotionCam Outdoor, а також координати тривожної кнопки, яка була натиснута в застосунку Ajax.

Якщо режим груп не використовують, всі події надходять з ідентифікатором групи 01 і 02. За замовчуванням всі пристрої додано до групи 01, але якщо пристрій реагує на активацію Нічного режиму — всі його події будуть надходити за групою 02. Після встановлення під охорону подія надходитиме за обома групами — 01 і 02. У разі використання режиму груп номер групи у застосунку відповідатиме номеру групи на ПЦС.

Як налаштувати передавання подій з Ajax Translator до ПЦС Kronos

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

ajax translator

З випадаючого переліку CMS протокол меседжингу виберіть Kronos.

ajax translator

Натисніть Зберегти внизу вікна.

ajax translator

Після збереження налаштувань Ajax Translator покаже повідомлення про помилку.

ajax translator

Натисніть ОК, перейдіть на вкладку Program і натисніть Вихід.

ajax translator

Введіть пароль від облікового запису, щоб вийти з Ajax Translator.

ajax translator

При наступному запуску Ajax Translator почне використовувати для передавання подій протокол Kronos.

Для коректної роботи необхідно налаштувати приймання подій у ПЦС Kronos.

Починаючи з версії 1.10, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом MASXML. Цей протокол дає змогу приймати події та тривоги, а також фотопідтвердження тривог із датчиків MotionCam/MotionCam Outdoor.

Якщо режим груп не використовують, усі події надходять з ідентифікатором групи 01 і 02. За замовчуванням усі пристрої додано до групи 01, але якщо пристрій реагує на активацію Нічного режиму — всі його події будуть надходити за групою 02. Після встановлення під охорону подія надходитиме за обома групами — 01 і 02. У разі використання режиму груп номер групи у застосунку відповідатиме номеру групи на ПЦС.

Як налаштувати передавання подій з Ajax Translator до ПЦС MASterMind

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

ajax translator

З випадаючого переліку CMS протокол меседжингу виберіть MASXML.

ajax translator

Натисніть Зберегти внизу вікна.

ajax translator

Після збереження налаштувань Ajax Translator покаже повідомлення про помилку.

ajax translator

Натисніть ОК, перейдіть на вкладку Program і натисніть Вихід.

ajax translator

Введіть пароль від облікового запису, щоб вийти з Ajax Translator.

ajax translator

Після наступного запуску Ajax Translator почне використовувати для передавання подій протокол MASterMind.

Для приймання подій також необхідно вибрати правильний протокол у налаштуваннях ПЦС MASterMind.

Починаючи з версії 1.12, в Ajax Translator з’явилася підтримка передавання повідомлень за протоколом Listener. Цей протокол дозволяє приймати фотопідтвердження тривог з датчиків MotionCam/MotionCam Outdoor, а також координати тривожної кнопки, яка була натиснута у застосунку Ajax.

Якщо режим груп не використовується, всі події надходять з ідентифікатором групи 01 і 02. За замовчуванням всі пристрої додаються до групи 01, але якщо пристрій реагує на активацію Нічного режиму — всі його події будуть надходити за групою 02. При встановленні під охорону подія буде надходити за обома групами — 01 і 02. У разі використання режиму груп номер групи у застосунку відповідатиме номеру групи на ПЦС.

Як налаштувати передавання подій з Ajax Translator до ПЦС Listener

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

ajax translator

З випадаючого переліку CMS протокол меседжингу виберіть Listener.

ajax translator

Натисніть Зберегти внизу вікна.

ajax translator

Після збереження налаштувань Ajax Translator покаже повідомлення про помилку.

ajax translator

Натисніть ОК, перейдіть на вкладку Program і натисніть Вихід.

ajax translator

Введіть пароль від облікового запису, щоб вийти з Ajax Translator.

ajax translator

При наступному запуску Ajax Translator почне використовувати для передавання подій протокол Listener.

Для коректної роботи необхідно налаштувати приймання подій у ПЦС Listener.

Підключення хаба до 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.

Повідомити про помилку

Текст, який буде надіслано нашим редакторам: