Datalog MV Pelco VideoXpert Plugin Software Manual www.cortech.co.uk Product Code: 1264
Pelco VideoXpert Plugin 2017 Cortech Developments Ltd All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective 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 no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Printed: October 2017 Cortech Developments Ltd The Barn Brook House Farm Withers Lane High Legh Knutsford Cheshire WA16 0SG Tel. +44(0)1925 750 600 Email. info@cortech.co.uk www.cortech.co.uk Cortech Middle East DMCC Office 405, JBC1, Cluster G Jumeirah Lake Towers Dubai United Arad Emirates Tel. +971 (0) 44 524 256 Email. info@cortech.ae www.cortech.ae
Contents 3 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 Introduction A plugin is available to integrate with the Pelco VideoXpert system. The plugin uses the Pelco VideoXpert SDK v2.0.0.14. 2 Installation The 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 be copied 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.dll CSharpWrapper.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 VideoXpert item and select General Settings. The following window will appear:
Installation 5 Installation Path - the root folder of the where the Pelco VideoXpert SDK has been installed to. If the SDK has been installed to a different folder from the default, the enter here the path to where the SDK has been installed. The folder structure of the SDK must be c:\<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 that can be displayed in MV using the Pelco VideoXpert plugin. This number includes both live and replay video streams. Please see Streaming Video for further details. If the video of number of video streams is exceeded, the relevant video segment within MV will inform the operator that the maximum number of streams has been reached. 3 Configuration The 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 represent is detailed below. To access the configuration of the Pelco VideoXpert plugin right click on the Datalog MV icon in the Windows system tray and from the popup menu select, Configuration and Licensing. The following window will then appear.
6 Pelco VideoXpert Plugin The initial task is to add a Device or Devices to each of the Pelco NVRs. Expand the Pelco VideoXpert branch as per the window above and right click the on Devices item. From the popup menu select Add Device.
Configuration 7 Enter in each row of the table above the connection details for each of the Pelco devices that are to be connected. The number of rows in the table will keep automatically increasing as required. If a mistake is made and a row is populated that isn't need, simply remove the details entered into that row 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 the operator that a restart of the plugin is required. To restart the plugin, right-click on the Pelco VideoXpert in the tree and select Restart. Once the plugin has restarted Datalog MV will connect to the Pelco devices and obtain a full list of cameras and monitors. The cameras will then appear under the Sources branch as below and
8 Pelco VideoXpert Plugin 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-click and from the popup menu select either Edit or Delete Item as appropriate. If a Device is deleted, the associated cameras with that device will also be deleted. Ple a s e No te : wh e n e v e r th e e d it win d o w is o p e n fo r th e p lu g in o r a n y p o p u p m e s s a g e s b o x e s th a t a r e v is ib le, th is will p r e v e n t a n y ca m e r a s e le ctio n s o r a n y a ctio n s b e in g ca r r ie d o u t with in D a ta lo g MV u n til th e win d o w is clo s e d. 4 Camera Configuration To access the configuration of the Pelco VideoXpert plugin right click on the Datalog MV icon in the Windows system tray and from the popup menu select, Configuration and Licensing. The Plugin Licensing window will appear displaying all the Plugin Information. Within the tree navigate to the Pelco VideoXpert branch, then Sources. This will display list of all the cameras which are available within the Pelco VideoXpert plugin. Select the relevant camera from the list, right click and select Edit and the following window will appear:
Camera Configuration 9 Primary Stream - Primary video stream for this camera. Defaults to the first video stream reported by the VideoXpert SDK. Please note, this may not be the primary stream configured on the physical camera. Secondary Stream - Secondary video stream for this camera, if available. Defaults to the second video stream reported by the VideoXpert SDK. Please note, this may not be the secondary stream configured on the physical camera. Please refer to the Streaming Video section for further details regarding primary and second streams. Alarm Handling Report Motion Alarms - when selected Video Motion alarms will be reported for his camera. Also requires 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 Video Multicast and Unicast The Pelco VideoXpert plugin supports streaming of video in either multicast or unicast. The method of 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 Streams Each camera within the MV plugin can be assigned a primary and secondary stream. Normally, the primary stream is set to a higher resolution/frame rate and the secondary stream is used for lower resolution. This is to allow the plugin to switch from the primary stream to the secondary to reduce the 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 video segment in Datalog MV and the resolution of the video stream. If the size of the video segment is smaller than the resolution of the secondary video stream, then secondary video stream will be used to stream the camera. Otherwise the primary video stream will be used. If the Secondary Stream for the camera configured within the plugin as not being available, then the primary stream will always be used for this camera. Please refer to the Camera Configuration section on how to set the primary and second video streams for each camera.
10 Pelco VideoXpert Plugin Maximum Video Streams The Pelco VideoXpert plugin will only stream a certain number of video streams simultaneously. The maximum 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 and performance issues of the plugin and MV. Please refer to the Installation section on where to set the maximum number of video streams supported. 6 PTZ Functionallity The Pelco VideoXpert SDK currently supports for the following PTZ functionality: Zoom Pan/Tilt Focus Near, Focus Far Iris Open, Iris Close Preset Recall Please note, automatic focus and automatic iris commands are not supported by the Pelco VideoXpert SDK. 7 Alarm Events The plugin is capable of monitoring the following camera related events which in turn can be reported through to Datalog as alarms: Motion Analytics For these events to generate an alarm in Datalog, within Datalog and the DatalogMV Manager assigned the relevant source to a Datalog circuit as highlighted below:
Alarm Events 11 For further details, please refer to the main Datalog MV documentation. 8 Monitor Wall The 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 change layouts 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 the Pelco monitor may not show the true status of the physical monitor. 9 Trouble Shooting Unable to Stream Video If the plugin starts up and connects successfully to the VideoXpert server, but when a camera is selected to stream video (live or replay), a popup error messages occurs, this is related to the installation path of the SDK folder being incorrect. Please refer to the Installation section for further details and verify the SDK is installed correctly. Plugin Error, Unresponsive, Restarting, when Streaming Multiple Cameras If multiple cameras are being streamed and the plugin becomes un-responsive and/or gives error messages. 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
12 Pelco VideoXpert Plugin 100% CPU usage. Please refer to the section Streaming Video on to prevent such errors and also look at reducing the the maximum number of video streams setting.