9.51 Antenna-Tracking

Please note, the Antenna-Tracking device is no longer maintained and should not be used for new M&C installations.

The Antenna-Tracking logical device is a 'high level' driver for motor driven antennas. It is used together with a driver for the type of antenna controller used. To operate the device in step track modes, also a beacon receiver is required. The Antenna-Tracking device provides three mayor tracking modes:

Device window pages

The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameters which must be set to make the Antenna-Tracking device work properly.

parameter description
config.azimuthId Enter here the parameter ID of the azimuth target value the tracking unit shall use. Example: 'ODU.azimuth'
config.stateAzId Enter here the parameter ID of the azimuth read out value the tracking unit shall use. Example: 'ODU.state.az'
config.elevationId Enter here the parameter ID of the elevation target value the tracking unit shall use. Example: 'ODU.elevation'
config.stateElId Enter here the parameter ID of the elevation read out value the tracking unit shall use. Example: 'ODU.state.el'
config.polarizationId Enter here the parameter ID of the polarization offset target value the tracking unit shall use. The tracking unit does no polarization, however a fixed polarization offset value is stored together with each target. Example: 'ODU.polarization'
config.antennaFaultId Enter here the parameter ID of the antenna fault, the tracking unit shall monitor.
config.bcrxFreqId Enter here the parameter ID of the beacon receiver frequency setting. The tracking unit sends the receive frequency stored with a target to this parameter (RF frequency, not L-band). Leave this field empty, if the beacon receiver frequency cannot be controlled through the sat-nms software. Please note, that in the tracking unit the beacon frequency must be set to the correct value even if it is not passed to the beacon receiver. This is because the tracing unit computes the step track search sizes from the beacon frequency.
config.bcrxLevelId Enter here the parameter ID of the beacon receiver level reading. The value is expected to be a receive level in dBm or a C/N value [dB]. To read the analog output value of a tracking receiver, you need an external device which reads this voltage and converts the readint to dBm. The sat-nms Antenna Control Unit ODM is capable to do this.
config.bcrxFTrackId If you are using a sat-nms L-band beacon receiver together with this tracking device, enter 'BCRX.ftrack.fast' here, replace BCRX by the device name of the beacon receiver. This tells the tracking engine to perform a synchronous frequency tracking step on the beacon receiver before each antenna tracking step.
config.bcrxFaultId Enter here the parameter ID of the beacon receiver fault, the tracking unit shall monitor.
config.xDiameter This parameter tells the tracking device the width of the antenna dish. The tracking device computes the azimuth tracking step size from this parameter and the beacon frequency value.
config.yDiameter This parameter tells the tracking device the height of the antenna dish. The tracking device computes the elevation tracking step size from this parameter and the beacon frequency value.
longitude The antenna's longitude (degree east). Provide this value with an accuracy of 0.01° to ensure a precise orbit to pointing calculation
latitude The antenna's latitude (degree north). Provide this value with an accuracy of 0.01° to ensure a precise orbit to pointing calculation
altitude The antenna's altitude over sea. Provide this value with an accuracy of 10 meters to ensure a precise orbit to pointing calculation

Built in analysis tools

The Antenna-Tracking device is capable to show two different types of diagrams which support you to monitor and optimize the tracking behaviour.

The first diagram tool is the X/Y display of the antenna movements. This display works completely autoscaled, it shows one green dot for each antenna position the tracking memorizes (usually the recent 48 hours). The actual antenna pointing is marked with a slightly larger yellow dot. After at least 24 hours of continuous operation, the antenna position dots give the curve of the daily movement of the satellite, from the antenna's angle of look. With a mouse click to the diagram area, the display cas be switched into a Y/T diagram showing the recent 48 hours. This condensed display of the azimuth, elevation and beacon level variations over 48 hours is meant as an overview display. A second mouse click switches back to the previous view.

The separate Y/T display window gives more detailed information about what the tracking engine did during the recorded 48 hours. It provides variable scales, and permits to display additional information. The display shows either the azimuth or the elevation pointing found at the beginning of each each tracking step together with the beacon level measured at this time. The following additional information may be included to the diagram:

Recommended beacon receiver settings

Below some recommended settings for the sat-nms L-band beacon receiver for the use with the tracking device are listed. These settings have proved to work satisfactory in most cases. If you are using a third party beacon receiver, use analogous values a starting point.

Variables defined by this device driver

name type flags range
info.driver TEXT R/O StringRange R/O
info.type TEXT R/O StringRange R/O
info.port TEXT R/O StringRange R/O
info.frame TEXT R/O StringRange R/O
config.azimuthId TEXT SAVE SETUP StringRange
config.stateAzId TEXT SAVE SETUP StringRange
config.elevationId TEXT SAVE SETUP StringRange
config.stateElId TEXT SAVE SETUP StringRange
config.polarizationId TEXT SAVE SETUP StringRange
config.antennaFaultId TEXT SAVE SETUP StringRange
config.bcrxFreqId TEXT SAVE SETUP StringRange
config.bcrxLevelId TEXT SAVE SETUP StringRange
config.bcrxPolId TEXT SAVE SETUP StringRange
config.bcrxInhibitId TEXT SAVE SETUP StringRange
config.bcrxFaultId TEXT SAVE SETUP StringRange
config.xDiameter FLOAT SAVE SETUP DoubleRange (0.0 .. 0.0)
config.yDiameter FLOAT SAVE SETUP DoubleRange (0.0 .. 0.0)
config.longitude FLOAT SAVE SETUP DoubleRange (0.000 .. 0.000)
config.latitude FLOAT SAVE SETUP DoubleRange (0.000 .. 0.000)
config.altitude FLOAT SAVE SETUP DoubleRange (0 .. 0)
azimuth FLOAT SAVE DoubleRange (0.00 .. 0.00)
elevation FLOAT SAVE DoubleRange (0.00 .. 0.00)
polarization FLOAT SAVE DoubleRange (0.0 .. 0.0)
trackMode CHOICE SAVE EnumRange (OFF STEP ADAPTIVE PROGRAM)
polPlane CHOICE EnumRange DIS (H V)
frequency FLOAT DoubleRange (0.000 .. 0.000)
interval INTEGER SAVE IntegerRange (0 .. 60)
name TEXT SAVE StringRange
elements TEXT SAVE StringRange
orbit FLOAT SAVE DoubleRange (0.0 .. 0.0)
stepSize INTEGER SAVE IntegerRange (0 .. 200)
stepMode CHOICE SAVE EnumRange (FAST SLOW)
optimizeSize INTEGER SAVE IntegerRange (0 .. 200)
averagingTime INTEGER SAVE IntegerRange (1 .. 120)
settlingTime INTEGER SAVE IntegerRange (1 .. 120)
dazMax FLOAT SAVE DoubleRange (0.0 .. 10.0)
delMax FLOAT SAVE DoubleRange (0.0 .. 10.0)
driftMax FLOAT SAVE DoubleRange (0.00 .. 10.00)
dropMax FLOAT SAVE DoubleRange (0.00 .. 10.00)
sdevMax FLOAT SAVE DoubleRange (0.00 .. 10.00)
beaconThreshold FLOAT SAVE DoubleRange (-100.0 .. 0.0)
state.saz FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
state.sel FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
state.daz FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
state.del FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
eval.az FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
eval.el FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
eval.pl FLOAT R/O DoubleRange R/O (0.000 .. 0.000)
state.mode1 TEXT R/O StringRange R/O
state.mode2 TEXT R/O StringRange R/O
state.mode3 TEXT R/O StringRange R/O
state.mode4 TEXT R/O StringRange R/O
state.beacon FLOAT R/O DoubleRange R/O (0.00 .. 0.00)
state.elements TEXT R/O StringRange R/O
reset TEXT NOPRESET StringRange
evalByOrbit TEXT NOPRESET StringRange
evalByElements TEXT NOPRESET StringRange
moveEvaluated TEXT NOPRESET StringRange
slist.select CHOICE NOPRESET EnumRange ()
slist.action TEXT NOPRESET StringRange
faults.01 ALARM R/O AlarmFlagRange R/O (Beacon receiver)
faults.02 ALARM R/O AlarmFlagRange R/O (Beacon level)
faults.03 ALARM R/O AlarmFlagRange R/O (AZ window limit)
faults.04 ALARM R/O AlarmFlagRange R/O (EL window limit)
faults.05 ALARM R/O AlarmFlagRange R/O (Antenna)
faults.06 ALARM R/O AlarmFlagRange R/O (Search step size)
faults.07 ALARM R/O AlarmFlagRange R/O (AZ Model match)
faults.08 ALARM R/O AlarmFlagRange R/O (EL Model match)