connectUE
Download Required: To use connectUE
,
first download the Communications Toolbox Wireless Network Simulation Library add-on.
Description
connectUE(
connects one or more new radio (NR) user equipment (UE) nodes, gnb
,ue
,Name=Value
)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.
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
5 (default) | 1
| 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. 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
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 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"
.
CustomContext
— Custom UE context
structure
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
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 R2023aR2024b: Includes support for custom UE context
You can now specify the custom UE context as a structure using the
customUE
name-value argument of the connectUE object
function.
See Also
Objects
Comando MATLAB
Hai fatto clic su un collegamento che corrisponde a questo comando MATLAB:
Esegui il comando inserendolo nella finestra di comando MATLAB. I browser web non supportano i comandi MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)