nrPUCCH0

Generate PUCCH format 0 modulation symbols

Syntax

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

sym = nrPUCCH0(___,mrb)

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

Description

sym = nrPUCCH0(ack,sr,symAllocation,cp,nslot,nid,groupHopping,initialCS,freqHopping) returns the physical uplink control channel (PUCCH) format 0 modulation symbols, as defined in TS 38.211 Section 6.3.2.3 [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

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

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

Examples

Generate PUCCH Format 0 Modulation Symbols for Positive SR Transmission

Specify a transmission without HARQ-ACK and a positive SR.

ack = [];
sr = 1;

Specify the first symbol index in the PUCCH transmission slot as 11, the number of allocated PUCCH symbols as 2, and the slot number as 63.

symAllocation = [11 2];
nslot = 63;

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 disabled, and group hopping enabled.

cp = 'normal';
freqHopping = 'disabled';
groupHopping = 'enable';
sym = nrPUCCH0(ack,sr,symAllocation,cp,nslot,nid,groupHopping,initialCS,freqHopping)

sym = 24×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 PUCCH Format 0 Modulation Symbols for HARQ-ACK Transmission

Specify two-bit HARQ-ACK transmission and a negative SR.

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

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

symAllocation = [10 2];
nslot = 3;

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

nid = 12;
initialCS = 5;

Generate the symbols with extended cyclic prefix, intra-slot frequency hopping disabled, and group hopping enabled.

nid = 12;
initialCS = 5;
cp = 'extended';
freqHopping = 'disabled';
groupHopping = 'enable';
sym = nrPUCCH0(ack,sr,symAllocation,cp,nslot,nid,groupHopping,initialCS,freqHopping)

sym = 24×1 complex

  -0.7071 - 0.7071i
  -0.9659 - 0.2588i
  -0.9659 + 0.2588i
  -0.7071 - 0.7071i
   0.2588 - 0.9659i
  -0.2588 - 0.9659i
  -0.7071 + 0.7071i
   0.9659 + 0.2588i
   0.2588 + 0.9659i
  -0.7071 - 0.7071i
      ⋮

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 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 0, L is either 1 or 2.

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

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 0 modulation symbols

empty vector | complex column vector

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