nrPUCCH1

Generate PUCCH format 1 modulation symbols

Syntax

sym = nrPUCCH1(ack,sr,symAllocation,cp,nslot,nid,groupHopping,initialCS,freqHopping,occi)

sym = nrPUCCH1(___,mrb)

sym = nrPUCCH1(___,'OutputDataType',datatype)

Description

sym = nrPUCCH1(ack,sr,symAllocation,cp,nslot,nid,groupHopping,initialCS,freqHopping,occi) returns the physical uplink control channel (PUCCH) format 1 modulation symbols, as defined in TS 38.211 Section 6.3.2.4 [1], based on these input arguments:

• Hybrid automatic repeat-request acknowledgment (HARQ-ACK) ack

• Scheduling request (SR) sr

• PUCCH symbol allocation symAllocation

• Cyclic prefix cp

• Radio frame slot number nslot

• Scrambling identity nid

• Group hopping configuration groupHopping

• Initial cyclic shift initialCS

• Intra-slot frequency hopping configuration freqHopping

• Orthogonal cover code index occi

sym = nrPUCCH1(___,mrb) specifies the number of PUCCH resource blocks in addition to the input arguments in the previous syntax.

sym = nrPUCCH1(___,'OutputDataType',datatype) specifies the PUCCH symbol data type in addition to the input argument combinations in the previous syntaxes.

Examples

Generate PUCCH Format 1 Modulation Symbols for Two-Bit HARQ-ACK with Positive SR Transmission

Specify a transmission with two-bit HARQ-ACK and positive SR.

ack = [0;1];
sr = 1;

Specify the first symbol index in the PUCCH transmission slot as 0, the number of allocated PUCCH symbols as 14, and the slot number as 3.

symAllocation = [0 14];
nslot = 3;

Set the scrambling identity to 512 and the initial cyclic shift to 5.

nid = 512;
initialCS = 5;

Generate the symbols with normal cyclic prefix, intra-slot frequency hopping and group hopping enabled, and orthogonal cover code index 2.

cp = 'normal';
freqHopping = 'enabled';
groupHopping = 'enable';
occi = 2;
sym = nrPUCCH1(ack,sr,symAllocation,cp,nslot, ...
    nid,groupHopping,initialCS,freqHopping,occi)

sym = 84×1 complex

  -1.0000 - 0.0000i
  -0.5000 + 0.8660i
  -0.8660 + 0.5000i
  -0.0000 - 1.0000i
  -0.8660 - 0.5000i
   0.8660 - 0.5000i
  -1.0000 + 0.0000i
   0.8660 + 0.5000i
  -0.8660 + 0.5000i
  -1.0000 + 0.0000i
   0.8660 + 0.5000i
   0.5000 + 0.8660i
   0.5000 + 0.8660i
  -0.8660 - 0.5000i
   0.0000 + 1.0000i
      ⋮

Generate PUCCH Format 1 Modulation Symbols for One-Bit HARQ-ACK Transmission

Specify a transmission with one-bit HARQ-ACK and negative SR.

ack = 1;
sr = 0;

Specify the first symbol index in the PUCCH transmission slot as 3, the number of allocated PUCCH symbols as 9, and the slot number as 7.

symAllocation = [3 9];
nslot = 7;

Set the scrambling identity to 512 and the initial cyclic shift to 9.

nid = 512;
initialCS = 9;

Generate the symbols with extended cyclic prefix, intra-slot frequency hopping and group hopping enabled, and orthogonal cover code index 1.

cp = 'extended';
freqHopping = 'enabled';
groupHopping = 'enable';
occi = 1;
sym = nrPUCCH1(ack,sr,symAllocation,cp,nslot, ...
    nid,groupHopping,initialCS,freqHopping,occi)

sym = 48×1 complex

  -0.0000 + 1.0000i
  -0.8660 + 0.5000i
  -0.5000 + 0.8660i
   1.0000 - 0.0000i
   0.8660 - 0.5000i
   0.8660 + 0.5000i
  -0.0000 - 1.0000i
  -0.8660 + 0.5000i
   0.8660 + 0.5000i
   0.0000 + 1.0000i
  -0.5000 - 0.8660i
  -0.5000 + 0.8660i
  -0.0000 - 1.0000i
  -0.8660 - 0.5000i
   0.5000 + 0.8660i
      ⋮

Input Arguments

ack — HARQ-ACK bits

empty vector | binary column vector

HARQ-ACK bits, specified as an empty vector or a binary column vector with one or two rows. An empty vector indicates PUCCH transmission without HARQ-ACK. If specifying a binary column vector, the number of rows corresponds to the number of codewords. Vector element 1 denotes positive acknowledgement (ACK), and vector element 0 denotes negative acknowledgment (NACK).

Data Types: double

sr — SR bits

empty vector | 1 | 0

SR bits, specified as an empty vector, 1, or 0. An empty vector indicates PUCCH transmission without SR. 1 denotes positive SR. 0 denotes negative SR. For either positive or negative SR with HARQ-ACK information bits, only HARQ-ACK transmission occurs. For negative SR without HARQ-ACK, the output sym is empty.

Data Types: double

symAllocation — PUCCH symbol allocation

two-element numeric vector

PUCCH symbol allocation, specified as a two-element numeric vector of the form [S L], where S and L are nonnegative integers.

• S is the first OFDM symbol index in the PUCCH transmission slot.

• L is the number of OFDM symbols allocated for PUCCH transmission. For PUCCH format 1, L is an integer from 4 or 14.

Note

S and L must satisfy these conditions.

• For extended control prefix, S + L ≤ 12.

• For normal cyclic prefix, S + L ≤ 14.

Data Types: double

cp — Cyclic prefix length

'normal' | 'extended'

Cyclic prefix length, specified as one of these options:

• 'normal' — Use this value to specify normal cyclic prefix. This option corresponds to 14 OFDM symbols in a slot.

• 'extended' — Use this value to specify extended cyclic prefix. This option corresponds to 12 OFDM symbols in a slot. For the numerologies specified in TS 38.211 Section 4.2, extended cyclic prefix length only applies for 60 kHz subcarrier spacing.

Data Types: char | string

nslot — Radio frame slot number

integer from 0 to 159

Radio frame slot number, specified as an integer from 0 to 159. For normal cyclic prefix of different numerologies, specify an integer from 0 to 159. For extended cyclic prefix, specify an integer from 0 to 39. For more details, see TS 38.211 Section 4.3.2.

Data Types: double

nid — Scrambling identity

integer from 0 to 1023

Scrambling identity, specified as an integer from 0 to 1023. nid is higher layer parameter hoppingId, ranging from 0 to 1023, if the higher layer parameter is configured. Otherwise, nid is the physical layer cell identity number NCellID, ranging from 0 to 1007. For more information on these values, see TS 38.211 Section 6.3.2.2.1.

Data Types: double

groupHopping — Group hopping configuration

'neither' | 'enable' | 'disable'

Group hopping configuration, specified as 'neither', 'enable', or 'disable'. The groupHopping argument is higher layer parameter pucch-GroupHopping.

Note

When groupHopping is set to 'disable', the function enables sequence hopping. In this case, the selected sequence number might not be appropriate for short base sequences.

Data Types: char | string

initialCS — Initial cyclic shift

integer from 0 to 11

Initial cyclic shift, m_0, specified as an integer from 0 to 11. initialCS is higher layer parameter initialCyclicShift.

For more information, see TS 38.213 Section 9.2.1 [2].

Data Types: double

freqHopping — Intra-slot frequency hopping configuration

'enabled' | 'disabled'

Intra-slot frequency hopping configuration, specified as 'enabled' or 'disabled'. The freqHopping argument is higher layer parameter intraSlotFrequencyHopping.

Data Types: char | string

occi — Orthogonal cover code index

integer from 0 to 6

Orthogonal cover code index, specified as an integer from 0 to 6. This input argument corresponds to higher layer parameter timeDomainOCC. The valid range depends on the number of OFDM symbols that contain control information in a hop.

Data Types: double

mrb — Number of PUCCH resource blocks

1 (default) | positive integer

Number of PUCCH resource blocks, specified as a positive integer.

Data Types: double

datatype — Data type of output symbols

'double' (default) | 'single'

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

Data Types: char | string

Output Arguments

sym — PUCCH format 1 modulation symbols

complex column vector | empty vector

PUCCH format 1 modulation symbols, returned as a complex column vector or an empty vector. sym is of length 12×mrb×floor(L/2), where L is the PUCCH symbol allocation length, specified by symAllocation. For negative SR without HARQ-ACK, the output sym 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.

[2] 3GPP TS 38.213. “NR; Physical layer procedures for control.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

The datatype input argument must be compile-time constant. For example, when specifying 'single' as the output data type, include {coder.Constant('OutputDataType'),coder.Constant('single')} in the -args value of the codegen function. For more information, see the coder.Constant (MATLAB Coder) class.

Version History

Introduced in R2019a

R2023a: Release 17 Update: Input argument for PUCCH resource blocks

Use the mrb input argument to specify the number of PUCCH resource blocks.