Main Content

configureBIG

Configure BIG parameters at Bluetooth LE isochronous broadcaster and receiver

Since R2022a

    Description

    example

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

    Examples

    collapse all

    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 with the Role property set to "synchronized-receiver".

    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