Actions

Difference between revisions of "Virtual I/O (Pulse)"

From Zenitel Wiki

(Created page with "{{P}} Virtual I/O is a feature for activating scripts on station events. The supported script languages are Lua and bash. A station can be triggered, e.g. by DTMF or an input...")
 
Line 15: Line 15:
 
* Select '''SIP Configuration''' > '''Script Upload'''
 
* Select '''SIP Configuration''' > '''Script Upload'''
  
[[File:SIP Turbine ScriptUP.PNG|thumb|left|500px|Script Upload]]
+
[[File:SIP Turbine ScriptUP.PNG|thumb|left|700px|Script Upload]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Line 25: Line 25:
 
* Select '''SIP Configuration''' > '''Script Configuration'''
 
* Select '''SIP Configuration''' > '''Script Configuration'''
  
[[File:SIP_Turbine_ScriptConf.PNG|thumb|left|500px|Script Configuration]]
+
[[File:SIP_Turbine_ScriptConf.PNG|thumb|left|700px|Script Configuration]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Line 52: Line 52:
 
In the example below, the script "Grant Door Access" will be executed when the station receives DTMF digit #6 from the remote station:
 
In the example below, the script "Grant Door Access" will be executed when the station receives DTMF digit #6 from the remote station:
  
[[File:SIP Turbine ScriptEvents.PNG|thumb|left|500px|Script Events]]
+
[[File:SIP Turbine ScriptEvents.PNG|thumb|left|700px|Script Events]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  

Revision as of 11:36, 29 October 2019

Pulse icon 300px.png

Virtual I/O is a feature for activating scripts on station events. The supported script languages are Lua and bash. A station can be triggered, e.g. by DTMF or an input to execute scripts towards other systems, e.g. access control systems. These scripts can be uploaded and configured via the menu options:

  • Script Upload
  • Script Configuration
  • Script Events

Requirements

  • Turbine station operating in Pulse and SIP mode.
  • Turbine version 4.2 or higher.
Note icon INCA stations do not support Virtual I/O.


Script Upload

To start with, a script should be uploaded to the station. It is possible to download scripts from the station by clicking its Name. Scripts are kept during a software upgrade process.

  • Select SIP Configuration > Script Upload
Script Upload


  • Upload Script: Click Browse to upload the desired script


Script Configuration

  • Select SIP Configuration > Script Configuration
Script Configuration


After uploading a script the user must configure a script slot (Slot 1 - Slot 10). First, assign a logical name to the script in the Assign a Label field. Then, enter the script to activate and add parameters in the text field under Enter script in selected slot (note that shell scripts don’t need to be uploaded as it is possible to write the script direclty in the text field). Lua scripts have the followings syntax:

lua <scriptname> <parameter1> <parameter2> <parameter3> ....

Shell scripts follow the same syntax, but starts with sh:

sh <scriptname> <parameter1> <parameter2> <parameter3> ...

The uploaded scripts should clearly state which parameters are needed in the beginning of the file.

The example shown in the screenshot above has 4 parameters: username, password, the IP address of the TruPortal device, and door number to activate. The parameter values in the example are:

  • Username = admin
  • Password = alphaadmin
  • IP address = 10.5.105.202
  • Door number = 4


Script Events

  • Select SIP Configuration > Script Events

After a script slot has been created, you need to configure which Event that should Execute the script.

In the example below, the script "Grant Door Access" will be executed when the station receives DTMF digit #6 from the remote station:

Script Events


If there is a need to delay the execution of the script, one can choose a time in seconds in the field "after a duration of".


Examples