Actions

Virtual I/O (SIP)

From Zenitel Wiki

SIP 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.


OBS icon
  • As from version 4.11.3.1 Virtual I/Os are by default disabled. To enable, access the Webcall interface by selecting Advanced SIP > Webcall, and check the flag Enable Web Call and Relay



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