2026-07-06 修改记录

推理程序心跳

新增独立心跳上报：

POST http://127.0.0.1:<upload-port>/heartbeat

心跳只在启动参数指定了有效 -p <upload-port>，且 -c <processUUID> 非空时发送。当前发送周期沿用 HEARTBEAT_SECS = 60。

心跳包结构：

{
  "message_type": "heartbeat",
  "schema_version": 1,
  "serial": "<processUUID>",
  "process_uuid": "<processUUID>",
  "status": "running",
  "timestamp": 1778826272
}

其中 serial 和 process_uuid 都来自启动参数 -c。例如 fire_check 进程应传入 deviceUUID_fire_check。

心跳发送点放在解码帧完成 RGA 转换之后、时间段判断之前。因此即使 -P/--time-period 当前不执行识别，只要推理程序仍在读流解码，也会继续刷新心跳。

推理结果业务包

业务结果仍然走原接口：

POST http://127.0.0.1:<upload-port>/video/post

本次只新增顶层区分字段，不改变原有业务字段：

{
  "message_type": "inference_result",
  "schema_version": 1,
  "serial": "<processUUID>",
  "type": 19,
  "at": 1778826272,
  "params": [
    {
      "class_idx": 1,
      "name": "person",
      "number": 1
    }
  ]
}

管理程序可按以下规则区分：

/heartbeat + message_type=heartbeat          -> 只刷新心跳
/video/post + message_type=inference_result  -> 业务推理结果

未修改内容

未修改识别阈值、workspace 过滤、类别判断、NMS、模型后处理逻辑。
未修改 /video/post 中 serial/type/at/params 原有字段含义。
未恢复旧的 number=0 心跳业务包。
当前推理程序缓存文件仍是 .h264，没有改成 .mp4。

mp4-merge 代码确认

已查看本地 mp4-merge/ 源码。该项目是 MP4 box 级合并工具，依赖输入文件已有 moov/mdat/stbl 等 MP4 容器结构，当前不能直接合并裸 .h264。

如果要支持 .h264，推荐在 mp4-merge 命令入口增加预处理：

.h264 -> ffmpeg 无损封装为临时 .mp4 -> 复用现有 join_files 合并

不建议直接在现有 MP4 box 合并逻辑里解析裸 H264。

构建验证

已使用 WSL + Linaro 交叉编译通过，生成产物：

C:\Users\Smos.DESKTOP-6MT98U8\Desktop\yolov5-inference\build-aarch64\yolov5

构建输出为 ARM aarch64 ELF。构建过程中出现 Windows/WSL 时间戳导致的 Clock skew warning，但目标文件已成功生成。

2.4 KiB Raw Blame History