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.

The default nrWavegenSSBurstConfig object configures the SS burst with four active SS blocks and a periodicity of 20 ms, corresponding to the initial cell selection. The default configuration also specifies the SS burst to carry the master information block (MIB) and places the SS burst in the center of a carrier with 15 kHz subcarrier spacing (block pattern Case A). To update the frequency location of the SS burst, set the NCRBSSB and KSSB object properties to a nonempty value.

Creation

Syntax

ssb = nrWavegenSSBurstConfig

ssb = nrWavegenSSBurstConfig(Name,Value)

Description

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

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

Properties

Enable — Enable SS burst

1 (default) | 0

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

• 1 — Enable the SS burst.

• 0 — Disable the SS burst.

Data Types: double | logical

Power — Power scaling of SS burst in dB

0 (default) | real number

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

BlockPattern — Block pattern of SS burst

'Case A' (default) | 'Case B' | 'Case C' | 'Case D' | 'Case E'

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

TransmittedBlocks — Block transmission bitmap

[1 1 1 1] (default) | 4-bit, 8-bit, or 64-bit binary vector

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 — Period of SS burst in ms

20 (default) | 5 | 10 | 40 | 80 | 160

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

Data Types: double

NCRBSSB — Frequency offset from point A

[] (default) | integer from 0 to 2199

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

KSSB — Subcarrier offset

0 (default) | integer from 0 to 23

Subcarrier offset, specified as one these options.

• For FR1:

  • If SubcarrierSpacingCommon is 15, specify this property as an integer from 0 to 11.

  • If SubcarrierSpacingCommon is 30, specify this property as an integer from 0 to 23.

  In both cases, units are in terms of 15 kHz SCS. For block pattern Case B, KSSB must be even.

• 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

DataSource — Source of SS burst payload

'MIB' (default) | 'PN9-ITU' | 'PN9' | 'PN11''PN15' | 'PN23' | two-element cell array | 24-bit binary vector

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

DMRSTypeAPosition — Position of first DM-RS symbol

2 (default) | 3

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

CellBarred — Cell barring

0 (default) | 1

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

IntraFreqReselection — Enable intrafrequency reselection

0 (default) | 1

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

PDCCHConfigSIB1 — Configuration type of PDCCH SIB1

0 (default) | integer from 0 to 255

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

SubcarrierSpacingCommon — SIB1 SCS in kHz

15 (default) | 30 | 60 | 120

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

Configure SS Burst for 5G Downlink Waveform Generation

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;

Compatibility Considerations

Subcarrier offset range in SS burst configuration has changed

Behavior changed in R2021a

Starting in R2021a, the range of the KSSB property for FR1 depends on the value of the SubcarrierSpacingCommon property.

References

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

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.