Main Content

nrPRSConfig

PRS configuration parameters

Since R2021a

expand all in page

    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

    Syntax

    prs = nrPRSConfig
    prs = nrPRSConfig(Name=Value)

    Description

    prs = nrPRSConfig creates a default PRS configuration object.

    example

    prs = nrPRSConfig(Name=Value) specifies properties using one or more name-value arguments. For example, PRSResourceSetPeriod='on' specifies that all of the PRS resources are present in the operating slot.

    example

    Properties

    expand all

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    collapse all

    Open Live Script

    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]
    Open Live Script

    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

    See Also

    Objects

    Functions

    Topics