9.49 Antenna-Pointing

The Antenna-Pointing 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.

While the plain driver for the antenna controller simply supports to set the azimuth/elevation/pol-offset parameters of the antenna, the Antenna-Pointing logical device extends this with additional capabilities:

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-Pointing device work properly.

parameter description
config.reserved.lo.x
config.reserved.lo.y
config.reserved.hi.x
config.reserved.hi.y These settings give a hint to the RX-LineSettings-CDB devices, that a particular port of the antenna actually is reserved and not available for automatic antenna selection. These settings have no impact to the Antenna-Pointing device itself.
azId The message ID controlling the antenna's azimuth parameter.
elId The message ID controlling the antenna's elevation parameter.
polId The message ID controlling the antenna's polarization parameter.
orbitId The message ID controlling the antenna's orbit parameter.
polPlaneId The message ID selecting the antenna's polarization plane. See section "Polarization plane handling" below.
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.
beamwidth The antenna's half 3dB beamwidth. A satellite is considered a pointed by the antenna, if the azimuth/elevation angles of the antenna match the stored pointing of a satellite within +/- beamwidth.

Operation modes

The Antenna-Pointing device knows three different modes of operation. This is to adapt the behaviour of the device to different types of antennas. By setting the azId, elId, polId and orbitId configuration parameter or leaving them empty you select the proper mode of operation for a particular antenna:

Polarization plane handling

The Antenna-Pointing device accepts an operational parameter called 'rxpolplane' (H/V). This parameter may be used to select a certain receive polarization plane by turning the feed (This works with 3-axis antennas only.)

The device translates the commanded polarization angle when forwarding it to the antenna. If horizontal polarization is selected (which is the default if the parameter isn't used), the angle is forwarded as it is. With vertical polarization, the device either adds or subtracts 90 degrees before the value gets forwarded. The device decides if to add or to subtract based on the range of the polarization angle given by antenna controller driver.

If the configuration parameter polPlaneId is set, the device will forward the polarization plane setting to the given device / parameter rather than shifting the polarization angle. The destination may be a switch selecting the polarization plane or a comparable parameter of the antenna controller itself. This "pass-through" mode may be used with all types of antenna controllers, as long as there is a parameter to select the polarization plane.

Remarks

  1. To make the antenna move to a satellite already stored in the list, double click to the satellite's entry in the tb-satellite.gif - page.
  2. Pressing the right mouse button on a satellite's entry in the list opens a context menu offering all funktions to manage the satellite list.
  3. When entering a new satellite to the list, first move the antenna to it's calculated position by entering the satellite's orbit position at the tb-setdev.gif - page. Optimize the antenna pointing. Then switch to the tb-satellite.gif - page, add a new entry to the list and update this entry with the current antenna pointing.

Satellite position file

The Antenna-Pointing device stores the satellite positions in a text file in the base directory of the M&C/VLC software. It is named "XXXX.txt" where XXXX is the name of the Antenna-Pointing logical device. The file contains the satellite list as a table of semicolon separated fields. It may be imported by common spread sheet programs this way. The table columns are defined as follows.

  1. satellite name
  2. orbit position (deg. east)
  3. antenna azimuth
  4. antenna elevation
  5. antenna polarization offset Be aware, that the numeric values are stored with a decimal dot (##.###), regardless of the default locale of your computer.

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.frame TEXT R/O StringRange R/O
config.reserved CHOICE SETUP EnumRange (NO YES)
config.reserved.lo.x CHOICE SAVE SETUP EnumRange (NO YES)
config.reserved.lo.y CHOICE SAVE SETUP EnumRange (NO YES)
config.reserved.hi.x CHOICE SAVE SETUP EnumRange (NO YES)
config.reserved.hi.y CHOICE SAVE SETUP EnumRange (NO YES)
config.azId TEXT SAVE SETUP StringRange
config.elId TEXT SAVE SETUP StringRange
config.polId TEXT SAVE SETUP StringRange
config.orbitId TEXT SAVE SETUP StringRange
config.polPlaneId TEXT SAVE SETUP StringRange
config.beamwidth FLOAT SAVE SETUP DoubleRange (0.00 .. 0.00)
config.diameter FLOAT SAVE SETUP DoubleRange (0.0 .. 0.0)
config.satlist GENERIC ObjectRange generic object
config.longitude FLOAT SAVE SETUP DoubleRange (-180.00 .. 180.00)
config.latitude FLOAT SAVE SETUP DoubleRange (-90.00 .. 90.00)
satellite CHOICE EnumRange (?)
copositioned TEXT R/O StringRange R/O
update TEXT NOPRESET StringRange
azimuth FLOAT NOPRESET DoubleRange DIS (0.0 .. 0.0)
elevation FLOAT NOPRESET DoubleRange DIS (0.0 .. 0.0)
polarization FLOAT NOPRESET DoubleRange DIS (0 .. 0)
orbit FLOAT NOPRESET DoubleRange (0.0 .. 0.0)
rxpolplane CHOICE SAVE NOPRESET EnumRange (H V)
polamount BOOLEAN R/O BooleanRange R/O (true false)
fixed BOOLEAN R/O BooleanRange R/O (true false)
orbitPassThrough BOOLEAN R/O BooleanRange R/O (true false)
locked BOOLEAN SAVE BooleanRange (true false)
faults.01 ALARM R/O AlarmFlagRange R/O (ACU Fault)
faults.02 ALARM R/O AlarmFlagRange R/O (ACU Warning)