iRidi Pro Server (ProAV Control Processor)

Инсталляция и запуск iRidi Pro Server на базе контроллеров ProAV Control Processor

документация обновлена 01.01.2024

Общие сведения​

iRidi Pro Server (ProAV Control Processor) - программная реализация iRidi Pro Server, которая запускается как демон или консольное приложение на контроллерах, в частности на ProAV Control Processor.

Инструкции, описанные в этой статье, подходят для работы в продуктах:

• ProAV Control Processor Basic (PX-VM20-Basic);
• ProAV Control Processor Advanced (PX-VP100-Advanced).

Технические характеристики​

Актуальные технические характеристики смотрите в статье на соответствующий контроллер:

• ProAV Control Processor Basic (PX-VM20-Basic)
• ProAV Control Processor Advanced (PX-VP100-Advanced)

Первое включение​

1. Подключите контроллер к локальной сети и электропитанию по инструкции.

2. С помощью приложения iRidium transfer или стандартным сканером LAN-сети (например, Advanced Port Scanner) определите IP-адрес устройства ProAV Control Processor.

3. Используйте этот адрес, чтобы открыть веб-интерфейс сервера в браузере:

• http://192.168.1.254:8888/ (укажите адрес своего контроллера!)

Сервер получает лицензию и проект из облака после авторизации разработчика (интегратора) в веб-интерфейсе сервера с учетной записью на сайте iridi.com. Для этого запустите сервер, откройте web-интерфейс и активируйте сервер:

1. Введите логин и пароль аккаунта интегратора, в котором вы создали объект с серверным проектом
2. Задайте сервисный пароль, чтобы заходить в настройки сервера. По умолчанию 2007
3. Далее, вы увидите список объектов и серверных проектов из iRidium Cloud. Выберите проект, который должен работать на сервере и нажмите на него, чтобы скачать (пропустите этот шаг, если еще не пользовались облаком)
4. В web-интерфейсе сервера, вкладка Cloud, вы можете скачать на сервер проект (Projects) или деактивировать сервер (Deactivate Server). На сервер с включенным режимом Test Mode вы сможете загружать проекты из iRidium Transfer

Изменение IP-адреса​

Измените IP-адрес контроллера, в соответствии с адресацией в вашей сетевой инфраструктуре. Настройки доступны в веб-интерфейсе сервера на странице System > Network .

Вы можете назначить:

• Динамический адрес (DHCP) или
• Статический адрес

DHCP-адрес (выдаётся автоматически):

Статический IP-адрес:

Настройки Security​

В web-интерфейсе iRidium Server на странице System -> Security представлены настройки обеспечения безопасности сервера.

Password​

Данная функция используется для изменения пароля для доступа к web-интерфейсу сервера.

Для изменения пароля требуется ввести ваш текущий пароль, новый пароль и повторить его.

После нажатия кнопки Change service Password для доступа к web-интерфейсу будет использоваться новый пароль.

Secure connection​

Данная функция отвечает за активацию защищенного соединения HTTPS (SSL) для доступа к web-интерфейсу iRidium Server.

Для включения защищенного подключения требуется в web-интерфейсе на вкладке Security включить чек-бокс Enable secure connection и нажать кнопку Save.

После включения данной функции сервер изменит порт доступа к web-интерфейсу на 8443 (ip адрес сервера:8443).

Для выключения доступа по SSL требуется выключить чек-бокс и нажать кнопку Save, сервер возвращает свой стандартный порт 8888 для доступа к web-интерфейсу (ip адрес сервера:8888).

SSH Connection​

Данная функция отвечает за доступность сервера для SSH подключения.

Для ограничения доступа по SSH к серверу требуется включить соответствующий чек-бокс на странице Security и нажать кнопку Save.

Для возвращения возможности SSH подключения к серверу требуется выключить чек-бокс и нажать кнопку Save.

Обновление сервера​

1. Откройте веб-интерфейс сервера на вкладке System > Info , нажмите кнопку Update.

2. Установите галочку под пунктом Get latest version from the iRidium website (по умолчанию активирована) и нажмите кнопку UPDATE. С сайта iridi.com автоматически установится последняя версия сервера.

Сброс на заводские настройки​

Для сброса контроллера iRidi Pro Server (ProAV Control Processor) на заводские настройки воспользуйтесь инструкцией:

• ProAV Control Processor Basic.
• ProAV Control Processor Advanced.

Восстановление работоспособности​

Если вы не можете открыть веб-интерфейс iRidi Pro Server (сервер не запускается, веб-интерфейс не работает), используйте следующие шаги приведенные в этой инструкции по аварийному запуску/обновлению/откату прошивки на контроллере. Для этого необходимо подключиться к устройству(контроллеру) по протоколу ssh.

Подключение к устройству (контроллеру) по протоколу SSH​

1. Определите IP-адрес контроллера удобным способом (например, с помощью iRidi transfer или сканером LAN-сети).
2. Скачайте и запустите программу PuTTY.
3. Настройте программу следующим образом:

• Host Name (or IP address):
• Port: 22
• Connection Type: SSH и нажмите Open.

4. В открывшейся консоли введите:

• Login as: root
• root@XXX.XXX.XXX.XXX's password: iridi (пароль не отображается во время ввода)

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

Подключение к устройству (контроллеру) по протоколу SSH с помощью системы RNDIS​

1. Соедините интерфейс microUSB на передней панели вашего контроллера с интерфейсом USB-A вашего ПК с помощью соответствующего кабеля.

2. Среди сетевых интерфейсов вашего ПК появится еще один сетевой адаптер Remote NDIS .

3. Подключитесь к контроллеру по SSH используя IP адрес 192.168.177.77

Смена пароля​

1. Для смены стандартного пароля воспользуйтесь командой passwd при подключении SSH .

2. Система предложит ввести новый пароль. Введите новый пароль.

Если пароли совпали вы увидите сообщение об успешной смене пароля: password for root changed by root .

Принудительный запуск сервера​

1. Перейдите в папку /iridiumserver/: cd /iridiumserver/

2. Введите команду запуска сервера в фоновом режиме (чтобы сервер не закрылся при закрытии PuTTY) ./iridium --force --hidden

3. В случае успеха сервер запустится и будет готов к работе.

Обновление и откат версии​

Данные действия выполняются в случае полной потери доступа к веб-интерфейсу сервера. Если доступ к интернету отсутствует, то воспользуйтесь инструкцией Обновление и откат версии при отсутствии доступа к интернету.

1. Загрузите последнюю версию ProAV Control Processor Basic в корневую папку контроллера: wget -O iridiumPro.ipk --no-check-certificate https://iridi.com/redirects/?go=iRidium_Server_HS_Server

2. Проверьте содержимое папки (убедитесь, что файл .ipk присутствует в папке): ls

3. Запустите установку более новой версии сервера: opkg install iridiumPro.ipk

Или откатите версию сервера до более старой: opkg install --force-downgrade iridiumPro.ipk

4. После установки сервер запустится автоматически. Сервер готов к работе.

Обновление и откат версии при отсутствии доступа к интернету​

1. Установите и запустите WinSCP:

• Нажмите на вкладку New Site , настройте:
• File Protocol: SCP
• Host name:
• Port number: 22
• User name: root
• Password: iridi

Нажмите Login.

2. Скопируйте файл установки сервера ProAV Control Processor (.ipk) в корневую папку /root контроллера iRidi Pro Server (ProAV Control Processor), используя WinSCP.

3. В консольной строке проверьте содержимое корневой папки (убедитесь, что файл .ipk присутствует): ls

4. Запустите установку более новой или такой же версии сервера: opkg install .ipk

Или откатите версию сервера до более старой: opkg install --force-downgrade .ipk

5. После установки сервер запустится автоматически. Сервер готов к работе.

Настройка сервера​

1. Когда ProAV Control Processor подготовлен, перейдите к разработке его конфигурации и логики: Серверный проект в iRidi Studio.

2. Готовый проект загрузите на iRidi Server: Запуск конфигурации iRidi server.

Настройка драйвера ProAV Control Processor​

ProAV Control Processor - это драйвер, позволяющий создать интерфейс для управления и настройки AV-процессором.

Устройство ProAV Control Processor имеет ряд входных и выходных портов для управления различным оборудованием:

• Inputs: универсальные входы R, V (0-50кОм, 0-12VDC). По умолчанию настроены как Button;
• Relays: слаботочные реле (NO, 3А, 24VDC);
• IR: ИК-выходы на задней панели устройства для управления оборудованием и ИК-вход на передней панели устройства для обучения ИК командам.

Назначение и функционал входов и выходов определяется серверным проектом с драйвером ProAV Control Processor.

В один серверный проект может быть добавлен лишь один драйвер ProAV Control Processor.

Настройка профилей входов Inputs, а также выбор модели процессора осуществляется только при добавлении драйвера ProAV Control Processor из базы драйверов. После добавления драйвера в проект, данные настройки изменить нельзя.

Настройка в iRidium Studio​

1. В созданном серверном проекте на вкладке Devices добавьте драйвер ProAV Control Processor .

2. В открывшемся окне выберите используемую модель ProAV Процессора управления и необходимый профиль входов (Inputs).

Profile:

• Button,
• Temperature Sensor,
• Voltage Sensor.

3. Заполните необходимые настройки драйвера.

Настройка нетворка​

• Protocol - Serial;
• Log Level - уровень логирования;
• Device model - модель устройства (PX-VM20-basic);
• COM 1 Mode - режим COM 1:
• • RS-232 + RS-485 ;
• • RS-232(CTS+RTS) ;
• Driver Version - версия драйвера.

Настройка I/O интерфейсов​

Устройство ProAV Control Processor имеет ряд входных и выходных портов для управления различным оборудованием:

• Inputs: универсальные входы R, V (0-50кОм, 0-12VDC). По умолчанию настроены как Button;
• Relays: слаботочные реле (NO, 3А, 24VDC);
• IR: ИК-выходы на задней панели устройства для управления оборудованием и ИК-вход на передней панели устройства для обучения ИК командам.

Назначение и функционал входов и выходов определяется серверным проектом с драйвером ProAV Control Processor.

Inputs​

Конфигурация входов Inputs задается только при добавлении драйвера ProAV Control Processor в серверный проект. Поддерживаются следующие конфигурации:

Button

Вход сухих контактов, используется на устройстве по умолчанию, если не был сконфигурирован драйвером ProAV Control Processor. Имеется возможность, через настройки подустройства, включить инверсию.

• Name - имя устройства,
• Driver Type - ProAV Control Processor,
• Inversion - инверсия входа (true, false).

Temperature sensor

Позволяет подключить один из поддерживаемых температурных сенсоров:

• VT.AC501
• B57164-K_103-J_10
• iRidiNTC.

Имеется возможность через настройки подустройства указать калибровочное значение.

• Name - имя устройства,
• Driver Type - ProAV Control Processor,
• Sensor Type - тип датчика,
• Calibration value - допустимое значение погрешности при измерении температуры окружающей среды.
• Deadband - минимальное значение, на которое должно произойти изменение значения с датчика (от текущего), чтобы произошло событие изменения канала обратной связи Value, независимо от настройки Pulse
• Pulse (min) - таймер, через который отправляется значение в шину (в мин). 0 - выключен, минимальное значение 1, максимальное - час.

Voltage sensor

Позволяет измерять значение напряжения на входе в диапазоне 0-12VDC

• Name - имя устройства,
• Driver Type - ProAV Control Processor,
• Deadband - минимальное значение, на которое должно произойти изменение значения с датчика (от текущего), чтобы произошло событие изменения канала обратной связи Value, независимо от настройки Pulse
• Pulse (min) - таймер, через который отправляется значение в шину (в мин). 0 - выключен, минимальное значение 1, максимальное - час.

Relay​

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

• Name - имя устройства,
• Driver Type - ProAV Control Processor,
• Inversion - инверсия входа (true, false),
• Auto off time (ms) - время, после которого произойдет программное размыкание реле,
• Behavior on start - стартовое поведение.

IR​

Позволяет управлять оборудованием при помощи ИК команд. Имеется возможность задавать повтор отправки команд, а также задержку между отправками команд. Для настройки управления необходимо произвести процедуру обучения ИК командам.

Обучение ИК-командам

1. Запустить приложение iRidium Studio.

2. Перейти к устройству IR

3. Для нужного подустройства, например IR1 (количество ИК выходов зависит от конкретной модели AB процессора), создать необходимое количество команд.

4. Выбрать для команд удобный формат, который будет отображен в iRidium Studio после обучения.

5. Нажать ПКМ на подустройстве и выбрать из меню пункт IR Learning (также можно обучать каждую команду в отдельности, для этого необходимо сделать ПКМ на нужной команде и выбрать из меню IR Learning).

6. Выбрать обучаемое устройство и ввести его IP адрес.

• ProAV Сontrol Processor: 30600
• I-PX-IR3: 1001 (по умолчанию, может быть изменен в web интерфейсе)

Если требуется выбрать конкретного производителя для обучения через AV Control Processor, установите флажок “Использовать стандарт ИК-частоты ”— после этого станет доступен список производителей.

Если нужного производителя нет в списке, выберите пункт “Другой ” и вручную укажите необходимую частоту.

7. Нажать кнопку "Начало".

8. Направить источник ИК сигналов на ИК приемник на передней панели устройства ProAV Control Processor.

9. Отправить нужную команду.

10. Повторить пункты 8-9 для остальных команд.

11. После обучения всех команд, процесс обучения завершится автоматически.

12. Для прерывания процесса обучения, необходимо нажать кнопку "Остановить" в окне "Learning".

После обучения необходимо подключить ИК передатчик к выходу, для которого были обучены команды и загрузить подготовленный проект в приложение iRidium Server на устройстве ProAV Control Processor. Теперь можно настроить отправку ИК команд с графических элементов в приложении i3Pro с помощью драйвера iRidium Server.

Изменение формата команд в iRidium Studio при наличии подготовленных ИК-команд

1. Запустить приложение iRidium Studio.

2. Создать серверный проект и добавить в него драйвер ProAV Control Processor.

3. Для нужного подустройства, например IR1 (количество ИК выходов зависит от конкретной модели AB процессора), создать необходимое количество команд.

4. Выбрать для команд формат отображения iRidi Hex в iRidium Studio.

5. В поле Date вставить ранее подготовленную команду формата iRidi Hex.

6. В поле Date Type изменить формат отображения на Pronto Hex

Настройка интерфейса RS-232/485​

Режим работы данного интерфейса определяется драйвером ProAV Control Processor.

В зависимости от модели, количество интерфейсов RS-232/485 может быть разное:

• ProAV Control Processor Basic (PX-VM20-Basic) - 1 (COM1)
• ProAV Control Processor Advanced (PX-VP100-Advanced) - 2 (COM1, COM2)

1. Одновременная работа RS-485 и RS-232 (без HRDW Flow Control), последовательность используемых пинов (слева направо):

2. Только RS-232 с HRDW Flow Control . Последовательность используемых пинов (слева направо): GND - TX - RX - RTS - CTS Данный режим используется по умолчанию.

Для выбора режима работы необходимо:

1. Запустить приложение iRidium Studio.

2. Создать серверный проект и добавить в него драйвер "ProAV Control Processor".

3. В настройках драйвера изменить значение параметра "COM 1 Mode", например на RS-232 + RS-485 .

4. Загрузить проект в iRidium Server.

В результате указанных действий, режим работы выхода COM 1 переключится на выбранный, что позволит подключить соответствующие оборудование и управлять им через выход.

1. В iRidium Studio создайте новый проект для iRidium server: File> New > New Server Project… и добавьте в созданный проект драйвер "ProAV Control Processor". Либо используйте уже созданный проект с драйвером "ProAV Control Processor".

2. Добавьте драйвер Modbus RTU в проект.

3. Выберите значение параметра "Used with iRidi device" равное порту RS-485, например, ProAV Processor Basic COM 1 (RS-485) .

4. Настройте параметры соединения:

• Host: /oem/hal/485_1_port;
• Update Time: время обновления данных в миллисекундах;
• Baud Rate: скорость передачи данных, бит/с (зависит от настройки устройств на шине, стандартно 9600);
• Data Bits: число бит данных (зависит от настройки устройств на шине, стандартно 8);
• Parity: проверка чётности (зависит от настройки устройств на шине, стандартно None);
• Stop bits: число стоповых битов (зависит от настройки устройств на шине, стандартно 1);
• Coil Write Function: тип Modbus-функции для отправки бинарных данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине);
• Holding Write Function: тип Modbus-функции для отправки аналоговых данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине).

Изучите руководства по эксплуатации остальных устройств на шине RS-485: настройте одинаковую скорость передачи данных на всех устройствах, задайте одинаковые параметры Data Bits, Parity, Stop Bits. Помимо этого, каждое устройство на шине должно иметь уникальный идентификатор (Device ID).

5. Настройте необходимое количество каналов. В каждом канале необходимо задать параметры Modbus RTU:

• Device ID: идентификационный номер slave-устройства;
• Type: тип данных (Coil, Discrete Input, Holding Register, Input Register);
• Address: адрес, по которому размещаются данные в slave-устройстве.

6. После этого проект настроен для передачи данных по протоколу Modbus RTU.

Активация HRDW Flow Control (RS-232)​

HRDW Flow control - это механизм управления потоком, который является частью стандарта RS-232. Он использует еще два контакта на разъеме RS-232, RTS (Запрос на отправку) и CTS (Разрешение на отправку). Эти две линии позволяют приемнику и передатчику оповещать друг друга о своем состоянии. Повышение и понижение этих линий позволяет драйверам устройств, которые реализуют аппаратный код управления потоком, поддерживать надежное соединение для передачи данных между передатчиком и приемником. Преимущество этого подхода заключается в том, что повреждение данных при передаче не влияет на механизм управления потоком (как в Xon/Xoff).

Для активации HRDW Flow Control необходимо:

1. В iRidium Studio создайте новый проект для iRidium server: File> New > New Server Project… и добавьте в созданный проект драйвер "ProAV Control Processor". Либо используйте уже созданный проект с драйвером "ProAV Control Processor".

2. Добавьте драйвер AV&Custom System в проект.

3. Выберите тип протокола Serial.

4. Выберите значение параметра "Used with iRidi device" равным RS-232, например ProAV Processor Basic COM 1 (RS-232) .

5. Измените значение параметра "HRDW Flow control" на Enable .

6. Остальные параметры измените согласно требованиям подключенного оборудования.

7. После этого проект настроен на работу через порт COM 1 в режиме RS-232 с HRDW Flow Control .

Настройка интерфейса RS-232​

Контроллер ProAV Control Processor имеет дополнительные встроенные порты RS-232, которые можно использовать, например, для обмена данными по протоколу Modbus RTU или Modbus ASCII.

1. В iRidium studio создайте новый проект для iRidium server: File> New > New Server Project… и добавьте в созданный проект драйвер "ProAV Control Processor". Либо используйте уже созданный проект с драйвером "ProAV Control Processor".

2. Добавьте драйвер Modbus RTU в проект.

3. Выберите значение параметра "Used with iRidi device" равным порту RS-232, например ProAV Processor Basic COM 2 (RS-232) .

4. Настройте параметры соединения:

• Host: /oem/hal/232_2_port;
• Update Time: время обновления данных в миллисекундах;
• Baud Rate: скорость передачи данных, бит/с (зависит от настройки устройств на шине, стандартно 9600);
• Data Bits: число бит данных (зависит от настройки устройств на шине, стандартно 8);
• Parity: проверка чётности (зависит от настройки устройств на шине, стандартно None);
• Stop bits: число стоповых битов (зависит от настройки устройств на шине, стандартно 1);
• Coil Write Function: тип Modbus-функции для отправки бинарных данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине);
• Holding Write Function: тип Modbus-функции для отправки аналоговых данных в шину (зависит от наличия поддержки multiple-функции Modbus в устройствах на шине).

Изучите руководства по эксплуатации остальных устройств на шине RS-232: настройте одинаковую скорость передачи данных на всех устройствах, задайте одинаковые параметры Data Bits, Parity, Stop Bits. Помимо этого, каждое устройство на шине должно иметь уникальный идентификатор (Device ID).

5. Настройте необходимое количество каналов. В каждом канале необходимо задать параметры Modbus RTU:

• Device ID: идентификационный номер slave-устройства;
• Type: тип данных (Coil, Discrete Input, Holding Register, Input Register);
• Address: адрес, по которому размещаются данные в slave-устройстве.

6. После этого проект настроен для передачи данных по протоколу Modbus RTU.

Настройка интерфейса Bus77 (TCP\IP)​

По умолчанию, интерфейс Bus77 активирован и можно сразу начинать работу с оборудованием Bus77:

1. В web-интерфейсе сервера, на вкладке System > Other , убедитесь, что активировано подключение CAN 0 (TCP Port 30467) (по умолчанию включено) и CAN 1 (TCP Port 30468) (по умолчанию включено на ProAV Control Processor PX-VP100).

2. В iRidium Studio создайте новый Bus77 проект: File> New > New Bus77 Project.

3. Подключитесь и отсканируйте шину Bus77.

4. Добавьте найденные устройства в проект Bus77.

Настройка интерфейса Bus77 (CAN-шина)​

Для работы с шиной Bus77 непосредственно из приложения iRidium Server напрямую по CAN интерфейсу, необходимо:

1. В web-интерфейсе сервера, на вкладке System > Other , отключите параметр CAN 0 (TCP Port 30467) (по умолчанию включено).
2. В iRidium studio создайте новый серверный проект: File> New > New Server Project.
3. Добавьте драйвер Bus77 в проект с помощью импорта устройств из приложения Bus77 Home или с помощью проекта Bus77 в iRidium Studio.
4. Загрузить готовый серверный проект в приложение iRidium Server на устройстве ProAV Control Processor.

Для управления из одного серверного проекта двумя выходами Bus77, на устройстве ProAV Control Processor PX-VP100, необходимо:

1. Открыть iRidium Studio и создать два проекта Bus77.

2. В первом проекте нажать кнопку “Устройство не найдено”.

3. Ввести IP адрес устройства и указать порт 30467 (для выхода CAN0).

4. Перетащить найденное устройство во вкладку “Device in project”.

5. Сохранить проект.

6. Перейти во второй проект Bus77. 7. Повторить шаги 2-5, указав при этом порт 30468 (для выхода CAN1).

7. Создать серверный проект.

8. Импортировать в него оба сохраненных проекта Bus77.

9. Изменить тип протокола у драйверов Bus77 на CAN.

10. У драйвера из второго проекта Bus77, при сканировании которого использовался порт 30468, изменить порт на CAN1.

Настройка интерфейса KNX​

Контроллер iRidi Pro Server (ProAV Control Processor) может работать как устройство шины KNX: принимать и отправлять команды через интерфейс KNX TP1. Также iRidi Pro Server (ProAV Control Processor) может выполнять функцию KNX/IP-шлюза, т.е. обеспечивает связь Engineering Tool Software (ETS) с шиной, а также работу клиентов по протоколу KNXnet/IP (но только после настройки).

Сервер как KNX-устройство​

Контроллер iRidi Pro Server (ProAV Control Processor) может подключиться к любому удаленному KNX IP интерфейсу или шлюзу для управления по протоколу KNXnet/IP (UDP) - по сети. Но, если ProAV Control Processor подключен к шине по KNX TP1, необходимо выбрать связь с шиной с использованием именно этого интерфейса.

1. Подключите iRidi Pro Server (ProAV Control Processor) к шине KNX с помощью интерфейса KNX TP1
2. Сохраните файл проекта в формате *.pr3, *.pr4, *.pr5, *.knxproj, *.csv. Желательно использовать буквы латиницы в имени проекта. Язык Windows должен совпадать с языком проекта для корректного импорта имен групповых адресов.
3. В iRidi Studio создайте новый проект для iRidi Server: File> New > New Server Project...
4. Нажмите кнопку Scanner/ Import в панели Драйверы, выберите ваш проект ETS и импортируйте его. На основе проекта ETS сформируется список доступных KNX IP интерфейсов и групповых адресов.

5. После импорта проекта, измените настройку Protocol драйвера на Serial - это настройка, обеспечивающая связь iRidi Pro Server (ProAV Control Processor) с интерфейсом KNX TP1. Настройки подключения к KNX полностью изменятся.

6. Настройте параметры подключения.

• Host: /oem/hal/knx_port
• Baud Rate: 38400
• Data Bits: 8
• Parity: None
• Stop Bits: 1
• Physical Address: физический адрес iRidi Pro Server как устройства шины

7. Настройка закончена. При запуске проекта на сервере, будет установлена связь с шиной через интерфейс TP1, iRidi Pro Server (ProAV Control Processor) будет определяться как устройство шины (будет иметь свой физический адрес), хотя не будет иметь собственных групповых адресов.

О других настройках iRidi Server и драйвера KNX читайте в разделах:

• Серверный проект в iRidi Studio
• iRidi для KNX

Сервер как KNX-устройство и KNX/IP-шлюз​

После специальной настройки iRidi Pro Server (ProAV Control Processor) может дополнительно выполнять функции KNX/IP-шлюза:

• обеспечивает связь ETS с шиной (ищется и добавляется в ETS как KNX-интерфейс)
• обеспечивает подключение к шине клиентов по протоколу KNXnet/IP
• обеспечивает передачу в шину мультикаст пакетов от других KNX IP интерфейсов

1. Подключите iRidi Pro Server (ProAV Control Processor) к шине KNX с помощью интерфейса KNX TP1.
2. В iRidi Studio создайте новый проект для iRidi Server: File> New > New Server Project...
3. Импортируйте и настройте (см. предыдущий раздел) или настройте вручную драйвер KNX Router (KNXnet/IP) / Serial для связи iRidi Pro Server (ProAV Control Processor) с шиной через KNX TP1. Выбрать KNX IP Gateway: True

• Host: /oem/hal/knx_port
• Baud Rate: 38400
• Data Bits: 8
• Parity: None
• Stop Bits: 1
• Physical Address: физический адрес iRidi Pro Server (ProAV Control Processor) как устройства шины

4. После запуска проекта с настроенным драйвером и скриптом на iRidi Pro Server (ProAV Control Processor) вы сможете найти ProAV Control Processor в ETS и использовать как интерфейс доступа в шине.

KNX IP Gateway - чек-бокс, отвечающий за включение/выключение KNX шлюзования. У него есть 3 поведения:

1. Если на сервер загружен драйвер KNX с протоколом Serial, то параметры Physical Adress и KNX IP Gateway Port шлюзование возьмет из драйвера.

2. Если на сервере нет драйвера KNX с протоколом Serial, то параметры Physical Adress и KNX IP Gateway Port будут стандартными (Physical Adress - 15.15.255, KNX IP Gateway Port - 3671).

3. Если на сервере было настроено KNX шлюзование через скрипт, то чек-бокс при попытке включения будет выдавать ошибку в лог сервера. Если перезагрузить страницу, то он будет выключен.

KNX IP Gateway Port - поле для ввода числового значения UDP порта работы KNX шлюзования.

Создайте пустой файл скрипта (иконка JS на верхней панели инструментов + New Script ) и вставьте в него скрипт:

IR.AddListener(IR.EVENT_START,0,function() 
{
   var KNXSerial = "KNX Router (KNXnet/IP) / Serial (UMC)";   // name of KNX Serial driver in your project
   
   if(IR.GetDevice(KNXSerial)) { 
      IR.GetDevice(KNXSerial).SetParameters({ServerDevice: "KNX IP"});
   }
   IR.CreateDevice(IR.DEVICE_KNX_IP_SERVER, 
                  "KNX IP",
                  {Port: 3671, 
                  ClientDevice: KNXSerial
                  });
});

Сервер как KNX/IP-шлюз​

Существует также возможность более простой активации функции KNX/IP-шлюза без создания драйвера и скрипта (так как описано выше). Нужно лишь активировать режим KNX/IP-шлюза в веб-интерфейсе сервера на вкладке Network > SYSTEM > Other > Server working mode .

Сканирование и мониторинг шины KNX​

Для мониторинга и сканирования шины необходимо настроить сервер как KNX/IP-шлюз.

После этого запустите приложение ETS для настройки и отладки устройств KNX и перейдите на вкладку Bus. Подключите необходимый интерфейс.

Сканирование шины KNX​

Сканирование линии позволяет увидеть устройства, подключенные к одной из линии сети KNX.

Для этого перейдите в соответствующую вкладку в меню:

Заполните поле Line Address и выберите среду передачи данных

Нажмите кнопку Scan.

Сервер просканирует линию и выведет на экран все адреса устройств, подключенных к ней.

Мониторинг шины KNX​

В ETS есть два типа мониторинга:

• мониторинг групповых операций;
• мониторинг шины.

Мониторинг групповых операций позволяет считывать нынешнее значение определенного устройства, а также присвоить ему новое значение.

Для этого перейдите во вкладку Group Monitor и нажмите кнопку Start.

Для того чтобы считывать или записывать значение в устройство в поле Group Address нужно вписать адрес нашего устройства

при нажатии на кнопку Read в таблице появится значение устройства из шины

Для изменения этого значения укажите новое значение в поле Value и нажмите на кнопку Write.

Мониторинг шины KNX при помощи ETS​

iRidium server версии pro 1.2.11 и старше поддерживает мониторинг шины KNX с помощью ПО Engineering Tool Software (ETS). Для этого необходимо активировать KNX/IP-шлюз, как описано в инструкции Сервер как KNX/IP-шлюз.

1. Запустите ETS. Перейдите на вкладку Diagnostics .

2. Далее перейдите на вкладку Bus Monitor .

3. Выберите из списка тот интерфейс GatewayKNXServerIP , который хотите мониторить.

4. Нажмите кнопку Start . Вы в реальном времени увидите все данные, которые проходят через KNX/IP-шлюз.

Настройка интерфейса HDL Buspro​

HDL-шлюз - это связь между портами LAN и CAN. При включенном HDL-шлюзе - устройства, находящиеся на шине CAN, могут обмениваться данными с устройствами, находящимися в сети Ethernet, как будто они все находятся на одной шине. На стороне Ethernet-сети используется протокол TCP.

Порты RS-485 и LAN можно использовать для реализации обмена данными по протоколу HDL Buspro.

Активация HDL-шлюза через веб-интерфейс​

HDL-шлюз - это связь между портами LAN и RS-485: при включенном HDL-шлюзе устройства, находящиеся на шине RS-485, могут обмениваться данными с устройствами, находящимися в сети Ethernet, как будто бы они все находятся на одной шине. На стороне Ethernet-сети используется протокол UDP.

Самый простой способ - активировать режим HDL-шлюза в веб-интерфейсе сервера на вкладке Network > SYSTEM > Other > Server working mode .

Включение шлюза HDL через веб-интерфейс будет работать только при подключении к порту COM 1. Чтобы настроить шлюз для работы через порт COM 2 необходимо воспользоваться инструкцией Настройка HDL Buspro на стороне RS-485 и Активация HDL-шлюза с помощью скрипта.

• Host: /oem/hal/485_1_port
• Baud Rate: 9600
• Data Bits: 8
• Parity: Even
• Stop bits: 1
• Send Timeout: период отправки данных на шину HDL Buspro в миллисекундах

4. Настройте параметры каждого устройства на шине HDL Buspro.

• Subnet ID: номер подсети;
• Device ID: уникальный идентификатор устройства.

Каждое устройство в пределах подсети шины должно иметь уникальный идентификатор (Device ID).

5. Задайте параметры каждого канала:

Наиболее важные параметры Command и Feedback драйвера HDL Buspro:

• Operation code: операция (команда протокола HDL Buspro)
• Option: опция операции
• Channel: канал многоканального устройства
• Parameter: параметр многофункционального устройства
• Need confirm: требуется подтверждение (рекомендуется установить Disable)
• Use Timer: циклическая отправка команды (true - включить, false - отключить)
• Timer, s: период циклической отправки команды в секундах

Изучите руководство по эксплуатации устройства HDL Buspro, чтобы правильно настроить сервер для обмена данными с ним. 6. После этого проект настроен для передачи данных по протоколу HDL Buspro через порт RS-485.

Настройка HDL Buspro на стороне LAN​

1. Добавьте драйвер HDL Buspro Network (UDP) и необходимое количество устройств HDL Buspro в проект:

2. Настройте общие параметры сети:

• Send timeout: период отправки данных в сеть HDL Buspro в миллисекундах
• Connect mode: способ подключения к сети HDL Buspro (Local - в локальной сети, Internet - с авторизацией по логину и паролю, Remote Server - с использованием удалённого сервера HDL Remote Server)
• Broadcast: маска IP-адресов широковещательной рассылки
• Fast Feedback: получение быстрого отклика без ожидания отклика от реального устройства
• Host: IP-адрес сервера
• Port: порт сервера
• Remote Server Priority: приоритет удалённого сервера (рекомендуется значение true)
• Login: логин для доступа к HDL Remote Server или в интернет
• Password: пароль для доступа к HDL Remote Server или в интернет
• External Port: удалённый порт
• Project Name: имя проекта
• Group Name: имя группы

3. Настройте параметры каждого устройства на шине HDL Buspro и параметры каждого его канала (по аналогии с предыдущим разделом).

4. После этого проект настроен для передачи данных по протоколу HDL Buspro через порт LAN.

Активация HDL-шлюза с помощью скрипта​

Создайте пустой файл скрипта (иконка JS на верхней панели инструментов + New Script ) и вставьте в него скрипт:

IR.AddListener(IR.EVENT_START, 0, function() 
{                                   
   var HDL_UDP = IR.GetDevice("HDL Buspro Network (UDP)"); //name of HDL Buspro (UDP) driver in your project
   var HDL_Serial = IR.GetDevice("HDL Buspro Network (RS-485)"); //name of HDL Buspro (RS-485) driver in your project
      
    if (HDL_UDP && HDL_Serial) { //check for drivers existence in project
      HDL_UDP.SetParameters({RouteDevice: HDL_Serial.Name});
      HDL_Serial.SetParameters({RouteDevice: HDL_UDP.Name});
   }; 
});

После запуска проекта с настроенным драйверами HDL Buspro Network (UDP) , HDL Buspro Network (RS-485) и скриптом вы сможете использовать порт LAN контроллера ProAV Control Processor как интерфейс доступа в последовательной шине HDL Buspro.

Сканирование устройств HDL Buspro в сети Ethernet​

iRidium studio имеет удобный функционал, который избавляет от необходимости определять каждое устройство в проекте вручную. iRidium studio опрашивает статус всех устройств в сети Ethernet по протоколу HDL Buspro, получает ответы и сохраняет конфигурацию сети и параметры каждого устройства в проекте.

1. Чтобы сканировать устройства, нажмите кнопку Scanner/ Import в панели Драйверы , затем нажмите HDL-Bus Pro network scanner :

2. После этого запустится процесс сканирования и через несколько секунд появятся найденные устройства:

3. Путём установки галочек можно выбрать устройства, какие из них будут добавлены в проект, а какие - нет. После нажатия на кнопку OK выбранные устройства со всеми своими параметрами запишутся в проект, в драйвер HDL Buspro Network (UDP) .

Импорт драйвера в панельный проект​

Есть несколько способов добавить драйвер ProAV Control Processor в панельный проект:

• в новый панельный проект,
• в готовый проект визуализации.

Добавление драйвера в новый панельный проект

Правой кнопкой мыши нажмите на вкладку серверного проекта и выберите пункт "Create panel project":

Будет создан панельный проект с пустой страницей и драйвером iRidium Server, в который перейдут все теги сервера. С ними можно будет работать как с командами и каналами обратной связи - привязывать к элементам для управления и отображения, обрабатывать с помощью iRidium Script.

При внесении изменений в серверный проект, вы можете быстро синхронизировать его с панельным проектом. Выберите драйвер iRidium Server и нажмите Synchronize .

Файл серверного проекта, с которым будет синхронизироваться драйвер, можно заменить в строке Source Project.

Добавление драйвера в готовый проект визуализации

Если вы уже создали проект визуализации, и хотите добавить в него ProAV Control Processor:

1. Добавьте драйвер iRidium Server из базы данных;
2. Укажите путь к проекту *.sirpz, с которым находится драйвер ProAV Control Processor;
3. Вы получите драйвер iRidium Server с актуальным списком команд и каналов обратной связи.

Настройка команд и фидбеков​

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).

Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".

Input: Button​

Пример получения данных через JS:

//Вывод состояния логического входа в лог:
var state = "Drivers.iRidium Server.ProAV Control Processor.Input 2: Button:State";
IR.SetGlobalListener(IR.EVENT_GLOBAL_TAG_CHANGE, function(name, value)
{
   if (name == state)
      IR.LOG(value);
});
IR.SubscribeTagChange(state);

Input: Voltage Sensor​

Пример получения данных через JS:

//Вывод значения напряжения на элемент:
var voltage = "Drivers.iRidium Server.ProAV Control Processor.Input 1: Voltage Sensor:Voltage";
IR.SetGlobalListener(IR.EVENT_GLOBAL_TAG_CHANGE, function(name, value)
{
   if (name == voltage)
      IR.GetPage("Page 1").GetItem("Item 1").GetState(0).Text = value;
});
IR.SubscribeTagChange(voltage);

Input: Temperature Sensor​

Пример получения данных через JS:

//Вывод температуры на элемент:
var temperature = "Drivers.iRidium Server.ProAV Control Processor.Input 1: Temperature Sensor:Temperature";
IR.SetGlobalListener(IR.EVENT_GLOBAL_TAG_CHANGE, function(name, value)
{
   if (name == temperature)
      IR.GetPage("Page 1").GetItem("Item 1").GetState(0).Text = value;
});
IR.SubscribeTagChange(temperature);

Relay​

Пример отправки данных через JS:

//Переключение реле по нажатию на кнопку:
IR.AddListener(IR.EVENT_ITEM_RELEASE, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
    IR.GetDevice("iRidium Server").Set("ProAV Control Processor.Relay 1:Toggle", 1)
});

IR​

Пример отправки данных через JS:

//Отправка команды по нажатию на кнопку:
IR.AddListener(IR.EVENT_ITEM_RELEASE, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
    IR.GetDevice("iRidium Server").Set("ProAV Control Processor.IR 2:Send", 1)
});

Тестирование сервера​

Запуск проекта в тестовом режиме​

Тестовый режим - это возможность загружать на сервер и тестировать проекты прямо из iRidi Studio, без покупки лицензий. Если загружать проект на сервер из iRidi cloud - он использует коммерческую или Trial лицензию.

Загрузку проекта из studio на сервер обеспечивает программа iRidi transfer и включенный тестовый режим на сервере.

В iRidi transfer, после настройки сервера, нажмите кнопку Поиск. В результате поиска в Transfer появится новое устройство с именем (Server)

Включите опцию "Test Mode: ON" в настройках сервера, чтобы использовать его в режиме полной функциональности. Подробнее о режимах использования читайте в разделе Политика лицензирования.

Проверьте, действительно ли активирован режим Test Mode, нажав на кнопку в нижнем левом углу.

С активным Test Mode вы можете тестировать работу облачных проектов и загружать проекты из iRidi transfer (локально, без использования iRidi cloud).

Проверка проекта в триальном режиме​

Для проверки проектов на устройствах заказчика, используйте триальный режим. Он обеспечивает конечным пользователям 60 дней тестирования проектов. Продлить триальный период нельзя, но он доступен для любого нового объекта в облаке. По завершению триального периода, заказчик принимает решение о покупке лицензии iRidium.

Для активации триальной лицензии:

• перейдите в личный кабинет интегратора;
• выберите необходимый объект в списке;
• перейдите на вкладку pro > МОИ ПРОЕКТЫ > Лицензии ;
• активируйте временную лицензию на 2 месяца "Get trial period (2 month) ".

Активация и деактивация сервера​

Активация и деактивация сервера описаны в инструкциях:

• активация сервера c онлайн лицензированием;
• активация сервера с офлайн лицензированием (USB-ключом).

Перестало работать управление с панелей?​

Если у вас неожиданно пропало управление с панелей, исключите возможные проблемы с лицензией:

1. Убедитесь, что сервер активирован.

2. Убедитесь, что количество панелей не превышает лимит коммерческой лицензии (подробнее здесь).

3. Проверьте подключение к серверу с триальной лицензией.

Если предыдущие шаги не помогли, активируйте триальную лицензию, чтобы восстановить работу сервера и опишите свою ситуацию в тех. поддержку support@iridi.com, указав:

• режим работы сервера: cloud gate / direct connect;
• hwid сервера;
• сервер активирован аккаунтом: email интегратора;
• версия сервера;
• панели, которые имеют проблемы в проекте:
  • hwid панели;
  • email авторизованного пользователя;
• версия установленного приложения
• название объекта в личном кабинете;
• дополнительные файлы (при необходимости): лог сервера, скриншоты, видеозапись и др.