From: lal.harshita Date: Mon, 13 Jun 2022 10:29:23 +0000 (+0530) Subject: F Release Document Upate X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?p=o-du%2Fl2.git;a=commitdiff_plain;h=90664a3ee86a61b71260de72c916f2bb85a3afc4 F Release Document Upate Signed-off-by: lal.harshita Change-Id: I2eeed74163fe985e6421ea563c5170f8cf817e6d Signed-off-by: lal.harshita --- diff --git a/container-tag.yaml b/container-tag.yaml index 77334273a..11f2e4f3e 100644 --- a/container-tag.yaml +++ b/container-tag.yaml @@ -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 index 000000000..6038b047e Binary files /dev/null and b/docs/Inter_DU_Handover_Within_OCU.png differ diff --git a/docs/api-docs.rst b/docs/api-docs.rst index 0806255a0..16323d8f2 100644 --- a/docs/api-docs.rst +++ b/docs/api-docs.rst @@ -6,7 +6,7 @@ API-Docs ********** -This is the API-docs for e-release o-du/l2. +This is the API-docs for F 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. diff --git a/docs/installation-guide.rst b/docs/installation-guide.rst index b2353bc5f..2c5b1baf8 100644 --- a/docs/installation-guide.rst +++ b/docs/installation-guide.rst @@ -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. | | diff --git a/docs/overview.rst b/docs/overview.rst index 3ce575c3d..1698f409e 100644 --- a/docs/overview.rst +++ b/docs/overview.rst @@ -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 ========================= diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 71f83318c..3e9039a31 100644 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -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 diff --git a/docs/user-guide.rst b/docs/user-guide.rst index e6971fd72..620f39604 100644 --- a/docs/user-guide.rst +++ b/docs/user-guide.rst @@ -4,7 +4,7 @@ User Guide *********** -This is the user guide for e-release of O-DU/l2. +This is the user guide for F 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 diff --git a/releases/container-release-o-du-l2 b/releases/container-release-o-du-l2 index d9133eb0b..019fcbd57 100644 --- a/releases/container-release-o-du-l2 +++ b/releases/container-release-o-du-l2 @@ -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 diff --git a/releases/container-release-o-du-l2-cu-stub b/releases/container-release-o-du-l2-cu-stub index c9b0f7e35..263da0cbf 100644 --- a/releases/container-release-o-du-l2-cu-stub +++ b/releases/container-release-o-du-l2-cu-stub @@ -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