nrWavegenCSIRSConfig
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
Description
csirs = nrWavegenCSIRSConfig
creates a default CSI-RS
configuration object for 5G waveform generation.
csirs = nrWavegenCSIRSConfig(
sets properties using one
or more name-value arguments. Enclose each property name in quotes. For example,
Name,Value
)'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 theCSIRSType
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 theCSIRSType
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 (l0 and l1 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 l0 value in the specified table.
Vector of integers of the form [l0 l1] or [l0; l1], where l0 and l1 are the corresponding l0 and l1 values in the specified table — The l1 values are required only in table rows 13, 14, 16, and 17. l0 is an integer from 0 to 13, and l1 is an integer from 2 to 12.
For Multiple CSI-RS Resources
Cell array of l0 values or vectors of the form [l0 l1] or [l0; l1] — 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 l0 and l1, 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 l0 and l1 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 (ki 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 R2020bR2022a: 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}
.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)