Main Content

lteNPRACHInfo

NPRACH resource information

Since R2021a

collapse all in page

Syntax

info = lteNPRACHInfo(ue,chs)

Description

info = lteNPRACHInfo(ue,chs) returns narrowband physical random access channel (NPRACH) information for user equipment (UE) settings ue and channel transmission configuration chs.

example

Examples

collapse all

Open Live Script

Get NPRACH information for specified UE settings and channel transmission configuration.

Specify the narrowband physical layer cell identity and subcarrier spacing.

ue = struct('NNCellID',0,'NBULSubcarrierSpacing','15kHz');

Specify the NPRACH format, periodicity, subcarrier offset, number of subcarriers, and number of preamble repetitions.

chs = struct('NPRACHFormat','0','Periodicity',80, ...
    'SubcarrierOffset',0,'NumSubcarriers',12,'NRep',1);

Generate and display the NPRACH information.

info = lteNPRACHInfo(ue,chs)
info = struct with fields:
     SubcarrierSpacing: 3750
                  Nfft: 512
          SamplingRate: 1920000
             Windowing: 18
     FrequencyLocation: [0 1 7 6]
                     K: 4
                 NULSC: 12
    PreambleParameters: [1x1 struct]

Display the random access preamble parameters, as specified in Table 10.1.6.1-1 [2].

disp(info.PreambleParameters)
        G: 4
        P: 4
        N: 5
     T_CP: 2048
    T_SEQ: 40960

Input Arguments

collapse all

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

FieldRequired or OptionalValuesDescriptionData Type
NNCellIDRequiredInteger in the interval [0, 503]Narrowband physical layer cell identity.double
NBULSubcarrierSpacingRequired'3.75kHz', '15kHz'Narrowband internet of things (NB-IoT) uplink subcarrier spacing. To set a subcarrier spacing of 3.75 kHz, specify this field as '3.75kHz'. To set a subcarrier spacing of 15 kHz, specify this field as '15kHz'.char, string
WindowingOptionalNonnegative integer, default value depends on NPRACH preamble format in accordance with section F.5.F of [1]

Number of time-domain samples over which the function applies windowing and overlapping of OFDM samples.

If you do not specify this field, this function returns the Windowing field of the info output as a function of the NBULSubcarrierSpacing field. This behavior compromises between the effective duration of the cyclic prefix (and therefore the channel delay spread tolerance) and the spectral characteristics of the transmitted signal (not considering any additional FIR filtering). For NPRACH preamble format 2, the function sets the default value such that the ratio of cyclic prefix length to windowing length is the same as that of NPRACH preamble format 1.

double

Data Types: struct

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

FieldRequired or OptionalValuesDescriptionDependenciesData Types
NPRACHFormatRequired'0', '1', '2'NPRACH preamble format.Not applicablechar, string
PeriodicityRequired40, 80, 160, 240 (since R2024b), 320, 640, 1280, 2560, 5120NPRACH resource periodicity, in milliseconds.

If you set the NPRACHFormat field to '0' or '1', you cannot set this field to 5120.

If you set the NPRACHFormat field to '2', you cannot set this field to 240.

double
SubcarrierOffsetRequired0, 2, 6, 12, 18, 24, 34, 36, 42, 48, 54, 60, 72, 78, 84, 90, 102, 108Frequency location of the first subcarrier allocated to NPRACH.

If you set the NPRACHFormat field to '0' or '1', you cannot set this field to 6, 42, 48, 54, 60, 72, 78, 84, 90, 102, or 108.

If you set the NPRACH field to '2', you cannot set this field to 2 or 34.

double
NumSubcarriersRequired12, 24, 36, 48, 72, 108, 144Number of subcarriers allocated to NPRACH.

If you set the NPRACHFormat field to '0' or '1', you cannot set this field to 72, 108, or 144.

If you set the NPRACHFormat field to '2', you cannot set this field to 12, 24, or 48.

double
NRepRequired1, 2, 4, 8, 16, 32, 64, 128Number of NPRACH repetitions.Not applicabledouble
StartTimeOptional8 (default), 16, 32, 64, 128, 256, 512, 1024NPRACH starting time, in milliseconds.Not applicabledouble
NInitOptional0 (default), integer in the interval [0, NumSubcarriers – 1]Initial subcarrier for NPRACH.Not applicabledouble

Data Types: struct

Output Arguments

collapse all

NPRACH resource information, returned as a structure containing these fields.

FieldValuesDescriptionData Type
NfftPositive integerNumber of fast Fourier transform (FFT) points.double
SamplingRatePositive scalarSampling rate, in Hz, of the time-domain waveform.double
WindowingNonnegative even integerNumber of time-domain samples over which the function applies windowing and overlapping of OFDM symbols.double
FrequencyLocationRow vector of nonnegative integersFrequency location for all symbol groups in an NPRACH transmission. For more information about NPRACH symbol groups, see the NB-IoT PRACH Waveform Generation example. The kth element of this output represents the frequency location of the kth symbol group.double
KPositive integerRatio of uplink data to NPRACH subcarrier spacing.double
NULSCPositive integerNumber of subcarriers for the specified uplink bandwidth.double
PreambleParametersStructureRandom access preamble parameters for the specified preamble format and frame structure type 1, as specified in Table 10.1.6.1-1 of [2].struct

PreambleParameters Field

The PreambleParameters field of this output contains these fields.

FieldValuesDescriptionData Type
GPositive integerNumber of time-contiguous symbol groups.double
PPositive integerTotal number of symbol groups.double
NPositive integerNumber of symbols in a symbol group.double
T_CPPositive integerCyclic prefix length, in multiples of Ts, where Ts is the basic time unit, defined in section 4 of [2] as 1 ÷ (15000 × 2048) seconds.double
T_SEQPositive integerLength of symbols in a symbol group, in multiples of Ts.double

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. https://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). https://www.3gpp.org.

Version History

Introduced in R2021a

expand all

See Also

Functions

Topics