<p>fixeria has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/26056">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">doc/manuals: add documentation for interference reporting<br><br>Change-Id: I3c15b11bbcba0811e3a15fe64365067bf8ad0dae<br>Related: SYS#5313<br>---<br>A doc/manuals/chapters/interf_meas.adoc<br>M doc/manuals/osmobsc-usermanual.adoc<br>2 files changed, 46 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/56/26056/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/interf_meas.adoc b/doc/manuals/chapters/interf_meas.adoc</span><br><span>new file mode 100644</span><br><span>index 0000000..b3b2e42</span><br><span>--- /dev/null</span><br><span>+++ b/doc/manuals/chapters/interf_meas.adoc</span><br><span>@@ -0,0 +1,44 @@</span><br><span style="color: hsl(120, 100%, 40%);">+== Interference reporting</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+According to 3GPP 48.058, section 6.1, the BTS shall periodically report the</span><br><span style="color: hsl(120, 100%, 40%);">+interference levels on *idle* channels using the "Radio resource indication"</span><br><span style="color: hsl(120, 100%, 40%);">+procedure.  This is done by sending the `RF RESource INDication` message,</span><br><span style="color: hsl(120, 100%, 40%);">+which is specified in sections 8.6.1 and 9.3.21.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+// TODO: BSC -> MSC reporting (3GPP TS 48.008, section 3.1.3)</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Interference reporting parameters</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The interference band is calculated by the BTS based on the `Interference level</span><br><span style="color: hsl(120, 100%, 40%);">+Boundaries` and the `Averaging period`.  These parameters are sent by the BSC</span><br><span style="color: hsl(120, 100%, 40%);">+over the A-bis/OML, and can be configured via the VTY interface.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Below are the default values for them:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+network</span><br><span style="color: hsl(120, 100%, 40%);">+ bts 0</span><br><span style="color: hsl(120, 100%, 40%);">+  interference-meas avg-period 6 <1></span><br><span style="color: hsl(120, 100%, 40%);">+  interference-meas level-bounds -85 <2> -91 -97 -103 -109 -115 <3></span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> Averaging period (`Intave`) in SACCH multiframe periods (480ms).</span><br><span style="color: hsl(120, 100%, 40%);">+<2> Interference level boundary `0` (in dBm).</span><br><span style="color: hsl(120, 100%, 40%);">+<3> Interference level boundary `X5` (in dBm).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The `Intave` parameter defines the averaging period, so with the default value</span><br><span style="color: hsl(120, 100%, 40%);">+of 6 SACCH multiframe periods the BTS is instructed to report interference</span><br><span style="color: hsl(120, 100%, 40%);">+levels approximately every 3 seconds.  Before reporting to the BSC, the BTS</span><br><span style="color: hsl(120, 100%, 40%);">+maps each interference level (in dBm) to one of the 5 bands using the given</span><br><span style="color: hsl(120, 100%, 40%);">+boundaries.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+-85 dBm    -91 dBm    -97 dBm   -103 dBm   -109 dBm   -115 dBm</span><br><span style="color: hsl(120, 100%, 40%);">+   |          |          |          |          |          |</span><br><span style="color: hsl(120, 100%, 40%);">+   +----------+----------+----------+----------+----------+</span><br><span style="color: hsl(120, 100%, 40%);">+   |  band 1  |  band 2  |  band 3  |  band 4  |  band 5  |</span><br><span style="color: hsl(120, 100%, 40%);">+   +----------+----------+----------+----------+----------+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+// FIXME: what happens if a value is below -115 dBm or above -85 dBm</span><br><span style="color: hsl(120, 100%, 40%);">+// TODO: document PDCH interference reporting</span><br><span style="color: hsl(120, 100%, 40%);">+// TODO: dynamic timeslot handling</span><br><span>diff --git a/doc/manuals/osmobsc-usermanual.adoc b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>index 120fe2c..0afa015 100644</span><br><span>--- a/doc/manuals/osmobsc-usermanual.adoc</span><br><span>+++ b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>@@ -26,6 +26,8 @@</span><br><span> </span><br><span> include::{srcdir}/chapters/power_control.adoc[]</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+include::{srcdir}/chapters/interf_meas.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> include::{srcdir}/chapters/handover.adoc[]</span><br><span> </span><br><span> include::{srcdir}/chapters/smscb.adoc[]</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/26056">change 26056</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-bsc/+/26056"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-bsc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I3c15b11bbcba0811e3a15fe64365067bf8ad0dae </div>
<div style="display:none"> Gerrit-Change-Number: 26056 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: fixeria <vyanitskiy@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>