addSecondaryCarrierOnUE

R2026b

Configure and activate secondary carriers on UE nodes

Since R2026b

Syntax

addSecondaryCarrierOnUE(gnb,ue,componentCarrierConfig)

addSecondaryCarrierOnUE(gnb,ue,componentCarrierConfig,Name=Value)

Description

addSecondaryCarrierOnUE(gnb,ue,componentCarrierConfig) configures and activates secondary carriers for carrier aggregation on one or more user equipment (UE) nodes connected to a next-generation Node B (gNB). Activating secondary carriers enables a UE node to use multiple frequency bands simultaneously.

addSecondaryCarrierOnUE(gnb,ue,componentCarrierConfig,Name=Value) configures secondary carriers using one or more optional name-value arguments that specify connection parameters.

You can add secondary carriers to multiple UE nodes in a single addSecondaryCarrierOnUE function call, but these UE nodes must use the same connection parameter values specified in the name-value arguments.

Examples

Simulate 5G Network with Carrier Aggregation

Carrier aggregation enables the gNB and UE nodes to transmit and receive data simultaneously on multiple carriers, significantly increasing data throughput. In a 5G network, the base stations manage and allocate these carriers to the UE nodes. This example demonstrates how to configure and simulate carrier aggregation in a 5G network.

In this example, you create:

• One gNB node with two component carriers

• Two UE nodes. The first UE node connects to the primary carrier only (single carrier operation), while the second UE node connects to both the primary and secondary carriers (carrier aggregation).

To simulate the scenario, follow these steps.

Create the network simulator.

rng("default") % Reset the random number generator
networkSimulator = wirelessNetworkSimulator.init

networkSimulator = 
  wirelessNetworkSimulator with properties:

        CurrentTime: 0
            EndTime: 0
    ChannelFunction: "fspl"
              Nodes: {}

Create component carrier configurations using the nrComponentCarrierConfig object.

% Two NR carriers in the same band
ccConfigs = nrComponentCarrierConfig(NumContiguousCarriers=2)

ccConfigs = 
  1×2 nrComponentCarrierConfig array

The array contains two contiguous component carrier objects: the first corresponds to the primary carrier, and the second corresponds to the secondary carrier.

Display the component carrier objects.

ccConfigsPrimary = ccConfigs(1)

ccConfigsPrimary = 
  nrComponentCarrierConfig with properties:

   Read-only properties:
     CarrierFrequency: [2.6725e+09 2.5275e+09]
     ChannelBandwidth: 5000000
    NumResourceBlocks: 25
    SubcarrierSpacing: 15000
           DuplexMode: "FDD"
     SRSPeriodicityUE: 5

ccConfigsSecondary=ccConfigs(2)

ccConfigsSecondary = 
  nrComponentCarrierConfig with properties:

   Read-only properties:
     CarrierFrequency: [2.6775e+09 2.5325e+09]
     ChannelBandwidth: 5000000
    NumResourceBlocks: 25
    SubcarrierSpacing: 15000
           DuplexMode: "FDD"
     SRSPeriodicityUE: 5

Create a gNB node with multiple component carriers.

gNB = nrGNB(ComponentCarrierConfig=ccConfigs, ...
    NumTransmitAntennas=4, ...
    NumReceiveAntennas=4);

Configure a built-in scheduler for multiple carriers.

configureScheduler(gNB,Scheduler="BestCQI");

Create UE nodes with multi-carrier capability.

ue1 = nrUE(NumTransmitAntennas=2,NumReceiveAntennas=2);

ue2 = nrUE(NumComponentCarriers=2, ...  % UE can connect to two carriers
    NumTransmitAntennas=2, ...
    NumReceiveAntennas=2);

ues = [ue1,ue2];

Connect the UE nodes on the primary carrier and enable full-buffer traffic. Full-buffer traffic assumes an unlimited amount of queued data is available for transmission.

connectUE(gNB,ues,FullBufferTraffic="on"); 

Add the secondary carrier on the second UE node.

addSecondaryCarrierOnUE(gNB,ue2,ccConfigs(2));

Add the nodes to the simulator.

addNodes(networkSimulator,gNB)
addNodes(networkSimulator,ues)

Run the simulation.

simulationTime = 0.1; % Units are in seconds
run(networkSimulator,simulationTime);

Obtain the UE node statistics.

ue1Stats = ue1.statistics();
ue2Stats = ue2.statistics();

Obtain the physical layer statistics of the first UE node.

ue1StatsPHY = ue1Stats.PHY

ue1StatsPHY = struct with fields:
    TransmittedPackets: 97
       ReceivedPackets: 96
        DecodeFailures: 0

Obtain the physical layer statistics of the second UE node.

ue2StatsPHY = ue2Stats.PHY

ue2StatsPHY = struct with fields:
    TransmittedPackets: 194
       ReceivedPackets: 192
        DecodeFailures: 0

The results show that the second UE node, which supports carrier aggregation, achieved twice the packet transmission and reception capacity of the first UE node, which uses only the primary carrier.

Input Arguments

gnb — gNB node for adding secondary carriers to UE nodes

nrGNB object

gNB node, specified as an nrGNB object.

ue — UE nodes for secondary carrier assignment

nrUE object | vector of nrUE objects

UE nodes for secondary carrier assignment, specified as an nrUE object or a vector of nrUE objects.

componentCarrierConfig — Secondary carrier configuration

nrComponentCarrierConfig object | vector of nrComponentCarrierConfig objects.

Secondary carrier configuration, specified as a nrComponentCarrierConfig object or a vector of nrComponentCarrierConfig 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: addSecondaryCarrierOnUE(gNB,ue,ccConfigs(2),CSIReportConfig=nrCSIReportConfig(CQITable="table2")); adds a secondary carrier to the UE node with a CSI report configuration using CQI table 2.

CSIReportPeriodicity — CSI-RS reporting periodicity

positive integer

Channel state information reference signal (CSI-RS) reporting periodicity, in slots, specified as a positive integer. If you do not specify CSIReportPeriodicity, the function uses the value of CSI-RS transmission periodicity 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 the DL-UL pattern.

Data Types: double

CSIReportConfig — CSI report configuration

nrCSIReportConfig

CSI report configuration, specified as an nrCSIReportConfig object. Use this name-value argument to configure CSI report configuration for the UE. You can configure the same CSI report configuration for multiple UEs, but configuring multiple CSI report configurations for a single UE is not supported.

You can configure only these properties of the nrCSIReportConfig object for the UE node.

Property	Supported Property Value
CQITable	"table2"
CodebookType	"type1SinglePanel" "type2" "etype2"
CQIFormatIndicator	"wideband" and "subband" Note Built-in schedulers, such as "RoundRobin", "BestCQI", and "ProportionalFair", do not use subband-level channel quality indicator (CQI) measurements. Instead, they use wideband CQI measurements. However, custom schedulers can use subband-level CQI measurements for scheduling.
PMIFormatIndicator	"wideband" and "subband"
SubbandSize	4 8 16 32 Note The allowed values for SubbandSize depend on the NumResourceBlocks of nrGNB, according to TS 38.214. When the bandwidth part (BWP) size is greater than or equal to 24 PRBs, you can configure subband-based reporting for CQI and PMI. The system does not support sub-band measurements with multi-user (MU) multiple-input multiple-output (MIMO).
CodebookMode	1 2
CodebookSubsetRestriction	[] Binary vector
I2Restriction	[] Binary vector
RIRestriction	[1 1 1 1 0 0 0 0] for "type1SinglePanel" Supports only up to rank 4. Only single codeword is supported.
NumberOfBeams	2 3 4
PhaseAlphabetSize	4 8
ParameterCombination	Integer from 1 to 8

Version History

Introduced in R2026b