Main Content

configureBIG

Configure BIG between isochronous broadcaster and synchronized receiver

Since R2022a

collapse all in page

    Syntax

    cfgUpdatedBluetoothLEBIG = configureBIG(cfgBluetoothLEBIG,isoBroadcasterNode,receiverNode)

    Description

    cfgUpdatedBluetoothLEBIG = configureBIG(cfgBluetoothLEBIG,isoBroadcasterNode,receiverNode) configures the broadcast isochronous group (BIG) parameters at the Bluetooth® low energy (LE) isochronous broadcaster node, isoBroadcasterNode and at the receiver node, receiverNode by using the Bluetooth LE BIG configuration object, cfgBluetoothLEBIG.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    Check if the Communications Toolbox™ Wireless Network Simulation Library support package is installed. If the support package is not installed, MATLAB® returns an error with a link to download and install the support package.

    wirelessnetworkSupportPackageCheck;

    Create a Bluetooth LE node, specifying the role as "isochronous-broadcaster".

    isoBroadcasterNode = bluetoothLENode("isochronous-broadcaster");

    Create a Bluetooth LE node, specifying the role as "synchronized-receiver".

    receiverNode = bluetoothLENode("synchronized-receiver");

    Create a default BIG configuration object.

    bigConfig = bluetoothLEBIGConfig;

    Specify the number of BISes in the BIG, the number of subevents in each BIS event in the BIG, and the BIS arrangement.

    bigConfig.NumBIS = 2;
bigConfig.NumSubevents = 2;
bigConfig.BISArrangement = "interleaved";

    Specify the number of payloads associated with a BIS event.

    bigConfig.BurstNumber = 2;

    Specify the time interval between successive BIS subevents and the isochronous event interval.

    bigConfig.SubInterval = 0.006; % In seconds
bigConfig.ISOInterval = 0.015  % In seconds
    bigConfig = 
  bluetoothLEBIGConfig with properties:

        SeedAccessAddress: "78E52493"
                  PHYMode: "LE1M"
                   NumBIS: 2
              ISOInterval: 0.0150
               BISSpacing: 0.0022
              SubInterval: 0.0060
                   MaxPDU: 251
              BurstNumber: 2
    PretransmissionOffset: 0
          RepetitionCount: 1
             NumSubevents: 2
           BISArrangement: "interleaved"
                BIGOffset: 0
        ReceiveBISNumbers: 1
             UsedChannels: [0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36]
            InstantOffset: 6
    BaseCRCInitialization: "1234"

    Assign the BIG configuration to the Bluetooth LE nodes.

    configureBIG(bigConfig,isoBroadcasterNode,receiverNode);

    Input Arguments

    collapse all

    Bluetooth LE BIG configuration object, specified as a bluetoothLEBIGConfig object.

    Bluetooth LE node object for the isochronous broadcaster, specified as a bluetoothLENode object with the Role property set to "isochronous-broadcaster".

    Bluetooth LE node object for the synchronized receiver, specified as a bluetoothLENode object or a vector of bluetoothLENode objects with the Role property set to "synchronized-receiver". If you specify this input as a vector of bluetoothLENode objects:

    • The object function synchronizes all the receiver nodes to the same broadcaster node.

    • The isochronous broadcaster must be specified as a single bluetoothLENode object.

    Output Arguments

    collapse all

    Bluetooth LE BIG configuration object, returned as a bluetoothLEBIGConfig object.

    References

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

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

    Version History

    Introduced in R2022a

    See Also

    Objects