Introduction

This page covers the configuration of the plugin within AdvanceGuard®. This plugin enables AdvanceGuard® to receive target data from an external system based on the ICD-100 XML protocol. The configuration controls the network settings as well as enabling how and what data is transmitted through the plugin. Once the target data has been received it is treated in exactly the same way as if it was a target being generated by a Navtech Radar sensor.

ICD-100 is a US Military communication protocol based on XML. The protocol is used over standard TCP/IP client-server connections.

Contents

Overview

When Witness generates events, such as alarms, or processes targets, it passes all this information to the Integration Manager. The Integration Manager is then able to use loaded plugins such as ICD-100 to convert this information into a suitable data format to send to external systems. In this case the plugin converts the data to XML message which are transmitted over a TCP/IP connection.

The data is transmitted as the events occur, leading to real time reporting.

Installing the ICD-100 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 Integration Manager and contain code which knows how to convert the Witness data into the required format for the external system. Navtech Radar can easily develop bespoke plugins to interface with a specific type of equipment or application, however ICD-001 has been developed to provide a comprehensive communication protocol which is based on open standards in order to make it as easy as possible to integrate with a large number of different systems.

When installing Witness, in the Choose Components page of the Witness Setup wizard, open Integration Plugin options and select ICD100:

Open

Configuring the ICD-100 Plugin

When the plugin is installed and licensed, a plugin configuration with default settings is automatically generated. The settings can be viewed and edited by enabling the Config Function, then selecting the plugin in Integration Configurations, within the Configuration Tree. Configuration settings will then be available in the Configuration Panel. 

Open

The setting options are as follows:

Plugin Enabled: When enabled the plugin will start and will always start when the Witness system starts. When disabled the plugin will stop and will not start until re-enabled.

Name: User friendly name of the plugin.

Sender Id: Numeric Id used to identify this plugin for incoming tracks. This allows track detections passed into Witness via the ICD-001 plugin to be identified has having come from this plugin.

Speed Units: Select from the list of speed measurements:

m/s

mph

kph

Knots

Track Output Mode: Sets the track output filter:

All: Reports all tracks.

Alarm Only: Report only tracks which have broken rules that results in an active alarm.

Broken Rule: Report all tracks which have broken rules, regardless of whether this resulted in an alarm.

None: No tracks reports are sent.

Pump Timer: This is how often it will send output.

TCP Server

Enabled: Select the checkbox to enable the TCP server.

TCP Port: The TCP port on which the plugin listens to connections from clients.

UDP Server

Enabled: Select the checkbox to enable the UDP communications.

UDP Port: The port number used for the UDP communications.

Remote IP Address: This is the IP Address of the client that wants to receive the ICD-100 messages.

Classification Map

The Classification Map allows you to map AdvanceGuard® Classification Models to the ICD-100 Classifications.

Classification: The Classification Model of the target - see Classification Configs | Classification Models.

None

Unclassified

Vehicle

Person

Aeroplane

Boat

Large Vehicle

Animal

Drone

Helicopter

ICD-100 Classification: Select from the list of ICD-100 Classifications of the target.

Related Information