nrPUCCH4

Generate PUCCH format 4 modulation symbols

Syntax

sym = nrPUCCH4(uciCW,mod,nid,rnti,sf,occi)

sym = nrPUCCH4(___,mrb)

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

Description

sym = nrPUCCH4(uciCW,mod,nid,rnti,sf,occi) returns the physical uplink control channel (PUCCH) format 4 modulation symbols for encoded uplink control information (UCI) codeword uciCW. The function implements TS 38.211 Section 6.3.2.6 [1]. The encoding consists of:

• Scrambling using scrambling identity nid.

• Symbol modulation using modulation scheme mod.

• Block-wise spreading using spreading factor sf and orthogonal cover code index occi.

• Transform precoding by considering 12 subcarriers associated with the PUCCH format 4 transmission.

rnti is the radio network temporary identifier (RNTI) of the user equipment (UE).

sym = nrPUCCH4(___,mrb) specifies the number of PUCCH resource blocks in addition to the input arguments in the previous syntax. In this case, the transform precoding considers 12×mrb subcarriers for the PUCCH.

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

Examples

Generate PUCCH Format 4 QPSK Modulation Symbols

Create a random sequence of binary values corresponding to a UCI codeword of 96 bits.

uciCW = randi([0 1],96,1);

Using QPSK modulation, generate PUCCH format 4 modulation symbols for the specified scrambling identity, RNTI, spreading factor, and orthogonal cover code index.

modulation = 'QPSK';
nid = 148;
rnti = 160;
sf = 2;
occi = 1;
sym = nrPUCCH4(uciCW,modulation,nid,rnti,sf,occi)

sym = 96×1 complex

   0.0000 + 0.0000i
  -0.8165 + 0.8165i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
  -0.8165 + 0.8165i
   0.0000 + 0.0000i
  -1.4142 + 1.4142i
   0.0000 + 0.0000i
  -0.8165 + 0.8165i
   0.0000 + 0.0000i
   1.4142 - 1.4142i
   0.0000 + 0.0000i
   0.8165 + 0.0000i
   0.0000 + 0.0000i
      ⋮

Generate PUCCH Format 4 Pi/2-BPSK Modulation Symbols

Create a random sequence of binary values corresponding to a UCI codeword of 192 bits.

uciCW = randi([0 1],192,1);

Using pi/2-BPSK modulation, generate PUCCH format 4 modulation symbols of single data type for the specified scrambling identity, RNTI, spreading factor, and orthogonal cover code index.

modulation = 'pi/2-BPSK';
nid = 285;
rnti = 897;
sf = 4;
occi = 3;
sym = nrPUCCH4(uciCW,modulation,nid,rnti,sf,occi,'OutputDataType','single')

sym = 768×1 single column vector

   0.0000 + 0.0000i
  -1.6330 - 1.6330i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
  -1.6330 - 1.6330i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.8165 + 0.8165i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
   0.0000 + 0.0000i
      ⋮

Input Arguments

uciCW — Encoded UCI codeword

logical column vector

Encoded UCI codeword, specified as a logical column vector. For pi/2-BPSK modulation, the length of uciCW must be a multiple of 12. For QPSK modulation, the length of uciCW must be a multiple of 24. For more information, see TS 38.212 Section 6.3.1 [2].

Data Types: int8 | double | logical

mod — Modulation scheme

'pi/2-BPSK' | 'QPSK'

Modulation scheme, specified as 'pi/2-BPSK' or 'QPSK'. The modulation scheme determines the modulation type performed on the input codeword and the number of bits used per modulation symbol.

Modulation Scheme	Number of Bits Per Symbol
'pi/2-BPSK'	1
'QPSK'	2

Data Types: char | string

nid — Scrambling identity

integer from 0 to 1023

Scrambling identity, specified as an integer from 0 to 1023. nid is higher layer parameter dataScramblingIdentityPUSCH, 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, see TS 38.211 Section 6.3.2.6.1.

Data Types: double

rnti — RNTI of UE

integer from 0 to 65,535

RNTI of the UE, specified as an integer from 0 to 65,535.

Data Types: double

sf — Spreading factor for PUCCH format 4

2 | 4

Spreading factor for PUCCH format 4, specified as 2 or 4.

Data Types: double

occi — Orthogonal cover code index

nonnegative integer

Orthogonal cover code index, specified as a nonnegative integer. occi must be less than the spreading factor sf.

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

complex column vector

PUCCH format 4 modulation symbols, returned as a complex column vector.

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™.

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.