X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?p=o-du%2Fphy.git;a=blobdiff_plain;f=docs%2FSetup-Configuration_fh.rst;fp=docs%2FSetup-Configuration_fh.rst;h=7b387b2c9695ffc5f403ccd5fc2aa186eae870f4;hp=fa9ac07699d9b549048c2d0458c2d94560266a98;hb=892daba4c616407f16506415d5a69549519ef11d;hpb=76b4495d593ccf45d712db1a3ec96fa9d2d8f5f5 diff --git a/docs/Setup-Configuration_fh.rst b/docs/Setup-Configuration_fh.rst index fa9ac07..7b387b2 100644 --- a/docs/Setup-Configuration_fh.rst +++ b/docs/Setup-Configuration_fh.rst @@ -31,25 +31,42 @@ below. Steps for running the sample application on the O-DU side and 0-RU side are the same, except configuration file options may be different. -.. image:: images/Setup-for-xRAN-Testing.jpg +.. image:: images/Setup-for-O-RAN-Testing.jpg :width: 400 - :alt: Figure 26. Setup for O-RAN Testing + :alt: Figure 27. Setup for O-RAN Testing -Figure 26. Setup for O-RAN Testing +Figure 27. Setup for O-RAN Testing -.. image:: images/Setup-for-xRAN-Testing-with-PHY-and-Configuration-C3.jpg + + +.. image:: images/Setup-for-O-RAN-Testing-with-PHY-and-Configuration-C3.jpg + :width: 400 + :alt: Figure 28. Setup for O-RAN Testing with PHY and Configuration C3 + +Figure 28. Setup for O-RAN Testing with PHY and Configuration C3 + + + +.. image:: images/Setup-for-O-RAN-Testing-with-PHY-and-Configuration-C3-for-Massive-MIMO.jpg :width: 400 - :alt: Figure 27. Setup for O-RAN Testing with PHY and Configuration C3 + :alt: Figure 29. Setup for O-RAN Testing with PHY and Configuration C3 for + +Figure 29. Setup for O-RAN Testing with PHY and Configuration C3 for +Massive MIMO + -Figure 27. Setup for O-RAN Testing with PHY and Configuration C3 A.2 Prerequisites ----------------- -Each server in Figure 26 requires the following: + +Each server in *Figure 27* requires the following: - Wolfpass server according to recommended BOM for FlexRAN such as Intel® Xeon® Skylake Gold 6148 FC-LGA3647 2.4 GHz 27.5 MB 150W 20 - cores (two sockets) + cores (two sockets) or higher + +- Wilson City or Coyote Pass server with Intel® Xeon® Icelake CPU for + Massive-MIMO with L1 pipeline testing - BIOS settings: @@ -164,11 +181,9 @@ ESX*, FreeBSD*, and EFI/EFI2 are located at: .. -https://downloadmirror.intel.com/682037/readme_8_50.txt -(700 series) +https://downloadcenter.intel.com/download/24769 (700 series) -https://downloadmirror.intel.com/709693/readme_3.10.txt -(E810 series) +https://downloadcenter.intel.com/download/29736 (E810 series) PTP Grand Master is required to be available in the network to provide synchronization of both O-DU and RU to GPS time. @@ -177,9 +192,9 @@ The software package includes Linux\* CentOS\* operating system and RT patch according to FlexRAN Reference Solution Cloud-Native Setup document (refer to Table 2). Only real-time HOST is required. -1. Install Intel® C++ Compiler v19.0.3 +1. Install Intel® C++ Compiler v19.0.3 or OneAPI compiler (preferred) -2. Download DPDK v20.11.1 +2. Download DPDK v20.11.3 3. Patch DPDK with FlexRAN BBDev patch as per given release. @@ -262,7 +277,7 @@ to O-RAN Front haul:: ICE_WRITE_REG(hw, QINT_TQCTL(base_queue + i), val_tx); } -5.Build and install DPDK:: +5.Build and install the DPDK:: See https://doc.dpdk.org/guides/prog_guide/build-sdk-meson.html @@ -517,29 +532,29 @@ Install and Configure Sample Application To install and configure the sample application: -1. Set up the environment:: +1. Set up the environment(shown for icc change for icx):: For Skylake and Cascadelake export GTEST_ROOT=pwd/gtest-1.7.0 - export RTE_SDK=pwd/dpdk-20.11.1 + export RTE_SDK=pwd/dpdk-20.11.3 export RTE_TARGET=x86_64-native-linuxapp-icc export DIR_WIRELESS_SDK_ROOT=pwd/wireless_sdk export WIRELESS_SDK_TARGET_ISA=avx512 export SDK_BUILD=build-${WIRELESS_SDK_TARGET_ISA}-icc export DIR_WIRELESS_SDK=${DIR_WIRELESS_SDK_ROOT}/${SDK_BUILD} - export MLOG_DIR=pwd/flexran_l1_sw/libs/mlog - export XRAN_DIR=pwd/flexran_xran + export MLOG_DIR=`pwd`/flexran_l1_sw/libs/mlog + export XRAN_DIR=`pwd`/flexran_xran for Icelake - export GTEST_ROOT=pwd/gtest-1.7.0 - export RTE_SDK=pwd/dpdk-20.11.1 + export GTEST_ROOT=`pwd`/gtest-1.7.0 + export RTE_SDK=`pwd`/dpdk-20.11 export RTE_TARGET=x86_64-native-linuxapp-icc - export DIR_WIRELESS_SDK_ROOT=pwd/wireless_sdk + export DIR_WIRELESS_SDK_ROOT=`pwd`/wireless_sdk export WIRELESS_SDK_TARGET_ISA=snc export SDK_BUILD=build-${WIRELESS_SDK_TARGET_ISA}-icc export DIR_WIRELESS_SDK=${DIR_WIRELESS_SDK_ROOT}/${SDK_BUILD} - export MLOG_DIR=pwd/flexran_l1_sw/libs/mlog - export XRAN_DIR=pwd/flexran_xran + export MLOG_DIR=`pwd`/flexran_l1_sw/libs/mlog + export XRAN_DIR=`pwd`/flexran_xran 2. export FLEXRAN_SDK=${DIR_WIRELESS_SDK}/install Compile mlog library:: @@ -580,23 +595,30 @@ Install and Configure FlexRAN 5G NR L1 Application The 5G NR layer 1 application can be used for executing the scenario for mmWave with either the RU sample application or just the O-DU side. The current release supports the constant configuration of the slot pattern -and RB allocation on the PHY side. +and RB allocation on the PHY side. The build process follows the same +basic steps as for the sample application above and is similar to +compiling 5G NR l1app for mmWave with Front Haul FPGA. Please follow the +general build process in the FlexRAN 5G NR Reference Solution L1 User +Guide (refer to *Table 2*.) (For information only as a FlexRAN binary blob +is delivered to the community) -1. O-RAN library is enabled by default l1 application: +1. O-RAN library is enabled by default l1 application 2. Get the FlexRAN L1 binary from https://github.com/intel/FlexRAN. Look for the l1/bin/nr5g/gnb/l1 folder for the l1app binary and the corresponding phycfg and xrancfg files. 3. Configure the L1app using bin/nr5g/gnb/l1/phycfg_xran.xml and -xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: +xrancfg_sub6.xml (or other xml if it is mmW or massive MIMO). :: - - oran_e_maintenance_release_v1.0 - + + oran_f_release_v1.0 + 1 - + 25 - + 1 @@ -705,8 +727,13 @@ xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: 0x8000000000, 96, 0 + 0x0000000000, 96, 0 0 + + 0 + + 0 0 @@ -752,6 +779,9 @@ xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: 0 0 + + 0 + 1 0 @@ -764,11 +794,19 @@ xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: 1 + + 0 - 8 + 9 0 + + 0 + + 16 + 6 + 6 1 @@ -817,14 +855,14 @@ xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: -4. Modify bin/nr5g/gnb/l1/dpdk.sh (change PCIe addresses from VFs). :: +4. Modify l1/bin/nr5g/gnb/l1/dpdk.sh (change PCIe addresses from VFs). :: $RTE_SDK/usertools/dpdk-devbind.py --bind=vfio-pci 0000:21:02.0 $RTE_SDK/usertools/dpdk-devbind.py --bind=vfio-pci 0000:21:02.1 5. Use configuration of test mac per:: - /bin/nr5g/gnb.testmac/cascade_lake-sp/csxsp_mu1_100mhz_mmimo_hton_xran.cfg + l1//bin/nr5g/gnb.testmac/cascade_lake-sp/csxsp_mu1_100mhz_mmimo_hton_xran.cfg (info only N/A) phystart 4 0 40200 TEST_FD, 1002, 1, fd/mu3_100mhz/2/fd_testconfig_tst2.cfg @@ -832,28 +870,23 @@ xrancfg_sub6.xml (or other xml if it is mmwave or massive MIMO). :: 6. To execute l1app with O-DU functionality according to O-RAN Fronthaul specification, enter:: - [root@xran flexran] cd ./bin/nr5g/gnb/l1 + [root@xran flexran] cd ./l1/bin/nr5g/gnb/l1 [root@xran l1]#./l1.sh –xran -where output corresponding L1 is 7. To execute testmac with O-DU functionality according to O-RAN Fronthaul specification, enter:: - [root@xran flexran] cd ./bin/nr5g/gnb/testmac + [root@xran flexran] cd ./l1/bin/nr5g/gnb/testmac -8. To execute test case type:: +8. To execute test case type (info only as file not available):: ./l2.sh --testfile=./cascade_lake-sp/csxsp_mu1_100mhz_mmimo_hton_xran.cfg -where output corresponding to Test MAC:: - - [root@sc12-xran-sub6 testmac]# ./l2.sh --testfile=./cascade_lake-sp/csxsp_mu1_100mhz_mmimo_hton_xran.cfg - Configure FlexRAN 5G NR L1 Application for multiple O-RUs with multiple numerologies ==================================================================================== @@ -883,10 +916,10 @@ Solution L1 User Guide (refer to Table 2.) Look for the l1/bin/nr5g/gnb/l1 folder for the l1app binary and the corresponding phycfg and xrancfg files. -3. Configure the L1app using bin/nr5g/gnb/l1/xrancfg_sub6_mmimo.xml. +3. Configure the L1app using bin/nr5g/gnb/l1/xrancfg_sub6_mmimo.xml.:: - - oran_e_maintenance_release_v1.0< + + oran_f_release_v1.0< 3 @@ -1182,7 +1215,7 @@ Solution L1 User Guide (refer to Table 2.) 0,273,0,14,1,1,1,9,1,0,0 0,273,0,14,1,1,1,9,1,0,0 - + 4. Modify ./bin/nr5g/gnb/l1/dpdk.sh (change PCIe addresses from VFs). :: @@ -1203,6 +1236,7 @@ Solution L1 User Guide (refer to Table 2.) 5. Use configuration of test mac per:: + (Info only as these files not avilable) /bin/nr5g/gnb/testmac/icelake-sp/icxsp_mu1_100mhz_mmimo_64x64_hton_xran.cfg phystart 4 0 100200 TEST_FD, 3370, 3, fd/mu1_100mhz/376/fd_testconfig_tst376.cfg, @@ -1211,18 +1245,17 @@ Solution L1 User Guide (refer to Table 2.) 6. To execute l1app with O-DU functionality according to O-RAN Fronthaul specification, enter:: - [root@xran flexran] cd ./bin/nr5g/gnb/l1 + [root@xran flexran] cd ./l1/bin/nr5g/gnb/l1 ./l1.sh -xranmmimo Radio mode with XRAN - Sub6 100Mhz Massive-MIMO (CatB) + 7. To execute testmac with O-DU functionality according to O-RAN Fronthaul specification, enter:: - [root@xran flexran] cd ./bin/nr5g/gnb/testmac + [root@xran flexran] cd ./l1/bin/nr5g/gnb/testmac 8. To execute test case type:: + (Info only as file not available) ./l2.sh --testfile=./cascade_lake-sp/csxsp_mu1_100mhz_mmimo_hton_xran.cfg -where output corresponding to Test MAC:: - - root@icelake-scs1-1 testmac]# ./l2.sh --testfile=./icelake-sp/icxsp_mu1_100mhz_mmimo_64x64_hton_xran.cfg