TapLink 使用说明书

TapLink 是面向现场工程师的 NFC 设备配置工具。通过一部支持 NFC 的 Android 手机，可以读取和写入设备参数、使用云端 NFC 模板、配置 LoRa 模块，并通过 NFC 完成设备固件升级。

本文档适用于当前 Android 版本。实际模板、固件、组织和服务器由部署管理员维护。

软件概述

TapLink 提供三类核心现场操作：

• 模板参数：选择云端 NFC 模板，读取设备数据，编辑后写回设备。
• 设备升级：选择远程固件或本地导入包，匹配设备信息后通过 NFC 升级。
• LoRa 参数：读写 AppEUI、DevAddr、密钥、频率、功率和 16 路信道等配置。

登录后还可以查看当前组织可用的云端模板、切换组织和界面语言，并管理远程服务器设置。

运行要求

• 支持并已启用 NFC 的 Android 手机。
• 手机 NFC 天线区域能够贴近目标设备的 NFC 感应区。
• 能够访问管理员指定的 ThinkLink 后端。
• 由管理员授权的账号、组织、NFC 模板和固件资源。
• 固件升级期间保持手机电量充足，并避免锁屏或切换 APP。

下载与安装

下载 TapLink Android APK

1. 使用具备 NFC 功能的 Android 手机扫描二维码，或点击下载链接。
2. 如果系统提示安装未知来源应用，请先确认下载域名为 thinklink.manthink.cn，再按 Android 系统指引仅授权本次安装。
3. 安装后确认系统 NFC 功能已经开启。

安装安全

仅从上述官方 HTTPS 地址下载安装包。不要安装通过聊天工具、网盘或不明网站转发的 APK。

首次配置

1. 打开底部导航中的 Me / 我的。
2. 在 Service / 服务器 中填写管理员提供的远程服务器地址。
3. 点击 Sign in / Register，选择密码登录方式。
4. 输入管理员通过安全渠道提供的账号和密码。
5. 登录后确认当前组织，等待模板资源同步。

原始测试环境使用 http://192.168.1.216，该值仅用于说明服务器字段。正式使用时应填写部署管理员提供的地址，并优先使用带受信任证书的 HTTPS。

凭据安全

本文档不发布测试账号或密码。不要在不可信网络或共享设备上保存密码；使用完成后应退出登录。

首页

首页提供三个主要入口：

• Template Params：模板化参数读取与写入。
• Device Upgrade：通过 NFC 执行设备固件升级。
• LoRa Params：读取和写入 LoRa 模块寄存器。

底部导航用于切换 Home、Templates、Me。开始现场操作前，请先确认当前组织和服务器状态正确。

模板参数

1. 点击 Pick an NFC template。
2. 选择与目标设备型号和用途匹配的模板。
3. 点击读取按钮，将手机 NFC 天线区域贴近设备感应区。
4. 等待读取完成，核对并编辑参数。
5. 执行写入时保持手机和设备位置不动，直至出现成功提示。
6. 写入完成后再次读取，确认设备中的值与预期一致。

写入前核对

使用错误模板或参数可能改变设备行为。写入前必须核对设备型号、模板名称、参数格式和目标值。

设备固件升级

1. 选择 Remote firmware 或 Local import。
2. 选择正确的固件，并核对页面显示的轮询间隔等参数。
3. 点击 Match device info，通过 NFC 读取并匹配设备。
4. 核对设备型号、硬件版本、当前版本和目标版本。
5. 确认无误后开始升级。
6. 等待成功结果，再按现场流程验证设备启动和通信状态。

固件升级

不匹配的固件可能导致设备不可用。必须先完成设备信息匹配。升级期间不要移开手机、退出 APP、关闭 NFC 或锁定屏幕。升级中断后不要盲目重复写入，应先联系管理员确认设备状态和恢复流程。

LoRa 参数

1. 点击读取按钮，读取当前 FW/RD 寄存器。
2. 核对 AppEUI、DevAddr、NwkSKey、AppSKey 和 AppKey 的十六进制格式与长度。
3. 按网络规划设置 RX2、DLSetting、发射功率和信道频率。
4. 如所有信道使用相同数据率，可使用 Apply to all。
5. 点击写入按钮并保持 NFC 接触。
6. 写入完成后再次读取并逐项核对。

网络参数

错误的标识、密钥、频率、数据率或功率可能导致设备无法入网或违反区域射频规划。只使用网络管理员审核后的参数，不要在文档、截图或聊天中泄露真实密钥。

云端模板

入口：底部导航 Templates。

登录后，页面显示当前组织可用的 NFC 模板和更新时间。点击模板可查看具体 RPC 或参数定义。

如果模板列表为空：

1. 确认账号仍处于登录状态。
2. 核对当前组织是否正确。
3. 检查服务器和网络连接。
4. 退出后重新登录，等待模板再次同步。

账号与组织

入口：底部导航 Me / 我的。

• 在 Current organization 中查看或切换组织。
• 在 Service 中核对远程服务器地址。
• 在 Language 中切换中文或英文。
• 现场工作结束后点击 Sign out。

切换组织会改变可见模板和其他云端资源。切换后应回到 Templates 页面确认所需模板属于当前组织。

常见问题

无法登录

确认手机能够访问管理员提供的服务器，服务器 URL 正确，并重新输入管理员提供的账号凭据。不要通过公开渠道发送凭据截图。

模板列表为空

重新登录并确认当前组织，随后检查服务器连接和模板授权。如仍为空，请联系组织管理员确认模板是否已发布。

无法发现 NFC 设备

确认手机支持并已开启 NFC。移动手机以找到 NFC 天线位置，使其贴近设备感应区，并移除可能干扰 NFC 的厚手机壳或金属附件。

参数读取或写入失败

保持手机和设备静止后重新读取。核对模板、字段格式和参数长度；写入成功后必须再次读取验证。

升级中断

不要立即重复写入固件。记录设备型号、原版本、目标版本和中断阶段，联系管理员确认设备状态及恢复步骤。