Actions

LenelS2 OnGuard - Zenitel Connect Pro integration

From Zenitel Wiki


Introduction

This article describes the installation, configuration and operation of the integration between Zenitel Connect Pro and OnGuard, an access control system from LenelS2.

Installation and Configuration

It is assumed that the reader is familiar with Zenitel Connect Pro™ and OnGuard® and knows how to install and configure both these systems for what can be considered ‘standard operation’, see Prerequisites.

Prerequisites

  • OnGuard 8.3.x or newer configured on a compatible Operating System
  • Zenitel Connect Pro to 1.5.0 or later
    • Zenitel Connect Pro with the connected devices have been configured and the system is working properly – directory numbers must be in the range 1-32767; Specific configuration for the certification tests is outlined in the paragraph Zenitel Connect Pro Configuration

Licensing

OnGuard requires the following license:

  • Maximum Number of Intercom Exchanges (SWG-1340)

It is possible to connect multiple Zenitel Connect systems to OnGuard. This requires as many SWG-1340 licenses as the number of connected Zenitel Connect systems.
Zenitel Connect Pro requires the following license from Zenitel for integration with OnGuard:

  • 1002720900 – ZCL-API – ZC-Integration license

Installation

Install Accessory Add on

The Accessory Add on can be downloaded from the LenelS2 download area. It is listed as 'x.x Accessory Add-On for Zenitel Connect™ y.y.y with an msi installation file 'x.x Accessory Add-On for Zenitel Connect System.msi' Install ‘x.x Accessory Add-On for Zenitel Connect System.msi’

  • x.x denotes the OnGuard version for which the Accessory Add-On is intended
  • y.y.y denotes the version of the Add-On.

Zenitel Connect Pro configuration

Firewall

Zenitel Connect Pro communicates with OnGuard via TCP-port 443 and 8086. These ports are by default open. In case of connection problems, it should be checked whether these ports are open. See Firewall_(Zenitel_Connect_Pro) for more details.

Zenitel Link User

The Zenitel Connect API is called Zenitel Link. The integration between OnGuard and Zenitel Connect Pro requires a Zenitel Link User, which must authenticate itself with username and password. See User_Management_(Zenitel_Connect_Pro) for more details and how to add a Zenitel Link user.

Call queues

The principle of the integration is based on Zenitel devices at doors, in elevators, help points and other locations set up a call to a call queue. These calls are then listed in Alarm Monitoring and optionally shown in a map as Call Queued.


Door opening and permission

When an operator is in conversation with a door station and wants to open the door by pressing digit 6, Zenitel Connect Pro should send a data event to OnGuard.

OnGuard configuration

Zenitel Connect Pro Link user and certificate

The integration needs to know the Zenitel Link credentials and collect the certificate needed.

  • Run the command line application ‘ZL-OG-UserCredentials.exe’, which can found in the folder C:\ProgramData\Lnl\Zenitel. Run the application with parameters; Zenitel Link Username credentials and IP address to the Zenitel Connect Pro server:
    • ./ZL-OG-UserCredentials.exe username password ip.address.zcp.server
ZL-OG-UserCredentials application prompt

If you get a "Get certificate completed sucessfully" after running the command, you can continue to the next step. The username and password will be stored in an encrypted format. Run the application again to update the credentials and/or Zenitel Connect Pro Server address if needed.

Define Zenitel Connect Pro

Under Additional Hardware, select Intercom Devices … to define Zenitel Connect, additional intercom stations and intercom functions. Define the Zenitel Connect connection in the TAB Intercom Devices

  • Name: Enter an appropriate name, for instance 'Zenitel Connect'
  • Connection type IPv4
  • IP-address: the IP address of Zenitel Connect
  • Port: 8086 (The use of port 8086 is mandatory. Entering any other port number will cause the integration to fail.)


Intercom Stations

Define intercom stations in the TAB Intercom Stations:

  • All physical intercom stations in the system

Intercom functions

Define intercom functions in the TAB Intercom functions

  • If door opening should be possible from the operator intercom
    • Description: 'Door Opening'
    • Parameter: 6
Door opening

Pressing digit 6 during conversation will send a data command to OnGuard, if Zenitel Connect Pro has been programmed to do so.
In Global I/O, define the door station as the station that sends digit 6, not the operator station. This is so that in Global I/O the door station (input event) can be associated with a door (output action).

Default intercom station

To be able to use the function Call Intercom from the Alarm Monitoring GUI, a default operator station for a zone must be defined.

  • In System Administration, navigate to Monitoring/Monitoring Zones …
  • Click Add
  • Select a Monitoring Zone
  • Under Intercom Station/Place calls from: select an intercom station from the drop down list
  • Click OK

Intercom stations must already have been defined in System Administration.

Operation

Commands from the GUI

Users have the ability to execute the following commands (Intercom Right-click Options):

  • Place call: displays a dialog box where you enter the station number you are calling to. Zenitel Connect does not use the priority setting, it will be ignored
  • Cancel Call: cancels the intercom call
  • Call Intercom: places a call using the default intercom station for the zone, see paragraph Default intercom station

Visualization

In Alarm Monitoring, the following messages are displayed related to intercom station status changes:

  • Call Established – parameters: Originating station and called station
  • Call Disconnected – parameters: Originating station and called station
  • Call to a Private Subscriber – parameters: Originating station and called station
  • Call to a Busy Subscriber – parameters: Originating station and called station
  • Call Queued – parameters: Originating station and called station
  • Intercom Function; followed by the defined intercom function


In Alarm Monitoring, the following messages are displayed related to intercom system error messages:

  • Intercom Exchange Failure – Intercom Error


  • Intercom Exchange Failure – Intercom OK


  • Zenitel Connect is down


  • Zenitel Connect is up


Global I/O

In Intercom Function, it is possible to define the following sub-events:

  • Open door

Through the linkage server, it is possible to link an event in IC-EDGE to an action in OnGuard:

  • During a call between an operator and a caller at a door station, the operator presses digit 6 on the keypad
  • The resulting event in OnGuard will trigger an action: Pulse Door Unlock

OnGuard Maps

All intercom devices that exist in OnGuard Alarm Monitoring can effectively be placed on a map where they can be monitored. Icons in maps have the following appearances depending on intercom station statuses:

  • Idle
  • Busy
  • InQueue
  • Connected: Station is in a conversation with another station
  • LineError: A line error to the station has been detected
  • Offline: The station is off line; The state is shown when the Communication Server is not running, all station icons will show the Offline state

Limitations

OnGuard defines intercom directory numbers as integers; the supported range in the OnGuard-Zenitel Connect Pro integration is 1-32766. Directory numbers with a leading ‘0’ shall not be used in Zenitel Connect Pro.

Retrieved from "https://wiki.zenitel.com/w/index.php?title=LenelS2_OnGuard_-_Zenitel_Connect_Pro_integration&oldid=242878"