nrPRSConfig
Description
The nrPRSConfig
object sets the positioning reference signal
(PRS) configuration parameters, as defined in TS 38.211 Section 7.4.1.7 [1]. By default, the object
defines a PRS resource set with a single PRS resource occupying 52 resource blocks and
spanning over the first 12 orthogonal frequency division multiplexing (OFDM) symbols per slot.
The default object allocates the complete bandwidth for PRS resource, when used in combination
with a default nrCarrierConfig
object.
For multiple PRS resources, the maximum vector length of these properties specifies the number of configured PRS resources:
Creation
Description
creates a default PRS
configuration object.prs
= nrPRSConfig
specifies properties using one
or more name-value arguments. For example, prs
= nrPRSConfig(Name=Value
)PRSResourceSetPeriod='on'
specifies that all of the PRS resources are present in the operating slot.
Properties
PRSResourceSetPeriod
— PRS resource set slot periodicity and slot offset
'on'
(default) | 'off'
| two-element vector
PRS resource set slot periodicity and slot offset, specified as one of these options.
'on'
— All of the PRS resources are present in the operating slot.'off'
— All of the PRS resources are absent in the operating slot.Two-element vector of the form [TPRSPeriod, TPRSOffset] — TPRSPeriod is the resource set slot periodicity. The nominal value of TPRSPeriod must equal 2μ multiplied by one of the values in the set {4, 5, 8, 10, 16, 20, 32, 40, 64, 80, 160, 320, 640, 1280, 2560, 5120, 10,240}, where μ is the subcarrier spacing configuration with a value of 0, 1, 2, or 3. TPRSOffset is the resource set slot offset and must equal a value in the range [0, TPRSPeriod – 1].
Data Types: double
| string
| char
PRSResourceOffset
— Slot offset of each PRS resource
0
(default) | scalar in the range [0, 511] | vector of integers in the range [0, 511]
Slot offset of each PRS resource (0-based) provided by the higher layer parameter dl-PRS-ResourceSlotOffset-r16, specified as a scalar in the range [0, 511] or a vector of integers in the range [0, 511]. This property represents the starting slot offset of a PRS resource relative to the PRS resource set offset (TPRSOffset).
Configure this property for each resource in a resource set separately based on one of these options.
When a single resource is present, specify this property as a scalar.
When multiple resources are present, specify this property as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of PRS resources to be configured in a PRS resource set.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset].
Data Types: double
PRSResourceRepetition
— PRS resource repetition factor
1
(default) | 2
| 4
| 6
| 8
| 16
| 32
PRS resource repetition factor provided by the higher layer parameter
dl-PRS-ResourceRepetitionFactor-r16, specified as
1
, 2
, 4
,
6
, 8
, 16
, or
32
. This property value is the same for all of the PRS resources in
a PRS resource set.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset].
Data Types: double
PRSResourceTimeGap
— Slot offset between two consecutive repeated instances of a PRS resource
1
(default) | 2
| 4
| 8
| 16
| 32
Slot offset between two consecutive repeated instances of a PRS resource, specified
as 1
, 2
, 4
,
8
, 16
, or 32
. The property
represents the offset in terms of the number of slots between two repeated instances of
a PRS resource. This property value is same the for all of the PRS resources in a PRS
resource set. This property is the higher layer parameter
dl-PRS-ResourceTimeGap-r16.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset] and the PRSResourceRepetition property to a value greater than 1.
Data Types: double
MutingPattern1
— Muting bit pattern option-1
[]
(default) | binary-valued vector of length 2, 4, 6, 8, 16, or 32
Muting bit pattern option-1, specified as []
or a binary-valued
vector of length 2, 4, 6, 8, 16, or 32.
If the higher layer parameter mutingOption1-r16 is configured, set this property to a binary-valued vector of length 2, 4, 6, 8, 16, or 32. Each element in the vector corresponds to a number of consecutive instances of a PRS resource set based on the
MutingBitRepetition
property. The vector element also indicates whether all of the PRS resources within the PRS resource set instances are transmitted (binary 1) or muted (binary 0).If the higher layer parameter mutingOption1-r16 is not configured, set this property to
[]
. To disable the muting bit pattern option-1, set this property to[]
.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset].
Data Types: double
MutingBitRepetition
— Muting bit repetition factor
1
(default) | 2
| 4
| 8
Muting bit repetition factor provided by the higher layer parameter
dl-PRS-MutingBitRepetitionFactor-r16, specified as
1
, 2
, 4
, or
8
. This property indicates the number of consecutive instances of
the PRS resource set, N, corresponding to each element of the
MutingPattern1
property. The first element in
MutingPattern1
corresponds to the first N
instances of a PRS resource set, the second element corresponds to the next
N instances of a PRS resource set, and so on.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset] and the
MutingPattern1
property to a value other than
[]
.
Data Types: double
MutingPattern2
— Muting bit pattern option-2
[]
(default) | binary-valued vector of length 1, 2, 4, 6, 8, 16, or 32
Muting bit pattern option-2, specified as []
or a binary-valued
vector of length 1, 2, 4, 6, 8, 16, or 32.
If the higher layer parameter mutingOption2-r16 is configured, set this property to a binary-valued vector of length 1, 2, 4, 6, 8, 16, or 32. Each element in the vector relates to the corresponding repetition index. Each element in the vector corresponds to a single repetition index of each PRS resource in an active instance of a PRS resource set. The vector element also indicates whether the repetition index for all of the PRS resources is transmitted (binary 1) or muted (binary 0).
If the higher layer parameter mutingOption2-r16 is not configured, set this property to
[]
. To disable the muting bit pattern option-2, set this property to[]
.
Dependencies
To enable this property, set the PRSResourceSetPeriod
property to a two-element vector of the form
[TPRSPeriod, TPRSOffset].
Data Types: double
NumPRSSymbols
— Number of consecutive OFDM symbols allocated for each PRS resource
12
(default) | scalar in the range [0, 12] | vector of integers in the range [0, 12]
Number of consecutive OFDM symbols allocated for each PRS resource, specified as a scalar in the range [0, 12] or a vector of integers in the range [0, 12].
Configure this property for each resource in a resource set separately based on one of these options.
When a single resource is present, specify this property as a scalar.
When multiple resources are present, specify this property as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of PRS resources to be configured in a PRS resource set.
This property is the higher layer parameter
dl-PRS-NumSymbols-r16, and the nominal value of this property
must be 2
, 4
, 6
, or
12
. To indicate no PRS resource allocation, set this property to
0
.
Data Types: double
SymbolStart
— Starting OFDM symbol of each PRS resource in slot
0
(default) | scalar in the range [0, 13] | vector of integers in the range [0, 13]
Starting OFDM symbol of each PRS resource in a slot (0-based), specified as a scalar in the range [0, 13] or a vector of integers in the range [0, 13].
Configure this property for each resource in a resource set separately based on one of these options.
When a single resource is present, specify this property as a scalar.
When multiple resources are present, specify this property as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of PRS resources to be configured in a PRS resource set.
This property is the higher layer parameter dl-PRS-ResourceSymbolOffset-r16, and the nominal value of this property must be in the range [0, 12].
Data Types: double
NumRB
— Number of PRBs allocated for all PRS resources
52
(default) | scalar in the range [0, 275]
Number of PRBs allocated for all PRS resources in a resource set, specified as a
scalar in the range [0, 275]. This property is the higher layer parameter
dl-PRS-ResourceBandwidth-r16, and the nominal value of this
property must be in the range [24, 272] with a granularity of 4 PRBs. To indicate no PRS
resource allocation, set this property to 0
.
Data Types: double
RBOffset
— Starting PRB index of all PRS resources relative to carrier resource grid
0
(default) | scalar in the range [0, 274]
Starting PRB index of all PRS resources relative to the carrier resource grid, specified as a scalar in the range [0, 274].
Data Types: double
CombSize
— Comb size of all PRS resources
2
(default) | 4
| 6
| 12
Comb size of all PRS resources in a resource set, specified as 2
,
4
, 6
, or 12
. The comb size
represents the resource element spacing in each OFDM symbol. This property is the higher
layer parameter dl-PRS-CombSizeN-r16. The value
2
specifies for the object to allocate every 2nd RE in the PRB for
PRS, the value 4
specifies for the object to allocate every 4th RE in
the PRB for PRS, and so on.
Data Types: double
REOffset
— Starting RE offset in first PRS OFDM symbol of each PRS resource
0
(default) | scalar in the range [0, (CombSize
–1)] | vector of integers in the range [0, (CombSize
–1)]
Starting RE offset in the first PRS OFDM symbol of each PRS resource, specified as a
scalar in the range [0, (CombSize
–1)] or a vector of integers in the range [0,
(CombSize
–1)]. The relative RE offsets of the next PRS OFDM
symbols are defined relative to the REOffset
value, as described in
TS 38.211 Table 7.4.1.7.3-1.
Configure this property for each resource in a resource set separately based on one of these options.
When a single resource is present, specify this property as a scalar.
When multiple resources are present, specify this property as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of PRS resources to be configured in a PRS resource set.
This property is the higher layer parameter dl-PRS-ReOffset-r16.
Data Types: double
NPRSID
— Sequence identity of each PRS resource
0
(default) | scalar in the range [0, 4095] | vector of integers in the range [0, 4095]
Sequence identity of each PRS resource provided by the higher layer parameter dl-PRS-SequenceID-r16, specified as a scalar in the range [0, 4095] or a vector of integers in the range [0, 4095].
Configure this property for each resource in a resource set separately based on one of these options.
When a single resource is present, specify this property as a scalar.
When multiple resources are present, specify this property as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of PRS resources to be configured in a PRS resource set.
Data Types: double
FrequencyOffsetTable
— Frequency offsets table
4
-by-13
table
This property is read-only.
Frequency offsets table, specified as a
4
-by-13
table. The table contains the relative
resource element offsets in each PRS OFDM symbol defined relative to the
REOffset
property, according to TS 38.211 Table 7.4.1.7.3-1. The
4 rows in the table correspond to the four CombSize
property
values. The 13 columns in the table correspond to the OFDM symbol numbers within the PRS
resource allocation (0 to 12).
The object automatically sets this property based on the TS 38.211 Table 7.4.1.7.3-1.
Data Types: double
Examples
Set PRS Configuration Parameters
Create a default PRS configuration object. Display its properties.
prs = nrPRSConfig
prs = nrPRSConfig with properties: PRSResourceSetPeriod: 'on' PRSResourceOffset: 0 PRSResourceRepetition: 1 PRSResourceTimeGap: 1 MutingPattern1: [] MutingBitRepetition: 1 MutingPattern2: [] NumPRSSymbols: 12 SymbolStart: 0 NumRB: 52 RBOffset: 0 CombSize: 2 REOffset: 0 NPRSID: 0 Constant properties: FrequencyOffsetTable: [4x13 table]
Create PRS Configuration Object with Two PRS Resources
Create a default PRS configuration object.
prs = nrPRSConfig;
Set properties that are common to all of the PRS resources in a resource set.
prs.PRSResourceSetPeriod = [20 0]; prs.PRSResourceRepetition = 4; prs.PRSResourceTimeGap = 2; prs.MutingPattern1 = [1 0]; prs.MutingBitRepetition = 2; prs.MutingPattern2 = [1 0 1 0]; prs.NumRB = 32; prs.RBOffset = 10; prs.CombSize = 4;
Set properties that are unique to each PRS resource in a resource set. You can specify these properties as a scalar or vector. If you specify a scalar, the object applies that value to all of the PRS resources in a PRS resource set. If you specify a vector, the object applies the vector element values to the corresponding PRS resource. The length of this vector must be equal to the number of configured PRS resources in a PRS resource set.
prs.PRSResourceOffset = [0 10]; prs.NumPRSSymbols = [6 4]; prs.SymbolStart = [0 1]; prs.REOffset = 0; prs.NPRSID = [10 50];
Display the object properties.
disp(prs)
nrPRSConfig with properties: PRSResourceSetPeriod: [20 0] PRSResourceOffset: [0 10] PRSResourceRepetition: 4 PRSResourceTimeGap: 2 MutingPattern1: [1 0] MutingBitRepetition: 2 MutingPattern2: [1 0 1 0] NumPRSSymbols: [6 4] SymbolStart: [0 1] NumRB: 32 RBOffset: 10 CombSize: 4 REOffset: 0 NPRSID: [10 50] Constant properties: FrequencyOffsetTable: [4x13 table]
References
[1] 3GPP TS 38.211. “NR; Physical channels and modulation (Release 16).” 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 R2021a
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)