nrPDSCHDecode

Decode PDSCH modulation symbols

Syntax

[cws,symbols] = nrPDSCHDecode(sym,mod,nid,rnti)

[cws,symbols] = nrPDSCHDecode(carrier,pdsch,sym)

[cws,symbols] = nrPDSCHDecode(___,nVar)

Description

[cws,symbols] = nrPDSCHDecode(sym,mod,nid,rnti) returns soft bits cws and constellation symbols symbols resulting from the inverse operation of the physical downlink shared channel (PDSCH) processing specified in TS 38.211 Sections 7.3.11–3 [1]. The decoding consists of layer demapping, demodulation of sym with modulation scheme mod, and descrambling with scrambling identity nid. The input rnti is the radio network temporary identifier (RNTI) of the user equipment (UE).

[cws,symbols] = nrPDSCHDecode(carrier,pdsch,sym) returns soft bits cws and constellation symbols symbols for the specified carrier configuration, carrier, and PDSCH configuration, pdsch. The input sym specifies the received PDSCH symbols to decode.

[cws,symbols] = nrPDSCHDecode(___,nVar) specifies the noise variance scaling factor of the soft bits in the PDSCH demodulation, in addition to the input arguments in any of the previous syntaxes.

Examples

Decode PDSCH Modulation Symbols

Generate and decode PDSCH modulation symbols.

Specify a random sequence of binary values corresponding to a codeword of 8000 bits using 256-QAM modulation. Generate PDSCH modulation symbols for the specified physical layer cell identity number, RNTI, and number of transmission layers.

modulation = '256QAM';
nlayers = 4;
ncellid = 42;
rnti = 6143;
data = randi([0 1],8000,1);
txsym = nrPDSCH(data,modulation,nlayers,ncellid,rnti);

Add an additive white Gaussian noise (AWGN) to the PDSCH symbols. Then demodulate to produce soft bit estimates.

SNR = 30; % SNR in dB
rxsym = awgn(txsym,SNR);
rxbits = nrPDSCHDecode(rxsym,modulation,ncellid,rnti);

Decode PDSCH Symbols Using Configuration Parameters

Create a carrier configuration object with default properties. Specify the physical layer cell identity as 42.

carrier = nrCarrierConfig;
carrier.NCellID = 42;

Create a PDSCH configuration object with default properties. Set the radio network temporary identifier to 1005, size of the bandwidth part to 25, starting PRB index of the BWP to 10, and the PRB set to occupy the whole BWP.

pdsch = nrPDSCHConfig;
pdsch.RNTI = 1005;
pdsch.NID = []; % Set NID equal to the NCellID property of carrier
pdsch.NSizeBWP = 25;
pdsch.NStartBWP = 10;
pdsch.PRBSet = 0:pdsch.NSizeBWP-1;

Generate PDSCH symbols for a single codeword of 8000 bits with the specified carrier configuration and PDSCH configuration.

cws = randi([0 1],8000,1);
sym = nrPDSCH(carrier,pdsch,cws);

Add an additive white Gaussian noise (AWGN) to the PDSCH symbols. Then demodulate the symbols to produce soft-bit estimates.

SNR = 30; % SNR in dB
rxsym = awgn(sym,SNR);
[rxbits,symbols] = nrPDSCHDecode(carrier,pdsch,rxsym);

Input Arguments

sym — Received PDSCH modulation symbols

complex matrix

Received PDSCH modulation symbols, specified as a complex matrix of size N_RE-by-N_Layers. N_RE is the number of resource elements in a layer, and N_Layers is the number of layers. N_Layers determines the number of codewords in cws.

• If N_Layers is from 1 to 4, the function returns one codeword in cws.

• If N_Layers is from 5 to 8, the function returns two codewords in cws.

Data Types: single | double
Complex Number Support: Yes

mod — Modulation scheme

'QPSK' | '16QAM' | '64QAM' | '256QAM' | '1024QAM' | string array | cell array of character vectors

Modulation scheme, specified as 'QPSK', '16QAM', '64QAM', '256QAM', '1024QAM', a string array, or a cell array of character vectors. This modulation scheme specifies the modulation type of the codewords and the number of bits used per modulation symbol. If cws contains two codewords, the modulation scheme applies to both codewords. Alternatively, you can specify different modulation schemes for each codeword by using a string array or a cell array of character vectors.

Modulation Scheme	Number of Bits Per Symbol
'QPSK'	2
'16QAM'	4
'64QAM'	6
'256QAM'	8
'1024QAM'	10

Example: To specify different modulation schemes for two codewords, you can use any of these formats: {'QPSK','16QAM'} or ["QPSK","16QAM"].

Data Types: char | string | cell

nid — Scrambling identity

integer

Scrambling identity, specified as an integer from 0 to 1023. nid is the physical layer cell identity number (0 to 1007) or higher layer parameter dataScramblingIdentityPDSCH (0 to 1023). For more information, see TS 38.331 Section 6.3.2.

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

nVar — Noise variance

1e-10 (default) | nonnegative numeric scalar

Noise variance, specified as a nonnegative numeric scalar. The soft bits are scaled with the variance of additive white Gaussian noise (AWGN). The default value corresponds to an SNR of 100 dB, assuming unit signal power.

Note

The default value assumes the decoder and coder are connected back-to-back, where the noise variance is zero. To avoid -Inf or +Inf values in the output, the function uses 1e-10 as the default value for noise variance. To get appropriate results when the signal is transmitted through a noisy channel, adjust the noise variance accordingly.

Data Types: double | single

carrier — Carrier configuration parameters

nrCarrierConfig object

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

pdsch — PDSCH configuration parameters

nrPDSCHConfig object

PDSCH configuration parameters, specified as an nrPDSCHConfig object. This function uses only these nrPDSCHConfig object properties.

• Modulation

• NID

• RNTI

Output Arguments

cws — Approximate LLR soft bits

cell array of real column vectors

Approximate log likelihood ratio (LLR) soft bits, returned as a cell array of one or two real column vectors. The column vectors in cws have the same data type as sym. The number of column vectors depends on the number of layers in sym. The signs in the output values represent the hard bits.

Data Types: cell

symbols — Symbol constellation for each codeword

cell array of one or two column vectors of complex numbers

Symbol constellation for each codeword in cws, returned as a cell array of one or two column vectors of complex numbers. The column vectors in symbols have the same data type as sym.

Data Types: cell

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

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™. (since R2024b)

The nrPDSCHDecode function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Version History

Introduced in R2018b

R2024b: GPU array support

The nrPDSCHDecode function adds support for GPU arrays. For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

R2023a: Release 17 updates for 1024QAM

The function now supports 1024QAM modulation.