BLE Component

The BLE Component (Bluetooth Low Energy) is typically used with Bluetooth beacons, such as Kontakt beacons.

You add one BLE Component to your Project to enable Bluetooth, then each beacon is entered as a BLE Item under the BLE component. Each beacon requires its own ID number to be typed in so that the system can identify it. Then you add actions to the BLE Items that will occur when users come within the range of the beacon.

For example: the beacon’s interaction with the Project can map and direct consumers’ movement within a space; when the consumer comes close to the beacon, the project can notify them with a text popup of special offers, exclusive rewards or extra product information.

The BLE component can also be used with other types of Bluetooth device, such as with an Edison device, but we consider this advanced development: please refer to the IoT and SDK documentation.

Setting up a BLE Component

Starting Bluetooth Scanning

You will need to add a Set BLE Frequency action somewhere to start Bluetooth scanning. You might place this action on a Page “After Show” event, or on a Button click. If the user has not enabled Bluetooth on their device, they will usually be prompted to allow the App to use Bluetooth.

Go on to add BLE Items under the BLE component for each beacon.


Except for On Enable and On Disable these events require advanced programming knowledge. Refer to IoT/SDK documentation for the other events.

Actions affecting the BLE Component

There are several specific actions related to the BLE Component in the b>IoT Actions tab. Using either Set BLE Frequency or Enable Bluetooth is required to start operation.

If you’re only using Beacons, and no other types of Bluetooth device, only the Set BLE Frequency action is useful.

Setting BLE Characteristics

When using the Set BLE Characteristic Action, the following parameters are required:

Setting up a BLE Item

Using the plus button on the BLE Component you can add BLE Items for each Bluetooth device you want to scan for. These will be grouped under the BLE Component. These items can be beacons or other devices.

This help describes how to set up beacons. Please visit the IoT/SDK documentation for more technical help with Edison or other Bluetooth devices.

BLE Item properties

IDRequired. Pops up text editor panel to enter the Beacon ID, an 8 digit hexadecimal value such
as “A7EF0840”.
CloseDefines the signal strength that will be considered “Close”. Slider to indicate signal strength in
decibels (-180 to 0) The default setting is -80 and is generally a very appropriate level.
Very CloseDefines the signal strength that will be considered “Very Close”. Slider (-180 to 0) The default
setting is -60 and is generally a very appropriate level.

BLE Item Events

BLE Items have the following events that can occur:


The actions may be connected to the movement of a phone, your car keys or travel luggage as examples.