Introduction
This page covers the installation and configuration of the ADS-B (Automatic Dependent Surveillance-Broadcast) plugin which enables AdvanceGuard® to receive data via your ADS-B receivers.
Contents
Overview
Witness supports integration with many different types of external systems through the use of plugins.
The ADS-B plugin passes information from your existing ADS-B receivers into AdvanceGuard®, such as location information and flight numbers transmitted by aircraft. AdvanceGuard® then correlates this information with radar tracks to provide accurate classification of detected objects and additional information such as flight numbers of aircraft.
The plugin can be selected during setup and will automatically be installed in the correct location.
Prerequisites
The ADS-B Plugin relies on using the UDP Protocol to receive messages from a compatible ADS-B receiver.
This is a link to a document which describes the structure for the transmission of ADS-B messages: https://www.eurocontrol.int/publication/cat021-eurocontrol-specification-surveillance-data-exchange-asterix-part-12-category-21.
It is version 0.23 that the plugin has been designed to work with.
Installing the ADS-B Plugin
When installing AdvanceGuard®, in the Choose Components page of the AdvanceGuard® Setup wizard, open Integration Plugin options and select ADS-B.
Configuring the ADS-B Plugin in AdvanceGuard®
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.
ADS-B Plugin Fields
Plugin Enabled: Select to enable the ADS-B Plugin.
Name: The ADS-B Plugin name.
System Id: ID of the system sending the sightings.
Timer Interval (s): The time period for reporting health and cleaning up stale tracks.
Track Expiry (s): This specifies how long a track will be kept alive in AdvanceGuard® whilst it waits for an update. If a Track Detection update is not received during this expiry period then the track will be automatically deleted and purged from the AdvanceGuard® system.
Show All Targets: If enabled, this option will show all targets, otherwise, only ground based targets will be processed.
Send Non Friendly: If enabled, both friendly and non friendly tracks will be processed, otherwise, only friendly tracks will be processed.
Use Detection Areas: If enabled, tracks will only be shown in Detection Areas - see Detection Areas.
UDP Server
UDP Port: The port number used for the UDP Server.
Remote IP Address: The ADS-B server address.
Tag Overrides
Classification overrides have been added to the ADS-B plugin so specific, known vehicles / planes / targets etc can be classified within it.
Address Type: These are from the CAT-21 specifications:
Non Unique: Non unique address.
ICAO: ICAO (International Civil Aviation Organization) address, typically, an aeroplane.
Surface Vehicle: Surface vehicle address.
Vehicle: Anonymous address.
Other: Reserved for future use.
Target Address (Hex): A hex string that corresponds with the expected ID of a target.
Tag Override: This provides us with a method of overriding the incoming tracks with our own tags and classifications.
For example, if we had a ground transponder with a target address of #000001 we could tag it with "Bob's car" and force the classification to be a car.
Classification: The Classification Model of the target - see https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/790069631/Classification+Configs#Classification-Models
None
Unclassified
Vehicle
Person
Debris
Aeroplane
Boat
Large Vehicle
Animal
Drone
Helicopter
Any
IFF (Identification Friend or Foe) Overrides
This allows specific classifications and/or an incoming target address to be classed as friendly or not.
Classification: The Classification Model:
Unclassified
Aeroplane
Drone
Large Vehicle
Vehicle
Debris
Helicopter
Is Friend: Select the checkbox if the Classification Model is to be regarded as friendly.
Exceptions
Address Type:
Non Unique
ICAO
Surface Vehicle
Vehicle
Other
Target Address (Hex): The Hex value of an incoming target to override the default setting for the classification. For example, if all cars are considered friendly, then adding an exception would mean that a target marked as a car, which has the given Address Type and Target Address, would be considered as not friendly.
Related Information
-
Bosch BVMS Plugin (Witness 4.0)
-
ADAM-6060 Relay Plugin (Witness 4.0)
-
Milestone XProtect Plugin (Witness 4.0)
-
Mail and SMS Plugins (Witness 4.0)
-
RTS IFF Plugin (Witness 4.0)
-
AXIS Video Encoder (Witness 4.0)
-
Camera Integration (Witness 4.0)
-
ICD-001 Plugin (Witness 4.0)
-
ICD-006 Plugin (Witness 4.0)
-
ICD-007 Plugin (Witness 4.0)