bleLLDataChannelPDU

Generate Bluetooth LE LL data channel PDU

Syntax

dataLLpdu = bleLLDataChannelPDU(cfgLLData)

dataLLpdu = bleLLDataChannelPDU(cfgLLData,LLPayload)

Description

dataLLpdu = bleLLDataChannelPDU(cfgLLData) generates a Bluetooth^® low energy (LE) link layer (LL) data channel protocol data unit (PDU), dataLLpdu, for a given Bluetooth LE LL data channel configuration object, cfgLLData. Use this syntax to generate a Bluetooth LE LL control PDU.

dataLLpdu = bleLLDataChannelPDU(cfgLLData,LLPayload) generates a Bluetooth LE LL data channel PDU, dataLLpdu, containing the upper-layer payload LLPayload for a given Bluetooth LE LL data channel configuration object, cfgLLData. Use this syntax to generate a Bluetooth LE LL data PDU.

Examples

Generate Bluetooth LE LL Control PDU of Type Connection Update Indication

Create a default Bluetooth LE LL control PDU configuration object.

cfgControl = bleLLControlPDUConfig

cfgControl = 
  bleLLControlPDUConfig with properties:

                Opcode: 'Connection update indication'
            WindowSize: 1
          WindowOffset: 0
    ConnectionInterval: 6
     PeripheralLatency: 0
     ConnectionTimeout: 10
               Instant: 0

Create a Bluetooth LE LL data channel PDU configuration object for a control PDU of type 'Connection update indication'.

cfgLLData = bleLLDataChannelPDUConfig('LLID','Control', ...
    'ControlConfig',cfgControl)

cfgLLData = 
  bleLLDataChannelPDUConfig with properties:

                 LLID: 'Control'
                 NESN: 0
       SequenceNumber: 0
             MoreData: 0
    CRCInitialization: '012345'
        ControlConfig: [1×1 bleLLControlPDUConfig]

Generate a Bluetooth LE LL data channel PDU of type 'Connection update indication' by using the configuration object 'cfgLLData'. Display the PDU length in octets.

dataLLpdu = bleLLDataChannelPDU(cfgLLData);
numel(dataLLpdu)/8

ans = 
17

Display the first octet of the generated BLE LL data channel PDU.

dataLLpdu(1:8)

ans = 8×1

     1
     1
     0
     0
     0
     0
     0
     0

Generate Bluetooth LE LL Data PDU Using Upper-Layer Payload

Create a default Bluetooth LE LL data channel PDU configuration object.

cfgLLData = bleLLDataChannelPDUConfig

cfgLLData = 
  bleLLDataChannelPDUConfig with properties:

                 LLID: 'Data (continuation fragment/empty)'
                 NESN: 0
       SequenceNumber: 0
             MoreData: 0
    CRCInitialization: '012345'

Generate a Bluetooth LE LL data PDU by using the corresponding configuration object, 'cgLLData' and the upper-layer payload '030004000A0100'. Display the PDU length in octets.

dataLLpdu = bleLLDataChannelPDU(cfgLLData,'030004000A0100');
numel(dataLLpdu)/8

ans = 
12

Display the first octet of the generated BLE LL data PDU.

dataLLpdu(1:8)

ans = 8×1

     1
     0
     0
     0
     0
     0
     0
     0

Input Arguments

cfgLLData — Bluetooth LE LL data channel configuration object

bleLLDataChannelPDUConfig object

Bluetooth LE LL data channel configuration object, specified as a bleLLDataChannelPDUConfig object.

LLPayload — Upper-layer payload

character vector | string scalar | numeric vector | character array

Upper-layer payload, specified as one of these types:

• Character vector — This vector represents octets in hexadecimal format.

• String scalar — This scalar represents octets in hexadecimal format.

• Numeric vector of elements in the range [0,255] — This vector represents octets in decimal format.

• n-by-2 character array — Each row represents an octet in hexadecimal format. n represents total number of rows.

Data Types: char | string | double

Output Arguments

dataLLpdu — Generated Bluetooth LE LL data channel PDU

binary column vector

Generated Bluetooth LE LL data channel PDU, returned as a binary column vector.

References

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

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

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• When the CRCInitialization property of the bleLLDataChannelPDUConfig object is set to constant, code generation is possible.

Version History

Introduced in R2019b