Bosch BVMS Plugin

Owned by Isabelle Avery (Unlicensed)
Last updated: Jan 04, 2023 by Charlotte Dakin-Norris
2 min read

Introduction

This page discusses the integration of the Bosch Video Management System with the Witness software. Integration has been tested with BVMS version 9.0.

Contents

Overview

The BVMS (Bosch Video Management System) plugin is designed to allow Witness to send camera movement updates to a BVMS server. This implementation will close a BVMS Virtual Input when a camera move operation is started by Witness and will open the Virtual Input again after a configurable period of camera inactivity. If the camera is moving in response to an alarm then data about the camera, track and alarm will be sent to BVMS each time the camera moves to look at a new alarm.

Adding the BVMS Plugin

Witness supports integration with many different types of external systems through the use of plugins. These are stand-alone software libraries which are dynamically loaded by the Management Server and contain code which knows how to convert the Witness data into the required format for the external system. The BVMS plugin file is entitled Witness.Plugin.Bvms.dll and must be present in the Witness Plugin folder which is inside the main application folder. The plugin depends on two third party files, Bosch.Vms.SDK.dll and GenuineChannels.dll, which must be placed in the main application folder.

The plugin can be selected during setup and will automatically install the files in the correct locations.

The BVMS SDK files, Bosch.Vms.SDK.dll and GenuineChannels.dll are not supplied with Witness, These can be found within the BVMS installation files, typically in the Bin folder. They must be copied to the main Witness application folder.

BVMS Plugin Message Payload

The following values are passed to BVMS every time the Alarm that the camera is responding to changes. The payload has 10 available values but currently only 5 are configured.

Data Index

Value

Data Index

Value

1

The id of the camera within BVMS

2

The numeric id of the track within Witness

3

The alarm description for the alarm being watched by the camera

4

The classification of the track

5

The speed of the track in m/s

Configuring the BVMS Plugin

Plugin Enabled: Select to enable plugin.

Name: The name of the plugin.

IP Address: The address of the BVMS server.

Port: The port used by BVMS (5390 is the default value and is unlikely to need changing).

Username: The username used to logon to the BVMS system.

Password: The password associated with the above User value.

Input Reset Period (s): The period (in seconds) after no new alarm updates have been received that will cause the virtual input open command to be sent to BVMS.

BVMS Data Mapping

Navtech Camera

BVMS Camera

BVMS Virtual Input

Camera Settings

User ID: The BVMS Virtual Input that will be closed when a camera movement is triggered by Witness

External System ID: The BVMS camera id that relates to this camera and can be found by opening the BVMS Config Client and opening the Cameras and Recording page.

 

Safety is everything.