Main Content

nrPUCCHDMRS

Generate PUCCH DM-RS symbols

Since R2021a

collapse all in page

    Syntax

    sym = nrPUCCHDMRS(carrier,pucch)
    sym = nrPUCCHDMRS(carrier,pucch,'OutputDataType',datatype)

    Description

    sym = nrPUCCHDMRS(carrier,pucch) generates sym, which contains demodulation reference signal (DM-RS) symbols of a physical uplink control channel (PUCCH), as defined in TS 38.211 Section 6.4.1.3 [1], for all PUCCH formats. carrier specifies the carrier configuration. pucch specifies the PUCCH configuration. For PUCCH formats 1, 3, and 4, setting the GroupHopping property of pucch is set to 'disable' enables sequence hopping. In this case, the function selects a sequence number, which might be inappropriate for short base sequences. For PUCCH format 0, the function returns an empty value for sym.

    example

    sym = nrPUCCHDMRS(carrier,pucch,'OutputDataType',datatype) specifies the data type of the PUCCH symbols.

    example

    Examples

    collapse all

    Open Live Script

    Create a default carrier configuration object.

    carrier = nrCarrierConfig;

    Specify the number of RBs in the carrier resource grid as 50, the start of the carrier resource grid relative to CRB 0 as 120, and the slot number as 25.

    carrier.NSizeGrid = 50;
carrier.NStartGrid = 120;
carrier.NSlot = 25;

    Create a default PUCCH format 2 configuration object.

    pucch2 = nrPUCCH2Config;

    Specify the first symbol index in the PUCCH transmission slot as 7 and the number of allocated PUCCH symbols as 2. Set the PRBs allocated for the PUCCH to range from 40 to 45. Enable intraslot frequency hopping and set the starting PRB index of the second hop to 20. Specify the DM-RS scrambling identity as 1005.

    pucch2.SymbolAllocation = [7 2];
pucch2.PRBSet = 40:45;
pucch2.FrequencyHopping = 'intraSlot';
pucch2.SecondHopStartPRB = 20;
pucch2.NID0 = 1005;

    Generate the DM-RS symbols of PUCCH format 2.

    sym = nrPUCCHDMRS(carrier,pucch2)
    sym = 48×1 complex

   0.7071 - 0.7071i
  -0.7071 + 0.7071i
  -0.7071 - 0.7071i
   0.7071 - 0.7071i
  -0.7071 - 0.7071i
   0.7071 - 0.7071i
   0.7071 - 0.7071i
   0.7071 - 0.7071i
   0.7071 - 0.7071i
  -0.7071 + 0.7071i
      ⋮

    Generate the DM-RS RE indices of PUCCH format 2.

    ind = nrPUCCHDMRSIndices(carrier,pucch2)
    ind = 48x1 uint32 column vector

   4682
   4685
   4688
   4691
   4694
   4697
   4700
   4703
   4706
   4709
      ⋮

    Plot the generated symbols and REs in the carrier resource grid.

    resGrid = nrResourceGrid(carrier);
resGrid(ind) = sym;
imagesc(abs(resGrid))
axis xy
xlabel('OFDM Symbols')
ylabel('Subcarriers')
title('Carrier Grid Containing DM-RS of PUCCH Format 2')

    Figure contains an axes object. The axes object with title Carrier Grid Containing DM-RS of PUCCH Format 2, xlabel OFDM Symbols, ylabel Subcarriers contains an object of type image.

    Open Live Script

    Create a default carrier configuration object.

    carrier = nrCarrierConfig;

    Specify the number of RBs in the carrier resource grid to 10.

    carrier.NSizeGrid = 10;

    Create a default PUCCH format 4 configuration object.

    pucch4 = nrPUCCH4Config;

    Set the first symbol index in the PUCCH transmission slot to 2 and the number of allocated PUCCH symbols to 12. Enable group hopping and the additional DM-RS configuration flag. Specify the hopping identity as 120, the spreading factor as 4, and the orthogonal cover code index (OCCI) as 3.

    pucch4.SymbolAllocation = [2 12];
pucch4.GroupHopping = 'enable';
pucch4.HoppingID = 120;
pucch4.SpreadingFactor = 4;
pucch4.OCCI = 3;
pucch4.AdditionalDMRS = 1;

    Generate the DM-RS symbols of PUCCH format 4 with data type single.

    sym = nrPUCCHDMRS(carrier,pucch4, 'OutputDataType','single')
    sym = 48x1 single column vector

   0.7071 - 0.7071i
   0.7071 - 0.7071i
   0.7071 - 0.7071i
  -0.7071 - 0.7071i
  -0.7071 - 0.7071i
   0.7071 - 0.7071i
   0.7071 + 0.7071i
  -0.7071 - 0.7071i
   0.7071 + 0.7071i
   0.7071 + 0.7071i
      ⋮

    Generate the DM-RS RE indices of PUCCH format 4.

    ind = nrPUCCHDMRSIndices(carrier,pucch4)
    ind = 48x1 uint32 column vector

   361
   362
   363
   364
   365
   366
   367
   368
   369
   370
      ⋮

    Plot the generated symbols and REs in the carrier resource grid.

    resGrid = nrResourceGrid(carrier);
resGrid(ind) = sym;
imagesc(abs(resGrid))
axis xy
xlabel('OFDM Symbols')
ylabel('Subcarriers')
title('Carrier Grid Containing DM-RS of PUCCH Format 4')

    Figure contains an axes object. The axes object with title Carrier Grid Containing DM-RS of PUCCH Format 4, xlabel OFDM Symbols, ylabel Subcarriers contains an object of type image.

    Input Arguments

    collapse all

    Carrier configuration parameters for a specific OFDM numerology, specified as an nrCarrierConfig object. This function uses only these properties of the nrCarrierConfig object.

    PUCCH configuration parameters, specified as one of these options.

    For PUCCH formats 1 to 3 and operation with shared spectrum channel access for frequency range 1 (FR1), set the corresponding Interlacing property to true, and use the RBSetIndex and InterlaceIndex object properties to specify the allocated frequency resources. In addition, for PUCCH formats 2 and 3, you can use the SpreadingFactor and OCCI properties with single-interlace configurations. (since R2023b)

    Note

    For PUCCH format 0, the function returns an empty value.

    Data type of the output symbols, specified as 'double' or 'single'.

    Data Types: char | string

    Output Arguments

    collapse all

    PUCCH DM-RS modulation symbols, returned as a complex matrix. For PUCCH format 0, this output is empty.

    Data Types: single | double
    Complex Number Support: Yes

    References

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

    Extended Capabilities

    Version History

    Introduced in R2021a

    expand all

    See Also

    Functions

    Objects