Fix for L2 compilation with WLS [Issue-ID: ODUHIGH-240]
[o-du/l2.git] / docs / README
index 91d4f14..3a0bf8a 100644 (file)
@@ -4,10 +4,12 @@ Directory Structure :
    a. common : contains individual module's makefile
    b. config : contains SSI memory configuration
    c. odu    : contains main makefile to generate an executable binary
+
+2. l2/docs/  : contains README and other configuration files for building docs
        
 2. l2/src/ : contains layer specific source code
    a. 5gnrmac  : MAC source code
-   b.  5gnrrlc  : RLC source code
+   b. 5gnrrlc  : RLC source code
    c. cm       : common, environment and interface files
    d. cu_stub  : Stub code for CU
    e. du_app   : DU application and F1 code 
@@ -20,6 +22,9 @@ Pre-requisite for Compilation :
 -------------------------------
 1. Linux 32-bit/64-bit machine
 2. GCC version 4.6.3 and above
+3. Install LKSCTP
+   a. On Ubuntu : sudo apt-get install -y libsctp-dev
+   b. On CentOS : yum install lksctp-tools
 
 
 How to Clean and Build:
@@ -36,29 +41,44 @@ How to Clean and Build:
    a. Build folder
          cd l2/build/odu
    b. Building CU Stub binary
-         make cu_stub MACHINE=BIT64 MODE=FDD
+         make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
    c. Cleaning CU Stub binary
-         make clean_cu MACHINE=BIT64 MODE=FDD
+         make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
+
+2. Building RIC Stub binary:
+   a. Build folder
+         cd l2/build/odu
+   b. Building RIC Stub binary
+         make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
+   c. Cleaning RIC Stub binary
+         make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
 
-3. Cleaning ODU and CU Stub
+4. Cleaning ODU and CU Stub
       make clean_all MACHINE=BIT64 MODE=FDD
 
 How to execute:
 ---------------
 1. Assign virtual IP addresses as follows:
-      ifconfig <interface name>:ODU "10.0.2.20"
-      ifconfig <interface name>:CU_STUB "10.0.2.25"
+      ifconfig <interface name>:ODU "192.168.130.81"
+      ifconfig <interface name>:CU_STUB "192.168.130.82"
+      ifconfig <interface name>:RIC_STUB "192.168.130.80"
 
 2. CU execution folder:
       cd l2/bin/cu_stub
      
 3. Run CU Stub binary:
-      ./cu_stub -f ../config/ssi_mem
+      ./cu_stub
+
+4. RIC execution folder:
+      cd l2/bin/ric_stub
+     
+5. Run RIC Stub binary:
+      ./ric_stub
 
 4. DU execution folder:
       cd l2/bin/odu
      
 5. Run ODU binary:
-      ./odu -f ../config/ssi_mem
+      ./odu
 
-PS: CU stub must be run first
+PS: CU stub and RIC stub must be run (in no particular sequence) before ODU