umtsUplinkWaveformGenerator

UMTS uplink waveform generation

Syntax

waveform = umtsUplinkWaveformGenerator(config)

Description

waveform = umtsUplinkWaveformGenerator(config) returns the Universal Mobile Telecommunications Service (UMTS) uplink waveform defined by the configuration structure, config. This function supports Wideband Code Division Multiple Access (W-CDMA), High-Speed Uplink Packet Access (HSUPA), and Evolved High-Speed Uplink Packet Access (HSPA+) waveform generation. The top-level parameters and lower-level substructures of config characterize the waveform and channel properties of the umtsUplinkWaveformGenerator function output. The config input is generated using the umtsUplinkReferenceChannels function; config includes top-level parameters and substructures to describe the different channels to include in the waveform. The top-level parameters of config are: TotFrames, ScramblingCode, FilterType, OversamplingRatio, and NormalizedPower. To enable the specific channels, you can add associated substructures: DPDCH, DPCCH, HSUPA, and HSDPCCH.

Examples

UMTS Uplink Waveform Generation

Initialize an 'RMC384kbps' reference channel and generate the UMTS waveform that corresponds to these settings.

Generate the configuration structure, config.

rc = 'RMC384kbps';
config = umtsUplinkReferenceChannels(rc);

Generate the desired waveform using config as the input to the waveform generation function. Create a spectrum analyzer object sampling at chiprate x OversamplingRatio. Plot the waveform.

waveform = umtsUplinkWaveformGenerator(config);
saScope = dsp.SpectrumAnalyzer('SampleRate', 3.84e6*config.OversamplingRatio);
saScope(waveform);

Input Arguments

config — Definition of the channels included for the waveform generator

structure

Top-Level Parameters and Substructures

Definition of the channels included by the waveform generator, specified as a structure.

Parameter Field	Required or Optional	Values	Description
TotFrames	Required	Positive integer	Total number of frames to be generated, specified as a positive integer.
ScramblingCode	Required	Nonnegative integer	Scrambling code index used by user equipment (UE), specified as a nonnegative integer in the interval [0, 224–1].
FilterType	Required	'RRC' (default), or 'Off'	Enable or disable the RRC Filter by specifying FilterType as 'RRC' or 'Off', respectively.
OversamplingRatio	Required	Positive integer	Oversampling ratio, specified as a positive integer.
NormalizedPower	Required	Float, –inf, inf, 'Off'	Overall waveform power in dBW relative to 1 ohm, specified as a float, –inf, inf, or 'Off'. Disable power normalization by specifying NormalizedPower as 'Off'.
DPDCH	Optional	Not present or structure	See DPDCH Substructure.
DPCCH	Optional	Not present or structure	See DPCCH Substructure.
HSUPA	Optional	Not present or structure	See HSUPA Substructure.
HSDPCCH	Optional	Not present or structure	See HSDPCCH Substructure.

DPDCH Substructure

To add the dedicated physical data channel (DPDCH) to the output structure, include the DPDCH substructure in the config structure. The DPDCH substructure contains the following fields.

Parameter Field	Required or Optional	Values	Description
Enable	Required	'On', 'Off'	Enable or disable the channel by specifying Enable as 'On' or 'Off, respectively.
SlotFormat	Required	Nonnegative integer	DPDCH slot format number, specified as 0, 1, 2, 3, 4, 5, or 6.
CodeCombination	Required	Nonnegative integer, vector	Valid spreading factors, specified as a power of two or a vector of powers of two in the interval [4, 256].
Power	Required	Float, –inf, inf	Channel power in dB, specified as a float, –inf, or inf.
DataSource	Required	Scalar, vector, character vector, cell array, string scalar	DPDCH data source, specified as a scalar, vector, cell array, or string scalar. When defined as a cell array, use standard PN sequences and a seed value: {PN, seed}. PN options for character vector or cell array are 'PN9-ITU', 'PN9', 'PN11', 'PN15', and 'PN23'. If no seed is specified, the shift register is initialized with all ones. To enable transport channel coding, specify DataSource as 'CCTrCH'.
CCTrCH	Optional	Structure	See CCTrCH Substructure.

CCTrCH Substructure

The CCTrCH substructure is associated with the DPDCH physical channel definition substructures. The CCTrCH substructure contains the following fields.

Parameter Field	Required or Optional	Values	Description
Name	Optional	Character vector, string scalar Default depends on the physical channel specified	Name assigned to the CCTrCH, specified as a character vector or a string scalar. Functions do not use the Name field. Therefore, you can redefine the content with no consequence.
TrCH	Required	Structure, structure array	Transport channels in the CCTrCH, specified as a structure or a structure array.
TrCH.Name	Required	Character vector or string scalar Default depends on the physical channel specified	Name assigned to the TrCH, specified as a character vector or a string scalar. Functions do not use the Name field. Therefore, you can redefine the content with no consequence.
TrCH.CRC	Required	Character vector, string scalar	Cyclic redundancy check (CRC) polynomial specifier, specified as one of these values: '0', '8', '12', '16', or '24'.
TrCH.TTI	Required	Positive integer	Transmission Time Interval (TTI) in ms, specified as 10, 20, 40, or 80.
TrCH.CodingType	Required	'turbo', 'conv2', 'conv3'	Channel coding type and rate, specified as 'turbo', 'conv2', or 'conv3'.
TrCH.RMA	Required	Positive integer	Rate matching attribute value, specified as a positive integer in the interval [1, 256].
TrCH.DataSource	Required	Binary scalar, binary vector, character vector, cell array, or string scalar	Transport channel data source, specified as a binary scalar, a vector with binary entries, a cell array, or a string scalar. When defined as a cell array use standard PN sequences and a seed value: {PN, seed}. PN options for character vector or cell array are 'PN9-ITU', 'PN9', 'PN11', 'PN15', and 'PN23'. If no seed is specified, the shift register is initialized with all ones.
		Examples for setting the DataSource field include: ...CCTrCH.TrCh(1).DataSource = [1 0 0 1], generates a sequence of transport blocks by looping the vector [1 0 0 1]. ...CCTrCH.TrCh(1).DataSource = 'PN9', generates a physical channel data block with random seed = 511. ...CCTrCH.TrCh(1).DataSource = {'PN9',5}, generates a physical channel data block with seed = 5.
TrCH.ActiveDynamicPart	Required	Positive integer, vector	Active dynamic part, specified as a positive integer or a vector whose entries are positive integers in the interval [1, length(DynamicPart)].
		The ActiveDynamicPart field indicates the DynamicPart array index for the active transport format (BlockSize, BlockSetSize) from available combinations defined in DynamicPart. The selected transport format is used for data transmission in the current TTI.
TrCH.DynamicPart	Required	Structure, structure array	Size of each transport block, specified as a structure or a structure array.
		The DynamicPart fields, BlockSize and BlockSetSize, define the size of each transport block and the total bits per transport block set. As a pair (BlockSize, BlockSetSize) describe a transport format set. DynamicPart defines one or multiple transport format sets.
TrCH.DynamicPart.BlockSize	Required	Positive integer	Transport block length, specified as a positive integer.
TrCH.DynamicPart.BlockSetSize	Required	Integer, multiple of BlockSize	Total number of bits in the transport block set. Implementation does not support multiple transport blocks, so by definition BlockSize is equal to BlockSetSize.

DPCCH Substructure

To add the dedicated physical control channel (DPCCH) to the output structure, include the DPCCH substructure in the config structure. The DPCCH substructure contains the following fields.

Parameter Field	Required or Optional	Values	Description
Enable	Required	'On', 'Off'	Enable or disable the channel by setting Enable to 'On' or 'Off', respectively.
SlotFormat	Required	Nonnegative integer	DPCCH slot format number, specified as 0, 1, 2, 3, 4, or 5.
Power	Required	Float, –inf, inf	DPCCH power in dB, specified as a float, –inf, or inf.
TPCData	Required	Binary scalar, binary vector	Transmit power control data, specified as a binary scalar or a vector with binary entries.
TFCI	Required	Nonnegative integer	Transport format combination indicator, specified as a nonnegative integer in the interval [0, 1023].
FBIData	Required	Binary scalar, binary vector	Feedback information data, specified as a binary scalar or a vector with binary entries.

HSUPA Substructure

To add the high-speed uplink packet access (HSUPA) information and channels to the output structure, include the HSUPA substructure in the config structure. The HSUPA substructure contains the following fields.

Parameter Field	Required or Optional	Values	Description
Enable	Required	'On', 'Off'	Enable or disable the channel by specifying Enable as 'On' or 'Off', respectively.
CodeCombination	Required	Positive integer, vector	Valid one-code combinations for BPSK modulation are: 2, 4, 8, 16, 32, 64, 128, and 256. Valid two-code combinations for BPSK modulation are [2 2] and [4 4]. The valid four-code combination for BPSK and 4PAM modulation is [2 2 4 4].
EDPDCHPower	Required	Float, –inf, inf	E-DPDCH channel power in dB, specified as a float, –inf, or inf.
EDPCCHPower	Required	Float, –inf, inf	E-DPCCH channel power in dB, specified as a float, –inf, or inf.
RSNSequence	Required	Vector	Retransmission sequence numbers, specified as a vector whose entries are 0, 1, 2, or 3. The length of this vector determines the number of retransmissions.
ETFCI	Required	Nonnegative integer	E-TFCI value, specified as a nonnegative integer in the interval [0, 127].
HappyBit	Required	0 or 1	Happy bit, specified as 0 or 1.
DataSource	Required	Scalar, vector, character vector, cell array, or string scalar	E-DPDCH data source, specified as a binary scalar, a vector with binary entries, a character vector, a cell array, or a string scalar. When specifying DataSrouce as a cell array, use standard PN sequences and a seed value: {PN, seed}. PN options for character vector or cell array are 'PN9-ITU', 'PN9', 'PN11', 'PN15', and 'PN23'. If no seed is specified, the shift register is initialized with all ones. To enable transport channel coding, specify DataSource as 'EDCH'.
EDCH	Required	Structure	Enhanced dedicated channel (EDCH), specified as a structure.
EDCH.BlockSize	Required	Nonnegative integer	Transport block size, specified as a nonnegative integer.
EDCH.TTI	Required	2, 10	Transmission Time Interval (TTI), in ms, specified as 2 or 10.
EDCH.Modulation	Required	'BPSK', '4PAM'	Modulation scheme, specified as 'BPSK' or '4PAM'.
EDCH.DataSource	Required	Scalar, vector, character vector, cell array, or string scalar	E-DCH transport data source, specified as a binary scalar, a vector with binary entries, a character vector, a cell array, or a string scalar. When specifying DataSource as a cell array, use standard PN sequences and a seed value: {PN, seed}. PN options for character vector or cell array are 'PN9-ITU', 'PN9', 'PN11', 'PN15', and 'PN23'. If no seed is specified, the shift register is initialized with all ones.

HSDPCCH Substructure

Include HSDPCCH substructure in config structure To add the high speed dedicated physical control channel (HS-DPCCH) to the output structure. The HSDPCCH substructure contains the following fields.

Parameter Field	Required or Optional	Values	Description
Enable	Required	'On', 'Off'	Enable or disable the channel by specifying Enable as 'On' or 'Off', respectively.
Power	Required	Float, –inf, inf	HS-DPCCH channel power in dB, specified as a float, –inf, or inf.
CQI	Required	Nonnegative integer, vector	CQI values, specified as a nonnegative integer or a vector whose entries are nonnegative integers in the interval [0, 30].
HARQACK	Required	Nonnegative integer, vector	HARQACK messages, specified as a nonnegative integer or a vector whose entries are nonnegative integers in the interval [0, 3].
UEMIMO	Required	0, 1	Flag to indicate MIMO mode, specified as 0 or 1.

Output Arguments

waveform — Modulated baseband waveform containing the UMTS physical channels

complex vector array

Modulated baseband waveform containing the UMTS physical channels, returned as a complex vector array, sampled at (3.84 × config.OversamplingRatio) MHz.

Data Types: double
Complex Number Support: Yes

References

[1] 3GPP TS 25.101. “Universal Mobile Telecommunications System (UMTS); User Equipment (UE) Radio Transmission and Reception (FDD).” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.

[2] 3GPP TS 25.141. “Universal Mobile Telecommunications System (UMTS); Base Station (BS) Conformance Testing (FDD).” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.