nrPUSCH

Generate PUSCH modulation symbols

collapse all in page

Syntax

sym = nrPUSCH(cw,mod,nLayers,nid,rnti)

sym = nrPUSCH(___,transformPrecode,mrb)

sym = nrPUSCH(___,txScheme,nPorts,tpmi)

sym = nrPUSCH(carrier,pusch,cw)

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

Description

example

sym = nrPUSCH(cw,mod,nLayers,nid,rnti) returns physical uplink shared channel (PUSCH) modulation symbols, as defined in TS 38.211 Sections 6.3.1.1 to 6.3.1.5 [1]. The process consists of scrambling with scrambling identity nid, performing symbol modulation with modulation scheme mod, and layer mapping. cw specifies an uplink shared channel (UL-SCH) codeword, as described in TS 38.212 Section 6.2.7 [2]. nLayers specifies the number of transmission layers. rnti is the radio network temporary identifier (RNTI) of the user equipment (UE).

sym = nrPUSCH(___,transformPrecode,mrb) specifies transform precoding as a logical value in addition to the input arguments in the first syntax. When transformPrecode is set to true, the function applies the transform precoding defined in TS 38.211 Section 6.3.1.4. mrb specifies the allocated number of PUSCH resource blocks.

example

sym = nrPUSCH(___,txScheme,nPorts,tpmi) specifies the transmission scheme in addition to the input arguments in the second syntax. When txScheme is set to 'codebook', the function performs multi-input multi-output (MIMO) precoding based on the specified number of layers nLayers, number of antenna ports nPorts, and the transmitted precoding matrix indicator (TPMI) tpmi.

example

sym = nrPUSCH(carrier,pusch,cw) returns PUSCH modulation symbols for the specified carrier configuration carrier and PUSCH configuration pusch. The input cw specifies an uplink shared channel (UL-SCH) codeword.

sym = nrPUSCH(___,'OutputDataType',datatype) specifies the PUSCH symbol data type in addition to the input arguments in any of the previous syntaxes.

Examples

collapse all

Generate PUSCH Modulation Symbols

Open Live Script

Specify a random sequence of binary values corresponding to a codeword of 8064 bits.

cw = randi([0 1],8064,1);

Using 16-QAM modulation, generate PUSCH modulation symbols for the specified physical layer cell identity number, RNTI, and two transmission layers. By default, the function disables transform precoding and noncodebook-based transmission.

modulation = '16QAM';
nlayers = 2;
ncellid = 17;
rnti = 111;
sym = nrPUSCH(cw,modulation,nlayers,ncellid,rnti)

sym = 1008×2 complex

  -0.9487 - 0.9487i  -0.3162 + 0.3162i
   0.3162 + 0.3162i  -0.9487 - 0.3162i
   0.3162 + 0.3162i   0.3162 - 0.3162i
   0.9487 - 0.3162i  -0.3162 + 0.9487i
  -0.3162 - 0.9487i   0.3162 - 0.9487i
  -0.3162 + 0.9487i   0.3162 - 0.3162i
   0.3162 + 0.3162i   0.9487 - 0.9487i
  -0.9487 + 0.9487i  -0.3162 + 0.3162i
   0.9487 - 0.9487i  -0.9487 - 0.3162i
  -0.9487 - 0.9487i   0.3162 + 0.9487i
      ⋮

Generate PUSCH Symbols Using Codebook-Based Transmission

Open Live Script

Specify a random sequence of binary values corresponding to a codeword of 8064 bits.

cw = randi([0 1],8064,1);

Using 256-QAM modulation, generate PUSCH modulation symbols for the specified physical layer cell identity number, RNTI, bandwidth, and one transmission layer. Enable transform precoding and codebook-based transmission based on the specified TPMI and four antennas.

modulation = '256QAM';
ncellid = 17;
rnti = 111;
mrb = 6;
nlayers = 1;
transformPrecode = true;
txScheme = 'codebook';
tpmi = 1;
nports = 4;
sym = nrPUSCH(cw,modulation,nlayers,ncellid,rnti,transformPrecode,mrb,txScheme,nports,tpmi)

sym = 1008×4 complex

   0.0000 + 0.0000i   0.2169 + 0.2350i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   0.2296 + 0.3713i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i  -0.0797 - 0.9008i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i  -0.4767 - 0.0143i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   0.4124 + 0.2638i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i  -0.1433 - 0.2366i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   0.0885 - 0.1080i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   0.5507 - 0.1894i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i  -0.3039 - 0.9165i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i  -0.1498 + 0.3356i   0.0000 + 0.0000i   0.0000 + 0.0000i
      ⋮

Generate PUSCH Symbols and Indices

Open Live Script

Create a carrier configuration object with default properties. This object corresponds to 30 kHz of subcarrier spacing and 20 MHz transmission bandwidth.

carrier = nrCarrierConfig;
carrier.SubcarrierSpacing = 30;
carrier.NSizeGrid = 51;

Create a PUSCH configuration object with specified properties. When transform precoding is 1, the waveform type is discrete fourier transform spread orthogonal frequency division multiplexing (DFT-s-OFDM).

pusch = nrPUSCHConfig;
pusch.NStartBWP = 10;
pusch.NSizeBWP = 41;
pusch.Modulation = '16QAM';
pusch.NID = []; % Set NID equal to the NCellID property of carrier.
pusch.PRBSet = 0:5;
pusch.TransformPrecoding = 1;
pusch.FrequencyHopping = 'intraSlot';
pusch.SecondHopStartPRB = 3;

Generate PUSCH indices, setting the index orientation with respect to the carrier grid.

[ind,info] = nrPUSCHIndices(carrier,pusch,'IndexOrientation','carrier')

ind = 864x1 uint32 column vector

   121
   122
   123
   124
   125
   126
   127
   128
   129
   130
      ⋮

info = struct with fields:
                G: 3456
               Gd: 864
        NREPerPRB: 144
    DMRSSymbolSet: [2 7]
    PTRSSymbolSet: [1x0 double]

Generate PUSCH symbols of data type single.

numDataBits = info.G;
cws = randi([0 1],numDataBits,1);
sym = nrPUSCH(carrier,pusch,cws,'OutputDataType','single')

sym = 864x1 single column vector

  -0.7454 + 0.2981i
   0.3406 - 0.2312i
  -0.1153 + 0.2756i
   1.1921 - 0.3658i
  -0.3968 - 0.0277i
  -0.8788 - 0.6493i
  -0.8737 + 0.8318i
  -0.5764 + 0.0269i
  -1.6638 + 0.0482i
  -1.0270 - 0.1347i
      ⋮

Plot the generated symbols and indices on the carrier resource grid.

grid = complex(zeros([carrier.NSizeGrid*12 carrier.SymbolsPerSlot pusch.NumLayers]));
grid(ind) = sym;
imagesc(abs(grid(:,:,1)));
axis xy;
xlabel('OFDM Symbols');
ylabel('Subcarriers');
title('PUSCH Resource Elements in Carrier Resource Grid');

Input Arguments

collapse all

`cw` — UL-SCH codeword
column vector of integers from –2 to 1

UL-SCH codeword from TS 38.212 Section 6.2.7, specified as a column vector of integers from –2 to 1.

0 and 1 represent false and true bit values, respectively.
–1 and –2 represent x and y placeholders in the uplink control information (UCI), respectively. For more details, see TS 38.212 Sections 5.3.3.1 and 5.3.3.2.

Data Types: double | int8

`mod` — Modulation scheme
`'pi/2-BPSK'` | `'QPSK'` | `'16QAM'` | `'64QAM'` | `'256QAM'`

Modulation scheme, specified as 'pi/2-BPSK', 'QPSK', '16QAM', '64QAM', or '256QAM'. This modulation scheme determines the modulation type and number of bits used per modulation symbol.

Modulation Scheme	Number of Bits Per Symbol
`'pi/2-BPSK'`	1
`'QPSK'`	2
`'16QAM'`	4
`'64QAM'`	6
`'256QAM'`	8

Data Types: char | string

`nLayers` — Number of transmission layers
integer from 1 to 4

Number of transmission layers, specified as an integer from 1 to 4. For more information, see TS 38.211 Section 6.3.1.3.

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 dataScramblingIdentityPUSCH, ranging from 0 to 1023, if the higher layer parameter is configured. Otherwise, nid is physical layer cell identity number NCellID, ranging from 0 to 1007. For more information, see TS 38.211 Section 6.3.1.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

`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

`mrb` — Number of allocated PUSCH resource blocks
integer from 1 to 275

Number of allocated PUSCH resource blocks, specified as an integer from 1 to 275. For more information, see TS 38.214 Section 6.1.2.

Data Types: double

`txScheme` — Transmission scheme
`'nonCodebook'` (default) | `'codebook'`

Transmission scheme, specified as one of these values:

'nonCodebook' — Use this option to disable MIMO precoding.
'codebook' — Use this option for codebook-based transmission using MIMO precoding.

For more information, see TS 38.211 Section 6.3.1.4.

Data Types: char | string

`tpmi` — Transmitted precoding matrix indicator
integer from 0 to 27

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

Data Types: double

`nPorts` — Number of antenna ports
`1` | `2` | `4`

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

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

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

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

Property Field	Values	Description
`NCellID`	1 (default), integer from 0 to 1007	Physical layer cell identity

`pusch` — PUSCH configuration parameters
`nrPUSCHConfig` object

PUSCH configuration parameters for a specific OFDM numerology, specified as an nrPUSCHConfig object. This function only uses these nrPUSCHConfig object properties.

Property Field	Values	Description
`Modulation`	'QPSK', '16QAM', '64QAM', or '256QAM', 'pi/2-BPSK', string scalar, or character array	Modulation scheme of codeword
`NumLayers`	1 (default), integer from 1 to 4	Number of transmission layers
`NID`	`[]` (default), integer from 0 to 1023	Scrambling identity, specified as an integer from 0 to 1023. Use `[]` value to allow this property to be equal to `NCellID` of `carrier` input.
`RNTI`	1 (default), integer from 0 to 65,535	Radio network temporary identifier of the user equipment
`TransformPrecoding`	0 (default), 1	Transform precoding flag, specified as one of these values. `0` — The transform precoding is disabled and waveform type is CP-OFDM. `1` — The transform precoding is enabled and waveform type is DFT-s-OFDM.
`PRBSet`	[0:51] (default), vector of nonnegative integers from 0 to 274	Physical resource blocks allocated for the shared channel within a BWP (0-based)
`TransmissionScheme`	`'nonCodebook'` (default), `'codebook'`	PUSCH transmission scheme
`NumAntennaPorts`	1 (default), 2, or 4	Number of antenna ports
`TPMI`	0 (default), integer from 0 to 27	Transmitted precoding matrix indicator

Output Arguments

collapse all

`sym` — PUSCH modulation symbols
complex matrix

PUSCH modulation symbols, returned as a complex matrix. If txScheme is set to 'codebook', the number of matrix columns is nPorts. If txScheme is set to 'nonCodebook', the number of matrix columns is nLayers.

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.212. “NR; Multiplexing and channel coding.” 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:

Names and values in name-value pair arguments must be compile-time constants. For example, to specify single data type for the output, 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.

Documentation

nrPUSCH

Syntax

Description

Examples

Generate PUSCH Modulation Symbols

Generate PUSCH Symbols Using Codebook-Based Transmission

Generate PUSCH Symbols and Indices

Input Arguments

`cw` — UL-SCH codeword
column vector of integers from –2 to 1

`mod` — Modulation scheme
`'pi/2-BPSK'` | `'QPSK'` | `'16QAM'` | `'64QAM'` | `'256QAM'`

`nLayers` — Number of transmission layers
integer from 1 to 4

`nid` — Scrambling identity
integer from 0 to 1023

`rnti` — RNTI of UE
integer from 0 to 65,535

`transformPrecode` — Transform precoding
`false` (default) | `true`

`mrb` — Number of allocated PUSCH resource blocks
integer from 1 to 275

`txScheme` — Transmission scheme
`'nonCodebook'` (default) | `'codebook'`

`tpmi` — Transmitted precoding matrix indicator
integer from 0 to 27

`nPorts` — Number of antenna ports
`1` | `2` | `4`

`datatype` — Data type of output symbols
`'double'` (default) | `'single'`

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

`pusch` — PUSCH configuration parameters
`nrPUSCHConfig` object

Output Arguments

`sym` — PUSCH modulation symbols
complex matrix

References

Extended Capabilities

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

See Also

Functions

Objects

5G Toolbox Documentation

Support

Documentation

nrPUSCH

Syntax

Description

Examples

Generate PUSCH Modulation Symbols

Generate PUSCH Symbols Using Codebook-Based Transmission

Generate PUSCH Symbols and Indices

Input Arguments

cw — UL-SCH codeword column vector of integers from –2 to 1

mod — Modulation scheme 'pi/2-BPSK' | 'QPSK' | '16QAM' | '64QAM' | '256QAM'

nLayers — Number of transmission layers integer from 1 to 4

nid — Scrambling identity integer from 0 to 1023

rnti — RNTI of UE integer from 0 to 65,535

transformPrecode — Transform precoding false (default) | true

mrb — Number of allocated PUSCH resource blocks integer from 1 to 275

txScheme — Transmission scheme 'nonCodebook' (default) | 'codebook'

tpmi — Transmitted precoding matrix indicator integer from 0 to 27

nPorts — Number of antenna ports 1 | 2 | 4

datatype — Data type of output symbols 'double' (default) | 'single'

carrier — Carrier configuration parameters nrCarrierConfig object

pusch — PUSCH configuration parameters nrPUSCHConfig object

Output Arguments

sym — PUSCH modulation symbols complex matrix

References

Extended Capabilities

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

See Also

Functions

Objects

5G Toolbox Documentation

Support

`cw` — UL-SCH codeword
column vector of integers from –2 to 1

`mod` — Modulation scheme
`'pi/2-BPSK'` | `'QPSK'` | `'16QAM'` | `'64QAM'` | `'256QAM'`

`nLayers` — Number of transmission layers
integer from 1 to 4

`nid` — Scrambling identity
integer from 0 to 1023

`rnti` — RNTI of UE
integer from 0 to 65,535

`transformPrecode` — Transform precoding
`false` (default) | `true`

`mrb` — Number of allocated PUSCH resource blocks
integer from 1 to 275

`txScheme` — Transmission scheme
`'nonCodebook'` (default) | `'codebook'`

`tpmi` — Transmitted precoding matrix indicator
integer from 0 to 27

`nPorts` — Number of antenna ports
`1` | `2` | `4`

`datatype` — Data type of output symbols
`'double'` (default) | `'single'`

`carrier` — Carrier configuration parameters
`nrCarrierConfig` object

`pusch` — PUSCH configuration parameters
`nrPUSCHConfig` object

`sym` — PUSCH modulation symbols
complex matrix

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