WORKBYZANDER KBeaconPro App User Guide

WORKBYZANDER KBeaconPro App

Specifications

• Manufacturer: WORKBYZANDER LLC
• Product Name: KBeaconPro App
• Compatibility: iOS and Android devices
• Bluetooth Requirement: Bluetooth 4.0 support
• Minimum Android Version: 5.1
• Minimum iOS Version: 10.0

Product Usage Instructions

Download KBeaconPro App
Download the KBeaconPro App from the iOS App Store or Android Google Play or by scanning the provided QR code.

• iOS App: [Link to iOS App]
• Android App: [Link to Android App]
• Minimum Requirements:
• A mobile phone with Bluetooth 4.0 support
• For Android devices: Android version 5.1 or newer
• For iOS devices: iOS version 10.0 or newer

KBeaconPro App Instruction

CONFIDENTIAL
This document is the property of WORKBYZANDER LLC retains all rights pertaining to industrial property including patent applications. This document is only for the recipient(s) which authorized by WORKBYZANDER LLC . It contains confidential information and any use, dissemination, distribution, or reproduction of this message by unintended recipients is not authorized and may be unlawful.

Download KBeaconPro App

Download the App ‘KBeaconPro ’ from iOS App Store or Android Google Play or scan the QR code below to down the App.

iOS APP Android APP
Minimum requirements
A mobile phone with Bluetooth 4.0 support is needed. For Android devices, Android version 5. 1 or newer. For iOS devices, iOS version 10.0 or newer.
Reminder: This instruction uses Android App to demonstrate. The iOS App interface is slightly different from Android App.

How to Connect KBeacon Device to KBeaconPro App

Kindly note: Please make sure your KBeacon device is with battery already.
Enable your smart phone Bluetooth and run the App ‘KBeaconPro ’.

Turn on KBeacon

KBeacon with external or internal button (Including model ACCOUNTABLEV1

The factory setting of KBeacon with button is power OFF.
Turn ON the device: Hold the button for 3 seconds, the LED starts flashing and the flashing lasts for 30 seconds.
Turn OFF the device: Hold the button for 5 seconds, the LED starts flashing and flash 8 times.

• KBeacon without button ACCOUNTABLEV1

The factory setting of KBeacon without button is ON. ACCOUNTABLEV1 does not support turning off the power.

Connect KBeacon
Let’s use a ACCOUNTABLEV1 (MAC: DD3311000588) to demonstrate, the MAC ID is printed on the device:

1. Method 1: Scan QR code to connect
   Run KBeaconPro App, Find ‘Scan QR code ’ on the App, and then scan the QR code on the device to find this KBeacon device quickly.
   Reminder: iOS App filter the device by Device Name when use the ‘Scan QR code ’ method. If the device name is not KBPro, the device can not be found on iOS App when scan the QR code.

2. Method 2: Scan the Bluetooth signal to connect
   Run KBeaconPro App and tap ‘SCAN ’ in the top right corner, the App can scan the device’s Bluetooth signal, then the Beacon device will be displayed on the scan page.
   Find the corresponding KBeacon device on the App according to its MAC ID, Tap it, it will start connecting and jump to the configuration page (see pictures below).

If there are too many devices found , filter by RSSI to find a certain Beacon quickly.
Put the KBeacon device close to your phone (within 10cm range). Slide the RSSI bar to set the RSSI value at -30~-40dBm, tap the arrow on the top right corner, then the nearest KBeacon can be found

How to Configure KBeacon

LOT Definition
KBeacon supports total 5 SLOTs (SLOT0 to SLOT4). Each SLOT is independent and configurable. The Beacon type can be set for each SLOT. Beacon parameters such as Adv interval, Tx Power, Connectable enable/disable etc can be configured separately for each SLOT. They are independent of each other.
Each SLOT can be set to one Beacon type ONLY. For example, if you set SLOT0 to be iBeacon, set SLOT1 to be URL, set SLOT2 to be TLM, then the KBeacon device will broadcast iBeacon, URL and TLM simultaneously.

KBeacon supports the following Beacon types:

• iBeacon
• Eddystone URL
• Eddystone UID
• Eddystone TLM
• KSensor: KKM self-defined protocol, includes battery level and sensor information
• System: Including the KBeacon device info such as System ID (ie.MAC ID), Model name.

How to configure iBeacon and Eddystone
Take iBeacon as an example:
Tap: Beacon Type—> iBeacon—> Save—> Return

iBeacon parameters (UUID, Major ID, Minor ID, Adv Interval, TX power etc.) can also be configured in the App. Eddystone URL, UID, TLM, can be configured by the same steps above.

KSensor: KKM sensor data, see Section 6. 3 for details UID/TLM/URL: Google Eddystone, see Section6.2 for details iBeacon: Apple iBeacon, , see Section 6. 1 for details

System: KKM System data, see Section 6.4 for details

Adv Interva| 1000.0| Advertisement period is  expressed  in  decimal  and the unit is ms. If you need to use it on Apple devices, it  is  recommended  to follow Apple’s specifications. Apple has some suggestions that make the device more easily discovered by IOS phones. (The  suggest value was: 152.5 ms; 211.25 ms; 318.75 ms; 417.5 ms;

546.25 ms; 760 ms; 852.5 ms; 1022.5 ms; 1285 ms). For more information, please refer to Section 3.5 in “Bluetooth Accessory Design Guidelines for Apple Products”.

https://developer.apple.com/accessories/Accessory-Design- Guidelines.pdf.

Tx power| -40 ~ 8?| Beacon TX power. The value range depends on the support capability of the device, some devices are -40 ~ 4 dBm, some devices are -40~8dBm.
Connectable| Yes| Whether the device can be connected. For detailed description,

please refer to Section 5. 1.

Trigger only advertisement| No| When this feature is set to be ‘YES’, this slot will be broadcasted only when the trigger happens.

For example, if you set ‘Trigger Adv Slot ’ of ‘Button single click ’ to be SLOT0 and SLOT0 is iBeacon, then iBeacon will be

broadcasted only when the button single click happens.

iBeacon parameters (UUID/Major/Minor)|

NA

| Configuration parameters of iBeacon

After the parameters are modified, you need to tap: UPLOAD—> OK, then all the parameters configured can be loaded to the device successfully.

How to configure KSensor and System
KSensor is KKM defined protocol, it includes battery level and sensor information (for example
temperature&humidity sensor, acceleration sensor etc).
Tap: Beacon Type—> KSensor—> Save—> Return

Parameters Defaults

include 3-axis information in KSensor broadcasts.
Sensor H&T| Yes| When KBeacon supports  temperature  and  humidity  sensor, whether to include temperature and humidity information in KSensor broadcasts.
Sensor Light| Yes| When KBeacon supports light sensor,  whether  to  include light level in KSensor broadcasts.
Sensor PIR| Yes| When KBeacon supports light sensor, whether to include PIR
| | events in KSensor broadcasts.
---|---|---
Sensor VOC| Yes| When KBeacon supports VOC sensor, whether to include VOC in KSensor broadcasts.
Sensor CO2| Yes| When KBeacon supports CO2 sensor, whether to include CO2 in KSensor broadcasts.
New   Log

Count

| Yes| When KBeacon supports record sensor history, whether to include New Log Count in KSensor broadcasts.

“System” can also be configured by the same steps above.

View KSensor advertisement data
When we configure KSensor to broadcast sensor information in section 3.3, we can scan sensor data through app.

The broadcast content of different sensors is displayed differently on the APP.

Battery Level

| The unit of battery level is mV. For example, if it is 3210, it means the battery voltage is 3210mV.

Temperature

| The unit of temperature is ℃ . For example, if it is 2 5 ℃ , it means that the current temperature detected by the beacon is 25 ℃ .

Humidity

| The unit of humidity is %. For example, if it is 60%, it means that the current humidity

detected by the beacon is 60%.

Door/PIR sensor
For door sensor, you can configure when the sensor works.

sleep mode by turning the hour hand and minute hand, or input the time through the keyboard.

How to evaluate battery life
KBeaconPro supports evaluating the battery life of beacon according to the configured parameters.

KBeaconPro App Instruction Reminder:

Please make sure that your phone supports BLE 5.0 PHY Code (Long range) feature, otherwise you will not be able to scan the PHY code advertisement if the Beacon was set to PHY Code (Long range) Mode.
If you set the Beacon to PHY code advertisement, and your phone doesn’t support PHY Code broadcast, you can force the device to enter the Legacy mode for 30 seconds by single click the button of the device.

How to Configure Trigger

For some KBeacon device that has some motion sensor, temperature&humidity sensor, push button, etc., The application can configure the KBeacon to monitor some trigger event. For example, button was pressed, the temperature is too high, or device was motion. The KBeacon can do some action when the trigger condition was met.
When the conditions of the Trigger are met, we can trigger a specific advertisement, or trigger the event to be recorded in memory, or report an event to the App.
Tap: Trigger Command—>Trigger Type
The following example is based on the K21 device

Trigger event to advertisement

The trigger advertisement has follow parameters:

• Trigger No: Trigger instance number, the device supports up to 5 Triggers by default, the No is 0 ~ 4.
• Trigger type: Trigger event type
• Trigger action: Action when trigger event happened. For example: start broadcast, make a sound, or send a notification to the connected App.
• Trigger Adv slot: When the Trigger event happened, which advertisement Slot starts to broadcasting
• Trigger parameters: For motion trigger, the parameter is acceleration sensitivity. For temperature above trigger, you can set to the temperature threshold.
• Trigger Adv duration: The advertisement duration when trigger event happened. Unit is second.
• Trigger Adv TX power: The advertisement TX power when trigger event happened. Unit is dBm.
• Trigger Adv interval: The advertisement interval when trigger event happened. Unit is ms.

Trigger only advertisement
The device usually does not broadcast by default, and we want to trigger the broadcast when the trigger event happened.

Example:

1. Setting slot 0 to iBeacon advertisement(adv period = 211.25ms, trigger only adv = true).
2.  Add a single button trigger(Trigger No = 0, Trigger type = Btn single click, Action = advertisement, Adv slot = 0, Adv duration = 20).

Trigger to an exist advertisement
For some scenario, we need to continuously monitor the KBeacon to ensure that the device was alive. The device usually broadcasting iBeacon1 (UUID=xxx1) , and we want to trigger the broadcast iBeacon2
(UUID=xxx2) when the button is pressed.

Example:

1. Setting slot 0 to iBeacon advertisement (UUID=xxx1, adv period = 1280ms, trigger only adv = false).

2. Setting slot 1 to iBeacon advertisement (UUID=xxx2, adv period = 211.25ms, trigger only adv = true).
   We set an larger advertisement interval during alive advertisement and a short advertisement interval when trigger event happened, so we can achieve a balance between power consumption and triggers advertisement be easily detected.

3. Add a single button trigger(Trigger No = 0, Trigger type = Btn single click, Action = advertisement, Adv slot = 1, Adv duration = 20).

Trigger event to record
For some Triggers, the device supports recording the Trigger events. For more information, see 2. 1.1 Trigger capability.
For the Trigger event, we can set the Trigger Action to “Record”. After setting, when the trigger event is triggered, KBeacon will record the Trigger event.
Reminder: Currently, only some devices support recording Trigger events, including:

Example:

1. We assume that the current ambient humidity is 60%, and we set an trigger event to be logged when the humidity exceeds 70%.
2. Put the KBeacon in an environment with a humidity over 70%.
3. Observe whether the event is logged.
   In order to verify that the record is generate by the Trigger, we can turn off the T&H Logger during the test, which means that when the temperature and humidity change exceeds the specified threshold, the recording will not be performed. It will only be logged when the Trigger event happened.

Trigger event to App
We can also set KBeacon to send an event message to the App when the Trigger is happened.

If set “Report to App”, there will be a message notification displayed on the cell phone when the trigger event happens.

Other Settings

Unconnectable mode
Each SLOT has two different advertising status, connectable mode and unconnectable mode. Only when the advertising status is connectable, the KBeacon is configurable. But the unconnectable mode saves about 20% -30%power consumption than connectable mode.
After the KBeacon is deployed, we recommend setting the KBeacon to be unconnectable mode. This can lower battery power consumption and the Beacon also have better security performance.
Reminder: For the KBeacon device that doesn’t have button and whose battery can not be re-installed, once the device was set to unconnectable mode, it can not be confirgured any more!

How to set unconnectable mode:
Tap: Connectable—> OFF—> Save—>Return —>UPLOAD. Question: How can I configure KBeacon again if it was set to be unconnectable mode?

• For KBeacon with button: click the button, the Beacon will enter a connectable mode for 30 seconds, users can connect the device within these 30s. Or re-install battery.
• For KBeacon without button: Re-install battery

Power off
For KBeacon device WITH BUTTON, you can use the App to turn off the device. Tap: Power Off—> OK

Reset configuration
You can reset the KBeacons setting to factory default configuration on the App.
Reminder: If you customize some of your own parameters to KKM, such as Trigger parameters, multiple slots broadcast parameters. KKM will configure these parameters for you before leaving the factory. If you perform the “reset configuration” operation, these pre configured parameters may be lost.
Tap: Reset configuration—> OK

 KBeacon Payload

Beacon payload struct
iBeacon is a BLE broadcast format defined by Apple for Location. For detailed definitions see: https://developer.apple.com/ibeacon/

Eddystone payload struct
Eddystone is a BLE broadcast format defined by Google. For detailed definitions see: https://github.com/google/eddystone

FCC Statement

This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:

• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
• Consult the dealer or an experienced radio/TV technician for help.

Caution: Any changes or modifications to this device not explicitly approved by manufacturer could void your authority to operate this equipment.
This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions:

1. This device may not cause harmful interference, and
2. this device must accept any interference received, including interference that may cause undesired operation.

RF Exposure Information
The device has been evaluated to meet general RF exposure requirement.
The device can be used in 0mm exposure condition, compliance with exposure requirements.
Only in the stated conditions, the device is shown to fully comply with the FCC RF Exposure requirements of KDB 447498.

References

• GitHub - google/eddystone: Specification for Eddystone, an open beacon format from Google

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>