Материал из 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:


Description

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.


Connection

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


LutronConnection.png

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


Lutron add device.png

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.

Lutron params.png
  • 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: "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:

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):

SendValue.png


Setting

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.

DEVICE

enables control of the 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 the LED indicator of a 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 blind opening and lamella rotation 0-100
Set a custom lift level only Set the level of bling opening 0-100
Set a custom tilt level only Set the level of lamella 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 the lighting level of keypad buttons in the inactive state 0-100

OUTPUT

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

  • IntegrationID - Channel ID

Action

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 flashing Flash period (in sec)
Pulse Turn on Rapid Flash Pulse period (in sec)
Set\Get Venetian tilt level only Set\get the level of lamella rotation 0-100
Start raising venetian tilt Start lamella rotation up
Start lowering venetian tilt Start lamella 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 levele of DMX1 0-255\0-100
Motor Jog raise Lift 220 V AC blind
Motor Jog lower Drop 220 V AC blind
Motor 4-stage jog raise Increase power of 4-gear motor
Motor 4-stage jog lower Decrease power of 4-gear motor

SHADEGRP

Enables control of shades

  • IntegrationID - Channel ID

Action

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

HVAC

enables control of HVAC equipment

  • IntegrationID - Channel ID

Action

type description Value
Get Current Temperature Set the temperature value in Fahrenheit (only for American market) 32-212F
Set\Get Heat and Cool Set the temperature value for cooling or heating in Fahrenheit (only for 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 Get 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 till the next event in the schedule
Get Temperature sensor connection status Get the connection status of temperature sensors (the fucntion is not supported by thermostats for 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 what the thermostat works by 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(°С) 1-100
Set\Get heat and cool setpoint(C) Set\Get the required temperature (°С) Setpoint Heat (SPH)=0–100 °C
Setpoint Cool (SPC)=0–100 °C

AREA

enables control of zones

  • IntegrationID - Channel ID

Action

type description Value
Set Area level Set the illumination 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 level of the light sensor 1-Active
2-Inactive
Get Occupancy State Get the state of the presence detector 1=Unknown
2=Inactive
3=Occupied
4=Unoccupied
Get Occupancy Mode Get the mode of work of the presence detector 1=Occupancy and Vacancy 7
2=Vacancy 7
3=Not Applicable 8
4=Inactive
Set\Get Occupied level or scene Set\Get the illumination level to turn on by a sensor or the number of a scene for an occupied room Level =0–100;
Scene Number =0–32
Set\Get UnOccupied level or scene Set\Get the illumination level to turn on by a sensor or the number of a scene for an unoccupied room Level =0–100;
Scene Number =0–32
Set Hyperion Shadow Sensor Override State Set Hyperion Shadow Sensor Override State 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)