Beacon services

WARNING We are discontinuing support for Firmware below 4.x with these updates.

Connecting to a Beacon

PLEASE NOTE  This only applies to beacons running firmware 3.1 and below. Click here to learn more about our new Secure Communication process.

You can connect to a Kontakt.io Beacon using a BLE (Bluetooth Low Energy) device with the appropriate software installed: the Kontakt.io Administration App for iOS or Android, or you can also use third party management apps such as LightBlue.

Once you are connected, the names of all implemented services and characteristics can be read.

A user has 30 seconds to write password (8 hexadecimal) to a proper characteristic. Otherwise the connection will be lost and the beacon will be blocked from further connection attempts for 20 minutes. Of course, if you're logged in to your Kontakt.io Proximity Web Panel Account in the Administration App, you don't have to worry about any of this – app will download password for your beacons automatically and apply them when needed.

If a user writes the correct password, there is a 6 minute window to read and change the beacon's services and characteristics.  After that time the user will be disconnected, however the device will not be blocked.

Connecting to the beacon consumes more power than normal operation - the limited connection window is designed to enhance battery life.

Beacon services

Kontakt.io Beacons implement eight services.

Five of these are standard Bluetooth SIG’s with 16-bit Universally Unique Identifiers (UUID) and three others are custom services with generated 128-bits UUIDs.

Each service contains one or more characteristics which store information or control values. All services and characteristics are shown in the charts below according to order in which they appear.

Service 1  
UUID 0x1800
Name Generic Access
Characteristic 1  
UUID 0x2A00
Name Device Name
Description name of the device
Properties readable, constant
Characteristic 2  
UUID 0x2A01
Name Appearance
Description appearance of the device
Properties readable, constant
Characteristic 3  
UUID 0x2A04
Name Slave Preferred Connection Parameters
Description connection parameters in slave role
Properties readable, constant
Service 2  
UUID 0x1801
Name Generic Attribute
Characteristic 1  
UUID 0x2A05
Name Service Changed
Description handle of attribute which was changed
Properties sending indications
Service 3  
UUID 0x180A
Name Device Information
Characteristic 1  
UUID 0x2A29
Name Manufacturer Name String
Description name of the manufacturer
Properties readable, constant
Characteristic 2  
UUID 0x2A26
Name Firmware Revision String
Description firmware number
Properties readable, constant
Characteristic 3  
UUID 0x2A27
Name Hardware Revision String
Description hardware number
Properties readable, constant
Service 4  
UUID 0x1804
Name TxPower
Characteristic 1  
UUID 0x2A07
Name Tx Power Level
Description user can set the transmission power to one of eight values - Transmission power settings
Properties 2 hexadecimal numbers; readable, writable after correct password
Service 5  
UUID 0x180F
Name Battery Service
Characteristic 1  
UUID 0x2A19
Name Battery Level
Description measured battery level in percentage
Properties 2 hexadecimal numbers; readable
Service 6  
UUID 0xA1EA8110-0E1B-D4A1-B840-63F88C8DA1EA
Name Proximity Service
Characteristic 1  
UUID 0xA1EA8111-0E1B-D4A1-B840-63F88C8DA1EA
Name Proximity UUID
Description set new proximity uuid
Properties 32 hexadecimal numbers; readable, writable after correct password
Characteristic 2  
UUID 0xA1EA8112-0E1B-D4A1-B840-63F88C8DA1EA
Name Major
Description set new major value
Properties 4 hexadecimal numbers; readable, writable after correct password
Characteristic 3  
UUID 0xA1EA8113-0E1B-D4A1-B840-63F88C8DA1EA
Name Minor
Description set new minor value
Properties 4 hexadecimal numbers; readable, writable after correct password
Characteristic 4  
UUID 0xA1EA8114-0E1B-D4A1-B840-63F88C8DA1EA
Name Propagated Device Name
Description device name which will be seen in an applications
Properties maximally 30 or less hexadecimal numbers which represent characters in ASCII codeble, writable after correct password
Service 7  
UUID 0xA1EA8120-0E1B-D4A1-B840-63F88C8DA1EA
Name Timers
Characteristic 1  
UUID 0xA1EA8121-0E1B-D4A1-B840-63F88C8DA1EA
Name Advertising Interval
Description user can set interval between advertising packets to a value from 20ms to 10.24s. A value of 0x20 corresponds to 20ms and 0x4000 corresponds to 10.24s (interval=value*625µs)
Properties 4 hexadecimal numbers; readable, writable after correct password
Service 8  
UUID 0xA1EA8130-0E1B-D4A1-B840-63F88C8DA1EA
Name Control Service
Characteristic 1  
UUID 0xA1EA8131-0E1B-D4A1-B840-63F88C8DA1EA
Name Password
Description After connection has been established, the user has 30 seconds to write the correct password characteristic or he will be disconnected.
Properties 8 hexadecimal numbers (4 characters in ASCII code); writable
Characteristic 2  
UUID 0xA1EA8132-0E1B-D4A1-B840-63F88C8DA1EA
Name Set Password
Description set new password for connection
Properties 8 hexadecimal numbers (4 characters in ASCII code); writable after correct password
Characteristic 3  
UUID 0xA1EA8133-0E1B-D4A1-B840-63F88C8DA1EA
Name Reset
Description write a value greater than zero to reset the device to default settings
Properties 2 hexadecimal numbers; writable after correct password
Characteristic 4  
UUID 0xA1EA8134-0E1B-D4A1-B840-63F88C8DA1EA
Name Default Settings
Description user can restore default settings by typing the 6 character master password
Properties 12 hexadecimal numbers (6 characters in ASCII code); writable after correct password
Characteristic 5  
UUID 0xA1EA8135-0E1B-D4A1-B840-63F88C8DA1EA
Name Bootloader
Description user has to type 6 character master password to run bootloader mode
Properties 12 hexadecimal numbers (6 characters in ASCII code); writable after correct password
Characteristic 6 Characteristic added in firmware V2.6
UUID 0xA1EA8136-0E1B-D4A1-B840-63F88C8DA1EA
Name Non-connectable mode (see Apple iBeacon compatibility)
Description user has to type 6 character master password to put the Beacon into non-connectable mode
Properties 12 hexadecimal numbers (6 characters in ASCII code); writable after correct password

Related information

 
- 2017-10-25 16:55:03 UTC
Was this article helpful?
0 out of 0 found this helpful

Comments

Follow

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Review our cookies information for more details.