SE6: Single-Node 5G SA
1) Experiment Overview
1) Experiment Overview
Experiment Definition: The user logs into the E-VM on a fixed (virtual) AERPAW Node (Machine #1) and one E-VM on the portable (virtual), or fixed, AERPAW Node (Machine #2). At the end of the experiment, the user can view logs and test results.
Experiment Scenarios Applicable: S1, S2, S3, S4, S7. These scenarios correspond to various different user experimentation scenarios in AERPAW.
Experiment Goals: The main goal of this experiment is to provide a complete end-to-end 5G SA network, using srsUE with OCUDU GnB and open5GS. The different modes offered in this experiment are EMULATION, TESTBED and applicable tests for these modes are PING, IPERF
Mode Descriptions
EMULATION
Base Station to Single UE Link (1 BS+Core PC + 1 UE PC)
Description: Two or more radio modules (on each side) send IQ samples to the channel emulator, so the channel emulator should be stated such that it can forward (selectively) IQ samples.
TESTBED
Base Station to Single UE Link (1 BS+Core PC + 1 UE PC)
Description: This mode sets up an 5G Core, GnB, and a UE. A connection will be established. If the default configuration settings are used, the experiment runs using settings for TDD in band n78.
Test Descriptions
PING
Description: Ping (latency is the technically more correct term) means the time it takes for a small data set to be transmitted from your device to a server on the Internet and back to your device again. The ping time is measured in milliseconds (ms)
IPERF
Description: Iperf has client and server functionality, and can create data streams to measure the throughput between the two ends in one or both directions.
Software
Machine #1 (for B205mini / B210 Container)
- Ubuntu version 22.04
- Open CU DU (OCUDU)
- Open5GS
- uhd 4.2.0.1
Machine #2 (for B205mini / B210 container)
- Ubuntu version 22.04
- Openairinterface (OAI) NR UE
- uhd 4.2.0.1
3) Modifying the Experiment Configuration Parameters
ARFCN (center frequency) — set via cell_cfg.dl_arfcn in gnb.yaml: this sets the center frequency of the downlink transmission for 3GPP supported bands. The uplink center frequency should be set according to the downlink frequency since it is a TDD band.
USRP Tx Gain — set via ru_sdr.tx_gain in gnb.yaml (overridden at launch by startOCUDU-5G-SISO-GNB.sh): sets the gain of the variable PA in the USRP, in the range of 0 to 89 for B series, 0 to 30 for X310. AERPAW's OCUDU profile defaults to 70 dB.
USRP Rx Gain — set via ru_sdr.rx_gain in gnb.yaml (overridden at launch by startOCUDU-5G-SISO-GNB.sh): sets the gain of the variable PA in the USRP, in the range of 0 to 76 for B series, 0 to 30 for X310. AERPAW's OCUDU profile defaults to 40 dB.
2) Modifying the Experiment Configuration Parameters:
Open5GS Core Network configuration (Machine # 1)#
The database can be modified using the Open5GS Database Configuration Tool. To add a user with default values
$ /opt/open5gs/build/misc/db/open5gs-dbctl add [imsi] [key] [opc]To add a user with a specified IP address
$ /opt/open5gs/build/misc/db/open5gs-dbctl add [imsi] [ip] [key] [opc]To remove a user
$ /opt/open5gs/build/misc/db/open5gs-dbctl remove [imsi]Base Station (Machine # 1)#
The shell script /root/Profiles/ProfileScripts/Samples/startOpen5GS-OCUDU-gNB.sh.sh calls a script /root/Profiles/ProfileScripts/Radio/Helpers/startOCUDU-5G-SISO-GNB.sh which can be edited by the experimenter to modify the parameters of the base station.
UE#
The shell script /root/Profiles/ProfileScripts/Samples/startOpen5GS-OAI-UE.sh calls the script /root/Profiles/ProfileScripts/Radio/Helpers/start_OAI_NR_UE.sh which can be edited by the experimenter to modify the parameters of the UE.
3) Performing the Experiment:
3.A) Choosing the Experiment Mode#
Machine #1:
We assume the core network and gNB is the fixed node. Login to the E-VM corresponding to the fixed node. Navigate to the folder containing all the Radio scripts
$ cd /root/Profiles/ProfileScripts/RadioCopy the start Open5GS + OCUDU script as startRadio.sh
$ cp Samples/startOpen5GS-OCUDU-gNB.sh startRadio.shUse an editor to uncomment the line /Radio/startRadio.sh in /root/startexperiment.sh and run the following command:
$ /root/startexperiment.shMachine #2:
5G SA UE configuration#
The shell script /root/Profiles/ProfileScripts/Samples/startOpen5GS-OAI-UE.sh calls the script /root/Profiles/ProfileScripts/Radio/Helpers/start_OAI_NR_UE.sh which can be edited by the experimenter to modify the parameters of the UE.
We assume the UE is a portable node. Login to the E-VM corresponding to the portable node. Navigate to the folder containing all the Radio scripts
$ cd /root/Profiles/ProfileScripts/RadioCopy the OAI NR UE script as startRadio.sh
$ cp Samples/startOpen5GS-OAI-UE.sh startRadio.shUse an editor to uncomment the line /Radio/startRadio.sh in /root/startexperiment.sh and run the following command:
$ /root/startexperiment.sh4) Results:
Results can be viewed by executing the following commands:
4.A) Ping Results:#
The UE will search for a cell at the specific frequency. The experiment generates timestamped measurement log under the /root/Results folder. Once it finds a cell, it will initiate the attachment processes and once attached, the data sessions can be established.
Openairinterface NR UE logs showing successful connection with the OCUDU gNB#
