This page is dedicated to the 5G-NR development in OpenAirInterface
Building and usage
to build gNB and UE for USRP target use
./build_oai --gNB -w USRP
./build_oai --nrUE -w USRP''
to run gNB
sudo ./nr_softmodem -O ../../../targets/PROJECTS/GENERIC-LTE-EPC/CONF/gnb.band78.tm1.106PRB.usrpn300.conf''
You should edit the config file and make sure that your USRP is configured correctly (IP addresses, etc).
to run the UE
``sudo ./nr-uesoftmodem --numerology 1 -r 106 --phy-test -C 3510000000 --usrp-args "addr=192.168.30.2,clock_source=external,time_source=external"''
Of course, the IP addresses have to be replaced with yours.
all of them can be compiled using
Main branch for development is oai/develop-nr. When a new feature for 5G-NR is developed, a feature branch is created starting from the latest oai/develop-nr. When finished it is merged back to oai/develop-nr. Further, oai/develop-nr is regularly updated with oai/develop.
Progress is also discussed in our developer meetings. See OpenAirDevMeetingsfor more details.
The processing requirements for 5G-NR are much higher as for 4G, so a high end PC or server is needed. So far we have been using
Intel Core i7 6900K (8 cores), 16GB DDR, 480GB SSD (~2200€).
Allows SW LDPC on 3 cores (1 segment per slot, 3 slots decoded in parallel, up to 30Mb/s) or LDPC on FPGA (up to 300Mb/s on 80MHz SISO).
Intel Core i9 7980EX (18 cores) shall support future configurations incl. MIMO (~3700 €).
Allows parallel LDPC SW decoder on 9 or 12 cores, up to 3 (tested) or 5 (ongoing) segments per slot or 140Mb/s or LDPC on FPGA (same as above)
Intel(R) Xeon(R) Gold 6154 CPU @ 3.00GHz with 18 cores and 2x10Gbit Ethernet
This older platform will also work with 5G-NR, but only supports bandwidths up to 80MHz with 3/4 sampling.
The SYRTEM platform is based on the Xilinx EVALUATION KIT ZYNQ-7000 ZC706 (ex. supplier Digikey ref: 122-1904-ND, 2427€)
and the Analog Device Transceiver type ADRV9371 (ex. supplier : Digikey ADRV9371-W/PCBZ-ND ('WIDE TUNING RANGE 300MHZ-6HGZ' version) 1169€).
As a high performance alternative to the software LDPC decoder included in this release, the decoder can also be offloaded to another FPGA board (EVALUATION KIT ZYNQ-7000 ZC706). The FPGA binary image provided by Creonic (https://www.creonic.com) while the drivers are provided by Syrtem (http://www.syrtem.com/). Please get in touch with us if you want to use them.
Ubuntu 16.04 or 17.10 with the lowlatency kernel option
CentOS Linux release 7.4.1708 (Core)
Releases and roadmap
First NR release (MWC 2018)
TCL, Eurecom and other partners have demonstrated their first version of 5G-NR at MWC 2018 (see here for more details)
On this page you will find all the necessary information to reproduce this demo.
Functionalities and Limitations
The highlight of the current release are the highly optimized LDPC encoder and decoder that are used instead of the Turbo encoder and decoder (These are located in openair1/PHY/CODING).
Supported as of today: PHY-test mode only, 40/80MHz, SCS 60kHz, LDPC, adapted LTE L1.
Other notes/ restrictions:
The throughput (mcs) is limited by the performance of the gNB PC (and the UE PC in case the software LDPC decoder is used). For the setup mentioned above, the MCS is limited to 15, but it might be different on other PCs and also with the USRP.
some parameters are hard coded: in lte-softmodem.c: rf-config-file (for ADRV9371_ZC706 target), numerology, in eNB_scheduler_phytest.c: mcs
command line parameters to be used at eNB: --phy-test -O <path_to_config_files>/enb.band7.tm1.100PRB.usrpx310.conf -E (for 3/4 sampling in case of USRP X300)