lteRMCDLTool

Generate downlink RMC waveform

Syntax

lteRMCDLTool

[waveform,grid,rmccfgout] = lteRMCDLTool(rmccfg,trdata)

[waveform,grid,rmccfgout] = lteRMCDLTool(rc,trdata,duplexmode,totsubframes)

Description

lteRMCDLTool starts the LTE Waveform Generator app configured for parameterization and generation of a reference measurement channel (RMC) waveform. The Reference Channel menu lists the available RMCs with their default top-level settings.

[waveform,grid,rmccfgout] = lteRMCDLTool(rmccfg,trdata) where rmccfg specifies a user-defined reference channel structure. The reference configuration structure with default parameters can easily be created using lteRMCDL then modified if desired.

Note

SIB1 messages and the associated PDSCH and PDCCH can be added to the output waveform by adding the substructure rmccfg.SIB.

[waveform,grid,rmccfgout] = lteRMCDLTool(rc,trdata,duplexmode,totsubframes) specifies the default reference measurement channel, rc, and information bits trdata. duplexmode and totsubframes are optional input arguments, that define the duplex mode of the generated waveform and total number of subframes that make up the grid.

Examples

Generate LTE DL RMC R.31-4

Generate a time domain signal and a 3-dimensional array of the resource elements for R.31-4 FDD as specified in TS 36.101 Annex A.3.9.1-1. R.31-4 FDD is 20MHz, 64QAM, variable code rate and has user data scheduled in subframe 5.

[txWaveform,txGrid,rmcCfgOut] = lteRMCDLTool('R.31-4',{[1;0] [1;0]});

Generate RMC R.3 with SIB

This example shows use of lteRMCDLTool to generate a tx waveform with SIB transmission enabled using DCIFormat1A and localized allocation.

Specify desired RMC, initialize configuration structure and define txData. Generate txGrid and plot it.

rc = 'R.3';
rmc = lteRMCDL(rc);

txData = [1;0;0;1];
[~,txGrid,~] = lteRMCDLTool(rmc, txData);
mesh(abs(txGrid))
view(2)

To insert SIB1 message into the output waveform, initialize SIB substructure, enable SIB transmission, adjust other defaults, and regenerate txGrid. Plot txGrid to illustrate the presence of SIB1 message in subframe 5

rmc.SIB.Enable = 'On'; 
rmc.SIB.DCIFormat = 'Format1A';
rmc.SIB.AllocationType = 0;
rmc.SIB.VRBStart = 8;
rmc.SIB.VRBLength = 8;
rmc.SIB.Data = randi([0 1],144,1);

[txWaveform,txGrid,rmcCfgOut] = lteRMCDLTool(rmc, txData);
figure
mesh(abs(txGrid))
view(2)

Generate LTE DL RMC R.12 With 16QAM Modulation

Generate a time domain waveform, and a 3D array of the resource elements for RMC R.12 as specified in TS 36.101. Modify the standard R.12 RMC to use 16QAM modulation scheme instead of the default QPSK.

Create an RMC setting structure specifying R.12 for RC and 16QAM for Modulation.

rmc.RC = 'R.12';
rmc.PDSCH.Modulation = '16QAM';

Generate the tx waveform, RE grid and also output the RMC configuration structure.

txData = [1;0;0;1];
[txWaveform, txGrid, rmcCfgOut] = lteRMCDLTool(rmc, txData);

Review the rmcCgfOut structure and PDSCH substructure.

rmcCfgOut

rmcCfgOut = struct with fields:
                 RC: 'R.12'
              NDLRB: 6
           CellRefP: 4
            NCellID: 0
       CyclicPrefix: 'Normal'
                CFI: 3
        PCFICHPower: 0
                 Ng: 'Sixth'
      PHICHDuration: 'Normal'
              HISet: [112x3 double]
         PHICHPower: 0
             NFrame: 0
          NSubframe: 0
       TotSubframes: 10
          Windowing: 0
         DuplexMode: 'FDD'
              PDSCH: [1x1 struct]
    OCNGPDCCHEnable: 'Off'
     OCNGPDCCHPower: 0
    OCNGPDSCHEnable: 'Off'
     OCNGPDSCHPower: 0
          OCNGPDSCH: [1x1 struct]
               Nfft: 128
          SerialCat: 1
       SamplingRate: 1920000

rmcCfgOut.PDSCH

ans = struct with fields:
               TxScheme: 'TxDiversity'
             Modulation: {'16QAM'}
                NLayers: 4
                    Rho: 0
                   RNTI: 1
                  RVSeq: [0 1 2 3]
                     RV: 0
         NHARQProcesses: 8
           NTurboDecIts: 5
                 PRBSet: [6x1 double]
         TargetCodeRate: 0.3333
         ActualCodeRate: [0 0.3846 0.3846 0.3846 0.3846 0 0.3846 0.3846 0.3846 0.3846]
             TrBlkSizes: [0 936 936 936 936 0 936 936 936 936]
        CodedTrBlkSizes: [0 2496 2496 2496 2496 0 2496 2496 2496 2496]
              DCIFormat: 'Format1'
            PDCCHFormat: 2
             PDCCHPower: 0
                CSIMode: 'PUCCH 1-1'
                PMIMode: 'Wideband'
    HARQProcessSequence: [0 1 2 3 4 0 5 6 7 8]

Display Uplink PRB Allocation Type 1

Display the PRB allocations associated with the sequence of subframes in a frame for DCI Format 0 and uplink resource allocation type 1.

Configure a type 1 uplink resource allocation (multi-cluster). TS 36.213, Section 8.1.2 describes the resource indication value (RIV) determination.

enbue = struct('NDLRB',50);
dcistr = lteDCI(enbue,struct('DCIFormat','Format0','AllocationType',1));
dcistr.Allocation.RIV = 1;

Display an image of the PRBs used in each slot of each subframe in a frame.

• Create a subframeslots matrix full of zeros. There are 20 slots per frame, specifically two slots per subframe and ten subframes per frame.

• Loop through assigning a PRB set of indices for each subframe. Also assign a value in subframeslots for each occupied PRB index.

subframeslots = zeros(enbue.NDLRB,20);
for i = 0:9
    enbue.NSubframe = i;
    prbSet = lteDCIResourceAllocation(enbue,dcistr);
    prbSet = repmat(prbSet,1,2/size(prbSet,2));
    for s = 1:2
        subframeslots(prbSet(:,s)+1,2*i+s) = 20+s*20;
    end
end
imagesc(subframeslots); 
axis xy;
xlabel('Subframe Slots'); 
ylabel('PRB Indices');

Observe from the image that the same set of PRB indices is used in each slot.

Display Uplink Hopping PRB Allocation

Display the PRB allocations associated with the sequence of subframes in a frame for an uplink resource allocation with hopping.

Configure a type 1 uplink resource allocation that has type 0 hopping and slot and subframe hopping.

enbue = struct('NDLRB',50,'NCellID',0);
dcistr = lteDCI(enbue,struct('DCIFormat','Format0','AllocationType',0,...
    'FreqHopping',1));
dcistr.Allocation.HoppingBits = 0;
dcistr.Allocation.RIV = 110;
enbue.PUSCHHopping = 'InterAndIntra';
enbue.MacTxNumber = 0;
enbue.NSubbands = 1;
enbue.PUSCHHoppingOffset = 10;

Display an image of the PRBs used in each slot of each subframe in a frame.

• Create a subframeslots matrix full of zeros. There are 20 slots per frame, specifically two slots per subframe and ten subframes per frame.

• Loop through assigning a PRB set of indices for each subframe. Also assign a value in subframeslots for each occupied PRB index.

subframeslots = zeros(enbue.NDLRB,20);
for i = 0:9
    enbue.NSubframe = i;
    prbSet = lteDCIResourceAllocation(enbue,dcistr);
    prbSet = repmat(prbSet,1,2/size(prbSet,2));
    for s = 1:2
        subframeslots(prbSet(:,s)+1,2*i+s) = 20+s*20;
    end
end
imagesc(subframeslots)
axis xy
xlabel('Subframe Slots')
ylabel('PRB Indices')

Observe from the image that the occupied PRB indices hops in odd and even slots.

Input Arguments

rc — Reference channel

character vector | string scalar

Reference channel, specified as a character vector or string scalar. The function configures the RMC in accordance with the reference channels defined in Annex A.3 of TS 36.101. This table lists the supported values of this input and their associated configuration parameters.

Reference Channel (rc)	Configuration
	Transmission Scheme (PDSCH.TxScheme)	Number of Resource Blocks	Modulation	Number of CRS Antenna Ports	Coding Rate
'R.0'	'Port0'	1	16-QAM	1	1/2
'R.1'	'Port0'	1	16-QAM	1	1/2
'R.2'	'Port0'	50	QPSK	1	1/3
'R.3'	'Port0'	50	16-QAM	1	1/2
'R.4'	'Port0'	6	QPSK	1	1/3
'R.5'	'Port0'	15	64-QAM	1	3/4
'R.6'	'Port0'	25	64-QAM	1	3/4
'R.7'	'Port0'	50	64-QAM	1	3/4
'R.8'	'Port0'	75	64-QAM	1	3/4
'R.9'	'Port0'	100	64-QAM	1	3/4
'R.10'	'TxDiversity', 'SpatialMux'	50	QPSK	2	1/3
'R.11'	'TxDiversity''SpatialMux', 'CDD'	50	16-QAM	2	1/2
'R.12'	'TxDiversity'	6	QPSK	4	1/3
'R.13'	'SpatialMux'	50	QPSK	4	1/3
'R.14'	'SpatialMux', 'CDD'	50	16-QAM	4	1/2
'R.25'	'Port5'	50	QPSK	1	1/3
'R.26'	'Port5'	50	16-QAM	1	1/2
'R.27'	'Port5'	50	64-QAM	1	3/4
'R.28'	'Port5'	1	16-QAM	1	1/2
'R.31-3A' (with FDD)	'CDD'	50	64-QAM	2	0.85-0.90
'R.31-3A (with TDD)	'CDD'	68	64-QAM	2	0.87-0.90
'R.31-4'	'CDD'	100	64-QAM	2	0.87-0.90
'R.43' (with FDD)	'Port7-14'	50	QPSK	2	1/3
'R.43' (with TDD)	'SpatialMux'	100	16-QAM	4	1/2
'R.44' (with FDD)	'Port7-14'	50	QPSK	2	1/3
'R.44' (with TDD)	'Port7-14'	50	64-QAM	2	1/2
'R.45'	'Port7-14'	50	16-QAM	2	1/2
'R.45-1'	'Port7-14'	39	16-QAM	2	1/2
'R.48'	'Port7-14'	50	QPSK	2	1/2
'R.50' (with FDD)	'Port7-14'	50	64-QAM	2	1/2
'R.50' (with TDD)	'Port7-14'	50	QPSK	2	1/3
'R.51'	'Port7-14'	50	16 -QAM	2	1/2
'R.68-1' (with FDD)	'CDD'	75	256-QAM	2	0.74-0.88
'R.68-1' (with TDD)	'CDD'	75	256-QAM	2	0.76-0.88
'R.105' (with FDD)	'CDD'	100	1024-QAM	2	0.76-0.79
'R.105' (with TDD)	'CDD'	100	1024-QAM	2	0.76-0.78
Custom RMCs configured for non-standard bandwidths but with the same code rate as the standard versions.
'R.6-27RB'	'Port0'	27	64-QAM	1	3/4
'R.12-9RB'	'TxDiversity'	9	QPSK	4	1/3
'R.11-45RB'	'CDD'	45	16-QAM	2	1/2

Data Types: char | string

trdata — Information bits

vector | cell array containing one or two vectors

Information bits, specified as a vector or cell array containing one or two vectors of bit values. Each vector contains the information bits stream to be coded across the duration of the generation, which represents multiple concatenated transport blocks. If the number of bits required across all subframes of the generation exceeds the length of the vectors provided, the txdata vector is looped internally. This feature allows you to enter a short pattern, such as [1;0;0;1], which is repeated as the input to the transport coding. In each subframe of generation, the number of data bits taken from this stream comes from the elements of the rmccfgout.PDSCH.TrBlkSizes matrix.

When the trdata input contains empty vectors, there is no transport data. The transmission of PDSCH and its corresponding PDCCH are skipped in the waveform when the trdata contains empty vectors. The other physical channels and signals are transmitted as normal in generated waveform.

Example: [1;0;0;1]

Data Types: double | cell
Complex Number Support: Yes

duplexmode — Duplexing mode

'FDD' (default) | optional | 'TDD'

Duplexing mode, specified as 'FDD' or 'TDD' to indicate the frame structure type of the generated waveform.

Data Types: char | string

totsubframes — Total number of subframes

10 (default) | positive integer

Total number of subframes, specified as a positive integer. This argument specifies the total number of subframes that form the resource grid.

Data Types: double

rmccfg — Reference channel configuration

structure

Reference channel configuration, specified as a structure. Create a reference configuration structure with default parameters by using the lteRMCDL function. The reference configuration structures you generate with the lteRMCDL function comply with those defined in Annex A.3 of [1].

To generate the waveform output in alignment with your simulation requirements, modify the output of the lteRMCDL function. To add SIB1 messages and the associated PDSCH and PDCCH to the output waveform, specify the rmccfg.SIB substructure. You can specify this input to include fields contained in the rmccfgout output structure.

Data Types: struct

Output Arguments

waveform — Generated RMC time-domain waveform

numeric matrix

Generated RMC time-domain waveform, returned as a N_S-by-N_T numeric matrix. N_S is the number of time-domain samples and N_T is the number of transmit antennas.

Data Types: double
Complex Number Support: Yes

grid — Populated resource grid

numeric 3-D array

Populated resource grid, returned as a numeric 3-D array of resource elements for several subframes across all configured antenna ports, as described in Represent Resource Grids.

grid represents the populated resource grid for all the physical channels specified in TS 36.101 [1], Annex A.3.

Data Types: double
Complex Number Support: Yes

rmccfgout — RMC configuration

structure

RMC configuration, returned as a structure. This output contains information about the OFDM-modulated waveform and RMC-specific configuration parameters. Field definitions and settings align with rmccfg.

For more information about the OFDM modulated waveform, see lteOFDMInfo. For more information about the RMC-specific configuration parameters, see lteRMCDL.

Parameter Field	Values	Description
RC	'R.0', 'R.1', 'R.2', 'R.3', 'R.4', 'R.5', 'R.6', 'R.7', 'R.8', 'R.9', 'R.10', 'R.11', 'R.12', 'R.13', 'R.14', 'R.25', 'R.26', 'R.27', 'R.28', 'R.31-3A', 'R.31-4', 'R.43', 'R.44', 'R.45', 'R.45-1', 'R.48', 'R.50', 'R.51', 'R.68-1', 'R.105', 'R.6-27RB', 'R.12-9RB', 'R.11-45RB'	Reference measurement channel (RMC) number or type, as specified in Annex A.3 of TS 36.101. To facilitate the transmission of system information blocks (SIBs), user data is usually not scheduled on subframe 5. To schedule user data in subframe 5, use one of these sustained-data-rate RMCs: 'R.31-3A', 'R.31-4', 'R.68-1', or 'R.105'. 'R.6-27RB', 'R.12-9RB', and 'R.11-45RB' are custom RMCs configured for non-standard bandwidths that maintain the same code rate as the standardized versions defined in Annes A.3 of TS 36.101.
NDLRB	Integer in the interval [6, 110]	Number of downlink resource blocks
CellRefP	1, 2, 4	Number of cell-specific reference signal (CRS) antenna ports
NCellID	Integer in the interval [0, 503]	Physical layer cell identity
CyclicPrefix	'Normal', 'Extended'	Cyclic prefix length
CFI	1, 2, 3, real-valued vector of length 10	Control format indicator (CFI) value. When the CFI value does not vary between subframes, specify this field as a scalar. Otherwise, specify this field as a vector, where the kth element corresponds to the CFI value of the kth subframe. The CFI value varies between subframes for these RMCs when you specify the duplexmode input as 'TDD' mode, the CFI varies per subframe for these RMCs: 'R.0', 'R.5', 'R.6', 'R.6-27RB', 'R.12-9RB'.
PCFICHPower	Real-valued scalar	PCFICH symbol power adjustment, in dB
Ng	'Sixth', 'Half', 'One', 'Two'	HICH group multiplier
PHICHDuration	'Normal', 'Extended'	PHICH duration
HISet	112-by-3 matrix	Maximum PHICH groups (112), as specified in section 6.9 of TS 36.211, with the first PHICH sequence of each group set to ACK). For more information, see ltePHICH.
PHICHPower	Real-valued scalar	PHICH symbol power, in dB
NFrame	Nonnegative integer	Frame number
NSubFrame	Nonnegative integer	Subframe number
TotSubFrames	Nonnegative integer	Total number of subframes to generate
Windowing	Nonnegative integer	Number of time-domain samples over which the function applies windowing and overlapping of OFDM symbols
DuplexMode	'FDD', 'TDD'	Duplexing mode, returned as one of these values 'FDD' — Frequency division duplex 'TDD' — Time division duplex
CSIRSPeriod	'On', 'Off', integer in the interval [0, 154], two-element row vector of nonnegative integers, cell array	CSI-RS subframe configurations for CSI-RS resources, returned as one of these values. 'On' or 'Off An integer in the interval [0, 154] corresponding to the parameter ICSI-RS, specified in Table 6.10.5.3-1 of TS 36.211 A vector of the form [TCSI-RS ∆CSI-RS], in accordance with Table 6.10.5.3-1 of TS 36.211 A cell array of configurations for each resource. This field applies only when the TxScheme field is 'Port7-14'.
These fields are only present and applicable for 'Port7-14' transmission scheme (TxScheme) and only required in rmccfg if CSIRSPeriod is not set to 'Off'.
CSIRSConfig	Nonnegative integer	Array CSI-RS configuration indices. See Table 6.10.5.2-1 of TS 36.211.
CSIRefP	1, 2, 4, 8	Array of number of CSI-RS antenna ports
These fields are only present and applicable for 'Port7-14' transmission scheme (TxScheme)
ZeroPowerCSIRSPeriod	'Off' (default), 'On', Icsi-rs (0,...,154), [Tcsi-rs Dcsi-rs]. You can also specify values in a cell array of configurations for each resource.	Zero power CSI-RS subframe configurations for one or more zero power CSI-RS resource configuration index lists. Multiple zero power CSI-RS resource lists can be configured from a single common subframe configuration or from a cell array of configurations for each resource list.
The following field is only applicable for 'Port7-14' transmission scheme (TxScheme) and only required in rmccfg if CSIRSPeriod is not set to 'Off'.
ZeroPowerCSIRSConfig	16-bit bitmap character vector or string scalar (truncated if not 16 bits or '0' MSB extended), or a numeric list of CSI-RS configuration indices. You can also specify values in a cell array of configurations for each resource.	Zero power CSI-RS resource configuration index lists (TS 36.211 Section 6.10.5.2). Specify each list as a 16-bit bitmap character vector or string scalar (if less than 16 bits, then '0' MSB extended), or as a numeric list of CSI-RS configuration indices from TS 36.211 Table 6.10.5.2-1 in the '4' CSI reference signal column. Multiple lists can be defined using a cell array of individual lists.
PDSCH	Scalar structure	PDSCH transmission configuration substructure
SIB	Scalar structure	Include a SIB message by adding the SIB substructure to the lteRMCDL function configuration output structure, rmccfgout, after it is generated and before using the rmccfgout structure as input to lteRMCDLTool.
OCNGPDCCHEnable	'Off', 'On'	Enable PDCCH OFDMA channel noise generator (OCNG). See footnote.
OCNGPDCCHPower	Scalar integer, 0 (default)	PDCCH OCNG power in dB
OCNGPDSCHEnable	'Off', 'On'	Enable PDSCH OCNG
OCNGPDSCHPower	Scalar integer, defaults to PDSCH.Rho (default)	PDSCH OCNG power in dB
OCNGPDSCH	Scalar structure	PDSCH OCNG configuration substructure
OCNG	'Off', 'On'. 'Disable' and 'Enable' are also accepted.	OFDMA channel noise generator Note This parameter will be removed in a future release. Use the PDCCH and PDSCH-specific OCNG parameters instead.
The following fields are only present and applicable for 'TDD' duplex mode (DuplexMode).
SSC	0 (default), 1, 2, 3, 4, 5, 6, 7, 8, 9	Special subframe configuration (SSC)
TDDConfig	0, 1 (default), 2, 3, 4, 5, 6	Uplink–downlink configuration See footnote.
SamplingRate	Numeric scalar	Carrier sampling rate in Hz, (NSC/NSYM) × 3.84e6, where NSC is the number of subcarriers and NSYM is the number of OFDM symbols in a subframe.
Nfft	Scalar integer, typically one of {128, 256, 512, 1024, 1536, 2048} for standard channel bandwidths {'1.4MHz', '3MHz', '5MHz', '10MHz', '15MHz', '20MHz'}, respectively.	Number of FFT frequency bins
CFI is equal to the number of symbols allocated to: PDCCH - 1 for NDLRB < 10 PDCCH for NDLRB >= 10 For the RMCs, the number of symbols allocated to PDCCH varies with channel bandwidth setting, 2 symbols for 20 MHz, 15 MHz, and 10 MHz 3 symbols for 5 MHz and 3 MHz 4 symbols for 1.4 MHz In the TDD mode, only two OFDM symbols are allocated to PDCCH in subframes 1 and 6 irrespective of the channel bandwidth. Therefore, the CFI value varies per subframe for the 5 MHz and 3 MHz and 1.4 MHz channel bandwidths, that is for bandwidths where PDCCH symbol allocation is not two for other subframes. The PDCCH ONCG fills the unused PDCCH resource elements with QPSK symbols using either single port or transmit diversity depending on the number of cell RS ports. All supported RMCs use TDDConfig 1 by default. When you specify a value different then the default, the full parameter set is configured according to the following rules. Preserve subframe 0 (downlink) for all TDDConfig — The values of the parameters in subframe 0 of TDDConfig 1 is applied in all other TDDConfig. Preserve special subframe behavior — The values of the parameters in special subframes of TDDConfig 1 is applied in all other TDDConfig. Preserve subframe 5 (downlink) for all TDDConfig — The values of the parameters in subframe 5 of TDDConfig 1 is applied to all other TDDConfig. For all RMCs currently supported, subframe 5 is treated separately from other subframes. According to TS 36.101 Section A.3.1, “Unless otherwise stated, no user data is scheduled on subframes 5 in order to facilitate the transmission of system information blocks (SIB).” Hence the RC value, if present, determines the behavior of subframe 5. This means that subframe 5 is not transmitted for other RMCs, with the exception of sustained data rate RMCs R.31-3A and R.31-4. All other downlink subframes use the same settings as subframe 9.

PDSCH Substructure

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

Parameter Field	Values	Description
TxScheme	'Port0', 'TxDiversity', 'CDD', 'SpatialMux', 'MultiUser', 'Port5', 'Port7-8', 'Port8', 'Port7-14'.	PDSCH transmission scheme, specified as one of the following options. Transmission scheme Description 'Port0' Single antenna port, port 0 'TxDiversity' Transmit diversity 'CDD' Large delay cyclic delay diversity scheme 'SpatialMux' Closed loop spatial multiplexing 'MultiUser' Multi-user MIMO 'Port5' Single-antenna port, port 5 'Port7-8' Single-antenna port, port 7, when NLayers = 1. Dual layer transmission, ports 7 and 8, when NLayers = 2. 'Port8' Single-antenna port, port 8 'Port7-14' Up to eight layer transmission, ports 7–14
Modulation	'QPSK', '16QAM', '64QAM', or '256QAM'	Modulation type, specified as a character vector, cell array of character vectors, or string array. If blocks, each cell is associated with a transport block.
NLayers	Integer from 1 to 8	Number of transmission layers.
Rho	0 (default), numeric scalar	PDSCH resource element power allocation, in dB
RNTI	0 (default), scalar integer	Radio network temporary identifier (RNTI) value (16 bits)
RVSeq	Integer vector (0,1,2,3), specified as a one or two row matrix (for one or two codewords)	Redundancy version (RV) indicator used by all HARQ processes, returned as a numeric matrix. RVSeq is a one- or two-row matrix for one or two codewords, respectively. The number of columns in RVSeq equals the number of transmissions of the transport blocks associated with a HARQ process. The RV sequence specified in each column is applied to the transmission of the transport blocks. If RVSeq is a scalar (or column vector in the case of two codewords), then there is a single initial transmission of each block with no retransmissions. If RVSeq is a row vector in a two-codeword transmission, then the same RV sequence is applied to both codewords.
RV	Integer vector (0,1,2,3). A one or two column matrix (for one or two codewords).	Specifies the redundancy version for one or two codewords used in the initial subframe number, NSubframe. This parameter field is only for informational purposes and is read-only.
NHARQProcesses	1, 2, 3, 4, 5, 6, 7, or 8	Number of HARQ processes per component carrier
NTurboDecits	5 (default), nonnegative scalar integer	Number of turbo decoder iteration cycles
PRBSet	Integer column vector or two-column matrix	Zero-based physical resource block (PRB) indices corresponding to the slot-wise resource allocations for this PDSCH. The function returns this field as one of these values. a column vector, the resource allocation is the same in both slots of the subframe, a two-column matrix, this parameter specifies different PRBs for each slot in a subframe, a cell array of length 10 (corresponding to a frame, if the allocated physical resource blocks vary across subframes). This field varies per subframe for these RMCs: 'R.25' (with TDD), 'R.26' (with TDD), 'R.27' (with TDD), 'R.43' (with FDD), 'R.44', 'R.45', 'R.48', 'R.50', 'R.51', 'R.68-1', and 'R.105'.
TargetCodeRate	Numeric scalar or one or two row numeric matrix	Target code rates for one or two codewords for each subframe in a frame. Used for calculating the transport block sizes according to TS 36.101 [1], Annex A.3.1. If both TargetCodeRate and TrBlkSizes are not provided at the input, and the RC does not have a single ratio target code rate in TS 36.101, Table A.3.1.1-1, TargetCodeRate == ActualCodeRate.
ActualCodeRate	One or two row numeric matrix	Actual code rates for one or two codewords for each subframe in a frame, calculated according to TS 36.101 [1], Annex A.3.1. The maximum actual code rate is 0.93. This parameter field is only for informational purposes and is read-only.
TrBlkSizes	One or two row numeric matrix	Transport block sizes for each subframe in a frame
CodedTrBlkSizes	One or two row numeric matrix	Coded transport block sizes for one or two codewords. This parameter field is for informational purposes and is read-only.
DCIFormat	'Format0', 'Format1', 'Format1A', 'Format1B', 'Format1C', 'Format1D', 'Format2', 'Format2A', 'Format2B', 'Format2C', 'Format2D', 'Format3', 'Format3A', 'Format4', 'Format5', 'Format5A'	Downlink control information (DCI) format type of the PDCCH associated with the PDSCH. See lteDCI.
PDCCHFormat	0, 1, 2, 3	Aggregation level of PDCCH associated with PDSCH
PDCCHPower	Numeric scalar	PDCCH power in dB
CSIMode	'PUCCH 1-0', 'PUCCH 1-1', 'PUSCH 1-2', 'PUSCH 3-0', 'PUSCH 3-1'	CSI reporting mode
PMIMode	'Wideband' (default), 'Subband'	PMI reporting mode. PMIMode='Wideband' corresponds to PUSCH reporting Mode 1-2 or PUCCH reporting Mode 1-1 (PUCCH Report Type 2) and PMIMode='Subband' corresponds to PUSCH reporting Mode 3-1.
The following field is only present for 'SpatialMux' transmission scheme (TxScheme).
PMISet	Integer vector with element values from 0 to 15.	Precoder matrix indication (PMI) set. It can contain either a single value, corresponding to single PMI mode, or multiple values, corresponding to multiple or subband PMI mode. The number of values depends on CellRefP, transmission layers and TxScheme. For more information about setting PMI parameters, see ltePMIInfo.
The following field is only present for 'Port7-8', 'Port8', or 'Port7-14' transmission schemes (TxScheme).
NSCID	0 (default), 1	Scrambling identity (ID)
The following fields are only present for UE-specific beamforming ('Port5', 'Port7-8', 'Port8', or 'Port7-14').
W	Numeric matrix	NLayers-by-P precoding matrix for the wideband UE-specific beamforming of the PDSCH symbols. P is the number of transmit antennas. When W is not specified, no precoding is applied.
NTxAnts	Nonnegative scalar integer	Number of transmission antennas.
HARQProcessSequence	1-by-LHARQ_Seq integer vector.	One-based HARQ process indices for the internal HARQ scheduling sequence. The sequence of length LHARQ_Seq is optimized according to transport block sizes, number of HARQ processes, duplex mode, and when in TDD mode the UL/DL configuration. See footnote.
The function returns valid TrBlkSizes and CodedTrBlkSizes set to 0 when PRBSet is empty, indicating there is no PDSCH allocation in this frame. The HARQ process sequence table is calculated according to the procedure detailed in 3GPP Tdoc R5-095777 ("Scheduling of retransmissions and number of active HARQ processes for DL performance RMC-s") For the case when NHARQProcesses = 1, the HARQProcessSequence is [1 0 0 0 0 0 0 0 0 0]. Using this HARQ process sequence, only the TrBlkSize corresponding to subframe 0 gets transmitted. There is no transmission in other subframes, even if the transport block sizes in other subframes are nonzero.

SIB Substructure

If the substructure SIB has been added to rmccfg, SIB1 messages and the associated PDSCH and PDCCH can be generated. The SIB substructure includes these fields:

Parameter Field	Values	Description
Data	(0,1), bit array	SIB1 transport block information bits See footnote.
VRBStart	variable, see rules in TS 36.213 Section 7.1.6.3	Virtual RB allocation starting resource block, RBstart.
VRBLength	variable, see rules in TS 36.213 Section 7.1.6.3	Length in terms of virtual contiguously allocated resource blocks, LCRBs.
Enable	'On' (default), 'Off'	Enable/Disable SIB generation
DCIFormat	'Format1A' (default) or 'Format1C'	Downlink control information (DCI) format
AllocationType	0 (default) or 1, single bit flag	Localized (0) or distributed (1) allocation of virtual resource blocks for Resource allocation type 2
The following parameter is only applicable when DCIFormat = 'Format1A'.
N1APRB	2 or 3	Transport block set selection parameter, $$N_{PRB}^{1A}$$ Indicates the column in TS 36.213, Table 7.1.7.2.1-1 for transport block size selection. The default is the smallest transport block size, in either column 2 or 3, that is bigger than or equal to the length of the Data field. Also see TS 36.212 Section 5.3.3.1.3 and TS 36.213 Section 7.1.7.
The following parameter is only applicable when using distributed allocation (AllocationType = 1).
Gap	0 or 1	Distributed allocation gap, ‘0’ for Ngap,1 or ‘1’ for Ngap,2
The set of valid transport block sizes is specified in TS 36.213 [4], Table 7.1.7.2.1-1. Only columns 2 and 3 apply to the SIB DL-SCH. The Data field is padded with zeros to the closest valid size from this table. Note Per TS 36.321 [5], Section 6.1.1, the lowest order information bit of the SIB.Data field is mapped to the most significant bit of the SIB1 transport block. For subframe 5, per TS 36.101 [1], Annex A.3, reference PDSCH transmissions are not scheduled in subframe 5 except for the SIB1 associated PDSCH. Setting the OCNG parameter field 'On' fills all unused, unscheduled PDSCH resource elements with QPSK modulated random data. The values for CFI and PRBSet can vary per subframe. If these parameters are arrays, then the function cyclically steps through the elements of the array starting with the index given by mod(NSubframe,length(parameter)). When parameter is PRBSet, the parameter must be a cell array of column vectors or slot-wise matrices. The PHICH symbols carry a single ACK on the first PHICH instance in each PHICH group.

OCNGPDSCH Substructure

The substructure, OCNGPDSCH, defines the OCNG patterns in associated RMCs and tests according to TS 36.101 [1], Section A.5. OCNGPDSCH contains these fields which can also be customized with the full range of PDSCH-specific values.

Parameter Field	Values	Description
Modulation	OCNG Modulation has same setting options as rmccfgout.PDSCH.Modulation	See rmccfgout.PDSCH.Modulation
TxScheme	OCNG TxScheme has same setting options as rmccfgout.PDSCH.TxScheme	See rmccfgout.PDSCH.TxScheme
RNTI	0 (default), scalar integer	OCNG radio network temporary identifier (RNTI) value (16 bits)

Data Types: struct

References

[1] 3GPP TS 36.101. “Evolved Universal Terrestrial Radio Access (E-UTRA); User Equipment (UE) Radio Transmission and Reception.” 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.

[3] 3GPP TS 36.212. “Evolved Universal Terrestrial Radio Access (E-UTRA); Multiplexing and channel coding.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.

[4] 3GPP TS 36.213. “Evolved Universal Terrestrial Radio Access (E-UTRA); Physical layer procedures.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.

[5] 3GPP TS 36.321. “Evolved Universal Terrestrial Radio Access (E-UTRA); Medium Access Control (MAC) protocol Specification.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network. URL: https://www.3gpp.org.

Version History

Introduced in R2014a

R2019b: This function now opens the LTE Waveform Generator app

In previous releases, the input-free syntaxes of this function opened the LTE Downlink RMC Generator app. Starting in R2019b, input-free calls to this function open the LTE Waveform Generator app for a downlink RMC waveform.