← 返回工具 | 📖 OTA 设备升级监管工具 — 使用帮助

📖 使用帮助

一、设备卡片字段说明

每台设备的卡片展示了查询到的关键信息。以下逐一解释每个字段的来源和含义:

字段 示例值 来源 & 含义
固件版本 TM721_YH_LED1.1.0.a6 设备当前运行的固件版本号。由 0107(终端属性应答)和 6006(终端文本消息)两个来源合并计算得出。优先采用最新时间、非零的有效版本。
6006固件 TM721_YH_LED1.0.0.a1 来源 消息ID 6006(0x6006):终端文本消息,内容格式 VER=HW:xxx/APP:yyy。设备主动上发,通常与平台升级指令触发关联。
仅在设备处于"升级中"或有升级历史时显示
0107固件 TM721_YH_LED1.1.0.a6 来源 消息ID 0107(0x0107):终端属性应答,TLV 格式的硬件/固件版本字段。设备响应平台属性查询时上报。
仅在设备处于"升级中"或有升级历史时显示
硬件版本 TM721A-H011B 设备硬件电路板版本号。可从 0107 或 6006 消息中获取,由 TLV 固件版本字段之后的一个字节分隔后解析。
活跃状态 在线 / 待确认 / 离线 基于今日最新消息时间的判断:
在线 ≤10分钟内有新数据
待确认 10~30分钟内有数据
离线 >30分钟无数据 或 今日无记录
版本时间 (📡) 06/27 10:53 设备最新一次上报版本号(0107 或 6006)的报文时间。代表设备端时钟时间。
查询时间 (🕐) 06/27 10:53 本工具最新一次查询该设备数据的时间。是你主动操作的记录。
基准版本 (基:xxx) 基:TM721_YH_LED1.1.0.a5 只在设备标记为"升级中"时显示。即触发升级时锁定的固件版本号,升级判定以此为基线比较。

二、卡片图标 & 按钮

🔍
查询该设备最新数据
🚀
标记为升级中,锁定当前版本为基线
手动标记升级成功
手动标记升级失败(弹出原因选择)
🗑
从当前任务删除该设备
取消升级中状态

状态徽标

🟠 升级中
设备正在等待升级判定,有呼吸灯动画。30秒后检查应答,3分钟轮询,10分钟超时
✅ 已成功
升级已成功(版本号发生变化)
❌ 失败
升级失败,鼠标悬停可看原因

三、升级流程 & 规则

3.1 升级状态机

状态说明
⚪ 待升级初始状态,点击 🚀 进入升级中
🟠 升级中已标记,等待设备应答和版本变化
- 30秒后检查应答报文(type=24582/33536,含 DIP=U
- 无应答 → 标记失败(未应答)
- 应答后30秒内仍有数据 → 标记失败(未中断)
- 应答正常 → 继续 3 分钟轮询版本号
- 10分钟超时 → 标记失败(超时)
✅ 升级成功版本号发生变化(与基线不同)→ 自动判定成功
❌ 升级失败以下情况触发失败:
1. 设备未应答(30秒无 DIP=U 确认)
2. 设备持续上报未中断(应答后仍在发数据)
3. 版本号未变化(升级后但版本未变)
4. 超时未上线(>10分钟)
5. 管理员手动标记

3.2 版本号判定规则

未升级时(自动合并)
1. 同时解析 0107 和 6006 两个来源的最新版本号
2. 纯零版本(0000 / 00000 / 0 等)视为无效,自动跳过
3. 两者都有效 → 对比报文时间,取最新
4. 只有一个有效 → 使用该来源
5. 两个都无效或没有 → 显示 "-"
升级中/升级后(分开展示)
卡片上独立显示三行:6006固件版本 / 0107固件版本 / 硬件版本
升级判定同时监控两个来源的变化,任一版本变化即判定升级成功

四、顶部操作栏

按钮/控件功能
📥 导入设备号批量粘贴设备号(每行一个/逗号分隔),自动去重后导入到当前任务
🚀 标记升级中将已勾选的设备批量标记为升级中
🗑 批量删除删除已勾选的设备
📤 导出数据导出 JSON / CSV / HTML 表格三种格式
🔄 全部刷新重新查询当前任务所有设备(排除升级中的)
▶ 查询选中仅查询已勾选的设备
📋 版本管理跳转到版本管理页面
📊 历史记录跳转到历史记录页面(服务器持久化数据)
❓ 使用帮助本页面
☁ 同步到服务器将全部设备数据推送到服务器,实现跨电脑同步
搜索框按设备号模糊搜索 / 筛选活跃状态 / 固件版本 / 硬件版本 / 升级状态 / 查询状态
排序下拉按活跃度 / 设备号 / 固件版本 / 查询时间排序
☑ 全选一键勾选/取消当前筛选结果中的所有设备
📋 复制已勾选将已勾选设备的设备号复制到剪贴板

五、顶部仪表盘

卡片含义
📊 设备总数当前任务下的设备总数
🟢 在线≤10分钟内有新数据的设备
🟡 待确认10~30分钟内有数据的设备
⚫ 离线>30分钟无数据或今日无记录
🟠 升级中当前处于升级中状态的设备数量
✅ 升级成功升级历史中有成功记录的总设备数
❌ 升级失败最后一次升级结果为失败的设备
⏳ 待查询导入后尚未查询过的设备
📊 成功率所有升级记录中成功的比例(成功次数/总次数)

点击仪表盘任一卡片可快速跳转到对应筛选条件。

六、任务系统

任务标签位于仪表盘上方,用于分组管理设备。不同批次的升级活动可创建独立任务,互不干扰。

七、JT/T808 协议解析

工具解析的关键消息类型

十进制十六进制名称用途
2630x0107终端属性应答TLV 格式的固件版本 (FW) 和硬件版本 (HW)
245820x6006终端文本消息VER=HW:xxx/APP:yyy 格式的版本信息 + 升级应答确认
5120x0200定位数据GPS 经纬度、速度等
20x0002心跳保持连接
23040x0900数据上行透传ANT 私有协议数据
327690x8001平台通用应答平台消息的确认回复

八、常见问题

Q: 为什么有些设备版本号显示 "0000"?

某些设备 0107 应答的固件版本字段为全零,工具会自动回退到 6006 来源获取真实版本号。若升级前仍显示 0000,可能是该设备当日无 6006 报文。查询一次即可更新。

Q: 升级判定为什么不准确?

工具同时监控 0107 和 6006 两个来源。升级中设备卡片会分开展示两条版本号,任一路径版本变化即判定成功。请在升级中状态下再查询一次以获取最新判定。

Q: 换电脑后为什么设备不见了?

设备数据存储在浏览器本地。换电脑前需在原电脑点击「☁ 同步到服务器」,新电脑打开后会从服务器自动恢复。

Q: 在线/离线判断的"今天"是什么时间范围?

当天 00:00 至当前时刻。API 查询范围也限定为当天数据。跨天数据需要重新点击查询。