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

iRidium для Lutron Homeworks QS

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

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

Подсказка

скачать пример: *iRidium Lutron

iRidium для Lutron Homeworks QS - это набор инструментов, позволяющий создать интерфейс для управления домом или офисом на базе одноименного оборудования. Реализует команды протокола Lutron.

Подключение

примечание

Панели управления (iOS, Android, Windows, Mac) могут управлять оборудованием Lutron Homeworks QS только через процессор Homeworks QS.

LutronConnection.png

  1. Предварительно сконфигурируйте процессор с помощью программы Lutron Designer(по вопросам доступа к функционалу программы, обращайтесь к производителю).
  2. Выберите необходимые устройства в конфигураторе и активируйте их(в ходе этого процесса каждому устройству будет назначен индивидуальный ID).
  3. Сохраните проект и отправьте конфиг в процессор.
примечание
  • При настройке кнопочных панелей укажите параметр "Led Logic", как "Via Integration". Только при таком условии, панели будут корректно обрабатывать запрос от iRidium.

  • Для панелей термостата! В протоколе разработчика не описано команд, которые бы позволили эмулировать нажатия кнопок на панели термостата.

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

Если у вас нет возможности импортировать устройство, добавьте драйвер Lutron Homeworks QS в проект из базы данных iRidium:

  1. Запустите приложение iRidium Studio, создайте новый серверный проект iRidium;
  2. Добавьте драйвер Lutron Homeworks QS в проект.

Обязательно укажите адрес контроллера в проекте iRidium, иначе он не будет работать.

lutron_add_device.png

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

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

lutron_params.png

  • Log Level - уровень логирования
  • Host - IP адрес контроллера
  • Port - порт подключения к контроллеру
  • Login - Логин доступа к контроллеру
  • Password - Пароль доступа к контроллеру

Изменение параметров подключения

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

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

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

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

function Internal_1() {
IR.GetDevice('BACnet').SetParameters({Host: "192.168.0.95", Port: 5001, Login: "admin", Password: "admin"});
}
function External_1() {
IR.GetDevice('BACnet').SetParameters({Host: "215.110.10.10", Port: 5001, Login: "user", Password: "user"});
}

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

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

Script call internal-external.png

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

Commands & Feedbacks

Команды и каналы обратной связи нужно привязать к графическим элементам для управления оборудованием:

  • Команда привязывается к графическому элементу.
  • Канал обратной связи привязывается к графическому элементу, чтобы отобразить состояние переменной

Чтобы связать команду или канал с графическим элементом, используйте метод drag&drop - перетягивание.

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

SendValue.png

Настройка

Для настройки команды или фидбека необходимо установить значение полей канала или тега. Список полей меняется в зависимости от значения поля Command. В данный момент драйвер поддерживает следующие типы команд и тегов:

В зависимости от команды будут доступны следующие настройки:

  • Name - имя команды\фидбека;
  • Command - команда, с помощью которой идет обращение к нужному устройству;
  • Integration ID - адрес устройства (настраивается предварительно в конфигураторе Lutron designer );
  • Component - номер кнопки на панели управления(для кнопочных панелей);
  • Value - значение необходимого мода для устройства.

Lutron_sets.png

DEVICE

Позволяет управлять входами устройства, такими как кнопки и сухие контакты

  • IntegrationID - ID канала
  • Component - Номер компонента

Action

ТипОписаниеValue
EnabledАктивировать-
DisableДеактивировать-
Press/Close/OccupiedНажатие/Закрыть/Замкнут-
Release/Open/UnoccupiedОтпускание/Открыть/Разомкнут-
HoldУдержание-
Multi-tapМультинажатие-
Set/Get Current SceneУстановить/Получить текущую сценуНомер сцены
Set/Get LED StateУстановить/Получить состояние LED индикатора кнопки кейпадаOn
Off
Normal Flash
Rapid Flash
Set/Get Light LevelУстановить/Получить уровень яркостиЗначение уровня яркости
Set/Get Zone LockУстановить/Получить блокировку зоны (не поддерживается Homeworks QS)On
Off
Set/Get Scene LockУстановить/Получить блокировку сцены (не поддерживается Homeworks QS)On
Off
Set/Get Sequence StateУстановить/Получить состояние последовательностиOff
Scenes 1-4
Scenes 5-16
Start RaisingНачать увеличение-
Start loweringНачать уменьшение-
Stop Raising/LoweringОстановить увеличение/уменьшение-
Get battery statusПолучить состояние батареи-
Set a custom lift and tilt levelУстановить уровень открытия жалюзи и поворота ламелей0-100
Set a custom lift level onlyУстановить уровень открытия шторы0-100
Set a custom tilt level onlyУстановить уровень поворота ламелей0-100
Hold/ReleaseУдержание/Отпускание-
GRAFIK Eye QS Timeclock stateВключить/выключить Timeclock stateEnabled/Disabled
Query CCI stateЗапрос CCI статуса-
Set/Get activate LED levelУстановить/Получить уровень подсветки кнопок кейпада в активном состоянии0-100
Set/Get inactivate LED levelУстановить/Получить уровень подсветки кнопок кейпада в неактивном состоянии0-100
Get Temperature CПолучить значение температуры в Цельсиях-
Get Temperature FПолучить значение температуры в Фаренгейтах-

OUTPUT

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

  • IntegrationID - ID канала

Action

ТипОписаниеValue
Set/Get Venetian lift and tilt levelУстановить/Получить уровень подъема и наклона жалюзи0-100
Set/Get light levelУстановить/Получить уровень яркости0-100
Start RaisingНачать увеличение-
Start loweringНачать уменьшение-
Stop Raising/LoweringОстановить увеличение/уменьшение-
Start FlashПодать серию импульсовВремя работы вспышки (в секундах)
PulseПодать одиночный импульс на диммерВремя пульсации (в секундах)
Set/Get Venetian tilt level onlyУстановить/Получить уровень поворота ламелей жалюзи0-100
Start raising venetian tiltНачать поворот ламелей вверх-
Start lowering venetian tiltНачать поворот ламелей вниз-
Stop venetian tiltОстановить поворот ламелей-
Start raising venetian liftНачать подъем жалюзи-
Start lowering venetian liftНачать опускание жалюзи-
Stop venetian liftОстановить жалюзи-
Set DMX color/level settingsЗадать цвет/уровень яркости DMX0-255 / 0-100
Motor Jog raiseПоднять штору 220В AC-
Motor Jog lowerОпустить штору 220В AC-
Motor 4-stage jog raiseУвеличить мощность 4-ступенчатого мотора-
Motor 4-stage jog lowerУменьшить мощность 4-ступенчатого мотора-

SHADEGRP

Позволяет управлять шторами

  • IntegrationID - ID канала

Action

ТипОписаниеValue
Set shade group levelЗадать уровень открытия штор0-100
Start RaisingНачать открытие-
Start LoweringНачать закрытие-
Stop Raising/LoweringОстановить открытие/закрытие-
Set/Get Current PresetУстановить текущий пресет0-30

HVAC

Позволяет управлять HVAC оборудованием

  • IntegrationID - ID канала

Action

ТипОписаниеValue
Set/Get Single Setpoints (°C)Установить/Получить одно значение отдельной уставкиПараметр Use Fixed Drift
При True — жесткие рамки дрифтов
При False — только температура
Формат: #HVAC,9,19,55.00,0.00,7.00
9 — идентификатор зоны
19 — номер действия
5.5 — целевая температура (0–100 °C)
0.0 — отклонение вниз (0–8 °C)
0.0 — отклонение вверх (0–8 °C)
Get Current TemperatureПолучить значение температуры в Фаренгейтах (только для американского рынка)32-212°F
Set/Get Heat and CoolУстановить значение температуры охлаждения или нагревания в Фаренгейтах (только для американского рынка)32-212°F
Set/Get operation modeУстановить режим работы1=off
2=heat
3=cool
4=auto
5=em. heat
7=fan
8=dry
Set/Get fan modeУстановить скорость вентилятора1=auto
2=on
3=cycler
4=no fan
5=high
6=medium
7=low
8=top
Set/Get Eco modeУстановить Eco режим1=off
2=on
Get Eco offsetЗадать Eco уставку1-11°F
Set Schedule statusЗадать статус расписанияSchedule unavailable — расписание недоступно
Following schedule — следовать расписанию
Permanent hold — переключение в ручной режим
Temporary Hold — переключение в ручной режим до следующего события в расписании
Get Temperature sensor connection statusПолучить статус подключения температурных датчиков (не поддерживается термостатами для европейского рынка)1=Все сенсоры активны
2=Сенсор не найден
3=Только беспроводные сенсоры
4=нет сенсоров
Get Schedule EventПолучить событие расписания"№ расписания, № события, HH, MM, SPH(setpoint heat), SPC(setpoint cool)"
Get Schedule Day assignmentПолучить дни, когда термостат будет работать по расписанию"Schedule#(1–7), DD(Bitmap:Sunday(Bit 0)–Saturday(Bit 6) 1–active day, 0–inactive day)"
Get system modeПолучить системный режим1=Normal
2=Away
3=Green
Get Heat and Cool setpointsПолучить значение охлаждения и отопленияSPH=32–212 °F
SPC=32–212 °F
Get emergency heat availableПолучить состояние аварийного отопления1=Not Available
2=Available
Get call statusПолучить статус вызова0=None, Last was Heat
1=Heat Stage 1
2=Heat Stage 1 and 2
3=Heat Stage 1, 2, and 3
4=Heat Stage 3
5=None, Last was Cool
6=Cool Stage 1
7=Cool Stage 1 and 2
8=Off
9=Emergency Heat
10=Dry
Get current temperatureПолучить текущую температуру1-100 °C
Set/Get heat and cool setpoint(C)Установить/Получить уставку по температуреSPH=0–100 °C
SPC=0–100 °C
Set Current Temperature (°C)Установить значение температуры в градусах Цельсия0-100

AREA

Позволяет управлять зонами

  • IntegrationID - ID канала

Action

ТипОписаниеValue
Set Area levelУстановить уровень включения света для помещенияLevel 1=0–100
Fade 2 in: SS.ss, SS, MM:SS
Delay 2 in: SS.ss, SS, MM:SS
Start RaisingНачать увеличение-
Start LoweringНачать уменьшение-
Stop Raising/LoweringОстановить увеличение/уменьшение-
Set/Get current sceneЗадать текущую сцену0-32 (Scene Number)
Set/Get daylighting modeЗадать/Получить состояние датчика освещенности1=Active
2=Inactive
Get Occupancy StateПолучить состояние датчика присутствия1=Unknown
2=Inactive
3=Occupied
4=Unoccupied
Get Occupancy ModeПолучить режим работы датчика присутствия1=Occupancy and Vacancy
2=Vacancy
3=Not Applicable
4=Inactive
Set/Get Occupied level or sceneЗадать/Получить уровень включения по датчику или номер сцены для занятого помещенияLevel =0–100
Scene Number =0–32
Set/Get UnOccupied level or sceneЗадать/Получить уровень включения по датчику или номер сцены для свободного помещенияLevel =0–100
Scene Number =0–32
Set Hyperion Shadow Sensor Override StateЗадать состояние переопределения датчика тени Hyperion0=Disable
1=Enable
2=Mixed (Get Only)
Set Hyperion Brightness Sensor Override StateЗадать яркость переопределения датчика тени Hyperion0=Disable
1=Enable
2=Mixed (Get Only)