Main Content

ltePUCCH1DRSIndices

PUCCH format 1 DRS resource element indices

Description

example

ind = ltePUCCH1DRSIndices(ue,chs) returns a matrix of resource element indices for the demodulation reference signal (DRS) associated with PUCCH format 1 transmission given structures containing the UE-specific settings, and the channel transmission configuration settings.

example

[ind,info] = ltePUCCH1DRSIndices(ue,chs) also returns a PUCCH information structure array, info.

example

[___] = ltePUCCH1DRSIndices(ue,chs,opts) formats the returned indices using options specified by opts.

This syntax supports output options from prior syntaxes.

Examples

collapse all

Generate PUCCH format 1 DM-RS RE indices for a 1.4 MHz bandwidth and PUCCH resource index 0. Use default values for all other parameters.

Initialize UE-specific and channel configuration structures. Generate PUCCH format 1 DM-RS indices.

ue.NULRB = 6;
ue.CyclicPrefixUL = 'Normal';

chs.ResourceIdx = 0;
chs.DeltaShift = 1;
chs.CyclicShifts = 0;
chs.ResourceSize = 0;

ind = ltePUCCH1DRSIndices(ue,chs);
ind(1:4)
ans = 4x1 uint32 column vector

   145
   146
   147
   148

Generate the PUCCH format 1 DM-RS indices for two transmit antenna paths.

Initialize UE-specific and channel configuration structures. Generate PUCCH1 DRS indices and information outputs.

ue.NULRB = 6;
ue.CyclicPrefixUL = 'Normal';

chs.ResourceIdx = [0 4];
chs.ResourceSize = 0;
chs.DeltaShift = 1;
chs.CyclicShifts = 0;

[ind,info] = ltePUCCH1DRSIndices(ue,chs);

Because there are two antennas, the DM-RS indices are output as a two-column vector, and the info output structure contains two elements. View ind and the size of info to confirm this.

ind(1:6,:)
ans = 6x2 uint32 matrix

    145   1153
    146   1154
    147   1155
    148   1156
    149   1157
    150   1158

size(info)
ans = 1×2

     1     2

View the contents of the two info structure elements.

info(1)
ans = struct with fields:
    PRBSet: [0 5]
     RBIdx: 0

info(2)
ans = struct with fields:
    PRBSet: [0 5]
     RBIdx: 0

Generate the PUCCH format 1 DM-RS indices for two transmit antenna paths, and output in subscript indexing form.

Initialize UE-specific and channel configuration structures, and the indexing option parameter. Generate PUCCH1 DM-RS indices and information outputs.

ue.NULRB = 6;
ue.CyclicPrefixUL = 'Normal';

chs.ResourceIdx = [0 4];
chs.ResourceSize = 0;
chs.DeltaShift = 1;
chs.CyclicShifts = 0;

opts = {'sub'};

[ind,info] = ltePUCCH1DRSIndices(ue,chs,opts);

Using 'sub' indexing style, the indices are output in [subcarrier, symbol, antenna] subscript form. View the midpoint of ind and observe the antenna index change.

size(ind)
ans = 1×2

   144     3

ind(70:74,:)
ans = 5x3 uint32 matrix

   70   12    1
   71   12    1
   72   12    1
    1    3    2
    2    3    2

size(info)
ans = 1×2

     1     2

Because there are two antennas, the info output structure contains two elements. View one of the info structure elements.

info(1)
ans = struct with fields:
    PRBSet: [0 5]
     RBIdx: 0

Input Arguments

collapse all

UE-specific settings, specified as a structure containing these fields.

Number of uplink resource blocks, specified as an integer from 6 to 110.

Data Types: double

Cyclic prefix length for uplink channels, specified as 'Normal' or 'Extended'.

Data Types: char | string

Channel transmission configuration, specified as a structure containing these fields.

PUCCH resource indices, specified as an integer or a vector of integers. Values range from 0 to 2047. These indices determine the physical resource blocks, cyclic shift and orthogonal cover used for transmission. (nPUCCH(1)). Define one index for each transmission antenna.

Data Types: double

Size of resources allocated to PUCCH format 2, specified as an integer from 0 to 98. This parameter affects the location of this transmission. (NRB(2))

Data Types: double

Delta shift, specified as 1, 2, or 3. (Δshift)

Data Types: double

Number of cyclic shifts used for format 1 in resource blocks (RBs) with a mixture of format 1 and format 2 PUCCH, specified as an integer from 0 to 7. (Ncs(1))

Data Types: double

Data Types: struct

Output format options for resource element indices, specified as a character vector, cell array of character vectors, or string array. For convenience, you can specify several options as a single character vector or string scalar by a space-separated list of values placed inside the quotes. Values for opts when specified as a character vector include (use double quotes for string) :

Category Options Description

Indexing style

'ind' (default)

The returned indices are in linear index style.

'sub'

The returned indices are in [subcarrier,symbol,port] subscript row style.

Index base

'1based' (default)

The returned indices are one-based.

'0based'

The returned indices are zero-based.

Example: 'ind 1based', "ind 1based", {'ind','1based'}, or ["ind","1based"] specify the same formatting options.

Data Types: char | string | cell

Output Arguments

collapse all

Resource element indices, returned as an integer column vector or a three-column integer matrix. By default the indices are returned in one-based linear indexing form that can directly index elements of a resource matrix. These indices are ordered according to PUCCH format 1 DRS modulation symbol mapping. The opts input offers alternative indexing formats. The indices for each antenna are in the columns of ind, with the number of columns determined by the number of PUCCH resource indices specified in chs.ResourceIdx.

Example: [145,146,147,...]

Data Types: uint32

PUCCH format 1 DRS information, returned as a structure array with elements corresponding to each transmit antenna and containing these fields.

Indices occupied by PRB in each slot of the subframe, returned as a nonnegative integer vector. The indices are zero-based.

Example: [0,5]

Data Types: double

PUCCH logical resource block index, returned as a nonnegative integer. (m)

Data Types: double

Data Types: struct

Version History

Introduced in R2014a