Amarisoft

NR 1 Band 2 sdr

The purpose of this tutorial is to show you how to use multiple sdr cards combined (called Stereo Mode) to implement wide bandwidth that is wider than the maximum bandwidth of single sdr card. As of now, Amarisoft products are based on one of the following two types sdr cards as follows. The main difference between them are maximum bandwidth it can cover.

There is no issues (no major differences) for LTE regardless of whether you use SDR50 or SDR100 since the max bandwidth of LTE is only 20 Mhz, but there would be some cases where you come across issues for NR if you are using SDR50 since there are various kinds of configuration that uses the bandwidth wider than 50Mhz.  Then how do we test NR with Bandwidth greater than 50Mhz with sdr50 ?  This tutorial would provide you with the solution for the case. The idea is to combine two sdr50 cards that enables to handle max 100 Mhz bandwidth.

NOTE : This kind of utilization of sdr 50 (Stereo Mode) is supported only in Callbox, not supported in UEsim. Therefore, in order for you to test NR with the bandwidth greater than 50 Mhz on UEsim, you need to use UEsim that uses SDR100.

Table of Contents

Introduction

Software Defined Radios (SDRs) have revolutionized wireless communications by providing flexible, programmable platforms capable of emulating a variety of radio protocols and adapting to new standards through software updates. In the context of wireless network testing and development, products like Amarisoft Callbox utilize advanced SDR hardware to emulate base stations and user equipment for technologies such as LTE and 5G NR (New Radio). One of the architectural challenges faced in modern 5G NR testing environments is the requirement for extremely wide channel bandwidths, often exceeding the maximum supported by a single SDR card. To address this, Amarisoft's Callbox platforms implement a technique known as Stereo Mode, where multiple SDR cards are synchronized and combined to operate as a single logical interface, effectively aggregating their individual bandwidth capabilities. For example, while the SDR50 card supports up to 50 MHz of RF bandwidth and the SDR100 supports up to 100 MHz, certain NR test scenarios—especially those simulating high-capacity or carrier aggregation use cases—may require more than 50 MHz on platforms equipped only with SDR50 cards. Stereo Mode enables two SDR50 cards to be used together to deliver up to 100 MHz bandwidth, thus overcoming hardware limitations without the need for a more expensive SDR100 card. This capability is critical for comprehensive NR testing and ensures that test equipment can keep pace with evolving wireless standards. Understanding and correctly configuring Stereo Mode is essential for engineers and testers aiming to validate wideband NR configurations, optimize performance, and ensure conformance with 3GPP specifications within the Amarisoft testing ecosystem.

Summary of the Tutorial

This tutorial details the procedures and methodologies for configuring and testing NR Standalone (SA) and Non-Standalone (NSA) cells with 100 MHz bandwidth using multiple SDR50 cards, as a single SDR50 can only support up to 50 MHz bandwidth. The tutorial covers two main test scenarios and provides tips for SDR card combinations.

The tutorial emphasizes adjusting configuration files, properly assigning SDR devices, tuning RF parameters, and validating the test setup using system logs and UE behavior. Detailed message contents and protocol specifics are intentionally omitted in favor of focusing on high-level test methodologies and configuration procedures.

Test Setup

Test setup for this tutorial is as shown below.

The SDR cards in the callbox are connected to external antennas. The UE talks to the callbox over the air. No cable connects the UE to the callbox.

Callbox with multiple SDR cards cabled to external antennas and a UE over the air

Key Configuration Parameters

Followings are important configuration parameters for this tutorial. You may click on the items for the descriptions from Amarisoft documents.

Test 1 : NR SA 100 Mhz BW with 2 x sdr50

In this test, I will show you how to configure a SA cell of 100Mhz BW using two sdr50. The max bandwidth that can be supported by a sdr50 is 50Mhz. So with sdr50 card, it would have not been able to simulate a cell with bandwidth greater than 50Mhz. To overcome this limitation, we implemented the feature to combine two sdr50 cards to simulate a cell with the bandwidth greater than 50 Mhz. So in this test, we need to use two SDR 50 cards even though the number of cell is only one.

Configuration

I used the configuration file gnb-sa-2sdr-0-1.cfg which is copied from gnb-sa.cfg and modified.

enb.cfg symbolic link pointing to gnb-sa-2sdr-0-1.cfg

Configured in gnb-sa-2sdr-0-1.cfg is as shown below. I set NR_BANDWIDTH to 100 Mhz. args:"dev0=/dev/sdr0,dev1=/dev/sdr1" mean that two sdr card sdr0 and sdr1 will be enabled for this test. Another important parameter to configure one cell with multiple sdr card is n_subband parameter in rf_ports. The sample_rate and guard_band are configured to fine tune the two combined sdr cards.

The rest of the defines at the top of the file are the usual FR1 TDD settings. NR_TDD is 1, FR2 is 0 and NR_TDD_CONFIG is 2. N_ANTENNA_DL is 2 for 2x2 MIMO and N_ANTENNA_UL is 1. Only NR_BANDWIDTH is changed to 100 for this test.

In rf_driver, the args line sits inside an #if N_ANTENNA_DL >= 4 branch. Both branches carry the same two devices, dev0=/dev/sdr0 and dev1=/dev/sdr1. Since N_ANTENNA_DL is 2, the #else line is the one in use. dev0 is always the master. rx_antenna is set to "rx" to force the RX antenna on the RX connector in TDD.

The rf_ports block has one entry because there is only one cell. n_subband: 2 splits the 100 MHz cell into two subbands, one for each sdr50. sample_rate is 61.44 MHz and guard_band is 6.1 MHz. If you want to use a different pair of sdr cards, change only the device names in args. The Tips section below shows how.

gnb-sa-2sdr-0-1.cfg with NR_BANDWIDTH 100, two sdr devices and rf_ports n_subband 2

Perform the Test

Run LTE service and check cell configuration in (enb) screen as shown below. Confirm that the Bandwidth are configured as you intended.

I used the cell phy and cell main commands. cell phy shows one NR cell 0x001 on band n78 with BW 100. The DL and UL ARFCN are both 632628 and the SCS is 30 kHz. DL uses 2 antennas and 2 layers. The SSB ARFCN is 629952.

cell main shows the same cell with TAC 0x000064, PCI 500 and PLMN 00101. Even though two sdr cards are used, only one cell appears in both outputs.

cell phy and cell main output with one n78 NR cell of BW 100

Check tx_gain and rx_gain and see if there is any changes comparing to 1 sdr cases. (NOTE : the default / max gain are same as 1 sdr case). In this case, TX0 and TX1 is from sdr0. TX2 and TX3 is from sdr1. RX0 is for sdr0 and RX1 is for sdr1.

tx_gain lists four channels, TX0 to TX3, all on Port 0 with 89.8 dB. rx_gain lists two channels, RX0 and RX1, both on Port 0 with 60.0 dB. All channels belong to Port 0 because both sdr cards serve the same single cell.

tx_gain with TX0 to TX3 at 89.8 dB and rx_gain with RX0 and RX1 at 60.0 dB

Check how RF of each sdr cards are configured. With rf_info command, you can figure out the center frequencies that each sdr cards are tuned to.

TX0, TX1 and RX0 are tuned to 3464.790000 MHz. This is the center frequency of the first subband. TX2, TX3 and RX1 are tuned to 3514.050000 MHz. This is the center frequency of the second subband. The midpoint of the two values is 3489.42 MHz. That is the center of the 100 MHz cell at ARFCN 632628.

The rest of the rf_info output lists each card separately, first PCIe RFIC /dev/sdr0 and then PCIe RFIC /dev/sdr1. Both cards have Hardware ID 0x4b01 and FPGA revision 2021-10-08, with AGC Off. TX underflows=0 and RX overflows=0 tell you that the two cards are running without sample loss.

rf_info with the two subband center frequencies on sdr0 and sdr1

Enable bcch log capturing in (enb) as shown below

The command is log bcch=1. With this, the broadcast messages such as SIB1 are written to the gNB log. ss-PBCH-BlockPower is carried in SIB1, so this is needed for the next step.

log bcch=1 command entered at the enb prompt

Check ss-PBCH-BlockPower as shown below. This value would vary depending on channel Bandwidth and Frequency.

I searched the log with cat /tmp/gnb0.log | grep ss-PBCH-BlockPower. Every SIB1 in this run carries ss-PBCH-BlockPower -32. This is lower than in the 20 MHz case.

grep of gnb0.log with ss-PBCH-BlockPower -32 in every SIB1

Power on UE and let it complete the attach

I used the t command to watch the UE trace. The PRACH line shows cell=01 seq=1 ta=6 snr=15.5 dB. After that the UE with RNTI 4601 is scheduled on cell 001.

Once traffic starts, the DL cqi is 14 to 15 and ri is 2. The DL mcs reaches about 23.0 and the DL brate goes above 90M, up to 98.7M. This confirms that the UE is attached and receiving data on the 100 MHz cell served by the two sdr50 cards.

UE trace on cell 001 with DL brate up to 98.7M after attach

Test 2 : NR NSA 100 Mhz BW with 2 x sdr50

In this test, I will show you how to configure a NSA cell of 100Mhz BW using three sdr50. The max bandwidth that can be supported by a sdr50 is 50Mhz. So with sdr50 card, it would have not been able to simulate a cell with bandwidth greater than 50Mhz. To overcome this limitation, we implemented the feature to combine two sdr50 cards to simulate a cell with the bandwidth greater than 50 Mhz. So in this test, we need to use three SDR 50 cards in total even though the number of cell is only two. One LTE cell uses one sdr50 card and one NR cell uses tw0 sdr50 cards in this test.  

Configuration

I used the configuration file gnb-nsa-2sdr-1-2.cfg which is copied from gnb-nsa.cfg and modified.

enb.cfg symbolic link pointing to gnb-nsa-2sdr-1-2.cfg

Configured in gnb-sa-2sdr-1-2.cfg is as shown below. I set NR_BANDWIDTH to 100 Mhz. If TRX_MAX_BANDWIDTH is narrower than NR_BANDWIDTH, multi sdr card is automatically selected.

The SDR card in my call box (Amari Classic) supports up to 50 MHz. So I set TRX_MAX_BANDWIDTH to 50. The comment in the file says to set it to 50 for the PCIe SDR 50Mhz board and to 100 for the PCIe SDR 100Mhz board. With NR_BANDWIDTH at 100, the NR cell is wider than one board. This is the condition that turns on the multi sdr setup in the rest of the file.

The other defines set up the LTE cell and the NR cell. TDD is 0, so the LTE cell is FDD. N_RB_DL is 100, which is 20 MHz for LTE. NR_TDD is 1 and FR2 is 0, so the NR cell is FR1 TDD with NR_TDD_CONFIG 2. N_ANTENNA_DL is 2. If your callbox has SDR100 boards, set TRX_MAX_BANDWIDTH to 100 and the NR cell uses a single card.

gnb-nsa-2sdr-1-2.cfg with TRX_MAX_BANDWIDTH 50 and NR_BANDWIDTH 100

args:"dev0=/dev/sdr0,dev1=/dev/sdr1,dev2=/dev/sdr2" mean that two sdr card sdr0,sdr1 and sdr2 will be enabled for this test. The configuration in gnb-nsa.cfg in 2021-11-19 release is automatically handling dev with combined sdr card as follows. This is just for your reference. You don't need to change anything in this part.

The args line is chosen by two conditions. The outer one is #if NR_BANDWIDTH > TRX_MAX_BANDWIDTH and the inner one is #if N_ANTENNA_DL <= 2. In this test both are true. So the line in use is "dev0=/dev/sdr0,dev1=/dev/sdr1,dev2=/dev/sdr2". sdr0 serves the LTE cell, and sdr1 and sdr2 together serve the NR cell.

The other branches are not used in this test. With 4x4 MIMO the wide NR case uses six devices, sdr0 to sdr5. When the NR cell fits in one board, the file falls back to two devices for 2x2 or four devices for 4x4.

rf_driver args selecting sdr0, sdr1 and sdr2 when NR_BANDWIDTH exceeds TRX_MAX_BANDWIDTH

Another important parameter to configure one cell with multiple sdr card is n_subband parameter in rf_ports. The sample_rate and guard_band are configured to fine tune the two combined sdr cards. The configuration in gnb-nsa.cfg in 2021-11-19 release is automatically handling rf_ports with combined sdr card as follows. This is just for your reference. You don't need to change anything in this part.

rf_ports has two entries. The first one is the RF port for the LTE cell and it is left empty. The second one is the RF port for the NR cell. Under #if NR_BANDWIDTH > TRX_MAX_BANDWIDTH, it sets n_subband: 2 and guard_band: 6.1 MHz. These are the same values I used in Test 1.

sample_rate depends on TRX_MAX_BANDWIDTH. With TRX_MAX_BANDWIDTH == 50, sample_rate is 61.44 MHz, and this is the line used in this test. With SDR100 boards it would be 122.88 MHz. The #if FR2 block with rf_dl_freq, rf_ul_freq and rx_to_tx_latency is not used, because this test is FR1.

rf_ports NR entry with n_subband 2, guard_band 6.1 and sample_rate 61.44

Perform the Test

Run LTE service and check cell configuration in (enb) screen as shown below. Confirm that the Bandwidth are configured as you intended.

cell phy now shows two cells. Cell 0x001 is the LTE cell on band 1 with BW 20, DL ARFCN 300 and UL ARFCN 18300. It uses RF port 0. Cell 0x002 is the NR cell on n78 with BW 100 and ARFCN 632628. It uses RF port 1, and its SSB ARFCN is 629664.

cell main shows the LTE cell with TAC 0x0001, PCI 1 and PLMN 00101. The NR cell has PCI 500 but no TAC and no PLMN. This is expected for an NSA NR cell, because the UE reaches it through the LTE cell.

cell phy and cell main with LTE band 1 cell and n78 NR cell of BW 100

Check tx_gain and rx_gain and see if there is any changes comparing to 1 sdr cases. (NOTE : the default / max gain are same as 1 sdr case)

tx_gain lists six channels at 89.8 dB. TX0 and TX1 are on Port 0, the LTE cell. TX2 to TX5 are on Port 1, the NR cell. rx_gain lists RX0 on Port 0 and RX1 and RX2 on Port 1, all at 60.0 dB. The NR cell has twice as many channels as the LTE cell because it is spread over two sdr cards.

tx_gain with six TX channels and rx_gain with three RX channels over two ports

Check how RF of each sdr cards are configured.

I used rf_info again. TX0 and TX1 on sdr0 are at 2140.000000 MHz and RX0 is at 1950.000000 MHz. These are the DL and UL center frequencies of the LTE band 1 cell. TX2, TX3 and RX1 on sdr1 are at 3464.790000 MHz, the first subband of the NR cell. TX4, TX5 and RX2 on sdr2 are at 3514.050000 MHz, the second subband.

The NR subband frequencies are the same as in Test 1. Only the cards have moved from sdr0 and sdr1 to sdr1 and sdr2. TX underflows=0 and RX overflows=0 again. The card details start with PCIe RFIC /dev/sdr0.

rf_info with the LTE frequency on sdr0 and the two NR subbands on sdr1 and sdr2

The rest of the rf_info output covers PCIe RFIC /dev/sdr1 and PCIe RFIC /dev/sdr2. Both have Hardware ID 0x4b01 and FPGA revision 2021-10-08, with AGC Off. Together with sdr0, this confirms that all three cards are running.

rf_info card details for sdr1 and sdr2

Power on UE and let it complete the attach

There are two PRACH lines in the trace. The first one is on cell=01, the LTE cell, with seq=47. The second one is on cell=02, the NR cell, with seq=1. This is the UE first attaching on LTE and then adding the NR cell.

After that, every trace period has two rows. UE_ID 1 is on cell 001 with RNTI 003d and ri 1. UE_ID 2 is on cell 002 with RNTI 4601 and ri 2.

UE trace with PRACH on both cells and rows for LTE cell 001 and NR cell 002

Check out ue configuration. You would notice that one core network id is assigned and two different cell ID (RAN ID) and RAN_UE_ID are assigned for the same UE in case of NSA cell. One of the cell ID is for LTE cell and the other is for NR cell.

RAN_UE_ID 1 is the connection to the LTE cell 0x001 with RNTI 0x003d. It carries CN_UE_ID 100. RAN_UE_ID 2 is the connection to the NR cell 0x002 with RNTI 0x4601. Its CN_UE_ID is shown as "-". Only the LTE connection has a core network id.

ue command with LTE and NR connections of the same UE

Tips

Both tests above use fixed sdr card numbers. This section shows how to move the combined cell to other cards in the callbox. Only the args line in rf_driver needs to change.

Using other combinations of sdr card

If you want to combine other two sdr cards (i.e, other than sdr 0 and sdr 1), you can do it by simply changing sdr card number as shown below.

args: "dev0=/dev/sdr1,dev1=/dev/sdr2"    // this allow you to use sdr 1(2nd sdr card) and sdr 2(third sdr card) for one band

args: "dev0=/dev/sdr2,dev1=/dev/sdr3"    // this allow you to use sdr 2(3rd sdr card) and sdr 3(fourth sdr card) for one band