This page is a
translated version of the page
Lutron and the translation is 100% complete.
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:
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.
Tested equipment:
- HQP7-2 - Homeworks QSX Proccesor;
- LQSE-4A5-230-D - DIN Rail Power Module Adaptive 4 Output
- LQSE-2DALUNV-D - DIN Rail Panel Module Universal DALI
- SMC55-RESI-2 - Palladiom HVAC Controller
- HQWT-T-HW-BL-A - Palladiom HVAC Thermostat
- QSSC-EDU-10 - Sivoia QS roller 64 Electronic Drive Unit
Connection
Control panels (iOS, Android, Windows, Mac) can control Lutron equipment only via Homeworks QS processor.
- Pre-configure the processor using the Lutron Designer program (to access the program functionality, please, contact the manufacturer).
- Select necessary devices in the configurator and activate them (during this process each device will be assigned an individual ID).
- Save the project and send the configuration to the processor.
Work in iRidium
Create a new project and add Lutron driver to it with the help of a scanner or enter data manually.
Scanning devices
iRidium Studio scans Lutron equipment, finds devices and adds them to iRidium project with preconfigured commands and feedback channels.
1 Open the Devices panel and click Scan > Lutron Scanner:
2 Enter the IP-address of Homeworks QSX Proccesor, and your login and password to Lutron Designer:
3 Add required devices to the project:
If the scanner can't find equipment, you can enter the driver settings manually:
Adding Driver Manually
Add Lutron driver to your project from iRidium database
1 Open the Devices panel in the created project and add Lutron driver to it with the help of Add driver:
2 Click the left mouse button on the added Lutron driver and add required devices (Add subdevice). All devices are devided into folders according to their type.
3 Enter connection parameters in the settings of the driver, devices, commands and feedback channels.
Setting Connection Parameters
Driver connection settings:
- Protocol - TCP;
- Log Level - logging level of the driver;
- Host - IP-address of Homeworks QSX Proccesor;
- Port - connection port (by default it is 80);
- Login - user name (entered in a project in Lutron Designer);
- Password - user password (entered in a project in Lutron Designer);
- SSL - type of encrypting (Disable, TLS v1.2, SSL v2.3, SSL v3.0);
- Keep Alive - interval to check TCP connection. In case there is no answer to Keep Alive request, the driver will be forced into the off state. The parameter is meant for correct display of the on-line status if the client is turned off urgently or incorrectly. 0 - disables the setting;
- Driver Version - version of the driver.
Device connection settings:
- Name - name of device;
- Driver Type - type of driver (Lutron);
- Device Type - type of device:
- Area - contains scenes in the area;
- Zone - contans commands to control a device in a zone;
- LED - light diodes, have their own control commands, can't be inside zones;
- Zone Type - type of zone (only for Device Type - Zone):
- Dimmed - zone with dimmable devices;
- Switched - zone with relays;
- Spectrum Tune - zone with dimmable RGBA light;
- White Tune - zone with DALI;
- Shade - zone with roller shades;
- Shade With Tilt - zone with tilting shades;
- Shade With Tilt When Closed - zone with closed tilting shades;
- CCO - zone with PowPak CCO Module (low-voltage radio station);
- Fan Speed - zone with fan / intake ventilation;
- Open Close Stop - zone with commands to open / close / stop (garage door);
- Receptacle - zone with a sensor of liquid level;
- Single SetPoint HVAC - thermostat with 1 set temperature;
- Dual SetPoint HVAC - thermostat with 2 set temperatures;
- ID - ID of controlled device / scene (only for Device Type - Area / LED).
Commands and Feedback channels of devices do not have unique parameters.
Only Device Type - Area has an additional parameter - ID, a scene ID.
Types of all commands and feedback channels are descrived below.
Setting Commands and Feedback Channels
To control equipment it is required to set Commands and Feedbacks. To send a command, drag'n'drop it on a graphic item and enter a value to send. To display feedback drag'n'drop a feedback channel on a graphic item and choose how to output or display a value.
Read more about work with graphic items in the
"Types of graphic items" article.
Zone Dimmed
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Dimmed Level |
Command |
0 - 100% |
Dimming
|
| Raise |
Command |
Any value |
Increase brightess to the max value
|
| Lower |
Command |
Any value |
Desrease brightness to the min level
|
| Stop |
Command |
Any value |
Stop dimming
|
| Dimmed Level |
Feedback |
0 - 100% |
Stop dimming
|
Zone Switched
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Switched Level |
Command |
0 - 1 |
Enter level till overflow
|
| Switched Level |
Feedback |
0 - 1 |
Sensor of liquid level
|
Zone Spectrum Tune
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Spectrum Tuning Level (RGBA) |
Command |
255.255.255.255 |
Enter RGBA lighting
|
| Raise |
Command |
Any value |
Increase brightess to the max value
|
| Lower |
Command |
Any value |
Desrease brightness to the min level
|
| Stop |
Command |
Any value |
Stop dimming
|
| Spectrum Tuning Level (RGBA) |
Feedback |
255.255.255.255 |
State of RGBA lighting
|
Zone White Tune
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| White Tuning Level |
Command |
0 - 100% |
Change level of brightness (DALI)
|
| White Tuning Kelvin |
Command |
1000 - 7000 |
Change light temperature (DALI)
|
| White Tuning Level |
Feedback |
0 - 100% |
Brightness level (DALI)
|
| White Tuning Kelvin |
Feedback |
1000 - 7000 |
Light temperature (DALI)
|
Zone Shade
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Shade Level |
Command |
0 - 100% |
Change shade level
|
| Raise |
Command |
Any value |
Open shade
|
| Lower |
Command |
Any value |
Close shade
|
| Stop |
Command |
Any value |
Stop shade
|
| Shade Level |
Feedback |
0 - 100% |
Shade level
|
Zone Shade With Tilt
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Shade Level |
Command |
0 - 100% |
Change shade opening level
|
| Shade Tilt |
Command |
0 - 100% |
Change shade tilting level
|
| Raise |
Command |
Any value |
Open shade
|
| Raise Lift |
Command |
Any value |
Raise shade
|
| Raise Tilt |
Command |
Any value |
Increase shade tilt level to the max value
|
| Lower |
Command |
Any value |
Close shade
|
| Lower Lift |
Command |
Any value |
Drop shade
|
| Lower Tilt |
Command |
Any value |
Decrease shade tilt level to the min value
|
| Stop |
Command |
Any value |
Stop shade
|
| Stop Lift |
Command |
Any level |
Stop raising / dropping shade
|
| Stop Tilt |
Command |
Any value |
Stop tilting shade
|
| Shade Level |
Feedback |
0 - 100% |
Level of shade opening
|
| Shade Tilt |
Feedback |
0 - 100% |
Level of shade tilting
|
Zone Shade With Tilt When Closed
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Shade Level |
Command |
0 - 100% |
Change shade opening level
|
| Shade Tilt |
Command |
0 - 100% |
Change shade tilting level
|
| Raise |
Command |
Any value |
Open shade
|
| Raise Lift |
Command |
Any value |
Raise shade
|
| Raise Tilt |
Command |
Any value |
Increase shade tilt level to the max value
|
| Lower |
Command |
Any value |
Close shade
|
| Lower Lift |
Command |
Any value |
Drop shade
|
| Lower Tilt |
Command |
Any value |
Decrease shade tilt level to the min value
|
| Stop |
Command |
Any value |
Stop shade
|
| Stop Lift |
Command |
Any level |
Stop raising / dropping shade
|
| Stop Tilt |
Command |
Any value |
Stop tilting shade
|
| Shade Level |
Feedback |
0 - 100% |
Level of shade opening
|
| Shade Tilt |
Feedback |
0 - 100% |
Level of shade tilting
|
Zone CCO
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| CCO Level |
Command |
0 - 100% |
Set the level of liquid sensor
|
| CCO Level |
Feedback |
0 - 100% |
Current value of liquid sensor
|
Zone Fan Speed
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Fan Speed |
Command |
OFF - 1,
LOW - 2,
MEDIUM - 3,
MEDIUM_HIGH - 4,
HIGH - 5 |
Airing mode:
1 - off,
2 - low,
3 - medium,
4 - medium high,
5 - max.
|
| Fan Speed |
Feedback |
OFF - 1,
LOW - 2,
MEDIUM - 3,
MEDIUM_HIGH - 4,
HIGH - 5 |
Airing mode:
1 - off,
2 - low,
3 - medium,
4 - medium,
5 - max.
|
Zone Open Close Stop
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Raise |
Command |
Any value |
Open to the max value
|
| Lower |
Command |
Any value |
Close to the min level
|
| Stop |
Command |
Any value |
Stop opening / closing
|
Zone Receptacle
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Receptacle Level |
Command |
0 - Off / 1 - On |
Turn on / off liquid level sensor
|
| Receptacle Level |
Feedback |
0 - Off / 1 - On |
Turn on / off liquid level sensor
|
Zone Single SetPoint HVAC
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| SetPoint (C) |
Command |
10 - 32 (depends on target device) |
Set temperature in degrees Celsius
|
| SetPoint (F) |
Command |
50 - 90 (depends on target device) |
Set temperature in degrees Farhenheit
|
| Custom Operating Mode |
Command |
OFF - 1,
HEAT - 2,
COOL - 3,
AUTO - 4,
EMERGENCY_HEAT - 5,
FAN - 6,
DRY - 7,
UNKNOWN - 8
(depends on target device) |
Set value for Operating Mode.
|
| Custom Fan Mode |
Command |
AUTO - 1,
ON - 2,
CYCLE - 3,
NO_FAN - 4,
HIGH - 5,
MEDIUM - 6,
LOW - 7,
TOP - 8,
UNKNOWN - 9
(depends on target device) |
Set value for Fan Mode.
|
| Operating Mode Off |
Command |
Any value |
Set Off in Operating Mode
|
| Operating Mode Heat |
Command |
Any value |
Set Heat in Operating Mode
|
| Operating Mode Cool |
Command |
Any value |
Set Cool in Operating Mode
|
| Operating Mode Auto |
Command |
Any value |
Set Auto in Operating Mode
|
| Operating Mode Emergency Heat |
Command |
Any value |
Set Emergency Heat in Operating Mode
|
| Operating Mode Fan |
Command |
Any value |
Set Fan in Operating Mode
|
| Operating Mode Dry |
Command |
Any value |
Set Dry in Operating Mode
|
| Fan Mode Auto |
Command |
Any value |
Set Auto in Fan Mode
|
| Fan Mode On |
Command |
Any value |
Set On in Fan Mode
|
| Fan Mode Cycle |
Command |
Any value |
Set Cycle in Fan Mode
|
| Fan Mode No Fan |
Command |
Any value |
Set No Fan in Fan Mode
|
| Fan Mode High |
Command |
Any value |
Set High in Fan Mode
|
| Fan Mode Medium |
Command |
Any value |
Set Medium in Fan Mode
|
| Fan Mode Low |
Command |
Any value |
Set Low in Fan Mode
|
| Fan Mode Top |
Command |
Any value |
Set Top in Fan Mode
|
| Current Temperature (F) |
Feedback |
-22 ~ 122
(depends on target device) |
Current temperature in degrees Fahrenheit
|
| Current Temperature (C) |
Feedback |
-30 ~ 50
(depends on target device) |
Current temperature in degrees Celsius
|
| SetPoint Status (F) |
Feedback |
18 ~ 32
(depends on target device) |
Value of set temperature in degrees Farhenheit
|
| SetPoint Status (C) |
Feedback |
0 ~ 90
(depends on target device) |
Value of set temperature in degrees Celsius
|
| Operating Mode |
Feedback |
OFF - 1,
HEAT - 2,
COOL - 3,
AUTO - 4,
EMERGENCY_HEAT - 5,
FAN - 6,
DRY - 7,
UNKNOWN - 8
(depends on target device) |
Current work mode.
|
| Fan Mode |
Feedback |
AUTO - 1,
ON - 2,
CYCLE - 3,
NO_FAN - 4,
HIGH - 5,
MEDIUM - 6,
LOW - 7,
TOP - 8,
UNKNOWN - 9
(depends on target device) |
Current work mode of air conditioner
|
| Fan Status |
Feedback |
UNKNOWN - 1,
HIGH - 2,
MEDIUM - 3,
LOW - 4,
OFF - 5
(depends on target devcie) |
Current state of air conditioner
|
Zone Dual SetPoint HVAC
| Name of a command or a feedback channel |
Type |
Admissible values |
Description
|
| Custom Operating Mode |
Command |
OFF - 1,
HEAT - 2,
COOL - 3,
AUTO - 4,
EMERGENCY_HEAT - 5,
FAN - 6,
DRY - 7,
UNKNOWN - 8
(depends on target device) |
Set value for Operating Mode.
|
| Custom Fan Mode |
Command |
AUTO - 1,
ON - 2,
CYCLE - 3,
NO_FAN - 4,
HIGH - 5,
MEDIUM - 6,
LOW - 7,
TOP - 8,
UNKNOWN - 9
(depends on target devcie) |
Set value for Fan Mode.
|
| Operating Mode Off |
Command |
Any value |
Set Off in Operating Mode
|
| Operating Mode Heat |
Command |
Any value |
Set Heat in Operating Mode
|
| Operating Mode Cool |
Command |
Any value |
Set Cool in Operating Mode
|
| Operating Mode Auto |
Command |
Any value |
Set Auto in Operating Mode
|
| Operating Mode Emergency Heat |
Command |
Any value |
Set Emergency Heat in Operating Mode
|
| Operating Mode Fan |
Command |
Any value |
Set Fan in Operating Mode
|
| Operating Mode Dry |
Command |
Any value |
Set Dry in Operating Mode
|
| Fan Mode Auto |
Command |
Any value |
Set Auto in Fan Mode
|
| Fan Mode On |
Command |
Any value |
Set On in Fan Mode
|
| Fan Mode Cycle |
Command |
Any value |
Set Cycle in Fan Mode
|
| Fan Mode No Fan |
Command |
Any value |
Set No Fan in Fan Mode
|
| Fan Mode High |
Command |
Any value |
Set High in Fan Mode
|
| Fan Mode Medium |
Command |
Any value |
Set Medium in Fan Mode
|
| Fan Mode Low |
Command |
Any value |
Set Low in Fan Mode
|
| Fan Mode Top |
Command |
Any value |
Set Top in Fan Mode
|
| Heating SetPoint (F) |
Feedback |
50 ~ 80
(depends on target device) |
Set temperature for heating in degrees Fahrenheit
|
| Heating SetPoint (C) |
Feedback |
10 ~ 26
(depends on target device) |
Set temperature for heating in degrees Celsius
|
| Cooling SetPoint (F) |
Feedback |
80 ~ 90
(depends on target devcie) |
Set temperature for cooling in degrees Farhenheit
|
| Cooling SetPoint (C) |
Feedback |
50 ~ 80
(depends on target device) |
Set temperature for heating in degrees Celsius
|
| Current Temperature (F) |
Feedback |
-22 ~ 122
(depends on target device) |
Current temperature in degrees Fahrenheit
|
| Current Temperature (C) |
Feedback |
-30 ~ 50
(depends on target device) |
Current temperature in degrees Celsius
|
| Heating SetPoint Status (F) |
Feedback |
50 ~ 80
(depends on target device) |
Set temperature for heating in degrees Fahrenheit
|
| Heating SetPoint Status (C) |
Feedback |
10 ~ 26
(depends on target device) |
Set temperature for heating in degrees Celsius
|
| Cooling SetPoint Status (F) |
Feedback |
80 ~ 90
(depends on target devcie) |
Set temperature for cooling in degrees Farhenheit
|
| Cooling SetPoint Status (C) |
Feedback |
28 ~ 32
(depends on target device) |
Set temperature for cooling in degrees Celsius
|
| Operating Mode |
Feedback |
OFF - 1,
HEAT - 2,
COOL - 3,
AUTO - 4,
EMERGENCY_HEAT - 5,
FAN - 6,
DRY - 7,
UNKNOWN - 8
(depends on target device) |
Current work mode
|
| Fan Mode |
Feedback |
AUTO - 1,
ON - 2,
CYCLE - 3,
NO_FAN - 4,
HIGH - 5,
MEDIUM - 6,
LOW - 7,
TOP - 8,
UNKNOWN - 9
(depends on target device) |
Current work mode of air conditioner
|
| Fan Status |
Feedback |
UNKNOWN - 1,
HIGH - 2,
MEDIUM - 3,
LOW - 4,
OFF - 5
(depends on target device) |
Current state of air conditioner
|
