X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Foverview.rst;h=872d7c0e35ef87394f1a341a37e22f784abfdedd;hb=refs%2Fchanges%2F57%2F3557%2F3;hp=c0d232710e73c4fa8d08e25438bfb077173fe0be;hpb=98d3f0738d3401baf302f69c1ec34d9851c667d3;p=ric-app%2Fmc.git

diff --git a/docs/overview.rst b/docs/overview.rst
index c0d2327..872d7c0 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -1,12 +1,39 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
 .. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2019 AT&T
 
 
 RIC Measurement Campaign (MC) Overview
 =======================================
 
+MC xApp
+5G EN-DC Measurement and KPI Computation xApp
+Developed by Rajarajan Sivaraj, Theodore Johnson, Vladislav Shkapenyuk
+Additional Credits: Matti Hiltunen, Gueyoung Jung, Scott Daniels
+AT&T Labs Research
+---------------------------------
+
 MC xApp calculates a number of metrics and KPIs based on X2 messages formatted as protobufs as defined in ric-plt/streaming-protobufs.
 
+In the MC xApp, we compute 5G KPIs at customized fine-grained granularities in the following manner:
+- On a per-UE per-bearer basis
+- On a per-UE basis
+- On a UE-group basis
+- On an NR cell-wide basis
+- On an NR gNB-wide basis
+
+We identify individual UEs across multiple EN-DC sessions by the s1-UL-GTPtunnelEndpoint IE in 3GPP X2AP: SgNB Addition Request message, as long as they remain connected to the same eNB.
+We identify UE groups based on (i) QCI, (ii) E-RAB-ID, (iii) (QCI, ARP) value pair, etc.
+We identify NR cell based on the NR-PCI or the Physical Cell Identity
+We identify the NR gNB based on the gNB ID Information Element (IE) received in the RMR X2AP streaming header
+
+The key 3GPP EN-DC X2AP procedures that we handle in the MC xApp include:
+- SgNB Addition
+- SgNB Release
+- SgNB Modification
+- RRC Transfer
+- Secondary RAT Data Usage Report
+
 The metrics are reported periodically as VES events and include metrics such as number of dual connected UEs, duration of dual connections, and signal strength metrics. For a full list of supported metrics see the readme.
 
 Internally, MC xApp uses the gs-lite stream processing engine (com/gs-lite).