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

---

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:

download the 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 (for access to 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 the Lutron tab in the DEVICE BASE. Drag'n'drop Lutron to PROJECT DEVICE PANEL

Enter 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 - Controller IP-address
• 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 feedback drag'n'drop a feedback channel on a graphic item and select where to display 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 - Number of component
  

Action

Type	Description	Value
Enabled	Activate
Disable	Deactivate
Press/Close/Occupied	Press/Close/Occupied
Release/Open/Unoccupied	Release/Open/Unoccupied
Hold	Hold
Multi-tap	Multipress
Set\Get Current Scene	Set/Get the current scene	Number of scene
Set\Get LED State	Set/Get the state of LED indicator of the keypad button	On, Off, Normal Flash, Rapid Flash
Set\Get Light Level	Set/Get brightness level	Value of brightness level
Set\Get Zone Lock	Set\Get zone blocking (not supported by Homeworks QS)	On, Off
Set\Get Scene Lock	Set\Get scene blocking (not supported by Homeworks QS)	On, Off
Set\Get Sequence State	Set\Get the state of sequence	Off, Scenes 1-4, Scenes 5-16
Start Raising	Start raising
Start lowering	Start descreasing
Stop Raising/Lowering	Stop raising/descreasing
Get battery status	Get battery state
Set a custom lift and tilt level	Set the level of opening blinds and lamellas rotation	0-100
Set a custom lift level only	Set the level of opening blinds	0-100
Set a custom tilt level only	Set the level of lamellas rotation	0-100
Hold\Release	Hold\drop
GRAFIK Eye QS Timeclock state	Turn on\off Timeclock state	Enabled\Disabled
Query CCI state	Request of CCI status
Set\Get activate LED level	Set/Get the lighting level of keypad buttons in the active state	0-100
Set\Get inactivate LED level	Set/Get lighting level of keypad buttons in the inactive state	0-100
Get Temperature C	Get temperature in Celsius.
Get Temperature F	Get temperature in Fahrenheit.

OUTPUT

Allows to control outputs such as dimmers and dry contacts outputs

• IntegrationID - Channel ID
  

Action

Type	Description	Value
Set/Get Venetian lift and tilt level	Set/Get the level of raising and tilting blinds	0-100
Set\Get light level	Get/Set brightness level	0-100
Start Raising	Start raising
Start lowering	Start descreasing
Stop Raising/Lowering	Stop raising/descreasing
Start Flash	Send pulse train	Time of flash work (in seconds)
Pulse	Send a single impulse to the dimmer	Time of pulsation (in seconds)
Set\Get Venetian tilt level only	Set/Get the level of lamellas rotation	0-100
Start raising venetian tilt	Start lamellas rotation up
Start lowering venetian tilt	Start lamellas rotation down
Stop venetian tilt	Stop lamella rotation
Start raising venetian lift	Start raising blinds
Start lowering venetian lift	Start lowering blinds
Stop venetian lift	Stop blinds
Set DMX color\level settings	Set color\brightness level of DMX1	0-255\0-100
Motor Jog raise	Raise 220B AC blind
Motor Jog lower	Lower 220B AC blind
Motor 4-stage jog raise	Increase the power of 4-step motor
Motor 4-stage jog lower	Decrease the power of 4-step motor

SHADEGRP

Enables control of shades

• IntegrationID - Channel ID
  

Action

Type	Description	Value
Set shade group level	Set the level of opening blinds	0-100
Start Raising	Start opening
Start Lowering	Start closing
Stop Raising/Lowering	Stop opening\closing
Set\Get Current Preset	Set the current preset	0-30

HVAC

Allows to control HVAC equipment

• IntegrationID - Channel ID
  

Action

Type	Description	Value
Set/Get Single Setpoints (°C)	Set/Get one value of a separate setpoint	0-100
Get Current Temperature	Set temperature value in Fahrenheit (only for the American market)	32-212F
Set\Get Heat and Cool	Set value of cooling or heating temperature in Fahrenheit (only for the American market)	32-212F
Set\Get operationg mode	Set the mode of work	1=off,2=heat,3=cool,4=auto,5=em. heat,7=fan,8=dry
Set\Get fan mode	Set fan speed	1=auto,2=on,3=cycler,4=no fan,5=high,6=medium,7=low,8=top
Set\Get Eco mode	Set Eco mode	1=off, 2=on
Get Eco offset	Set Eco offset	1-11F
Set Schedule status	Set schedule status	Schedule unavailable - schedule is unavailable Following schedule - keep the schedule Parmanent hold - Switching to manual mode Temporary Hold - Switching to manual mode until the next event of schedule starts
Get Temperature sensor connection status	Get connection status of temperature sensors (the function is not supported by thermostats for the European market)	1=All sensors are active 2=A sensor is not found 3=Only wireless sensors 4=no sensors
Get Schedule Event	Get schedule event	"schedule №, event №, HH, MM, SPH(setpoint heat), SPC(setpoint cool)"
Get Schedule Day assignment	Get days when the thermostat works on schedule	"Schedule#(1–7), DD(Bitmap:Sunday(Bit 0)–Saturday(Bit 6) 1–active day, 0–inactive day)"
Get system mode	Get the system mode	1=Normal 2=Away 3=Green
Get Heat and Cool setpoints	Get the value of cooling and heating	Setpoint Heat (SPH)=32–212 °F Setpoint Cool (SPC)=32–212 °F
Get emergency heat available	Get the state of emergency heating	1=Not Available 2=Available
Get call status	Get the request 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	Get the current temperature (°C)	1-100
Set\Get heat and cool setpoint(C)	Set/Get temperature setpoint (°C)	Setpoint Heat (SPH)=0–100 °C Setpoint Cool (SPC)=0–100 °C
Set Current Temperature (°C)	Set temperature value in Celcius	0-100

AREA

Allows to control zones

• IntegrationID - Channel ID
  

Action

Type	Description	Value
Set Area level	Set the lighting level for the room	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 raising
Start Lowering	Start descreasing
Stop Raising\Lowering	Stop raising/descreasing
Set\Get current scene	Set the current scene	0-32(Scene Number)
Set\Get daylighting mode	Set/Get the state of light sensor	1-Active 2-Inactive
Get Occupancy State	Get the state of the presence sensor	1=Unknown 2=Inactive 3=Occupied 4=Unoccupied
Get Occupancy Mode	Get the operation mode if the presence sensor	1=Occupancy and Vacancy 7 2=Vacancy 7 3=Not Applicable 8 4=Inactive
Set\Get Occupied level or scene	Set/Get the activation level by sensor or scene number for an occupied room	Level =0–100; Scene Number =0–32
Set\Get UnOccupied level or scene	Set/Get the activation level by sensor or scene number for a free room	Level =0–100; Scene Number =0–32
Set Hyperion Shadow Sensor Override State	Set override state of Hyperion Shadow Sensor	0=Disable 1=Enable 2=Mixed (Get Only)
Set Hyperion Brightness Sensor Override State	Set override brightness of Hyperion Shadow Sensor	0=Disable 1=Enable 2=Mixed (Get Only)