Main Content

nrWavegenSSBurstConfig

SS burst configuration parameters for 5G waveform generation

Description

The nrWavegenSSBurstConfig object sets synchronization signal (SS) burst configuration parameters. Use this object to set the SSBurst property of the nrDLCarrierConfig object when configuring 5G downlink waveform generation.

This object defines the subcarrier spacing (SCS), time-domain and frequency-domain allocations, power, and payload of the SS burst.

Creation

Description

ssb = nrWavegenSSBurstConfig creates a default SS burst configuration object for 5G waveform generation.

example

ssb = nrWavegenSSBurstConfig(Name,Value) sets properties using one or more name-value pair arguments. Enclose each property name in quotes. For example, 'BlockPattern','Case B' specifies block pattern Case B.

Properties

expand all

Enable SS burst in 5G waveform generation, specified as one of these values.

  • 1 — Enable SS burst.

  • 0 — Disable SS burst.

Data Types: double | logical

Power scaling of the SS burst in dB, specified as a real number. Use this property to scale the power of the SS burst in the generated 5G waveform.

Data Types: double

Block pattern of the SS burst, specified as one of these values corresponding to the patterns from TS 38.213 Section 4.1 [1].

  • 'Case A' — Use this value for frequency range 1 (FR1) and 15 kHz SCS.

  • 'Case B' or 'Case C' — Use either of these values for FR1 and 30 kHz SCS.

  • 'Case D' — Use this value for frequency range 2 (FR2) and 120 kHz SCS.

  • 'Case E' — Use this value for FR2 and 240 kHz SCS.

Data Types: char | string

Block transmission bitmap in a 5 ms half-frame burst, specified as a 4-bit or 8-bit binary vector for FR1 or a 64-bit binary vector for FR2. This vector specifies which SS blocks are active in the SS burst.

Data Types: double

Period of the SS burst in ms, specified as 5, 10, 20, 40, 80, or 160.

Data Types: double

Subcarrier offset, specified as one these options.

  • For FR1, specify this property as an integer from 0 to 23. For block pattern Case B, KSSB must be even. Units are in terms of 15 kHz SCS.

  • For FR2, specify this property as an integer from 0 to 11. For block pattern Case D, KSSB must be even. For block pattern Case E, KSSB must be a multiple of 4. Units are in terms of SCS equal to the SubcarrierSpacingCommon property value.

The object increases the frequency offset of the SS burst from point A by KSSB subcarriers.

Dependencies

To enable this property, set the NCRBSSB property to a value other than [].

Data Types: double

Frequency offset from point A, specified as [] or an integer from 0 to 2199. Point A is the center of subcarrier 0 in the common resource block 0 (CRB 0). This property specifies the frequency offset of the SS burst in resource blocks (RBs) relative to point A.

  • For block pattern Case A, Case B and Case C, the unit of this property is expressed in terms of 15 kHz SCS.

  • For block pattern Case D and Case E, the unit of this property is expressed in terms of 60 kHz SCS.

When NCRBSSB is an empty vector, [], the SS burst is positioned in the center of the carrier with the SCS corresponding to the block pattern specified by the BlockPattern property.

Data Types: double

Source of the SS burst payload, specified as one of these options.

  • 'MIB', 'PN9-ITU', 'PN9', 'PN11', 'PN15', or 'PN23'

  • Two-element cell array consisting of one of the character vectors from the previous list and a random numeric seed (for example, {'PN9',7})

  • 24-bit binary vector

If you do not specify a random seed, all shift registers are initialized with an active state.

Data Types: double | cell | string | char

Position of the first demodulation reference signal (DM-RS) symbol in the physical downlink shared channel (PDSCH) system information block type 1 (SIB1), specified as 2 or 3.

Dependencies

To enable this property, set the DataSource property to 'MIB'.

Data Types: double

Cell barring, specified as 0 or 1. When CellBarred is set to 1, the cell enables the user equipment (UE) to camp on the cell.

Dependencies

To enable this property, set the DataSource property to 'MIB'.

Data Types: double | logical

Enable intrafrequency reselection, specified as one of these values.

  • 0 — Disable intrafrequency reselection.

  • 1 — Enable intrafrequency reselection of the same frequency cells.

Dependencies

To enable this property, set the DataSource property to 'MIB'.

Data Types: double | logical

Configuration type of the physical downlink control channel (PDCCH) SIB1, specified as an integer from 0 to 255.

Dependencies

To enable this property, set the DataSource property to 'MIB'.

Data Types: double

SIB1 SCS in kHz, specified as one of these values.

  • 15 or 30 for FR1

  • 60 or 120 for FR2

Dependencies

To enable this property, either set the DataSource property to 'MIB' or set the NCRBSSB property to a value other than [] and the BlockPattern property to 'Case D' or 'Case E'.

Data Types: double

Examples

collapse all

Create a downlink carrier configuration object with the specified property values.

cfgDL = nrDLCarrierConfig('FrequencyRange','FR2','ChannelBandwidth',100);
cfgDL.SCSCarriers{1} = nrSCSCarrierConfig('SubcarrierSpacing',120);
cfgDL.BandwidthParts{1} = nrWavegenBWPConfig('SubcarrierSpacing',120);

Create an SS burst configuration object for block pattern Case D, corresponding to 120 kHz SCS, and a block transmission bitmap for FR2.

ssb = nrWavegenSSBurstConfig('BlockPattern','Case D','TransmittedBlocks',ones(1,64));

Specify the SS burst frequency offset to be one third of the carrier size.

ssb.NCRBSSB = round(cfgDL.SCSCarriers{1}.NSizeGrid/3);

Specify the subcarrier offset of the SS burst, taking into account the specified block pattern. For block pattern Case D, the subcarrier offset value must be even.

ssb.KSSB = 2*4;

Specify the SS burst configuration for the downlink carrier configuration.

cfgDL.SSBurst = ssb;

References

[1] 3GPP TS 38.213. “NR; Physical layer procedures for control.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

See Also

Functions

Objects

Introduced in R2020b