configureULPowerControl

R2026b

Configure uplink power control parameters

Since R2023b

Syntax

configureULPowerControl(gnb,Name=Value)

Description

configureULPowerControl(gnb,Name=Value) configures uplink (UL) power control parameters at a 5G base station (gNB) node, gnb. This object function sets the power control configuration parameters using one or more optional name-value arguments. For example, PoPUSCH=8 sets the nominal transmit power of a user equipment (UE) node per resource block to 8 dBm. To calculate the UL transmit power, the UE nodes connected to a gNB node use the same power control parameter values specified by the name-value arguments. This feature also requires the Wireless Network Toolbox™ product.

Note

To disable the uplink power control mechanism, set the value of PoPUSCH to a value greater than the value of TransmitPower.

Examples

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);

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;

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 | vector of nrgNB objects

gNB node, specified as an nrGNB object or vector of nrGNB 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: configureULPowerControl(gnb,PoPUSCH=8) sets the nominal transmit power of a UE node per resource block to 8 dBm.

ComponentCarrierConfig — Component carrier(s) to configure with uplink power control parameters

nrComponentCarrierConfig object | vector of nrComponentCarrierConfig objects.

Since R2026b

Component carrier(s) to configure with uplink power control parameters, specified as an nrComponentCarrierConfig object or a vector of nrComponentCarrierConfig objects. Use this argument to specify which carrier(s) on the gNB node use the specified uplink power control parameters (PoPUSCH and Alpha).

Note

If you do not specify this argument, the ConfigureULPowerControl function configures all carriers on the gNB node with the specified uplink power control parameters.

PoPUSCH — Nominal transmit power of UE per resource block

-60 (default) | numeric scalar in range [-202, 24]

Nominal transmit power of a UE per resource block, specified as a numeric scalar in the range [-202, 24]. Units are in dBm. Increasing the PoPUSCH value causes the uplink transmit power to approach the maximum attainable value.

Data Types: double

Alpha — Fractional power control multiplier of UE at gNB

1 (default) | 0 | 0.4 | 0.5 | ...

Fractional power control multiplier, specified as one of these options. Units are in dBm.

• 0

• 0.4

• 0.5

• 0.6

• 0.7

• 0.8

• 0.9

• 1

Increasing the Alpha value causes the uplink transmit power to approach the maximum attainable value.

Data Types: double

More About

UL Power Control Equation

Section 7.1 of TS 38.213 specifies the UL power control equation that governs uplink power levels [1] and states the equation as

$$P_{PUSCH}=\min \{\begin{array}{c}{P}_{c\max }\\ P_{OPUSCH}+10{\log }_{10}(2^{\mu }{M}_{RB})+\alpha P_L+{\Delta }_{SINR}\end{array}$$

In this equation,

• $$P_{c\max }$$— Configured UE transmit power

• $$P_{OPUSCH}$$— Nominal UE transmit power

• $$\mu$$— Numerology

• $$M_{RB}$$— Allocated resource blocks

• $$\alpha$$— Fractional power control multiplier

• $$P_L$$— Path loss measurements

• $${\Delta }_{SINR}$$— Difference between the target signal-to-interference-plus-noise ratio (SINR) and the actual SINR measured at the base station

Note

This equation applies to each component carrier.

References

[1] 3GPP TS 38.213. “NR; Physical layer procedures for control.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Version History

Introduced in R2023b

R2026b: Configure uplink power control parameters for specific carriers

You can configure uplink power control parameters for specific carriers using the ComponentCarrierConfig name-value argument of the configureULPowerControl object function.

R2026a: Moved to 5G Toolbox and requires Wireless Network Toolbox

Starting in R2026a, this feature is available in 5G Toolbox™ and also requires a Wireless Network Toolbox license. In prior releases, the feature is available through the Communications Toolbox™ Wireless Network Simulation Library add-on.