1.8 APS-Backup-Antenna-Control

The APS-Backup-Antenna-Control logical device is a project specific extension to the sat-nms software. The device controls the switch over procedure between a backup antenna and a number of operative antennas.

Switching the uplink from an operative antenna to the backup antenna is a 2-step procedure. The first step (preparation) positions the backup antenna to the same satellite as the operative antenna and prepares the waveguide switches at the backup antenna for taking over the signal(s) from the operative antenna.

After the preparation has been completed successfully the final switchover is executed as an independent command. The actual switchover is performed by a APS-Backup-Antenna-Switch logical device located at the operative antenna. This sets the waveguide switches there to route the uplink to the backup antenna instead to the local one. Immediately after the switchover this device also increases the transmit power to compensate for the increased waveguide loss to the backup antenna. At the backup antenna M&C, Proxy devices act in place of the remote APS-Backup-Antenna-Switch devices.

Antenna command and verification

As of version 2.00 the APS-Backup-Antenna-Control device expects the backup antenna to be controlled by a SatService ACU/ODM ( SatService-ACU-ODM device driver). During the switchover preparation phase, the APS-Backup-Antenna-Control device commands a target memory number to the ACU/ODM. The target memory in the ACU contains the center of box coordinates of the satellite and the beacon/tracking parameters stored for the satellite normally tracked by the antenna which is going to be backed up.

The center of box coordinates are stored in the APS-Backup-Antenna-Control device's configuration file as well. After the the antenna has been commanded to move to the target in question, the APS-Backup-Antenna-Control device polls the actual antenna pointing and compared it to the pointing stored in the configuration file. Once the pointing matches within a configurable threshold, the APS-Backup-Antenna-Control device states "position reached" and proceeds to the next step.

With this next step the beacon level threshold fault is monitored. The device waits until there is no beacon level stated by the ACU, then the device assumes the antenna points to the satellite.

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

Most of the configuration parameters of the APS-Backup-Antenna-Control device are defined in a configuration file (see below). At the maintenance page of the device window there are a couple of configuration parameter which concern the local (backup) antenna device.

parameter description
antennaName The device name of the backup antenna controller. This device must be a NDSatCom-Step-Track device.
antennaTimeout The maximum time, the APS-Backup-Antenna-Control device waits after an antenna movement, that the antenna tracks the new satellite.
azThreshold The difference between measured and commanded antenna pointing accepted by the APS-Backup-Antenna-Control device to state 'position reached'.
elThreshold The difference between measured and commanded antenna pointing accepted by the APS-Backup-Antenna-Control device to state 'position reached'.

Fault flags

The device provides three fault flags:

Configuration file

The APS-Backup-Antenna-Control device requires to be setup by a configuration file. The file has the name of the device (case sensitive!) extended by the suffix '.txt'. The file must reside in the M&C server's home directory. It defines the number of stations this antenna shall backup, the antenna pointings and all switch setting to be performed during the preparation / switchover.

The file format text based, straight forward and almost self-explaining. This is a short example, taken from the real installation in Munich. Everything right of a '#' character is treated as a comment, in the example below those are used used to describe the file format.

#
#  Example for an APS-Backup-Antenna-Control configuration file
#
#
    S1-2X = A    # WG switch setting for the local operation
    S1-2Y = A    # of the backup antenna. The 'forceLocal' command
    S1-3X = A    # tells the APS-Backup-Antenna-Control to perform
    S1-3Y = A    # these settings
    S2-1X = A
    S2-1Y = A
    S1-AX = B
    S1-AY = B
    S2-AX = B
    S2-AY = B

#  The 'station' statement opens the definition of a antenna / M&C to backup.
#  '1A' is the name of the antenna which appears in the selection box a the 
#  APS-Backup-Antenna-Control's user interface.
#  
station 1A

    S1-2X = B    # The WG switch settings following the 'station' statement
    S1-2Y = B    # are performed when the operator commands to prepare the
    S1-3X = B    # take over for this antenna. They are performed immediately,
    S1-3Y = B    # before the antenna gets moved.

    # The 'antenna' statement tells the device where to point the antenna. It
    # must be followed by the target memory number to be invoked at the
    # antenna controller and the azimuth / elevation reference angles on
    # the same line. 
    # 
    antenna  2  169.958  34.115 

    SU-4X = B    # After the antenna has been pointed to the new satellite and
    SU-4Y = B    # tracking has found the satellite, the WG switch settings
    SU-3X = B    # following the 'antenna' statement are performed. After
    SU-3Y = B    # these settings have been verified successfully, the
    S1-AX = A    # backup antenna is prepared for the switchover.
    S1-AY = A   

    # The 'final' statement closes the definition opened by 'station'. It
    # tells the APS-Backup-Antenna-Control device which proxy device
    # has to be controlled in order to execute the actual switchover at the
    # remote antenna. The proxy device must be configured to act for the
    # APS-Backup-Antenna-Switch device at the M&C of interrest.
    # 
    final ASTRA-1A

#  Here starts the definition of the second station (omitted here). The 
#  APS-Backup-Antenna-Control device is capable to manage an arbitrary number
#  of stations.
#  
station 1B
                        

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.antennaName TEXT SAVE SETUP StringRange
config.antennaTimeout INTEGER SAVE SETUP IntegerRange (1 .. 15)
config.azThreshold FLOAT SAVE SETUP DoubleRange (0.000 .. 1.000)
config.elThreshold FLOAT SAVE SETUP DoubleRange (0.000 .. 1.000)
station CHOICE EnumRange (??)
prepare TEXT StringRange DIS
release TEXT StringRange DIS
switchTo TEXT StringRange DIS
switchBack TEXT StringRange DIS
forceLocal TEXT StringRange
progressReport TEXT R/O StringRange R/O
progressIcon TEXT R/O StringRange R/O
reset TEXT StringRange
faults.01 ALARM R/O AlarmFlagRange R/O (Configuration file)
faults.02 ALARM R/O AlarmFlagRange R/O (Switch combination)
faults.03 ALARM R/O AlarmFlagRange R/O (Switchover procedure)