Beacon Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

EMDK For Xamarin - 6.0

Overview

Beacon Manager (BeaconMgr) controls the signal transmitted by the Bluetooth Low Energy (BLE) radio of a powered-off device to help locate the device using Zebra Device Tracker software running on a second device, which detects the non-connectible advertising packets sent by the device being tracked.

Beacon Manager provides administrative control of beacon contents as well as the interval and power level of the transmitted signal to help balance power consumption with detectable range.

Main Functionality

  • Turn On/Off:
    • Beacon transmission when device is powered off
    • Beacon transmission when device is in "Airplane mode"
  • Set the beacon transmission power level
  • Set the transmission interval
  • Set beacon parameters for:
    • Beacon type
    • AltBeacon universally unique identifier (UUID)
    • AltBeacon ID1, ID2
    • Custom beacon data

Zebra Device Tracker

The Zebra Device Tracker user interface.

Device Tracker is preinstalled on most Zebra devices running Android 8.x Oreo and later and is compatible with many other devices and Android versions. Learn more about Zebra Device Tracker including supported devices and Android versions.


Beaconing Enable/Disable

Controls whether a beacon is transmitted by a device when the device is powered OFF. Disabled by default.

Parm Name: Beaconing

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

Android API: 29+

1 Turn ON Enables beacon transmission when device is powered off.

MX: 10.2+

Android API: 29+

2 Turn OFF Disables beacon transmission when device is powered off.

MX: 10.2+

Android API: 29+

Beaconing Airplane Mode Enable/Disable

Controls whether a beacon is transmitted by a device when powered OFF while in Airplane Mode. Disabled by default. Airplane Mode typically disables Bluetooth, cellular and Wi-Fi radios on the device, and can be controlled using Settings Manager.

Parm Name: BeaconingInAirplaneMode

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

Android API: 29+

1 Turn ON Enables beacon transmission when device is powered off when in Airplane Mode.

MX: 10.2+

Android API: 29+

2 Turn OFF Disables beacon transmission when device is powered off when in Airplane Mode.

MX: 10.2+

Android API: 29+

Beacon Type

Controls the type of beacon transmitted for locating a lost device when it's powered off. AltBeacon, an open specification for determiniing device proximity, is enabled by default. If "Custom" is selected (option 3), specify custom proximity protocols using the CustomBeaconData parameter.

Parm Name: BeaconType

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change device settings; any previously selected setting is retained.

MX: 10.2+

Android API: 29+

2 AltBeacon Enables the AltBeacon open device beacon specication (default).

MX: 10.2+

Android API: 29+

3 Custom Enables the custom custom beacon specification as entered in the CustomBeaconData parameter.

MX: 10.2+

Android API: 29+

Transmit Power Level

Used to enter the power level (in decibels per milliwatt, or dBm) for beacon transmission. Select a value that balances power consumption and transmission power to optimize device detection range. Option 1 (1 dBm) is selected by default.

Parm Name: TxPowerLevel

Option Name Description Note Requires
1 High (1 dBm) Sets the highest beacon transmission power level for maximum detection range. Uses the most device power (default).

MX: 10.2+

Android API: 29+

2 Medium (-7 dBm) Sets a moderate beacon transmission power level, conserving power and reducing detection range slightly.

MX: 10.2+

Android API: 29+

3 Low Power (-15 dBm) Sets a low beacon transmission power level, conserving power and reducing detection range.

MX: 10.2+

Android API: 29+

4 Ultra Low Power (-21 dBm) Sets a very low beacon transmission power level, conserving power while reducing detection range to a minimum.

MX: 10.2+

Android API: 29+

5 Custom (-127 dBm to 1 dBm) Allows a custom value to be entered using the CustomTxPowerLevel parameter.

MX: 10.2+

Android API: 29+

Custom Transmit Power Level

Used to enter a power level (in decibels per milliwatt, or dBm) for beacon transmission.

Input value rules:

  • An integer from -127–1

Shown if: Transmit Power Level is "Custom"

Parm Name: CustomTxPowerLevel

Requires:

  • MX: 10.2+
  • Android API: 29+

Transmit Interval

Used to enter the amount of time (in milliseconds) between each beacon transmission. Select a value that balances power consumption and transmission frequency to optimize device location. Option 1 (100 ms) is selected by default.

Parm Name: TxInterval

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no changes device settings; any previously selected setting is retained.

MX: 10.2+

Android API: 29+

1 Low Latency (100 ms) Causes a beacon to be transmitted approx. 10 times per second. This option uses the most device power.

MX: 10.2+

Android API: 29+

2 Balanced (250 ms) Causes a beacon to be transmitted approx. four times per second.

MX: 10.2+

Android API: 29+

3 Low Power (1000 ms) Causes a beacon to be transmitted once per second.

MX: 10.2+

Android API: 29+

4 Custom (100 ms to 10240 ms) Allows a custom value to be entered using the CustomTxInterval parameter.

MX: 10.2+

Android API: 29+

Custom Transmit Interval

Used to enter the amount of time (in milliseconds) between each beacon transmission. Allowable range is 100 ms (10 transmissions per second) and 10240 (one transmission every 10 seconds).

Input value rules:

  • An integer from 100–10240

Shown if: Transmit Interval is "Custom"

Parm Name: CustomTxInterval

Requires:

  • MX: 10.2+
  • Android API: 29+

Explicit Beacon UUID (checkbox)

Controls whether an explicit beacon UUID will be entered. If unchecked, a self-generated, device-specific UUID is used (default).

Parm Name: BeaconType

Option Name Description Note Requires
0 (unchecked) Disables entry of an explicit beacon UUID.

MX: 10.2+

Android API: 29+

1 (checked) Enables entry of an explicit beacon UUID.

MX: 10.2+

Android API: 29+

AltBeacon UUID

Used to enter a 32-character AltBeacon UUID in hexadecimal format.

The 20-byte AltBeacon data format contains 40 hexadecimal characters of information divided into the UUID (32 hexadecimal characters) plus ID1 (4 hexadecimal characters) and ID2 (4 hexadecimal characters).

Input value rules:

  • String of exactly 32 hexadecimal characters

Shown if: Beacon Type is "AltBeacon" and Explicit Beacon UUID is "checked"

Parm Name: AltBeaconUUID

Requires:

  • MX: 10.2+
  • Android API: 29+

AltBeacon ID1

Used to enter the ID1 portion of the AltBeacon UUID. Default value of EBEB is used if this parameter is missing or left blank.

The 20-byte AltBeacon data format contains 40 hexadecimal characters of information divided into the UUID (32 hexadecimal characters) plus ID1 (4 hexadecimal characters) and ID2 (4 hexadecimal characters).

Input value rules:

  • String of exactly four (4) hexadecimal characters

Shown if: Beacon Type is "AltBeacon"

Parm Name: ID1

Requires:

  • MX: 10.2+
  • Android API: 29+

AltBeacon ID2

Used to enter the ID2 portion of the AltBeacon UUID. Default value of ECDD is used if this parameter is missing or left blank.

The 20-byte AltBeacon data format contains 40 hexadecimal characters of information divided into the UUID (32 hexadecimal characters) plus ID1 (4 hexadecimal characters) and ID2 (4 hexadecimal characters).

Input value rules:

  • String of exactly four (4) hexadecimal characters

Shown if: Beacon Type is "AltBeacon"

Parm Name: ID2

Requires:

  • MX: 10.2+
  • Android API: 29+

Custom Beacon Data

Used to enter custom or proprietary UUID, URL and other data for beacon transmission. Accepts as many as 56 hexadecimal characters; must follow Bluetooth SIG Advertising format.

More Information:

Input value rules:

  • String from 1–56 numerals in Bluetooth SIG Advertising format

Parm Name: CustomBeaconData

Requires:

  • MX: 10.2+
  • Android API: 29+

Examples

Configure beaconing

Turn beaconing on:


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <parm name="Beaconing" value="1"/>
    </characteristic>
</wap-provisioningdoc>


Turn beaconing on in Airplane Mode:


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <parm name=" BeaconingInAirplaneMode " value="1"/>
    </characteristic>
</wap-provisioningdoc>


Configure default AltBeacon data:


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="BeaconType" value="2"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure explicit beacon data using AltBeacon:


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="BeaconType" value="2"/>
            <parm name="ExplicitBeaconUUID" value="1"/>
            <parm name="AltBeaconUUID" value="123456789abcdef123456789abcdef12"/>
            <parm name="ID1" value="AAAA"/>
            <parm name="ID2" value="BBBB"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure explicit beacon data using custom beacon:


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="BeaconType" value="3"/>
            <parm name="CustomBeaconData" value="1affF101beacd69cad1c04fca07052bcc0896b0f7764aaaabbbbc5"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure transmit (tx) interval (low latency):


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="TxInterval" value="1"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure transmit (tx) interval (custom value of 2000 ms):


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="TxInterval" value="4"/>
            <parm name="CustomTxInterval" value="2000"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure transmit (tx) power level (high):


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="TxPowerLevel" value="1"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>


Configure transmit (tx) power level (custom):


<wap-provisioningdoc>
    <characteristic type="BeaconMgr" version="10.2" >
        <characteristic type="BeaconParameters">
            <parm name="TxPowerLevel" value="5"/>
            <parm name="CustomTxPowerLevel" value="-24"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>