Documentation

lteTestModelTool

Syntax

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

Description

````lteTestModelTool` starts the Wireless Waveform Generator app for the parameterization and generation of the E-UTRA test model (E-TM) waveforms.```

example

``````[waveform,grid,tm] = lteTestModelTool(tmn,bw,ncellid,duplexmode)``` accepts inputs for the test model number and channel bandwidth for the generated waveform. Optionally, accepts inputs for the physical cell identity and duplex mode.```

example

``````[waveform,grid,tm] = lteTestModelTool(tm)``` where a user-defined test model configuration structure is provided as an input. ```

Examples

collapse all

Generate a time domain signal, `txWaveform`, and a 2-dimensional array of the Resource Elements, `txGrid`, for Test Model TS 36.141 E-TM 2a with 10MHz bandwidth. This is a 256QAM E-TM.

Specify test model number and bandwidth. Generate `txWaveform`. Plot the `txGrid` output.

```[txWaveform,txGrid,tm] = lteTestModelTool('2a','10MHz'); plot(txGrid,'.')```

The plot of all the complex resource element symbols in the frame is dominated by the 256QAM PDSCH constellation.

Generate a time domain signal, `txWaveform`, and a 2-dimensional array of the Resource Elements, `txGrid`, for Test Model TS 36.141 E-TM 3.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 analyzer.

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

Input Arguments

collapse all

Test model number, specified as a character vector or string scalar. Use double quotes for string. For more information on these test model numbers, see TS 36.141 [1], Section 6.1.

Example: `'3.2'`

Data Types: `char` | `string`

Channel bandwidth, specified as a character vector or string scalar. Use double quotes for 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` | `string`

Physical layer cell identity, specified as an integer. 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`

Duplex mode of the generated waveform, specified as `'FDD'` or `'TDD'`. Optional.

Example: `'FDD'`

Data Types: `char` | `string`

User-defined test model configuration, specified as a scalar structure. You can use `lteTestModel` to generate 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

Generated E-TM time-domain waveform, returned as a T-by-P numeric matrix, where P is the number of antennas and T is the number of time-domain samples. TS 36.141 [1], Section 6 fixes P = 1, making `waveform` a T-by-1 column vector.

Data Types: `double`
Complex Number Support: Yes

Resource grid, returned as a 2-D numeric array of resource elements for a number of subframes across a single antenna port. The number of subframes (10 for FDD and 20 for TDD), start from subframe zero, across a single antenna port, as specified in TS 36.141 [1], Section 6.1. Resource grids are populated as described in Representing Resource Grids.

Data Types: `double`
Complex Number Support: Yes

E-UTRA test model (E-TM) configuration, returned as a scalar structure. `tm` contains the following fields.

Test model configuration, returned as a scalar structure containing information about the OFDM modulated waveform as described in `lteOFDMInfo` and test model specific configuration parameters as described in `lteTestModel`. These fields are included in the output structure:

Parameter FieldValuesDescription
`TMN``'1.1'`, `'1.2'`, `'2'`, `'2a'`, `'2b'`, `'3.1'`, `'3.1a'`, `'3.1b'` `'3.2'`, `'3.3'`

Test model number

`BW`

`'1.4MHz'`, `'3MHz'`, `'5MHz'`, `'10MHz'`, `'15MHz'`, `'20MHz'`, `'9RB'`, `'11RB'`, `'27RB'`, `'45RB'`, `'64RB'`, `'91RB'`,

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

`NDLRB`

Nonnegative integer

Number of downlink resource blocks. (${N}_{\text{RB}}^{\text{DL}}$)

`CellRefP`1

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

`NCellID`

Integer from 0 to 503

Physical layer cell identity

`CyclicPrefix``'Normal'`

Cyclic prefix length. This argument is for informational purposes and is read-only.

`CFI`1, 2, or 3

Control format indicator value

`Ng`

`'Sixth'`, `'Half'`, `'One'`, `'Two'`

HICH group multiplier

`PHICHDuration`

`'Normal'`, `'Extended'`

PHICH duration

`NSubframe`

0 (default), nonnegative scalar integer

Subframe number

This argument is for informational purposes and is read-only.

`TotSubframes`

Nonnegative scalar integer

Total number of subframes to generate

`Windowing`

Nonnegative scalar integer

Number of time-domain samples over which windowing and overlapping of OFDM symbols is applied

`DuplexMode`

`'FDD'` (default), `'TDD'`

Duplexing mode, specified as:

• `'FDD'` for Frequency Division Duplex or

• `'TDD'` for Time Division Duplex

`CellRSPower`

Numeric value

Cell-specific reference symbol power adjustment, in dB

`PDSCH`

Scalar structure

PDSCH transmission configuration substructure

`PSSPower`

Numeric value

Primary synchronization signal (PSS) symbol power adjustment, in dB

`SSSPower`

Numeric value

Secondary synchronization signal (SSS) symbol power adjustment, in dB

`PBCHPower`

Numeric value

PBCH symbol power adjustment, in dB

`PCFICHPower`

Numeric value

PCFICH symbol power adjustment, in dB

`NAllocatedPDCCHREG`

Nonnegative integer

Number of allocated PDCCH REGs. This argument is derived from `tmn` and `bw`.

`PDCCHPower`

Numeric value

PDCCH symbol power adjustment, in dB

`PDSCHPowerBoosted`

Numeric value

PDSCH symbol power adjustment, in dB, for the boosted physical resource blocks (PRBs)

`PDSCHPowerDeboosted`

Numeric value

PDSCH symbol power adjustment, in dB, for the de-boosted physical resource blocks (PRBs)

These fields are present only when `DuplexMode` is set to `'TDD'`.
`SSC`

Integer from 0 to 9

8 (default)

Special subframe configuration (SSC)

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

`TDDConfig`

Integer from 1 to 6

3 (default)

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

`AllocatedPRB`

Numeric array

Allocated physical resource block list

`SamplingRate`

Numeric value

Sampling rate of the time-domain waveform

`Nfft`

Positive integer

Number of fast Fourier transform (FFT) points

PDSCH substructure

The substructure PDSCH relates to the physical channel configuration and contains these fields:

Parameter FieldValuesDescription
`NLayers``1`

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

`TxScheme``'Port0'`

Transmission scheme. The E-TMs have a single antenna port. This argument is for informational purposes and is read-only.

`Modulation`

Cell array of one or two character vectors. Valid values of character vectors include: `'QPSK'`, `'16QAM'`, `'64QAM'`, `'256QAM'`, `'1024QAM'`

Modulation formats, specifying the modulation formats for boosted and deboosted PRBs. This argument is for informational purposes and is read-only.

Data Types: `struct`

Compatibility Considerations

expand all

Behavior changed in R2019b

Errors starting in R2019b

References

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

[2] 3GPP TS 36.211. “Evolved Universal Terrestrial Radio Access (E-UTRA); Physical Channels and Modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.