connectUE

Connect one or more UEs to gNB

Since R2023a

Download Required: To use connectUE, first download the Communications Toolbox Wireless Network Simulation Library add-on.

Syntax

connectUE(gnb,ue,Name=Value)

Description

connectUE(gnb,ue,Name=Value) connects one or more new radio (NR) user equipment (UE) nodes, ue, to a NR base station node (gNB), gnb. The function sets the connection configuration parameters using one or more optional name-value arguments. For example, BSRPeriodicity=5 sets the uplink (UL) buffer status reporting periodicity to 5 subframes. You can connect multiple UE nodes to a gNB node in a single connectUE function call, but these UE nodes must all use same connection parameter values specified in the name-value arguments.

Examples

Connect UEs to gNB

Create a default gNB node.

gnb = nrGNB;

Create two UE nodes positioned at [100 100 0] and [5000 100 0], with each one having a transmit power of 20 dBm.

ueArray1 = nrUE(Position=[100 100 0; 5000 100 0],TransmitPower=20); % In Cartesian x, y, and z 

Create two UE nodes positioned at [700 100 430] and [500 1000 657], with each one having a transmit power of 29 dBm.

ueArray2 = nrUE(Position=[700 100 430; 500 1000 657],TransmitPower=29);

Connect two UE nodes positioned at [100 100 0] and [5000 100 0] to the gNB node with the uplink (UL) buffer status reporting periodicity set to 5.

connectUE(gnb,ueArray1,BSRPeriodicity=5)

Connect two UE nodes positioned at [700 100 430] and [500 1000 657] to the gNB node with the UL buffer status reporting periodicity set to 16.

connectUE(gnb,ueArray2,BSRPeriodicity=16)

.Copyright 2022 The MathWorks, Inc.

Create, Configure, and Simulate 5G Network

Initialize wireless network simulator.

networkSimulator = wirelessNetworkSimulator.init;

Create a gNB node with these specifications.

• Duplex mode — Time division duplex

• Channel bandwidth — 20 MHz

• Subcarrier spacing — 30 KHz

gnb = nrGNB(ChannelBandwidth=20e6,DuplexMode="TDD",SubcarrierSpacing=30e3);

Create a UE node with a transmit power of 20 dBm.

ue = nrUE(TransmitPower=20);

Configure these uplink power control parameters at the gNB node.

• Nominal transmit power of UE per resource block — 7 dBm

• Fractional power control multiplier— 2

configureULPowerControl(gnb,PoPUSCH=7,Alpha=0.4)

Add a random way point mobility model to the UE node.

addMobility(ue,BoundaryShape="rectangle")

Establish a connection between the UE and gNB nodes.

connectUE(gnb,ue)

Create a voice over Internet protocol (VoIP) application traffic pattern object.

traffic = networkTrafficVoIP(GeneratePacket=true);

Add the data traffic source to the gNB node. Set the destination node as the UE node.

addTrafficSource(gnb,traffic,DestinationNode=ue)

Add the gNB node to the wireless network simulator.

addNodes(networkSimulator,gnb)

Add the UE node to the wireless network simulator.

addNodes(networkSimulator,ue)

Specify the simulation time, in seconds.

simulationTime = 0.3;

Run the simulation for the specified simulation time.

run(networkSimulator,simulationTime)

Obtain the statistics for the gNB and UE nodes.

gnbStats = statistics(gnb);
ueStats = statistics(ue);

Input Arguments

gnb — gNB node

nrGNB object

gNB node, specified as an nrGNB object.

ue — UE node

nrUE object

UE node, specified as an nrUE object or an array of nrUE objects.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: connectUE(gnb,ue,BSRPeriodicity=5) sets the uplink (UL) buffer status reporting periodicity to 5 subframes.

BSRPeriodicity — UL buffer status reporting periodicity

1 (default) | 5 | 10 | 20

Uplink (UL) buffer status reporting periodicity, specified as one of these options, in number of subframes. One subframe equals one millisecond.

• 1

• 5

• 10

• 20

• 32

• 40

• 80

• 128

• 160

• 320

• 640

• 1280

• 2560

• Inf

Data Types: double

CSIReportPeriodicity — CSI-RS reporting periodicity

positive integer

Channel state information reference signal (CSI-RS) reporting periodicity, specified as a positive integer. Units are in slots. If you do not specify CSIReportPeriodicity, the function uses the value of CSI-RS transmission periodicity, as determined by the gNB object. For more information about the CSI-RS transmission periodicity, see the More About section.

• For FDD, the CSI-RS reporting periodicity must be greater than or equal to the CSI-RS transmission periodicity.

• For TDD, the CSI-RS reporting periodicity must also be a multiple of the length of DL-UL pattern.

Data Types: double

FullBufferTraffic — Configuration of full buffer traffic for UE

"off" (default) | "on" | "UL" | "DL"

Configuration of full buffer traffic for a UE, specified as one of these options.

• "off" — Disable the full buffer traffic in both the UL and DL directions.

• "on" — Enable the full buffer traffic in both the UL and DL directions.

• "UL" — Enable the full buffer traffic in the UL direction.

• "DL" — Enable the full buffer traffic in the DL direction.

You can use this name-value argument as an alternative to the addTrafficSource object function for setting up traffic during connection configuration.

Data Types: char | string

RLCBearerConfig — RLC bearer configuration

nrRLCBearerConfig object

RLC bearer configuration, specified as an nrRLCBearerConfig object or an array of nrRLCBearerConfig objects.

Dependencies

To enable this name-value argument, set the FullBufferTraffic argument to "off".

More About

CSI-RS and sounding reference signal (SRS) configuration

The gNB node automatically sets the connection parameters related to CSI-RS and sounding reference signal (SRS). The gNB node transmits a full bandwidth CSI-RS for downlink (DL) channel measurements. All the UE nodes connected to the gNB node use this full bandwidth CSI-RS. The minimum value of CSI-RS transmission periodicity is 10 slots. For the frequency division duplex (FDD) mode, the CSI-RS transmission periodicity is 10 slots. The CSI-RS transmission periodicity for the time division duplex (TDD) mode is a multiple of the length of the DL-uplink (UL) pattern, in slots. For UL channel measurements, the gNB node reserves one symbol for the sounding reference signal (SRS) for every L slots across the entire bandwidth. The minimum value of L is 5. For FDD, the value of L is 5. For TDD, L is a multiple of the length of the DL-UL pattern, in slots. The gNB node configures the UE nodes to share the reserved SRS by varying the comb offset, cyclic shift, or transmission time. The gNB uses both a comb size and maximum cyclic shift of 4. As a result, the gNB node can configure up to 16 connected UE nodes to transmit SRS with periodicity as L slots. If more than 16 UE nodes connect, the scheduler increases the SRS transmission periodicity for each UE to the next multiple of L to accommodate more UE nodes.

References

[1] 3GPP TS 38.104. “NR; Base Station (BS) radio transmission and reception.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[2] 3GPP TS 38.101-1. “NR; User Equipment (UE) radio transmission and reception; Part 1: Range 1 Standalone.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Version History

Introduced in R2023a