From 5dadf0ae6ecc04426a07c14192e0c7a8c802ff69 Mon Sep 17 00:00:00 2001 From: Neels Hofmeyr Date: Wed, 28 Oct 2020 03:19:44 +0100 Subject: [PATCH] manual: describe TA-based positioning and cell locations Change-Id: I3d8ae0f6fef0c60499a5e133d3dd0ebd54e8c321 --- doc/manuals/chapters/cells.adoc | 26 ++++++++++++++++++++++++++ doc/manuals/chapters/positioning.adoc | 11 +++++++++++ doc/manuals/chapters/running.adoc | 5 +++-- doc/manuals/osmosmlc-usermanual.adoc | 4 ++++ 4 files changed, 44 insertions(+), 2 deletions(-) create mode 100644 doc/manuals/chapters/cells.adoc create mode 100644 doc/manuals/chapters/positioning.adoc diff --git a/doc/manuals/chapters/cells.adoc b/doc/manuals/chapters/cells.adoc new file mode 100644 index 0000000..a54c026 --- /dev/null +++ b/doc/manuals/chapters/cells.adoc @@ -0,0 +1,26 @@ +== Configure Cell Locations + +To determine geographic location estimates based on the serving cell, OsmoSMLC +needs preconfigured global positions by latitude and longitude, for each cell of +each BSC. + +On the `cells` configuration node, cell locations can be indicated by LAC and +CI, or by Cell Global Identity. The following example configures the position +for a cell by LAC 23 and CI 42: + +---- +cells + lac-ci 23 42 lat 12.3456 lon 23.4567 +---- + +The following example configures the position by a Cell Global Identity with +PLMN 001-01, LAC 2 and CI 3: + +---- +cells + cgi 001 01 2 3 lat 34.5678 lon 45.6789 +---- + +If a cell's latitude and longitude is not configured, all location requests for +subscribers served by that cell are answered by a BSSMAP-LE Perform Location +Response without a Location Estimate and LCS Cause "Facility not supported". diff --git a/doc/manuals/chapters/positioning.adoc b/doc/manuals/chapters/positioning.adoc new file mode 100644 index 0000000..e16c224 --- /dev/null +++ b/doc/manuals/chapters/positioning.adoc @@ -0,0 +1,11 @@ +== Positioning Methods + +So far, OsmoSMLC provides only TA-based positioning. + +=== TA-Based Positioning + +In TA-based positioning, the serving Cell Id and the Timing Advance (a.k.a. +Access Delay) are provided by the BSC. OsmoSMLC returns a GAD "ellipsoid point +with uncertainty circle" as location estimate. The ellipsoid point is the +latitude and longitude of the serving cell, and the uncertainty circle is the +maximum distance from that cell based on the Timing Advance information. diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index 0a3174e..684866e 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -63,10 +63,11 @@ has to configure a distinct point-code. See <>. ===== Configure SCCP/M3UA (AoIP) OsmoSMLC acts as client to contact an STP instance and establish an SCCP/M3UA -link. +link. OsmoSMLC always uses the SSN "SMLC (BSSMAP-LE)" (SSN code 252). The +configurable point-code defaults to 0.23.6 (190). An example configuration of OsmoSMLC's Lb SCCP link, assuming the SMLC at -point-code 1.23.6 via an SG listening for M3UA at 127.0.0.1:2905: +point-code 1.23.6, listening for M3UA at 127.0.0.1:2905: ---- cs7 instance 0 diff --git a/doc/manuals/osmosmlc-usermanual.adoc b/doc/manuals/osmosmlc-usermanual.adoc index 0be3a23..d2aa544 100644 --- a/doc/manuals/osmosmlc-usermanual.adoc +++ b/doc/manuals/osmosmlc-usermanual.adoc @@ -18,6 +18,10 @@ include::./common/chapters/logging.adoc[] include::./common/chapters/cs7-config.adoc[] +include::{srcdir}/chapters/positioning.adoc[] + +include::{srcdir}/chapters/cells.adoc[] + include::./common/chapters/counters-overview.adoc[] // include::{srcdir}/chapters/counters.adoc[]