MikroTik Beacon Manager for Android devices

MikroTik Beacon Manager 应用用于配置 Bluetooth 标签（TG-BT5-XX）。由于这些标签是基于 Bluetooth 的设备，因此在进行配置之前，你必须在手机上启用 Bluetooth。

概述

MikroTik Beacon Manager 应用用于配置 Bluetooth 标签（TG-BT5-XX）。由于这些标签是基于 Bluetooth 的设备，因此在进行配置之前，你必须在手机上启用 Bluetooth。

对于 Android 设备，你可以通过链接找到该应用。

Beacon manager 界面

启动应用后看到的第一个界面是 "MikroTik Beacon Manager" 界面，其中显示了附近所有的 Bluetooth 标签。

如果列表为空，意味着附近所有标签都处于出厂休眠模式。一旦标签进入广播或配置模式，它就会显示在列表中。要将标签从出厂休眠模式唤醒，请将磁铁放在标签上方（激活簧片开关）3-10 秒。

信息

如果列表未捕获到任何标签，尽管你确信手机范围内存在标签 → 请尝试在手机的 GPS 设置中打开 "Location=ON"。 在界面的右上角有 3 个按钮：

二维码读取器

"QR Code reader" 按钮允许你通过二维码添加标签（MAC 地址用作标签的 ID）：

NFC 支持

信息

本节仅适用于 TG-BT5-OUT 型号 你还可以使用 NFC（类似二维码读取器功能）查找标签（MAC 地址用作标签的 ID）。

你需要做的只是在手机设置中启用 NFC 并打开 MikroTik Beacon Manager 应用。

当你看到初始界面（标签列表）后，将标签靠近手机的 NFC 天线，系统将提供打开设备设置的选项：

如果按下 "YES"，你将被重定向到下方显示的页面。在菜单中，你可以选择从列表中删除设备，或通过 "Configure" 按钮进入配置模式。

排序方式

"Order by" 按钮允许你更改设备列表的顺序，或者通过勾选 "Show only MikroTik beacons" 复选框将列表过滤为仅显示 MikroTik beacon：

设置与批量配置

"⋮" 选项卡分为 2 个子选项卡 - "Settings" 和 "Batch Configuration"。

设置

此选项卡中的第一个选项是设置 "Discovery refresh interval"，即扫描附近标签的间隔。

第二个选项是启用或禁用 "Save triggers" 设置。启用后，应用会将检测到的触发器保存到数据库中。你可以在 "Sensor Triggers" 菜单中查看触发器（"Sensor Triggers" 菜单显示在本指南的 "Tag Management" 部分）。如果禁用此选项，一旦应用关闭，"Sensor Triggers" 数据就会被清除。

最后，"App version" 字段显示当前应用版本/构建号。

批量配置

此选项允许你使用相同的设置批量配置多个标签。

为此，你需要从其中一个标签导出配置文件。标签配置的导出和导入显示在本指南的 "Tag Configuration" 部分。

保存配置文件后，只需按下 "Batch Configuration" 按钮，它会带你进入文件菜单，你需要在其中选择文件。选择你希望应用于多个单元的配置文件，应用将向你显示所有检测到的附近标签的界面：

最后一步是将这些标签置于配置模式（将磁铁放在标签上方 5-10 秒）。将设备置于配置模式后，你将看到 "Uploading configuration" 消息。配置成功应用后，该消息将变为 "Configuration updated"。

标签管理

当标签出现在列表上时，你可以点击其 MAC 地址，随后将看到以下选项：

可通过 "SAVE" 保存标签，或通过 "CONFIG ONLY" 按钮立即进入标签的配置菜单。

首先，我们将更详细地解释 "SAVE" 选项。标签的配置菜单将在后面的 "Tag Configuration" 部分中解释。

当你点击之前保存的标签时，将看到以下菜单：

你首先应该注意的是信号强度指示（标签的 RSSI 信号 - 标签距离有多远）。当所有圆圈均为绿色时，表示信号强度约为 -60 RSSI。当只有 2 个圆圈为绿色时，表示信号强度约为 -70 RSSI。当只有 1 个圆圈为绿色时，表示信号强度为 -80 RSSI。当没有圆圈为绿色时，表示信号强度为 -90 RSSI 或更低。

在信号强度指示器下方，你有 2 个选项 - 进入标签的配置菜单（"Configure" 按钮）或删除设备（"Delete" 按钮）。

在 "Name/Display Name" 字段中，你可以更改标签的名称：

在 "Sensors" 字段中，你可以查看标签的电池电量或温度。

信息

TG-BT5-IN 型号没有温度传感器 在 "Sensor Triggers" 字段中，你可以查看标签报告的触发器：

标签配置

要访问标签的配置菜单，你需要按下 "CONFIG ONLY" 按钮或 "Configure" 按钮，如下所示：

紧接着，你需要将磁铁放在簧片开关上方 5-10 秒：

经过短暂的上电时间后，设备应进入配置模式：

应用将在 "Status" 选项卡中显示有关标签的一般信息（如上方截图所示）。

配置可在 "Settings" 选项卡中修改：

写入保护

此菜单允许你使用 6 个字符长的密码锁定标签的设置：

一旦设置了密码，就无法移除密码保护（只能编辑它）。

下次你尝试配置标签时，系统将通知你该标签已 "write protected"，你可以选择保持 "READ-ONLY" 模式（允许你浏览/读取设置，并限制进行配置更改），或通过输入已配置的密码来 "UNLOCK" 设置：

Beacon 设置

在广播模式下，标签通过 Bluetooth 广告数据包广播关于自身的信息。信息取决于广告数据包类型（类型可在设置中更改）。

目前，以下是所有支持的类型：

DeviceName、MikroTik、Eddystone-TLM、Eddystone-UID 和 iBeacon。

广告属性

预估电池寿命

本节显示预估的电池寿命：

预估电池寿命在很大程度上取决于发送（配置为发送）的广告数据包数量。应用会计算每天预估广播的数据包数量、标签将活跃多长时间，以及平均每日功耗的估算值。

加速度计设置

加速度计可以完全关闭，并可以使用 "Use Accelerometer" 切换按钮开启。

本节允许你更改下方截图中显示的参数：

模式与数据速率

此菜单允许你在 2 种模式之间进行选择："Low power" 和 "High power"。在 "Low power" 模式下，你会获得较低的精度，但功耗也更低。在 "High power" 模式下，你会获得较高的精度，但功耗也更高。

"Data Rate" 设置表示 1 秒窗口内的加速度测量次数（测量频率）。每秒发送的数据包越少 → 功耗越低。

满量程

可在 (2g...16g) 之间变化。它是用于计算唤醒阈值的测量范围。满量程定义了加速度计能够测量的加速度范围（范围越大，测得加速度的精度越低）。

带宽滤波器

是一种数字滤波截止（高通滤波器带宽）。

如果带宽 = "x" Hz，则标签将滤除变化频率低于每秒 "x" 次的加速度变化。

例如，如果设备平放在桌子上，加速度将显示为 0g（而不是 1g），即使存在地球重力 →（因为地球重力是恒定的 - 其变化频率为 0 Hz，即 < "x" Hz）它会被滤除。

唤醒阈值与持续时间

"Wakeup Threshold" 定义了唤醒区域/加速度范围。"Wakeup Duration" 定义了加速度超过所配置唤醒阈值的时间。当任意轴（X、Y 或 Z）上的加速度在配置的唤醒持续时间内超过阈值时，就会生成唤醒事件（触发唤醒条件）。要更好地理解 "任意轴（X、Y 或 Z）上的加速度" 的含义，想象一个三维笛卡尔坐标系，并将标签的加速度计或标签本身置于原点（公共点）：

例如，唤醒阈值设置为 1.0g（这意味着 -1.0g 到 +1.0g 之间的任何加速度都落在所配置的阈值/加速度范围内），唤醒持续时间设置为 0.12s。结果是，一旦设备被推向/抛向任意轴（设备开始向任意方向移动），且加速度超过所配置的阈值（acceleration> +1.0g 或 acceleration< -1.0g）的时间超过 0.12s → 就会触发唤醒条件。

自由落体阈值与持续时间

"Free Fall Threshold" 定义了自由落体区域/加速度范围。"Free Fall Duration" 定义了加速度将处于所配置自由落体阈值内的时间。当所有 3 个轴（X、Y 和 Z）上的加速度在配置的自由落体持续时间内都处于自由落体区域/阈值内时，就会生成自由落体事件（触发自由落体条件）。要更好地理解 "所有轴（X、Y 和 Z）上的加速度" 的含义，请查看上方 "Wakeup Threshold and Duration" 部分中的设备照片。

例如，自由落体阈值设置为 156.25g（这意味着 -156.25g 到 +156.25g 之间的任何加速度都落在所配置的阈值/加速度范围内），自由落体持续时间设置为 0.2s。结果是，一旦设备处于自由落体状态，且所有轴上的加速度在所配置的阈值内（-156.25g<acceleration<+156.25g）的时间超过 0.2s → 就会触发自由落体条件。

角度阈值

可在 50°...80° 之间变化。它是倾斜功能的阈值。当阈值设置为例如 60°，且设备倾斜到该角度时 - 就会触发倾斜动作并发送广告数据包。

低噪声滤波器

用于启用或禁用低噪声滤波器的选项。低噪声滤波器用于降低测量中的噪声密度。启用此功能会略微增加功耗。

温度偏移

信息

TG-BT5-IN 型号没有温度传感器！

可在 -10°C...+10°C 之间变化。以 centicelsius 为单位应用于原始温度测量的偏移量。

Tx Power

以分贝毫瓦（dBm）为单位的发射功率级别。可在 -28dBm...6dBm 之间变化。Tx Power 仅用于增加/降低标签的发射功率。

数据日志

信息

本节仅适用于 TG-BT5-OUT 型号。 本节允许你配置/查看日志（仅能通过应用访问）：

配置日志记录

在 "Configure logging" 菜单中，你可以设置日志记录设置：

你可以选择设置 "Periodic logging interval (s)"（或者可以禁用它）。启用后，数据日志将每隔 "x" 秒自动保存一次：

另一个选项是启用 "Log Triggers"（周期性日志记录和触发器日志记录可以一起使用）。使用日志触发器时 - 每当检测到倾斜、自由落体和/或撞击动作时，都会保存日志。

例如，当启用倾斜触发器并被标签检测到时 - 该消息会被记录。

你可以在 "Field config" 部分设置要记录哪些参数：

你可以选择记录 3 个参数：1) Battery level；2) Temperature；3) Acceleration。

如果你对某个参数不感兴趣，可以禁用每个参数，也可以为它们设置阈值。

如果你只关心低于 40% 的电池电量，可以设置阈值从 minimum=0% 到 maximum=40%，结果是，只有当电池电量（电池电量百分比）处于所配置范围内时，才会显示在日志中。同样的原则适用于其他 2 个参数。

数据日志

记录的消息将显示在 "Data Logs" 选项卡中：

你可以通过 "Export as .csv" 按钮将日志导出为 .csv 文件：

系统

在 "System" 选项卡中，你可以同步时间、查看系统日志、将标签置于工厂休眠模式，以及升级固件：

Unix Time

使用此设置，你可以为标签同步当前时间和日期：

日志

在此菜单中，你可以查看系统日志：

工厂休眠

此选项可以为标签启动工厂休眠模式：

升级固件

此菜单允许你升级标签的固件版本：

自动升级

点击 "Download and install" 并等待设备重启。

手动升级

要手动下载标签的固件文件，请导航至 https://download.mikrotik.com/firmware/bt-tag/latest。它将允许你下载 "latest" 文件，该文件可以用记事本或任何其他文本编辑器打开。文件内容将指示最新的可用 TG-BT5-XX 版本：

2.3.1 1638358509
1326c554c18340a41e79fd88abbea193dc53b99931eddecd018e33cff577f6d3 bt-tag_HT_app_2.3.1-0rr.gbl
9dc21eb980e8bd36732ec4db8e4b03a8177885fccdbbd87122f7d9bf76410b8b bt-tag_HT_apploader_3.2.3-0rr.gbl
9e4f30d9006f24063ac96d0fb1181d135929d86d0e243d3b3985cc5e43d6b448 bt-tag_IN_app_2.3.1-0rr.gbl
e03fa2987b874463e9a5c686303f4d75fef0c0f8d89dde14f8c4b04be4838a93 bt-tag_IN_apploader_3.2.3-0rr.gbl
54e959dd9cc1da3a5408b5dc7c797c52ae1a1685122e14d966cbe433ec1d1b3c bt-tag_OUT_app_2.3.1-0rr.gbl
e0bc2e8a1a9de6a1974c201a48cfea2276465414e07efc07816400abca91aa14 bt-tag_OUT_apploader_3.2.3-0rr.gbl
5257a1b06cb8d57d06ae10ef2c87abf0df0a3ab8a9ac7f9229a9a421b8a0c0fc bt-tag_HT_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_HT_apploader_3.2.3-000.gbl
0f6603d97df5fc4b3f260b410628b3c62fb2562f26e85e44b6cdfdf1b58d04f8 bt-tag_IN_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_IN_apploader_3.2.3-000.gbl
3235db7bb9a9cca0d5e59ae774c3cd004be4e58b44c1ae40e6e3bb84feb077a6 bt-tag_OUT_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_OUT_apploader_3.2.3-000.gbl

使用应用再次确认当前标签的固件版本：

例如，已知该标签是 TG-BT5-IN 型号，且当前版本为 1.6.1-000，我们可以推断最新版本是 "bt-tag_IN_app_2.3.1-000.gbl"。

请注意，对于大多数标签，固件版本将是 1.6.1-0rr（而不是 1.6.1-000）。你需要使用 x.x.x-0rr 文件。

要下载实际的固件文件，请将链接中的 "latest" 部分更改为 "bt-tag_IN_app_2.3.1-000.gbl"。

因此，如果你当前的版本例如是 "1.6.1-000"（TG-BT5-IN 标签），则可以使用以下链接下载固件：

https://download.mikrotik.com/firmware/bt-tag/bt-tag_IN_app_2.3.1-000.gbl

如果你当前的版本例如是 "1.6.1-0rr"（TG-BT5-OUT 标签），则可以使用以下链接下载固件：

https://download.mikrotik.com/firmware/bt-tag/bt-tag_OUT_app_2.3.1-0rr.gbl

升级设置

警告

如果标签更新出现问题，标签停留在 OTA/更新模式 → 请尝试启用 "Reliable write"！

当标签在 OTA/升级模式中 "卡住" 时，可能会发生两种情况： a) Beacon Manager 标签列表仍会在列表中显示该标签，但不会指示该标签是 "configurable"。你仍然可以点击列表中的标签（即使没有 "gear" 图标）并在不激活磁性开关的情况下浏览其设置；

b) 该标签可能会从可管理标签列表中消失。在这种情况下，请尝试使用二维码读取器功能手动添加标签，并批准 "configuration"。 要进入附加升级设置菜单，请点击 "Upgrade settings" 按钮：

这将允许你更改 "Reliable write" 配置：

启用后，该复选框允许你使 Bluetooth 升级过程 "更慢" 但 "更可靠"（手机和标签之间会进行额外的交换和验证步骤）。

导入/导出

在界面的右上角，你可以选择导入/导出当前设置：

如果按下导出按钮，应用将打开手机的文件夹菜单，你可以在其中命名配置文件并保存。

如果按下导入按钮，应用将打开手机的文件夹菜单，你可以在其中选择配置文件并应用它。