Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
###Introduction This article will explain how to integrate a DSC security system containing a DSC IT-100 or the newer Envisalink 3 automation interfaces into an OpenRemote 2.0 system.
The functionalities of the following products are supported by OpenRemote. Certified products are extensively tested in combination with Professional Designer and supported by OpenRemote certified Integrators.
###Configuration of System First, you will have to install OR controller. Have a look to the tutorials to install it on a NAS, computer, Raspberry or get an eBox!
Then you have to make it work with your DSC compatible interface.
####Configuring for DSC-IT100 Interface It is assumed that the serial-to-Ethernet gateway has been pre-configured and can accept a TCP/IP connection. Configuration of the gateway is beyond the scope of this document. No further configuration is required.
####Configuring for Envisalink Interface After verifying that your Envisalink interface is functioning correctly, you must configure the password that is used to connect to the TPI (Third Party Interface) of the Envisalink. This password is stored in
If you have changed the default password of "user" (highly recommended) for the Envisalink web interface, this password must be entered here.
###Creating devices/commands in the Designer Once you have configured the port settings and started your OR controller, you must create devices and commands to communicate with your receiver.
- Create a device by clicking on New/Device, then enter the details in the "New Device" box:
- Click Next then Add Command to add a new command. Note that you should choose IT100 as protocol, both for configuring IT100 as well as Envisalink 3.
There are two types of commands supported by this protocol- executable commands and sensor commands. Executable commands execute an action on the DSC security panel (i.e. Arm, Disarm). Sensor commands read state information from the security panel (i.e. Zone 1 open, Zone 2 closed, Partition 1 armed).
With the Envisalink interface, at least one Sensor must be created as this allows the connection to the panel to be authenticated. This requirement does not exist with the IT-100 as it does not require authentication.
*Code requirement dependent on alarm system programming
#####Example: ARM Command Here we will create a command in the designer to ARM the alarm:
With the Alarm device highlighted, select New/Command:
Enter the IP address of your DSC interface under IT-100 Address, The Command is ARM and the target will be the partition number that you wish to ARM. This command requires a valid User code to be entered under Security Code.
You can then add a button to your UI designer and link it to the command created above.
#####Example: PARTITION_STATE Sensor Here we will create a PARTITION_STATE Sensor. As with all sensors, we must first create a command. I called mine PARTITION_STATE as well although a more descriptive name could be used if you have multiple partitions. the PARTITION_STATE is always reported to OpenRemote using a Custom Sensor.
You will notice that Security Code is blank. This is fine for any command that doesn't change the ARM status of the alarm.
Then create a Custom Sensor (New/Sensor and select Type Custom)
The command should be the command created above. You can add all of the available PARTITION_STATES in the Custom state items although I did not find that necessary although If you wish to use other (custom) text then this is where you would add it.
The possible states are listed in the table below:
Once the sensor is created, I found it best to create a Label in the UI and link it to the newly created Sensor. This will then display the current state of the alarm.
#####Example: ZONE_STATE Sensor Each Zone can also be assigned to a sensor, this allows you to view the status of all alarm zones within your OpenRemote panel.
As always, first create a command for the Sensor:
The Target in this instance is the Zone number (not the Partition)
You should then create a Custom Sensor to link to this command:
The possible states for this sensor are listed in the table below and can be entered in the Custom state items section (this is required if you wish to use a seperate image to display each state)
Once created, you can "beautify" your panel with images as below:
Always check the OpenRemote Forum for the latest developments.