上位机说明书

AWTools 用于在电脑上连接终端、读取和修改配置、观察通信数据，以及使用协议辅助工具。本册介绍跨型号、跨项目共用的操作；具体接线、按键时长、传感器校准和项目参数表，请配合对应终端说明使用。

先选择要完成的任务

希望先看演示，可以打开操作视频，再按对应章节的图文步骤操作。

您当前的情况	从哪里开始	完成后应该得到什么
第一次安装和使用	安装软件 → 第一次连接	连接到正确设备并读出参数；需要修改时再保存
电脑已用线连接设备	串口连接	识别正确端口，完成连接和读取
准备用蓝牙配置	蓝牙连接	找到目标设备，连接并读出配置
修改设备行为	读写配置	核对变更、保存并按提示处理重启；回读可选
配置设备入网	公共 LoRaWAN 参数	知道各字段填什么、哪些值需与平台一致
备份或复用配置	配置管理	导出备份，明确导入会自动保存到设备
查看收发或收集故障信息	串口助手 → 日志	保留含时间、方向、数据和错误信息的记录
更新终端程序	终端固件升级	核对固件、完成升级后核对身份与版本；业务检查按需
生成、转换或解析报文	通用工具箱	分清生成、解析和实际发送，按示例核对结果
已经遇到错误	常见问题与排查	找到失败阶段，按顺序处理并保留证据

从首页进入功能

首页右上角选择工作入口；配置设备通常使用串口配置或蓝牙配置。 点击放大

首页右上角选择工作入口；配置设备通常使用串口配置或蓝牙配置。

• 串口配置：识别设备，并用表单读写配置。
• 蓝牙配置：通过附近终端的蓝牙配置通道读写配置。
• 串口调试助手：按串口参数收发原始数据，需要了解对端协议。
• 工具箱：查询协议、计算校验、生成报文、解析数据及联调。

“串口配置”和“串口调试助手”都能使用串口，但它们的工作目标不同。配置页负责设备参数，调试助手负责原始收发；不要把任意串口设备当成一定能被配置页识别的终端。

最短上手流程

流程图加载中…

只查看参数，连接并读出后即可使用。修改参数时，保存并按提示处理重启。换一台设备时，重新核对设备标识和读取结果。

哪些操作可以跳过

标注	怎样理解	例子
可选	按需要选择，软件不以此作为每次操作的前提	修改前备份、保存后回读
按需 / 条件说明	只有遇到对应情况才执行	无扫描结果时手动连接；有修改才保存；需确认业务时做测试
必需条件与操作结果	相关操作中不能忽略	接口匹配、确认目标、等待写入完成、按提示处理重启

需要恢复原值时建议备份；首次调试或对结果有疑问时建议回读。排查保存失败、写入中断时，重新读取是确认现状的排查步骤。固件升级、恢复出厂等操作请阅读对应章节的额外条件。

常用词说明

名称	在本手册中的含义
上位机版本	电脑上 AWTools 软件的版本，在“关于”查看
终端固件版本	设备自身程序的版本，连接读取后在设备信息中查看
端口	电脑识别到的串口，如 COM3 或 /dev/cu.usb…
EUI / DevEUI	用于区分设备的标识，不能仅凭相同型号判断是同一台设备
读取	从当前设备获取参数，更新页面中的值
本地编辑	在页面里修改字段，还没有执行设备写入
保存修改	把待修改内容写入设备；是否还需重启，以提示为准
回读	保存后再次读取，用设备返回值确认修改是否生效
HEX	用十六进制表示字节，如 01 表示一个字节
Payload	应用载荷，不等于完整 LoRaWAN 无线帧

配图和视频如何使用

图片下方的图注指出当前操作位置。局部放大的图片保留完整原图，点击后可选择 原始尺寸 查看细节，按 Esc 或点击 关闭 返回正文。

配图中的端口、版本、型号、EUI 和参数只用于说明界面。标明“离线示例”的图片展示工具的示例输入输出，不代表现场设备上报或实际发送结果。

原生界面主要采集于 26.10.16-951；未连接的串口首页保留为早期界面示例。版本号、端口、设备身份和参数均为采图时的示例，当前版本以自己软件的“关于”页面为准。离线组件图会在图注标明，不代表设备通信结果。

本册 18 个操作章节均有视频。视频用于演示本章标明的场景，详细参数与条件以对应图文为准；蓝牙视频仅演示扫描排查，安装视频不演示重装，工具联调未执行的部分会明确标注。

公共功能与终端手册的分工

本册讲解共用的连接、字段操作、网络参数概念、配置管理和维护流程。终端分册用于说明每个型号的接线、电源、蓝牙开启方法、专属采集/控制功能、推荐参数和项目差异。

某个分组或按钮未出现时，先确认读取成功，再核对该型号和固件是否支持。不能依据另一型号截图判断自己的设备缺少功能。