图像调试
图像调试
概述
图像调试用于接收和显示图像类数据流，适合摄像头、视觉传感器、图像压缩模块、图像算法中间结果等场景。它和普通文本接收区不同，关注的是“把一帧图像完整解析出来并显示”。
纸飞机的图像数据包由“帧头 + 帧数据段”组成。帧头用于定位数据包，帧数据段可以承载图像、曲线或文本数据。帧头校验和包校验均使用满足 ModbusRTU 风格的 CRC 校验规则。
适合场景
MCU 或 SoC 输出灰度图、RGB565、RGB555、JPG 等图像帧。
调试摄像头采集链路，确认图像是否错位、花屏、截断或颜色异常。
观察图像算法的中间结果，例如二值图、边缘图、ROI 区域。
在自由工作区中把图像卡片与曲线、数值显示器放在同一屏。
数据格式
图像传输建议使用软件随附示例中的 Unify 协议文件，例如 unify_protocol.c、unify_protocol.h、modbus_crc.h。下位机只需要按示例构造帧头，再紧跟符合图像类型的帧数据即可。
典型流程：
下位机准备一帧图像数据。
根据图像格式、宽度、高度和数据长度构造帧头。
计算帧头校验和数据校验。
先发送帧头，再发送图像数据段。
纸飞机收到完整帧后解析并刷新图像窗口。
如果使用自由工作区图像卡片，图像数据仍来自协议解析链路；工作区只负责把结果展示在布局中。
操作步骤
在纸飞机中打开图像调试窗口或包含图像卡片的自由工作区。
确认当前协议和下位机发送格式匹配。
下位机按 Unify 图像帧格式发送测试帧。
观察图像是否完整、方向是否正确、颜色是否正常。
如果需要长期观察，可结合实时记录或外部脚本保存图像输入源。
注意事项
图像传输带宽消耗较大，优先使用网络通信；低波特率串口只适合小图或低帧率。
图像帧必须完整发送，缺少帧头、长度不匹配或 CRC 错误都会导致解析失败。
花屏通常和宽高、像素格式、字节序或帧截断有关。
JPG 数据要保证编码完整；RGB565、RGB555、GRAY8 等原始格式要保证像素数量与宽高一致。
如果同时开启大量曲线、分窗和图像刷新，建议关注 CPU、内存和通信吞吐。
MCP 自动化
MCP 暴露了图像调试设置和状态查询能力，例如读取图像调试状态、设置窗口 ID、匹配窗口、保存路径、记录帧率和录制开关。AI agent 可以用这些接口确认图像调试是否开启、当前是否在录制，以及图像窗口是否收到数据。
> 本文为 AI 辅助生成内容