bleWaveformGenerator

Generate Bluetooth LE PHY waveform

collapse all in page

    Syntax

    waveform = bleWaveformGenerator(message)
    waveform = bleWaveformGenerator(message,Name=Value)

    Description

    waveform = bleWaveformGenerator(message) generates waveform, a time-domain Bluetooth® low energy (LE) physical layer (PHY) waveform by using the input information bits, message.

    example

    waveform = bleWaveformGenerator(message,Name=Value) also specifies options using one or more name-value pair arguments. For example, 'Mode'="LE2M" specifies the generating mode value of the desired Bluetooth LE waveform.

    example

    Examples

    collapse all

    Open Live Script

    Create an input message column vector of length 2056 containing random binary values. Set the symbol rate to default value.

    message = randi([0 1],2056,1);
symbolRate = 1e6;

    Generate the Bluetooth LE waveform.

    waveform = bleWaveformGenerator(message);

    Create a spectrum analyzer System object to display the frequency spectrum of the generated Bluetooth LE waveform. Set the sample rate of the frequency spectrum.

    scope = spectrumAnalyzer;
scope.SampleRate = 8*symbolRate;

    Plot the Bluetooth LE waveform.

    scope(waveform);

    Open Live Script

    Create an input message column vector of length 640 containing random binary values.

    message = randi([0 1],640,1);

    Specify the values of the generating PHY mode and samples per symbol. Set symbol rate to the default value.

    phyMode = "LE125K";
sps = 4;
symbolRate = 1e6;

    Create a spectrum analyzer System object™ to display the frequency spectrum of the generated Bluetooth LE waveform. Specify the sample rate of the frequency spectrum.

    scope = spectrumAnalyzer;
scope.SampleRate = sps*symbolRate;

    Generate a Bluetooth LE waveform by specifying the modulation index and the length of the frequency pulse shape.

    waveform = bleWaveformGenerator(message,"Mode",phyMode,"SamplesPerSymbol",sps, ... 
    "ModulationIndex",0.52,"PulseLength",3);

    Visualize the Bluetooth LE waveform.

    scope(waveform);

    Open Live Script

    Specify a connection data channel protocol data unit (PDU) for angle of departure (AoD) constant tone extension (CTE). 

    pduHex = '1B820127';                      % Valid PDU in hexadecimal
pdu = int2bit(hex2dec(pduHex),32,false);

    Generate and append cyclic redundancy check (CRC) to the PDU.

    cfgCRC = crcConfig(Polynomial='z^24+z^10+z^9+z^6+z^4+z^3+z+1', ...
    InitialConditions=int2bit(hex2dec('555551'),24), ...
    DirectMethod=true);
pduCRC = crcGenerate(pdu,cfgCRC);

    Generate the Bluetooth LE waveform.

    waveform = bleWaveformGenerator(pduCRC,'ChannelIndex',36, ...
    'DFPacketType','ConnectionCTE');

    Input Arguments

    collapse all

    Input message bits, specified as a binary-valued column vector of numerical or logical values. This input contains the protocol data unit (PDU) and cyclic redundancy check (CRC) data. The maximum length of this value is 2088 bits.

    Data Types: double | single | int8 | logical

    Name-Value Arguments

    collapse all

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

    Example: bleWaveformGenerator(message,Mode="LE2M",ChannelIndex=36)

    Note

    For information about connection CTE and connectionless CTE direction finding packet generation, see Bluetooth Packet Structure.

    PHY generating mode, Specified as a name–value pair consisting of 'Mode' and "LE1M", "LE2M", "LE500K", or "LE125K".

    Data Types: string

    Channel index, Specified as a name–value pair consisting of 'ChannelIndex'and an integer in the range [0, 39]. For data channels, this value must be in the range [0, 36]. The data-whitening block uses this value to randomize the bits.

    Data Types: double | numeric

    Samples per symbol, Specified as a name–value pair consisting of 'SamplesPerSymbol' and a positive integer. The function uses this value for the Gaussian frequency-shift keying (GFSK) modulation.

    Data Types: double | numeric

    Access address, Specified as a name–value pair consisting of 'AccessAddress' and a 32-bit column vector of numerical or logical values.

    Data Types: numeric | logical

    Type of direction finding packet, Specified as a name–value pair consisting of "DFPacketType" and "ConnectionlessCTE", "ConnectionCTE", or "Disabled".

    Data Types: string

    Data whiten status, specified as 'On' or 'Off'. To perform whitening on message, set this value to 'On'.

    Data Types: char | string

    Modulation index, specified as a scalar in the range [0.45, 0.55]. This input specifies the modulation index that this function uses while performing GFSK modulation.

    Data Types: double | numeric

    Length of the frequency pulse shape, specified as an integer in the range [1, 4]. Units are in symbol intervals.

    Data Types: double | numeric

    Data type of the generated waveform, specified as "single" or "double". If you do not specify this input argument, the data type of waveform output is:

    • single when the data type of the message input is single

    • double when the data type of the message input is double or int8

    Data Types: string

    Output Arguments

    collapse all

    Output Time-domain waveform, returned as a complex-valued column vector of size Ns-by-1, where Ns represents the number of time-domain samples. The function returns this output in the form of complex in-phase quadrature (IQ) samples. If you specify the Mode input as "LE1M" or "LE2M", this output includes an additional 40 bits containing a combination of the access address and preamble length. For more information, see Bluetooth Packet Structure.

    Data Types: double | single

    References

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

    [2] Bluetooth Core Specifications Working Group. "Bluetooth Core Specification" v6.1. https://www.bluetooth.com/specifications/specs/core-specification-6-1/.

    Extended Capabilities

    expand all

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

    Version History

    Introduced in R2019b

    expand all

    See Also

    Apps

    Functions

    Objects

    Topics