nrPDCCHSpace

Generate PDCCH resources for all candidates and aggregation levels

Syntax

allInd = nrPDCCHSpace(carrier,pdcch)

[allInd,allDMRSSym,allDMRSInd] = nrPDCCHSpace(carrier,pdcch)

[allInd,allDMRSSym,allDMRSInd] = nrPDCCHSpace(carrier,pdcch,Name,Value)

Description

allInd = nrPDCCHSpace(carrier,pdcch) returns physical downlink control channel (PDCCH) resource element indices allInd for all candidates at each aggregation level, as defined in TS 38.211 Section 7.3.2 [1]. The input carrier specifies carrier configuration parameters for a specific OFDM numerology. The input pdcch specifies PDCCH configuration parameters.

example

[allInd,allDMRSSym,allDMRSInd] = nrPDCCHSpace(carrier,pdcch) also returns PDCCH demodulation reference signal (DM-RS) symbols allDMRSSym and PDCCH DM-RS resource element indices allDMRSInd for all candidates at each aggregation level, as defined in TS 38.211 Section 7.4.1.3.

example

[allInd,allDMRSSym,allDMRSInd] = nrPDCCHSpace(carrier,pdcch,Name,Value) specifies output formatting options using one or more name-value pair arguments.

Examples

collapse all

Generate PDCCH Indices for All Candidates and Aggregation Levels

Open Live Script

Configure the carrier and the PDCCH with default configuration parameters.

carrier = nrCarrierConfig;
pdcch = nrPDCCHConfig;

Generate all PDCCH resource element indices for all candidates and aggregation levels.

allInd = nrPDCCHSpace(carrier,pdcch)

allInd=5×1 cell array
    { 54x8 uint32}
    {108x8 uint32}
    {216x4 uint32}
    {432x2 uint32}
    {864x1 uint32}

Verify that the number of generated candidates for the PDCCH indices at each aggregation level matches the number of candidates specified by the default search space set.

numCandidates = [...
    size(allInd{1},2) ... 
    size(allInd{2},2) ... 
    size(allInd{3},2) ... 
    size(allInd{4},2) ... 
    size(allInd{5},2)];
isequaln(pdcch.SearchSpace.NumCandidates,numCandidates)

ans = logical
   1

Generate PDCCH DM-RS Symbols for All Candidates and Aggregation Levels

Open Live Script

Configure the carrier with default configuration parameters.

carrier = nrCarrierConfig;

Configure the CORESET with 6 frequency resources, a duration of 3 OFDM symbols, and a REG bundle size of 3.

crst = nrCORESETConfig;
crst.FrequencyResources = ones(1,6);
crst.Duration = 3;
crst.REGBundleSize = 3;

Configure the search space set for the PDCCH with the specified number of candidates at each aggregation level.

cfgSS = nrSearchSpaceConfig;
cfgSS.NumCandidates = [5 5 3 2 1];

Configure the PDCCH with the specified bandwidth part, CORESET, and search space set.

pdcch = nrPDCCHConfig;
pdcch.NStartBWP = 6;
pdcch.NSizeBWP = 36;
pdcch.CORESET = crst;
pdcch.SearchSpace = cfgSS;

Generate PDCCH DM-RS symbols for all candidates and aggregation levels.

[~,allDMRS] = nrPDCCHSpace(carrier,pdcch)

allDMRS=5×1 cell array
    { 18x5 double}
    { 36x5 double}
    { 72x3 double}
    {144x2 double}
    {288x1 double}

Verify that the number of generated candidates for the PDCCH DM-RS symbols at each aggregation level matches the number of candidates specified by the search space set.

numCandidates = [...
    size(allDMRS{1},2) ... 
    size(allDMRS{2},2) ... 
    size(allDMRS{3},2) ... 
    size(allDMRS{4},2) ... 
    size(allDMRS{5},2)];
isequaln(cfgSS.NumCandidates,numCandidates)

ans = logical
   1

Generate PDCCH DM-RS Indices for All Candidates and Aggregation Levels

Open Live Script

Configure a carrier grid of 60 resource blocks (RBs), where the starting RB index relative to the common resource block 0 (CRB 0) is 3.

carrier = nrCarrierConfig;
carrier.NStartGrid = 3;
carrier.NSizeGrid = 60;

Configure noninterleaved CORESET with 6 frequency resources and a duration of 3 OFDM symbols.

crst = nrCORESETConfig;
crst.FrequencyResources = ones(1,6);
crst.Duration = 3;
crst.CCEREGMapping = 'noninterleaved';

Configure the search space set for the PDCCH with the specified number of candidates at each aggregation level.

cfgSS = nrSearchSpaceConfig;
cfgSS.NumCandidates = [5 5 3 2 1];

Configure the PDCCH with the specified bandwidth part, CORESET, and search space set.

pdcch = nrPDCCHConfig;
pdcch.NStartBWP = 5;
pdcch.NSizeBWP = 48;
pdcch.CORESET = crst;
pdcch.SearchSpace = cfgSS;

Generate PDCCH DM-RS resource element indices for all candidates and aggregation levels using 1-based, subscript indexing form relative to the BWP grid.

[~,~,allDMRSInd] = nrPDCCHSpace(carrier,pdcch, ...
    'IndexOrientation','bwp','IndexStyle','subscript')

allDMRSInd=5×1 cell array
    { 18x3x5 uint32}
    { 36x3x5 uint32}
    { 72x3x3 uint32}
    {144x3x2 uint32}
    {288x3   uint32}

Verify that the number of generated candidates for PDCCH DM-RS indices at each aggregation level matches the number of candidates specified by the search space set.

numCandidates = [...
    size(allDMRSInd{1},3) ... 
    size(allDMRSInd{2},3) ... 
    size(allDMRSInd{3},3) ... 
    size(allDMRSInd{4},3) ... 
    size(allDMRSInd{5},3)];
isequaln(cfgSS.NumCandidates,numCandidates)

ans = logical
   1

Input Arguments

collapse all

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

Carrier configuration parameters for a specific OFDM numerology, specified as an nrCarrierConfig object.

`pdcch` — PDCCH configuration parameters
`nrPDCCHConfig` object

PDCCH configuration parameters, specified as an nrPDCCHConfig object.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'IndexStyle','subscript','IndexBase','0based' specifies the indexing form and indexing base of the output.

`'IndexStyle'` — Resource element indexing form
`'index'` (default) | `'subscript'`

Resource element indexing form, specified as the comma-separated pair consisting of 'IndexStyle' and one of these values:

'index' — The indices are in linear index form.
'subscript' — The indices are in [subcarrier, symbol, antenna] subscript row form.

Data Types: char | string

`'IndexBase'` — Resource element indexing base
`'1based'` (default) | `'0based'`

Resource element indexing base, specified as the comma-separated pair consisting of 'IndexBase' and one of these values:

'1based' — The index counting starts from one.
'0based' — The index counting starts from zero.

Data Types: char | string

`'IndexOrientation'` — Indexing orientation of PDCCH and DM-RS resource elements
`'carrier'` (default) | `'bwp'`

Indexing orientation of PDCCH and DM-RS resource elements, specified as the comma-separated pair consisting of 'IndexOrientation' and one of these values:

'carrier' — Indices are referenced with respect to the carrier grid.
'bwp' — Indices are referenced with respect to the bandwidth part.

Data Types: char | string

`'OutputDataType'` — Data type of PDCCH DM-RS symbols
`'double'` (default) | `'single'`

Data type of PDCCH DM-RS symbols, specified as the comma-separated pair consisting of 'OutputDataType' and one of these values:

'double' — Output symbols are of double data type.
'single' — Output symbols are of single data type.

Data Types: char | string

Output Arguments

collapse all

`allInd` — PDCCH resource element indices for all candidates at each aggregation level
5-by-1 cell array

PDCCH resource element indices for all candidates at each aggregation level, returned as a 5-by-1 cell array. The five cells correspond to aggregation levels 1, 2, 4, 8, and 16, respectively. Each cell contains a matrix corresponding to all candidates at the appropriate aggregation level. The dimensionality of all matrices is either two or three, depending on the 'IndexStyle' name-value pair argument. The last dimension of each matrix corresponds to the number of candidates specified by the pdcch.SearchSpace.NumCandidates property for the appropriate aggregation level.

Data Types: uint32

`allDMRSSym` — PDCCH DM-RS symbols for all candidates at each aggregation level
5-by-1 cell array

PDCCH DM-RS symbols for all candidates at each aggregation level, returned as a 5-by-1 cell array. The five cells correspond to aggregation levels 1, 2, 4, 8, and 16, respectively. Each cell contains a 2-D matrix corresponding to all candidates at the appropriate aggregation level. The number of matrix columns in each cell corresponds to the number of candidates specified by the pdcch.SearchSpace.NumCandidates property for the appropriate aggregation level.

Data Types: single | double

`allDMRSInd` — PDCCH DM-RS resource element indices for all candidates at each aggregation level
5-by-1 cell array

PDCCH DM-RS resource element indices for all candidates at each aggregation level, returned as a 5-by-1 cell array. The five cells correspond to aggregation levels 1, 2, 4, 8, and 16, respectively. Each cell contains a matrix corresponding to all candidates at the appropriate aggregation level. The dimensionality of all matrices is either two or three, depending on the 'IndexStyle' name-value pair argument. The last dimension of each matrix corresponds to the number of candidates specified by the pdcch.SearchSpace.NumCandidates property for the appropriate aggregation level.

Data Types: uint32

Compatibility Considerations

expand all

DM-RS reference point update for CORESET ID 0

Behavior changed in R2020b

Starting in R2020b, the reference point for the DM-RS sequence-to-subcarrier resource mapping for CORESET ID 0 is the lowest physical resource block of the CORESET instead of CRB 0. This update affects the resources that you generate with this function for CORESET ID 0. For all other CORESET ID values, the reference point remains CRB0.

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

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

Usage notes and limitations:

Names and values in name-value pair arguments must be compile-time constants. For example, to specify linear indexing form, include {coder.Constant('IndexStyle'),coder.Constant('index')} in the -args value of the codegen function. For more information, see the coder.Constant (MATLAB Coder) class.

Documentation

nrPDCCHSpace

Syntax

Description

Examples

Generate PDCCH Indices for All Candidates and Aggregation Levels

Generate PDCCH DM-RS Symbols for All Candidates and Aggregation Levels

Generate PDCCH DM-RS Indices for All Candidates and Aggregation Levels

Input Arguments

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

`pdcch` — PDCCH configuration parameters
`nrPDCCHConfig` object

Name-Value Pair Arguments

`'IndexStyle'` — Resource element indexing form
`'index'` (default) | `'subscript'`

`'IndexBase'` — Resource element indexing base
`'1based'` (default) | `'0based'`

`'IndexOrientation'` — Indexing orientation of PDCCH and DM-RS resource elements
`'carrier'` (default) | `'bwp'`

`'OutputDataType'` — Data type of PDCCH DM-RS symbols
`'double'` (default) | `'single'`

Output Arguments

`allInd` — PDCCH resource element indices for all candidates at each aggregation level
5-by-1 cell array

`allDMRSSym` — PDCCH DM-RS symbols for all candidates at each aggregation level
5-by-1 cell array

`allDMRSInd` — PDCCH DM-RS resource element indices for all candidates at each aggregation level
5-by-1 cell array

Compatibility Considerations

DM-RS reference point update for CORESET ID 0

References

Extended Capabilities

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

See Also

Functions

Objects

Topics

5G Toolbox Documentation

Support

Documentation

nrPDCCHSpace

Syntax

Description

Examples

Generate PDCCH Indices for All Candidates and Aggregation Levels

Generate PDCCH DM-RS Symbols for All Candidates and Aggregation Levels

Generate PDCCH DM-RS Indices for All Candidates and Aggregation Levels

Input Arguments

carrier — Carrier configuration parameters nrCarrierConfig object

pdcch — PDCCH configuration parameters nrPDCCHConfig object

Name-Value Pair Arguments

'IndexStyle' — Resource element indexing form 'index' (default) | 'subscript'

'IndexBase' — Resource element indexing base '1based' (default) | '0based'

'IndexOrientation' — Indexing orientation of PDCCH and DM-RS resource elements 'carrier' (default) | 'bwp'

'OutputDataType' — Data type of PDCCH DM-RS symbols 'double' (default) | 'single'

Output Arguments

allInd — PDCCH resource element indices for all candidates at each aggregation level 5-by-1 cell array

allDMRSSym — PDCCH DM-RS symbols for all candidates at each aggregation level 5-by-1 cell array

allDMRSInd — PDCCH DM-RS resource element indices for all candidates at each aggregation level 5-by-1 cell array

Compatibility Considerations

DM-RS reference point update for CORESET ID 0

References

Extended Capabilities

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

See Also

Functions

Objects

Topics

5G Toolbox Documentation

Support

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

`pdcch` — PDCCH configuration parameters
`nrPDCCHConfig` object

`'IndexStyle'` — Resource element indexing form
`'index'` (default) | `'subscript'`

`'IndexBase'` — Resource element indexing base
`'1based'` (default) | `'0based'`

`'IndexOrientation'` — Indexing orientation of PDCCH and DM-RS resource elements
`'carrier'` (default) | `'bwp'`

`'OutputDataType'` — Data type of PDCCH DM-RS symbols
`'double'` (default) | `'single'`

`allInd` — PDCCH resource element indices for all candidates at each aggregation level
5-by-1 cell array

`allDMRSSym` — PDCCH DM-RS symbols for all candidates at each aggregation level
5-by-1 cell array

`allDMRSInd` — PDCCH DM-RS resource element indices for all candidates at each aggregation level
5-by-1 cell array

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