iRidium для Helvar

набор инструментов для создания интерфейсов управления оборудованием Helvar

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

Описание​

iRidium для Helvar - это набор инструментов, позволяющий создать интерфейс для управления освещением на базе оборудования Helvar.

Подключиться к Helvar можно разными способами (драйверами): HelvarNet (TCP), HelvarNet (UDP), HelvarNet Internal (UDP), Helvar AV (RS232).

Лицензирование iRidium для Helvar (подробно).

Подключение​

Конфигурация оборудования и настройки, необходимые для того, чтобы iRidium начал управлять Helvar.

Способы подключения к Helvar​

Драйвры Helvar имеют особенности, которые нужно учитывать при выборе способа управления:

Локальное соединение:HelvarNet (TCP), HelvarNet (UDP), HelvarNet Internal (UDP), HelvarAV (RS232)

Интернет соединение:HelvarNet (TCP)

1. HelvarNet (TCP)

• поддерживает Site лицензию
• обновляет статусы устройств только по запросу панели управления
• поддерживает 1 подключение в локальной сети
• поддерживает 1 подключение в через Интернет

2. HelvarNet (UDP)

• поддерживает Site лицензию
• обновляет статусы устройств только по запросу панели управления
• получает только те изменения, которые запросила панель управления
• поддерживает несколько подключений в локальной сети
• не поддерживает подключение через Интернет

3. HelvarNet Internal (UDP)

• использует широковещание - UDP broadcasting в пределах сегмента IP-сети
• НЕ поддерживает Site лицензию
• информация об изменении состояний приходит без принудительного запроса
• поддерживает несколько подключений в локальной сети
• не поддерживает подключение через Интернет

4. Helvar AV (RS232)

• использует транспорт RS232 для подключения к DALI
• НЕ поддерживает Site лицензию
• поддерживает 1 подключение в локальной сети
• не поддерживает подключение через Интернет

Импорт драйвера Helvar в iRidium​

Импорт позволяет добавить в проект выгруженный из приложения Designer файл в формате csv. Это наиболее быстрый и удобный способ добавления драйвера в проект, все выгруженные в проект команды и фидбэки будут иметь предустановленные настройки, которые при необходимости можно изменить.

Для импорта:

1. Откройте приложение Designer и перейдите в Tools > Grouping Report...

2. Сгенерируйте отчёт о группах:

3. Перейдите во вкладку Reports, ПКМ по отчёту откройте меню и нажмите кнопку Save As :

4. В iRidium Studio нажмите кнопку Scanner / Import и выберите '''Import Helvar (*.csv).

5. Выберите необходимый файл в формате csv.

6. Выберите все необходимые устройства для импорта.

7. В проекте появится драйвер с командами и фидбэками, разделенных по папкам.

Добавление драйвера Helvar вручную​

Помимо импорта вы можете добавить драйвер Helvar и настроить его вручную:

Настройка подключения к Helvar​

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

• Host - IP-адрес роутера в локальной сети (или публичный IP-адрес маршрутизатора)
• Port - порт подключения к роутеру (TCP / UDP). Для TCP порт всегда 50000, для UDP - 50001

Для работы через Интернет укажите публичный IP-адрес маршрутизатора, к которому подключен контроллер и настройте проброс управляющего порта (Port Forwarding).

Публичный IP-адрес маршрутизатора можно узнать, например, через Яндекс.Интернет

Смена настроек подключения​

Возможность смены параметров подключения нужна, если вы отключаетесь от Wi-Fi сети объекта автоматизации и начинаете использовать 3G или другую Wi-Fi сеть. Чтобы управление продолжило работать, нужно переключиться с локального на публичный IP адрес интернет-маршрутизатора.

Переключение не происходит автоматически, вам нужно будет нажать на клавишу выбора режима соединения. Для возможности удаленного доступа необходимо сделать порты управления системой автоматизации публичными. Для этого настраивают службу Port Forwarding на интернет-маршрутизаторе. Защищенное соединение может обеспечить VPN.

1. Скачайте шаблон (*.js) (правая кнопка: "Сохранить объект как..."), добавьте шаблон в редактор скриптов клавишей (+) Add Script from file

2. Настройте параметры скрипта, как показано в примере:

function Internal_1() {
IR.GetDevice("HelvarNet (TCP)").SetParameters({Host: "10.254.1.2", Port: 50000});
}
function External_1() {
IR.GetDevice("HelvarNet (TCP)").SetParameters({Host: "215.110.10.10", Port: 50000});
}

Скопируйте имя драйвера из Projсet Device Panel, список параметров нужно скопировать из примера в точности.

3. Выберите кнопку, которая будет отвечать за переключение Internal и External параметров. Откройте Macros Editor для события Press (Object Properties > Programming), выберите команду Script Call и добавьте ее двойным кликом. Выберите имя функции, которую вызовет кнопка:

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

Управление оборудованием​

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

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

Возможные настройки команд, каналов и графических элементов представлены далее:

Direct Level, Query Load Level​

Direct Level используется чтобы включить/выключить/установить яркость устройства (Device) или группы (Group).

Query Load Level — это канал обратной связи, который периодически запрашивает и отдаёт в интерфейс статус управляемого устройства (Device).

Command (Direct Level Device)

Command (Direct Level Group)

Value — указывается при перетягивании команды на графический элемент. В системе Helvar диапазон 0–100, диммер обрабатывает все значения, а реле реагирует на ноль и ненулевое значение. Для реле существует порог срабатывания, ниже которого оно не включается.

Feedback (Query Load Level)

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

Recall Scene​

Чтобы вызывать сцену, запрограммированную для устройства или группы устройств в системе Helvar, используется команда Recall Scene Device / Group.

Команда вызова сцены может быть направлена только на нагрузки (диммеры, релейные блоки, балласты и т.д.).

Command (Recall Scene Device)

Command (Recall Scene Group)

Feedback: информацию о текущей сцене получить нельзя.

Direct Proportion​

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

Command (Direct Proportion Device)

Command (Direct Proportion Group)

Feedback:

Текущее состояние устройства приходит в Query Load Level

Modify Proportion​

Модификация пропорции. Результат применения можно рассчитать по формулам "#Direct Proportion", но "Modify Proportion" влияет на значение самой пропорции, а не на результат её применения. Таким образом, к 50%, добавленным через "Direct Proportion", мы можем добавить 5% через "Modify Proportion" (всего 55%) и получить результат по первоначальной формуле.

Command (Modify Proportion Device)

Command (Modify Proportion Group)

Value — указывается при перетягивании команды на графический элемент.

Feedback:

Текущее состояние устройства приходит в Query Load Level

Emergency Test Control Commands​

"Emergency Function Test Device" и "Emergency Duration Test Device" — запросы аварийного состояния для отправки только на DALI интерфейсы. От не аварийных устройств системы ответа не последует.

Command (Device)

Command (Group)

Feedback (Device)

Feedback (Group)

Query Commands​

Запросы статуса устройств в системе Helvar формируются во вкладке Feedbacks и срабатывают в цикле, с определенным интервалом, который настраивается в параметре Timer.

Если выбранный вами протокол работы с Helvar поддерживает авто-уведомление об изменении статусов системы, создайте Feedback без таймера.

Feedback:

• Value - приходит в канал обратной связи, используйте для отображения на элементах

Поддерживается обработка команды Query Load Color первой и второй версии протокола.

Query Device State​

Каждое устройство, входящее в состав системы управления освещением Helvar, по запросу может выдавать информацию о ряде своих параметров (флагов). Это может быть использовано при мониторинге состояния системы освещения.

Для отображения флагов устройства, создаем канал обратной связи, в настройках которого указывается адрес устройства и частота запроса флага. Канал привязываем к графическому элементу, который будет отображать статус флага (0 - не активен, 1 - активен):

Feedback:

• Value - приходит в канал обратной связи, используйте для отображения на элементах