Перейти к основному содержимому
Подсказка

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 имеют особенности, которые нужно учитывать при выборе способа управления:

Helvar_HowItWorks.png Локальное соединение: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. Это наиболее быстрый и удобный способ добавления драйвера в проект, все выгруженные в проект команды и фидбэки будут иметь предустановленные настройки, которые при необходимости можно изменить.

Для импорта:

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

Helvar_Import5.jpeg Helvar_Import6.jpg

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

Helvar_Import7.jpg

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

Helvar_Import8.jpg

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

Helvar_Import.png

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

Helvar_Import2.png

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

Helvar_Import3.png

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

Helvar_Import4.png

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

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

Helvar1.png

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

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

Helvar_2.png

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

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

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

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

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

SendRecieve.png

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

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

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

Direct Level, Query Load Level

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

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

Command (Direct Level Device):

Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *0...100заданное значение яркости

Command (Direct Level Group):

Group1...16383адрес группы устройств в системе Helvar
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *0...100заданное значение яркости
  • Value - укажите при перетягивании команды на графический элемент. В системе Helvar, диапазон для любого устройства составляет 0 ~ 100, но, диммер обрабатывает все значения диапазона, а реле реагирует на нулевое и НЕ нулевое значение. При этом, для реле существует понятие "предела срабатывания", и если отправить значение меньше этого предела, реле не сработает. Настройки срабатывания формируются при конфигурации Helvar.

Feedback (Query Load Level):

Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Use TimerYes/Noзапрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет.
Timer0...n(мс) частота запроса статуса устройства
Value *0...100текущее значение яркости устройства
  • Value - приходит в канал обратной связи, используйте для отображения на элементах

Recall Scene

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

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

Command (Recall Scene Device):

Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
CL0...1Constant Light: 1 = On, 0 = Off
Block1...8номер блока, "Scene 1.2" = блок 1 сцена 2 (см. Helvar Designer).
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *1...nномер сцены

Command (Recall Scene Group):

Group1...16383адрес группы устройств в системе Helvar
CL0...1Constant Light: 1 = On, 0 = Off
Block1...8номер блока, "Scene 1.2" = блок 1 сцена 2 (см. Helvar Designer).
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *1...nномер сцены
  • Value - укажите при перетягивании команды на графический элемент

Feedback:

Информацию о том, какая сцена сейчас работает, получить нельзя.

Direct Proportion

Установка пропорции. При использовании "Direct Proportion", установленное значение определяется как разница между последним значением (заданным сценой или напрямую) и максимальным выходным уровнем устройства.

Command (Direct Proportion Device):

Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *0...100значение пропорции

Command (Direct Proportion Group):

Group1...16383адрес группы устройств в системе Helvar
Fade Time0...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):

Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *0...100значение пропорции

Command (Modify Proportion Group):

Group1...16383адрес группы устройств в системе Helvar
Fade Time0...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остановить все аварийные проверки
Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value *-не используется, оставьте 0 или пустое значение

Command (Group):

Emergency Duration Test Deviceзапрос продолжительности аварийного состояния
Stop Emergency Tests Deviceостановить все аварийные проверки
Group1...16383адрес группы устройств в системе Helvar
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value0...100не используется, оставьте 0 или пустое значение

Feedback (Device):

Emergency Duration Test Deviceпродолжительность аварийного состояния
Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Fade Time0...6553.5*10^3(мс) скорость перехода из текущего статуса в заданный
Value0...nтекущее состояние

Feedback (Group):

Emergency Duration Test Deviceпродолжительность аварийного состояния
Group1...16383адрес группы устройств в системе Helvar
Value0...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системные параметры
Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Use TimerYes/Noзапрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет.
Timer0...n(мс) частота запроса статуса устройства
Subdevice1...255адрес подустройства
Value *0...100текущее значение параметра
  • Value - приходит в канал обратной связи, используйте для отображения на элементах

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

Query Device State

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

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

Feedback:

Command PropertyDisabledDevice or subdevice has been disabled, usually an IR subdevice or a DMX channel
Lamp FailureUnspecified lamp problem
MissingThe device previously existed but is not currently present
FaultyRan out of addresses (DALI subnet) / unknown Digidim control device / DALI load that keeps responding with multi-replies
RefreshingDALI subnet, DALI load or Digidim control device is being discovered
RestingLoad is intentionally off whilst the control gear is being powered by the emergency supply
Reserved
In EmergencyNo mains power is being supplied
In ProlongMains has been restored but device is still using the emergency supply
FT In ProgressThe Functional Test is in progress (brief test where the control gear is being powered by the emergency supply)
DT In ProgressThe 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 PendingThe Duration Test has been requested but has not yet commenced. The test can be delayed if the battery is not fully charged
FT PendingThe 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 FailBattery has failed
In Hi BitPrevents an emergency fitting from going into emergency mode
FT RequestedEmergency Function Test has been requested
DT RequestedEmergency Duration Test has been requested
UnknownInitial state of an emergency fitting
Over TemperatureLoad is over temperature/heating
Over CurrentToo much current is being drawn by the load
Comms ErrorCommunications error
Severe ErrorIndicates that a load is either over temperature or drawing too much current, or both
Bad ReplyIndicates that a reply to a query was malformed
Device MismatchThe actual load type does not match the expected type
Cluster1...253адрес устройства (@ address)
Router1...254адрес устройства (@ address)
Subnet1...4адрес устройства (@ address)
Device1...255адрес устройства (@ address)
Use TimerYes/Noзапрос статуса устройства по таймеру (HelvarNet не отдает статус без запроса). Если таймер выключен, статус устройства получен не будет.
Timer0...n(мс) частота запроса статуса устройства
Subdevice1...255адрес подустройства
Value *0...100текущее значение параметра
  • Value - приходит в канал обратной связи, используйте для отображения на элементах