iBKS Config Tool User Manual – Android

ABSTRACT

This document is an iBKS Config Tool App User Manual that explains how to use all its functions.

AUDIENCE

This document is focused for users with basic knowledge of beacons

IMPORTANT

The new iBKS Config Tool requires:

  • Android 5 or higher
  • Both bluetooth and location must be enabled on the mobile device

Install & setup

  1. Install the App by giving access permissionsinstall_setup_1
  2. Open the Appinstall_setup_2
  3. Check the first tips by scrolling left and click “Done”install_setup_3
  4. Choose a google account to associate withinstall_setup_4
  5. The first time every feature is open, a virtual guide appears to help with some tipsinstall_setup_5
  6. Select a project for registering EID by clicking on the menu in the top right sideinstall_setup_6
  7. Choose one project from the list (choose none if you don’t have any)install_setup_7

2. Connect to a beacon

  1. Click on the scan button to find the specific beacon to connect (you may need to wait for the scan to end or once you find the beacon, click on the scan button again to stop it)screenshot_20161109-102122
  2. Click on the beacon to connect. Connected!connect_beacon_2
  3. If this screen does not appear, the beacon could be in a non-connectable mode. Reset the beacon to enter in a connectable mode period. connect_beacon_3

IMPORTANT

  1. When scanning, the beacons shown with grey background, are NOT connectable.
  1. The battery life estimation shown (in months) indicates how long a new battery is expected to last with the current configuration set.

When the configuration is changed, after saving, the battery life estimation is updated.

3. Configure Eddystone Service

  1. Being connected, click on Eddystone Service to expand (the current configuration is shown)configure_eddystone_service_1
    1. Select the slot to configure
    2. Choose Eddystone type
    3. Fill all the required fieldsscreenshot_20161109-103205_2
      70912d2ac4b5441beae8618b50dbc918a42fd24e5b8d09b373pimgpsh_fullsize_distr Check Annex I for further information
  2. Disconnect to save changes
    1. Click on returnclick-on-return-bo
    2. Click on return click-2
    3. Click on “YES”configure_eddystone_service_3_3
    4. Click OKconfigure_eddystone_service_3_4

4. Configure iBeacon Service

  1. Being connected, click on iBeacon Service to expand (the current configuration is shown)configure_ibeacon_service_1
    1. Select the slot to configure
    2. Fill all the required fieldsscreenshot_20161109-104054_270912d2ac4b5441beae8618b50dbc918a42fd24e5b8d09b373pimgpsh_fullsize_distr Check Annex II for further information
  2. Disconnect to save changes
    1. Click on returnclick3
    2. Click on returnconfigure_ibeacon_service_3_2
    3. Click on “YES”configure_ibeacon_service_3_3
    4. Click OKconfigure_ibeacon_service_3_4

5. Change Connectable Mode

  1. Being connected, click on Global Service to expand (the current configuration is shown)change_connect_mode_1
  2. Select modechange_connect_mode_2
  3. Disconnect to save changes
    1. Click on returnchange_connect_mode_3_1
    2. Click on returnchange_connect_mode_3_2
    3. Click on “YES”change_connect_mode_3_3
    4. Click OKchange_connect_mode_3_4

6. Configure Connectable Window

70912d2ac4b5441beae8618b50dbc918a42fd24e5b8d09b373pimgpsh_fullsize_distr How does it work? See Annex III

  1. Being connected, click on Global Service to expand (the current configuration is shown)configure_connectable_window_1
    1. Enable “Connectable mode”.
    2. Enable connectable window.
    3. Set connectable period.
    4. Set connectable window.configure_connectable_window_2
  2. Disconnect to save changes
    1. Click on returnconfigure_connectable_window_3_1
    2. Click on returnconfigure_connectable_window_3_2
    3. Click on “YES”configure_connectable_window_3_3
    4. Click OKconfigure_connectable_window_3_4

7. Configure Advertising Window

70912d2ac4b5441beae8618b50dbc918a42fd24e5b8d09b373pimgpsh_fullsize_distr How does it work? See Annex IV

  1. Being connected, click on Global Service to expand (the current configuration is shown)configure_advertising_window_1
    1. Enable “Advertising Window”.
      (if disabled, it advertises all the time)
    2. Set starting time
    3. Set ending timeconfigure_advertising_window_2
    1. Click on returnconfigure_advertising_window_3_1
    2. Click on returnconfigure_advertising_window_3_2
    3. Click on “YES”configure_advertising_window_3_3
    4. Click OKconfigure_advertising_window_3_4

8. Lock Beacon

  1. Being connected, click on Global Service to expand (the current configuration is shown)lock_beacon_1
  2. Click on “Lock and Disconnect”lock_beacon_2
  3. A warning message appears. Click on YES if you agree.lock_beacon_3

    IMPORTANT

    The device gets locked with the previous password saved. By default, the password is 32 ‘0’ chars (00000000….000). Check “Change password” to change it.

9. Disable relock Beacon

  1. When connecting, in order to unlock the beacon, the password will be requested.disable_relock_beacon_1
  2. Being connected, click on Global Service to expand (the current configuration is shown)disable_relock_beacon_2
  3. Click on “Disable Relock”disable_relock_beacon_3

10. Change Password

  1. Being connected, click on the menu on the top right sidechange_pass_1
  2. In the menu, click on “Change Password”change_pass_2
  3. Enter current password and the new one. Then, click on SAVEchange_pass_3

    IMPORTANT

    When a new password is set the beacon automatically gets locked. In case you want to keep it unlocked, disable relock to retrieve it.

11. Change Device Name

  1. Being connected, click on the menu on the top right sidechange_device_name_1
  2. In the menu, click on “Change Device Name”change_device_name_2
  3. Enter the new name and click on CHANGEchange_device_name_3
  4. A warning message appears. Click on YES if you agree.change_device_name_4

12. Factory Reset

  1. Being connected, click on the menu on the top right sidefactory_reset_1

    IMPORTANT

    For the factory reset the beacon must be connected from the locked state. So:

      1. Lock the beacon (see chapter 8)
      2. Connect to the beacon entering password
      3. Apply factory reset
  2. In the menu, click on “Change Device Name”factory_reset_2
  3. A warning message appears. Click on YES if you agree.factory_reset_3

13. Add deployment file and scan iBKS beacons

IMPORTANT

  • The deployment file is provided only for orders of 100 beacons or more and when a custom configuration for each beacon was requested.
  • The deployment file cannot be used for mass programming. It is for deployment purposes and it is only used to show the configuration of the beacons according to their QR code without the need to connect to it.
  1. Click on “Deployment” tab aaaa
  2. Click on “Add Deployment File” and select the CSV file you previously received from Accent Systems. bbbbbbbbbbbbb
  3. Click Scan button to start scanning iBKS beacons
    1. Click on “Scan” ccccccccc
    2. Scan a beacon screenshot_2016-09-12-11-41-05
    3. Get iBKS beacon deployment info dddddddd

Annex I. Eddystone fields configuration guide

1. Common fields

ADVERTISING INTERVAL
  • Advertising Interval in milliseconds (ms)
  • UID, EID & URL: from 100ms to 10000ms
  • TLM: from 1000ms to 65535ms (as long as there is at least one slot active a part of this. Otherwise the maximum is 10000ms).
TX. POWER
  • Radio TX power values in hexadecimal (00 – 07). Next table shows the equivalence between power and hexadecimal value to be set:

radio-power

CAL. POWER 0m (dBm)
  • Calibration Power: The transmit power as measured zero meters away from the beacon.
  • Values between -126dBm and 127dBm.
  • We suggest -21dBm as default configuration value and we also encourage you to update it after calibrating again once the beacon is placed.

2. Eddystone UID configuration

UID
  • 16-byte hexadecimal (32 hex chars)10-byte Namespace + 6-byte Instance. Example: BA1C51BAB3147EFEE8E5252423222120
Register Eddystone-UID
  • When checked, it registers the eddystone UID 16-byte ID in the project selected of the google platform. Register the UID allows to set attachments such as Nearby Notifications.
  • If checkbox not enabled, indicates that the UID is already registered by you or another user.
Register Eddystone-UID
  • When checked, it registers the eddystone UID 16-byte ID in the project selected of the google platform. Register the UID allows to set attachments such as Nearby Notifications.
  • If checkbox not enabled, indicates that the UID is already registered by you or another user.

3. Eddystone EID configuration

ID
  • 16-byte hexadecimal (32 hex chars)10-byte Namespace + 6-byte Instance. Example: BA1C51BAB3147EFEE8E5252423222120
  • The ID status field shows the ID status in the google platform: if the ID is still available, if it is already registered, if it is still synchronized, …
EID Rotaion Period (K)
  • It sets from several predefined values how often the advertised encrypted ID is changed.

4. Eddystone URL configuration

URL
  • 18-ASCII chars maximum taking into account the following prefixes and suffixes are encoded to a 1 char size:
    http://
    https://
    http://www.
    https://www.
    .com/
    .org/
    .edu/
    .net/
    .info/
    .biz/
    .gov/
    .com
    .org
    .edu
    .net
    .info
    .biz
    .gov

    For example, http://www.accent-systems.com would be “http://www.” = 1 char, “accent-systems” = 14 chars and “.com” = 1 char, being 16 chars in total amount.

Annex II. iBeacon fields configuration guide

ADVERTISING INTERVAL

Advertising Interval in milliseconds (ms) from 100ms to 10000ms

TX. POWER

Radio TX power values in hexadecimal (00 – 07). Next table shows the equivalence between power and hexadecimal value to be set:
radio-power

CAL. POWER 1m (dBm)
  • Calibration Power: The transmit power as measured 1 meter away from the beacon.
  • Values between -126dBm and 127dBm.
  • We suggest -58dBm as default configuration value and we also encourage you to update it after calibrating again once the beacon is placed.
UUID [HEX]

A 16-byte hexadecimal (32 hex chars) organizational identifier for your beacon. Example: BA1C51BAB3147EFEE8E5252423222120

Major [HEX]

A 2-byte hexadecimal (4 hex chars) group identifier for your beacon. Example: 0E56

Minor [HEX]

A 2-byte hexadecimal (4 hex chars) unit identifier for your beacon. Example: 09FA

Extra Byte

If enabled, the battery level is advertised in the iBeacon Frame

Register iBeacon
  • When checked, it registers the iBeacon iD (UUID, Major & Minor) in the project selected of the google platform. Register the iBeacon allows to set attachments such as Nearby Notifications.
  • If checkbox not enabled, indicates that the iBeacon ID is already registered by you or another user.

Annex III. Understanding Connectable Window

In order to configure the connectable window, 2 parameters must be set:

  • Connectable period: how often the beacon enters in connectable mode. Connectable window: how long the beacon is able to connect.
  • Look at the next example where the connectable period is set to 60s and the connectable window to 20s. Therefore, every 60s the beacon will be connectable during 20s.

connectable period window

Annex IV. Understanding Adverstising Window

In order to configure the advertising window, 2 parameters must be set:

  • Advertising ON: what time the advertising starts
  • Advertising OFF: what time the advertising stops

Note: the difference between ON and OFF times cannot be greater than 17h!

Look at the next example where the advertising ON is set to 8h and the advertising OFF to 21h. Therefore, the beacon will be advertising from 8am till 9pm and will be in stand-by from 9pm till 8am.
advertising window

Last modified: August 9, 2017

CONTACT US

Lead Source
Lead Status
Lead Status

Max File(s) size limit is 20MB