Difference between revisions of "Milestone XProtect - Expert and Corporate"
From Zenitel Wiki
(→Matrix function) |
|||
(171 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{AI}} |
+ | {{obsolete}} | ||
+ | For integration with Milestone, please see: | ||
+ | * [[Milestone XProtect - ICX-AlphaCom Integration]] | ||
+ | * [[Milestone XProtect - IC-Edge Integration]] | ||
+ | ---- | ||
− | This article describes how to integrate the AlphaCom | + | The integration of ICX or AlphaCom with Milestone XProtect software enables video stream routing under control of commands issued by the ICX or AlphaCom. The interface uses the standard matrix functionality which is part of Milestone XProtect VMS. This article describes how to integrate the ICX or AlphaCom with the [http://www.milestonesys.com/ Milestone] XProtect Expert and Corporate 2014 (7.0c) versions.<br> Integration with the [[Milestone XProtect - Professional and Enterprise|Professional and Enterprise versions]] of XProtect is described in a separate article. |
− | [[Image:Milestone config example.png|thumb|400px|AlphaCom and Milestone integration]] | + | [[Image:Milestone config example.png|thumb|400px|ICX/AlphaCom and Milestone integration]] |
− | == | + | ==Features== |
− | + | The integration allows cameras to be connected to monitors on call and call request events, including changes to the viewed camera when the guard scrolls through the call request queue on the intercom station. | |
− | + | When a master station receives [[Call Request]] from a substation, and when a call is made to the substation, action strings are sent from the ICX/AlphaCom to the Milestone system using the [[EDO|EDO port]]. Using the [[Event Handler]], a few simple events allows control of cameras located in association with a substation. When scrolling the call queue, commands related to the selected station is transmitted, allowing the video on the monitor to follow the queue navigation on the master station. | |
+ | If any new call requests are received while in conversation, this will not influence on the active image. When the conversation is cancelled, and there are still calls in the queue, the image associated to the first station in queue will be displayed. | ||
− | + | ==Licenses == | |
− | + | * When used with the ICX System, the following license is required in the ICX in order to enable the EDO port: 1002602400 - ILI-IF Interface enabling | |
− | |||
− | * | ||
− | == | + | == Default TCP port usage == |
+ | * TCP port 1234: Between ICX/AlphaCom and the Milestone XProtect Server | ||
+ | * TCP port 80: Between the Server and the Smart Client | ||
+ | * TCP port 12345: Used for transferring Matrix-triggered images from the Server to the Smart Client view | ||
[[Image:Milestone config example 2.png|left|thumb|500px|Example: Server and the Smart Client are running on the same PC (i.e. same IP address)]] | [[Image:Milestone config example 2.png|left|thumb|500px|Example: Server and the Smart Client are running on the same PC (i.e. same IP address)]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | |||
+ | |||
+ | == Milestone XProtect configuration == | ||
It is assumed that a Milestone XProtect system is already installed and up and running. | It is assumed that a Milestone XProtect system is already installed and up and running. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
===Adding new cameras=== | ===Adding new cameras=== | ||
Line 31: | Line 36: | ||
# A wizard offers you several ways of detecting and adding cameras. Follow the instructions and consult the Milestone documentation if required (press F1 for online help). | # A wizard offers you several ways of detecting and adding cameras. Follow the instructions and consult the Milestone documentation if required (press F1 for online help). | ||
− | [[File:Milestone | + | [[File:Milestone AddCamera2.PNG|left|thumb|500px|Adding a new camera to the Milestone system]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | |||
==== Adding the DirectShow driver for video in idle ==== | ==== Adding the DirectShow driver for video in idle ==== | ||
Line 42: | Line 46: | ||
# Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | # Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | ||
# In the Overview pane, right-click the required recording server and select '''Add Hardware'''... | # In the Overview pane, right-click the required recording server and select '''Add Hardware'''... | ||
− | # Select '''Manual''' | + | # Select '''Manual''', then '''Add''' |
− | # Enter "DirectShow" as User Name and "DirectShow" as password | + | # Enter "DirectShow" as User Name and "DirectShow" as password, then '''Next''' |
− | # Scroll down in the device driver list to "Other", where you should check the "DirectShow Driver" | + | # Scroll down in the device driver list to "Other", where you should check the "DirectShow Driver", then '''Next''' |
# Enter the IP-address "0.0.0.1", port 80 and "DirectShow Driver". | # Enter the IP-address "0.0.0.1", port 80 and "DirectShow Driver". | ||
# Acknowledge the device channel settings | # Acknowledge the device channel settings | ||
Line 53: | Line 57: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | ==== Adding the camera of the | + | ==== Adding the camera of the Turbine Video Station, TCIV ==== |
− | + | Follow these steps to add the integrated camera of the [[Turbine Video Settings]] to Milestone system: | |
− | |||
# Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | # Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | ||
# In the Overview pane, right-click the required recording server and select '''Add Hardware'''... | # In the Overview pane, right-click the required recording server and select '''Add Hardware'''... | ||
− | # Select '''Manual''' | + | # Select '''Manual''', then press '''Next''', and '''Next''' again |
− | |||
# Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver" | # Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver" | ||
− | [[File:Milestone universal driver.PNG|left|thumb|500px|Selecting "Universal Driver" for the | + | [[File:Milestone universal driver.PNG|left|thumb|500px|Selecting "Universal Driver" for the TCIV camera]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | : | + | :5. Enter the IP-address of the camera, port 8090 and "Universal Driver" |
− | : | + | :6. Press '''Next''' multiple times to complete the wizard |
After the camera has been added, you need to change the video properties: | After the camera has been added, you need to change the video properties: | ||
Line 70: | Line 72: | ||
# In the Overview pane, select the camera | # In the Overview pane, select the camera | ||
# In the "Settings" tab, set: | # In the "Settings" tab, set: | ||
− | ## Connection URI: <nowiki> | + | ## '''Connection URI''': <nowiki>mjpg/video.mjpg</nowiki> |
− | ## Delivery mode: Multipart stream | + | ## '''Delivery mode''': Multipart stream |
− | ## Retrieval mode: Streaming | + | ## '''Retrieval mode''': Streaming |
− | ## Streaming mode: HTTP | + | ## '''Streaming mode''': HTTP |
− | [[File:Milestone | + | [[File:Milestone TCIV CAM.PNG|left|thumb|500px|Video settings for the TCIV camera]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | === | + | ==== Adding the camera of the IP Video Station, model 1401110100 ==== |
− | + | Follow these steps to add the integrated CP-CAM camera of the [[IP Video Door Station|IP Video Station, model 1401110100]] to Milestone system: | |
− | + | # Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | |
− | [[ | + | # In the Overview pane, right-click the required recording server and select '''Add Hardware'''... |
+ | # Select '''Manual''', then '''Next''' | ||
+ | # Enter "admin" as User Name and "1234" as password (this is the default username and password), then '''Next''' | ||
+ | # Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver" | ||
+ | [[File:Milestone universal driver.PNG|left|thumb|500px|Selecting "Universal Driver" for the CP-CAM]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | :6. Enter the IP-address of the camera, port 80 and "Universal Driver" | ||
+ | :7. Press '''Next''' multiple times to complete the wizard | ||
− | + | After the camera has been added, you need to change the video properties: | |
− | + | # Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node | |
− | + | # In the Overview pane, select the camera | |
− | + | # In the "Settings" tab, set: | |
− | + | ## '''Connection URI''': <nowiki>mjpg/video.mjpg</nowiki> | |
+ | ## '''Delivery mode''': Multipart stream | ||
+ | ## '''Retrieval mode''': Streaming | ||
+ | ## '''Streaming mode''': HTTP | ||
− | + | [[File:Milestone CPCAM.PNG|left|thumb|500px|Video settings for the CP-CAM]] | |
− | [[ | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | + | ==== Adding the camera of the IP Video Station, model 1401110200 ==== | |
− | + | The [[IP Video Door Station - 1401110200|IP Video Station, model 1401110200]] has an integrated Axis camera which can be added to the to Milestone system. Follow these steps: | |
− | + | # Expand the '''Servers''' folder in the Management Client's Site Navigation pane and select the '''Recording Server''' node. | |
− | + | # In the Overview pane, right-click the required recording server and select '''Add Hardware'''... | |
− | + | # Select '''Express''', then '''Add''' | |
+ | # Enter "admin" as User Name and "1234" as password (this is the default username and password), then '''Next''' | ||
+ | # The Axis camera should now be automatically discovered by the Milestone software: | ||
+ | [[File:Milestone AddAxis.PNG|left|thumb|500px|Axis camera discovered]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | :6. Press '''Next''' multiple times to complete the wizard | ||
− | ===Matrix function=== | + | ===The Matrix function=== |
− | + | With Matrix — an integrated solution for distributed viewing of video — you can send video from any camera on a network operating your system to Matrix recipients. A Matrix recipient is basically a computer capable of displaying Matrix-triggered video. There are two kinds of Matrix recipients: computers running a dedicated Matrix Monitor application and computers running the XProtect Smart Client. | |
+ | ==== Adding a Matrix recipient in the Management Client ==== | ||
+ | To add an Matrix recipient through the Management Client, do the following: | ||
+ | # In the Management Client's Site Navigation pane, expand the '''Client''' node, then select '''Matrix'''. | ||
+ | # In the Management Client's Overview pane, right-click '''Matrix Configurations''' and select '''Add Matrix'''... This opens the Add Matrix dialog. | ||
+ | # In the '''Name''' field, enter a descriptive name for the Matrix recipient. | ||
+ | # In the '''Description''' field, enter a description of the Matrix recipient. | ||
+ | # In the '''Address''' field enter the IP address or the host name of the required Matrix recipient | ||
+ | # In the '''Port''' field enter the port number used by the Matrix recipient installation. Default is 12345. | ||
+ | # In the '''Password''' field enter the Matrix recipient's password, e.g. 12345. | ||
+ | # In the '''Type''' field select the type of Matrix recipient you are adding—a Matrix Monitor or an XProtect Smart Client. | ||
+ | # Click '''OK''' to save the settings. | ||
− | [[File:Milestone | + | [[File:Milestone AddMatrix.PNG|left|thumb|500px|Adding a Matrix recipient]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | ==== Setting the Smart Client to work as a matrix recipient ==== | ||
+ | To make the''' Smart Client''' work as a matrix recipient, do the following steps: | ||
+ | # Start the '''Smart Client''' application and select the tab '''Setup''' | ||
+ | # In the '''Views''' pane, right click on the '''Private''' view and add '''New Group'''. | ||
+ | # Once the new group is created, right click and add '''New View''' and select the dimensions wanted. E.g. 4:3, 1x1. | ||
+ | # In the '''System Overview''' pane, drag and drop the '''Matrix''' item to the main window. | ||
+ | # While the main window is in focus, scroll down and click the button '''Connection Settings''' in the '''Properties''' pane, and enter port number 12345 and the same password as you entered in the Matrix setup in the Management Client. | ||
− | + | [[File:Milestone Smart Client.PNG|left|thumb|500px|Smart Client setup as Matrix recipient. Drag and drop the '''Matrix''' item to the main window, and set communication parameters in '''Connection Settings''']] | |
− | [[ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | === Events === | + | === Generic Events === |
− | + | ==== Adding Generic Events ==== | |
− | ==== | + | Generic events allow you to trigger actions in the Milestone XProtect event server by sending simple strings from the ICX or AlphaCom via the IP network to the Milestone event server. The [[Event Handler]] is used to generate strings transmitted via the [[EDO|EDO port]]. In this article the string is on the format "CamXXX", where XXX is the directory number of the station associated with the camera. Using the directory number as a part of the string is convenient, as it simplifies the event handler programming. But the syntax of the string is freely programmable. |
− | |||
− | |||
− | |||
+ | Examples: | ||
{| border="1" | {| border="1" | ||
− | ! style="background:#ffdead;" width="170" |EDO string | + | ! style="background:#ffdead;" width="170" |EDO string |
! style="background:#ffdead;" width="70" |Camera | ! style="background:#ffdead;" width="70" |Camera | ||
! style="background:#ffdead;" width="130" |Event name | ! style="background:#ffdead;" width="130" |Event name | ||
! style="background:#ffdead;" width="100" |Station dir.no | ! style="background:#ffdead;" width="100" |Station dir.no | ||
|- | |- | ||
− | | Cam107 || align=center | Entrance || align=center | | + | | Cam107 || align=center | Entrance || align=center | Cam107|| align=center |107 |
|- | |- | ||
− | | Cam108 || align=center | Backdoor|| align=center | | + | | Cam108 || align=center | Backdoor|| align=center | Cam108|| align=center |108 |
|- | |- | ||
− | | Cam109 || align=center | Corridor|| align=center | | + | | Cam109 || align=center | Corridor|| align=center | Cam109|| align=center |109 |
|- | |- | ||
− | | CamOff || align=center | All|| align=center | | + | | CamOff || align=center | All|| align=center | CamOff || align=center | All stations |
|- | |- | ||
|} | |} | ||
− | |||
− | The "CamOff" event is used to disconnect cameras from the | + | The "CamOff" event is used to disconnect cameras from the Smart Client when there is no conversations and the call queue is empty. |
+ | |||
+ | To add Generic Events from the Management Client, do the following: | ||
+ | # In the Management Client's Site Navigation pane, expand the '''Rules and Events''' node, then select '''Generic Events'''. | ||
+ | # In the Management Client's Overview pane, right-click '''Generic Events''' and select '''Add New'''... This opens the Add New dialog. | ||
+ | # In the '''Name''' field, enter a descriptive name for the event, e.g. '''Cam107'''. | ||
+ | # In the '''Expression''' field, enter the actual string in quotes ("..."), as received from ICX/AlphaCom. E.g. '''"Cam107"'''. | ||
+ | # In the '''Expression type''' select "Search" | ||
+ | # In the '''Data source''' field select "Compatible" | ||
+ | # In the '''Priority''' set to "1" | ||
+ | |||
+ | |||
+ | [[File:Milestone AddGenericEvents.PNG|left|thumb|500px|Adding generic event "Cam107" for station 107]] | ||
+ | <br style="clear:both;" /> | ||
+ | |||
+ | '''Important note!''' Generic events have no authentication. This makes them easier to trigger but, to avoid jeopardizing security, only events from local host are accepted. You can however allow other client IP addresses from '''Tools''' > '''Options''' menu > '''Generic Events''' tab. The ICX/AlphaCom IP address must be entered as a legal IP address. | ||
+ | |||
+ | [[File:Milestone Generic Event filter.PNG|left|thumb|500px|Allow reception of generic events from ICX/AlphaCom with IP address 10.5.101.30]] | ||
+ | <br style="clear:both;" /> | ||
+ | |||
+ | ==== Creating rules ==== | ||
+ | We need to create a rule, saying that when the Milestone event server receives a generic event from the ICX/AlphaCom, the video from a certain camera should pop up in a certain Smart Client. To define actions on events we use the event rule engine. | ||
+ | |||
+ | From the Management Client, do the following: | ||
+ | # In the Management Client's Site Navigation pane, expand the '''Rules and Events''' node, then select '''Rules'''. | ||
+ | # In the Management Client's Overview pane, right-click '''Rules''' and select '''Add Rule'''... This opens the Add Rule dialog. | ||
+ | # In the '''Step 1 - Type of Rule''': | ||
+ | ## In the '''Name''' field, enter a descriptive name, e.g. '''"Cam107"'''. | ||
+ | ## In the '''Select the type of rule you want to create''' field choose "Perform an action on <event>" | ||
+ | ## In the '''Edit rule description''' field click on '''event''', and scroll down to '''External Event''', then select '''Generic Event''', then select the relevant event, e.g. '''Cam107''' | ||
+ | ## Select '''Next''' | ||
+ | # Skip '''Step 2 - Conditions''' by clicking '''Next''' | ||
+ | # In the '''Step 3 - Actions''': | ||
+ | ## Enable '''Set Matrix to view <devices>''' | ||
+ | ## In the '''Edit rule description''' field click on '''Matrix''' and select the wanted Matrix recipient | ||
+ | ## In the '''Edit rule description''' field click on '''devices''' and select the wanted camera | ||
+ | ## Select '''Next''' | ||
+ | # Skip '''Step 4 - Stop criteria''' by clicking '''Finnish''' | ||
− | + | You should now have a rule looking something like this: | |
+ | |||
+ | [[File:Milestone AddRules.PNG|left|thumb|500px|Rule: When generic event Cam107 is received from external, show the video from camera 10.5.101.35 in the Matrix "Control Room"]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | + | Continue to create a rule for every camera in the system. | |
− | + | ||
− | + | You also need to create one common rule to remove the video image when a call is ended. This is done by switching the matrix to the "DirectShow virtual video", which has no video feed, when the string for disconnection of video (e.g. "CamOff") is received. | |
− | + | ||
− | + | [[File:Milestone AddRuleOff.PNG|left|thumb|500px|Rule: When generic event CamOff is received from external, show the video from virtual camera 0.0.0.1 in the Matrix "Control Room". This camera has no video feed, and the Smart Client will go in black]] | |
− | |||
− | |||
− | [[ | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | ''' | + | ==== Testing Generic Events ==== |
+ | One can test that the generic events are operational with a small program called [[Downloads#Useful_Tools|Generic Event tester]]. This makes to possible to verify the Milestone configuration, totally independent of the ICX/AlphaCom. | ||
+ | |||
+ | * '''Host''': Enter "localhost" if the GenericEventTester is running on the same computer as the Milestone server. If the GenericEventTester is running on a remote computer, enter the IP address of the Milestone server. | ||
+ | * '''Port''': The port number used by the Milestone event server for Generic Events. Default is 1234. | ||
+ | * '''Event''': The generic event string, e.g. '''Cam107''' or '''CamOff''', as defined in the "Expression" field of the Generic Event. | ||
+ | * Press '''Send Tcp''' to send the event string to Milestone. The actions as defined by the ''Rules'' should now be executed. | ||
+ | |||
+ | [[File:Milestone Generic Event test.PNG|left|thumb|500px|Test software for the generic events]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | ==AlphaCom configuration== | + | Note that if you run the GenericEventsTester on a remote computer, you have give access from the Milestone Management Client for that computers IP address in '''Tools''' > '''Options''' menu > '''Generic Events''' tab. |
+ | |||
+ | ==ICX or AlphaCom configuration== | ||
=== Configure the Master station for Call Queueing=== | === Configure the Master station for Call Queueing=== | ||
A number of different station types can be used for call queuing. The station should use the [[Mail Queue Operation|763x codes]] for queue navigation. These directory numbers should be assigned to [[DAK]] keys. The station should be prepared for call queue operation, how to do this depends on the station type used: | A number of different station types can be used for call queuing. The station should use the [[Mail Queue Operation|763x codes]] for queue navigation. These directory numbers should be assigned to [[DAK]] keys. The station should be prepared for call queue operation, how to do this depends on the station type used: | ||
Line 170: | Line 237: | ||
=== TCP/IP Communication setup === | === TCP/IP Communication setup === | ||
− | In AlphaPro, '''Exchange & System''' -> '''Serial Ports''', the EDO port must be configured to | + | In AlphaPro, '''Exchange & System''' -> '''Serial Ports''', the EDO 1 port must be configured to communicate with the computer running the Milestone XProtect server: |
− | [[Image:Milestone EDO config.PNG|left|thumb|500px|EDO port setup. | + | [[Image:Milestone EDO config.PNG|left|thumb|500px|EDO port setup. Milestone server IP address is 10.5.101.151, using port 1234]] |
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | * Port type: TCP/IP Client | + | * '''Port type''': TCP/IP Client |
− | * IP address: The IP address of the Milestone XProtect server | + | * '''IP address''': The IP address of the Milestone XProtect event server |
− | * Port: 1234 | + | * '''Port''': 1234 |
− | * Enable | + | * Enable '''Connect at AlphaCom write, disconnect after each write''' |
− | The Milestone XProtect Server is by default using TCP port 1234 for generic events. If required this port number can be modified from Milestone XProtect | + | The Milestone XProtect Server is by default using TCP port 1234 for generic events. If required this port number can be modified from Milestone XProtect Mangement Client, '''Tools''' -> '''Options''' -> '''Generic Events''' tab -> '''Port'''. |
'''Note!''' You might have to open TCP port 1234 in the Windows firewall of the computer running the Milestone server. | '''Note!''' You might have to open TCP port 1234 in the Windows firewall of the computer running the Milestone server. | ||
− | + | * '''Windows 7:''' Start > Control Panel > Windows Firewall > Advanced settings > Inbound rules > New Rule > Port > Select port type '''TCP'''. Specific local ports: '''1234''' > Enable '''Allow the connection'''. Name: Milestone. | |
+ | * '''Windows XP:''' Start > Control Panel > Windows Firewall > Exceptions tab > Add Port: Select port type '''TCP'''. Name: Milestone. Port number: '''1234''' | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 254: | Line 322: | ||
------------------ | ------------------ | ||
− | '''Event 4''' - When receiving a Call Request or scrolling the queue, and the master station is not busy, activate the camera | + | '''Event 4''' - When receiving a Call Request or scrolling the queue, and the master station is not busy, activate the camera associated with the selected substation. |
{| | {| | ||
|- | |- | ||
Line 280: | Line 348: | ||
------------------ | ------------------ | ||
− | '''Event 5''' - The Priority Mail Present - OFF event is triggered when the queue of the master station is empty. The queue can become empty because the delete code 7630 has been | + | '''Event 5''' - The Priority Mail Present - OFF event is triggered when the queue of the master station is empty. The queue can become empty because the delete code 7630 has been dialed, in that case the cameras should be turned off. Or the queue can become empty because of call back to the last substation in queue, in that case we want the camera to remain on until the conversation is cancelled. We start a 0.5 second timer, and check if the master station is in conversation when the timer times out: |
{| | {| | ||
|- | |- | ||
Line 322: | Line 390: | ||
== Related links and articles == | == Related links and articles == | ||
* [{{SERVER}}/alphawiki/downloads/GenericEventTest.exe Generic_Event_tester] | * [{{SERVER}}/alphawiki/downloads/GenericEventTest.exe Generic_Event_tester] | ||
+ | * Integration with the [[Milestone XProtect - Professional and Enterprise|Professional and Enterprise versions]] of Milestone XProtect | ||
− | + | [[Category:Discontinued Products]] | |
− | |||
− | [[Category: | ||
− | |||
− | |||
− | |||
− |
Latest revision as of 08:51, 16 August 2022
For integration with Milestone, please see:
The integration of ICX or AlphaCom with Milestone XProtect software enables video stream routing under control of commands issued by the ICX or AlphaCom. The interface uses the standard matrix functionality which is part of Milestone XProtect VMS. This article describes how to integrate the ICX or AlphaCom with the Milestone XProtect Expert and Corporate 2014 (7.0c) versions.
Integration with the Professional and Enterprise versions of XProtect is described in a separate article.
Contents
Features
The integration allows cameras to be connected to monitors on call and call request events, including changes to the viewed camera when the guard scrolls through the call request queue on the intercom station.
When a master station receives Call Request from a substation, and when a call is made to the substation, action strings are sent from the ICX/AlphaCom to the Milestone system using the EDO port. Using the Event Handler, a few simple events allows control of cameras located in association with a substation. When scrolling the call queue, commands related to the selected station is transmitted, allowing the video on the monitor to follow the queue navigation on the master station.
If any new call requests are received while in conversation, this will not influence on the active image. When the conversation is cancelled, and there are still calls in the queue, the image associated to the first station in queue will be displayed.
Licenses
- When used with the ICX System, the following license is required in the ICX in order to enable the EDO port: 1002602400 - ILI-IF Interface enabling
Default TCP port usage
- TCP port 1234: Between ICX/AlphaCom and the Milestone XProtect Server
- TCP port 80: Between the Server and the Smart Client
- TCP port 12345: Used for transferring Matrix-triggered images from the Server to the Smart Client view
Milestone XProtect configuration
It is assumed that a Milestone XProtect system is already installed and up and running.
Adding new cameras
Adding cameras in general
- To add a new camera expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
- In the Overview pane, right-click the required recording server and select Add Hardware...
- A wizard offers you several ways of detecting and adding cameras. Follow the instructions and consult the Milestone documentation if required (press F1 for online help).
Adding the DirectShow driver for video in idle
When the master station is in idle, and there is no video to show, the Smart Client must be connected to a virtual camera with no video. A "DirectShow driver" can be installed to the Recording Server, and will provide 8 video channels. Each of the channels can be set to a DirectShow device, which can be a local/USB web camera, an AVI- video file or empty (not configured). Install the DirectShow driver with: "0.0.0.1" as IP-address and "DirectShow" as password.
Installing the "DirectShow" driver:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
- In the Overview pane, right-click the required recording server and select Add Hardware...
- Select Manual, then Add
- Enter "DirectShow" as User Name and "DirectShow" as password, then Next
- Scroll down in the device driver list to "Other", where you should check the "DirectShow Driver", then Next
- Enter the IP-address "0.0.0.1", port 80 and "DirectShow Driver".
- Acknowledge the device channel settings
After device has been added, you can specify what to show for each camera channel in ‘Settings’ in the Properties pane..
Adding the camera of the Turbine Video Station, TCIV
Follow these steps to add the integrated camera of the Turbine Video Settings to Milestone system:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
- In the Overview pane, right-click the required recording server and select Add Hardware...
- Select Manual, then press Next, and Next again
- Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver"
- 5. Enter the IP-address of the camera, port 8090 and "Universal Driver"
- 6. Press Next multiple times to complete the wizard
After the camera has been added, you need to change the video properties:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node
- In the Overview pane, select the camera
- In the "Settings" tab, set:
- Connection URI: mjpg/video.mjpg
- Delivery mode: Multipart stream
- Retrieval mode: Streaming
- Streaming mode: HTTP
Adding the camera of the IP Video Station, model 1401110100
Follow these steps to add the integrated CP-CAM camera of the IP Video Station, model 1401110100 to Milestone system:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
- In the Overview pane, right-click the required recording server and select Add Hardware...
- Select Manual, then Next
- Enter "admin" as User Name and "1234" as password (this is the default username and password), then Next
- Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver"
- 6. Enter the IP-address of the camera, port 80 and "Universal Driver"
- 7. Press Next multiple times to complete the wizard
After the camera has been added, you need to change the video properties:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node
- In the Overview pane, select the camera
- In the "Settings" tab, set:
- Connection URI: mjpg/video.mjpg
- Delivery mode: Multipart stream
- Retrieval mode: Streaming
- Streaming mode: HTTP
Adding the camera of the IP Video Station, model 1401110200
The IP Video Station, model 1401110200 has an integrated Axis camera which can be added to the to Milestone system. Follow these steps:
- Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
- In the Overview pane, right-click the required recording server and select Add Hardware...
- Select Express, then Add
- Enter "admin" as User Name and "1234" as password (this is the default username and password), then Next
- The Axis camera should now be automatically discovered by the Milestone software:
- 6. Press Next multiple times to complete the wizard
The Matrix function
With Matrix — an integrated solution for distributed viewing of video — you can send video from any camera on a network operating your system to Matrix recipients. A Matrix recipient is basically a computer capable of displaying Matrix-triggered video. There are two kinds of Matrix recipients: computers running a dedicated Matrix Monitor application and computers running the XProtect Smart Client.
Adding a Matrix recipient in the Management Client
To add an Matrix recipient through the Management Client, do the following:
- In the Management Client's Site Navigation pane, expand the Client node, then select Matrix.
- In the Management Client's Overview pane, right-click Matrix Configurations and select Add Matrix... This opens the Add Matrix dialog.
- In the Name field, enter a descriptive name for the Matrix recipient.
- In the Description field, enter a description of the Matrix recipient.
- In the Address field enter the IP address or the host name of the required Matrix recipient
- In the Port field enter the port number used by the Matrix recipient installation. Default is 12345.
- In the Password field enter the Matrix recipient's password, e.g. 12345.
- In the Type field select the type of Matrix recipient you are adding—a Matrix Monitor or an XProtect Smart Client.
- Click OK to save the settings.
Setting the Smart Client to work as a matrix recipient
To make the Smart Client work as a matrix recipient, do the following steps:
- Start the Smart Client application and select the tab Setup
- In the Views pane, right click on the Private view and add New Group.
- Once the new group is created, right click and add New View and select the dimensions wanted. E.g. 4:3, 1x1.
- In the System Overview pane, drag and drop the Matrix item to the main window.
- While the main window is in focus, scroll down and click the button Connection Settings in the Properties pane, and enter port number 12345 and the same password as you entered in the Matrix setup in the Management Client.
Generic Events
Adding Generic Events
Generic events allow you to trigger actions in the Milestone XProtect event server by sending simple strings from the ICX or AlphaCom via the IP network to the Milestone event server. The Event Handler is used to generate strings transmitted via the EDO port. In this article the string is on the format "CamXXX", where XXX is the directory number of the station associated with the camera. Using the directory number as a part of the string is convenient, as it simplifies the event handler programming. But the syntax of the string is freely programmable.
Examples:
EDO string | Camera | Event name | Station dir.no |
---|---|---|---|
Cam107 | Entrance | Cam107 | 107 |
Cam108 | Backdoor | Cam108 | 108 |
Cam109 | Corridor | Cam109 | 109 |
CamOff | All | CamOff | All stations |
The "CamOff" event is used to disconnect cameras from the Smart Client when there is no conversations and the call queue is empty.
To add Generic Events from the Management Client, do the following:
- In the Management Client's Site Navigation pane, expand the Rules and Events node, then select Generic Events.
- In the Management Client's Overview pane, right-click Generic Events and select Add New... This opens the Add New dialog.
- In the Name field, enter a descriptive name for the event, e.g. Cam107.
- In the Expression field, enter the actual string in quotes ("..."), as received from ICX/AlphaCom. E.g. "Cam107".
- In the Expression type select "Search"
- In the Data source field select "Compatible"
- In the Priority set to "1"
Important note! Generic events have no authentication. This makes them easier to trigger but, to avoid jeopardizing security, only events from local host are accepted. You can however allow other client IP addresses from Tools > Options menu > Generic Events tab. The ICX/AlphaCom IP address must be entered as a legal IP address.
Creating rules
We need to create a rule, saying that when the Milestone event server receives a generic event from the ICX/AlphaCom, the video from a certain camera should pop up in a certain Smart Client. To define actions on events we use the event rule engine.
From the Management Client, do the following:
- In the Management Client's Site Navigation pane, expand the Rules and Events node, then select Rules.
- In the Management Client's Overview pane, right-click Rules and select Add Rule... This opens the Add Rule dialog.
- In the Step 1 - Type of Rule:
- In the Name field, enter a descriptive name, e.g. "Cam107".
- In the Select the type of rule you want to create field choose "Perform an action on <event>"
- In the Edit rule description field click on event, and scroll down to External Event, then select Generic Event, then select the relevant event, e.g. Cam107
- Select Next
- Skip Step 2 - Conditions by clicking Next
- In the Step 3 - Actions:
- Enable Set Matrix to view <devices>
- In the Edit rule description field click on Matrix and select the wanted Matrix recipient
- In the Edit rule description field click on devices and select the wanted camera
- Select Next
- Skip Step 4 - Stop criteria by clicking Finnish
You should now have a rule looking something like this:
Continue to create a rule for every camera in the system.
You also need to create one common rule to remove the video image when a call is ended. This is done by switching the matrix to the "DirectShow virtual video", which has no video feed, when the string for disconnection of video (e.g. "CamOff") is received.
Testing Generic Events
One can test that the generic events are operational with a small program called Generic Event tester. This makes to possible to verify the Milestone configuration, totally independent of the ICX/AlphaCom.
- Host: Enter "localhost" if the GenericEventTester is running on the same computer as the Milestone server. If the GenericEventTester is running on a remote computer, enter the IP address of the Milestone server.
- Port: The port number used by the Milestone event server for Generic Events. Default is 1234.
- Event: The generic event string, e.g. Cam107 or CamOff, as defined in the "Expression" field of the Generic Event.
- Press Send Tcp to send the event string to Milestone. The actions as defined by the Rules should now be executed.
Note that if you run the GenericEventsTester on a remote computer, you have give access from the Milestone Management Client for that computers IP address in Tools > Options menu > Generic Events tab.
ICX or AlphaCom configuration
Configure the Master station for Call Queueing
A number of different station types can be used for call queuing. The station should use the 763x codes for queue navigation. These directory numbers should be assigned to DAK keys. The station should be prepared for call queue operation, how to do this depends on the station type used:
TCP/IP Communication setup
In AlphaPro, Exchange & System -> Serial Ports, the EDO 1 port must be configured to communicate with the computer running the Milestone XProtect server:
- Port type: TCP/IP Client
- IP address: The IP address of the Milestone XProtect event server
- Port: 1234
- Enable Connect at AlphaCom write, disconnect after each write
The Milestone XProtect Server is by default using TCP port 1234 for generic events. If required this port number can be modified from Milestone XProtect Mangement Client, Tools -> Options -> Generic Events tab -> Port.
Note! You might have to open TCP port 1234 in the Windows firewall of the computer running the Milestone server.
- Windows 7: Start > Control Panel > Windows Firewall > Advanced settings > Inbound rules > New Rule > Port > Select port type TCP. Specific local ports: 1234 > Enable Allow the connection. Name: Milestone.
- Windows XP: Start > Control Panel > Windows Firewall > Exceptions tab > Add Port: Select port type TCP. Name: Milestone. Port number: 1234
Event Handler configuration
UDP Groups:
- Include all substations with cameras in UDP group 2.
Event Handler configuration:
The Event Handler is used to transmit commands through the EDO port to the Milestone IP Video system.
In AlphaPro, go to Exchange and System -> Events, press Insert and create the following events:
Event 1 - An UDD is used to store the busy/free status of the master station. 0 = free, 1 = in conversation. The index of the UDD is equal to the physical number of the master station. The UDD is checked when call requests are received or deleted. If the station is in use, cameras should not be turned on (i.e. no commands should be transmitted).
Event Owner: | The Master Station |
Event type: | 08 - Conversation Outgoing |
When change to: | ON or OFF |
When related to: | All |
Action: | WUDD %1.phy %chg(1,0) |
Event 2 - When a conversation is made from the master station to a substation w. camera, transmit command "CamXXX" to the IP Video system, where XXX = the directory number of the substation.
Event Owner: | The Master Station |
Event type: | 08 - Conversation Outgoing |
Subevent: | 0 |
When change to: | ON |
When related to: | Stations w. UDP, Id: 2 |
Action: | EDO 1 "Cam%2.dir" |
Event 3 - When the conversation between the master and any station cancels, switch off the camera ("CamOff"), and activate the MAILQ_NAVIG command. The MAILQ_NAVIG command will step to the first in the queue, and re-trigger the '23 - New Current Mail' event.
Event Owner: | The Master Station |
Event type: | 08 - Conversation Outgoing |
Subevent: | 0 |
When change to: | OFF |
When related to: | All |
Action: | EDO 1 "CamOff" |
$MAILQ_NAVIG L%1.dir 2 |
Event 4 - When receiving a Call Request or scrolling the queue, and the master station is not busy, activate the camera associated with the selected substation.
Event Owner: | The Master Station |
Event type: | 23 - New Current Mail |
Subevent: | 0 |
When change to: | ON |
When related to: | Stations w. UDP, Id: 2 |
Action: | IF %udd(%1.phy) |
STOP | |
ENDIF | |
EDO 1 "Cam%2.dir" |
Event 5 - The Priority Mail Present - OFF event is triggered when the queue of the master station is empty. The queue can become empty because the delete code 7630 has been dialed, in that case the cameras should be turned off. Or the queue can become empty because of call back to the last substation in queue, in that case we want the camera to remain on until the conversation is cancelled. We start a 0.5 second timer, and check if the master station is in conversation when the timer times out:
Event Owner: | The Master Station |
Event type: | 06 - Priority Mail Present |
When change to: | OFF |
Action: | $ST L%1.dir w5 L9999 |
Event 6 - Half a second after the queue was empty, check if the station is in conversation, if not switch off the camera:
Event Owner: | The Master Station |
Event type: | 21 - Event Timeout |
Subevent: | 0 |
When change to: | ON |
When related to: | Directory number: 9999 |
Action: | IF %udd(%1.phy) |
STOP | |
ENDIF | |
EDO 1 "CamOff" |
Related links and articles
- Generic_Event_tester
- Integration with the Professional and Enterprise versions of Milestone XProtect