c0e386e42d
Set SA mode as default - Set standalone (SA) mode as the default. - Adjust commands in Docker Compose files by removing --sa flags and adding --nsa flags where applicable. - Add a function to verify that only one mode is being used at a time. - Update all relevant documentation.
3.1 KiB
|
L2 nFAPI Simulator Usage |
4G L2 nFAPI simulator
This simulator allows to test L2 and above Layers using the nFAPI interface.
The UE executable is able to "simulate" multiple UEs in order to stimulate the scheduler in the eNB.
This simulator is available starting the v1.0.0 release on the master branch.
2022/03/08: CAUTION, THIS TUTORIAL IS NO LONGER VALID on the develop branch after the 2022.w01 tag.
2022/03/08: CAUTION, THE LAST VALID TAG on develop branch is 2021.w51_c.
Currently the Continuous Integration process is validating this simulator the following way:
- the LTE modem executable is run on one host (in our CI deployment it is a Xenial Virtual Machine)
- the UE(s) modem executable is run on another host (in our CI deployment it is also a Xenial Virtual Machine)
- We are testing:
- in S1 mode (ie we are connected to a 3rd-party EPC)
- in noS1 mode (no need for an EPC)
Normally it should be fine to run both executables on the same host using the loopback interface to communicate. But we are not guaranting it
2022/03/08: Starting the 2022.w01 tag on the develop branch, the L2 nFAPI simulation is using a proxy.
5G L2 nFAPI simulator
Note: L2 simulator does not work anymore.
Download and Build the Proxy Server (from EpiSci)
$ cd ~
$ git clone https://github.com/EpiSci/oai-lte-5g-multi-ue-proxy.git
$ cd oai-lte-multi-ue-proxy
$ make
Start Proxy Server
Set the number of UEs to connect to server as 1 and the mode is SA.
$ number_of_ues=1
$ sudo -E ./build/proxy $number_of_ues --nr
Start gNB
$ sudo -E ./nr-softmodem -O ../ci-scripts/conf_files/episci/proxy_rcc.band78.tm1.106PRB.nfapi.conf --nfapi VNF --noS1 --emulate-l1
Start UE
$ sudo -E ./nr-uesoftmodem -O ../ci-scripts/conf_files/nrue.uicc.conf --nfapi STANDALONE_PNF --node-number 2 --emulate-l1
EpiSci's Documentation
A more detailed tutorial is available on the EpiSci GitHub Repository.
This proxy allows to perform L2 nFAPI simulator for:
- LTE
- 5G-NSA
- 5G-SA
L2 Simulator as Docker Containers
There used to be docker deployment with L2sim that was run in the CI. Since L2
simulator does not work anymore, it has been removed. However, you can see the
old README.md from tag 2024.w44
here.
In the same directory is a docker-compose.yaml file that can be used to run
L2sim.