Эта страница является переводом страницы Lutron Homeworks QS. Перевод выполнен на 100%.

---

iRidium for Lutron

a set of tools to create control interfaces for Lutron equipment.

The driver is meant to control Lutron equipment. To understand the driver, use a project example below:

Example::

• iRidium Lutron

iRidium for Lutron is a set of tools to create an interface to control smart home or office based on Lutron equipment. It realizes commands of Lutron protocol.

Connection

Control panels (iOS, Android, Windows, Mac) can control Lutron equipment only via Homeworks QS processor.

1. Pre-configure the processor using the Lutron Designer program (to access the program functionality, please, contact the manufacturer).
2. Select necessary devices in the configurator and activate them (during this process each device will be assigned an individual ID).
3. Save the project and send the configuration to the processor.

When configuring button panels indicate the "Led Logic" parameter as "Via Integration". Only under this condition, the panels will correctly process the request from iRidium.

For thermostat panels! The developer's protocol does not describe commands that would allow emulating button presses on the thermostat panel.

Adding Driver Manually

If you can't import the device, add the Lutron driver to the project from iRidium database:

1. Launch iRidium Studio and create a new iRidium project.
2. Open DEVICE BASE side panel and find Lutron. Drag and drop Lutron driver to PROJECT DEVICE PANEL.

Indicate the controller address in iRidium project otherwise it will not work.

Setting connection parameters

When a driver is added to a project with the help of import or manually, indicate connection settings.

• Host - IP address of the controller
• Port - a port to connect to the controller
• Login - Login to access the controller
• Password -Password to access the controller

Change of connection settings

You need the possibility to change connection properties when you disconnect from the Wi-Fi network of the automation object and start using 3G or another Wi-Fi network. To maintain control of the object you need to switch from the local to public IP-address of the Internet router.

The switch is not automatic. You have to select the connection mode. For remote acces you have to make ports for controlling the automation system public. In order to do that you have o set up the Port Forwarding service on your Internet router. VPN can provide protected connection.

1 Download the template (*.js) (right-click button: "Save object as ..."), add the template in the script editor with the button (+) Add Script from file

2 Set up script properties as it is shown in the example:

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"});

}

Copy the driver name from Projeсt Device Panel - the list of properties has to be copied from the example.

3 Select the button which will be responsible for the switch of Internal and External properties. Open Macros Editor for the Press event (Object Properties > Programming), select the Script Call command and add it by double-clicking on it. Select the name of the function which will be activated by the button:

Now each pressing on the button will apply the corresponding connection properties.

Commands & Feedbacks

To control equipment it is required to set Commands and Feedbacks:

• The command is attached to the graphic item.
• The feedback channel is attached to the graphic item to display the status of a variable.

To assign commands or channels to graphic items use the drag&drop method.

To send a command, drag'n'drop it on a graphic item. To display a feedback value drag'n'drop a feedback channel on a graphic item and choose how to output a value.

Setting

To set commands and feedback channels set value in the channel or tag fields. The list of fields changes depending on the value of the Command field. At the moment the driver supports the following types of commands and tags:

• DEVICE;
• OUTPUT;
• SHADEGRP;
• HVAC;
• AREA.

Depending on the command, the following settings will be available:

• Name - name of a command/feedback channel;
• Command - a command that calls the required device;
• Integration ID - device address (preconfigured in the Lutron Designer configurator);
• Component - button number on the control panel (for button panels);
• Value - the value of the required mode for the device.

DEVICE

Allows to control device inputs such as buttons and dry contacts

• IntegrationID - Channel ID
  
• Component - Component number
  

Action

type	description	Value
Enabled	Activate
Disable	Deactivate
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 state	Enabled\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 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	Задать цвет\уровень яркости DMX1	0-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
Get Current Temperature	Установить значение температуры в фаренгейтах (только для американского рынка)	32-212F
Set\Get Heat and Cool	Установить значение температуры охлаждения или нагревания в фаренгейтах (только для американского рынка)	32-212F
Set\Get operationg 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-11F
Set Schedule status	Задать статус расписания	Schedule unavailable - расписание недоступно Following schedule - следовать расписанию Parmanent 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	Получить значение охлаждения и отопления	Setpoint Heat (SPH)=32–212 °F Setpoint Cool (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
Set\Get heat and cool setpoint(C)	Установить\Получить уставку по температуре(°С)	Setpoint Heat (SPH)=0–100 °C Setpoint Cool (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 3, SS, MM:SS Delay 2 in: SS.ss 3, 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 7 2=Vacancy 7 3=Not Applicable 8 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	Задать состояние переопределения датчика тени Hyperion	0=Disable 1=Enable 2=Mixed (Get Only)
Set Hyperion Brightness Sensor Override State	Задать яркость переопределения датчика тени Hyperion	0=Disable 1=Enable 2=Mixed (Get Only)