connectUE

Connect one or more UEs to gNB

Since R2023a

collapse all in page

    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.

    Note

    When you connect more than 16 UE nodes to a gNB node using the connectUE object function, you must adjust the SRS transmission periodicity of the nrGNB object manually. For more information about this, see the SRSPeriodicityUE property.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    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.

    This example uses:

    Open Live Script

    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

    collapse all

    gNB node, specified as an nrGNB object.

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

    Name-Value Arguments

    collapse all

    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.

    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

    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. The UE nodes report the rank indicator (RI), the precoding matrix indicator (PMI), and the channel quality indicator (CQI) based on measurements taken from the CSI-RS. For more information about the CSI-RS transmission periodicity, see the Algorithms 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

    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

    RLC bearer configuration, specified as an nrRLCBearerConfig object or a vector of nrRLCBearerConfig objects. If you do not enable the full buffer traffic and fail to specify this name-value argument, the objects uses the default configuration of an nrRLCBearerConfig object.

    Dependencies

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

    Since R2024b

    Custom UE context, specified as a structure. Use this name-value argument to specify any custom information regarding a UE node, which you can then use for your custom scheduling logic. The CustomContext property of UEContext, a property of the nrScheduler class, reflects the specified value for the corresponding UE node.. The connectUE call, invokable for each UE node, utilizes the CustomContext name-value argument to provide each UE with a unique context structure, enabling variation in fields or identical fields with distinct values.

    Data Types: struct

    Algorithms

    collapse all

    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

    expand all

    See Also

    Objects

    Topics