lteNSSSIndices

Generate NSSS RE indices for subframe

Syntax

ind = lteNSSSIndices(enb)

ind = lteNSSSIndices(enb,port)

ind = lteNSSSIndices(enb,port,opts)

Description

ind = lteNSSSIndices(enb) generates ind, the narrowband secondary synchronization signal (NSSS) resource element (RE) indices for cell-wide settings enb.

ind = lteNSSSIndices(enb,port) generates the NSSS RE indices for the antenna port corresponding to the port input.

ind = lteNSSSIndices(enb,port,opts) generates the NSSS RE indices for the specified antenna port in the format specified by opts.

Examples

Generate Zero-Based NSSS RE Indices

Generate zero-based NSSS RE indices for antenna port 2001.

Initialize cell-wide settings by specifying the operation mode, number of cell-specific RS antenna ports, physical layer cell identity, frame number, and subframe number.

enb.OperationMode = 'Inband-SamePCI';    % Operation mode
enb.CellRefP = 1;                        % Number of cell-specific RS antenna ports
enb.NCellID = 2;                         % Physical layer cell identity
enb.NSubframe = 9;                       % Subframe number
enb.NFrame = 4;                          % Frame number

Specify the antenna port and generate the NSSS RE indices, specifying zero-based indexing. To return a matrix whose rows each contain the subcarrier, index, and antenna port of the corresponding RE, specify the option 'sub'.

port = 1;
ind = lteNSSSIndices(enb,port,{'0based','sub'});

Input Arguments

enb — Cell-wide settings

structure

Cell-wide settings, specified as a structure containing these fields.

Name	Required or Optional	Values	Description	Data Types
OperationMode	Optional	'Standalone' (default), 'Inband-SamePCI', 'Inband-DifferentPCI', 'Guardband'	NB-IoT operation mode, specified as one of these values: 'Standalone' – NB-IoT standalone operation within any 180-kHz band outside any LTE carrier bandwidth 'Inband-SamePCI' – NB-IoT in-band operation with the same physical layer cell identity (PCI) as an LTE carrier 'Inband-DifferentPCI' – NB-IoT in-band operation with a different PCI to an LTE carrier 'Guardband' – NB-IoT guard-band operation utilizing unused resource blocks within the guard-band of an LTE carrier	char, string
NSubframe	Optional	9 (default), integer	Subframe number. Because the NSSS is defined only for subframe 9 in alternate frames, the function returns an empty array for any value of this field other than 9. This behavior enables resource grid indexing for any subframe number.	double
NFrame	Optional	0 (default), integer	Frame number. Because the NSSS is defined only for subframe 9 in alternate frames, the function returns an empty vector for odd values of this field. This behavior enables resource grid indexing for any subframe number and any frame number.	double
NCellID	Required when you specify OperationMode as 'Inband-SamePCI' or 'Inband-DifferentPCI'	Integer in the interval [0, 503]	PCI	double
CellRefP	Required when you specify OperationMode as 'Inband-SamePCI' or 'Inband-DifferentPCI'	1, 2, 4	Number of cell-specific antenna ports	double

Note

To exclude cell reference signal (RS) locations, specify the NCellID and CellRefP fields. If you do not specify the NCellID and CellRefP fields, the function assumes that the cell RS is absent and generates NSSS values for all cell RS locations.

Data Types: struct

port — Antenna port

0 | 1

Antenna port, specified as 0 or 1, corresponding to antenna port 2000 or 2001, respectively.

Data Types: double

opts — Output format and index base of generated indices

character vector | string scalar | cell array of character vectors | string array

Output format and index base of generated indices, specified as one of these forms.

• 'format base'

• "format base"

• {'format','base'}

• ["format","base"]

Where format and base are defined in this table.

Option	Values	Description
format	'ind' (default), 'sub'	Output format of generated indices To return the indices as a column vector, specify this option as 'ind'. To return the indices as an NRE-by-3 matrix, where NRE is the number of REs, specify this option as 'sub'. Each row of the matrix contains the subcarrier, symbol, and antenna port as its first, second, and third element, respectively.
base	'1based' (default), '0based'	Index base To generate indices whose first value is 1, specify this option as '1based'. To generate indices whose first value is 0, specify this option as '0based'.

Example: 'ind 0based', "ind 0based", {'ind','0based'}, and ["ind","0based"] specify the same output options.

Data Types: char | string | cell

Output Arguments

ind — NSSS RE indices for a subframe

complex-valued array | empty array

NSSS RE indices for a subframe, returned as a complex-valued array. The array dimensions depend on the format options you specify in opts. To return ind as a column vector, specify 'ind' in the opts input. To return ind as an N_RE-by-3 matrix, specify 'sub' in the opts input. If you specify the NSubframe field of the enb input as a value other than 9 or the NFrame field as an odd value, the function returns this output as an empty array.

Data Types: uint32

Version History

Introduced in R2019a