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 .
--- This page shows the operational parameters.
--- 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 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) |