Bluetooth BR/EDR Waveform Generator
Create, impair, visualize, and export Bluetooth BR/EDR waveforms
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
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 the Wireless Waveform Generator app. In the Wireless Waveform Generator app, select from the Waveform Type tab.
MATLAB Command Prompt: Enter
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.
App-Based Bluetooth BR/EDR Waveform Generation
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
.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 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
Transmit App-Generated Wireless Waveform Using Radio Transmitters
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.
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 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 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 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 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
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 December 1, 2022. https://www.bluetooth.com/.
 Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. https://www.bluetooth.com/.
Introduced in R2023a