Main Content

bluetoothTestWaveformConfig

Bluetooth BR/EDR or LE test waveform configuration parameters

    Description

    The bluetoothTestWaveformConfig object parameterizes the bluetoothTestWaveform function for generating the Bluetooth® basic rate/enhanced data rate (BR/EDR) or low energy (LE) test waveform.

    Creation

    Description

    cfgTestWaveform = bluetoothTestWaveformConfig creates a default Bluetooth BR/EDR or LE test waveform generation configuration object.

    example

    cfgTestWaveform = bluetoothTestWaveformConfig(Name=Value) sets properties by using one or more optional name-value arguments. For example, Mode="BR" sets the physical layer (PHY) transmission mode to basic rate.

    Properties

    expand all

    PHY transmission mode, specified as one of these values.

    Mode Value Characteristics
    "BR"
    • Modulation scheme is Gaussian frequency-shift keying (GFSK)

    • Data rate is 1 Mb/s

    "EDR2M"
    • Modulation scheme is π/4 differential quadrature phase-shift keying (DQPSK)

    • Data rate is 2 Mb/s

    "EDR3M"
    • Modulation scheme is 8 differential phase-shift keying (DPSK)

    • Data rate is 3 Mb/s

    "LE1M"
    • LE uncoded PHY

    • GFSK

    • Data rate is 1 Mb/s

    "LE2M"
    • LE uncoded PHY

    • Modulation scheme is GFSK

    • Data rate is 2 Mb/s

    "LE125K"
    • LE Coded PHY

    • Modulation scheme is GFSK

    • Data rate is 125 kb/s

    "LE500K"
    • LE Coded PHY

    • Modulation scheme is GFSK

    • Data rate is 500 kb/s

    Data Types: char | string

    Type of payload for which to generate test packet, specified as an integer in the range [0, 7].

    Data Types: double

    Payload length of Bluetooth LE test packet, specified as an integer in the range [0, 255]. This value specifies the number of bytes that the object processes in a packet.

    Dependencies

    To enable this property, set the Mode property to "LE1M", "LE2M", "LE125K", or "LE500K".

    Data Types: double

    Type of test packet, specified as one of these values corresponding to the Mode property.

    Mode Value PacketType Value
    "BR"
    • "DH1"

    • "DH3"

    • "DH5"

    • "DM1"

    • "DM3"

    • "DM5"

    "EDR2M"
    • "2-DH1"

    • "2-DH3"

    • "2-DH5"

    • "2-EV3"

    • "2-EV5"

    "EDR3M"
    • "3-DH1"

    • "3-DH3"

    • "3-DH5"

    • "3-EV3"

    • "3-EV5"

    "LE1M" or "LE2M"
    • "ConnectionCTE"

    • "Disabled"

    "LE125K" or "LE500K"
    • "Disabled"

    Because the constant tone extension (CTE) field position is the same for an LE test packet and the data packet, this object specifies the "ConnectionCTE" packet type for the CTE-based tests.

    Data Types: char | string

    This property is read-only.

    Fixed payload length of Bluetooth BR/EDR test packet, returned as a positive integer. Units are in bytes.

    Dependencies

    To enable this property, set the Mode property to "BR", "EDR2M", or "EDR3M". This table shows the valid values of this property for each PacketType of the "BR", "EDR2M", and "EDR3M" mode.

    Value of Mode Value of PacketTypeValue of FixedPayloadLength
    "BR""DH1"27
    "DH3"183
    "DH5"339
    "DM1"17
    "DM3"121
    "DM5"224
    "EDR2M""2-DH1"54
    "2-DH3"367
    "2-DH5"679
    "2-EV3"60
    "2-EV5"360
    "EDR3M""3-DH1"83
    "3-DH3"552
    "3-DH5"1021
    "3-EV3"90
    "3-EV5"540

    Data Types: double

    Samples per symbol, specified as a positive integer.

    Data Types: double

    Data whiten status, specified as "On" or "Off". If you set this value to "On", this object performs whitening on the header and payload.

    Data Types: char | string

    Whiten initialization, specified as a 7-bit binary-valued column vector. This value specifies the shift register initialization for data whitening or dewhitening.

    Dependencies

    To enable this property, set the WhitenStatus property to "On".

    Data Types: double

    Modulation index, specified as a scalar in the range [0.28, 0.35]. The object uses this value to perform GFSK modulation or demodulation.

    Dependencies

    To enable this property, set the Mode property to "BR", "EDR2M", or "EDR3M".

    Data Types: double

    Length of the CTE, specified as an integer in the range [2, 20]. This value specifies the length of the CTE in 8 microsecond units.

    Dependencies

    To enable this property, apply these configurations.

    • Set the Mode property to "LE1M" or "LE2M".

    • Set the PacketType property to "ConnectionCTE".

    Data Types: double

    Type of CTE, specified as [0; 0], [0; 1], or [1; 0].

    Dependencies

    To enable this property, apply these configurations.

    • Set the Mode property to "LE1M" or "LE2M".

    • Set the PacketType property to "ConnectionCTE".

    Data Types: double | logical

    Examples

    collapse all

    Create a default Bluetooth BR/EDR or LE test waveform configuration object.

    cfgTestWaveform = bluetoothTestWaveformConfig
    cfgTestWaveform = 
      bluetoothTestWaveformConfig with properties:
    
                    Mode: 'LE1M'
           PayloadLength: 255
              PacketType: 'Disabled'
             PayloadType: 0
        SamplesPerSymbol: 8
    
    

    Create a Bluetooth BR/EDR or LE test waveform configuration object, specifying the PHY transmission mode as EDR2M. Set the packet type to 2-DH1 and disable the data whiten status.

    cfgEDR2MTestWaveform = bluetoothTestWaveformConfig(Mode="EDR2M", ...
        PacketType="2-DH1", ...
        WhitenStatus="Off")
    cfgEDR2MTestWaveform = 
      bluetoothTestWaveformConfig with properties:
    
                      Mode: 'EDR2M'
              WhitenStatus: 'Off'
           ModulationIndex: 0.3200
                PacketType: '2-DH1'
               PayloadType: 0
          SamplesPerSymbol: 8
    
       Read-only properties:
        FixedPayloadLength: 54
    
    

    Create a default Bluetooth BR/EDR or LE test waveform configuration object. Set the PHY transmission mode to LE2M, packet type to connection-oriented CTE, and CTE length to 3.

    cfgLE2MTestWaveform = bluetoothTestWaveformConfig;
    cfgLE2MTestWaveform.Mode = "LE2M";
    cfgLE2MTestWaveform.PacketType = "ConnectionCTE";
    cfgLE2MTestWaveform.CTELength = 3
    cfgLE2MTestWaveform = 
      bluetoothTestWaveformConfig with properties:
    
                    Mode: 'LE2M'
           PayloadLength: 255
              PacketType: 'ConnectionCTE'
             PayloadType: 0
        SamplesPerSymbol: 8
               CTELength: 3
                 CTEType: [2x1 double]
    
    

    References

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

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

    Extended Capabilities

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

    Version History

    Introduced in R2022a