Main Content

bluetoothTestWaveformConfig

Bluetooth BR/EDR or LE test waveform configuration parameters

Since R2022a

expand all in page

    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

    Syntax

    cfgTestWaveform = bluetoothTestWaveformConfig
    cfgTestWaveform = bluetoothTestWaveformConfig(Name=Value)

    Description

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

    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.

    example

    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

    • Modulation scheme is 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 property 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 one of these values.

    • Scalar in the range [0.28, 0.35] — For Mode values "BR", "EDR2M", and "EDR3M"

    • Scalar in the range [0.45, 0.55] — For Mode values "LE1M", "LE2M", "LE125K", and "LE500K"

    This property specifies the modulation index that the object uses while implementing Gaussian frequency shift keying (GFSK) modulation or demodulation.

    Data Types: double

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

    Dependencies

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

    Data Types: double

    Length of the CTE, specified as an integer in the range [2, 20]. This property 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

    Open Live Script

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

    cfgTestWaveform = bluetoothTestWaveformConfig
    cfgTestWaveform = 
  bluetoothTestWaveformConfig with properties:

                Mode: 'LE1M'
       PayloadLength: 255
     ModulationIndex: 0.5000
         PulseLength: 1
          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
     ModulationIndex: 0.5000
         PulseLength: 1
          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, 2023. https://www.bluetooth.com/.

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

    [3] Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. Bluetooth Test Suite, RFPHY.TS.p20 edition 2. Revision date July 28, 2024https://www.bluetooth.com/.

    [4] Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. Bluetooth Test Suite, RF.TS.p33 edition 2. Revision date July 14, 2024https://www.bluetooth.com/.

    Extended Capabilities

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

    Version History

    Introduced in R2022a

    expand all

    See Also

    Functions

    Objects

    Topics