docs/README

   1 Directory Structure :
   2 ---------------------
   3 1. l2/build/ : contains files required to compile the code
   4    a. common : contains individual module's makefile
   5    b. config : contains SSI memory configuration
   6    c. odu    : contains main makefile to generate an executable binary
   7
   8 2. l2/docs/  : contains README and other configuration files for building docs
   9
  10 2. l2/src/ : contains layer specific source code
  11    a. 5gnrmac  : MAC source code
  12    b. 5gnrrlc  : RLC source code
  13    c. cm       : common, environment and interface files
  14    d. cu_stub  : Stub code for CU
  15    e. du_app   : DU application and F1 code
  16    f. mt       : wrapper functions over OS
  17    g. phy_stub : Stub code for Physical layer
  18    h. rlog     : logging module
  19
  20
  21 Pre-requisite for Compilation :
  22 -------------------------------
  23 1. Linux 32-bit/64-bit machine
  24 2. GCC version 4.6.3 and above
  25 3. Install LKSCTP
  26    a. On Ubuntu : sudo apt-get install -y libsctp-dev
  27    b. On CentOS : yum install lksctp-tools
  28
  29
  30 How to Clean and Build:
  31 -----------------------
  32 1. Building ODU binary:
  33    a. Build folder
  34          cd l2/build/odu
  35    b. Building ODU binary
  36          make odu MACHINE=BIT64 MODE=FDD
  37    c. Cleaning ODU binary
  38          make clean_odu MACHINE=BIT64 MODE=FDD
  39
  40 2. Building CU Stub binary:
  41    a. Build folder
  42          cd l2/build/odu
  43    b. Building CU Stub binary
  44          make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
  45    c. Cleaning CU Stub binary
  46          make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
  47
  48 2. Building RIC Stub binary:
  49    a. Build folder
  50          cd l2/build/odu
  51    b. Building RIC Stub binary
  52          make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
  53    c. Cleaning RIC Stub binary
  54          make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
  55
  56 4. Cleaning ODU and CU Stub
  57       make clean_all MACHINE=BIT64 MODE=FDD
  58
  59 How to execute:
  60 ---------------
  61 1. Assign virtual IP addresses as follows:
  62       ifconfig <interface name>:ODU "192.168.130.81"
  63       ifconfig <interface name>:CU_STUB "192.168.130.82"
  64       ifconfig <interface name>:RIC_STUB "192.168.130.80"
  65
  66 2. CU execution folder:
  67       cd l2/bin/cu_stub
  68
  69 3. Run CU Stub binary:
  70       ./cu_stub
  71
  72 4. RIC execution folder:
  73       cd l2/bin/ric_stub
  74
  75 5. Run RIC Stub binary:
  76       ./ric_stub
  77
  78 4. DU execution folder:
  79       cd l2/bin/odu
  80
  81 5. Run ODU binary:
  82       ./odu
  83
  84 PS: CU stub and RIC stub must be run (in no particular sequence) before ODU