ltePUCCH3Indices

PUCCH format 3 resource element indices

Syntax

ind = ltePUCCH3Indices(ue,chs)

[ind,info] = ltePUCCH3Indices(ue,chs)

[___] = ltePUCCH3Indices(ue,chs,opts)

Description

ind = ltePUCCH3Indices(ue,chs) returns a column vector of physical uplink control channel (PUCCH) format 3 resource element indices given structures containing the UE-specific settings, and the channel transmission configuration settings.

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

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

This syntax supports output options from prior syntaxes.

Examples

Generate PUCCH Format 3 Indices

Generate PUCCH format 3 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 3 indices.

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

chs.ResourceIdx = 0;

ind = ltePUCCH3Indices(ue,chs);
ind(1:4)

ans = 4x1 uint32 column vector

   1
   2
   3
   4

Generate PUCCH Format 3 Indices for Two Antennas

Generate the PUCCH format 3 indices for three transmit antenna paths, and display the information structure output.

Initialize UE-specific and channel configuration structures. Generate PUCCH 3 indices and information outputs.

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

chs.ResourceIdx = [0 2];

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

Because there are two antennas, the indices are output as a two-column vector, and the info output structure contains two elements.

ind(1:5,:)

ans = 5x2 uint32 matrix

      1   1009
      2   1010
      3   1011
      4   1012
      5   1013

size(info)

ans = 1×2

     1     2

View one of the info structure elements.

info(1)

ans = struct with fields:
       PRBSet: [0 5]
        RBIdx: 0
    NSymbSlot: [5 5]

Generate PUCCH Format 3 Indices Varying Indexing Style

Generate the PUCCH format 3 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 PUCCH 3 indices and information outputs.

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

chs.ResourceIdx = [0 9];

opts = {'sub'};

[ind,info] = ltePUCCH3Indices(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

   240     3

ind(118:123,:)

ans = 6x3 uint32 matrix

   70   14    1
   71   14    1
   72   14    1
   61    1    2
   62    1    2
   63    1    2

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

size(info)

ans = 1×2

     1     2

info(1)

ans = struct with fields:
       PRBSet: [0 5]
        RBIdx: 0
    NSymbSlot: [5 5]

Input Arguments

ue — UE-specific settings

structure

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

NULRB — Number of uplink resource blocks

nonnegative integer

Number of uplink resource blocks, specified as a nonnegative integer.

CyclicPrefixUL — Cyclic prefix length for uplink channels

'Normal' (default) | optional | 'Extended'

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

Data Types: char | string

Shortened — Option to shorten the subframe

0 (default) | optional | 1

Option to shorten the subframe by omitting the last symbol, specified as 0 or 1. For subframes with possible SRS transmission, this parameter is required. If 1, the last symbol of the subframe is not used.

Data Types: struct

chs — Channel transmission configuration

structure

Channel transmission configuration, specified as a structure containing the following fields.

ResourceIdx — PUCCH resource indices

0 (default) | optional | 0,...,549 | integer | vector of integers

PUCCH resource indices, specified as an integer or a vector of integers. Values range from 0 to 549. There is one index for each transmission antenna. These indices determine the cyclic shift and orthogonal cover used for transmission. ($$n_{PUCCH}^{(3)}$$)

Data Types: struct

opts — Output format options for resource element indices

character vector | cell array of character vectors | string array

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

ind — PUCCH format 3 resource element indices

integer column vector | three-column integer matrix

PUCCH format 3 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 3 modulation symbol mapping as specified in TS 36.211 [1], Section 5.4. 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: [1,2,3,4...]

info — PUCCH format 3 information

scalar structure | structure array

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

PRBSet — Set of PRB indices

column vector | two-column matrix

Set of PRB indices, returned as a column vector or two-column matrix corresponding to the resource allocations.

• When returned as a column vector, the resource allocation is the same in both slots of the subframe.

• When returned as a two-column matrix, the resource allocations can vary for each slot in the subframe.

The PRB indices are zero-based.

Example: [0,5]

RBIdx — PUCCH logical resource block index

nonnegative integer

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

NSymbSlot — Number of OFDM symbols in each slot

vector of integers

The number of OFDM symbols in each slot, returned as a vector of integers. ($$\left[N_{\text{SF},0}^{\text{PUCCH}}{N}_{\text{SF},1}^{\text{PUCCH}}\right]$$)

Data Types: struct

References

[1] 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.