nrWavegenCSIRSConfig

CSI-RS configuration parameters for 5G waveform generation

Since R2020b

Description

The nrWavegenCSIRSConfig object sets channel state information reference signal (CSI-RS) configuration parameters for one or more zero-power (ZP) or non-zero-power (NZP) CSI-RS resources, as defined in TS 38.211 Section 7.4.1.5 [1]. Use this object to set the CSIRS property of the nrDLCarrierConfig object when configuring 5G downlink waveform generation.

By default, the object defines an NZP-CSI-RS resource configured for two antenna ports with a CDM type of FD-CDM2 and density 1, corresponding to CSI-RS resource defined in row 3 of TS 38.211 Table 7.4.1.5.3-1.

Creation

Syntax

csirs = nrWavegenCSIRSConfig

csirs = nrWavegenCSIRSConfig(Name,Value)

Description

csirs = nrWavegenCSIRSConfig creates a default CSI-RS configuration object for 5G waveform generation.

csirs = nrWavegenCSIRSConfig(Name,Value) sets properties using one or more name-value arguments. Enclose each property name in quotes. For example, 'CSIRSType',{'zp','nzp','zp'} specifies three CSI-RS resources.

Properties

Enable — Enable CSI-RS

1 (default) | 0

Enable the CSI-RS in 5G waveform generation, specified as one of these values.

• 1 — Enable the CSI-RS.

• 0 — Disable the CSI-RS.

Data Types: double | logical

Label — Name of CSI-RS configuration

'CSIRS1' (default) | character array | string scalar

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

Data Types: char | string

Power — Power scaling of CSI-RS in dB

0 (default) | real scalar

Power scaling of CSI-RS in dB, specified as a real scalar. Use this property to scale the power of the CSI-RS in the generated 5G waveform.

Data Types: double

BandwidthPartID — ID of BWP

1 (default) | nonnegative integer

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

Data Types: double

CSIRSType — Type of one or more CSI-RS resource configurations

'nzp' (default) | 'zp' | cell array | string scalar | string array

Type of one or more CSI-RS resource configurations, specified as one of these options.

• 'nzp' — Use this option to specify a single NZP-CSI-RS resource.

• 'zp' — Use this option to specify a single ZP-CSI-RS resource.

• Cell array with elements 'nzp' or 'zp' — Use this option to specify multiple CSI-RS resources.

Alternatively, you can specify this property by using "nzp" and "zp" as string scalars or as elements of a string array.

The number of CSI-RS resource configurations is equal to the number of values provided for this property.

Data Types: cell | string | char

CSIRSPeriod — Slot periodicity and offset of CSI-RS resource

'on' (default) | 'off' | vector of integers | cell array | string scalar | string array

Slot periodicity and offset of the CSI-RS resource, specified as one of these options.

For Single CSI-RS Resource

• 'on' — Use this option to indicate that the resource is present in all slots.

• 'off' — Use this option to indicate that the resource is absent in all slots.

• Vector of integers of the form [Tcsi-rs Toffset] — Use this option to specify slot periodicity Tcsi-rs and offset Toffset for scheduling the CSI-RS resource in specific slots.

  Tcsi-rs is 4, 5, 8, 10, 16, 20, 32, 40, 64, 80, 160, 320, or 640. For a particular value of Tcsi-rs, the value of Toffset is in the range from 0 to Tcsi-rs–1.

For Multiple CSI-RS Resources

• Cell array with elements 'on', 'off', or [Tcsi-rs Toffset] — The number of elements in the cell array must be one or equal the number of CSI-RS resources specified by the CSIRSType property. When the cell array contains only one element, the specified value applies to all CSI-RS resources.

Alternatively, you can specify this property by using "on" and "off" as string scalars or as elements of a string array.

This property is the higher-layer parameter CSI-ResourcePeriodicityAndOffset or slotConfig defined in the CSI-RS-CellMobility IE.

Data Types: cell | string | char | double

RowNumber — Row number of CSI-RS resource

3 (default) | integer from 1 to 18 | vector of integers

Row number of CSI-RS resource, as defined in TS 38.211 Table 7.4.1.5.3-1, specified as one of these options.

For Single CSI-RS Resource

• Integer from 1 to 18

For Multiple CSI-RS Resources

• Vector of integers in the range from 1 to 18 — The number of vector elements must equal the number of CSI-RS resources specified by the CSIRSType property.

Data Types: double

Density — Frequency density of CSI-RS resource

'one' (default) | 'three' | 'dot5even' | 'dot5odd' | cell array | string scalar | string array

Frequency density of the CSI-RS resource, as defined in TS 38.211 Table 7.4.1.5.3-1, specified as one of these options.

For Single CSI-RS Resource

• 'one' — This option corresponds to ρ = 1 from the specified table.

• 'three' — This option corresponds to ρ = 3 from the specified table.

• 'dot5even' — This option corresponds to ρ = 0.5 from the specified table with even resource block (RB) allocation regarding the common resource block 0 (CRB 0).

• 'dot5odd' — This option corresponds to ρ = 0.5 from the specified table with odd RB allocation regarding CRB 0.

For Multiple CSI-RS Resources

• Cell array of the character vectors 'one', 'three', 'dot5even', or 'dot5odd' — The number of elements in the cell array must equal the number of CSI-RS resources specified by the CSIRSType property.

Alternatively, you can specify this property by using "one", "three", "dot5even", and "dot5odd" as string scalars or as elements of a string array.

The value of ρ is the higher-layer parameter density defined in the CSI-RS-ResourceMapping IE or the CSI-RS-CellMobility IE.

Data Types: cell | string | char

SymbolLocations — Time-domain locations of CSI-RS resource

0 (default) | integer from 0 to 13 | vector of integers | cell array

Time-domain locations of the CSI-RS resource (l₀ and l₁ values in the TS 38.211 Table 7.4.1.5.3-1), specified as one of these options.

For Single CSI-RS Resource

• Integer from 0 to 13 — This option corresponds to the l₀ value in the specified table.

• Vector of integers of the form [l₀ l₁] or [l₀; l₁], where l₀ and l₁ are the corresponding l₀ and l₁ values in the specified table — The l₁ values are required only in table rows 13, 14, 16, and 17. l₀ is an integer from 0 to 13, and l₁ is an integer from 2 to 12.

For Multiple CSI-RS Resources

• Cell array of l₀ values or vectors of the form [l₀ l₁] or [l₀; l₁] — The number of elements in the cell array must equal the number of CSI-RS resources specified by the CSIRSType property.

  In a two-element vector based on l₀ and l₁, to avoid the overlap between the CDM groups corresponding to different CSI-RS ports, specify the symbol locations at least 2 locations apart.

The values of l₀ and l₁ are the higher-layer parameters firstOFDMSymbolInTimeDomain and firstOFDMSymbolInTimeDomain2, respectively, in the CSI-RS-ResourceMapping IE or CSI-RS-ResourceConfigMobility IE.

Data Types: double

SubcarrierLocations — Frequency-domain locations of CSI-RS resource

0 (default) | numeric vector | cell array

Frequency-domain locations of the CSI-RS resource (k_i elements in column 5 of TS 38.211 Table 7.4.1.5.3-1), specified as one of these options.

For Single CSI-RS Resource

• Numeric vector with the number of elements 1, 2, 3, 4, or 6

For Multiple CSI-RS Resources

• Cell array of numeric vectors with the number of elements 1, 2, 3, 4, or 6 — The number of elements in the cell array must equal the number of CSI-RS resources specified by the CSIRSType property.

  To avoid the overlap between the CDM groups that correspond to different CSI-RS ports, specify the subcarrier locations at least 2 locations apart. TS 38.211 Section 7.4.1.5.3 describes the procedure to calculate subcarrier locations from a bitmap defined by the higher-layer parameter frequencyDomainAllocation in the CSI-RS-ResourceMapping IE or CSI-RS-ResourceConfigMobility IE. To avoid the loss in orthogonality among different CSI-RS ports, this procedure ensures that there is no overlap between the CDM groups.

Data Types: double

NumRB — CSI-RS resource bandwidth

52 (default) | integer from 1 to 275 | vector of integers

CSI-RS resource bandwidth, in terms of the number of allocated RBs, specified as one of these options.

For Single CSI-RS Resource

• Integer from 1 to 275

For Multiple CSI-RS Resources

• Vector of integers in the range from 1 to 275 — The number of vector elements must equal to one or the number of CSI-RS resources specified by the CSIRSType property. When the vector contains only one element, the specified value applies to all CSI-RS resources.

This property is the higher-layer parameter nrOfRBs in FrequencyOccupation IE or nrOfPRBs in CSI-RS-ResourceConfigMobility IE.

Data Types: double

RBOffset — Starting RB index of CSI-RS resource allocation

0 (default) | integer from 0 to 274 | vector of integers

Starting RB index of the CSI-RS resource allocation, relative to the carrier resource grid, specified as one of these options.

For Single CSI-RS Resource

• Integer from 0 to 274

For Multiple CSI-RS Resources

• Vector of integers in the range from 0 to 274 — The number of vector elements must be equal to one or the number of CSI-RS resources specified by the CSIRSType property. When the vector contains only one element, the specified value applies to all CSI-RS resources.

Note

Specify this property relative to the carrier start, which contains the BWP specified by the BandwidthPartID property.

Data Types: double

NID — Scrambling identity

0 (default) | integer from 0 to 1023 | vector of integers

Scrambling identity, specified as one of these options.

For Single CSI-RS Resource

• Integer from 0 to 1023

For Multiple CSI-RS Resources

• Vector of integers in the range from 0 to 1023 — The number of vector elements must be one or equal the number of CSI-RS resources specified by the CSIRSType property. When the vector contains only one element, the specified value applies to all CSI-RS resources.

This property is the higher-layer parameter scramblingID in NZP-CSI-RS-Resource IE or sequenceGenerationConfig in CSI-RS-ResourceConfigMobility IE.

When the CSIRSType property defines only ZP resources, this property is hidden.

Data Types: double

Examples

Configure CSI-RS for 5G Downlink Waveform Generation

Create two SCS carrier configuration objects with mixed numerologies and a custom number of resource blocks.

carriers = {
    nrSCSCarrierConfig('SubcarrierSpacing',15,'NStartGrid',10,'NSizeGrid',100), ...
    nrSCSCarrierConfig('SubcarrierSpacing',30,'NStartGrid',0,'NSizeGrid',70)};
    

Create two BWP configuration objects, one for each of the SCS carriers.

bwp = {
    nrWavegenBWPConfig('BandwidthPartID',1,'SubcarrierSpacing',15,'NStartBWP',10,'NSizeBWP',80), ...
    nrWavegenBWPConfig('BandwidthPartID',2,'SubcarrierSpacing',30,'NStartBWP',0,'NSizeBWP',60)};

Create two CSI-RS configuration objects, one for each of the BWP.

 csirs = {
     nrWavegenCSIRSConfig('BandwidthPartID',1,'RowNumber',2,'RBOffset',10), ... 
     nrWavegenCSIRSConfig('BandwidthPartID',2,'Density','three','RowNumber',4)};

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

cfgDL = nrDLCarrierConfig( ...
    'SCSCarriers',carriers, ...
    'BandwidthParts',bwp, ...
    'CSIRS',csirs);

References

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

Extended Capabilities

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

Version History

Introduced in R2020b

R2022a: nrWavegenCSIRSConfig object enables CSI-RS by default

The Enable property now defaults to 1 instead of 0. As a result, the object now enables CSI-RS by default. To preserve the behavior of the nrDLCarrierConfig object from previous releases, in which CSI-RS is disabled by default, the CSRSI property of the nrDLCarrierConfig object now defaults to {nrWavegenCSIRSConfig('Enable',0)} instead of {nrWavegenCSIRSConfig}.