<p>neels has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/20944">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">manual: describe LCS and Lb interface<br><br>Change-Id: I7ba432706759433987fabbc674bfc8cd55f2ce62<br>---<br>M doc/manuals/chapters/running.adoc<br>A doc/manuals/chapters/smlc.adoc<br>A doc/manuals/message-sequences/location_services_ta.msc<br>M doc/manuals/osmobsc-usermanual.adoc<br>4 files changed, 136 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/44/20944/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc</span><br><span>index ae45afc..ae177a9 100644</span><br><span>--- a/doc/manuals/chapters/running.adoc</span><br><span>+++ b/doc/manuals/chapters/running.adoc</span><br><span>@@ -140,3 +140,15 @@</span><br><span>  mgw remote-ip 10.9.8.7</span><br><span>  mgw remote-port 2427</span><br><span> ----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== Configure Lb to connect to an SMLC</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Enable the Lb interface. OsmoBSC will then use the default point-codes to</span><br><span style="color: hsl(120, 100%, 40%);">+establish a connection to the SMLC.</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%);">+smlc</span><br><span style="color: hsl(120, 100%, 40%);">+ enable</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%);">+More detailed configuration is described in <<smlc-config>>.</span><br><span>diff --git a/doc/manuals/chapters/smlc.adoc b/doc/manuals/chapters/smlc.adoc</span><br><span>new file mode 100644</span><br><span>index 0000000..7fd3e12</span><br><span>--- /dev/null</span><br><span>+++ b/doc/manuals/chapters/smlc.adoc</span><br><span>@@ -0,0 +1,73 @@</span><br><span style="color: hsl(120, 100%, 40%);">+== Location Services: Lb interface to SMLC</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoBSC and OsmoSMLC support positioning by Timing-Advance (TA), since October</span><br><span style="color: hsl(120, 100%, 40%);">+2020.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+A Perform Location Request is initiated by the MSC via BSSMAP on the</span><br><span style="color: hsl(120, 100%, 40%);">+A-interface, for a specific subscriber. The request is typically passed on via</span><br><span style="color: hsl(120, 100%, 40%);">+BSSMAP-LE on the Lb-interface to the SMLC. If required, the SMLC may request the</span><br><span style="color: hsl(120, 100%, 40%);">+subscriber's Timing Advance (a.k.a. Access Delay) from the BSC via BSSLAP</span><br><span style="color: hsl(120, 100%, 40%);">+(encapsulated BSSLAP APDU in a BSSMAP-LE Connection Oriented Information</span><br><span style="color: hsl(120, 100%, 40%);">+message). The SMLC may combine several location and velocity estimate methods to</span><br><span style="color: hsl(120, 100%, 40%);">+form a GAD PDU containing the resulting geographic location information. In</span><br><span style="color: hsl(120, 100%, 40%);">+TA-based positioning, the Timing-Advance information from the BSC is combined</span><br><span style="color: hsl(120, 100%, 40%);">+with the preconfigured latitude and longitude of the serving cell to form a</span><br><span style="color: hsl(120, 100%, 40%);">+location estimate. This is returned to the BSC via the Lb-interface, and in turn</span><br><span style="color: hsl(120, 100%, 40%);">+to the MSC via the A-interface.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[mscgen]</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+include::{srcdir}/message-sequences/location_services_ta.msc[]</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%);">+Location Services (LCS) are described in 3GPP TS 43.059 <<3gpp-ts-43-059>>.</span><br><span style="color: hsl(120, 100%, 40%);">+Messages for LCS on the A-interface (BSSMAP, between BSC and MSC) are described</span><br><span style="color: hsl(120, 100%, 40%);">+in 3GPP TS 48.008 <<3gpp-ts-48-008>>, on the Lb-interface (BSSMAP-LE between BSC</span><br><span style="color: hsl(120, 100%, 40%);">+and SMLC) in 3GPP TS 49.031 <<3gpp-ts-49-031>>. The resulting geographic</span><br><span style="color: hsl(120, 100%, 40%);">+location and possibly velocity information is encoded in GAD, described in 3GPP</span><br><span style="color: hsl(120, 100%, 40%);">+TS 23.032 <<3gpp-ts-23-032>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[smlc-config]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== Configure Lb-interface</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+All Lb-interface related configuration is found in the `smlc` section of</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoBSC's configuration.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+By default, the Lb-interface is disabled in OsmoBSC. It is started by `enable`.</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%);">+smlc</span><br><span style="color: hsl(120, 100%, 40%);">+ enable</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%);">+On the Lb-interface, OsmoBSC always uses SSN "BSC (BSSMAP-LE)" (SSN code 250)</span><br><span style="color: hsl(120, 100%, 40%);">+and contacts the remote SMLC on SSN "SMLC (BSSMAP-LE)" (SSN code 252).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The point-codes are configurable, and default to OsmoBSC's local point-code</span><br><span style="color: hsl(120, 100%, 40%);">+0.23.3 (187), and remote SMLC point-code 0.23.6 (190).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+To configure a different remote SMLC point-code, first configure an arbitrarily</span><br><span style="color: hsl(120, 100%, 40%);">+named SCCP address in the `cs7` address book, and then apply that to the</span><br><span style="color: hsl(120, 100%, 40%);">+`smlc-addr` configuration:</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%);">+cs7 instance 0</span><br><span style="color: hsl(120, 100%, 40%);">+ sccp-address my-smlc</span><br><span style="color: hsl(120, 100%, 40%);">+  point-code 0.42.6</span><br><span style="color: hsl(120, 100%, 40%);">+smlc</span><br><span style="color: hsl(120, 100%, 40%);">+ smlc-addr my-smlc</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%);">+Similarly, OsmoBSC's local point-code on the Lb-interface is configured by the</span><br><span style="color: hsl(120, 100%, 40%);">+`bsc-addr` configuration:</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%);">+cs7 instance 0</span><br><span style="color: hsl(120, 100%, 40%);">+ sccp-address my-bsc-on-lb</span><br><span style="color: hsl(120, 100%, 40%);">+  point-code 0.42.3</span><br><span style="color: hsl(120, 100%, 40%);">+smlc</span><br><span style="color: hsl(120, 100%, 40%);">+ bsc-addr my-bsc-on-lb</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%);">+The geographic locations of individual cells are configured at the SMLC. See</span><br><span style="color: hsl(120, 100%, 40%);">+for example OsmoSMLC's user manual <<userman-osmosmlc>>.</span><br><span>diff --git a/doc/manuals/message-sequences/location_services_ta.msc b/doc/manuals/message-sequences/location_services_ta.msc</span><br><span>new file mode 100644</span><br><span>index 0000000..e6bef38</span><br><span>--- /dev/null</span><br><span>+++ b/doc/manuals/message-sequences/location_services_ta.msc</span><br><span>@@ -0,0 +1,49 @@</span><br><span style="color: hsl(120, 100%, 40%);">+msc {</span><br><span style="color: hsl(120, 100%, 40%);">+  hscale="2";</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ms[label="MS/BTS"],bsc[label="BSC"],smlc[label="SMLC"],__msc[label="MSC"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ||| [label="Location Services (LCS): Perform Location Request using TA"];</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%);">+  --- [label="MS in DEDICATED MODE (currently active)"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ms =>> bsc [label="earlier Measurement Report provides Timing Advance"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc <<= __msc [label="PERFORM LOCATION REQUEST\n3GPP TS 48.008 3.2.1.71"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc =>> smlc [label="BSSMAP-LE PERFORM LOCATION REQUEST\n3GPP TS 49.031 9.1\nwith BSSLAP APDU = TA Layer3\n3GPP TS 48.071 4.2.8"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  smlc rbox smlc [label="SMLC uses TA included in TA Layer3"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc <<= smlc [label="BSSMAP-LE PERFORM LOCATION RESPONSE\n3GPP TS 49.031 9.2"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc =>> __msc [label="PERFORM LOCATION RESPONSE\n3GPP TS 48.008 3.2.1.72"];</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%);">+  --- [label="MS in IDLE MODE (not connected)"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc <<= __msc [label="PERFORM LOCATION REQUEST\n3GPP TS 48.008 3.2.1.71"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc =>> smlc [label="BSSMAP-LE PERFORM LOCATION REQUEST\n3GPP TS 49.031 9.1"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  smlc rbox smlc [label="SMLC needs TA information,\nasks BSC via BSSLAP"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc <<= smlc [label="BSSMAP-LE CONNECTION ORIENTED INFORMATION\n3GPP TS 49.031 9.12\nwith BSSLAP APDU = TA Request\n3GPP TS 48.071 4.2.1"];</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%);">+  ms <<= bsc [label="RR Paging Request\n3GPP TS 48.018 9.1.22-24"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ms =>> bsc [label="RSL CHANNEL REQUIRED\n3GPP TS 48.058 8.5.3\nincludes Access Delay (9.3.17) == Timing Advance"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ms =>> bsc [label="RR Paging Response\n3GPP TS 48.018 9.1.25"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  ms <<= bsc [label="RF CHANNEL RELEASE\n3GPP TS 48.058 8.4.14"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc =>> smlc [label="BSSMAP-LE CONNECTION ORIENTED INFORMATION\n3GPP TS 49.031 9.12\nwith BSSLAP APDU = TA Response\n3GPP TS 48.071 4.2.2"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc <<= smlc [label="BSSMAP-LE PERFORM LOCATION RESPONSE\n3GPP TS 49.031 9.2"];</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  bsc =>> __msc [label="PERFORM LOCATION RESPONSE\n3GPP TS 48.008 3.2.1.72"];</span><br><span style="color: hsl(120, 100%, 40%);">+}</span><br><span>diff --git a/doc/manuals/osmobsc-usermanual.adoc b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>index a34d3d4..3c80cee 100644</span><br><span>--- a/doc/manuals/osmobsc-usermanual.adoc</span><br><span>+++ b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>@@ -30,6 +30,8 @@</span><br><span> </span><br><span> include::{srcdir}/chapters/mscpool.adoc[]</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+include::{srcdir}/chapters/smlc.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> include::./common/chapters/counters-overview.adoc[]</span><br><span> </span><br><span> include::{srcdir}/chapters/counters.adoc[]</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/20944">change 20944</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/+/20944"/><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: I7ba432706759433987fabbc674bfc8cd55f2ce62 </div>
<div style="display:none"> Gerrit-Change-Number: 20944 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>