This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
fixeria gerrit-no-reply at lists.osmocom.orgfixeria has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/21886 )
Change subject: power_control: add documentation on available configuration params
......................................................................
power_control: add documentation on available configuration params
Change-Id: Ib65d33f0f1dd24d39e3be581e4e072a310bc906a
Related: SYS#4918
---
A doc/manuals/chapters/power_control.adoc
M doc/manuals/osmobsc-usermanual.adoc
2 files changed, 249 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/86/21886/1
diff --git a/doc/manuals/chapters/power_control.adoc b/doc/manuals/chapters/power_control.adoc
new file mode 100644
index 0000000..de0c43b
--- /dev/null
+++ b/doc/manuals/chapters/power_control.adoc
@@ -0,0 +1,247 @@
+== Power control
+
+The objective of power control is to regulate the transmit power of the MS (Uplink)
+as well as the BTS (Downlink) in order to achieve the optimal reception conditions,
+i.e. a desired signal strength and a desired signal quality.
+
+There are two advantages of power control:
+
+- reduction of the average power consumption (especially in the MS), and
+- reduction of the co-channel interference for adjacent channel users.
+
+Power control can be performed either by the BSC, or by the BTS autonomously.
+OsmoBSC currently lacks the power control logic, so it cannot act as the regulating
+entity, however it's capable to instruct a BTS that supports autonomous power
+control to perform the power regulation. This is achieved by including vendor-
+specific IEs with power control parameters in the channel activation messages
+on the A-bis/RSL interface.
+
+=== Power control parameters
+
+Unfortunately, 3GPP specifications do not specify the exact list of power control
+parameters and their encoding on the A-bis/RSL interface, so it's up to a BTS/BSC
+vendor what to send and in which format. Furthermore, there is no public
+documentation on which parameters are accepted by particular BTS models.
+
+3GPP TS 44.008 nonetheless defines a minimal set of parameters for a general power
+control algorithm. OsmoBSC allows to configure these parameters via the VTY
+interface, this is further described in the next sections.
+
+So far only the ip.access specific format is implemented, so it should be possible
+to enable power control for nanoBTS. OsmoBTS also accepts this format, but may
+ignore some of the received parameters due to incomplete implementation.
+
+=== Power control configuration
+
+Two identical groups of parameters are available for both MS (Uplink) and BS
+(Downlink) power control. This chapter is aimed to put some light on them.
+
+All parameters can be set via the VTY interface, currently within the scope of
+a BTS. This means that all transceivers will 'inherit' the same configuration.
+
+----
+OsmoBSC(config)# network
+OsmoBSC(config-net)# bts 0
+OsmoBSC(config-net-bts)# ?
+...
+ bs-power-control BS (Downlink) power control parameters
+ ms-power-control MS (Uplink) power control parameters
+...
+----
+
+Either of these commands would lead to a separate node:
+
+----
+OsmoBSC(config-net-bts)# ms-power-control
+OsmoBSC(config-ms-power-ctrl)# list with-flags
+...
+ . l. mode (static|dyn-bts) [reset]
+ . l. bs-power (static|dyn-max) <0-30>
+ . lv step-size inc <2-6> red <2-4>
+ . lv rxlev-thresh lower <0-63> upper <0-63>
+ . lv rxqual-thresh lower <0-7> upper <0-7>
+ . lv rxlev-thresh-comp lower <0-31> <0-31> upper <0-31> <0-31>
+ . lv rxqual-thresh-comp lower <0-31> <0-31> upper <0-31> <0-31>
+ . lv no (rxlev-avg|rxqual-avg)
+ . lv (rxlev-avg|rxqual-avg) params hreqave <1-31> hreqt <1-31>
+ . lv (rxlev-avg|rxqual-avg) algo (unweighted|weighted|mod-median)
+ . lv (rxlev-avg|rxqual-avg) algo osmo-ewma beta <1-99>
+----
+
+NOTE: flag 'v' indicates that a given parameter is vendor specific, so different
+BTS vendors/models may ignore or even reject it. Flag 'l' indicates that changing
+a given parameter at run-time would affect only the new connections.
+
+==== Power control mode
+
+Three power control modes exist:
+
+----
+OsmoBSC(config-ms-power-ctrl)# mode ?
+ static Instruct the MS/BTS to use a static power level <1>
+ dyn-bts Power control to be performed dynamically by the BTS itself <2>
+OsmoBSC(config-net-bts)# no (bs-power-control|ms-power-control) <3>
+----
+<1> and <2> are briefly described in the interactive VTY help.
+<3> Do not send any power control IEs in RSL CHANnel ACTIVation messages.
+
+By default, `static` mode is used for BS power control, while `dyn-bts` is used
+for MS power control. Changing the mode at run-time would not affect already
+established connections, only the new ones (check flag 'l').
+
+For BS power control, there is an additional parameter:
+
+----
+OsmoBSC(config-bs-power-ctrl)# bs-power ?
+ static Fixed BS Power reduction value (for static mode) <1>
+ dyn-max Maximum BS Power reduction value (for dynamic mode) <2>
+----
+
+that allows to configure the maximum BS power reduction value in `dyn-bts` mode,
+and a fixed power reduction value in `static` mode. In the later case, no
+attenuation (0 dB) is applied by default (full power).
+
+==== Power change step size
+
+In order to slow down the reactivity of the power control loop and thus make it more
+robust against sporadic fluctuations of the input values (RxLev and RxQual), the
+transmit power on both Uplink and Downlink is changed gradually, step by step.
+
+OsmoBSC allows to configure the step sizes for both increasing and reducing directions
+separately. The corresponding power control loop would apply different delta values
+to the current transmit power level in order to raise or lower it.
+
+.Example: Power change step size
+----
+network
+ bts 0
+ bs-power-control
+ mode dyn-bts <0>
+ bs-power dyn-max 12 <1>
+ step-size inc 6 red 4 <2>
+ ms-power-control
+ mode dyn-bts <0>
+ step-size inc 4 red 2 <3>
+----
+<0> Both MS and BS power control is to be performed by the BTS autonomously.
+<1> The BTS is allowed to reduce the power on Downlink up to 12 dB.
+<2> On Downlink, the power can be increased by 6 dB or reduced by 4 dB at once.
+<3> On Uplink, the power can be increased by 4 dB or reduced by 2 dB at once.
+
+It's recommended to pick the values in a way that the increase step is greather than
+the reduce step. This way the system would be able to react on signal degradation
+quickly, while a good signal would not trigger radical power reduction.
+
+Both parameters are mentioned in 3GPP TS 45.008, table A.1:
+
+- Pow_Incr_Step_Size (range 2, 4 or 6 dB),
+- Pow_Red_Step_Size (range 2 or 4 dB).
+
+==== RxLev and RxQual thresholds
+
+The general idea of power control is to maintain the signal level (RxLev) and quality
+(RxQual) within the target ranges. Each of these ranges can be defined as a pair of
+the lowest and the highest acceptable values called thresholds.
+
+The process of RxLev / RxQual threshold comparison is described in 3GPP TS 45.008,
+section A.3.2.1. All parameters involved in the process can be found in table
+A.1 with the recommended default values.
+
+.Example: RxLev and RxQual threshold configuration
+----
+network
+ bts 0
+ bs-power-control
+ mode dyn-bts <0>
+ rxlev-thresh lower 32 upper 38 <1>
+ rxqual-thresh lower 3 upper 0 <2>
+----
+<0> BS power control is to be performed by the BTS autonomously.
+<1> RxLev is to be maintained in range 32 .. 38 (-78 .. -72 dBm).
+<2> RxQual is to be maintained in range 3 .. 0 (lower is better).
+
+In 3GPP TS 45.008, <1> is refered as `L_RXLEV_XX_P` and `U_RXLEV_XX_P`, while <2>
+is refered as `L_RXQUAL_XX_P` and `U_RXQUAL_XX_P`, where XX is DL or UL.
+
+The process of threshold comparison actually involves more than just upper and lower
+values for RxLev and RxQual. The received 'raw' measurements are being averaged and
+stored in a circular buffer, so the power change is triggered only if Pn averages out
+of Nn averages exceed the corresponding thresholds.
+
+.Example: RxLev and RxQual threshold comparators
+----
+network
+ bts 0
+ bs-power-control
+ mode dyn-bts <0>
+ rxlev-thresh lower 32 upper 38
+ rxlev-thresh-comp lower 10 12 <1> upper 19 20 <2>
+ rxqual-thresh lower 3 upper 0
+ rxqual-thresh-comp lower 5 7 <3> upper 15 18 <4>
+----
+<0> BS power control is to be performed by the BTS autonomously.
+<1> P1=10 out of N1=12 averages < L_RXLEV_XX_P => increase power.
+<2> P2=19 out of N2=20 averages > U_RXLEV_XX_P => decrease power.
+<3> P3=5 out of N3=7 averages > L_RXQUAL_XX_P => increase power.
+<4> P4=15 out of N4=18 averages < U_RXQUAL_XX_P => decrease power.
+
+==== Measurement averaging process
+
+3GPP 45.008, section A.3.1 requires that the measurement values reported by a MS or
+the BTS must be pre-processed before appearing on the input of the corresponding
+power control loops in any of the following ways:
+
+- Unweighted average;
+- Weighted average, with the weightings determined by O&M;
+- Modified median calculation, with exceptionally high and low values
+ (outliers) removed before the median calculation.
+
+----
+OsmoBSC(config-bs-power-ctrl)# rxlev-avg algo ?
+ unweighted Un-weighted average
+ weighted Weighted average
+ mod-median Modified median calculation
+ osmo-ewma Exponentially Weighted Moving Average (EWMA)
+----
+
+OsmoBTS features a non-standard Osmocom specific EWMA (Exponentially Weighted Moving
+Average) based method. Other BTS models may support additional non-standard methods
+too.
+
+.Example: Implicit pre-processing configuration
+----
+network
+ bts 0
+ bs-power-control
+ mode dyn-bts <0>
+ no rxlev-avg <1>
+ no rxqual-avg <1>
+----
+<0> BS power control is to be performed by the BTS autonomously.
+<1> Do not indicate pre-processing configuration explicitly, use BTS defaults.
+
+Among with the averaging methods, 3GPP 45.008 also defines two pre-processing
+parameters in section A.3.1:
+
+- Hreqave - defines the period over which an average is produced, in terms of the
+ number of SACCH blocks containing measurement results, i.e. the number of
+ measurements contributing to each averaged measurement;
+
+- Hreqt - is the number of averaged results that are maintained.
+
+.Example: Explicit pre-processing configuration
+----
+network
+ bts 0
+ ms-power-control
+ mode dyn-bts <0>
+ rxlev-avg algo unweighted <1>
+ rxlev-avg params hreqave 4 hreqt 6 <2>
+ rxqual-avg algo osmo-ewma beta 50 <3>
+ rxqual-avg params hreqave 2 hreqt 3 <4>
+----
+<0> BS power control is to be performed by the BTS autonomously.
+<1> Unweighted average is applied to RxLev values.
+<2> RxLev Hreqave and Hreqt values: 4 out of 6 SACCH blocks produce an averaged measurement.
+<3> Osmocom specific EWMA is applied to RxQual values with smoothing factor = 50% (beta=0.5).
+<4> RxQual: Hreqave and Hreqt values: 2 out of 3 SACCH blocks produce an averaged measurement.
diff --git a/doc/manuals/osmobsc-usermanual.adoc b/doc/manuals/osmobsc-usermanual.adoc
index a084a51..e66b2be 100644
--- a/doc/manuals/osmobsc-usermanual.adoc
+++ b/doc/manuals/osmobsc-usermanual.adoc
@@ -24,6 +24,8 @@
include::{srcdir}/chapters/bsc.adoc[]
+include::{srcdir}/chapters/power_control.adoc[]
+
include::{srcdir}/chapters/handover.adoc[]
include::{srcdir}/chapters/smscb.adoc[]
--
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/21886
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: Ib65d33f0f1dd24d39e3be581e4e072a310bc906a
Gerrit-Change-Number: 21886
Gerrit-PatchSet: 1
Gerrit-Owner: fixeria <vyanitskiy at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20201228/a1b3c091/attachment.htm>