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.
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.
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
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
Interval – it tells how often an 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.
Kontakt Secure Profile Packet Interval (available in nRF52 SoCs) - use another type of interval by default 1000ms, prolonging interval of that packet can make connection and reconfiguration more time consuming and problematic. Values you can set with preset ranges from 100ms to 5000ms. More about the secure profile in an article: Secure Profile Packet.
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.
For any custom settings not listed above, please contact your Account Manager or Technical Support.
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.