Main Content

getElementPosition

Positions of the antenna array elements

    Download Required: To use getElementPosition, first download Communications Toolbox™ Library for the Bluetooth® Protocol. For more information, see Get and Manage Add-Ons. Alternatively, see Communications Toolbox Library for the Bluetooth Protocol File Exchange.

    Description

    example

    pos = getElementPosition(cfg) returns the positions of the antenna array elements for the input BLE angle estimation configuration object. The object function uses the origin of the local coordinate system as the position of the first antenna of the antenna array.

    Examples

    collapse all

    Create a default BLE angle estimation configuration object.

    cfg = bleAngleEstimateConfig
    cfg = 
      bleAngleEstimateConfig with properties:
    
               ArraySize: 4
          ElementSpacing: 0.5000
            SlotDuration: 2
        SwitchingPattern: [1 2 3 4]
    
       Read-only properties:
        No properties.
    
    

    Return the positions of antenna array elements.

    pos = getElementPosition(cfg)
    pos = 3×4
    
             0         0         0         0
             0    0.5000    1.0000    1.5000
             0         0         0         0
    
    

    Input Arguments

    collapse all

    BLE angle estimation configuration object, specified as a bleAngleEstimateConfig object.

    Output Arguments

    collapse all

    Positions of the antenna array elements, returned as a 3-by-N matrix, where N is the number of antenna array elements specified by the cfg input. Each column in pos defines the position of the antenna array element in the form [x; y; z] in the local coordinate system.

    Data Types: double

    References

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

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

    [3] Wooley, Martin. Bluetooth Direction Finding: A Technical Overview. Bluetooth Special Interest Group (SIG), Accessed April 6, 2020, https://www.bluetooth.com/.

    Extended Capabilities

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

    Introduced in R2020b