Main Content

5G Waveform Generator

Create, impair, visualize, and export 5G NR waveforms

Description

The 5G Waveform Generator app enables you to create, impair, visualize, and export 5G NR waveforms.

The app provides these capabilities by using the Wireless Waveform Generator app configured for 5G NR waveform generation. Using the app, you can:

  • Generate NR uplink and downlink carrier waveforms.

  • Generate NR test models (NR-TM) for FR1, as defined in TS 38.141-1 Section 4.9.2 [1].

  • Generate NR-TM for FR2, as defined in TS 38.141-2 Section 4.9.2 [2].

  • Generate NR downlink fixed reference channel (FRC) waveforms, as defined in TS 38.101-1 Annex A.3 [3].

  • Generate NR uplink FRC waveforms, as defined in TS 38.104 Annex A [4].

  • Export the NR waveform to your workspace or to a .mat or a .bb file.

  • Export NR uplink or downlink waveform generation parameters to a runnable MATLAB® script.

    Note

    You can use the MATLAB script to programmatically generate your waveform from the command line, without the app.

  • Visualize the NR waveform in spectrum analyzer and OFDM grid.

  • Distort the NR waveform by adding RF impairments, such as AWGN, phase offset, frequency offset, DC offset, IQ imbalance, and memoryless cubic nonlinearity.

  • Generate an NR waveform that you can transmit using a connected lab test instrument. The app can transmit a waveform by using instruments supported by the rfsiggen (Instrument Control Toolbox) function. Use of the transmit feature in the app requires Instrument Control Toolbox™ software. For more information, see the documentation for Instrument Control Toolbox.

To create, impair, visualize, and export waveforms other than NR waveforms, you must reconfigure the app. For a full list of features, see the Wireless Waveform Generator app.

For more information, see Use Wireless Waveform Generator App.

5G Waveform Generator app

Open the 5G Waveform Generator App

MATLAB Toolstrip: On the Apps tab, under Signal Processing and Communications, click the app icon.

MATLAB Command Prompt: Enter nrWaveformGenerator. This command opens the Wireless Waveform Generator app configured for 5G waveform generation.

Examples

expand all

This example shows how to generate standard-compliant NR uplink and downlink carrier waveforms, NR test models (NR-TM), and NR uplink and downlink fixed reference channel (FRC) waveforms by using the 5G Waveform Generator app. The example also discusses waveform exporting and transferring options available in the app.

Open 5G Waveform Generator App

On the Apps tab of the MATLAB® toolstrip, under Signal Processing and Communications, click the 5G Waveform Generator app icon. This app opens the Wireless Waveform Generator app configured for 5G waveform generation.

Select 5G NR Waveform

In the Waveform Type section on the app toolstrip, click the waveform you want to generate. Select one of these waveforms.

  • 5G Downlink

  • 5G Uplink

  • 5G Downlink FRC

  • 5G Uplink FRC

  • 5G Test Models (NR-TM)

Generate 5G NR Waveform

Depending on the selected waveform, the app presents specific tabs where you can set the parameters of the selected waveform. On the app toolstrip, in the Generation section, you can add impairments and set visualization tools applicable for the selected waveform. To visualize the waveform on the selected visualization tools, click Generate.

For example, this figure shows the visualization results of a downlink FRC waveform using default parameters.

Export Generated Waveform to MATLAB Workspace or File

To export the generated waveform, on the app toolstrip, in the Export section, select Export to Workspace or Export to File. You can export the waveform as a structure to the MATLAB workspace or a MAT-file (.mat). You can also export the waveform to a baseband file (.bb).

Export Waveform Configuration Parameters to MATLAB Script

To export waveform configuration parameters, on the app toolstrip, in the Export section, select Export to MATLAB Script. With this option, you can export the waveform configuration parameters into a runnable MATLAB script that you can use to generate the waveform outside the app. This option is only available for NR uplink and downlink waveforms.

Transmit 5G NR Waveform

To transmit the generated waveform, on the app toolstrip, click on the Transmitter tab and set up the instruments. You can use all the instruments supported by the rfsiggen (Instrument Control Toolbox) function. This feature requires Instrument Control Toolbox.

References

[1] 3GPP TS 38.141-1. “NR; Base Station (BS) conformance testing Part 1: Conducted conformance testing.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[2] 3GPP TS 38.141-2. “NR; Base Station (BS) conformance testing Part 2: Radiated conformance testing.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[3] 3GPP TS 38.101-1. “NR; User Equipment (UE) radio transmission and reception; Part 1: Range 1 Standalone.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[4] 3GPP TS 38.104. “NR; Base Station (BS) radio transmission and reception.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Introduced in R2020a