The Antenna-Pointing-ODM logical device is a special version of the Antenna-Pointing device for use with the SatService-ACU-ODM device. Unlike the standard version of the device, this specialized version uses the target memories stored in the ACU as the satellite list rather than maintaining a separate list for this.
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 store or delete target definitions 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. |
| odmDevice | The device name of the ACU/ODM. This must be a SatService-ACU-ODM device, the Antenna-Pointing-ODM device does not work with other antenna controllers. |
| 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. |
| diameter | The antenna's dish diameter in meters. This is used by the RX-Channel device when sorting antennas by size in activation based mode. |
| 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. |
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 .
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.
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.odmDevice | 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.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 |
| azimuth | FLOAT | NOPRESET | DoubleRange (0.0 .. 0.0) |
| elevation | FLOAT | NOPRESET | DoubleRange (0.0 .. 0.0) |
| polarization | FLOAT | NOPRESET | DoubleRange (0 .. 0) |
| orbit | FLOAT | NOPRESET | DoubleRange (0.0 .. 0.0) |
| rxpolplane | CHOICE | SAVE NOPRESET | EnumRange (H V) |
| 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) |