F Release Document Upate 55/8555/6
authorlal.harshita <Harshita.Lal@radisys.com>
Mon, 13 Jun 2022 10:29:23 +0000 (15:59 +0530)
committerlal.harshita <Harshita.Lal@radisys.com>
Thu, 16 Jun 2022 07:09:10 +0000 (12:39 +0530)
Signed-off-by: lal.harshita <Harshita.Lal@radisys.com>
Change-Id: I2eeed74163fe985e6421ea563c5170f8cf817e6d
Signed-off-by: lal.harshita <Harshita.Lal@radisys.com>
container-tag.yaml
docs/Inter_DU_Handover_Within_OCU.png [new file with mode: 0644]
docs/api-docs.rst
docs/installation-guide.rst
docs/overview.rst
docs/release-notes.rst
docs/user-guide.rst
releases/container-release-o-du-l2
releases/container-release-o-du-l2-cu-stub

index 7733427..11f2e4f 100644 (file)
@@ -1,4 +1,4 @@
 # The Jenkins job requires a tag to build the Docker image.
 # Global-JJB script assumes this file is in the repo root.
 ---
-tag: 5.0.3
+tag: 6.0.1
diff --git a/docs/Inter_DU_Handover_Within_OCU.png b/docs/Inter_DU_Handover_Within_OCU.png
new file mode 100644 (file)
index 0000000..6038b04
Binary files /dev/null and b/docs/Inter_DU_Handover_Within_OCU.png differ
index 0806255..16323d8 100644 (file)
@@ -6,7 +6,7 @@
 API-Docs
 **********
 
-This is the API-docs for e-release o-du/l2.
+This is the API-docs for release o-du/l2.
 
 .. contents::
    :depth: 3
@@ -46,42 +46,54 @@ API Functions
    A. MAC to Scheduler
 
       a. Air Interface Time : Sends timing information over air interface in terms of SFN and slo, as per Section
-         9.2.3.1.1 of the AAD Spec
+         9.2.3.1.1 of the AAD Spec.
 
-      b. Cell Configuration Request : MAC provides SCH the cell configuration as per Section 9.2.3.2.1 of the AAD Spec
+      b. Cell Configuration Request : MAC provides SCH the cell configuration as per Section 9.2.3.2.1 of the AAD Spec.
 
-      c. Add UE Configuration Request : MAC provides SCH the configuration/capabilities of a UE as per Section 9.2.3.2.5 of the AAD Spec
+      c. Add UE Configuration Request : MAC provides SCH the configuration/capabilities of a UE as per Section 9.2.3.2.5 of the AAD Spec.
 
       d. Modify UE Reconfiguration Request : MAC provides SCH the re-configuration of UE, also used to
-         add/release/modify existing bearers, as per Section 9.2.3.2.6 of the AAD Spec
+         add/release/modify existing bearers, as per Section 9.2.3.2.6 of the AAD Spec.
 
-      e. RACH Indication : MAC receives the RACH Indication and share the contents with SCH as per Section 9.2.3.2.12 of the AAD Spec
+      e. RACH Indication : MAC receives the RACH Indication and share the contents with SCH as per Section 9.2.3.2.12 of the AAD Spec.
 
       f. DL RLC Buffer Status Information : Reports data volume per LC when it is received at MAC as per Section
-         9.2.3.2.16 of the AAD Spec
+         9.2.3.2.16 of the AAD Spec.
 
       g. UL Buffer Status Report Indication : On reception and decoding of received BSR from the UE, MAC provides SCH
-         buffer status report for UL scheduling, as per Section 9.2.3.2.18 of the AAD Spec
+         buffer status report for UL scheduling, as per Section 9.2.3.2.18 of the AAD Spec.
 
       h. UE Delete Request : MAC receives UE delete request and forwards the request to SCH as per Section 9.2.3.2.7
-         of the AAD spec.
+         of the AAD Spec.
 
       i. Cell Delete Request :  MAC receives UE delete request and forwards the request to SCH as per Section 9.2.3.2.2
-         of the AAD spec.
+         of the AAD Spec.
 
       j. Slice Configuration Request : MAC receives Slice Configuration request and forwards the request to SCH as per Section
-         9.2.3.2.3 of the AAD Spec
+         9.2.3.2.3 of the AAD Spec.
         
       k. Slice Reconfiguration Request : MAC receives Slice Reconfiguration request and forwards the request to SCH as per 
-         Section 9.2.3.2.4 of the AAD Spec
+         Section 9.2.3.2.4 of the AAD Spec.
+
+      l. Paging Indication : MAC receives Paging Indication and forwards the trigger to SCH as per Section 9.2.3.2.13 of the AAD Spec.
+
+      m. RACH Resource Request : MAC receives RACH Resource Request for dedicated RACH resource allocation and forwards to SCH as per 
+         Section 9.2.3.2.14 of the AAD Spec.
+
+      n. RACH Resource Release : MAC receives RACH Resource Release from DU APP and forwards to SCH as per Section 9.2.3.2.15 of the
+         AAD Spec.
+
+      o. DL HARQ Indication : MAC receives UCI Indication and forwards any DL HARQ feedback from UE to SCH as per Sectiion 9.2.3.2.8 
+         of the AAD spec.
 
-      l. Paging Indication : MAC receives Paging Indication and forwards the trigger to SCH as per Section 9.2.3.2.13 of the AAD Spec
+      p. UL HARQ CRC Indication : MAC receives CRC Indication from PHY and forwards the decoded results to SCH as per Section 
+         9.2.3.2.9 of the AAD Spec.
 
    B. Scheduler to MAC
 
-      a. Cell Configuration Response - Response to cell configuration request from MAC, as per Section 9.2.3.3.1 of the AAD Spec
+      a. Cell Configuration Response - Response to cell configuration request from MAC, as per Section 9.2.3.3.1 of the AAD Spec.
 
-      b. UE Reconfiguration Response - Response to UE reconfiguration request from MAC, as per Section 9.2.3.3.6 of the AAD Spec
+      b. UE Reconfiguration Response - Response to UE reconfiguration request from MAC, as per Section 9.2.3.3.6 of the AAD Spec.
 
       c. DL Scheduling Information - Provides scheduling information for a given slot for downlink data, as per Section
          9.2.3.3.8 of the AAD spec.
@@ -92,18 +104,18 @@ API Functions
       e. RAR Information - Informs MAC of uplink scheduling and Msg3 scheduling information, as per Section 9.2.3.3.10 of the AAD Spec.
 
       f. Downlink Control Channel Information - Provides DCI scheduling information for a given slot on PDCCH, as per
-         Section 9.2.3.3.11 of the AAD Spec
+         Section 9.2.3.3.11 of the AAD Spec.
 
       g. Downlink Broadcast Allocation - Provides DCI and DL data scheduling information for SIB1 for a given slot for
          Broadcast Channel, as per Section 9.2.3.3.12 of the AAD Spec.
 
-      h. UE Delete Response - Response to UE delete request from MAC, as per Section 9.2.3.3.7
+      h. UE Delete Response - Response to UE delete request from MAC, as per Section 9.2.3.3.7 of the AAD Spec.
 
-      i. Cell Delete Response - Response to Cell delete request from MAC, as per Section 9.2.3.3.2
+      i. Cell Delete Response - Response to Cell delete request from MAC, as per Section 9.2.3.3.2 of the AAD Spec.
 
-      j. Slice Configuration Response : Response to Slice Configuration request from MAC, as per Section 9.2.3.3.3 of the AAD Spec
+      j. Slice Configuration Response : Response to Slice Configuration request from MAC, as per Section 9.2.3.3.3 of the AAD Spec.
         
-      k. Slice Reconfiguration Response : Response to Slice Reconfiguration request from MAC, as per Section 9.2.3.3.4 of the AAD Spec
+      k. Slice Reconfiguration Response : Response to Slice Reconfiguration request from MAC, as per Section 9.2.3.3.4 of the AAD Spec.
 
       l. Downlink Paging Allocation :  Provides DCI and DL data scheduling information for any Paging queued for a given slot 
          for Paging Channel, as per Section 9.2.3.3.13 of the AAD Spec.
@@ -129,8 +141,11 @@ API Functions
       f. UE Delete Request - Deletes UE information at MAC as per Section 9.2.4.7  of the AAD Spec.
 
       g. DL PCCH Indication - Sends DL PCCH Message to MAC for any Paging scheduled on a slot, as per Section 9.2.4.17 of the AAD Spec.
-      
 
+      h. RACH Resource Request - Requests for dedicated RACH resources for CF-RA with a UE, as per Section 9.2.4.9 of the AAD Spec.
+
+      i. RACH Resource Release - Releases dedicated RACH resources allocated for a UE for CF-RA, as per Section 9.2.4.11 of the AAD Spec.
+      
    B. MAC to DU APP
 
       a. UE Create Response - Response to UE Create Request from DU Manager as per Section 9.2.4.4 of the AAD Spec.
@@ -141,6 +156,8 @@ API Functions
       c. UL-CCCH Indication - Sends the UL CCCH Message received from UE to DU APP as per Section 9.2.4.15 of AAD Spec.
 
       d. UE Delete Response - Response to UE Delete Request from DU Manager as per Section 9.2.4.8 of the AAD Spec.
+
+      e. RACH Resource Response - Responds with dedicated resources allocated for CF-RA for a UE, as per Section 9.2.4.10 of the AAD Spec.
       
 4. DU APP - RLC Interface
    
@@ -158,16 +175,16 @@ API Functions
 
    B. RLC to DU APP
 
-      a. UE Create Response - Response to UE Create Request from DU APP, as per Section 9.2.5.3
+      a. UE Create Response - Response to UE Create Request from DU APP, as per Section 9.2.5.3 of the AAD Spec.
 
-      b. UE Reconfiguration Response - Response to UE Recofiguration Request from DU APP, as per Section 9.2.5.4
+      b. UE Reconfiguration Response - Response to UE Recofiguration Request from DU APP, as per Section 9.2.5.4 of the AAD Spec.
 
       c. UL RRC Message Tranfer - Delivers RRC Message from UE to CU as per Section 9.2.5.8 of the AAD spec.
 
       d. RRC Message Delivery Report - Informs DU Manager on failed/successful delivery of a DL RRC message to UE, as
          per Section 9.2.5.9 of the AAD Spec.
 
-      e. UE Delete Response - Response to UE Delete Request from DU APP, as per section 9.2.5.6
+      e. UE Delete Response - Response to UE Delete Request from DU APP, as per section 9.2.5.6 of the AAD Spec.
 
 5. SMO-OAM - DU APP
 
@@ -175,9 +192,9 @@ API Functions
 
    A. SMO-OAM to DU APP
 
-      a. Cell Configuration - Sends Basic Cell Configurations to DU APP as per Section 9.2.1.1
+      a. Cell Configuration - Sends Basic Cell Configurations to DU APP as per Section 9.2.1.1 of the AAD Spec.
       
-      b. Slice Configuration - Sends Slice Configurations to DU APP as per Section 9.2.1.2
+      b. Slice Configuration - Sends Slice Configurations to DU APP as per Section 9.2.1.2 of the AAD Spec.
 
 Additional APIs
 ----------------
@@ -227,3 +244,10 @@ Additional APIs
 
    e. Slice PM - DU APP sends PM for all Slices in 60sec duration.
 
+4. MAC - SCH Interface
+
+   A. SCH to MAC
+
+      a. RACH Resource Response : Response to RACH Resource Request for dedicated resource for CF-RA
+
+      b. HARQ Process Release : SCH indicates MAC to release a HARQ process in case a positive acknowledement is received or maximum retransmissions are done already.
index b2353bc..2c5b1ba 100644 (file)
@@ -24,6 +24,10 @@ Version history
 | **Date**           | **Ver.**           | **Author**         | **Comment**        |
 |                    |                    |                    |                    |
 +--------------------+--------------------+--------------------+--------------------+
+| 2022-06-16         |  4.0.0             |  Radisys,          |  F release         |
+|                    |                    |  HCL Technologies  |                    |
+|                    |                    |  Ltd.              |                    |
++--------------------+--------------------+--------------------+--------------------+
 | 2022-01-14         |  3.0.0             |  Radisys,          |  e-release         |
 |                    |                    |  HCL Technologies  |                    |
 |                    |                    |  Ltd.              |                    |
index 3ce575c..1698f40 100644 (file)
@@ -430,7 +430,7 @@ This section describes the Idle Mode Paging procedure within O-DU High.
 
 As seen in the Figure 9,
 
-- When a Paging is received from CU and the Cell to be Paged is UP then DU APP will calculate Paging Frame(PF) and i_s(Index of Paging Ocassion/Slot) and groups the Paging of UEs falling on same PF/SFN together and stores in its Cell's Databse.
+- When a Paging is received from O-CU and the Cell to be Paged is UP then DU APP will calculate Paging Frame(PF) and i_s(Index of Paging Ocassion/Slot) and groups the Paging of UEs falling on same PF/SFN together and stores in its Cell's Databse.
 
 - When a Slot Indication for SFN is received then DU APP extracts the Paging of all UEs whose PF is ahead by PAGING_DELTA and builds Paging RRC PDU. DU APP sends the same via DL PCCH Indication to MAC.
 
@@ -440,6 +440,52 @@ As seen in the Figure 9,
 
 - MAC forwards the PAGE to PHY in TX_Data.Request.
 
+Inter-DU Handover within O-CU
+------------------------------
+
+This section describes the handling of inter-DU handover of a UE within O-DU High.
+
+.. figure:: Inter_DU_Handover_Within_OCU.png
+   :width: 600
+   :alt: Inter-DU Handover withing O-CU
+   Figure 9 -  Inter_DU Handover call flow
+
+Assumption: UE is RRC connected with DU and PDU data session is active.
+
+- The UE sends Measurement Report message to the source O-DU. This message is sent from O-DU to O-CU in the UL RRC MESSAGE TRANSFER message over F1AP interface.
+
+- Based on UE Measurement Report, O-CU makes a handover decision to another cell belonging to the target O-DU.
+
+- The O-CU sends a UE CONTEXT MODIFICATION REQUEST message to source O-DU to query the latest configuration.
+
+- The DU APP in source O-DU responds with a UE CONTEXT MODIFICATION RESPONSE message that includes latest full configuration information.
+
+- The O-CU sends a UE CONTEXT SETUP REQUEST message to the target O-DU to create an UE context and setup one or more data bearers. The UE CONTEXT SETUP REQUEST message includes Hand-overPreparationInformation. At target O-DU, DU APP sends UE Create Request to MAC and RLC layers to create the UE context with radio resources and receives UE Create Response from the respective protocol layers.
+
+- The target O-DU responds with a UE CONTEXT SETUP RESPONSE message if the target O-DU can admit resources for the handover.
+
+- The O-CU sends a UE CONTEXT MODIFICATION REQUEST message to the source O-DU, which includes RRCReconfiguration message towards the UE. The O-CU also indicates the source O-DU to stop the data transmission for the UE.
+
+- The source O-DU forwards the received RRCReconfiguration message to the UE and then sends the UE Reconfiguration Request to MAC/Scheduler and RLC layer and get the UE Reconfiguration Response from the respective protocol layers.
+
+- The source O-DU responds to the O-CU with UE CONTEXT MODIFICATION RESPONSE message.
+
+- UE triggers Random Access procedure at the target O-DU. This is a contention free random access if UE was informed about its dedicated RACH resources in RRC Reconfiguration message.
+
+- Once Random Access procedure with target O-DU is complete, the UE responds to the target O-DU with a RRCReconfigurationComplete message.
+
+- The target O-DU sends UL RRC MESSAGE TRANSFER message to O-CU to convey the received RRCReconfigurationComplete message.
+
+- The downlink and uplink data packets are sent to/from the UE through the target O-DU.
+
+- The O-CU sends UE CONTEXT RELEASE COMMAND message to the source O-DU.
+
+- The source O-DU sends UE DELETE REQUEST to MAC/RLC layers to release the UE context and receives UE DELETE RESPONSE message.
+
+- The source O-DU responds to O-CU with UE CONTEXT RELEASE COMPLETE message.
+
+
 OSC Testcases Supported
 =========================
 
index 71f8331..3e9039a 100644 (file)
@@ -5,8 +5,7 @@
 Release-Notes
 **************
 
-
-This document provides the release notes for D Release of O-DU-L2.
+This document provides the release notes for F Release of O-DU-L2.
 
 .. contents::
    :depth: 3
@@ -20,6 +19,10 @@ Version history
 | **Date**           | **Ver.**           | **Author**         | **Comment**        |
 |                    |                    |                    |                    |
 +--------------------+--------------------+--------------------+--------------------+
+|2022-06-16          | 6.0.0              | Radisys,           | F release          |
+|                    |                    | HCL Technologies   |                    |
+|                    |                    | Ltd.               |                    |
++--------------------+--------------------+--------------------+--------------------+
 | 2022-01-14         | 5.0.0              | Radisys,           | e-release          |
 |                    |                    | HCL Technologies   |                    |
 |                    |                    | Ltd.               |                    |
@@ -47,8 +50,14 @@ F- release
 ^^^^^^^^^^
 This release contains the following:
 
- - Upgrade to E2AP version 2.0.
- - Support for IDLE Mode Paging.
+ - HARQ framework support and scheduler enhancement to prioritize retransmission
+
+ - Upgrade to E2AP version 2.0
+
+ - Support for IDLE Mode Paging
+
+ - Mobility mode Support (Intra-CU handover)
+
 
  - O1 Module
 
@@ -165,6 +174,25 @@ This release contains the following:
 
 Release Data
 ------------
+F release
+^^^^^^^^^^
++--------------------------------------+--------------------------------------+
+| **Project**                          | ODUHIGH                              |
+|                                      |                                      |   
++--------------------------------------+--------------------------------------+
+| **Repo/commit-ID**                   |o-du/l2/                              |
+|                                      |I2eeed74163fe985e6421ea563c5170f8cf81 |
+|                                      |7e6d                                  |
++--------------------------------------+--------------------------------------+
+| **Release designation**              | F release                            |
+|                                      |                                      |   
++--------------------------------------+--------------------------------------+
+| **Release date**                     |2022-06-16                            |
+|                                      |                                      |   
++--------------------------------------+--------------------------------------+
+| **Purpose of the delivery**          | F release                            |
+|                                      |                                      |   
++--------------------------------------+--------------------------------------+
 
 e-release
 ^^^^^^^^^^ 
@@ -283,9 +311,15 @@ F-release
 | **JIRA REFERENCE**                            | **SLOGAN**                                    |
 |                                               |                                               |
 +-----------------------------------------------+-----------------------------------------------+
+| https://jira.o-ran-sc.org/browse/ODUHIGH-402  | Support for HARQ and scheduler enhancement to |
+|                                               | prioritize retransmission                     |
++-----------------------------------------------+-----------------------------------------------+
 | https://jira.o-ran-sc.org/browse/ODUHIGH-404  | Support for E2AP version 2.0                  | 
 |                                               |                                               |
 +-----------------------------------------------+-----------------------------------------------+
+| https://jira.o-ran-sc.org/browse/ODUHIGH-405  | Support for Inter-DU Handover                 | 
+|                                               |                                               |
++-----------------------------------------------+-----------------------------------------------+
 | https://jira.o-ran-sc.org/browse/ODUHIGH-406  | Support for Idle Mode Paging                  | 
 |                                               |                                               |
 +-----------------------------------------------+-----------------------------------------------+
@@ -539,26 +573,28 @@ References
 ----------
 1. ORAN-WG8.AAD.0-v05.00.00
 
-2. ORAN WG3.E2AP v02.00
+2. O-RAN.WG5.C.1-v05.00
+
+3. ORAN WG3.E2AP v02.00
 
-3. 3GPP 38.473-f60 v15.3
+4. 3GPP 38.473-f60 v15.3
 
-4. 3GPP TS 38.211 v15.3
+5. 3GPP TS 38.211 v15.3
 
-5. 3GPP TS 38.212 v15.3
+6. 3GPP TS 38.212 v15.3
 
-6. 3GPP TS 38.213 v15.3
+7. 3GPP TS 38.213 v15.3
 
-7. 3GPP TS 38.214 v15.3
+8. 3GPP TS 38.214 v15.3
 
-8. 3GPP TS 38.321 v15.3
+9. 3GPP TS 38.321 v15.3
 
-9. 3GPP TS 38.331 v15.3
+10. 3GPP TS 38.331 v15.3
 
-10. 5G PHY FAPI Specification v1.0.5
+11. 5G PHY FAPI Specification v1.0.5
 
-11. 3GPP TS 28.541 Specfication V16.6
+12. 3GPP TS 28.541 Specfication V16.6
 
-12. O-RAN WG1.O1-Interface v04.00
+13. O-RAN WG1.O1-Interface v04.00
 
-13. O-RAN WG1.OAM-Architecture v04.00
+14. O-RAN WG1.OAM-Architecture v04.00
index e6971fd..620f396 100644 (file)
@@ -4,7 +4,7 @@
 User Guide
 ***********
 
-This is the user guide for e-release of O-DU/l2.
+This is the user guide for release of O-DU/l2.
 Follow installation-guide to get all the dependencies ready.
 
 .. contents::
@@ -66,17 +66,17 @@ II. Execution - Using Docker Images
 The call flow between O-DU High and CU Stub can be achieved by executing docker containers.
 
 - Pull the last built docker images:
-    -  docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:5.0.3
-    -  docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:5.0.3
+    -  docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:6.0.1
+    -  docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:6.0.1
 
 - Run CU Stub docker:
     - docker run -it --privileged --net=host --entrypoint bash
-      nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:5.0.3   
+      nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:6.0.1   
     - ./cu_stub
 
 - Run ODU docker:
     - docker run -it --privileged --net=host --entrypoint bash
-      nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:5.0.3   
+      nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:6.0.1   
     - ./odu
 
 
index d9133eb..019fcbd 100644 (file)
@@ -1,11 +1,11 @@
 ---
 
 distribution_type: container
-container_release_tag: 5.0.3
+container_release_tag: 6.0.1
 container_pull_registry: nexus.o-ran-sc.org:10004
 container_push_registry: nexus.o-ran-sc.org:10002
 project: o-du-l2 
-ref: 726a82abf1f485704459e2ce3777b8bac8cc16b6
+ref: eda4b205c3734bde66da2ec74427220890479920
 containers:
 - name: o-du-l2
-version: 5.0.3
+version: 6.0.1
index c9b0f7e..263da0c 100644 (file)
@@ -1,11 +1,11 @@
 ---
 
 distribution_type: container
-container_release_tag: 5.0.3
+container_release_tag: 6.0.1
 container_pull_registry: nexus.o-ran-sc.org:10004
 container_push_registry: nexus.o-ran-sc.org:10002
 project: o-du-l2 
-ref: 726a82abf1f485704459e2ce3777b8bac8cc16b6
+ref: eda4b205c3734bde66da2ec74427220890479920
 containers:
 - name: o-du-l2-cu-stub
-version: 5.0.3
+version: 6.0.1