ICD-001 Tracker Command

Introduction

This page covers the ICD-001 Tracker Command.

<!—MsgId is the unique id of the message being sent -->
<!—CommandType defines the type of action required -->
<!—TrackerId is the unique id of the tracker being controlled -->
<?xml version="1.0" encoding="utf-8"?>
<TrackerCommand xmlns=”http://navtechradar.com/TrackerCommand” xmlns:xsi="http://www.w3.org/2001/XMLSchema-Instance"
    MsgId="21" MsgTimeStamp="2012-02-14T11:23:15" CommandType="MoveRadar" TrackerId="0">
  <!—Payload type and content is dependant on the CommandType -->
  <Payload xsi:type="TrackerCommandPayloadMove" Offset="0" Latitude="52.5678" Longitude="2.144566" />
  <!-- The sender element is optional -->
  <Sender SenderId ="XFSControlSuite:1" NetworkAddress="192.168.24.5" NetworkPort ="2077"/>
</TrackerCommand>

Tracker Command Element

The tracker command provides a series of messages to control one or more trackers. Currently there are three message types. Descriptions and examples are provided in this section.

Tracker Command Attributes

Attributes	Description	Type	Notes
MsgId	Unique message Id	Long	This must be globally unique across all message types
MsgTimeStamp	Date and time that the message was sent	DateTime
CommandType	Type of Tracker Command: HideTracks ShowTracks MoveRadar	String
TrackerId	Id of the tracker which is the target for this message	Int	This must match the configured Id in Witness

Payload Element

The payload carries data specific to a command. Each command that requires a payload is detailed in this document and each of the payload elements is included within the appropriate XSD.

Network Sender Element

Each incoming message can include an optional Sender element. This must include the IP address and port that the client is using to send instructions.

If the Sender element is included the NetworkAddress value will be checked against the subscriber IP address and the command rejected if they do not match.

In addition the Sender element is included in the Command Reply. This is a duplicate of the incoming details (i.e. the subscribers IP address and port). The subscriber can use this to verify that they authored the message.

Hide Tracks

This command will hide all tracks from the specified tracker. Hiding tracks will prevent alarms being raised if the radar position is changed.

There is no issue with sending a duplicate command. If the tracks are hidden, subsequent commands to hide tracks for the same tracker will be ignored.

Hide Tracks Command Example

<!—MsgId is the unique id of the message being sent -->
<!—TrackerId is the unique id of the tracker being controlled -->
<?xml version="1.0" encoding="utf-8"?>
<TrackerCommand xmlns=”http://navtechradar.com/TrackerCommand” xmlns:xsi="http://www.w3.org/2001/XMLSchema-Instance"
    xmlns:xsd=http://www.w3.org/2001/XMLSchema MsgId="21" MsgTimeStamp="2012-02-14T11:23:15" CommandType="HideTracks" TrackerId="1">
  <!-- The sender element is optional -->
  <Sender SenderId ="XFSControlSuite:1" NetworkAddress="192.168.24.5" NetworkPort ="2077"/>
</TrackerCommand>

Show Tracks

This command will show the tracks form the specified tracker if previously hidden.

There is no issue with sending a duplicate command. If the tracks are shown, subsequent commands to show tracks for the same tracker will be ignored.

Show Tracks Command Example

<!—MsgId is the unique id of the message being sent -->
<!—TrackerId is the unique id of the tracker being controlled -->
<?xml version="1.0" encoding="utf-8"?>
<TrackerCommand xmlns=”http://navtechradar.com/TrackerCommand” xmlns:xsi="http://www.w3.org/2001/XMLSchema-Instance"
    xmlns:xsd=”http://www.w3.org/2001/XMLSchema” MsgId="22" MsgTimeStamp="2012-02-14T11:23:15" CommandType="ShowTracks" TrackerId="1">
  <!-- The sender element is optional -->
  <Sender SenderId ="XFSControlSuite:1" NetworkAddress="192.168.24.5" NetworkPort ="2077"/>
</TrackerCommand>

Move Radar

This command enables the position and/or the offset of radar to be changed.

Move Radar Command Example

Move Radar Payload Attributes

Attributes	Description	Type	Notes
Offset	Bearing offset of the radar zero point to geographical North	Double	In degrees
Latitude	WGS84 Latitude Coordinate	Double
Longitude	WGS84 Longitude Coordinate	Double

Related Information

Page:

ICD-001 Track Filter Command (Witness 4.0)
Page:

ICD-001 Acknowledge Alarm Command (Witness 4.0)
Page:

ICD-001 Request Status Command (Witness 4.0)
Page:

ICD-001 Detection Command (Witness 4.0)
Page:

ICD-001 Update Entity Command (Witness 4.0)
Page:

ICD-001 System Profile Command (Witness 4.0)
Page:

ICD-001 External Trigger Command (Witness 4.0)
Page:

ICD-001 Command Reply (Witness 4.0)
Page:

ICD-001 Camera Command (Witness 4.0)
Page:

ICD-001 Track Command (Witness 4.0)

Witness 4.0