Introduction

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

Navtech ICD-001 Protocol describes the protocol in detail, including message structure, message framing and all the message types.

This section covers the configuration of the plugin within Witness. The configuration controls the network settings as well as enabling how and what data is transmitted through the plugin.

Contents

Overview

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 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-001 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.

Open

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

Configuring the ICD-001 Plugin

When the plugin is 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.

Alarm Priority: This acts as a filter for alarm reports. Only alarms of the same or higher priority will be sent out through the plugin.

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

Max Clients: The total number of network clients supported by the plugin.

Track Output Mode: Sets the track output filter:

None: No tracks reports are sent.

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

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

All: Reports all tracks. 

Buffer Tracks: When enabled this will force tracks to be buffered and sent in batches based on the Track Buffer Timer. This can optimise network load but has the drawback of not sending data in real time. The Track Buffer Time setting specifies how often the buffered tracks are sent.

Status Reports: When enabled this will trigger status reports to be sent at a regular interval based on the Status Report Time. In addition it allows status reports to be sent when any status changes (i.e. health or system profile). This also enables support for the ICD-001 Request Status Command which provides the capability for external systems to request status reports. For more information please view ICD-001 Status Report.

Area Report Filter: This sets the filter for the area status report. One or more area types can be selected. This filter can be useful when a site has a lot of areas of different types. This filter ensures the status report only includes relevant areas. By default only Alarm areas are reported. If you do not wish to report any area status data then you clear the selection on all types.

Alarm Reports: When enabled, Alarm Reports will be sent when alarms are raised. For more information please view ICD-001 Alarm Report.

Camera Reports: When enabled, Camera Reports will be sent when cameras are tasked to follow targets. For more information please view ICD-001 Camera Report.

Classification Reports: When enabled, the Classification Report will contain the statistics for each configured section and classification type. For more information please view ICD-001 Classification Report.

Carriageway Statistics Report: When enabled, the Carriageway Statistics Report will contain the statistics for each section. For more details please see ICD-001 Carriageway Statistics Report.

Carriageway Statistics Interval (s): This setting specifies how often the Carriageway Statistics are sent.

Track Buffer Timer (s): Period of time between each batch of tracks being sent if Buffer Tracks is enabled.

Heartbeat Timer (s): The interval at which heartbeats are sent to the connected clients.

Status Report Timer (s): The interval at which each status report is sent. when the Send Status option is enabled.

Monitor Client Health: When enabled, the plugin will monitor the health of client connections. If a client is either not connected or connected but not sending heartbeats, then an alarm will be raised in Witness. The client must support sending heartbeats to Witness to use this option.

Allow Trace Logging: Enables trace logging for diagnostics purposes.

Use TLS: Enables TLS (v1.2) for the network connection. When disabled the link does not use any authentication or encryption. When enabled there are additional configuration options:

Authentication Type: The authentication method to use for the TLS connection:

None: No authentication is used however the link is still encrypted using TLS with a self-signed certificate created by Witness.

Fingerprint: This option can be used with self-signed certificates. This will look for client certificates with matching thumbprints on the server’s Windows certificate store. You can store more than one thumbprint in order to support a different certificate per client.

Certificate: This option uses a certificate with a fully verifiable certificate chain and Certificate Authority (CA). Typically this will need the full certificate chain including the CA root certificate available in the Windows certificate store or verifiable through a network connection.

Fingerprint Authentication

This is a simple way to authenticate clients when using self-signed certificates that can’t be verified using a Certificate Authority (CA).

Certificate Thumbprint: The thumbprint of the server certificate to use for the TLS connection.

Current User Store: Indicates if the certificate should be fetched from the current user store, if not it will be fetched from the local computer store.

Client Thumbprints: This is the list of client thumbprints. These are used to authenticate client connections. Each of these certificates must be installed in the certificate store on the server. Each entry can added with name for easy identification of the certificate.

Certificate Authentication

This is the standard way of authenticating a certificate using a Certificate Authority (CA) typically through a CA root certificate.

Certificate Thumbprint: The thumbprint of the server certificate to use for the TLS connection.

Current User Store: Indicates if the certificate should be fetched from the current user store, if not it will be fetched from the local computer store.

Product Specific Settings

ClearWay™

Send Size Classification Report: When enabled ClearWay™ Size & Classification Reports will sent if Traffic Analysis is enabled. 

Related Information