8.4 KiB
8.4 KiB
MAG160C 真机端到端自检清单（Phase A3）
用法：把最新
build-artifacts/mag160c-app-debug.apk装到手机，插上 MAG160C 热像仪，按顺序做一遍。每步的"预期 DebugLog 行"可在应用内 debug 日志文件中 对照（DCIM/MAG160C/debug_*.log；若 DCIM 拒收则 Download/MAG160C；文件头sink=注明实际落点），也可用adb logcat -s MAG160C/*实时看。日志行格式：
HH:mm:ss.SSS [tag] message。下表消息列为现有代码中的原文 （变量处用 <...> 占位）。若某项对不上，把整个日志文件发回分析。
步骤表
| # | 操作 | 预期 DebugLog 行（原文） | 通过标准 |
|---|---|---|---|
| 1 | 插入热像仪，系统弹出 USB 权限对话框，点"允许" | [usb] requestPermission: no device（无设备时）/ [usb] requesting permission (dialog) → [usb] permission result: true |
授予权限后自动开始连接 |
| 2 | 等待连接（首次约 1~3 s，首次装机需下载标定文件时更久） | [vm] connect() → [vm] permission ok, ddt <N> bytes, starting session → [session] state -> LINKING msg=null → [cmd] GetParameter1 write=4/4 → [cmd] GetParameter1 resp=0x5BB5B55B len=60 head=... → [cmd] BasePara1: serial=160043865 devType=3 160x120 @15fps |
五条全出现；serial/devType 与实际相机一致（devType=3 即 core160） |
| 3 | 同上（参数/标定握手） | [cmd] GetParameter2 resp=0x5BB5B55C len=... → [cmd] GetCaliInfo resp=0x5BB5B55E len=... → [session] cali info: size=<size> date=<date> → [session] device lifetime=<ms>ms |
GetParameter2/GetCaliInfo 有响应；lifetime 非 -1（0 或正数均可，首次上电后很小正常） |
| 4 | 首次安装运行（无 cali 缓存） | [session] first run on this host: downloading cali file <size> B (EP 0x84) → [session] cali download <p>%（若干行）→ [session] cali downloaded+cached: <product>.<serial>.<date> (<size> B)；第二次运行改为 [session] cali cache hit: <name> + [session] cali cache vs bundled DDT: identical（或 differ，两者都不算失败） |
缓存命中或下载成功二者之一 |
| 5 | 等待 DDT 加载 + 出流 | [session] ddt bytes <N> → [session] state -> STREAMING msg=null → [cmd] StartTransferImg write=4/4 → [cmd] StartTransferImg ack=0x... → [stream] reader loop start: sync bulkTransfer (800 ms) + halt recovery → [stream] first reads [0] n=<n> head=... → [vm] first rendered frame -> UI |
出现 first rendered frame -> UI 即画面已出（实时页显示热像，不再黑屏） |
| 6 | 观察实时页 5 s 以上 | 每 2 s：[stream] stats: reads=<n> frames=<n> rendered=<n> timeouts=<n> fps=15.0 renderState=<n> ref=true lifetime=<ms>；每 ~5 s：[vm] hb: state=streaming streaming=true uiFrames=<n> latest=true |
frames/rendered 持续递增，fps≈15，ref=true；timeouts 偶发可接受，不应持续增长而 frames 不涨 |
| 7 | 顶栏点 FFC 两次（每次间隔 ~1 s） | 每次：[cmd] FFC(0) write=8/8 → [cmd] FFC(0) ack=0x... len=...（ack 读不到时日志为 [cmd] FFC(0) ack=<n> bytes，相机仍会执行校正，不算失败） |
画面出现一次快门校正（短暂黑/停顿后恢复） |
| 8 | 点底部大圆快门拍照 | [vm] hb: state=saved ...（下一次 5 s 心跳即可看到 status=saved）；UI 上状态文案短暂显示 |
相册/文件管理器 DCIM/MAG160C 出现 MAG160C_yyyyMMdd_HHmmss.jpg（实际为 MDT 容器，扩展名 .jpg） |
| 9 | 点录像，录 10 s，再点停止 | [vm] hb: state=recording ... → 停止后 [vm] hb: state=rec_done ... |
状态回到 rec_done，无崩溃 |
| 10 | 切到"相册"页 | （无 DebugLog；纯 UI） | 列表出现步骤 8 的照片缩略图（MDT 尾部校验通过才显示） |
| 11 | 点该照片进入分析页 | （无 DebugLog；纯 UI） | 图片可缩放/平移；调色板重渲染可用；图像顶部出现温度条（中心 x.x℃ 最低 x.x℃ 最高 x.x℃）；点图任意位置出现白色圆点+温度标签，再点同一点可清除；备注可编辑保存 |
| 12 | 分析页生成 PDF 报告 | （无 DebugLog；纯 UI） | 报告文件在 DCIM/MAG160C 或 Download/MAG160C 生成，可打开 |
| 13 | 实时页顶栏第 5 项点"画中画"（首次会弹相机权限，点允许） | [pip] camera opened id=<id> → [pip] repeating preview started |
右上角（色标条左侧）出现 128×96dp 白框小窗，显示可见光画面；顶栏该项高亮为"画中画·开" |
| 14 | 拖动 PIP 小窗到其它角落；单击小窗（循环 96/128/160dp）；双击小窗关闭 | [pip] released（双击关闭时） |
小窗跟手移动且不出界；单击在三档宽度间循环；双击后小窗消失，顶栏恢复"画中画"未开启态；日志有 released |
| 15 | PIP 开启时按 Home 回到桌面再返回 | [pip] released（进入后台时） |
返回后若 PIP 仍为开启态，画面重新出现（重新 open）；无崩溃 |
远程预览（Phase F，需要两台设备）
两台安卓设备（或一台手机 + 一个模拟器）连同一个 Wi-Fi。以下称 A=插热像仪的 主机手机，B=远程查看的手机。
| # | 操作 | 预期 DebugLog 行（原文） | 通过标准 |
|---|---|---|---|
| 16 | A：插热像仪，确认实时页已出图（清单前 6 步） | [session] state -> STREAMING |
A 本地画面正常 |
| 17 | A：设置页 → "远程预览服务端"（点一下） | [remote] host started (name=<机型> serial=0) |
该行文案变为"已开启" |
| 18 | A：若第 17 步弹"先连接热像仪" | （无日志） | 说明 USB 会话不活跃：先回到实时页确认出流 |
| 19 | B：设置页 → "远程预览客户端" → "查找主机" | （B 端）列表出现 A 的主机名 | 10 秒内列出 A（卡片显示 <主机名> 与 <IP>:47511）；未列出可用"手动添加"填 A 的 IP |
| 20 | B：点该卡片（或手动 IP 后点"连接"） | A 端：[remote] client connected from <B的IP>；B 端：[remote] client connected to <A的IP>:47511 → [remote] line: {"type":"welcome",...} → [remote] line: {"type":"stream-start"} → [remote] first remote frame |
B 显示 A 的热像实时画面（同一构图：竖屏 3:4、顶栏 4 项、右侧色标条） |
| 21 | B：顶栏点变倍/追踪/调色板 | （无日志，全部本地） | 立即生效、无卡顿（调色板/变倍不下发到 A） |
| 22 | B：顶栏点 FFC | A 端出现一次快门校正；B 画面随之更新 | FFC 经 A 的热像仪执行 |
| 23 | B：点底部红色"断开"圆钮 | A 端：[remote] client <IP> disconnected (frames=<N>) |
B 返回主机列表并弹出"已断开"提示；A 服务端保持"已开启"待重连 |
| 24 | A：设置页再点"远程预览服务端"关闭 | [remote] host stopped |
文案变回"已关闭"；A 本地热像画面不受影响 |
远程预览失败时的表现（设计如此）：连不上主机时 B 显示"无法连接主机"并返回列表；
中途断网/主机退出时 B 显示"连接已断开"；A 端相机与本地画面始终不受网络影响；
日志中 frames=… 每 300 帧记一次。
相机（PIP）失败时的表现（设计如此，不算 bug）
PIP 的相机是可选功能，任何相机异常都只记日志并关闭小窗，不影响热像主画面：
- 无相机硬件 / 权限被拒 →
[pip] no camera available/[pip] camera permission not granted， 小窗空白或未出现； - 相机被其它应用占用 →
[pip] camera error=<N>+[pip] released； - 上述情况下主画面、拍照、录像、分析全部照常工作。
失败时的快速定位（沿用第 11 轮起的诊断路径）
reads=0且timeouts持续上涨 → 相机没出流：查第 5 步 START 前后的[cmd]行与[usb] ep 0x81 fail#... halted=...（halt 会自动清除并重试）。frames>0 rendered=0→ 管线在暖机/FFC/参考窗口：看ref=false是否长期持续 （持续 false → BasePara2/66c 响应异常）。GetParameter1 resp=超时 →[session] parameter1 handshake failed -> abort， 屏显"相机无应答，请拔插热像仪重试"。- 相机中途重新枚举（
[vm] usb detached vid=0x833C+ 再次弹权限）→ 多为 OTG 供电/线材问题，换短线或带供电 OTG 再试（第 13 轮结论）。 - 任何闪退：日志文件开头
[crash]行有完整堆栈（DebugLog 崩溃钩子）。