Page 1
Automation manual for 2N IP intercoms Configuration Manual Version: 2.22 www.2n.cz...
Page 2
2N TELEKOMUNIKACE a.s. administers the FAQ database to help you quickly find information and to answer your questions about 2N products and services. On www. faq.2n.cz you can find information regarding products adjustment and instructions for optimum use and procedures „What to do if...".
Page 3
The 2N TELEKOMUNIKACE a.s. is the holder of the ISO 9001:2009 certificate. All development, production and distribution processes of the company are managed by this standard and guarantee a high quality, technical level and professional aspect of all our products.
Page 4
Content: 1. Terms and Symbols 2. 2N® IP Automation Configuration 3. Events 4. Actions 5. Conditions 6. Utilities 7. Available Digital Inputs and Outputs 8. Examples of Use 2N TELEKOMUNIKACE a.s., www.2n.cz 4/104...
Warning Always abide by this information to prevent damage to the device. Caution Important information for system functionality. Useful information for quick and efficient functionality. Note Routines or advice for efficient use of the device. 2N TELEKOMUNIKACE a.s., www.2n.cz 5/104...
Page 6
2. 2N® IP Automation Configuration 2N IP intercoms provide 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 – Automation . Typically,...
Page 7
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. 2N TELEKOMUNIKACE a.s., www.2n.cz 7/104...
29 actions and assign them to 1 event, for example. Enabled – function enable Name – function name State – function state: Started/Stopped/Empty/Error Action – click to set the function and to delete the function. 2N TELEKOMUNIKACE a.s., www.2n.cz 8/104...
. Drag and drop the items to the desktop. Toolbar – includes function controls Pictogram Description function name function editing mode function block moving mode help mode for function blocks. Click a block to display the block help. magnification zoom out/in import/export 2N TELEKOMUNIKACE a.s., www.2n.cz 9/104...
Page 10
Automation manual reference save quit function editing desktop helps you place and interconnect the function blocks. 2N TELEKOMUNIKACE a.s., www.2n.cz 10/104...
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 TELEKOMUNIKACE a.s., www.2n.cz 11/104...
Count contains the count of event generations after the device start or last block configuration change. The output parameter increases by 1 after each event generation. Refer to the following subsections for more output parameters with specific functions. 2N TELEKOMUNIKACE a.s., www.2n.cz 12/104...
Page 13
The Upper/Lower case is not be respected in the output parameters names. Caution You cannot use the output parameters in the block relation defining parameters, i.e. Event, Condition, etc. 2N TELEKOMUNIKACE a.s., www.2n.cz 13/104...
Page 14
Time – specific time (alarm clock) MotionDetected – motion detected by the camera NoiseDetected – noise detected by the microphone RegistrationStateChanged – SIP account registration state changed See below for details on the events and their Input parameters and use. 2N TELEKOMUNIKACE a.s., www.2n.cz 14/104...
Pressed Key – the recorded code of the key which was the last to generate this event. The key code is stored in the Key parameter format. Example Event generated by pressing of # and quick dial button 3 or 4: 2N TELEKOMUNIKACE a.s., www.2n.cz 15/104...
Page 16
Released Key – the recorded code of the key which was the last to generate this event. The key code is stored in the Key parameter format. Example Event generated by releasing of 1 and quick dial button 2: 2N TELEKOMUNIKACE a.s., www.2n.cz 16/104...
Page 17
Output parameters Event – the Event invoke connected Event or Action. Pressed Key – the recorded received DTMF code which was the last to generate the event. The DTMF is stored in the Key parameter format. 2N TELEKOMUNIKACE a.s., www.2n.cz 17/104...
Page 18
Example Event generated upon detection of DTMF code #: 2N TELEKOMUNIKACE a.s., www.2n.cz 18/104...
Page 19
Output parameters Event – the Event invoke connected Event or Action. Code – the detected received numeric code which was the last to generate this event. Example Event generated upon detection of DTMF code 12345* 2N TELEKOMUNIKACE a.s., www.2n.cz 19/104...
Page 20
– tones are not suppressed enabled – tones are suppressed (default value). Output parameters Event – the Event invoke connected Event or Action. Code – the received numeric code which was the last to generate this event. 2N TELEKOMUNIKACE a.s., www.2n.cz 20/104...
Page 21
Example Event generated by entering code 12345* on a keypad: 2N TELEKOMUNIKACE a.s., www.2n.cz 21/104...
Page 22
Input parameters This block has no Input parameters. Output parameters Event – the Event invoke connected Event or Action. Example Event generated by entering code 112 if some of the users is assigned code 111. 2N TELEKOMUNIKACE a.s., www.2n.cz 22/104...
Page 23
The parameter is optional, the default value is Direction – define direction Valid values: in – reader with defined incoming direction out – reader with defined outgoing direction any – both directions The parameter is optional, the default value is 2N TELEKOMUNIKACE a.s., www.2n.cz 23/104...
Page 24
Direction – configured direction at the card reader ( in, out, any Reader – name of the module which was used ( internal_cardreader external_cardreader <module_name> Example Event generated by entering of the card with ID 0012456: 2N TELEKOMUNIKACE a.s., www.2n.cz 24/104...
Page 25
The parameter is optional, the default value is Direction – define direction Valid values: in – reader with defined incoming direction out – reader with defined outgoing direction any – both directions The parameter is optional, the default value is Output parameters 2N TELEKOMUNIKACE a.s., www.2n.cz 25/104...
Page 26
Reader – name of the module which was used ( internal_cardreader external_cardreader <module_name> Direction – configured direction at the card reader ( In, Out, Unspecified Example Event generated by holding of the card with ID 0012456: 2N TELEKOMUNIKACE a.s., www.2n.cz 26/104...
Page 27
State – the detected call state which generated this event. The options correspond to the State parameter. Direction – the detected call direction which generated this event. The options are incoming or outgoing. Example Event generated by answering a call from number 1234: 2N TELEKOMUNIKACE a.s., www.2n.cz 27/104...
Page 29
The options correspond to the Input parameter values. Edge – the detected edge change which was the last to generate this event. The options are falling or rising. Example Event generated by disconnection of the tamper switch (device opening): 2N TELEKOMUNIKACE a.s., www.2n.cz 29/104...
Page 31
10 – 10 seconds (units are unnecessary) 10s – 10 seconds 100ms – 100 milliseconds. Output parameters Event – the Event invoke connected Event or Action. Example Event generated 1s after the rise of event on row 1: 2N TELEKOMUNIKACE a.s., www.2n.cz 31/104...
Page 32
100ms – 100 milliseconds. The minimum period is 100ms Output parameters Event – the Event invoke connected Event or Action. Example Event generated three times in 1s intervals after the rise of event on row 1: 2N TELEKOMUNIKACE a.s., www.2n.cz 32/104...
Page 34
& is used as the separator. The HTTP-received Input parameters are available as HttpTrigger block Output parameters. The output parameters name equals to the name of the parameter transferred - $(line.param1) a $(line.param2). 2N TELEKOMUNIKACE a.s., www.2n.cz 34/104...
Page 35
Example Event generated by receiving of the following HTTP command: http://ip_addr/enu /trigger/opendoor 2N TELEKOMUNIKACE a.s., www.2n.cz 35/104...
Page 36
Example: Suppose a mass command generated by the MulticastRequest action is received, in which Params=“AAA=123” is included. The MulticastTrigger event which processes this command will automatically include value 123 for the AAA output parameter. This output parameter can be referred to in the interconnected blocks. 2N TELEKOMUNIKACE a.s., www.2n.cz 36/104...
Page 37
Example Event generated by receiving of a mass opendoor command: 2N TELEKOMUNIKACE a.s., www.2n.cz 37/104...
Page 38
Output parameters Event – the Event invoke connected Event or Action. Example An event generated after the audio loop test if the test result is negative (i.e. the microphone or loudspeaker is out of order): 2N TELEKOMUNIKACE a.s., www.2n.cz 38/104...
Page 39
Condition.ProfileState at the started action and specify requested days in the used time profile. Output parameters Event – the Event invoke connected Event or Action. Example Event generated every day at 17:30. 2N TELEKOMUNIKACE a.s., www.2n.cz 39/104...
Page 40
The parameter is optional, the default value is start Source – internal camera source only Output parameters Event – the Event invoke connected Event or Action. Example Event generated at the start of the motion. 2N TELEKOMUNIKACE a.s., www.2n.cz 40/104...
Page 41
– end of the noise The parameter is optional, the default value is start Output parameters Event – the Event invoke connected Event or Action. Example Event generated at the start of the noise 2N TELEKOMUNIKACE a.s., www.2n.cz 41/104...
Page 42
Account – select the account for which events are to be monitored. State – set the registration state that generates the event. Example Event generated when the intercom has been unregistered (whenever the registrar failed to respond to a periodical registration request): 2N TELEKOMUNIKACE a.s., www.2n.cz 42/104...
Page 44
SendDtmf - DTMF codes sending SendEmail – email sending SetOnvifVirtualInput – virtual input for ONVIF SendWiegandCode – code sending to the Wiegand bus UploadSnapshotToFtp – snapshot upload to the FTP server StartAutoUpdate – firmware and configuration AutoUpdate 2N TELEKOMUNIKACE a.s., www.2n.cz 44/104...
Page 45
– the switch is toggled. The parameter is optional, the default value is Example Activate switch 1 if the event defined on row 2 arises and the condition defined on row 3 is met: 2N TELEKOMUNIKACE a.s., www.2n.cz 45/104...
Page 46
Available Digital Inputs and Outputs subsection Level – define the required output level. This parameter is optional. Valid values: lo – output deactivation hi – output activation (default value). Example Activate Output1 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 46/104...
Page 47
– define the IP Mobile application to be called: device_name. Enter just one of the above mentioned parameters ( Number Uri User Device Example Establish an outgoing call if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 47/104...
– define the event to launch the action. Condition – define the condition to be met to execute the action. This parameter is optional. Example Answer a call if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 48/104...
Page 49
– define the event to launch the action. Condition – define the condition to be met to execute the action. This parameter is optional. Example Terminate a call if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 49/104...
Page 50
Example 1) Whenever a connected event is generated, HTTP sends a request to the following IP address: 10.27.24.6: Example 2) Whenever any key is pressed, its exact identification is sent to the following IP address: 10.27.24.6: 2N TELEKOMUNIKACE a.s., www.2n.cz 50/104...
Page 52
Format in Formatter Request to be sent pressed Quick dial 1 http://10.27.1.6 http://10.27.1.6/message=%251 ("%" is /message={1} encoded as "%25") Keypad 1 http://10.27.1.6 http://10.27.1.6/message=1 /message={1} Quick dial 1 http://10.27.1.6/mess? http://10.27.1.6/mess?age=%251 age={1} Keypad 1 http://10.27.1.6/mess? http://10.27.1.6/mess?age=1 age={1} 2N TELEKOMUNIKACE a.s., www.2n.cz 52/104...
Page 53
Use any text containing the A–Z, a–z and 0–9 characters. Example Send the opendoor command to all the devices with the properly set Event. MulticastTrigger block in the network if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 53/104...
Page 55
– the sound is played on the intercom. call – the sound is played into the call. The parameter is optional; the default value is speaker Example Play user sound 1 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 55/104...
Page 56
– codec G.722 – codec L16, 16 kHz The parameter is optional; the default value is pcmu Example Start audio stream sending via channel 1 to address 239.0.0.1:10000 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 56/104...
Page 58
– define the condition to be met for the action to be executed. This parameter is optional. Channel – define the channel number (0–3) to be controlled. Example Stop audio stream sending via channel 1 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 58/104...
Page 59
– codec L16, 16 kHz The parameter is optional; the default value is pcmu Example Start audio stream receiving on multicast IP address 239.0.0.1:10000 via channel 1 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 59/104...
Page 61
– define the condition to be met for the action to be executed. This parameter is optional. Channel – define the channel number (0–3) to be controlled. Example Stop audio stream receiving via channel 1 if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 61/104...
Page 62
– external IP camera. The parameter is optional, the default value is internal Example Switch the video signal source to the first external analogue camera input if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 62/104...
Page 63
Operation – define the RTP stream operation. Valid values mute – mute the stream. unmute – unmute the stream (stream is played). Example Mute call streams in both ways if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 63/104...
Page 64
– define the condition to be met for the action to be executed. This parameter is optional. Example Send a syslog message with captured event 2 (Event.CardEntered) if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 64/104...
Page 65
Condition – defines the condition to be met for the action to be executed. This parameter is optional. Code – defines sent DTMF characters Valid values: 0 – 9, A – D, F Example Sends code 1234 into an active call 2N TELEKOMUNIKACE a.s., www.2n.cz 65/104...
Page 66
The parameter is optional; the default value is User – define the user to whom the email will be sent. Valid values: 2N TELEKOMUNIKACE a.s., www.2n.cz 66/104...
Page 67
Email – define the email address to which the email will be sent. Enter more email addresses if necessary separated with a comma in inverted commas. Valid values: user@domain_name user@ip_address " user@domain_name, user@ip_address" User parameter is preferred to the Email parameter. 2N TELEKOMUNIKACE a.s., www.2n.cz 67/104...
Page 68
Example Send an email to the email address set to user2@domain_name if event 1 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 68/104...
Page 69
The parameter is optional; the default value is hi (true). Example Send information that port 8 has changed its value to 1 via the O NVIF protocol if the event defined on row 2 arises: The following is sent to ONVIF: InputToken: onvif_port_08 LogicalState:true 2N TELEKOMUNIKACE a.s., www.2n.cz 69/104...
Page 70
– define the module via which the code is to be sent. Valid values: module name configured in the Module name parameter in the Hardware / Extenders / Modules / Wiegand module menu. The parameter is mandatory for Verso but not applied for other models. 2N TELEKOMUNIKACE a.s., www.2n.cz 70/104...
Page 71
Example Send a code entered by Event.CodeEntered via the Wiegand interface: For Verso and Access Unit the second line should look like as follows: 2N TELEKOMUNIKACE a.s., www.2n.cz 71/104...
Page 72
– internal camera external – external camera. The parameter is optional; the default value is a Example Upload a picture from the camera to the FTP server if the event defined on row 2 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 72/104...
Page 73
– define the event to launch this action. Condition – define the condition to be met for the action to be executed. This parameter is optional. Send an email to the email address set to user2@domain_name if event 1 arises: 2N TELEKOMUNIKACE a.s., www.2n.cz 73/104...
Page 74
FlipFlopRS – RS-type flip-flop FlipFlopD – D-type flip-flop LogicalAnd – logical AND of conditions LogicalOr – logical OR of conditions LogicalNot – condition negation See below for details on the conditions and their parameters and use. 2N TELEKOMUNIKACE a.s., www.2n.cz 74/104...
True True block defines the condition to be met each time. Output parameters Example The condition is always met: 2N TELEKOMUNIKACE a.s., www.2n.cz 75/104...
Page 76
False False block defines the condition not to be met any time. Output parameters Example The condition is always not met. 2N TELEKOMUNIKACE a.s., www.2n.cz 76/104...
State – define the required profile state. This parameter is optional. Valid values: active – active profile (default value) inactive – inactive profile. Output parameters Example The condition is met for inactive time profile 1: 2N TELEKOMUNIKACE a.s., www.2n.cz 77/104...
Page 78
– define the call direction. Valid values: incoming – incoming calls outgoing – outgoing calls – both directions. The parameter is optional, the default value is Output parameters Example The condition is met for an inactive call: 2N TELEKOMUNIKACE a.s., www.2n.cz 78/104...
Page 79
Valid values: registered – the account is registered unregistered – the account is not registered The parameter is optional, the default value is registered Output parameters Example The condition is met for not registered 1 account: 2N TELEKOMUNIKACE a.s., www.2n.cz 79/104...
Page 80
– define the required digital input level. The parameter is optional. Valid values: – logic 0 – logic 1 (default value). Output parameters Example The condition is met for an activated tamper switch (device not open): 2N TELEKOMUNIKACE a.s., www.2n.cz 80/104...
Page 81
0 – condition is not met (default value) 1 – condition is met. Output parameters Example The condition is met at the rise of event 1 and not met at the rise of event 2: 2N TELEKOMUNIKACE a.s., www.2n.cz 81/104...
Page 82
The ® FlipFlopD output can be used as a condition for action control in rather complex 2N Automation applications. It is a simulation of a D-type flip-flop circuit.
Page 83
In4 – define the condition to be met. In5 – define the condition to be met. Output Parametres Example The condition is met if conditions 1, 2 and 3 are met at the same time: 2N TELEKOMUNIKACE a.s., www.2n.cz 83/104...
Page 84
In3 – define the condition to be met. In4 – define the condition to be met. In5 – define the condition to be met. Output parameters Example The condition is met if conditions 1, 2 or 3 are met: 2N TELEKOMUNIKACE a.s., www.2n.cz 84/104...
Page 85
LogicalNot LogicalNot block defines the condition to be met in case another defined condition is not met. Input parameters Output parameters Example The condition is met in case condition 1 is not met: 2N TELEKOMUNIKACE a.s., www.2n.cz 85/104...
Page 86
6. Utilities Automation defines the following types of events: 2N TELEKOMUNIKACE a.s., www.2n.cz 86/104...
Page 87
Param 5 – set an output parameter for the Format parameter. Typically, it is connected to the Events variable. Output parameters Text – final Format text with the set output parameters if any. In Param 1. 2N TELEKOMUNIKACE a.s., www.2n.cz 87/104...
Page 88
Example Prepare an http command including the value of the key pressed in KeyPressed. 2N TELEKOMUNIKACE a.s., www.2n.cz 88/104...
In this section, the digital inputs and outputs available on each 2N IP intercom model are described. ® IP Vario ® IP Force/Safety ® IP Audio/Video Kit ® IP Verso ® IP Solo ® SIP Audio Converter ® Access Unit 2N TELEKOMUNIKACE a.s., www.2n.cz 89/104...
Page 90
2N ® IP Vario Outputs relay1 – relay output on basic unit relay2 – relay output on additional switch (if installed) cr_relay1 – relay output 1 on card reader (if installed) cr_relay2 – relay output 2 on card reader (if installed) led_secured –...
Page 91
– second button backlight at Safety led_key3 – third button backlight at Safety Inputs tamper – tamper switch (if installed) cr_input1 – digit input 1 on card reader (if installed) cr_input2 – digital input 2 on card reader (if installed) 2N TELEKOMUNIKACE a.s., www.2n.cz 91/104...
Page 92
2N ® IP Audio/Video Kit Outputs relay1 – relay output output1 – digital output 1 output2 – digital output 2 led1 – LED 1 control output led2 – LED 2 control output led3 – LED 3 control output Inputs input1 –...
2N ® IP Verso Basic Unit Outputs output1 – digital output relay1 – relay output led_secured – red LED indicator at the panel Inputs input1 – digital input on basic unit I/0 Module The inputs / outputs are addressed as follows: <module_name>.<input/output_name>...
Page 95
2N ® IP Solo Outputs output1 – digital output relay1 – relay output led_secured – red LED indicator at the panel Inputs input1 – digital input on basic unit tamper – tamper switch 2N TELEKOMUNIKACE a.s., www.2n.cz 95/104...
Page 96
2N ® SIP Audio Converter Outputs relay1 – relay output Inputs Unavailable It is possible to use Event.KeyPressed: Key=%1 for events generated at LOGIC IN input 2N TELEKOMUNIKACE a.s., www.2n.cz 96/104...
Page 97
2N ® Access Unit Basic Unit Outputs output1 – digital output relay1 – relay output led_secured – red LED indicator at the front panel Inputs input1 – digital input No. 1 on basic unit input2 – digital input No. 2 on basic unit input3 –...
Page 98
– output LED OUT Inputs input1 – vstup LED IN tamper – tamper switch (if installed) 2N TELEKOMUNIKACE a.s., www.2n.cz 98/104...
Call the selected telephone number whenever the tamper switch gets disconnected (device opened).e Block diagram The rising edge on the tamper input (1: Event.InputChanged) initiates calling to the defined telephone number (2: Action.BeginCall). Intercom settings 1: Event.InputChanged: Input=tamper 2: Action.BeginCall: Number=1111; Event=1 2N TELEKOMUNIKACE a.s., www.2n.cz 99/104...
Page 100
(2: Condition.CodeEntered) on the numeric keypad. If another code is entered (3: Condition.CodeEntered), the condition will be invalid. Intercom settings 1: Event.InputChanged: Input=tamper; Edge=rising 2: Event.CodeEntered: Code=164575 3: Event.CodeEntered: Code=111 4: Condition.FlipFlopRS: SetEvent=3; ResetEvent=2; ResetValue=1 5: Action.BeginCall: Number=1111; Event=1; Condition=4 2N TELEKOMUNIKACE a.s., www.2n.cz 100/104...
Page 101
Activate the door contact switch by tapping/swiping the proper RFID card on /through the reader. Block diagram Entering an RFID card with the defined ID (1: Event.CardEntered) activates switch 1 (2: Action.ActivateSwitch). Intercom settings 1: Event.CardEntered: Card=0*0000 2: Action.ActivateSwitch: Switch=1; Event=1 2N TELEKOMUNIKACE a.s., www.2n.cz 101/104...
Page 102
Delay).The call is only executed if the door remains open for more than 120 s (3: Condition.InputState). Intercom settings 1: Event.InputChanged: Input=input1; Edge=rising 2: Event.Delay: Delay=120 s; StartEvent=1 3: Condition.InputState: Input=input1; Level=1 4: Action.BeginCall: Number=1111; Event=2; Condition=3 2N TELEKOMUNIKACE a.s., www.2n.cz 102/104...
Page 103
LED switch-on action is conditioned by the active call (3: Condition.CallState). Intercom settings 1: Event.Timer: Period=250 ms 2: Event.Delay: Delay=125 ms; StartEvent=1 3: Condition.CallState: State=Connected 4: Action.SetOutput: Output=led1; Level=1; Event=1; Condition=3 5: Action.SetOutput: Output=led2; Level=0; Event=2 2N TELEKOMUNIKACE a.s., www.2n.cz 103/104...