pelco videoxpert plugin - partner...

Pelco VideoXpert Plugin

www.cortech.co.uk

Software Manual

Datalog MV

1264Product Code:

All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, ormechanical, including photocopying, recording, taping, or information storage and retrieval systems - without thewritten permission of the publisher.

Products that are referred to in this document may be either trademarks and/or registered trademarks of therespective owners. The publisher and the author make no claim to these trademarks.

While every precaution has been taken in the preparation of this document, the publisher and the author assume noresponsibility for errors or omissions, or for damages resulting from the use of information contained in thisdocument or from the use of programs and source code that may accompany it. In no event shall the publisher andthe author be liable for any loss of profit or any other commercial damage caused or alleged to have been causeddirectly or indirectly by this document.

Printed: October 2017

Pelco VideoXpert Plugin

© 2017 Cortech Developments Ltd

Cortech Middle East DMCCOffice 405, JBC1, Cluster GJumeirah Lake TowersDubaiUnited Arad Emirates

Tel. +971 (0) 44 524 256Email. [email protected]

www.cortech.ae

Cortech Developments LtdThe BarnBrook House FarmWithers LaneHigh LeghKnutsfordCheshireWA16 0SG

Tel. +44(0)1925 750 600Email. [email protected]

www.cortech.co.uk

3Contents

Table of Contents

Part I Introduction 4

Part II Installation 4

Part III Configuration 5

Part IV Camera Configuration 8

Part V Streaming Video 9

Part VI PTZ Functionallity 10

Part VII Alarm Events 10

Part VIII Monitor Wall 11

Part IX Trouble Shooting 11

4 Pelco VideoXpert Plugin

1 IntroductionA plugin is available to integrate with the Pelco VideoXpert system.

The plugin uses the Pelco VideoXpert SDK v2.0.0.14.

2 InstallationThe Pelco VideoXpert SDK needs to be installed on the same PC running Datalog MV.

An installation program is available called "Pelco VideoXpert v2.0.EXE".

Run the program and follow the onscreen instructions.

Once the SDK is installed the following files (distributed as part of the plugin package) need to becopied into the following folder, c:\Pelco VideoXpert\MediaController\ThirdParty\GStreamer\1.8.1\x86\gstreamer_runtime\bin\ (assuming the Pelco SDK was installed to it's default location):

PelcoVideoXpertWrapper.dllCSharpWrapper.dll

Open a command prompt with administrator privileges and browse to the above installation folder.Then run the Register.bat.

Ensure the file, PelcoVideoXpertModule.dll is copied in the Datalog MV plugins folder, c:\DatalogMV\Plugins\.

Right click on the Datalog MV icon in the Windows system tray and from the popup menu select,Configuration and Licensing. From the Plugin Licensing window, right lick on the Pelco VideoXpertitem and select General Settings.

The following window will appear:

5Installation

Installation Path - the root folder of the where the Pelco VideoXpert SDK has been installed to. Ifthe SDK has been installed to a different folder from the default, the enter here the path to wherethe SDK has been installed.

The folder structure of the SDK must bec:\<Root Folder Name, Default "Pelco VideoXpert">\MediaController\ThirdParty\GStreamer\1.8.1\x86\gstreamer_runtime\bin

If this path is wrong, then the plugin will not be able to stream any video.

Maximum Number of Video Streams - The maximum number of simultaneous video streams thatcan be displayed in MV using the Pelco VideoXpert plugin. This number includes both live and replayvideo streams. Please see Streaming Video for further details. If the video of number of videostreams is exceeded, the relevant video segment within MV will inform the operator that themaximum number of streams has been reached.

3 ConfigurationThe configuration of the Pelco VideoXpert plugin is based around five main sections, Devices,Cameras, Monitors, Alarm Inputs and Outputs, further details on what each of the sections representis detailed below.

To access the configuration of the Pelco VideoXpert plugin right click on the Datalog MV icon in theWindows system tray and from the popup menu select, Configuration and Licensing. The followingwindow will then appear.


The initial task is to add a Device or Devices to each of the Pelco NVRs. Expand the Pelco VideoXpertbranch as per the window above and right click the on Devices item. From the popup menu selectAdd Device.

7Configuration

Enter in each row of the table above the connection details for each of the Pelco devices that are tobe connected. The number of rows in the table will keep automatically increasing as required. If amistake is made and a row is populated that isn't need, simply remove the details entered into thatrow and the device will not be added into Datalog MV.

IP Address - the IP address of the Pelco device.User Name - user name to login to the Pelco device.Password - password to login to the Pelco device.

Once all the parameters above have been entered, click Ok, a prompt will be displayed warning theoperator that a restart of the plugin is required. To restart the plugin, right-click on the PelcoVideoXpert in the tree and select Restart.

Once the plugin has restarted Datalog MV will connect to the Pelco devices and obtain a full list ofcameras and monitors. The cameras will then appear under the Sources branch as below and


monitors will appear under the Monitor branch.

A Device can be changed or removed at any time. Select the relevant device from the list, right-clickand from the popup menu select either Edit or Delete Item as appropriate. If a Device is deleted, theassociated cameras with that device will also be deleted.

Ple a se Note : whe ne v e r the e d it window is ope n fo r the p lug in o r a ny popup m e ssa ge sbox e s tha t a re v is ib le , th is will p re v e nt a ny ca m e ra se le ctions o r a ny a ctions be ingca rr ie d out with in Da ta log MV until the window is close d .

4 Camera ConfigurationTo access the configuration of the Pelco VideoXpert plugin right click on the Datalog MV icon in theWindows system tray and from the popup menu select, Configuration and Licensing. The PluginLicensing window will appear displaying all the Plugin Information. Within the tree navigate to thePelco VideoXpert branch, then Sources. This will display list of all the cameras which are availablewithin the Pelco VideoXpert plugin. Select the relevant camera from the list, right click and select Editand the following window will appear:

9Camera Configuration

Primary Stream - Primary video stream for this camera. Defaults to the first video streamreported by the VideoXpert SDK. Please note, this may not be the primary stream configured on thephysical camera.Secondary Stream - Secondary video stream for this camera, if available. Defaults to the secondvideo stream reported by the VideoXpert SDK. Please note, this may not be the secondary streamconfigured on the physical camera.

Please refer to the Streaming Video section for further details regarding primary and secondstreams.

Alarm HandlingReport Motion Alarms - when selected Video Motion alarms will be reported for his camera. Alsorequires the camera to be configure to report motion alarms.Report Analytics Alarms - when selected Video Analytics alarms will be reported for his camera.Also requires analytic rules to be configured on the camera.

5 Streaming VideoMulticast and UnicastThe Pelco VideoXpert plugin supports streaming of video in either multicast or unicast. The methodof streaming is determined by the setup of the VideoXpert system within the Media Gateway settings.Please refer to the Pelco documentation for further details.

Primary and Secondary StreamsEach camera within the MV plugin can be assigned a primary and secondary stream. Normally, theprimary stream is set to a higher resolution/frame rate and the secondary stream is used for lowerresolution. This is to allow the plugin to switch from the primary stream to the secondary to reducethe workload of the plugin when multiple cameras are streamed at once.

The plugin will automatically determine which stream to use (if available) based on size of the videosegment in Datalog MV and the resolution of the video stream. If the size of the video segment issmaller than the resolution of the secondary video stream, then secondary video stream will be usedto stream the camera. Otherwise the primary video stream will be used. If the Secondary Stream forthe camera configured within the plugin as not being available, then the primary stream will alwaysbe used for this camera.

Please refer to the Camera Configuration section on how to set the primary and second videostreams for each camera.


Maximum Video StreamsThe Pelco VideoXpert plugin will only stream a certain number of video streams simultaneously. Themaximum number will be determined by the configuration of the video streams, resolution, fps etc.Streaming too many video streams into the plugin simultaneously will cause stability andperformance issues of the plugin and MV.

Please refer to the Installation section on where to set the maximum number of video streamssupported.

6 PTZ FunctionallityThe Pelco VideoXpert SDK currently supports for the following PTZ functionality:

ZoomPan/TiltFocus Near, Focus FarIris Open, Iris ClosePreset Recall

Please note, automatic focus and automatic iris commands are not supported by the PelcoVideoXpert SDK.

7 Alarm EventsThe plugin is capable of monitoring the following camera related events which in turn can bereported through to Datalog as alarms:

MotionAnalytics

For these events to generate an alarm in Datalog, within Datalog and the DatalogMV Managerassigned the relevant source to a Datalog circuit as highlighted below:

11Alarm Events

For further details, please refer to the main Datalog MV documentation.

8 Monitor WallThe Pelco VideoXpert plugin can control the Pelco video wall software.

Live cameras can be dragged and dropped onto the relevant segment and the ability to changelayouts is also possible.

Available Pelco monitors will automatically be added to the Datalog MV configuration.

For further details, please refer to the main Datalog MV documentation.

Please note, due to limitations of the Pelco VideoXpert SDK, the mimic provided within Datalog of thePelco monitor may not show the true status of the physical monitor.

9 Trouble ShootingUnable to Stream VideoIf the plugin starts up and connects successfully to the VideoXpert server, but when a camera isselected to stream video (live or replay), a popup error messages occurs, this is related to theinstallation path of the SDK folder being incorrect. Please refer to the Installation section for furtherdetails and verify the SDK is installed correctly.

Plugin Error, Unresponsive, Restarting, when Streaming Multiple CamerasIf multiple cameras are being streamed and the plugin becomes un-responsive and/or gives errormessages. The most likely cause is the plugin has reached the maximum performance for the PC.Check the CPU usage of the pluginhost.exe using Windows Task Manager to see it has reached the


100% CPU usage. Please refer to the section Streaming Video on to prevent such errors and alsolook at reducing the the maximum number of video streams setting.

pelco videoxpert plugin - partner...

Documents