ISM-DTU 设备与配置工具
本手册说明设备流量服务、面板指示灯、复位按键及 Windows 配置工具的常用操作,供设备安装、调试和日常维护时参考。
1. 功能范围
配置页的读写配置、保存、恢复默认、重启、SIM 信息、版本检查和 OTA 操作使用统一的链路判断。用户不必为每种操作分别选择串口或远程命令;工具根据当前连接和调试设备选择状态分发命令。
同时,工具统一按钮类别、颜色、尺寸、悬停和禁用状态。调试数据页原有的远程快捷操作继续保留,包括远程读取/写入配置、远程 OTA,以及启停设备调试等。
2. 流量服务说明
- 流量用于设备通过蜂窝网络与业务服务器通信,也可能包含设备管理、远程调试及升级等网络数据。
- 请在业务设计中控制上报频率和报文大小;大量频繁上报、长时间调试或 OTA 下载会增加流量消耗。
- “每月 30 MB”是套餐月度额度。额度是否结转、超额后的处理方式、套餐起算日及覆盖范围,请以设备订单、服务协议或运营商查询结果为准。
- 配置工具当前不提供蜂窝套餐余量查询功能。需要核对剩余流量时,请通过供货服务渠道或运营商提供的查询方式确认。
3. 设备指示灯与复位按键
| 面板标识 | 状态/表现 | 用户可据此判断 |
|---|---|---|
| NET / 蓝灯 | 蜂窝网络尚未连通时,与 RUN 绿灯交替闪烁,约每 0.5 秒切换。 | 设备正在等待蜂窝网络连接;检查天线、SIM 卡、信号覆盖和套餐状态。 |
| NET / 蓝灯 | 蜂窝网络已连接、未连接调试 MQTT 时,蓝灯约每 0.5 秒闪烁;未连接的数据服务器通道会由 RUN 灯较快闪烁提示。 | 蜂窝链路可用不代表业务服务器已连接,需结合 RUN 灯和平台状态判断。 |
| NET / 蓝灯 | 调试 MQTT 连接时蓝灯常亮;串口收到数据时蓝灯短闪约 400 ms。 | 常亮表示调试链路在线;短闪表示串口有数据到达设备。 |
| RUN / 绿灯 | 存在已启用的数据通道且服务器已连接时通常熄灭;没有已连接的数据服务器时约每 0.2 秒闪烁。 | 闪烁表示尚无已连接的数据服务器通道;检查服务器地址、端口、账号及网络状态。 |
| RUN / 绿灯 | 网络数据转发到串口时短闪约 400 ms。 | 表示设备正在向串口输出业务数据。 |
| NET + RUN | 恢复出厂流程触发时,两灯按特定节奏闪烁,随后设备重启。 | 若非预期发生,请检查复位按键是否被连续按压或卡住。 |
指示灯由多种状态共同控制,灯灭不能单独证明设备故障;请结合配置工具状态栏、设备在线状态和业务服务器日志判断。不同硬件批次的面板颜色/丝印请以实物为准。
实体复位键
设备运行逻辑为:在 10 秒内按下复位键 5 次会清除设备保存的配置数据并自动重启。它不是普通重启键。恢复后设备使用固件默认配置,原有服务器地址、通道、串口和 MQTT 参数可能需要重新配置。执行前应确认确实需要恢复出厂设置;正常重启请使用配置工具中的“重启设备”。
4. 配置工具连接与按钮状态
| 条件 | 操作路由 | 配置操作按钮 | 说明 |
|---|---|---|---|
| 串口已连接 | 串口 | 空闲时启用 | 通过 AT 命令与设备通信。 |
| 串口未连接,MQTT 调试链路已连接,且已选中设备 | 远程 | 空闲时启用 | 远程目标为调试数据页当前选中的设备 CCID。 |
| 串口和远程链路均可用 | 串口 | 空闲时启用 | 串口优先。 |
| 没有可用链路,或远程链路没有选中设备 | 无 | 禁用 | 需先连接串口,或在调试页连接并选择设备。 |
| 设备操作正在执行/等待远程回执 | 保持当前路由 | 设备操作按钮禁用 | 串口和远程操作共用忙碌状态,避免重复触发。 |
远程模式下,操作按钮提示信息会显示目标 CCID,便于确认命令将发往哪台设备。链路状态变化、调试设备选择变化和忙碌状态变化都会刷新操作按钮。
5. 配置操作按钮说明
| 按钮 | 用途 | 操作提示 |
|---|---|---|
| 连接 / 断开 | 连接或断开 USB/串口配置通道。 | 连接前选择正确的串口和波特率。断开前等待当前设备操作结束。 |
| 刷新 | 重新扫描电脑当前可用串口。 | 设备刚插入但端口列表没有显示时使用。 |
| 读取配置 | 读取设备当前设置并填入表单。 | 修改前建议先读取,避免基于过期表单覆盖设备参数。 |
| 写入配置 | 把表单中的配置下发到设备。 | 需要先读取设备配置;工具会校验参数。串口方式写入后会回读校验。 |
| 保存到设备 | 将已写入的配置保存到设备,断电后保留。 | 串口操作时通常在写入配置后执行。远程下发配置已由设备直接保存。 |
| 导入配置 / 导出配置 | 从本地配置文件载入参数,或把当前表单保存为配置文件。 | 导入文件不会自动写入设备;仍需检查内容并执行“写入配置”。导出文件应妥善保管。 |
| 恢复默认 | 将设备配置恢复为固件默认值。 | 会覆盖设备现有设置;远程执行成功后设备重启。恢复前记录业务服务器和串口参数。 |
| 重启设备 | 重新启动设备,使需要重启生效的配置应用。 | 等待设备重新上线后再连接或检查状态。 |
| 获取卡信息 | 读取 SIM/蜂窝卡相关信息。 | 用于确认设备识别到 SIM 卡;读取失败时检查 SIM 安装和网络状态。 |
| 检查新版本 / 开始升级 / 查询状态 | 查询可用固件、启动 OTA 升级并查看升级状态。 | 升级时保持供电和网络稳定,不要断电。仅安装适用于本设备型号的固件。 |
6. 调试数据页按钮说明
| 按钮 | 用途 | 提示 |
|---|---|---|
| 刷新设备 | 刷新账号下绑定设备及在线状态列表。 | 列表中选中目标设备后,远程操作会以该设备 CCID 为目标。 |
| 打开调试 / 关闭调试 | 开启或关闭选中设备的远程调试数据通道。 | 调试会产生网络通信并消耗套餐流量;不需要时建议关闭。 |
| 读取配置 / 下发配置 | 经 MQTT 远程读取或下发设备配置。 | 下发操作会保存配置;请确认选中设备和参数内容。 |
| 开始升级 | 向选中设备发送远程 OTA 请求。 | 升级地址应为有效 HTTP/HTTPS 地址,并与设备型号匹配。 |
7. 配置操作说明
| 操作 | 串口行为 | 远程行为 | 注意事项 |
|---|---|---|---|
| 读取配置 | 通过 AT 读取设备配置,并回填表单。 | 发送 get_config,成功后解析设备返回内容并回填表单。 | 远程结果在界面线程应用;SIM/状态页的只读信息按返回能力更新。 |
| 写入配置 | 发送 AT 配置命令写入设备运行配置,随后回读并校验。 | 发送 set_config;固件保存配置,并更新当前运行配置。 | 写入前必须先读取设备配置;工具执行配置格式和字段校验。远程写入语义包含保存。 |
| 保存到设备 | 发送 AT 保存命令,将当前配置持久化。 | 发送 save,由固件调用配置保存接口。 | 串口写入和保存是两个独立步骤;远程 set_config 已包含保存。 |
| 恢复默认 | 通过 AT 执行恢复默认配置。 | 发送 restore_default,固件生成默认配置并保存;成功后设备重启。 | 恢复默认会覆盖现有配置。重启完成前远程连接会暂时中断。 |
| 重启 | 通过 AT 命令重启设备。 | 发送 reboot;固件先回送结果,再延时约 500 ms 重启。 | 成功后等待设备启动,再重新连接。 |
8. SIM、版本与 OTA
- 读取 SIM 信息:串口模式通过设备 AT 命令读取;远程模式发送
get_sim_info。 - 检查更新/读取版本:通过当前操作路由读取设备版本并与工具可用版本信息进行比较。
- 开始 OTA:串口模式使用现有 AT OTA 流程;远程模式发送
start_ota和升级 URL。远程 URL 必须是绝对http://或https://地址。 - 检查 OTA 状态:当前界面仅在串口路由可用时启用该操作。
远程 OTA 的命令回执表示升级已启动或启动失败,不代表固件下载、校验和安装已全部完成。后续进度以设备状态上报及工具状态栏/日志为准。
9. 远程命令与结果处理
远程请求使用唯一 requestId 与设备回执关联。工具将未完成请求登记在待处理集合中,收到匹配结果后更新状态栏、主日志和调试日志,并解除忙碌状态。远程请求等待回执最长 60 秒;超时后提示目标 CCID 并允许继续操作。
| 场景 | 界面反馈 |
|---|---|
| 命令发送成功,尚未收到结果 | 显示命令已发送及目标设备,继续等待回执。 |
| 设备返回成功 | 显示操作完成;读取配置等有返回数据的命令会应用结果。 |
| 设备返回失败 | 显示固件错误码/错误原因并记录日志。 |
| MQTT 发送异常 | 显示发送失败原因,清除本次请求并解除忙碌状态。 |
| 60 秒没有匹配回执 | 提示远程操作超时及目标 CCID,解除忙碌状态。 |
10. 按钮颜色说明
按钮统一高度为 30 px,圆角为 8 px。实心按钮悬停时提亮,次要按钮悬停显示浅蓝底;禁用时降低对比度并阻止触发。
| 类型 | 视觉 | 典型操作 |
|---|---|---|
| Primary | 工业蓝实心(#1668B3) | 读取配置、连接、读取 SIM、开始 OTA。 |
| Secondary | 白底描边、深色文字 | 写入配置、导入/导出、刷新、远程快捷操作、证书导入。 |
| Success | 绿色实心(#1E8E5A) | 保存、启用调试。 |
| Warning | 琥珀色实心(#C97A1E) | 恢复默认、检查更新。 |
| Danger | 红色实心(#C2413B) | 重启、断开连接、禁用调试。 |
11. 配置操作建议流程
- 建立串口连接,或进入调试数据页确认 MQTT 已连接并选中目标设备。
- 确认操作按钮已启用;远程模式下检查按钮提示中的 CCID。
- 先执行“读取配置”,确保工具表单与设备当前配置一致。
- 修改配置后执行“写入配置”。串口写入会回读校验;远程写入由设备保存并返回结果。
- 串口模式如需单独持久化,再执行“保存到设备”。远程模式下写入配置已经保存。
- 如修改了需要重启生效的参数,按业务需要执行重启;执行恢复默认时设备会自行重启。
12. 常见问题与注意事项
- 远程操作必须有可用 MQTT 调试链路,且当前设备列表中存在选中的 CCID。
- 远程命令仍受设备忙碌保护影响;设备正在执行其他配置/OTA操作时可能返回忙碌错误。
- 调试页快捷按钮与配置页操作入口并存,前者保留用于调试流程。
- 当前固件的
restore_default成功回执不附带恢复后的配置 JSON;工具以设备回执作为成功依据。 - 远程
set_config保存成功后,如 UART 参数发生变化,固件会重启以使 UART 参数在启动时生效。
本说明按当前工具端与固件代码可观察行为整理。设计方案中列出的后续预期与现状存在差异时,以此处“当前实现说明”及实际版本行为为准。