Documentation

lteTestModelTool

Downlink test model waveform generation

Syntax

  • [waveform,grid,tm] = lteTestModelTool
    example
  • [waveform,grid,tm] = lteTestModelTool(tmn,bw,ncellid,duplexmode)
  • [waveform,grid,tm] = lteTestModelTool(tm)
    example

Description

example

[waveform,grid,tm] = lteTestModelTool starts a user interface for the parameterization and generation of the E-UTRA test model (E-TM) waveforms. The main function outputs are specified in the GUI but can also be assigned to variables. waveform represents the generated E-TM time-domain waveform. It is a T-by-P array, where T is the number of time-domain samples and P is the number of antennas. TS 36.141, Section 6 [1] fixes P = 1, making waveform a T-by-1 column vector. grid, the populated resource grid, is a 2-D array of resource elements for a number of subframes (10 for FDD and 20 for TDD) across a single antenna port, as specified in TS 36.141, Section 6 [1] and described in Data Structures. tm is a structure containing information about the OFDM modulated waveform as described in lteOFDMInfo and test model specific configuration parameters as described in lteTestModel.

[waveform,grid,tm] = lteTestModelTool(tmn,bw,ncellid,duplexmode) returns the waveform, grid, and tm for the test model number tmn and channel bandwidth bw. The ncellid and duplexmode are the optional input parameters and define the physical cell identity and duplex mode of the generated waveform, respectively.

The input tmn is a string identifying the test model number as per [1].

example

[waveform,grid,tm] = lteTestModelTool(tm) where the input is the user-defined test model configuration structure tm as input parameter.

Examples

collapse all

Generate Downlink E-TM Waveform

Generate a time domain signal, txWaveform, and a 2-dimensional array of the Resource Elements, txGrid, for Test Model TS36.141 E-TM3.2 with 15MHz bandwidth.

Specify test model number and bandwidth for tmCfg configuration structure and create it. Generate txWaveform. View the waveform with a spectrum anaylzer.

tmn = '3.2';
bw = '15MHz';
tmCfg = lteTestModel(tmn,bw);
[txWaveform,txGrid,tm] = lteTestModelTool(tmCfg);
h = dsp.SpectrumAnalyzer('SampleRate', tm.SamplingRate);
step(h,txWaveform);

Launch LTE Test Model Generator Tool

Launch the tool to generate an E-UTRA Test Model (E-TM) waveform.

The LTE Downlink E-TM Generator dialog box appears for you to adjust as desired to generate E-TM waveforms.

lteTestModelTool;

Related Examples

Input Arguments

collapse all

tmn — Test model number'1.1' | '1.2' | '2' | '3.1' | '3.2' | '3.3'

Test model number, specified as a string. For more information on these test model numbers, see [1].

Example: '3.2'

Data Types: char

bw — Channel bandwidth'1.4MHz' | '3MHz' | '5MHz' | '10MHz' | '15MHz' | '20MHz' | '9RB' | '11RB' | '27RB' | '45RB' | '64RB' | '91RB'

Channel bandwidth, specified as a string. You can set the nonstandard bandwidths, '9RB','11RB','27RB','45RB','64RB', and '91RB', only when tmn is '1.1'. These nonstandard bandwidths specify custom test models.

Example: '15MHz'

Data Types: char

ncellid — Physical layer cell identity1 or 10 (default) | optional | scalar integer

Physical layer cell identity, specified as a scalar integer. Optional. If you do not specify this argument, the default is 1 for standard bandwidths and 10 for non-standard bandwidths.

Example: 1

Data Types: double

duplexmode — Duplex mode of the generated waveform'FDD' (default) | optional | 'TDD'

Duplex mode of the generated waveform, specified as a string. Optional.

Example: 'FDD'

Data Types: char

tm — User-defined test model configurationscalar structure

User-defined test model configuration, specified as a scalar structure. You can use lteTestModel generates the various tm configuration structures as per TS 36.141, Section 6 [1]. This configuration structure then can be modified as per requirements and used to generate the waveform.

Data Types: struct

Output Arguments

collapse all

waveform — Generated E-TM time-domain waveformnumeric matrix

Generated E-TM time-domain waveform, returned as a numeric matrix of size T-by-P. Where P is the number of antennas and T is the number of time-domain samples.

Data Types: double
Complex Number Support: Yes

grid — Resource gridnumeric matrix

Resource grid, returned as a numeric matrix. This argument is a 2-D array of resource elements for a number of subframes across a single antenna port.

Data Types: double
Complex Number Support: Yes

tm — Test model configurationscalar structure

Test model configuration, returned as a scalar structure. This argument contains information about the OFDM modulated waveform and test model configuration parameters.tm contains the following fields.

TMN — Test model number type'1.1' | '1.2' | '2' | '3.1' | '3.2' | '3.3'

Test model number type, returned as a string.

Data Types: char

BW — Channel bandwidth type'1.4MHz' | '3MHz' | '5MHz' | '10MHz' | '15MHz' | '20MHz' | '9RB' | '11RB' | '27RB' | '45RB' | '64RB' | '91RB'

Channel bandwidth type, in MHz, returned as a string. Non-standard bandwidths, '9RB','11RB','27RB','45RB','64RB', and '91RB', specify custom test models.

Data Types: char

NDLRB — Number of downlink resource blocks100 | nonnegative scalar integer

Number of downlink resource blocks, returned as a nonnegative scalar integer.

Data Types: double

CellRefP — Number of cell-specific reference signal antenna ports1

Number of cell-specific reference signal antenna ports, returned as 1. This argument is for informational purposes and is read-only.

Data Types: double

NCellID — Physical layer cell identityscalar integer

Physical layer cell identity, returned as a scalar integer.

Data Types: double

CyclicPrefix — Cyclic prefix length'Normal'

Cyclic prefix length, returned as the string, 'Normal'. This argument is for informational purposes and is read-only.

Data Types: char

CFI — Control format indicator value1 | 2 | 3

Control format indicator value, returned as a positive scalar integer. Valid values are 1, 2, and 3.

Data Types: double

Ng — HICH group multiplier'Sixth' | 'Half' | 'One' | 'Two'

HICH group multiplier, returned as a string.

Data Types: char

PHICHDuration — PHICH duration'Normal' | 'Extended'

PHICH duration, returned as a string.

Data Types: char

NSubframe — Subframe numbernonnegative scalar integer

Subframe number, returned as a nonnegative scalar integer.

Data Types: double

TotSubframes — Total number of subframes to be generatednonnegative scalar integer

Total number of subframes to be generated, returned as a nonnegative scalar integer.

Data Types: double

Windowing — Number of windowing samplesnonnegative scalar integer

Number of windowing samples, returned as a nonnegative scalar integer. This argument is the number of time-domain samples over which windowing and overlapping of OFDM symbols is applied.

Data Types: double

DuplexMode — Duplex mode'FDD' (default) | optional | 'TDD'

Duplex mode, returned as a string. Optional.

Data Types: char

TDDConfig — Present only for TDD duplex mode. Uplink/Downlink Configuration3 (default) | numeric scalar | 1...6

TDDConfig enumerates the subframe uplink-downlink configuration to be used in this frame. TS 36.211, Section 4.2 [2] specifies uplink-downlink configurations (uplink, downlink, and special subframe combinations).

Data Types: double

SSC — Present only for TDD duplex mode. Special Subframe Configuration8 (default) | numeric scalar | 1, ..., 9

SSC enumerates the special subframe configuration. TS 36.211, Section 4.2 [2] specifies the special subframe configurations (lengths of DwPTS, GP, and UpPTS).

Data Types: double

PDSCH — PDSCH transmission configurationscalar structure

PDSCH transmission configuration, returned as a scalar structure. PDSCH contains the following fields.

NLayers — Number of transmission layers1

Number of transmission layers, returned as 1. This argument is for informational purposes and is read-only.

Data Types: double

TxScheme — Transmission scheme'Port0'

Transmission scheme, returned as the string 'Port0'. This argument is for informational purposes and is read-only. The E-TMs have a single antenna port, Port 0.

Data Types: char

Modulation — Modulation formats{'QPSK'} | {'16QAM'} | {'64QAM'} | {'256QAM'} | cell array of one or two strings

Modulation formats, returned as a cell array of one or two strings specifying the modulation formats for boosted and deboosted PRBs.

Data Types: cell

Data Types: struct

CellRSPower — Cell-specific reference symbol power adjustmentnumeric scalar

Cell-specific reference symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

PSSPower — PSS symbol power adjustmentnumeric scalar

PSS symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

SSSPower — SSS symbol power adjustmentnumeric scalar

SSS symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

PBCHPower — PBCH symbol power adjustmentnumeric scalar

PBCH symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

PCFICHPower — PCFICH symbol power adjustmentnumeric scalar

PCFICH symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

NAllocatedPDCCHREG — Number of allocated PDCCH REGsnonnegative scalar integer

Number of allocated PDCCH REGs, returned as a nonnegative scalar integer. This argument is derived from TMN and BW.

Data Types: double

PDCCHPower — PDCCH symbol power adjustmentnumeric scalar

PDCCH symbol power adjustment, in dB, returned as a numeric scalar.

Data Types: double

PDSCHPowerBoosted — PDSCH symbol power adjustment for boosted PRBsnumeric scalar

PDSCH symbol power adjustment for boosted PRBs, in dB, returned as a numeric scalar.

Data Types: double

PDSCHPowerDeboosted — PDSCH symbol power adjustment for de-boosted PRBsnumeric scalar

PDSCH symbol power adjustment for de-boosted PRBs, in dB, returned as a numeric scalar.

Data Types: double

AllocatedPRB — Allocated PRB listnumeric scalar

Allocated PRB list, returned as a numeric scalar array.

Data Types: double

SamplingRate — Sampling ratenumeric scalar

Sampling rate, returned as a numeric scalar value.

Data Types: double

Nfft — Number of FFT points128 (default) | numeric scalar

Number of FFT points, returned as an unsigned integer.

Data Types: uint32

Data Types: struct

References

[1] 3GPP TS 36.141. "Base Station (BS) conformance testing." 3rd Generation Partnership Project; Technical Specification Group Radio Access Network; Evolved Universal Terrestrial Radio Access (E-UTRA). URL: http://www.3gpp.org.

[2] 3GPP TS 36.211. "Physical channels and modulation." 3rd Generation Partnership Project; Technical Specification Group Radio Access Network; Evolved Universal Terrestrial Radio Access (E-UTRA). URL: http://www.3gpp.org.

Introduced in R2014a

Was this topic helpful?