<p>Harald Welte <strong>merged</strong> this change.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bts/+/14334">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  Harald Welte: Looks good to me, approved
  Jenkins Builder: Verified

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">trx: Update documentation for fn-advance and rts-advance<br><br>Change-Id: I83eff296bfb7acff9d8560b5346bd9791fe6e7d9<br>Related: OS#4036<br>---<br>M doc/manuals/chapters/bts-models.adoc<br>1 file changed, 45 insertions(+), 2 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/bts-models.adoc b/doc/manuals/chapters/bts-models.adoc</span><br><span>index 4ae73c0..e1f8d9a 100644</span><br><span>--- a/doc/manuals/chapters/bts-models.adoc</span><br><span>+++ b/doc/manuals/chapters/bts-models.adoc</span><br><span>@@ -245,10 +245,53 @@</span><br><span> Set the number of frames to be transmitted to transceiver in advance of</span><br><span> current GSM frame number.</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+GSM is a TDMA (time division multiple access) system on the radio</span><br><span style="color: hsl(120, 100%, 40%);">+interface.  OsmoTRX is the "clock master" of that in the Osmocom</span><br><span style="color: hsl(120, 100%, 40%);">+implementation. It informs OsmoBTS of the current GSM frame</span><br><span style="color: hsl(120, 100%, 40%);">+number.  However, as there is non-zero delays (UDP packet trnsmission</span><br><span style="color: hsl(120, 100%, 40%);">+delay, operating system scheduler delay on both OsmoTRX and OsmoBTS</span><br><span style="color: hsl(120, 100%, 40%);">+side, ...), OsmoBTS must compensate for that delay by "advancing"</span><br><span style="color: hsl(120, 100%, 40%);">+the clock a certain amount of time.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+In other words, if OsmoTRX informs us that the current frame number is N,</span><br><span style="color: hsl(120, 100%, 40%);">+we advance it by `fn-advance` and transmit burst data for</span><br><span style="color: hsl(120, 100%, 40%);">+`N + fn-advance` towards OsmoTRX.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The fn-advance should be kept as low as possible to avoid additional</span><br><span style="color: hsl(120, 100%, 40%);">+delays to the user voice plane as well as to improve the performance</span><br><span style="color: hsl(120, 100%, 40%);">+of the control plane (LAPDm) as well as GPRS.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+However, fn-advance must be kept sufficiently high to ensure no</span><br><span style="color: hsl(120, 100%, 40%);">+underruns on the OsmoTRX side.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The detailed value will depend on your underlying computer systems,</span><br><span style="color: hsl(120, 100%, 40%);">+operating system and related tuning parameters.  Running OsmoTRX</span><br><span style="color: hsl(120, 100%, 40%);">+on a remote host will inevitably require a higher fn-advance then</span><br><span style="color: hsl(120, 100%, 40%);">+running it on the same machine, where the UDP packetes are just passed</span><br><span style="color: hsl(120, 100%, 40%);">+over the loopback device.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The default value for `fn-advance` is 20 (corresponding to 92</span><br><span style="color: hsl(120, 100%, 40%);">+milliseconds).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> ===== `osmotrx rts-advance <0-30>`</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-Set the number of frames to be requested from PCU in advance of current</span><br><span style="color: hsl(0, 100%, 40%);">-frame number.  Do not change this unless you have a good reason!</span><br><span style="color: hsl(120, 100%, 40%);">+Set the number of frames to be requested from L1SAP in advance of current</span><br><span style="color: hsl(120, 100%, 40%);">+frame number and fn-advance.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The value specified as `rts-advance` is added to the current GSM frame</span><br><span style="color: hsl(120, 100%, 40%);">+number as reported by OsmoTRX *and* the `osmotrx fn-advance` in order</span><br><span style="color: hsl(120, 100%, 40%);">+to generate the PH-RTS.ind (ready to send indications) across the L1SAP</span><br><span style="color: hsl(120, 100%, 40%);">+interface inside osmo-bts.  This will trigger the Layer 2 (LAPDm for</span><br><span style="color: hsl(120, 100%, 40%);">+the ocntrol plane, RTP for the voice plane, and OsmoPCU for GPRS) to</span><br><span style="color: hsl(120, 100%, 40%);">+generate a MAC block and input it into the osmo-bts-trx TDMA scheduler.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+If OsmoTRX reported N as the current frame number, the actual frame number</span><br><span style="color: hsl(120, 100%, 40%);">+reported on L1SAP to higher layes will be computed as follows:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  N + fn-advance + rts-advance</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The default value of `rts-advance` is 5 (corresponding to 23 milliseconds).</span><br><span style="color: hsl(120, 100%, 40%);">+Do not change this unless you have a good reason!</span><br><span> </span><br><span> ===== `osmotrx rx-gain <0-50>`</span><br><span> </span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bts/+/14334">change 14334</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-bts/+/14334"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-bts </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I83eff296bfb7acff9d8560b5346bd9791fe6e7d9 </div>
<div style="display:none"> Gerrit-Change-Number: 14334 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </div>
<div style="display:none"> Gerrit-Owner: Harald Welte <laforge@gnumonks.org> </div>
<div style="display:none"> Gerrit-Reviewer: Harald Welte <laforge@gnumonks.org> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder </div>
<div style="display:none"> Gerrit-Reviewer: fixeria <axilirator@gmail.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>