The Uplink-Power-Control logical device adjusts the level of a transmit signal in order to compensate the atmospheric attenuation in the signal uplink. To achieve this, the Uplink-Power-Control logical device reads the level of the satellite's beacon from a beacon receiver. The decrease of the beacon level with respect to it's 'clear sky' value describes the degree of downlink atmospheric attenuation which is used to estimate the atmospheric attenuation in the uplink.

The Uplink-Power-Control logical device must not use the level indication of the signal received back from the satellite instead of the beacon level. This would create a 'closed loop' level control which tends to oscillate or at least overshoot in an impermissible way.

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 interconnect the Level-Set device to the devices it monitors and controls.

parameter description
pwrSetId The parameter ID which controls the transmit level. In most cases this will be the 'eirp' parameter of the Level-Set or Level-Control logical device which controls the transmit power. If no Level-Set or Level-Control device is used, a modulator level or upconverter gain parameter may be used as well.
pwrMeasId The ID of the parameter indicating the satellite beacon level.
txFrequencyId You may enter a parameter ID here which reports the transmit frequency if you want make the device calculate the control ratio automatically. Please note that the frequency parameter must report the true RF transmit frequency in MHz. IF or L-band frequency settings cannot be used for this.
rxFrequencyId You may enter a parameter ID here which reports the satellite beacon frequency if you want make the device calculate the control ratio automatically. Please note that the frequency parameter must report the true RF frequency of the beacon in MHz. IF or L-band frequency settings cannot be used for this.
resetOnDisable This parameter controls the behaviour of the UPC when it gets disabled. When resetOnDisable is set to 'NO' (this is the default setting), then the output power will stay at it's last value before the UPC was switched OFF. With resetOnDisable set to 'YES' the output power will be reset to it's nominal value if the UPC ist switched off.
inhibitId If this parameter is not empty, the device listens to the parameter with this ID and inhibits the control loop if the parameter value matches the value of 'inhibitVal'
inhibitVal If an 'inhibitId' is given, this parameter should contain the value which triggers the inhibit state. Without an 'inhibitId' this parameter is ignored.
inhibitMode May be one of 'LATCHING' or 'MOMENTARY'. With LATCHING (which is the default) the device remains inhibited even if the inhibit condition is no longer present. Only a reset command clears the inhibit state in this mode. With MOMENTARY the inhibit data gets automatically cleared if the inhibit condition disappears.
ltFaultDelay This parameter defines the time (minutes) the 'power increase' fault must be constantly active to set the 'long term power increase' fault
logLevelEnableId This parameter can be used to control the logging of gain/level changes at the controlled HPA in a way, that the logging gets suppressed while the UPC is running. This prevents the log from being flooded with parameter change messages caused by the level regulation of the UPC. When the UPC is disabled, the logging is enabled again. If this parameter is not empty, the device send the value "OFF" to this ID when the upcEnable is set to "ON" and vice versa.
redundancyOffset This offset gets added to the nominal output level of this device and then set as nominal output of the redundant UPC by a Protection-Switch-N-To-1. Set this to the level difference the redundant path has with respect to this path.

Clear Sky Settings

Before the uplink power control can work, it must know the nominal values for the transmit power and the beacon level under clear sky conditions. You may enter these values to the appropriate fields at the primary device window page of the device. However, the more comfortable way is to press the 'CLEAR SKY' button once the transmit level has been setup properly. The this function also may be used to re-adjust the nominal values from time to time in order to compensate for some gain drift.

Control Ratio

The device has to estimate the atmospheric attenuation in the uplink from a lowering of the beacon (downlink) level. As transmission usually is done at higher frequencies than the downlink, the uplink atmospheric attenuation will be higher than the measured beacon level degradation.

The 'ratio' parameter found at the 'Advanced Parameters' page defines the uplink/downlink atmospheric attenuation ratio to be applied. You may set this value manually or let the device calculate it from the transmit / receive frequencies (ratio mode = 'AUTO'). E.g. for the Ku-band a ratio of 1.2 may be used which means that the transmit power gets increased by 1.2 dB if the beacon level falls by 1 dB.

When using the automatic mode, the device calculates the ratio from the frequency values shown at the same page. If you did set the 'txFrequencyId' and 'rxFrequencyId' configuration parameters, the frequency value are read automatically from the real settings. If you didn't configure this, you have to enter the frequency values manually.

Filtering And Hysteresis

The device provides some parameters to adjust the behaviour of the control that it does not react on every glitch in the beacon level. These parameter are:

Output Power Slope Limit

The device is capable to limit the slope of the commanded output power to user defined values. This means, a leap of the input power does not lead to an output power leap, the output power is commanded step by step to reach its target value with the given slope.

Power increment / decrement slopes are defined in dB/sec, the device internally interprets this as dB / driver cycle. Please ensure, that the IDLE time of the interface containing the Uplink-Power-Control device is set to 1000 msecs to match 'dB/sec' and 'dB / driver cycle'.

To enable the slope limits, set the parameter 'speed limit' to 'YES' and the slope values as desired.

Limits And Fault Detection

The device provides two parameters to limit the amount of transmit power adjustment:

Additionally, the device reports a 'long term power increase' fault which becomes active, when the 'power increase fault' is constantly active for a given time. This fault is latching am mut be reset by the 'RST FLT' button to be cleared. The duration how long the 'power increase fault' must be active to trigger this fault is tunable as a configuration parameter.

Beside the limit values discussed above, the device provides a parameter called drop threshold . If this parameter is set to a non zero value, the device permanently monitors the change of the beacon level from one reading to the next. If the beacon level suddenly falls by an amount larger than the threshold set, the uplink power control gets stopped before this dubitable value is processed. The device raises a 'Drop detected' fault and stops working until the RESET button ist pressed to clear the fault. This behaviour shall prevent the device from setting the transmit power to it's maximum in case of a failure or maloperation of the beacon receiver.

Inhibiting the UPC

The device is capable to watch an external parameter value and inhibit the UPC processing if this parameter turns to a certain value. This way for example a LNB fault can be watched and used to to inhibit the control loop in case of an error.

The inhibit state is latching, it must be cleared manually by pressing 'RST INH'. Depending on the 'resetOnDisable' mode, the control loop freezes when inhibited (resetOnDisable=NO) or reverts to the nominal output power (resetOnDisable=YES) when inhibited.

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.pwrSetId TEXT SAVE SETUP StringRange
config.pwrMeasId TEXT SAVE SETUP StringRange
config.txFrequencyId TEXT SAVE SETUP StringRange
config.rxFrequencyId TEXT SAVE SETUP StringRange
config.resetOnDisable CHOICE SAVE SETUP EnumRange (NO YES)
config.inhibitId TEXT SAVE SETUP StringRange
config.inhibitVal TEXT SAVE SETUP StringRange
config.inhibitMode CHOICE SAVE SETUP EnumRange (LATCHING MOMENTARY)
config.ltFaultDelay INTEGER SAVE SETUP IntegerRange (0 .. 0)
config.logLevelEnableId TEXT SAVE SETUP StringRange
config.redundancyOffset FLOAT SAVE SETUP DoubleRange (-10.00 .. 10.00)
nominalOutput FLOAT SAVE DoubleRange (0.00 .. 0.00)
nominalInput FLOAT SAVE DoubleRange (0.00 .. 0.00)
upcEnable CHOICE SAVE EnumRange (OFF ON)
maxPwrIncrease FLOAT SAVE DoubleRange (0.00 .. 60.00)
maxPwrDecrease FLOAT SAVE DoubleRange (0.00 .. 60.00)
maxPwrIncSpeed FLOAT SAVE DoubleRange (0.1 .. 10.0)
maxPwrDecSpeed FLOAT SAVE DoubleRange (0.1 .. 10.0)
clearSkyHysteresis FLOAT SAVE DoubleRange (0.00 .. 10.00)
outputHysteresis FLOAT SAVE DoubleRange (0.00 .. 10.00)
filter CHOICE SAVE EnumRange (OFF 1 Hz 0.5 Hz 0.2 Hz 0.1 Hz 0.05 Hz 0.02 Hz 0.01 Hz 0.005 Hz 0.002 Hz 0.001 Hz)
ratio FLOAT SAVE DoubleRange (0.00 .. 5.00)
ratioMode CHOICE SAVE EnumRange (MANUAL AUTO)
limitPwrSpeed CHOICE SAVE EnumRange (NO YES)
txFrequency FLOAT SAVE DoubleRange (0.000 .. 0.000)
rxFrequency FLOAT SAVE DoubleRange (0.000 .. 0.000)
dropThreshold FLOAT SAVE DoubleRange (0.00 .. 0.00)
clearSkyNow TEXT NOPRESET StringRange
reset TEXT NOPRESET StringRange
clearInhibit TEXT NOPRESET StringRange
clearLtFault TEXT NOPRESET StringRange
inputDelta FLOAT R/O DoubleRange R/O (0.00 .. 0.00)
outputDelta FLOAT R/O DoubleRange R/O (0.00 .. 0.00)
inputPower FLOAT R/O DoubleRange R/O (0.00 .. 0.00)
outputPower FLOAT R/O DoubleRange R/O (0.00 .. 0.00)
adjusting BOOLEAN R/O BooleanRange R/O (true false)
inhibited BOOLEAN R/O BooleanRange R/O (true false)
saved.faults.03 BOOLEAN SAVE BooleanRange (true false)
saved.faults.06 BOOLEAN SAVE BooleanRange (true false)
faults.01 ALARM R/O AlarmFlagRange R/O (Power decrease limit)
faults.02 ALARM R/O AlarmFlagRange R/O (Power increase limit)
faults.03 ALARM R/O AlarmFlagRange R/O (Drop detected)
faults.04 ALARM R/O AlarmFlagRange R/O (Long term pwr increase)
faults.05 ALARM R/O AlarmFlagRange R/O (UPC Off)
faults.06 ALARM R/O AlarmFlagRange R/O (Inhibited)