Main Content

lteTestModel

Downlink test model configuration structure

Description

example

tm = lteTestModel(tmn,bw) returns the E-UTRA test model (E-TM) configuration structure for given test model number and bandwidth. The output structure, tm, contains the configuration parameters required to generate a given downlink E-TM waveform using the generator tool, lteTestModelTool. The field names and default values align with those defined in TS 36.141 [1], Section 6.1.

The PDSCH is a substructure relating to the physical channel configuration and contains the fields NLayers, TxScheme, and Modulation.

tm = lteTestModel(tmn,bw,ncellid,duplexmode) controls the configuration of the physical cell identity, ncellid, and duplex mode, duplexmode.

tm = lteTestModel(tmcfg) returns tm, a configuration structure for the test model partially (or wholly) defined by the input structure tmcfg. The input structure tmcfg can define any (or all) of the parameters or substructure parameters and the output structure tm retains the defined parameters. The undefined fields are given appropriate default values.

The tm structure can be used with the E-TM generator tool to generate a waveform.

Examples

collapse all

Create the configuration structure for Test Model TS 36.141 E-TM 3.2, 20MHz.

Specify an E-TM 3.2 test model number and 20-MHz channel bandwidth. Create a test model configuration structure and view the contents.

tmn = '3.2';
bw  = '20MHz';
tm = lteTestModel(tmn, bw)
tm = struct with fields:
                    TMN: '3.2'
                     BW: '20MHz'
                  NDLRB: 100
               CellRefP: 1
                NCellID: 1
           CyclicPrefix: 'Normal'
                    CFI: 1
                     Ng: 'Sixth'
          PHICHDuration: 'Normal'
              NSubframe: 0
           TotSubframes: 10
              Windowing: 0
             DuplexMode: 'FDD'
                  PDSCH: [1x1 struct]
            CellRSPower: 0
               PSSPower: 2.4260
               SSSPower: 2.4260
              PBCHPower: 2.4260
            PCFICHPower: 0
     NAllocatedPDCCHREG: 180
             PDCCHPower: 1.1950
      PDSCHPowerBoosted: 2.4260
    PDSCHPowerDeboosted: -3
                   Nfft: []

tm.PDSCH
ans = struct with fields:
      TxScheme: 'Port0'
    Modulation: {'16QAM'  'QPSK'}
       NLayers: 1

Input Arguments

collapse all

Test model number, specified as a character vector or string scalar. Use double quotes for string. See TS 36.141 [1] for information on the test models.

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.

Data Types: char | string

Physical layer cell identity, specified as an integer from 0 to 503. If not specified, defaults to 1 for standard bandwidths and 10 for non-standard bandwidths.

Data Types: double

Duplex mode, specified as 'FDD' or 'TDD'.

Data Types: char | string

Test model configuration, specified as a scalar structure. Refer to the output tm for structure fields. Define any or all listed parameters or substructure parameters in the input structure, tmcfg. The output structure, tm, retains the defined parameters and appropriate defaults are assigned for undefined fields.

Data Types: struct

Output Arguments

collapse all

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

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, in MHz, returned as a character vector. Nonstandard bandwidths '9RB', '11RB', '27RB', '45RB', '64RB', and '91RB' specify custom test models.

NDLRB

Nonnegative integer

Number of downlink resource blocks (NRBDL)

CellRefP1

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.

CFI1, 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

NfftPositive integerNumber of IFFT points used in the OFDM modulation
DuplexMode

'FDD' (default), 'TDD'

Duplexing mode, specified as either:

  • 'FDD' for Frequency Division Duplex

  • '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)

Uplink-downlink configuration

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

PDSCH Substructure

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

Parameter FieldValuesDescription
NLayers1

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

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.

Version History

Introduced in R2014a

expand all