ICD-001 Tracker Command
Introduction
This page covers the ICD-001 Tracker Command.
Contents
Example 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:
| 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
-
ICD-001 Track Filter Command (Witness 4.0)
-
ICD-001 Acknowledge Alarm Command (Witness 4.0)
-
ICD-001 Request Status Command (Witness 4.0)
-
ICD-001 Detection Command (Witness 4.0)
-
ICD-001 Update Entity Command (Witness 4.0)
-
ICD-001 System Profile Command (Witness 4.0)
-
ICD-001 External Trigger Command (Witness 4.0)
-
ICD-001 Command Reply (Witness 4.0)
-
ICD-001 Camera Command (Witness 4.0)
-
ICD-001 Track Command (Witness 4.0)