Documentation

lteTestModel

Downlink test model configuration structure

Syntax

  • tm = lteTestModel(tmn,bw)
    example
  • tm = lteTestModel(tmn,bw,ncellid,duplexmode)
  • tm = lteTestModel(tmcfg)

Description

example

tm = lteTestModel(tmn,bw) returns the E-UTRA test model (E-TM) configuration structure, tm for given test model number, tmn, and bandwidth, bw, as specified in TS 36.141 [1], Section 6. tm is a structure that contains the configuration parameters required to generate a given downlink E-TM waveform using the generator tool, lteTestModelTool. The field names and default values are in accordance with the definition found in TS 36.141 [1], Section 6.

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. tm must contain at least the TMN and BW fields.

Examples

collapse all

Create Downlink E-TM Configuration Structure

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

Specify test model number and bandwidth for tm configuration structure to be initialized. Create tm and view contents.

tmn = '3.2';
bw  = '20MHz';
tm = lteTestModel(tmn, bw)
tm.PDSCH
tm = 

                    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


ans = 

      TxScheme: 'Port0'
    Modulation: {'16QAM'  'QPSK'}
       NLayers: 1

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. See TS 36.141 [1] for information on the types.

Data Types: char

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

Channel bandwidth type, 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.

Data Types: char

ncellid — Physical layer cell identity1 for standard bandwidths and 10 for non-standard bandwidths (default) | optional | scalar integer | 0,...,503

Physical layer cell identity, specified as a scalar integer. If not specified, defaults to 1 for standard bandwidths and 10 for non-standard bandwidths.

Data Types: double

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

Duplex mode, specified as a string.

Data Types: char

tmcfg — Test model configurationscalar structure

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

tm — E-UTRA test model (E-TM) configurationscalar structure

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', '3.1', '3.2', '3.3'

Test model number type, returned as a string.

BW

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

NDLRB

Nonnegative scalar integer

Number of downlink (DL) resource blocks (RBs)

CellRefP1

Number of cell-specific reference signal antenna ports, returned as 1. 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, returned as the string, 'Normal'. This argument is for informational purposes and is read-only.

CFI1, 2, or 3

Control format indicator value, returned as a positive scalar integer.

Ng

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

HICH group multiplier

PHICHDuration

'Normal', 'Extended'

PHICH duration

NSubframe

Nonnegative integer

Subframe number.

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 scalar

Cell-specific reference symbol power adjustment, in dB

PSSPower

Numeric scalar

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

SSSPower

Numeric scalar

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

PBCHPower

Numeric scalar

PBCH symbol power adjustment, in dB

PCFICHPower

Numeric scalar

PCFICH symbol power adjustment, in dB

NAllocatedPDCCHREG

Nonnegative scalar integer

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

PDCCHPower

Numeric scalar

PDCCH symbol power adjustment, in dB

PDSCHPowerBoosted

Numeric scalar

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

PDSCHPowerDeboosted

Numeric scalar

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

The following fields are present only when DuplexMode is set to 'TDD'.
TDDConfig

Numeric scalar

3 (default)

1,...,6

Uplink or downlink configuration

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

SSC

Numeric scalar

8 (default)

1,...,9

Special subframe configuration (SSC)

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

PDSCH

Scalar structure

PDSCH transmission configuration substructure

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

Modulation('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: 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?