Bluetooth BR/EDR Waveform Generator

Create, impair, visualize, and export Bluetooth BR/EDR waveforms

Since R2023a

Description

The Bluetooth BR/EDR Waveform Generator app enables you to create, impair, visualize, and export modulated Bluetooth^® basic rate/enhanced data rate (BR/EDR) waveforms.

To use this app, you must configure the Wireless Waveform Generator app for Bluetooth BR/EDR waveform generation. Using this app, you can:

Generate Bluetooth BR/EDR waveforms with physical layer (PHY) mode as BR, EDR2M, or EDR3M.
Export the Bluetooth BR/EDR waveforms to your workspace or to a .mat, .bb, or .txt file.
Export Bluetooth BR/EDR waveform generation code and parameters to a runnable MATLAB^® script or a Simulink^® block.
- Use the exported script to generate your waveform, without the app, from the command line.
- Use the exported block as a waveform source in a Simulink model. For more information, see the Waveform From Wireless Waveform Generator App block.
Visualize the Bluetooth BR/EDR waveform in the spectrum analyzer, time scope, and constellation diagram.
Distort the Bluetooth BR/EDR waveform by adding radio frequency (RF) impairments, such as additive white Gaussian noise (AWGN), phase offset, frequency offset, DC offset, in-phase and quadrature (IQ) imbalance, and memoryless cubic nonlinearity.
Generate a waveform that you can transmit using a connected radio or lab test instrument. The Transmitter tab shows the signal generator, radio transmitter, and SDR options available. Transmitter options include signal generator (Instrument or NI-VST), radio transmitter (USRP N310, USRP N320, USRP N321, USRP X310, USRP X410), software defined radio (Pluto, USRP B/N/X, USRP E, Zynq Based).
- To transmit a waveform by using a lab signal generator, you must have Instrument Control Toolbox. For more information, see Quick-Control RF Signal Generator Requirements (Instrument Control Toolbox). If you select Transmitter, the connected lab test instrument must:
  - Support the TCP/IP interface.
  - Use one of these drivers — AgRfSigGen, RsRfSigGen, AgRfSigGen_SCPI, or RsRfSigGen_SCPI.
  - Be supported by the rfsiggen (Instrument Control Toolbox) function.
  If you select NI-VST, the connected lab test instrument must:
  - Support the PXI interface NI-RFSG option when an NI VST resource is selected.
  - Use the NI-RFSG driver.
  - Be supported by the rfsiggen (Instrument Control Toolbox) function.
- To transmit a waveform by using an SDR, connect one of the supported SDRs (ADALM-Pluto, USRP™, USRP embedded series, or Xilinx^® Zynq-based radios) to a computer with the associated add-on installed. For more information, see Transmit Using SDR.
- To transmit your waveforms over the air at full radio device rates, use the Wireless Testbench™ software and connect a supported radio to your computer. For a list of radios that support full device rates, see Supported Radio Devices (Wireless Testbench). This feature requires Wireless Testbench. For an example, see Transmit App-Generated Wireless Waveform Using Radio Transmitters.

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

For more information about the Wireless Waveform Generator app, see the Create Waveforms Using Wireless Waveform Generator App topic.

Open the Bluetooth BR/EDR Waveform Generator App

MATLAB Toolstrip: On the Apps tab, under Signal Processing and Communications, click the Icon to open wireless waveform generator. icon to open the Wireless Waveform Generator app. In the Wireless Waveform Generator app, select Icon to configure wireless waveform generator for Bluetooth BR/EDR waveform generation. from the Waveform Type tab.

MATLAB Command Prompt: Enter wirelessWaveformGenerator. This command opens the Wireless Waveform Generator app. To configure the app for Bluetooth BR/EDR waveform generation, in the Waveform Type section, select Bluetooth BR/EDR.

Examples

expand all

App-Based Bluetooth BR/EDR Waveform Generation

Open Live Script

Generate Bluetooth BR/EDR waveforms by using the Bluetooth BR/EDR Waveform Generator app.

Open Bluetooth BR/EDR Waveform Generator App

On the Apps tab of the MATLAB® toolstrip under Signal Processing and Communications, select the Bluetooth BR/EDR app icon. This opens the Wireless Waveform Generator app configured for Bluetooth BR/EDR waveform generation.

Generate Bluetooth BR/EDR Waveform

To generate a Bluetooth BR/EDR waveform, perform these steps.

Select the PHY Mode of the Bluetooth BR/EDR waveform you want to generate. The app enables you to generate a Bluetooth BR/EDR waveforms with PHY data rates of BR, EDR2M, or EDR3M.
Specify the values for Packet type, Device address, Logical transport address, Header control information, Modulation index, and Samples per symbol.
Specify the Bit source parameters.
To visualize the waveform, click Generate.

For example, this figure shows the Spectrum Analyzer and Constellation Diagram visualization results for a Bluetooth BR/EDR waveform generated by using random input bits in BR mode.

Export Generated Waveform

You can export the generated waveform and its parameters by clicking Export. You can export the waveform as one of these options.

A MATLAB script with the .m extension, which you can run to generate the waveform without the app
A file with a .bb, .mat, or .txt extension
Your MATLAB workspace, as a structure
A Simulink block, which you can use to generate the waveform in a Simulink model without the app

Transmit Bluetooth BR/EDR Waveform

Transmitting waveforms requires a license for Instrument Control Toolbox™. To transmit a generated waveform, click the Transmitter tab on the app toolstrip and configure the instruments. You can use any instrument supported by the rfsiggen function.

Transmit App-Generated Wireless Waveform Using Radio Transmitters

This example uses:

This example shows how to use the NI™ USRP™ N310, USRP N320, USRP N321, USRP X310, and USRP X410 radio transmitters available in the Wireless Waveform Generator app to transmit an app-generated waveform over the air (requires Wireless Testbench™). These radio transmitters enable you to transmit up to 2 GB of contiguous data over the air at the maximum baseband sample rate supported by the radio device.

Introduction

The Wireless Waveform Generator app is an interactive tool for creating, impairing, visualizing, and transmitting waveforms. Using a radio transmitter available in the app, you can transmit your generated waveform repeatedly over the air. You can also export the waveform generation and transmission parameters to a runnable MATLAB® script. This example shows how to configure these radio transmitters.

Although this example shows how to transmit an OFDM waveform, the same process applies for all waveform types that you can generate with the app.

Set Up for Radio Transmission

To use the radio transmitters in the app, you need to Install Support Package for NI USRP Radios (Wireless Testbench) and set up your radio using the Radio Setup (Wireless Testbench) wizard.

Generate Waveform for Transmission

Open the Wireless Waveform Generator app by clicking the app icon on the Apps tab, under Signal Processing and Communications. Alternatively, enter wirelessWaveformGenerator at the MATLAB command prompt.

In the Waveform Type section, select an OFDM waveform by clicking OFDM. In the leftmost pane of the app, adjust any configuration parameters for the selected waveform. Then generate the configuration by clicking Generate in the app toolstrip.

Configure Radio Transmitter

Select the Transmitter tab from the app toolstrip. In the transmitter gallery, select a radio transmitter.

In the leftmost pane of the app, select the name of a radio setup configuration that you saved using the Radio Setup (Wireless Testbench) wizard.

Set the center frequency, gain, and antennas configuration parameters. The app automatically sets the waveform sample rate based on the waveform that you generated earlier. The radio transmitter uses onboard data buffering to ensure contiguous data transmission at up to the maximum baseband sample rate supported by the radio device. To achieve the specified sample rate, the radio uses a Farrow rate converter. If necessary, use this list as a reference when setting the sample rate:

USRP N310 -- 120,945 Hz to 76.8 MHz, or one of: 122.88 MHz, 125 MHz, or 153.6 MHz
USRP N320 -- 196,851 Hz to 125 MHz, or one of: 200 MHz, 245.76 MHz or 250 MHz
USRP N321 -- 196,851 Hz to 125 MHz, or one of: 200 MHz, 245.76 MHz or 250 MHz
USRP X310 -- 181,418 Hz to 100 MHz, or one of: 184.32 MHz or 200 MHz
USRP X410 -- 241,890 Hz to 125 MHz, or one of: 245.76 MHz or 250 MHz

Transmit Waveform

To transmit the waveform continuously, click Transmit. To end the continuous transmission, click Stop transmission. To export the waveform generation and transmission parameters to a runnable MATLAB script, click Export MATLAB script.

References

[1] Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed December 1, 2022. https://www.bluetooth.com/.

[2] Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. https://www.bluetooth.com/.

Version History

Introduced in R2023a

expand all

R2024a: Export IQ data without metadata

The Bluetooth BR/EDR Waveform Generator app adds support for exporting IQ data to a .txt file or to a .mat file without metadata.

R2023b: NI-VST support added

You can now use the Bluetooth BR/EDR Waveform Generator app to transmit generated waveforms using NI-VST hardware supported by Instrument Control Toolbox™.