nrWavegenPDCCHConfig

PDCCH configuration parameters for 5G waveform generation

Since R2020b

expand all in page

Description

The nrWavegenPDCCHConfig object sets physical downlink control channel (PDCCH) configuration parameters, as defined in TS 38.211 Section 7.3.2 [1] and TS 38.213 Section 10 [2]. Use this object to set the PDCCH property of the nrDLCarrierConfig object when configuring 5G downlink waveform generation.

Creation

Syntax

pdcch = nrWavegenPDCCHConfig
pdcch = nrWavegenPDCCHConfig(PropertyName=Value)

Description

pdcch = nrWavegenPDCCHConfig creates a default PDCCH configuration object for 5G waveform generation.

pdcch = nrWavegenPDCCHConfig(PropertyName=Value) sets writable properties using one or more name-value arguments. For example, AggregationLevel=2 configures the PDCCH with the specified aggregation level.

example

Properties

expand all

Enable the PDCCH in 5G waveform generation, specified as one of these values.

  • 1 — Enable the PDCCH.

  • 0 — Disable the PDCCH.

Data Types: double | logical

Name of the PDCCH configuration, specified as a character array or string scalar. Use this property to set a description to the PDCCH configuration.

Data Types: char | string

Power scaling of the PDCCH in dB, specified as a real-valued scalar or real-valued vector of length equal to the number of allocated transmissions in a period configured by the SlotAllocation property. Use this property to scale the power of the PDCCH in the generated 5G waveform.

Data Types: double

ID of the bandwidth part (BWP) containing the configured PDCCH, specified as a nonnegative integer. Use this property to associate this PDCCH configuration with one of the BWP configurations specified by the BandwidthParts property of the nrDLCarrierConfig object.

Data Types: double

ID of the search space set containing the configured PDCCH, specified as a nonnegative integer. Use this property to associate this PDCCH configuration with one of the search space set configurations specified by the SearchSpaces property of the nrDLCarrierConfig object.

Data Types: double

PDCCH aggregation level, specified as 1, 2, 4, 8, or 16.

Data Types: double

Candidate used for the PDCCH instance, specified as an integer from 1 to 8. The value of this property is an index from the set of candidates specified for the aggregation level by the NumCandidates property of the search space specified by the SearchSpaceID property.

This property does not apply when the CCEOffset property is set to a nonempty value.

Data Types: double

Control channel element (CCE) offset used for the PDCCH instance, specified as one of these options.

  • [] — The AllocatedCandidate property determines the first CCE used for the PDCCH instance.

  • Positive integer — This value explicitly specifies the index of the first CCE used for the PDCCH instance. The value must be a multiple of the AggregationLevel property value and less than or equal to the CCE capacity of the associated CORESET. This option overrides the allocation specified by the AllocatedCandidate property.

Data Types: double

Slot allocation in a PDCCH period, specified as a nonnegative integer or row vector of nonnegative integers. This property specifies the slot positions of the PDCCH by using 0-based indexing and values smaller than the value of the Period property. The object ignores slot allocation values larger than the period. This slot allocation must be within the slot allocation of the search space specified by the SearchSpaceID property.

Data Types: double

PDCCH allocation period in slots, specified as a nonnegative integer or []. An empty period indicates no repetition.

Data Types: double

Since R2025a

Mapping of the PDCCH port to physical antennas, specified as one of these values:

  • [] — The instance specified by this nrWavegenPDCCHConfig object is automatically mapped in the generated waveform starting from the first column.

  • Vector of N unique positive integers — The vector elements indicate where the instance specified by this nrWavegenPDCCHConfig object is mapped in the generated waveform.

    • If PrecodingMatrix is empty ([]), N is 1, which corresponds to the single PDCCH port.

    • If PrecodingMatrix is nonempty, N and the number of rows in the precoding matrix must be equal.

Data Types: double

Since R2025a

Precoding matrix, specified as one of these options:

  • [] — Precoding is not applied to the generated waveform.

  • M-by-1 numeric vector — Precoding is applied to the generated waveform using the specified vector.

    • If AntennaMapping is empty ([]), M is any positive integer.

    • If AntennaMapping is nonempty, M and the number of unique elements specified in the antenna mapping must be equal.

Note

Setting this property to a nonempty value can affect the power applied to the instance specified by this nrWavegenPDCCHConfig object in the generated waveform.

Data Types: double

Enable downlink control information (DCI) encoding, specified as one of these values.

  • 1 — Enable DCI encoding.

  • 0 — Disable DCI encoding.

Data Types: double | logical

Length of DCI in bits, specified as an integer from 0 to 140.

Dependencies

To enable this property, set the Coding property to 1.

Data Types: double

Source of DCI contents, specified as one of these options:

  • 'PN9-ITU', 'PN9', 'PN11', 'PN15', or 'PN23'

  • Two-element cell array consisting of one of the character vectors from the previous list and a random numeric seed (for example, {'PN9',7})

  • Binary vector

If you do not specify a random seed, all shift registers are initialized with an active state.

Data Types: double | cell | string | char

Radio network temporary identifier of the user equipment (UE), specified as an integer from 0 to 65,535. When you set this property to a value greater than 65,519, the object infers this property value to be 0.

Data Types: double

PDCCH demodulation reference signal (DM-RS) scrambling identity, specified as an integer from 0 to 65,535 if the higher layer parameter pdcch-DMRS-ScramblingID is configured or as [] if pdcch-DMRS-ScramblingID is not configured. When you specify this property as [], the object sets the PDCCH DM-RS scrambling identity to the physical layer cell identity specified by the NCellID property of the carrier.

Data Types: double

Power scaling of the PDCCH DM-RS in dB, specified as a real scalar. Use this property to scale the power of the PDCCH DM-RS in the generated 5G waveform. This scaling is additional to the PDCCH-wide power scaling specified by the Power property.

Data Types: double

Examples

collapse all

Open Live Script

Create a default CORESET configuration object. 

coreset = nrCORESETConfig;

Create a search space set configuration object, associating the search space set with the previously defined CORESET configuration.

searchSpace = nrSearchSpaceConfig('CORESETID',coreset.CORESETID);

Create a PDCCH configuration object for 5G waveform generation with the specified property values.

pdcch = nrWavegenPDCCHConfig( ...
    'SearchSpaceID',searchSpace.SearchSpaceID, ...
    'AggregationLevel',4, ...
    'AllocatedCandidate',2, ...
    'SlotAllocation',[0 2], ...
    'Period',3);

Create a downlink carrier configuration object, specifying the previously defined configurations. 

cfgDL = nrDLCarrierConfig( ...
    'CORESET',{coreset}, ...
    'SearchSpaces',{searchSpace}, ...
    'PDCCH',{pdcch});
Open Live Script

Create two CORESET configuration objects with unique IDs.

coreset1 = nrCORESETConfig('CORESETID',1);
coreset2 = nrCORESETConfig('CORESETID',2);

Create three search space set configuration objects with unique IDs. Associate each search space set with one of the previously defined CORESET configurations.

searchSpace1 = nrSearchSpaceConfig('SearchSpaceID',1,'CORESETID',coreset1.CORESETID);
searchSpace2 = nrSearchSpaceConfig('SearchSpaceID',2,'CORESETID',coreset1.CORESETID);
searchSpace3 = nrSearchSpaceConfig('SearchSpaceID',3,'CORESETID',coreset2.CORESETID);

Create four PDCCH configuration objects for 5G waveform generation. Specify a unique UE and one of the search space set configurations for each PDCCH.

pdcch1 = nrWavegenPDCCHConfig('RNTI',1,'SearchSpaceID',searchSpace1.SearchSpaceID);
pdcch2 = nrWavegenPDCCHConfig('RNTI',2,'SearchSpaceID',searchSpace2.SearchSpaceID);
pdcch3 = nrWavegenPDCCHConfig('RNTI',3,'SearchSpaceID',searchSpace2.SearchSpaceID);
pdcch4 = nrWavegenPDCCHConfig('RNTI',4,'SearchSpaceID',searchSpace3.SearchSpaceID);

Create a downlink carrier configuration object, specifying the previously defined configurations. 

cfgDL = nrDLCarrierConfig( ...
    'CORESET',{coreset1,coreset2}, ...
    'SearchSpaces',{searchSpace1,searchSpace2,searchSpace3}, ...
    'PDCCH',{pdcch1,pdcch2,pdcch3,pdcch4});

References

[1] 3GPP TS 38.211. “NR; Physical channels and modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

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

Extended Capabilities

expand all

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2020b

expand all

See Also

Functions

Objects