User Guide

[中文版]

Version

Date

Author

2.0

2025-09-09

Oran

Features

  • Easy to Operate: The Beacon Parameter Generation Tool simplifies the process of creating required Beacon parameters for customers, eliminating the need to delve into technical details.

  • Custom Parameter Settings: Users can customize parameters such as UUID, Major, and Minor according to their specific needs.

  • Improved Work Efficiency: The use of this tool significantly reduces the time and effort required to create parameters, thereby markedly improving work efficiency.

  • Bulk Generation and Export: The tool’s bulk generation function allows users to create multiple Beacon parameters at once, while the export function facilitates saving or sharing parameters, further enhancing the tool’s practicality.

  • Error Reduction: Manual form generation is more prone to errors, while using the tool can reduce such errors.

UI

The interface is intuitive and easy to use, allowing users to easily set parameters and generate configurations.

How to Generate Parameters Quickly

What Information is Included in Beacon Parameters?

  • Name: The name of the Beacon, used to identify and distinguish different Beacon devices.

  • Txpower: The signal transmission power of the Beacon device, measured in dBm.

  • Interval: The time interval for the Beacon to broadcast signals, measured in milliseconds (ms). This parameter determines the frequency of Beacon signal broadcasts. A shorter interval can increase signal coverage but will consume more battery power.

  • Pin: The PIN code used for connection.

  • UUID: A globally unique identifier used to distinguish different Beacon networks or applications.

  • Major: Used to distinguish regions or categories under the same UUID.

  • Minor: Used to further refine the classification of Major and identify more specific locations or items.

  • Rssi: A 1-byte value representing the average signal strength received from the advertising device at a distance of 1 meter, with a value range from 0 to -127.

Custom Device Name Generation

Generation Rules:

  1. Fixed name prefix.

  2. Name suffix generation rules: Decimal auto-increment, Hexadecimal auto-increment, Base36 auto-increment.

  3. Initial value of the name suffix.

  4. Required number of digits for the suffix.

Generating Broadcast Interval, Transmit Power, and PIN Code Parameters

Generation Rules:

  1. Select the module model (Choose the one that matches the device’s model).

  2. Enter the broadcast interval value in the settings box.

  3. After selecting the module model, set the corresponding transmit power.

  4. Enter the PIN code in the settings box.

Generating iBeacon Parameters

  1. UUID generation rule: Fixed UUID

  2. major&minor generation rules:

    • FixedValue (Fixed Value)

    • Increment (Auto-increment)

  3. max: Maximum value

  4. min: Minimum value

  5. int: Initial value

  6. rssi generation rule: Fixed rssi

Cases

Case 1

Case Requirements

There are 1000 modules, with names ranging from FSC-BP104E0020 to FSC-BP104E1019. Examples are listed as follows:

FSC-BP104E0020 FSC-BP104E0021 … FSC-BP104E1018 FSC-BP104E1019

Requirement Analysis

According to the naming rules, the customer’s requirement can be parsed into two parts for the module names: a fixed prefix “FSC-BP104E” and a variable 4-digit suffix. The suffix starts with an initial value of 20 and increments in decimal format. The name suffix must be 4 digits long, with leading zeros added if it has fewer than 4 digits.

Tool Configuration

Parameter Generation

Case 2

Case Requirements

  • Name prefix: wisp-

  • Suffix rules: Decimal auto-increment, initial value is 01516, retain 5 digits.

  • UUID: D546DF97475747EFBE093E2DCBDD0C77

  • Major: Fixed value 1.

  • Minor: Initial value is 01516, auto-increment, quantity is 1200.

Tool Configuration

Parameter Generation

Appendix

Download PDF