Milestone XProtect - Expert and Corporate

This article describes how to integrate the AlphaCom XE with the | Milestone XProtect Expert and Corporate 2013 R2 versions.

AlphaCom and Milestone integration

Feature

When a master station receives Call Request from a substation, and when a call is made to the substation, action strings can be sent from the AlphaCom XE to the Milestone system using the AlphaCom's 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 assosiated to the first station in queue will be displayed.

Software requirement:

• AMC 10.56 or higher
• AlphaPro 11.1.3.0 or higher
• Milestone XProtect Expert or Corporate, ver. 2013 R2

Configuration of Milestone XProtect

Example: Server and the Smart Client are running on the same PC (i.e. same IP address)

It is assumed that a Milestone XProtect system is already installed and up and running.

Default TCP port usage

• TCP port 1234: Between 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

Adding new cameras

Adding cameras in general

1. To add a new camera expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
2. In the Overview pane, right-click the required recording server and select Add Hardware...
3. 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 a new camera to the Milestone system

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:

1. Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
2. In the Overview pane, right-click the required recording server and select Add Hardware...
3. Select Manual
4. Enter "DirectShow" as User Name and "DirectShow" as password
5. Scroll down in the device driver list to "Other", where you should check the "DirectShow Driver"
6. Enter the IP-address "0.0.0.1", port 80 and "DirectShow Driver".
7. 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 a DirectShow driver

Adding the camera of the IP Video Station

If the camera of the IP Video Station (item 1401110100) is to be added to the Milestone, follow these steps:

1. Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node.
2. In the Overview pane, right-click the required recording server and select Add Hardware...
3. Select Manual
4. Enter "admin" as User Name and "1234" as password
5. Scroll down in the device driver list to "Universal Driver", where you should check the "Universal Driver"

Selecting "Universal Driver" for the CP-CAM

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:

1. Expand the Servers folder in the Management Client's Site Navigation pane and select the Recording Server node
2. In the Overview pane, select the camera
3. In the "Settings" tab, set:
   1. Connection URI: http://<camera IP address>/mjpg/video.mjpg
   2. Delivery mode: Multipart stream
   3. Retrieval mode: Streaming
   4. Streaming mode: HTTP

Video settings for the CP-CAM

Setting up a Smart Client user

The Smart Client provides remote users with access to the Milestone Image Server.

Create a user

Image Server Administrator: Adding a new user

• Start the Image Server Administrator application. The Image Server is the service handling Smart Client access to the Milestone XProtect Professional system.
• Under "User Administration" select "Full access for all users" and press the button "User Setup"
• Press Add Basic User, and enter a Username (say 'Peter') and a Password (say '6789')
• The server is by default using port 80, this can be changed in the Port field under "Server Configuration"

Smart Client Login

Smart Client login

Start the Smart Client application, and specify your login information in the following fields:

• Server address: Enter the IP address and port number of the server (for example http//:10.5.101.112:80). The Server and the Smart Client may run on the same PC, which is typical for a single user or when used for demos. If they do run on the same PC, use the IP address 127.0.0.1 (i.e. http//:127.0.0.1:80).
• Authentication: Select Basic Authentication
• User name: Enter the username created in the Image Server Administrator, e.g. 'Peter'
• Password: Enter the password created in the Image Server Administrator, e.g. '6789'

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.

---

To see a list of Matrix recipients configured in the Management Client, expand the Client node in the Management Client's Site Navigation pane, then select Matrix. A list of Matrix configurations is displayed in the Properties pane.

The Matrix function is required in order to have live images automatically presented on the required monitor. The Matrix function allows distributed viewing of live video from any camera on any monitor on a network operating with XProtect. A computer on which Matrix-triggered video can be displayed is known as a Matrix recipient. Being able to view Matrix-triggered video requires that either a Smart Client or the dedicated Matrix Monitor software is installed on the user’s computer. This can be a separate computer, or it can be the same computer as running the server.

A Matrix recepient (e.g. a Smart Client) must be defined in the XProtect Professional surveillance system server. Start the Administrator application, and select the Matrix button. The Config tab lets you define individual computers on which it should be possible to view Matrix-triggered content. Enable 'Milestone XProtect Matrix', and enter name, IP address of the matrix recepient, the port number (default 12345) and a password.

---

To add an Matrix recipient through the Management Client, do the following:

1. In the Management Client's Site Navigation pane, expand the Clients node, then select Matrix.
2. In the Management Client's Overview pane, right-click Matrix Configurations and select Add Matrix... This opens the Add Matrix dialog.
3. In the Name field, enter a descriptive name for the Matrix recipient.
4. In the Description field, enter a description of the Matrix recipient.
5. In the Address field enter the IP address or the host name of the required Matrix recipient
6. In the Port field enter the port number used by the Matrix recipient installation.
7. In the Password field enter the Matrix recipient's password. Remember that passwords are case sensitive, i.e. there is a difference between typing amanda and Amanda.

Tip: If in doubt, you can find the port number (default 12345) and password this way: For a Matrix Monitor application, go to the Matrix Monitor’s Configuration dialog. For an XProtect Smart Client, see the separate Matrix Monitor or XProtect Smart Client documentation.

1. In the Type field select the type of Matrix recipient you are adding—a Matrix Monitor or an XProtect Smart Client.

Your system does not verify that the specified port number or password is correct or that the specified port number, password, or type corresponds with the actual Matrix recipient. Therefore, make sure that you enter the information correctly.

1. Click OK to save the settings.

Matrix configuration on server

Smart Client setup as Matrix recepient

To make the Smart Client work as a matrix recepient, start the Smart Client application and select the tab Setup. In the Views right click on the Shared view and add New Group. Once the new group is created, right click and add New View and select the dimensions wanted. In the System Overview selection drag and drop the Matrix icon to the main window. While the main window is in focus, click the button Connection Settings in the Properties selection, and enter port number 12345 and the same password as you entered in the Matrix setup in the Administrator program.

Events

Create Generic Events

EDO strings from the AlphaCom is used to control the pictures in the monitor. When a string sent from the AlphaCom is recognized by the Milestone server, the correct camera should show up in the monitor. We need to decide what string to use for each camera. Here is an example, which is used in this article:

The event "EntranceEvent" will be triggered when receiving the string "Cam101" from the AlphaComE

EDO string/Event message	Camera	Event name	Station dir.no
Cam107	Entrance	EntranceEvent	107
Cam108	Backdoor	BackdoorEvent	108
Cam109	Corridor	CorridorEvent	109
CamOff	All	DisconnectEvent	All stations

Note that the EDO string is using the directory number of the station related to the camera, i.e. the camera of station 108 is triggered by the string "Cam108". This is convenient, as it simplifies the event handler programming in AlphaCom.

The "CamOff" event is used to disconnect cameras from the monitor when there is no conversations and the call queue is empty.

Create generic events in Milestone by selecting Administrator -> Generic Events, and 'Add new event'. Enter an 'Event name' and an 'Event message' according to the table above (or your own table). Add a new event for each camera.

Automatic Matrix Display on Events

In the Administrator -> Matrix window, the Event tab is used for configuring the automatic sending of live video based on predefined events; it lets you define exactly which events and cameras to use. You define this on a per-Matrix recipient basis.

1. In the Matrix window highlight the Matrix recipient, and select Event tab
2. Right-click the Matrix recipient and select 'Generic', then select one of the predefined Generic events
3. Now right-click the event to select which action should take place when the event occurs. Here, select 'Connect'.
4. Right-click the action to select which camera to apply the action on
5. Repeat 1 to 5 as required

Define events

NOTE: For the changes to take effect, you have to quit the Administrator program by pressing the Exit button.

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:

• TouchLine station used for Call Queing
• DualDisplay station used for Call Queing
• CRM IV station

TCP/IP Communication setup

In AlphaPro, Exchange & System -> Serial Ports, the EDO port must be configured to communiate with the computer running the Milestone XProtect server:

EDO port setup. Server IP address is 10.5.101.151, using port 1234

• Port type: TCP/IP Client
• IP address: The IP address of the Milestone XProtect 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 Administrator, I/O Setup -> Advanced -> Alert port.

Note! You might have to open TCP port 1234 in the Windows firewall of the computer running the Milestone server.

(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 assosiated 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 dialled, 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