Change in osmo-bsc[master]: doc/manuals: add documentation for interference reporting

[fixeria]

fixeria has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/26056 )


Change subject: doc/manuals: add documentation for interference reporting
......................................................................

doc/manuals: add documentation for interference reporting

Change-Id: I3c15b11bbcba0811e3a15fe64365067bf8ad0dae
Related: SYS#5313
---
A doc/manuals/chapters/interf_meas.adoc
M doc/manuals/osmobsc-usermanual.adoc
2 files changed, 46 insertions(+), 0 deletions(-)



  git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/56/26056/1

diff --git a/doc/manuals/chapters/interf_meas.adoc b/doc/manuals/chapters/interf_meas.adoc
new file mode 100644
index 0000000..b3b2e42
--- /dev/null
+++ b/doc/manuals/chapters/interf_meas.adoc
@@ -0,0 +1,44 @@
+== Interference reporting
+
+According to 3GPP 48.058, section 6.1, the BTS shall periodically report the
+interference levels on *idle* channels using the "Radio resource indication"
+procedure.  This is done by sending the `RF RESource INDication` message,
+which is specified in sections 8.6.1 and 9.3.21.
+
+// TODO: BSC -> MSC reporting (3GPP TS 48.008, section 3.1.3)
+
+=== Interference reporting parameters
+
+The interference band is calculated by the BTS based on the `Interference level
+Boundaries` and the `Averaging period`.  These parameters are sent by the BSC
+over the A-bis/OML, and can be configured via the VTY interface.
+
+Below are the default values for them:
+
+----
+network
+ bts 0
+  interference-meas avg-period 6 <1>
+  interference-meas level-bounds -85 <2> -91 -97 -103 -109 -115 <3>
+----
+<1> Averaging period (`Intave`) in SACCH multiframe periods (480ms).
+<2> Interference level boundary `0` (in dBm).
+<3> Interference level boundary `X5` (in dBm).
+
+The `Intave` parameter defines the averaging period, so with the default value
+of 6 SACCH multiframe periods the BTS is instructed to report interference
+levels approximately every 3 seconds.  Before reporting to the BSC, the BTS
+maps each interference level (in dBm) to one of the 5 bands using the given
+boundaries.
+
+----
+-85 dBm    -91 dBm    -97 dBm   -103 dBm   -109 dBm   -115 dBm
+   |          |          |          |          |          |
+   +----------+----------+----------+----------+----------+
+   |  band 1  |  band 2  |  band 3  |  band 4  |  band 5  |
+   +----------+----------+----------+----------+----------+
+----
+
+// FIXME: what happens if a value is below -115 dBm or above -85 dBm
+// TODO: document PDCH interference reporting
+// TODO: dynamic timeslot handling
diff --git a/doc/manuals/osmobsc-usermanual.adoc b/doc/manuals/osmobsc-usermanual.adoc
index 120fe2c..0afa015 100644
--- a/doc/manuals/osmobsc-usermanual.adoc
+++ b/doc/manuals/osmobsc-usermanual.adoc
@@ -26,6 +26,8 @@
 
 include::{srcdir}/chapters/power_control.adoc[]
 
+include::{srcdir}/chapters/interf_meas.adoc[]
+
 include::{srcdir}/chapters/handover.adoc[]
 
 include::{srcdir}/chapters/smscb.adoc[]

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/26056
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: I3c15b11bbcba0811e3a15fe64365067bf8ad0dae
Gerrit-Change-Number: 26056
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/20211101/a4229269/attachment.htm>