2N Helios IP Automation Instruction sheet

2N® Helios IP Automation
Configuration Manual
Version 2.5.0
Firmware 2.5 www.2n.cz

The 2N TELEKOMUNIKACE a.s. joint-stock company is a Czech manufacturer and supplier
of telecommunications equipment.
The product family developed by 2N TELEKOMUNIKACE a.s. includes GSM gateways,
private branch exchanges (PBX), and door and lift communicators.
2N TELEKOMUNIKACE a.s. has been ranked among the Czech top companies for years
and represented a symbol of stability and prosperity on the telecommunications market
for almost two decades. At present, we export our products into over 120 countries
worldwide and have exclusive distributors on all continents.
2N®is a registered trademark of 2N TELEKOMUNIKACE a.s.. Any product and/or other
names mentioned herein are registered trademarks and/or trademarks or brands
protected by law.
2N TELEKOMUNIKACE administers the FAQ database to help you quickly find information
and to answer your questions about 2N products and services. On faq.2n.cz you can find
information regarding products adjustment and instructions for optimum use and
procedures „What to do if...”.
Declaration of Conformity
2N TELEKOMUNIKACE a.s. hereby declares that the 2N®Helios product complies with all
basic requirements and other relevant provisions of the 1999/5/EC directive. For the full
wording of the Declaration of Conformity see the CD-ROM enclosed and at www.2n.cz.
The 2N TELEKOMUNIKACE company is a holder of the ISO 9001:2008 certificate. All
development, production and distribution processes of the company are managed by this
standard and guarantee a high quality and advanced technical level of and a professional
approach to all of our products.

Table of Contents
1. 2N®Helios IP Automation..................................................5
1.1 Terms and Symbols ....................................................................................................... 6
Symbols Used in Manual.................................................................................................. 6
1.2 2N®Helios IP Automation Configuration ..................................................................... 7
Block Parameter Settings................................................................................................. 8
Use of Variables............................................................................................................. 10
1.3 Events............................................................................................................................ 11
Event.KeyPressed.......................................................................................................... 12
Event.CodeEntered........................................................................................................ 13
Event.DtmfPressed ........................................................................................................ 14
Event.DtmfEntered......................................................................................................... 15
Event.CardEntered......................................................................................................... 16
Event.CallStateChanged................................................................................................ 17
Event.InputChanged....................................................................................................... 18
Event.Delay.................................................................................................................... 19
Event.Timer.................................................................................................................... 20
Event.HttpTrigger ........................................................................................................... 21
Event.MulticastTrigger.................................................................................................... 22
Event.AudioLoopTest..................................................................................................... 24
1.4 Actions .......................................................................................................................... 25
Action.ActivateSwitch..................................................................................................... 26
Action.SetOutput ............................................................................................................ 27
Action.BeginCall............................................................................................................. 28
Action.AnswerCall .......................................................................................................... 29
Action.EndCall................................................................................................................ 30
Action.SendHttpRequest................................................................................................ 31
Action.SendMulticastRequest ........................................................................................ 32
Action.PlayUserSound ................................................................................................... 34
Action.StartMulticastSend .............................................................................................. 35
Action.StopMulticastSend .............................................................................................. 36
Action.StartMulticastRecv .............................................................................................. 37
Action.StopMulticastRecv............................................................................................... 38
Action.SetCameraInput .................................................................................................. 39
1.5 Conditions..................................................................................................................... 40
Condition.ProfileState..................................................................................................... 41
Condition.CallState......................................................................................................... 42
Condition.InputState....................................................................................................... 43
Condition.LogicalAnd ..................................................................................................... 44
Condition.LogicalOr........................................................................................................ 44

Condition.LogicalNot ...................................................................................................... 45
Condition.True................................................................................................................ 45
Condition.False............................................................................................................... 45
Condition.FlipFlopD........................................................................................................ 46
Condition.FlipFlopRS ..................................................................................................... 47
1.6 Available Digital Inputs and Outputs.......................................................................... 48
1.7 Examples of Use........................................................................................................... 50

1
1. 2N®Helios IP
Automation
In this section, we describe the 2N®Helios IP Automation configuration.
Here is what you can find in this section:
Terms and Symbols
2N®Helios IP Automation Configuration
Description of Configurable Blocks

Terms and Symbols
1.1
1.1 Terms and Symbols
Symbols Used in Manual
Safety
Always abide by this information to prevent injury of persons.
Warning
Always abide by this information to prevent damage to the device.
Caution
Important information for system functionality.
Tip
Useful advice for quick and efficient functionality.
Note
Routines or advice for efficient use of the device.

2N® Helios IP Automation Configuration
1.2
1.2 2N®Helios IP Automation
Configuration
2N®Helios IP provides flexible setting options depending on the user’s requirements.
If the standard setting options (switch/call settings, e.g.) are insufficient for the
intended use, apply a special programmable interface - 2N®Helios IP Automation.
Typically, 2N®Helios IP Automation is helpful for applications that require rather
complex interconnection with the third parties’ systems.
Note
2N® Helios IP Automation works only with a valid Enhanced Integration
or Gold licence key.
Some 2N®Helios IP models are equipped with a number of digital inputs and outputs,
most of which can be configured like standard 2N®Helios IP switches (refer to the
Switches subsection). You can make use of all of these 2N®Helios IP Automation
inputs and outputs in variable combinations.
2N®Helios IP Automation helps you combine the Events arising in the system (such
as key pressing, RFID card use, digital input status change, etc.) with specific Actions
(such as digital output activation, user sound playing, call, etc.) as necessary.
Moreover, the execution of actions can be bound by selected Conditions (time profile
state, logic input state, e.g.).
The figure above shows a typical interconnection of the Event, Action and Condition
blocks. It holds true in general that an action is always tied with a selected event and
is executed when a selected condition is met. The condition is optional and if none is
selected, the action is executed whenever the assigned event occurs. 2N®Helios IP
Automation defines a number of events, actions and conditions to be further set. Refer
to the subsections below for the full list.
The example shown in the figure above can be interpreted as follows: The SetOutput
action (digital output setting) is executed if the InputChanged event (logic input1
change from log.0 to log. 1) arises and the Profile (active profile 1) condition is met.
InputChanged
Input=Input1
Event
SetOutput
Output=Relay1
Action
Profile
Profile=1
Condition

2N® Helios IP Automation Configuration
1.2
The 2N®Helios IP web interface helps you configure block combinations (Automation)
easily. The configuration shown in the figure below corresponds to the example above.
2N®Helios IP allows up to 12 blocks to be created and interconnected (regardless of
the block type - events, actions and conditions). Multiple actions can be assigned to an
event or condition. Thus, you can create 6 actions and assign them to 6 events, or
create 11 actions and assign them to 1 event, for example.
Block Parameter Settings
Select the required Event (Event.xxx), Action (Action.xxx) or Condition
(Condition.xxx) in the Block type column. Set one or more parameters for the blocks
in the respective row of the Parameters column - refer to the block describing
subsections below for the supported parameters. Separate the parameters with a
colon if more parameters are required.
The changes will not be executed until you press the Save button in the right-hand
bottom corner of the page.
If you have set a parameter correctly, a green mark will appear at the end of the
respective block definition row. If not (if you enter a wrong parameter name/value or
fail to complete an obligatory block parameter), a red mark will appear at the end of
the row. Move your mouse cursor to the red mark to display the Help to find the error.
If all the required blocks have been configured correctly (there is a green mark on
every row), 2N®Helios IP Automation will be enabled. If there is a red mark, the 2N®
Helios IP Automation function will be disabled.

2N® Helios IP Automation Configuration
1.2
Most of the blocks include parameters (Event, Condition, StartEvent, e.g.) that refer to
other blocks. Set these parameters to interconnect the defined blocks. Make sure that
the value to be entered matches the row number in the table defining the block that is
referred to. If you enter a wrong value (not matching the defined block type or
matching an undefined block) and press Save, a red mark will appear at the
respective row.
Tip
The Upper/Lower case need not be respected in the parameter names.
Some block parameters are optional. If you do not enter an optional
parameter in the block definition, the default value will be applied.

2N® Helios IP Automation Configuration
1.2
Use of Variables
The event block variables (parameters) help transfer additional information between
blocks –send ID of the detected card via HTTP to another device, use parameters
received in HTTP for setting parameters of a tied action and so on. Their values are
updated whenever the event is generated. Use the following syntax to refer to a
variable in the configuration parameters of another block:
$(block_number.variable_name) –the block number and variable name are separated
with a dot.
Example:
1: Event.KeyPressed: Key=Any
2: Action.SendHttpRequest: Event=1; Uri=http://192.168.1.1/ABCD?Key=$(1.Key)
Press any key (block 1 Event.KeyPressed) to send the HTTP request (block 2
Action.SendHttpRequest) to IP address 192.168.1.1. For example, if you press *, the
HTTP request URI will be as follows: http://192.168.1.1/ABCD?Key=*
Every event defines the TimeStamp and Count variables.
TimeStamp contains encoded date and time of the last event generation in the Unix
Time format (second count from 00:00:00 1.1.1970).
Count contains the count of event generations after the device start or last block
configuration change. The variable increases by 1 after each event generation.
Refer to the following subsections for more variables with specific functions.
Tip
The Upper/Lower case is not be respected in the variable names.
Caution
You cannot use the variables in the block relation defining parameters, i.e.
Event, Condition, etc.