Signed-off-by: lal.harshita <Harshita.Lal@radisys.com>
Change-Id: I5166fb1b6f04ed7e7d40344b21b0633259a26660
Signed-off-by: lal.harshita <Harshita.Lal@radisys.com>
# The Jenkins job requires a tag to build the Docker image.
# Global-JJB script assumes this file is in the repo root.
---
# The Jenkins job requires a tag to build the Docker image.
# Global-JJB script assumes this file is in the repo root.
---
- *void\* WLS_Open(const char \*ifacename, unsigned int mode, unsigned long long nWlsMemorySize)*
+ *void\* WLS_Open(const char \*ifacename, unsigned int mode, uint64_t \*nWlsMacMemorySize, uint64_t \*nWlsPhyMemorySize)*
- ifacename - pointer to string with device driver name (/dev/wls)
- mode - mode of operation (Master or Slave). Here, O-DU High acts as MASTER.
- ifacename - pointer to string with device driver name (/dev/wls)
- mode - mode of operation (Master or Slave). Here, O-DU High acts as MASTER.
+ - nWlsMacMemorySize - returns the value of WLS MAC memory Size as O-DU High acts as MASTER
+ - nWlsPhyMemorySize - returns the value of WLS PHY memory Size as O-DU High acts as MASTER
c. Returns pointer handle to WLS interface for future use by WLS functions
c. Returns pointer handle to WLS interface for future use by WLS functions
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
-.. contents::
- :depth: 3
- :local:
-
O-DU High Installation Guide
*****************************
O-DU High Installation Guide
*****************************
This document describes how to install O-DU High, it's dependencies and required system resources.
.. contents::
:depth: 3
:local:
This document describes how to install O-DU High, it's dependencies and required system resources.
.. contents::
:depth: 3
:local:
+Version history
+---------------
+--------------------+--------------------+--------------------+--------------------+
| **Date** | **Ver.** | **Author** | **Comment** |
+--------------------+--------------------+--------------------+--------------------+
| **Date** | **Ver.** | **Author** | **Comment** |
This document describes the hardware and software requirements along with guidelines on how to install O-DU High.
This document describes the hardware and software requirements along with guidelines on how to install O-DU High.
O-DU High images can be built using the source code or corresponding docker images can be downloaded.
Hardware requirements
O-DU High images can be built using the source code or corresponding docker images can be downloaded.
Hardware requirements
Following minimum hardware requirements must be met for installation of O-DU High
Following minimum hardware requirements must be met for installation of O-DU High
Software installation and deployment
Software installation and deployment
-==========================================
+-------------------------------------
This section describes the installation of the O-DU High on the reference hardware.
Libraries
This section describes the installation of the O-DU High on the reference hardware.
Libraries
Following libraries are required to compile and execute O-DU High:
Following libraries are required to compile and execute O-DU High:
- Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
- Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
Setting up Netconf server (Only if O1 interface enabled)
Setting up Netconf server (Only if O1 interface enabled)
---------------------------------------------------------
-
+========================================================
+
Following steps are required to compile and run ODU with O1 interface enabled.
- Create a new netconf user
Following steps are required to compile and run ODU with O1 interface enabled.
- Create a new netconf user
Compilation with O1 interface enabled
Compilation with O1 interface enabled
---------------------------------------
+=====================================
*********************
O-DU High Architecture
*********************
O-DU High Architecture
O-DU implements the functional blocks of L2 layer of a 5G NR protocol stack in SA(StandAlone) mode.
These layers primarily include NR MAC, NR Scheduler and NR RLC layers.
O-DU implements the functional blocks of L2 layer of a 5G NR protocol stack in SA(StandAlone) mode.
These layers primarily include NR MAC, NR Scheduler and NR RLC layers.
Figure 1 - O-DU High Architecture Diagram
O-DU High Thread Architecture
Figure 1 - O-DU High Architecture Diagram
O-DU High Thread Architecture
--------------------------------
+==============================
As shown in Figure 1, there are multiple entities within O-DU High. Modules sharing a
given color belong to one thread. O-DU architecture can be defined at a thread
As shown in Figure 1, there are multiple entities within O-DU High. Modules sharing a
given color belong to one thread. O-DU architecture can be defined at a thread
- Thread 8: O1
O-DU High Modules
- Thread 8: O1
O-DU High Modules
---------------------------
DU APP
^^^^^^^^^^^^^^^^^^
DU APP
^^^^^^^^^^^^^^^^^^
O-DU Utility and Common Functions
O-DU Utility and Common Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
These modules contain platform specific files and support O-DU High functionality and message exchanges.
These modules contain platform specific files and support O-DU High functionality and message exchanges.
-======================
-
This section describes the other modules that O-DU High interfaces with, as shown in below diagram.
This section describes the other modules that O-DU High interfaces with, as shown in below diagram.
-========================
Cell Up and Broadcast Procedure
Cell Up and Broadcast Procedure
---------------------------------
+================================
This section describes the cell-up procedure within O-DU High.
This section describes the cell-up procedure within O-DU High.
- RRC Release
Closed Loop Automation Procedure
- RRC Release
Closed Loop Automation Procedure
------------------------------------
+================================
This section describes the closed loop automation procedure within O-DU High.
This section describes the closed loop automation procedure within O-DU High.
O1 Netconf get-alarm list procedure
O1 Netconf get-alarm list procedure
------------------------------------
+===================================
This section describes the *Health Status Retrieval* scenario of O-DU High health-check. It enables a northbound client(SMO) to retrieve the health of the O-DU High based on the last self-check performed. The alarm-list is provided as the response to the request via O1 Netconf interface.
This section describes the *Health Status Retrieval* scenario of O-DU High health-check. It enables a northbound client(SMO) to retrieve the health of the O-DU High based on the last self-check performed. The alarm-list is provided as the response to the request via O1 Netconf interface.
Network Slicing procedure
Network Slicing procedure
---------------------------
+=========================
This section describes the Network Slicing feature within O-DU High.
This section describes the Network Slicing feature within O-DU High.
Idle Mode Paging procedure
Idle Mode Paging procedure
----------------------------
-
+===========================
This section describes the Idle Mode Paging procedure within O-DU High.
This section describes the Idle Mode Paging procedure within O-DU High.
- MAC forwards the PAGE to PHY in TX_Data.Request.
Inter-DU Handover within O-CU
- 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.
This section describes the handling of inter-DU handover of a UE within O-DU High.
-=========================
The O-DU High partially supports below use-cases:
The O-DU High partially supports below use-cases:
| | |
+--------------------------------------+--------------------------------------+
| **Repo/commit-ID** |o-du/l2/ |
| | |
+--------------------------------------+--------------------------------------+
| **Repo/commit-ID** |o-du/l2/ |
-| |I6058cf6966e75f31aa568ba5030c16d2723 |
-| |515eb |
+| |I5166fb1b6f04ed7e7d40344b21b0633259a |
+| |26660 |
| | |
+--------------------------------------+--------------------------------------+
| **Release designation** | F release |
| | |
+--------------------------------------+--------------------------------------+
| **Release designation** | F release |
The call flow between O-DU High and CU Stub can be achieved by executing docker containers.
- Pull the last built 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:6.0.2
- - docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:6.0.2
+ - docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:6.0.3
+ - docker pull nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:6.0.3
- Run CU Stub docker:
- docker run -it --privileged --net=host --entrypoint bash
- 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:6.0.2
+ nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2-cu-stub:6.0.3
- ./cu_stub
- Run ODU docker:
- docker run -it --privileged --net=host --entrypoint bash
- ./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:6.0.2
+ nexus3.o-ran-sc.org:10004/o-ran-sc/o-du-l2:6.0.3
---
distribution_type: container
---
distribution_type: container
-container_release_tag: 6.0.2
+container_release_tag: 6.0.3
container_pull_registry: nexus.o-ran-sc.org:10004
container_push_registry: nexus.o-ran-sc.org:10002
project: o-du-l2
container_pull_registry: nexus.o-ran-sc.org:10004
container_push_registry: nexus.o-ran-sc.org:10002
project: o-du-l2
-ref: 16d167817574850a75f64df4579e896d3ab2af47
+ref: c15c9bf54ea369c1281d4f75967b5cd71c2c3bb8
containers:
- name: o-du-l2
containers:
- name: o-du-l2
---
distribution_type: container
---
distribution_type: container
-container_release_tag: 6.0.2
+container_release_tag: 6.0.3
container_pull_registry: nexus.o-ran-sc.org:10004
container_push_registry: nexus.o-ran-sc.org:10002
project: o-du-l2
container_pull_registry: nexus.o-ran-sc.org:10004
container_push_registry: nexus.o-ran-sc.org:10002
project: o-du-l2
-ref: 16d167817574850a75f64df4579e896d3ab2af47
+ref: c15c9bf54ea369c1281d4f75967b5cd71c2c3bb8
containers:
- name: o-du-l2-cu-stub
containers:
- name: o-du-l2-cu-stub