iRidium для Helvar
набор инструментов для создания интерфейсов управления оборудованием Helvar
документация обновлена 01.01.2024
обучение: вебинары и видео-уроки
скачать:
Описание
iRidium для Helvar - это набор инструментов, позволяющий создать интерфейс для управления освещением на базе оборудования Helvar.
Подключиться к Helvar можно разными способами (драйверами): HelvarNet (TCP), HelvarNet (UDP), HelvarNet Internal (UDP), Helvar AV (RS232).
Убедитесь, что ваш Helvar роутер поддерживает протокол HelvarNet, иначе необходимо обновление программного обеспечения и прошивки
Для подключения по IP используйте DIGIDIM 910/920
Лицензирование iRidium для Helvar (подробно).
Подключение
Конфигурация оборудования и настройки, необходимые для того, чтобы iRidium начал управлять Helvar.
Способы подключения к Helvar
Драйвры Helvar имеют особенности, которые нужно учитывать при выборе способа управления:
Локальное соединение:HelvarNet (TCP), HelvarNet (UDP), HelvarNet Internal (UDP), HelvarAV (RS232)
Интернет соединение:HelvarNet (TCP)
- HelvarNet (TCP)
- поддерживает Site лицензию
- обновляет статусы устройств только по запросу панели управления
- поддерживает 1 подключение в локальной сети
- поддерживает 1 подключение в через Интернет
- HelvarNet (UDP)
- поддерживает Site лицензию
- обновляет статусы устройств только по запросу панели управления
- получает только те изменения, которые запросила панель управления
- поддерживает несколько подключений в локальной сети
- не поддерживает подключение через Интернет
- HelvarNet Internal (UDP)
- использует широковещание - UDP broadcasting в пределах сегмента IP-сети
- НЕ поддерживает Site лицензию
- информация об изменении состояний приходит без принудительного запроса
- поддерживает несколько подключений в локальной сети
- не поддерживает подключение через Интернет
- Helvar AV (RS232)
- использует транспорт RS232 для подключения к DALI
- НЕ поддерживает Site лицензию
- поддерживает 1 подключение в локальной сети
- не поддерживает подключение через Интернет
Импорт драйвера Helvar в iRidium
Импорт позволяет добавить в проект выгруженный из приложения Designer файл в формате csv. Это наиболее быстрый и удобный способ добавления драйвера в проект, все выгруженные в проект команды и фидбэки будут иметь предустановленные настройки, которые при необходимости можно изменить.
Для импорта:
- Откройте приложение Designer и перейдите в Tools > Grouping Report...

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

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

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

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

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

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

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

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

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

Для управления оборудованием настройте команды (Commands) и каналы обратной связи (Feedbacks). Чтобы отправить команду, перетяните ее на графический элемент и укажите значение (Value), которое необходимо отправить. Чтобы отобразить значение с канала обратной связи, перетащите Feedback на графический элемент, и укажите, каким образом вывести значение (Value).
Подробнее о работе с графическими элементами написано в статье "Типы графических элементов".
Возможные настройки команд, каналов и графических элементов представлены далее:
Direct Level, Query Load Level
Direct Level используется чтобы включить/выключить/установить яркость устройства (Device) или группы (Group).
Query Load Level - это канал обратной связи, который периодически запрашивает и отдает в интерфейс статус управляемого устройства (Device).
Command (Direct Level Device):
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | заданное значение яркости |
Command (Direct Level Group):
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | заданное значение яркости |
- Value - укажите при перетягивании команды на графический элемент. В системе Helvar, диапазон для любого устройства составляет 0 ~ 100, но, диммер обрабатывает все значения диапазона, а реле реагирует на нулевое и НЕ нулевое значение. При этом, для реле существует понятие "предела срабатывания", и если отправить значение меньше этого предела, реле не сработает. Настройки срабатывания формируются при конфигурации Helvar.
Feedback (Query Load Level):
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Use Timer | Yes/No | запрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет. |
| Timer | 0...n | (мс) частота запроса статуса устройства |
| Value * | 0...100 | текущее значение яркости устройства |
- Value - приходит в канал обратной связи, используйте для отображения на элементах
Recall Scene
Чтобы вызывать сцену, запрограммированную для устройства или группы устройств в системе Helvar, используется команда "Recall Scene Device / Group".
Команда вызова сцены может быть направлена только на нагрузки (диммеры, релейные блоки, балласты, ...):
Command (Recall Scene Device):
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| CL | 0...1 | Constant Light: 1 = On, 0 = Off |
| Block | 1...8 | номер блока, "Scene 1.2" = блок 1 сцена 2 (см. Helvar Designer). |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 1...n | номер сцены |
Command (Recall Scene Group):
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| CL | 0...1 | Constant Light: 1 = On, 0 = Off |
| Block | 1...8 | номер блока, "Scene 1.2" = блок 1 сцена 2 (см. Helvar Designer). |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 1...n | номер сцены |
- Value - укажите при перетягивании команды на графический элемент
Feedback:
Информацию о том, какая сцена сейчас работает, получить нельзя.
Direct Proportion
Установка пропорции. При использовании "Direct Proportion", установленное значение определяется как разница между последним значением (заданным сценой или напрямую) и максимальным выходным уровнем устройства.
Command (Direct Proportion Device):
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | значение пропорции |
Command (Direct Proportion Group):
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | значение пропорции |
- Value - укажите при перетягивании команды на графический элемент.
Feedback:
Текущее состояние устройства приходит в i
Как вычисляется значение пропорции
Результат записи положительной пропорции: если последняя сцена установила 44% яркости и вы запишите 50 в "Direct Proportion Device", результирующая яркость составит 72%:
44 + (100 - 44)*50/100 = 72%
Результат записи отрицательной пропорции: если последняя сцена установила 44% яркости, и вы запишите -50 в "Direct Proportion Device", результирующая яркость составит 22%:
44*50/100 = 22%
Modify Proportion
Модификация пропорции. Результат применения можно рассчитать по формулам "i ", но "Modify Proportion" влияет на значение самой пропорции, а не на результат ее применения. Таким образом, к 50%, добавленным через "Direct Proportion" мы можем добавить 5% через "Modify Proportion" (всего 55%) и получить результат по первоначальной формуле.
Command (Modify Proportion Device):
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | значение пропорции |
Command (Modify Proportion Group):
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | 0...100 | значение пропорции |
- Value - укажите при перетягивании команды на графический элемент.
Feedback:
Текущее состояние устройства приходит в i
Как модифицируется значение пропорции
Результат записи положительной модификации: возьмем пример команды "Direct Proportion", описанный в предыдущем разделе. Когда команда отправлена, последующая модификация пропорции на 5% даст результат 75% яркости, т.к. применяется к предыдущему значению "Direct Proportion":
44 + (100 - 44)*(50 + 5)/100 = 75%
Результат записи отрицательной модификации: возьмем пример команды "Direct Proportion", описанный в предыдущем разделе. Когда команда отправлена, последующая модификация пропорции на -5% даст результат 19% яркости, т.к. применяется к предыдущему значению "Direct Proportion":
44*(50 - 5)/100 = 19%
Emergency Test Control Commands
"Emergency Function Test Device" и "Emergency Duration Test Device" - запросы аварийного состояния для отправки только на DALI интерфейсы. От не аварийных устройств системы ответа не последует.
Command (Device):
| Emergency Duration Test Device | запрос продолжительности аварийного состояния | |
| Stop Emergency Tests Device | остановить все аварийные проверки | |
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value * | - | не используется, оставьте 0 или пустое значение |
Command (Group):
| Emergency Duration Test Device | запрос продолжительности аварийного состояния | |
| Stop Emergency Tests Device | остановить все аварийные проверки | |
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value | 0...100 | не используется, оставьте 0 или пустое значение |
Feedback (Device):
| Emergency Duration Test Device | продолжительность аварийного состояния | |
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Fade Time | 0...6553.5*10^3 | (мс) скорость перехода из текущего статуса в заданный |
| Value | 0...n | текущее состояние |
Feedback (Group):
| Emergency Duration Test Device | продолжительность аварийного состояния | |
| Group | 1...16383 | адрес группы устройств в системе Helvar |
| Value | 0...n | текущее состояние |
Query Commands
Запросы статуса устройств в системе Helvar формируются во вкладке Feedbacks и срабатывают в цикле, с определенным интервалом, который настраивается в параметре Timer.
Если выбранный вами протокол работы с Helvar поддерживает авто-уведомление об изменении статусов системы, создайте Feedback без таймера.
Feedback:
| Query Clusters | все идентификаторы элементов (Cluster Member), которые есть в кластере | |
| Query Routers | все идентификаторы в указанном кластере | |
| LSIB - Last Scene In Block | последняя запущенная сцена указанного блока | |
| Query Device Type | тип опрашиваемого устройства. 1 - DALI, 2 - Digidim, 4 - SDIM, 8 - DMX | |
| Query Description | описание устройства/группы | |
| |Device State Query Commands | ||
| Query Device State | флаги (параметры) устройства - список | |
| Query Device Is Disabled | отключение устройства | |
| Query Lamp Failure | повреждение лампы | |
| Query Device Is Missing | отсутствие устройства | |
| Query Device Is Faulty | неисправность устройства | |
| Query Emergency Battery Failure | повреждение аварийной батареи | |
| Measurement / Input / Level Query Commands | ||
| Query Measurement | изменение аналогового параметра, например, света (Analogue Input Unit) | |
| Query Inputs | состояние цифрового входа | |
| Query Load Level | статус устройства | |
| Power Consumption Query Commands | ||
| Query Power Consumption | энергопотребление устройства | |
| Query Group Power Consumption | энергопотребление всех устройств в группе | |
| Emergency Test Query Commands | ||
| Query Emergency Function Test Time | время аварийной проверки | |
| Query Emergency Function Test State | статус аварийной проверки. Pass - 0, Lamp Failure - 1, Battery Failure - 2, Faulty - 4, Failure - 8, Test Pending - 16, Unknown - 32 | |
| Query Emergency Duration Test Time | продолжительность аварийной проверки | |
| Query Emergency Duration Test State | продолжительность аварийного состояния | |
| Query Emergency Battery Charge | оставшийся заряд аварийной батареи | |
| Query Emergency Battery Time | общее время работы аварийной батареи | |
| Query Emergency Total Lamp Time | общее время работы лампы от любого источника питания | |
| System Query Commands | ||
| Query Time, Longitude, Latitude, Time Zone, Daylight Saving Time, Software Version, HelvarNet Version | системные параметры | |
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Use Timer | Yes/No | запрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет. |
| Timer | 0...n | (мс) частота запроса статуса устройства |
| Subdevice | 1...255 | адрес подустройства |
| Value * | 0...100 | текущее значение параметра |
- Value - приходит в канал обратной связи, используйте для отображения на элементах
Поддерживается обработка команды Query Load Color первой и второй версии протокола.
Query Device State
Каждое устройство, входящее в состав системы управления освещением Helvar, по запросу может выдавать информацию о ряде своих параметров (флагов). Это может быть использовано при мониторинге состояния системы освещения.
Для отображения флагов устройства, создаем канал обратной связи, в настройках которого указывается адрес устройства и частота запроса флага. Канал привязываем к графическому элементу, который будет отображать статус флага (0 - не активен, 1 - активен):
Feedback:
| Command Property | Disabled | Device or subdevice has been disabled, usually an IR subdevice or a DMX channel |
| Lamp Failure | Unspecified lamp problem | |
| Missing | The device previously existed but is not currently present | |
| Faulty | Ran out of addresses (DALI subnet) / unknown Digidim control device / DALI load that keeps responding with multi-replies | |
| Refreshing | DALI subnet, DALI load or Digidim control device is being discovered | |
| Resting | Load is intentionally off whilst the control gear is being powered by the emergency supply | |
| Reserved | ||
| In Emergency | No mains power is being supplied | |
| In Prolong | Mains has been restored but device is still using the emergency supply | |
| FT In Progress | The Functional Test is in progress (brief test where the control gear is being powered by the emergency supply) | |
| DT In Progress | The Duration Test is in progress. This test involves operating the control gear using the battery until the battery is completely discharged. The duration that the control gear was operational for is recorded, and then the battery recharges itself from the mains supply | |
| DT Pending | The Duration Test has been requested but has not yet commenced. The test can be delayed if the battery is not fully charged | |
| FT Pending | The Functional Test has been requested but has not yet commenced. The test can be delayed if there is not enough charge in the battery | |
| Battery Fail | Battery has failed | |
| In Hi Bit | Prevents an emergency fitting from going into emergency mode | |
| FT Requested | Emergency Function Test has been requested | |
| DT Requested | Emergency Duration Test has been requested | |
| Unknown | Initial state of an emergency fitting | |
| Over Temperature | Load is over temperature/heating | |
| Over Current | Too much current is being drawn by the load | |
| Comms Error | Communications error | |
| Severe Error | Indicates that a load is either over temperature or drawing too much current, or both | |
| Bad Reply | Indicates that a reply to a query was malformed | |
| Device Mismatch | The actual load type does not match the expected type | |
| Cluster | 1...253 | адрес устройства (@ address) |
| Router | 1...254 | адрес устройства (@ address) |
| Subnet | 1...4 | адрес устройства (@ address) |
| Device | 1...255 | адрес устройства (@ address) |
| Use Timer | Yes/No | запрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет. |
| Timer | 0...n | (мс) частота запроса статуса устройства |
| Subdevice | 1...255 | адрес подустройства |
| Value * | 0...100 | текущее значение параметра |
- Value - приходит в канал обратной связи, используйте для отображения на элементах