Purchasing beacons with presets

General Notes

If you want to get your beacons preconfigured, so they work as you want straight out of the box, please contact your sales representative, or send an email to our Sales Team BEFORE making a purchase.

Put your desired presets in a spreadsheet (e.g. Excel file) according to the following instructions. You can find a blank template, as well as a file with a sample configuration at the end of this article.

You don’t have to fill all of the columns in the provided Excel file, all of them are optional. If you leave some cells empty, we'll simply use a default value for each empty parameter. Please keep in mind that all preconfigurable settings are editable later.

Please, do not use any functions in this spreadsheet that perform any sort of calculations or operations on the data to get the desired values. Also, fill it only with actual data and don’t use any formatting. If you’ve e.g. pasted a formatted text there, please remove all formatting and make it a plain text.

Configurable Parameters

Profile – it lets you chose between a format that your beacons will be broadcasting by default. You can set it to either iBeacon or Eddystone. iBeacon is the default. It's possible to specify settings specific to a beacon profile other than the one you chose here. They will be used if you later choose to switch to a different profile.

iBeacon-specific settings
Proximity UUID – main iBeacon identifier. This column accepts only universally unique identifiers (UUID) in their canonical format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Default value is f7826da6-4fa2-4e98-8024-bc5b71e0893e.

Major & Minor – secondary iBeacon identifiers. They both accept unsigned 16-bit integers, which means you can enter numeric values from 0 to 65 535. There is no default value for either of them. If you don’t specify yours, they will be randomly generated for each beacon. Combination of UUID, Major and Minor should be unique across all of your iBeacon beacons

Eddystone-specific settings
Namespace ID – the first part of Eddystone-UID. The Namespace is intended to ensure ID uniqueness across multiple Eddystone implementers and may be used to filter on-device scanning for beacons. It contains 10 hexadecimal digits. That means you can use 20 characters: digits from 0 to 9 and letters from a to f. Default value is f7826da6bc5b71e0893e. To learn more about Eddystone-UID and best practices for generating its parts, please refer to Eddystone-UID specification.

Instance ID – the second part of Eddystone-UID. It contains 6 hexadecimal digits. That means you can use 12 characters: digits from 0 to 9 and letters from a to f. Similarly to iBeacon’s Major and Minor, there is no default value. We generate one randomly if you don’t request anything particular here. Combination of Namespace ID and Instance ID should be unique across all of your Eddystone beacons.

Eddystone-URL – a link that will be broadcast in Eddystone-URL packet. Due to the limited space available in a Bluetooth advertising packet, some of the most common URL elements (e.g. “http://www.”) will be truncated and converted to a single hexadecimal number in order to conserve space. The whole URL after the conversion can't be longer than 18 hexadecimal numbers. Please, refer to Eddystone-URL specification for further information and a list of all short codes. If not specified, Kontakt.io Eddystone beacons will broadcast this URL: http://kntk.io/eddystone

General settings
Interval – it tells how often and advertising packet is broadcast. It is specified in milliseconds and accepts values from 20 to 10240. In the spreadsheet, please put just the number, without a unit. The default value is 350.

TX power – Kontakt.io beacons can transmit signal in one of the 8 transmission power levels: from 0 to 7. Power levels are explained in this article: Transmission power, Range and RSSI. The default value is 3.

Custom name – a name that is broadcast publicly by a beacon. It will be visible e.g. in Kontakt.io Admin Apps. Default value is Kontakt. Maximum length is 15 characters. To learn more about different ways you can identify a beacon, please refer to this article: Beacon identifiers.

Templates

Below, you can download an empty preset template that you can fill with your data and send to your sales representative. We've also attached a sample file with different possible configurations, that will help you understand this process better.

- 2016-04-12 08:43:58 UTC
Was this article helpful?
1 out of 1 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.