Using RF Simulator Mode

The OpenAirInterface (OAI) RF simulator enables testing without access to physical radio hardware. This tutorial summarizes the basic usage for the RF simulator. For further details, see the the following resources:

Basic Configuration

When launching the gNB container, include these parameters in the USE_ADDITIONAL_OPTIONS parameter of the docker-compose.yaml file:

--rfsimulator.options chanmod
--telnetsrv

On the UE side, activate the RF-Simulator with these parameters:

--rfsimulator.options chanmod
--rfsimulator.serveraddr 192.168.71.140 # <gNB_IP_ADDRESS>

You can find an example configuration file in the configs/rfsim_arm64 folder.

Dynamic Re-configuration

The RF simulator supports runtime configuration through Telnet. See Telnet Usage Guide for details.

To control the downlink channel (on the UE):

# Connect to UE
telnet 192.168.71.150 9090

# View current settings
channelmod show current

# View available profiles
channelmod show predef

# Set noise power
channelmod modify 0 noise_power_dB -10

To control the uplink channel (on the gNB), connect to gNB and configure uplink:

# Connect to gNB
telnet 192.168.71.140 9090

# Set noise power
channelmod modify 1 noise_power_dB -10

Note

Changes take effect immediately. No restart is required.