The Antenna-Pointing-Fixed logical device is a variant of the Antenna-Pointing device for non-motorized antennas. Such (small) antennas may view multiple satellites at a time. The Antenna-Pointing-Fixed device permits to define these satellites in the satellites list of the device, thus making the antenna work together with RX-Channel or RX-LineSettings-CDB devices.
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 .
--- Contains the antenna pointing values, the selected satellite name and the orbit position of this satellite. You should use this page if you want to move the antenna to a certain orbit position.
--- The list of satellite positions. You can select a satellite to move the antenna to with this page and you can maintain the satellite list.
--- The device info page.
--- The maintenance page. The configuration parameters described below are set at this page.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
- page.
- page. Optimize the antenna pointing. Then switch to the
- 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.
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 | SETUP | StringRange DIS |
| config.elId | TEXT | SETUP | StringRange DIS |
| config.polId | TEXT | SETUP | StringRange DIS |
| config.orbitId | TEXT | SETUP | StringRange DIS |
| 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) |