外观
Error Code 错误代码
屏端运行时会监控工程资源与串口指令。发现图片/图标缺失或格式异常、字库缺失、指令帧不合法等问题时，可在屏幕左上角显示四字节十六进制 Error Code，便于定位。
适用范围： VTx（VTc / VTb）。调试阶段建议开启；量产可按屏参关闭显示。
格式说明
错误代码共 4 字节（十六进制显示）：
| 位置 | 含义 |
|---|---|
| 前 2 字节 | 随错误类型变化（多为资源编号、图标库/图标号等） |
| 后 2 字节 | 错误类型码 |
例： 00 5A 00 0E
00 0E：图片文件异常00 5A：异常图片编号0x005A（十进制 90）→ 查第 90 号图片
错误类型一览
屏左上角显示的 4 字节，与寄存器 0xF3–0xF6 相同：前两字节对应 0xF3–0xF4，类型码对应 0xF5–0xF6。MCU 侧读写见 常用寄存器 · 系统自检。
| 前两字节 | 类型码 | 描述 |
|---|---|---|
0000 | 0x0001 | SPI 初始化异常 |
0000 | 0x0002 | 系统参数 sysinitial 异常 |
0000 | 0x0003 | 读取 Config 异常 |
BIN_ID | 0x0004 | 用户数据文件异常 |
WAV_ID | 0x0005 | WAV 文件异常 |
Mp3_ID | 0x0006 | MP3 文件异常 |
AVI_ID | 0x0007 | AVI 文件异常 |
FT0_ID | 0x0008 | 0 号字库异常 |
V22_ID | 0x0009 | 变量初始化文件异常 |
UNICODE_ID | 0x000A | UNICODE 字库异常 |
FT_ASC_ID | 0x000B | 用户 ASCII 字库异常 |
FT_GB_ID | 0x000C | 用户全角字库异常 |
ICON_ID + ICON_NUM | 0x000D | 图标文件异常 |
PIC_ID | 0x000E | 图片文件异常 |
0000 | 0x0010 | 工程校验错误（读 0xF3 启动自检时返回） |
0000 | 0x0011 | 串口接收到异常指令 |
0000 | 0x0012 | 控件内存使用率大于 90% |
0000 | 0x0013 | 页面异常 |
0000 | 0x0014 | TTF 矢量字库异常 |
类型码 0x000F 未使用。
其中 BIN_ID / WAV_ID / PIC_ID 等为出错资源编号；图标异常时前两字节携带 ICON_ID 与 ICON_NUM。
对照示例：
| 屏上显示 | 含义 |
|---|---|
00 5A 00 0E | 图片 0x005A（90 号）异常 |
37 11 00 0D | 第 0x37 号图标库中第 0x11 号图标异常 |
00 00 00 12 | 控件内存使用率大于 90% |
00 00 00 14 | TTF 矢量字库异常 |
屏左上角出现 0x0011？
类型码 0x0011（屏上常见整段 00 00 00 11）表示屏收到了无法识别、长度不对或格式不完整的串口指令。
处理：
- 核对帧头、指令长度、是否按 HEX 发送、波特率是否一致
- 核对 TTL / RS-232 / RS-485 电平与接线是否匹配
- 启用 CRC 时，确认长度是否计入 CRC、算法是否按 CRC 校验（不含帧头与长度字段）
- 显示无异常、仅调试干扰时，可暂时关闭左上角提示（见下节），但仍建议抓包查根因
更多串口排查见 串口通信 FAQ。
左上角出现 0x000d、0x000e、0x000c 等分别代表什么？
后两字节为错误类型码（完整 4 字节含义见上文「格式说明」）：
| 类型码 | 含义 | 优先检查 |
|---|---|---|
0x000D | 图标文件异常 | 图标库/图标编号是否存在、格式是否支持 |
0x000E | 图片文件异常 | 图片编号、JPG 是否为基线格式 / BMP 24 位 |
0x000C | 用户全角字库异常 | 字库是否加入工程、控件 FONT 是否指向该编号 |
0x000B | 用户 ASCII 字库异常 | 同上，查 ASCII 字库 |
0x0011 | 串口异常指令 | 帧格式与通信参数 |
前两字节常为出错资源编号。对照示例与处理见下文「常见类型与处理」。
左上角错误代码能关闭吗？
可以。调试阶段建议保留显示；量产不希望用户看到时按下一节关闭。关闭后错误仍可能写入寄存器 0xF3–0xF6，只是屏上不再叠加提示。
如何关闭左上角提示
调试阶段建议保留显示。出厂不希望用户看到时：在窗口顶部打开 屏参（「屏参配置」），在 miscellaneous选项 分组中取消勾选 .4位。该位控制是否在屏幕上显示系统自检错误代码，默认勾选（开启显示）。分组下方的说明文字对应该位的开/关语义。关闭后需重新生成配置文件并下载到屏。
关闭后仍应通过工程检查与串口抓包排查问题，只是屏上不再叠加提示。
常见类型与处理
图片异常（… 00 0E）
常见原因：
- 工程中不存在该编号图片
- JPG 非屏端支持的 Baseline（基线） 格式（虚拟屏正常、实屏黑屏/跳页失败时尤其常见）
处理：
- 在 VGUS Next 工程资源/图片列表 中添加或替换该编号图片（不要只在资源管理器里改工程目录文件）
- JPG 异常时：用画图/PS 另存为 24 位 BMP，或另存 JPG 并选 基线标准；再在软件内替换
- VTc 等使用压缩位图路径时，JPG 格式问题相对少见，仍以实屏表现为准
图标异常（… 00 0D）
例： 37 11 00 0D → 第 0x37 号图标库中第 0x11 号图标异常。
- 库中缺少该图标：在对应 ICO/图标库中补齐
- 格式问题：同图片，改为 BMP/PNG（透明优先 PNG）后再在软件内替换
FF 00 00 0D：当前页有图标类控件未指定图标库，需逐个检查控件属性
若业务上故意引用「不存在」的图标做特效，可关闭 Error Code 显示以免干扰。
ASCII / 全角字库异常（00 0B / 00 0C）
工程缺少控件引用的字库编号。在字库列表添加对应编号字库，并保证控件 FONT 属性与之一致。
视频异常（00 07，多为 VTb）
编号对应的 AVI 不存在或格式不符。在资源列表正确添加/替换；格式要求见视频相关说明。VTc 通常无视频能力。
串口异常指令（00 00 00 11）
帧头缺失/截断、帧间多余字节等。结合屏上附带的异常帧片段与 帧格式、串口指令 核对 MCU 发送内容。
控件内存 / 页面 / TTF（00 12 / 00 13 / 00 14）
00 00 00 12：当前页控件占用内存过高，精简控件或拆页。00 00 00 13：页面配置异常，检查该页是否损坏或资源不完整。00 00 00 14：TTF 矢量字库缺失或异常，在字库列表核对并重新添加。
替换资源后的必要步骤
- 仅通过 VGUS Next 工程树/资源列表 替换 图片或图标
- 生成配置文件（或完整编译/生成下载包，以软件实际菜单为准）
- 重新 下载工程 到屏