Actions

Difference between revisions of "Milestone XProtect - IC-Edge Integration"

From Zenitel Wiki

(Created page with "{{E}} ==Introduction== <br> '''This article assumes that the reader is''' *familiar with setup and operation of the Milestone XProtect VMS *that the Milestone XProtect VMS is...")
 
Line 1: Line 1:
{{E}}
+
== Introduction ==
==Introduction==
+
The Zenitel Cal Handler (IC-Edge) is a plugin that allows users to integrate Milestone XProtect with Zenitel intercom systems. In this guide, we'll walk you through the installation process and explain how to
 +
configure the plugin to work with your setup.
 
<br>
 
<br>
'''This article assumes that the reader is'''
+
<br>
*familiar with setup and operation of the Milestone XProtect VMS
+
== Installation ==
*that the Milestone XProtect VMS is operational, with all the system connected cameras configured
+
*Download the zip file containing the plugin from the Zenitel website.
Only points that are specific to this integration and to its connected intercom stations are described.
+
*Extract the contents of the zip file to a location of your choice.
<br><br>
+
*Run the setup file (the MSI or the EXE, depending on your system).
 +
*When prompted for the installation location, select the Milestone/MIP installation folder (e.g. C:\Program Files\Milestone\MIP).
 +
*Click "Finish" to complete the installation.<br>
 +
<br>
 +
== Configuration ==
 +
====Basic plugin configuration====
 +
*Open the XProtect Smart Client.
 +
*Open the "Configuration" window by clicking the "Configuration" icon in the toolbar.
 +
*In the "Configuration" window enter the IP address and port number of your Zenitel intercom system acting as the IC-Edge controller in the "IP Address" and "Port" fields, respectively.
 +
*Click the "Connect" button and wait for the system to retrieve the list of available devices.
 +
*Select the operator's device by choosing its directory number from the drop-down list.
 +
<br>
 +
[[File:ZenitelCallHandler_IC-EdgeConfigurationGif.gif|thumb|center|800px|Animation of the Zenitel Cal Handler configuration process]]
  
===Overview===
 
Zenitel devices can be integrated into the Milestone XProtect system using their ONVIF capabilities and supplemented with the Zenitel Call Handler plugin.
 
<br><br>
 
'''ONVIF benefits:'''
 
* Auto discover devices in the Milestone XProtect VMS, ensuring easy integration.
 
* Display Zenitel device video feed in the Milestone XProtect VMS on various events like a call request, outgoing call, or pressed DAK button.
 
* Display Camera on a call connection, allowing the operator to see who he is talking to.
 
* Record audio and video during a conversation.
 
* Write a log entry for the audit trail on various events like starting a conversation, opening a door, motion detection, etc.
 
'''Benefits of Zenitel Call Handler:'''
 
* Pops up above all opened windows and displays all incoming (queued) and outgoing calls.
 
* Allows the operator to accept queued calls and close opened call connections without opening the plugin inside the Milestone XProtect VMS.
 
  
 
<br>
 
<br>
===Compatibility===
+
====Associating cameras with devices====
*Milestone XProtect Smart Client 2019 R3 and higher
+
*Open the camera settings window.
*ICX: 1.0.3.1 and higher
+
*On the left side, there will be a list of devices registered with the IC-Edge controller. On the right side, there will be a list of cameras registered within the XProtect system.
*AlphaCom: 13.1.3.3 and higher
+
*Click on a device in the left list to select it.
 
+
*Click on an item in the right list to preview the video feed from that camera.
===Licensing===
+
*To associate a camera with a selected device, click the checkbox next to the camera's name.
Zenitel devices can be used using their ONVIF capabilities without a specific integration license from Zenitel.<br>
+
*Repeat steps 3-5 to associate additional cameras with the selected device.
The use of the call handler plugin is licensed as detailed below.
+
*Once satisfied with the configuration, close the camera settings window.
====IC-EDGE====
+
*Click "Save and Close" on the configuration window to save the changes.
 +
<br>
 +
[[File:ZenitelCallHandlerCameraConfiguration2_IC-Edge.JPG|thumb|center|800px|Screenshot of the camera assosiation process]]
  
====Milestone license====
 
Using the integration plug-in module does not require a specific license from Milestone.<br>
 
For connection of devices to Milestone XProtect, please contact Milestone directly.
 
<br><br>
 
  
==ONVIF Integration==
 
Zenitel devices are recognized in the Milestone XProtect system as ONVIF compatible devices and are added to the system in the same way.
 
 
<br>
 
<br>
'''Note:''' ''audio-only devices are also recognized as ONVIF devices.''
+
== Using the Call Handler ==
<br><br>
+
The Zenitel Cal Handler (IC-Edge) plugin can be used for two scenarios: initiating calls and reacting to inbound calls.
=== Supported Devices ===
 
====Video Intercoms====
 
*Turbine Video intercom and kit: TCIV+
 
*Turbine Video kit: TKIV+
 
* Turbine  Video intercom TCIV (previous generation of Zenitel video intercom devices)
 
 
 
====Non-Video Intercoms====
 
* Turbine Compact series TCIS
 
* Turbine Industrial series TFIE
 
* Turbine kits TKIE and TKIS
 
* EX intercoms series TFIX
 
* V2 Master Stations
 
* IP Speakers
 
 
 
=== Pre-requisites ===
 
* VS-IS 6.4.3.0 or later must be installed in the Zenitel Device
 
* The latest XProtect Device Pack must be installed.
 
 
 
===ONVIF configuration===
 
Some ONVIF settings are available from the station web interface where the user needs to enable reporting DAKs and digital inputs in ONVIF.
 
<br clear="all" />
 
 
 
The user can configure digital inputs to trigger various behaviors in XProtect, most notably: <br>
 
* Set the Matrix to view the device video
 
* Start recording video/audio
 
* Write an entry in the audit trail log
 
* Trigger a pre-recorded audio message
 
* Trigger an alarm
 
 
 
More information on this topic can be found in the [[ONVIF Settings|ONVIF]] article.
 
 
 
===Using the Matrix===
 
 
 
1. The user has to create a matrix in the Milestone Management Client.
 
<br><br>
 
[[File:MatrixLocalSetup.PNG|700px]]
 
<br><br>
 
2. After configuring the matrix the user has to add it to a view in the XProtect Smart Client
 
<br><br>
 
[[File:MatrixSmartClient.PNG|700px]]
 
<br><br>
 
3. After the matrix has been set up the user has to configure the rule system in the XProtect Management System to push the device video to the matrix.
 
<br><br>
 
[[File:RuleExampleSetup.png|700px]]
 
 
 
More information on the matrix can be found in the official Milestone documentation <br>
 
[https://doc.milestonesys.com/latest/en-US/standard_features/sf_sc/sf_matrix/sc_workingwithmatrix(715).htm Milestone Matrix (usage)] <br>
 
[https://doc.milestonesys.com/latest/en-US/standard_features/sf_sc/sf_matrix/sc_configuringmatrix.htm Milestone Matrix (configuration)] <br>
 
 
 
===Alarm configuration===
 
On the Milestone XProtect VMS server, virtually any kind of incident or technical problem - events - can be set up to trigger an alarm. Alarms and events can all be viewed on the Alarm Manager tab, which provides a central overview of your Milestone XProtect VMS incidents, status, and possible technical problems.
 
<br><br>
 
The following images show a detailed overview of the XProtect alarm system:
 
<br><br>
 
[[File:Alarm management 3 - Detailed.png|1000px]]
 
[[File:Alarm trigered - Detailed.PNG|1000px]]
 
<br><br>
 
Full size images can be found here:
 
* [[Media:Alarm management 3 - Detailed.png]]
 
* [[Media:Alarm trigered - Detailed.PNG]]
 
 
 
More information on the alarm system can be found in the official Milestone documentation<br>
 
[https://doc.milestonesys.com/latest/en-US/feature_flags/ff_managealarms/sc_workingwithalarms.htm Milestone Alarms and events (usage)]
 
 
 
==Zenitel Call Handler plugin installation==
 
This section describes how to install the integration plugin.
 
It is assumed that the Milestone XProtect VMS has been installed and is running.<br>
 
 
 
===Prerequisite===
 
The integration plugin uses .NET 4.8. Please make certain that this version of the .NET framework is installed prior to installing the interface module itself.
 
 
 
===Milestone Management Client / Smart Client===
 
When installing (or uninstalling) the plugin, all Milestone Clients (Management Client and Smart Client) must be closed.
 
 
 
===Plugin Installation===
 
The name of the installation file is Zenitel-CallHandler.x.x.x.x.exe, where x.x.x.x is the version number.
 
Double click the exe-file to start the installation procedure. Click through the installation option screens, make the appropriate choices, and select Install to do the actual plugin installation.
 
 
 
The plugin will be installed in the directory
 
C:\Windows\Program Files(x86)\Zenitel\Zenitel Call Handler
 
 
 
[[File:ZCH_SetupFileStructure.png|thumb|left|700px|Setup File Structure]]
 
<br style="clear:both;" />
 
 
 
===Plugin Setup===
 
 
 
The installation in Milestone XProtect VMS is carried out by starting the program Zenitel.CallHandler.Plugin.Config.exe:
 
 
 
[[File:PluginSetup-Edge.PNG|thumb|left|700px|Milestone Plugin Setup]]
 
<br style="clear:both;" />
 
 
 
Select the type of system (ICX/IC-EDGE). Press “Apply” to execute the update. The program can also be used for changing the system type in which case you press “Load” – make the system change – and press “Apply”.
 
 
 
*ICX - Select ICX also if the system to be integrated is AlphaCom XE
 
*IC-EDGE - Selects IC-EDGE system (in the rest of this article only reference will be made to IC-EDGE, but the operation is the same for AlphaCom XE and ICX)
 
  
 +
====Initiating Calls====
 +
In XProtect Smart Client on the Zenitel Audio tab select a device you wish to call and click on the green "Call" button.<br>
 +
A popup window will be displayed showing the active call, along with a video preview from an associated camera.
 
<br>
 
<br>
 +
[[File:ZenitelCallHandlerOperation1_IC_Edge.JPG|thumb|center|800px|Screenshot of popup window displaying the active call and associated camera]]
  
===Milestone XProtect Smart Client===
 
 
The Milestone XProtect Smart Client is started in the following way:
 
*Ensure the three servers - management, event, and recording - are up and running. This can be checked by viewing the taskbar. All icons should be shown with a green indicator.  [[File:MilestoneServers.jpg]] <br style="clear:both;" />
 
*Click on icon [[File:SmartClientIcon.jpg]]  and wait until the following picture will be shown:
 
 
[[File:ConnectSmartClient.jpg|thumb|left|700px|Milestone XProtect Smart Client Connection]]
 
<br style="clear:both;" />
 
Press “Connect” and wait until the Milestone XProtect Client is started.
 
 
[[File:SmartClientGUI.jpg|thumb|left|700px|Milestone XProtect Smart Client Startup View]] <br style="clear:both;" />
 
 
Ensure that the “Setup” button in the upper right corner is turned on with an orange background as shown. The Milestone Xprotect VMS is now in setup mode.
 
It is now possible to define different views with different partitioning (split). For the test, it would be appropriate to create a (1 x 1) view (see picture above).
 
  
 
<br>
 
<br>
Select the (1*1) view and and drag and drop the “Zenitel Call Handler” plugin onto the view.
+
====Answering queued Calls====
[[File:SmartClientView_1_1.jpg|thumb|left|700px|Milestone XProtect Smart Client 1*1 View]] <br style="clear:both;" />
+
*When an inbound call is received, a popup window will be displayed showing the queued call, along with a video preview from an associated camera.
 +
*To answer the call, the operator has to answer it using a physical device selected as the operator directory number.
 +
*If there is an active call, the Call Handler will automatically hang up the active call and answer the inbound call.
 +
*If there are multiple queued calls, they will be displayed in order of priority.  
 
<br>
 
<br>
Press the orange "Setup" button.
+
[[File:ZenitelCallHandlerOperation2_IC-Edge.JPG|thumb|center|800px|Screenshot of popup window displaying the active call and his associated camera with two queued calls]]
You may push “<” in the panel  [[File:ViewSelect.jpg]] to hide the left side panel.
 
<br style="clear:both;" />
 
  
[[File:SmartClient_ICX_Unconfigured_Settup_window.PNG|thumb|left|700px|Milestone XProtect Smart Client - ICE Setup]]
 
<br style="clear:both;" />
 
  
You can easily switch between views by activating the “v” in the panel.
+
<br>
[[File:ViewSelect_2.jpg]] and select the desired view from the list:
+
====Using the Popup Window====
<br style="clear:both;" />
+
* The popup window displays the active call (if it was initiated by the operator) or a list of queued calls, along with a video preview from an associated camera.
 +
* The popup window will display the camera feed from the first associated camera of the active call (if present) or if there are no active calls, the first queued device-associated camera will be displayed.
 +
* To manually switch the camera video feed to any active or queued device, select the desired device from the dropdown list in the popup window.
 +
* To hang up the active call, click the red "Hang-Up" button.
 +
* To answer a queued call, the operator has to answer it using a physical device selected as the operator directory number.
 +
* If there are multiple queued calls, they will be displayed in order of priority. To answer a specific queued call, select it from the dropdown list in the popup window.
  
[[File:CreatedViews.jpg|thumb|left|700px|List of User Defined Views]]
+
<br>
<br style="clear:both;" />
 
 
 
The ICXICE-Client is now in setup mode. Switching between “Setup” and “Operation” is done by a single left click on the icon  [[File:ICX_Icon.jpg]]
 
<br style="clear:both;" />
 
  
==Operation==
+
==Previous versions==
===Popup window===
+
For configuration of previous versions of the plugin go to:
As soon as a call is queued the popup window will be opened. Popup windows will be drawn on top of any other open window and persist as the topmost window until manually closed. This way the operator can use the VMS to view video from the stations and the popup window to answer calls.
+
* [[Milestone Xprotect - IC-Edge Integration (Zenitel Call Handler)]] or
[[File:PopupDemo-Edge.png|thumb|left|500px|Popup window]]
+
* [[Milestone Xprotect - IC-Edge Integration (VS-Milestone Plugin)]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
 
===Usage===
 
The main TAB in operational mode is the '''Call Requests'''-TAB.<br/>
 
All call requests are listed in order of priority in the '''Call Requests'''-list; the time when the call request entered the list is shown below the station identification.<br>
 
An established call is shown in the top section of the TAB and in the popup window. A timer shows how long the conversation has been going on.<br>
 
[[File:SmartClient_ICE_Operation_1.png|thumb|left|500px|Call request TAB in operational mode]]
 
<br style="clear:both;" />
 
 
The '''Stations'''-TAB allows the selection of stations for directly calling them through the Milestone XProtect VMS. Clicking on the call icon will establish a call with the selected station and immediately open the popup window.
 
''NOTE: The popup window lacks the station tab to place calls from the Milestone XProtect VMS. More on stations tabs in the Usage section below.''
 
[[File:SmartClient ICX Operation 2.PNG|thumb|left|500px|Stations TAB in operational mode]]
 
<br style="clear:both;" />
 
 
==Additional Information==
 
All Zenitel devices with a camera (TCIV and TCIV+) are certified to ONVIF Profile S. This allows the stations to be discovered by Milestone XProtect.
 
As from VS-IS software version 6.4.3.0, a number of additional capabilities have been added:
 
 
*Support for DeviceIO
 
*Audio Backchannel, meaning audio from Milestone XProtect VMS to the device
 
 
In addition, some other major changes have been made:
 
 
*Audio only stations which can run VS-IS 6.4.3.0 are now able to generate a video stream and are therefore compliant with ONVIF Profile S
 
*As a further enhancement to DeviceIO, station modes are made available as a logical input to the Milestone XProtect VMS and can then trigger function in that Milestone XProtect VMS
 
 
====Non-Video Intercom stations as ONVIF Profile S compliant devices====
 
The stations generate a video stream (a Zenitel logo) and can be discovered as any other camera. As with the TCIV and TCIV+, the microphone is also discovered as a camera capability.
 
 
====Audio backchannel====
 
Milestone XProtect will also discover the presence of the station's loudspeaker. This then gives the possibility for the Milestone XProtect VMS operator to directly send a voice message to the station. This would normally be used when the same message needs to be broadcast to all cameras featuring a loudspeaker and which cannot be reached in the normal Zenitel way, as they are not part of an ICX-AlphaCom, IC-EDGE or SIP system.
 
 
====DeviceIO====
 
VMS's which support this ONVIF feature will be able to discover the presence of all inputs and outputs on the station, this includes Milestone XProtect VMS. Inputs can be used to trigger actions in the Milestone XProtect VMS event handler. Control of the outputs can be triggered directly by the operator, or as an action from the Milestone XProtect VMS event handler.
 
[[File:Support_for_ DeviceIO.png|thumb|left|700px|Support for DeviceIO]]
 
<br clear="all" />
 
=====Report DAK as Digital Input in ONVIF=====
 
Other than the general-purpose inputs which are available on the station, it is possible to have a DAK-button press reported as an input to the Milestone XProtect VMS. This can for instance be used as an additional way of signaling that there is somebody at the door, wanting to talk to the operator. (Turbine stations only, TCIS and TCIV+)
 
 
=====Report station call events as Digital Input in ONVIF=====
 
Stations know the state they are in: in a call, ringing, in call requester mode. This state information is now available to the ONVIF module in the station software and can be used to provide a number of additional 'virtual' inputs. These inputs are discovered through DeviceIO, in the way any physical input is discovered. States that can be signaled to Milestone XProtect are:
 
 
*Call established - Call in progress input Activated
 
*Call ended - Call in progress input Deactivated
 
*Station in ringing mode - both for an outgoing (ringback) and incoming call - Call ringing input Activated
 
*Station ringing mode ended - Call ringing input Deactivated
 
*Station has made a call request or ringing group call (only when the station is in AlphaCom mode) - Call queued input Activated
 
*Station leaves call request or ringing group call mode (only when the station is in AlphaCom mode) - Call queued input Deactivated
 
 
Use cases that can be solved by these inputs are:
 
 
*Switching a camera to a monitor pane at the start of a conversation
 
*Starting and stopping video and/or audio recording
 
*Adding an entry in a the log for audit trail purposes
 
 
=====The order of inputs being reported=====
 
The following order, from first to last, is used to report the different inputs if enabled and available.
 
 
*Call Active
 
*Call Queued
 
*Call Ringing
 
*DAK 1....n
 
*Inputs 1....n
 
 
[[Category:ONVIF]]
 
[[Category:3rd party integration]]
 

Revision as of 15:10, 22 May 2023

Introduction

The Zenitel Cal Handler (IC-Edge) is a plugin that allows users to integrate Milestone XProtect with Zenitel intercom systems. In this guide, we'll walk you through the installation process and explain how to configure the plugin to work with your setup.

Installation

  • Download the zip file containing the plugin from the Zenitel website.
  • Extract the contents of the zip file to a location of your choice.
  • Run the setup file (the MSI or the EXE, depending on your system).
  • When prompted for the installation location, select the Milestone/MIP installation folder (e.g. C:\Program Files\Milestone\MIP).
  • Click "Finish" to complete the installation.


Configuration

Basic plugin configuration

  • Open the XProtect Smart Client.
  • Open the "Configuration" window by clicking the "Configuration" icon in the toolbar.
  • In the "Configuration" window enter the IP address and port number of your Zenitel intercom system acting as the IC-Edge controller in the "IP Address" and "Port" fields, respectively.
  • Click the "Connect" button and wait for the system to retrieve the list of available devices.
  • Select the operator's device by choosing its directory number from the drop-down list.


Animation of the Zenitel Cal Handler configuration process



Associating cameras with devices

  • Open the camera settings window.
  • On the left side, there will be a list of devices registered with the IC-Edge controller. On the right side, there will be a list of cameras registered within the XProtect system.
  • Click on a device in the left list to select it.
  • Click on an item in the right list to preview the video feed from that camera.
  • To associate a camera with a selected device, click the checkbox next to the camera's name.
  • Repeat steps 3-5 to associate additional cameras with the selected device.
  • Once satisfied with the configuration, close the camera settings window.
  • Click "Save and Close" on the configuration window to save the changes.


Screenshot of the camera assosiation process



Using the Call Handler

The Zenitel Cal Handler (IC-Edge) plugin can be used for two scenarios: initiating calls and reacting to inbound calls.

Initiating Calls

In XProtect Smart Client on the Zenitel Audio tab select a device you wish to call and click on the green "Call" button.
A popup window will be displayed showing the active call, along with a video preview from an associated camera.

Screenshot of popup window displaying the active call and associated camera



Answering queued Calls

  • When an inbound call is received, a popup window will be displayed showing the queued call, along with a video preview from an associated camera.
  • To answer the call, the operator has to answer it using a physical device selected as the operator directory number.
  • If there is an active call, the Call Handler will automatically hang up the active call and answer the inbound call.
  • If there are multiple queued calls, they will be displayed in order of priority.


Screenshot of popup window displaying the active call and his associated camera with two queued calls



Using the Popup Window

  • The popup window displays the active call (if it was initiated by the operator) or a list of queued calls, along with a video preview from an associated camera.
  • The popup window will display the camera feed from the first associated camera of the active call (if present) or if there are no active calls, the first queued device-associated camera will be displayed.
  • To manually switch the camera video feed to any active or queued device, select the desired device from the dropdown list in the popup window.
  • To hang up the active call, click the red "Hang-Up" button.
  • To answer a queued call, the operator has to answer it using a physical device selected as the operator directory number.
  • If there are multiple queued calls, they will be displayed in order of priority. To answer a specific queued call, select it from the dropdown list in the popup window.


Previous versions

For configuration of previous versions of the plugin go to: