Page Comparison

The Dallmeier Plugin

Witness Canary 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 Canary and contain code which knows how to convert the Witness data into the required format for the external system.

The Dallmeier plugin file is entitled Witness.Plugin.Dallmeier.dll and must be present in the Witness Plugin folder which is inside the main application folder. 

Configuring the Dallmeier Plugin

When the plugin is installed and Canary starts, the plugin configuration settings are saved to the PluginConfiguration.xml file. This file is located in the Witness main application folder. To change the settings this file should be opened in a text editor, such as Notepad, however we would recommend an editor which is XML aware, such as Notepad++.

Once the file is open, locate the Dallmeier section, as illustrated below:

<?xml version="1.0" encoding="utf-8"?>
<Config>
  <Plugins>
    <Dallmeier>
      <PluginConfig>
        <VMSServer RemoteIPAddress="localhost" Enabled="True" Port="30000" />
        <TimerTick>1000</TimerTick>
        <HeartbeatInterval>10</HeartbeatInterval>
        <Timeout>2000</Timeout>
        <Retries>2</Retries>
        <Username>username</Username>
        <Password>password</Password>
        <AlarmTimeout>10</AlarmTimeout>
      </PluginConfig>
    </Dallmeier>
  </Plugins>
</Config>

The setting options are as follows:

TimerTick

Timer used to control connection checks and cleaning up buffers in milliseconds. Health of the TCP connection to the Dallmeier SMAVIA recording server is checked and reestablished if required at this interval.

VMSServer

Connction to the Dallmeier SMAVIA recording server is set here.

• RemoteIPAddress - should be the IP address of the server hosting the Dallmeier SMAVIA recording service
• Enabled - the plugin will attempt to connect if enabledif the connection should be attempted.
• Port - port for connecting to the SMAVIA recording service. By default this is 30000.

SendCAT10

• True - Sends all confirmed tracks in Witness as CAT-10 messages to the UdpServer address.
• False - Tracks are not sent out.

ListenCAT10

• True - Listens to CAT-10 messages on the udpserver address and port and inserts tracks detected as friendly tracks into Witness.
• False - Does not listen to CAT-10 messages.

One or both of ListenCAT10 or SendCAT10 should be true.

CAT10SourcePositions

Source positions are used to configure displacements of origins between systems.

• List of displacement locations based on system SIC and SAC for other systems.
• SIC: System Identification Code - uniquely identifies each systems within the airport.
• SAC: should normally be 0 for other systems in the same airport.
• X: System origin is located east from witness origin by X meters.
• Y: System origin is located north from witness origin by Y meters.

This does not need to be configured for systems who's origin coincides with Witness origin.

Example 1: A multilateration detection system has it's origin set at the airport control tower. Witness is configured with origion the control tower as well.

In this case, we do not need a SourcePosition record for the system.

Example 2: A single detector also sends CAT-10 messages relative to its own location - 150 meters north and 200 meters west from the control tower. This detector is assigned SIC153.

For this detector we will need a CAT10SourcePositions record of:

			<SourcePositions>

				<Sic>153</Sic>

				<Sac>0</Sac>

				<X>-200</X>

				<Y>150</Y>

			</SourcePositions>

External System tracks should be within Witness radar coverage to appear in Sentinel.

HeartbeatInterval

TimerTick

Timer used to control connection checks and cleaning up buffers in milliseconds. Health of the TCP connection to the Dallmeier SMAVIA recording server is checked and reestablished if required at this interval.

HeartbeatInterval

Period, in seconds, between each heartbeat being sent to every connected client. Default is 10 seconds.

Timeout

Period, in milliseconds for TCP message to be considered timed out with reply.

Retries

If a TCP message times out without reply, retries controls the number of retries we should do for the same message.

Username

Username to use for connecting to the Dallmeier SMAVIA service. This needs to be configured on the Dallmeier server.

Password

Password to use for connecting to the Dallmeier SMAVIA service. This needs to be configured on the Dallmeier server.

BufferTracks

• Buffer tracks to send in batches on TimerTicks

Related information