Bluetooth LE Waveform Generator
Create, impair, visualize, and export Bluetooth LE waveforms
The Bluetooth Low Energy Waveform Generator app enables you to create, impair, visualize, and export modulated Bluetooth® low energy (LE) waveforms.
To use this app, you must configure the Wireless Waveform Generator app for Bluetooth LE waveform generation. Using this app, you can:
Generate Bluetooth LE waveforms with physical layer (PHY) data rate of 2 Mbps, 1 Mbps, 500 Kbps, or 125 Kbps.
Export the Bluetooth LE waveform to your workspace or to a
Export Bluetooth LE waveform generation 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 LE waveform in the spectrum analyzer, time scope, constellation diagram, and eye diagram.
Distort the Bluetooth LE 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 waveform that you can transmit using a connected radio or lab test instrument.
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 a waveform by using lab test instrument, connect one of the instruments supported by the
rfsiggen(Instrument Control Toolbox) function to your computer. For more information, see Quick-Control RF Signal Generator Requirements (Instrument Control Toolbox). This feature requires Instrument Control Toolbox.
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 LE 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 Create Waveforms Using Wireless Waveform Generator App.
Open the Bluetooth LE Waveform Generator App
MATLAB Toolstrip: On the Apps tab, under Signal Processing and Communications, click the app icon.
MATLAB Command Prompt: Enter
command opens the Wireless Waveform Generator app. To
configure the app for Bluetooth LE waveform generation, in the Waveform Type section,
select Bluetooth Low Energy.
App-Based Bluetooth LE Waveform Generation
Generate Bluetooth® low energy (LE) waveforms by using the Bluetooth LE Waveform Generator app.
Open Bluetooth LE Waveform Generator App
On the Apps tab of the MATLAB® toolstrip under Signal Processing and Communication, select the Bluetoth Low Energy app icon. This opens the Wireless Waveform Generator app configured for Bluetooth LE waveform generation.
Generate Bluetooth LE Waveform
To generate a Bluetooth LE waveform, perform these steps.
Select the PHY Data rate of the Bluetooth LE waveform you want to generate. The app enables you to generate Bluetooth LE waveforms with PHY data rates of 2 Mbps, 1 Mbps, 500 Kbps, or 125 Kbps.
Specify the values for Samples per symbol, Channel index, and Access address.
Specify the Bit source value.
To visualize the waveform, click Generate.
For example, this figure shows the Time Scope, Spectrum Analyzer, Constellation Diagram, and Eye Diagram visualization results for a Bluetooth LE waveform generated by using random input bits at a data rate of 2 Mbps.
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
.mextension, which you can run to generate the waveform without the app
A file with a
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 LE 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
Transmit App-Generated Wireless Waveform Using Radio Transmitters
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 full radio device rate.
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. Configure these radio transmitters 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 must install the Wireless Testbench Support Package for NI USRP Radios add-on, and set up your radio outside the app. For more information, see Connect and Set Up NI USRP Radios (Wireless Testbench).
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 Waveform pane of the app, specify the parameters of OFDM Waveform Configuration, QAM Waveform Configuration, and Filtering Configuration 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 Waveform pane of the app, select the name of a radio setup configuration that you saved using the Radio Setup wizard. For more information, see Connect and Set Up NI USRP Radios (Wireless Testbench).
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 full hardware sample rate. If necessary, to achieve the specified sample rate, the radio uses a Farrow rate converter. 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
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.
 Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed November 28, 2022. https://www.bluetooth.com/.
 Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. https://www.bluetooth.com/.
Introduced in R2022a