Материал из for iRidium developers
Перейти к: навигация, поиск
Эта страница является переводом страницы Lutron. Перевод выполнен на 100%.

Other languages:
English • ‎русский

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

download the examples:


iRidium for Lutron is a set of tools to create an interface to control Smart home or office on the basis of Lutron equipement. It realizes commands of Lutron protocol.


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


Adding the driver manually

If you can't import a device, add 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 driver. Drag and drop Lutron to PROJECT DEVICE PANEL


Adding Lutron driver

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

Connection settings

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

  • Host - Controller IP-address
  • Port - the port of connection to the controller
  • Login - Login to access the controller
  • Password -Access password to 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 buttonIcon Scripts.png (+) Add Script from file

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

function Internal_1() {
IR.GetDevice('BACnet').SetParameters({Host: "", Port: 5001, Login: "admin", Password: "admin"});
function External_1() {
IR.GetDevice('BACnet').SetParameters({Host: "", 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:

Script call internal-external.png

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

Commands & Feedbacks

Commands and feedback channels have to be assigned to graphic items to control equipment:

  • A command is assigned to a graphic item.
  • Feedback channel is assigned to a graphic item to display the variable state.

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

To send a command, drag it on a graphic item. To display feedback, drag the channel on the graphic item and indicate where to output the value (Value):



To set commands and feedbacks, set values in channel or tag fields. The list of fields is changed depending on the value of Command field. At the moment the driver supports the following types of commands and tags: DEVICE, OUTPUT, SHADEGRP, HVAC, AREA.


enables control of the device inputs such as buttons and dry contacts

  • IntegrationID - Channel ID
  • Component - Number of component


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 lamp state 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 On, Off
Set\Get Scene Lock Set\Get scene blocking On, Off
Set\Get Sequence State Set\Get scene 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 value
Set a custom lift and tilt level Set the individual level of rise and inclination 0-100
Set a custom lift level only Set the individual level of rise 0-100
Set a custom tilt level only Set the individual level of inclination 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 Get\set the value of active LED 0-100
Set\Get inactivate LED level Get\set the value of inactive LED 0-100


Enables control of outputs, such as dimmer outputs and dry contacts.

  • IntegrationID - Channel ID


type description Value
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 Turn on Flash Время работы вспышки(в секундах)
Pulse Turn on Rapid Flash Время пульсации(в секундах)
Set\Get Venetian tilt level only set the blind inclination 0-100
Start raising venetian tilt Start raising blind inclination
Start lowering venetian tilt Start descreasing blind inclincation
Stop venetian tilt Stop blind inclination
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 levele of DMX1 0-255\0-100
Motor Jog raise increase motor power
Motor Jog lower Decrease motor power
Motor 4-stage jog raise Increase power of 4-gear motor
Motor 4-stage jog lower Decrease power of 4-gear motor


enables control of shades

  • IntegrationID - Channel ID


type description Value
Set shade group level Set the level of shade opening 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


enables control of HVAC equipment

  • IntegrationID - Channel ID


type description Value
Get Current Temperature Set temperature value 32-212F
Set\Get Heat and Cool Set temperature value for cooling or heating 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 Get Eco offset 1-11F
Set Schedule status Set schedule status Schedule unavailable -no schedule
Following schedule - next schedule
Parmanent hold-Permanent hold
Temporary Hold-temporary hold
Get Temperature sensor connection statys Get the connection status of temperature sensors 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 the day of schedule activation "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
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
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
9=Emergency Heat
Get current temperature Get the current temperature (C) 1-100
Set\Get heat and cool setpoint(C) Get the current temperature (C) Setpoint Heat (SPH)=0–100 °C
Setpoint Cool (SPC)=0–100 °C


enables control of zones

  • IntegrationID - Channel ID


type description Value
Set Area level Set zone value 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 day mode 1-Active
Get Occupancy State Get the occupation state 1=Unknown
Get Occupancy Mode Get the occupation mode 1=Occupancy and Vacancy 7
2=Vacancy 7
3=Not Applicable 8
Set\Get Occupied level or scene Set occupied value or scene Level =0–100;
Scene Number =0–32
Set\Get UnOccupied level or scene Set occupied value or scene Level =0–100;
Scene Number =0–32
Set Hyperion Shadow Sensor Override State Set Hyperion Shadow Sensor Override State 0=Disable
2=Mixed (Get Only)
Set Hyperion Brightness Sensor Override State Set override brightness of Hyperion Shadow Sensor 0=Disable
2=Mixed (Get Only)