nrPUSCHCodebook

Generate PUSCH precoding matrix

Syntax

w = nrPUSCHCodebook(nLayers,nPorts,tpmi)

w = nrPUSCHCodebook(nLayers,nPorts,tpmi,transformPrecode)

w = nrPUSCHCodebook(___,codebookType)

Description

w = nrPUSCHCodebook(nLayers,nPorts,tpmi) returns the physical uplink shared channel (PUSCH) precoding matrix for codebook-based transmission. nLayers is the number of layers, nPorts is the number of antenna ports, and tpmi is the transmitted precoding matrix indicator (TPMI). By default, this function disables transform precoding. The returned matrix, w, is the transpose of the precoding matrix defined in TS 38.211 Section 6.3.1.5 [1]. The matrix orientation of w allows the precoding operation to be performed by matrix multiplication on the output of the nrLayerMap function and w.

w = nrPUSCHCodebook(nLayers,nPorts,tpmi,transformPrecode) specifies transform precoding as a logical value. When transformPrecode is set to true, the function applies the transform precoding defined in TS 38.211 Section 6.3.1.4 [1].

w = nrPUSCHCodebook(___,codebookType) specifies the codebook type in addition to the input arguments in any of the previous syntaxes when nPorts is 8. (since R2024a)

Examples

Apply PUSCH Precoding Codebook

Modulate a random sequence of binary values of length 600 by using 64-QAM modulation. Split the modulated symbols into two layers.

modulation = '64QAM';
nlayers = 2;
in = randi([0 1],600,1);
data = nrSymbolModulate(in,modulation);
y = nrLayerMap(data,nlayers);

Generate the PUSCH precoding matrix for four antennas, two layers, and the specified TPMI.

nports = 4;
tpmi = 7;
w = nrPUSCHCodebook(nlayers,nports,tpmi)

w = 2×4 complex

   0.5000 + 0.0000i   0.0000 + 0.0000i   0.5000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   0.5000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.5000i

Precode the layered modulation symbols by using the codebook matrix.

z = y * w

z = 50×4 complex

  -0.0772 - 0.3858i   0.3858 - 0.5401i  -0.0772 - 0.3858i   0.5401 + 0.3858i
  -0.3858 + 0.0772i  -0.5401 - 0.0772i  -0.3858 + 0.0772i   0.0772 - 0.5401i
  -0.5401 - 0.2315i  -0.2315 + 0.0772i  -0.5401 - 0.2315i  -0.0772 - 0.2315i
  -0.3858 + 0.2315i  -0.2315 - 0.0772i  -0.3858 + 0.2315i   0.0772 - 0.2315i
  -0.0772 - 0.3858i   0.5401 + 0.2315i  -0.0772 - 0.3858i  -0.2315 + 0.5401i
  -0.5401 + 0.5401i  -0.0772 + 0.2315i  -0.5401 + 0.5401i  -0.2315 - 0.0772i
  -0.3858 + 0.2315i  -0.0772 + 0.5401i  -0.3858 + 0.2315i  -0.5401 - 0.0772i
  -0.3858 + 0.5401i   0.5401 + 0.3858i  -0.3858 + 0.5401i  -0.3858 + 0.5401i
  -0.2315 + 0.0772i   0.2315 - 0.5401i  -0.2315 + 0.0772i   0.5401 + 0.2315i
  -0.2315 - 0.0772i   0.3858 - 0.3858i  -0.2315 - 0.0772i   0.3858 + 0.3858i
      ⋮

Input Arguments

nLayers — Number of transmission layers

integer from 1 to 8

Number of transmission layers, specified as an integer from 1 to 8.

• For one codeword, specify an integer from 1 to 4.

• For two codewords, specify an integer from 5 to 8.

For more information, see TS 38.211 Section 6.3.1.3.

Data Types: double

nPorts — Number of antenna ports

1 | 2 | 4 | 8

Number of antenna ports, specified as 1, 2, 4, or 8. For more information, see TS 38.211 Section 6.3.1.5.

Data Types: double

tpmi — Transmitted precoding matrix indicator

integer from 0 to 304

Transmitted precoding matrix indicator, specified as an integer from 0 to 304. The valid range of tpmi depends on the specified number of transmission layers, nLayers, number of antenna ports, nPorts, and codebook type, codebookType. For more information, see TS 38.211 Tables 6.3.1.5-1 to 6.3.1.5-47.

Data Types: double

transformPrecode — Transform precoding

false (default) | true

Transform precoding, specified as false or true. For more information, see TS 38.211 Section 6.3.1.4.

Data Types: double | logical

codebookType — Codebook type

'codebook1_ng1n4n1' (default) | 'codebook1_ng1n2n2' | 'codebook2' | 'codebook3' | 'codebook4'

Since R2024a

Codebook type, specified as 'codebook1_ng1n4n1', 'codebook1_ng1n2n2', 'codebook2', 'codebook3', or 'codebook4'. Use this input together with the nLayers and tpmi inputs to specify the precoding matrix W from TS 38.211 Tables 6.3.1.5-9 to 6.3.1.5-47 for codebook transmissions with 8 antenna ports, that is, when nPorts=8.

Use this table to identify which codebook type to use for a specific number of antenna groups (Ng) and a specific table from TS 38.211. For a single antenna group (Ng=1), the table also shows the geometrical distribution of the antenna ports in each antenna group [N1 N2]. N1 is the number of antenna ports in the horizontal direction and N2 is the number of antenna ports in the vertical direction.

CodebookType	Ng	[N1 N2]	Tables from TS 38.211
'codebook1_ng1n4n1'	1	[4 1]	Tables 6.3.1.5-9 to 6.3.1.5-16
'codebook1_ng1n2n2'	1	[2 2]	Tables 6.3.1.5-17 to 6.3.1.5-24
'codebook2'	2	N/A	Tables 6.3.1.5-25 to 6.3.1.5-36
'codebook3'	4	N/A	Tables 6.3.1.5-37 to 6.3.1.5-46
'codebook4'	8	N/A	Table 6.3.1.5-47

Output Arguments

w — PUSCH precoding codebook

complex matrix

PUSCH precoding codebook, returned as a complex matrix of size nLayers-by-nPorts. If nLayers and nPorts are both 1, then w is 1. Otherwise, the function returns the transpose of the matrix selected from Tables 6.3.1.5-1 to 6.3.1.5-7 in TS 38.211 [1].

Data Types: 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

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2019a

R2024a: Release 18 support for eight antenna ports, up to eight layers, and two codewords

The function enables you to:

• Specify 5 to 8 layers through the nLayers input.

• Specify 8 antenna ports through the nPorts input.

• Specify values up to 304 for the transmitted precoding matrix indicator through the tpmi input.

• Specify the precoding matrix W from TS 38.211 Tables 6.3.1.5-9 to 6.3.1.5-47 through the codebookType input.