<p>Harald Welte <strong>merged</strong> this change.</p><p><a href="https://gerrit.osmocom.org/9488">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;">doc: add ms-channel-request.msc<br><br>Change-Id: Iab22b8ae85a1a54d2f4002733e6068356368101b<br>---<br>M doc/Makefile.am<br>A doc/ms-channel-request.msc<br>2 files changed, 64 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/Makefile.am b/doc/Makefile.am</span><br><span>index 3c8c2e0..5fe5674 100644</span><br><span>--- a/doc/Makefile.am</span><br><span>+++ b/doc/Makefile.am</span><br><span>@@ -6,6 +6,7 @@</span><br><span> $(builddir)/handover.png \</span><br><span> $(builddir)/assignment.png \</span><br><span> $(builddir)/lchan-release.png \</span><br><span style="color: hsl(120, 100%, 40%);">+ $(builddir)/ms-channel-request.png \</span><br><span> $(NULL)</span><br><span> </span><br><span> $(builddir)/%.png: $(srcdir)/%.msc</span><br><span>diff --git a/doc/ms-channel-request.msc b/doc/ms-channel-request.msc</span><br><span>new file mode 100644</span><br><span>index 0000000..c0ef60f</span><br><span>--- /dev/null</span><br><span>+++ b/doc/ms-channel-request.msc</span><br><span>@@ -0,0 +1,63 @@</span><br><span style="color: hsl(120, 100%, 40%);">+msc {</span><br><span style="color: hsl(120, 100%, 40%);">+ hscale=3;</span><br><span style="color: hsl(120, 100%, 40%);">+ ms [label="MS"], bts [label="BTS"], bsc[label="BSC"], bsc_gscon[label="BSC conn FSM"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+ ms note bsc_gscon [label="lchan allocation sequence for RSL Channel Request"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+ ms => bts [label="RR Channel Request"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts => bsc [label="RSL Channel Request"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="rsl_rx_chan_rqd()"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="Obtain RACH data from Request: - Reference - Access Delay (TA)</span><br><span style="color: hsl(120, 100%, 40%);">+ - Request Reason - Channel Type"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="If the reason is PDCH, the RACH Request is forwarded to PCU and BSC is no</span><br><span style="color: hsl(120, 100%, 40%);">+ longer concerned (rsl_rx_pchan_rqd())."];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="Always try to allocate an SDCCH regardless of the requested type, only if no</span><br><span style="color: hsl(120, 100%, 40%);">+ SDCCH is available, look for the actually requested channel type."];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="lchan_alloc(SDCCH, allow_bigger=0)"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+ --- [label="IF no lchan is available (neither SDCCH nor requested type)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="Figure out T3122 value from bts->T3122, network->T3122 or</span><br><span style="color: hsl(120, 100%, 40%);">+ GSM_T3122_DEFAULT"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="rsl_send_imm_ass_rej()"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="..."];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts <= bsc [label="RR Immediate Assign Reject"];</span><br><span style="color: hsl(120, 100%, 40%);">+ ms <= bts [label="RR Immediate Assign Reject (possibly grouped with up to 4 others)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="rsl_rx_pchan_rqd() exits, no channel is allocated."];</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%);">+ bsc box bsc [label="Store RACH data in lchan->rqd_ref, rqd_ta"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc abox bsc [label="Start lchan->act_timer (4s, lchan_act_tmr_cb())"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="rsl_chan_activate_lchan(RSL_ACT_INTRA_IMM_ASS)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ --- [label="is the chosen lchan on dynamic timeslot that is currently used as PDCH?"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [linecolor=red,label="Osmocom style dyn TS use the lchan->act_timer for an RSL RF</span><br><span style="color: hsl(120, 100%, 40%);">+ Channel Release, to release PDCH mode. This will actually overwrite above act_timer!"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts <= bsc [label="i) RSL RF Chan Release of PDCH (Osmocom dyn TS)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts <= bsc [label="OR ii) RSL PDCH Deact (ip.access dyn TS)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc -> bsc_gscon [label="gsm0808_assign_req() returns early"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc_gscon abox bsc_gscon [label="ST_WAIT_ASS_COMPL (GSM0808_T10_VALUE=6s)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ ...;</span><br><span style="color: hsl(120, 100%, 40%);">+ bts note bsc_gscon [linecolor="red",</span><br><span style="color: hsl(120, 100%, 40%);">+ label="Osmocom style dyn TS use lchan->act_timer to watch over RF Chan Release, but there</span><br><span style="color: hsl(120, 100%, 40%);">+ seems to be no timer watching over PDCH Deact!"];</span><br><span style="color: hsl(120, 100%, 40%);">+ ...;</span><br><span style="color: hsl(120, 100%, 40%);">+ bts => bsc [label="i) RSL RF Chan Release ACK (Osmocom dyn TS)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts => bsc [label="OR ii) RSL PDCH Deact ACK (ip.access dyn TS)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="rsl_chan_activate_lchan() re-invoked"];</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%);">+ bsc box bsc [label="lchan->state = LCHAN_S_ACT_REQ"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bts <= bsc [label="RSL Chan Activ: Immediate Assignment"];</span><br><span style="color: hsl(120, 100%, 40%);">+ ...;</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="Timeout of lchan->act_timer causes the</span><br><span style="color: hsl(120, 100%, 40%);">+ lchan->state to go to LCHAN_S_BROKEN, but no events or actions</span><br><span style="color: hsl(120, 100%, 40%);">+ are triggered."];</span><br><span style="color: hsl(120, 100%, 40%);">+ ...;</span><br><span style="color: hsl(120, 100%, 40%);">+ bts => bsc [label="RSL Chan Activ ACK"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="rsl_rx_chan_act_ack()"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="Stop lchan->act_timer"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc box bsc [label="lchan->state = LCHAN_S_ACTIVE"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc -> bsc [label="S_LCHAN_ACTIVATE_ACK (has no effect)"];</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc note bsc [label="Since this was an Immediate Assignment, no further action is required on</span><br><span style="color: hsl(120, 100%, 40%);">+ behalf of the BSC. The MS is now free to use the lchan."];</span><br><span style="color: hsl(120, 100%, 40%);">+}</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/9488">change 9488</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/9488"/><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-MessageType: merged </div>
<div style="display:none"> Gerrit-Change-Id: Iab22b8ae85a1a54d2f4002733e6068356368101b </div>
<div style="display:none"> Gerrit-Change-Number: 9488 </div>
<div style="display:none"> Gerrit-PatchSet: 7 </div>
<div style="display:none"> Gerrit-Owner: Neels Hofmeyr <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Harald Welte <laforge@gnumonks.org> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder </div>