登记、查询与删除终端

准备信息

先使用 AWTools 读取终端配置，保存设备配置到安全位置。填写服务器字段时使用读取结果，不用外壳编号、串口名称或网关 EUI 代替 DevEUI。

字段	格式与用途
DevEUI	16 个十六进制字符，终端身份
JoinEUI	16 个十六进制字符，OTAA 入网相关
DevAddr / 短地址	8 个十六进制字符，ABP 会话地址
AppKey / NwkKey	32 个十六进制字符，OTAA 根密钥；按 MAC 版本核对
AppSKey / NwkSKey	32 个十六进制字符，ABP 会话密钥
应用	终端的业务归属
设备配置 / 模版	区域、协议版本、Class 与 codec

手动添加

1. 进入“设备管理 → 终端管理”。
2. 点击“添加终端”。
3. 填写名称，选择所属应用和设备模版。
4. 填写 DevEUI，并按入网方式填写对应密钥和地址。
5. 确认没有禁用设备，再提交。
6. 保存后用完整 DevEUI 搜索，打开概览核对所属应用、模版和身份。

终端列表：本地真实页面，设备数量、状态和时间以现场为准。 点击放大

终端列表：本地真实页面，设备数量、状态和时间以现场为准。

添加终端窗口：先选择应用与模版，再填写身份。密钥已隐藏，未提交新终端。 点击放大

添加终端窗口：先选择应用与模版，再填写身份。密钥已隐藏，未提交新终端。

OTAA

终端和模版都应支持 OTAA。核对 JoinEUI 和根密钥，保存后让终端正常触发入网。看到 join 事件后，继续等待业务上行。设备已登记不等于已入网；一次 join 也不保证业务负载可正确解析。

ABP

除身份和模版外，还需正确激活会话，填写 DevAddr 和会话密钥。核对终端计数器状态；终端复位导致计数器回退时，应按会话维护流程处理。不要长期打开“跳过计数校验”来掩盖会话配置问题。

自家 ABP 自动登记

服务器支持受信任的自家 ABP 自动登记：需要功能已启用、设备目录和对应 codec 有效、实际收到兼容上行且会话校验通过。并非任意未知无线包都会建档。自动生成身份与手动登记 DevEUI 的关系以当前设备目录和实际记录为准，不能只靠短地址截取猜测。

部分兼容 ABP 档案使用短地址派生的服务器 DevEUI，界面会将前导零显示为下划线。调用 API 或订阅 MQTT 时必须从服务器查询完整 dev_eui，不能直接复制带下划线的显示文本，也不能假定它等于上位机读到的硬件 DevEUI。

先查询现有设备，避免手动重复建档。没有自动出现时，依次检查网关收到无线包、区域与信道、服务器收到网关事件、目录识别和密钥/完整性校验。修改目录后按发行版本说明同步或重启。

批量导入（按需）

1. 在终端管理打开导入入口，先下载当前版本模板。
2. 保留模板列名，填写设备数据；将 EUI、地址和密钥列设为文本，防止表格删除前导零或变科学计数法。
3. 选择文件后查看预览与逐行错误。
4. 修正所有错误，确认应用与模版，再点击“开始导入”。
5. 导入后用数量和若干完整 EUI 核对，不把部分成功当作全部成功。

模板文件包含密钥，应安全保存；录屏时也要检查文件选择窗口预览。

查询和筛选

可以按名称 / EUI 搜索，并按应用、在线状态筛选。重新查找时先清除旧筛选。详情包含概览、数据下行、荷载转码、实时数据、事件和历史数据。

编辑、禁用、重置与删除

• 编辑名称或所属应用：在概览修改，保存后重新打开核对。
• 设备禁用：用于暂停该设备参与通信，和断电/离线不同。
• 重置终端：清除服务端激活会话、下行队列、DevNonce、实时帧、事件、历史和链路统计，无法撤销；先阅读确认框，不等同于对硬件恢复出厂。
• 删除：核对完整 DevEUI 与关联业务后，在该条设备操作中删除并确认。批量删除先复核已选数量。删除登记不会擦除现场终端密钥，也不会关闭终端发射。

删除后再按 EUI 查询确认结果。如果自动登记仍启用且满足条件，后续上行可能重新生成登记。