VGUS Next

外观

Error Code 错误代码 ​

屏端运行时会监控工程资源与串口指令。发现图片/图标缺失或格式异常、字库缺失、指令帧不合法等问题时，可在屏幕左上角显示四字节十六进制 Error Code，便于定位。

适用范围： VTx（VTc / VTb）。调试阶段建议开启；量产可按屏参关闭显示。

格式说明 ​

错误代码共 4 字节（十六进制显示）：

位置含义
前 2 字节随错误类型变化（多为资源编号、图标库/图标号等）
后 2 字节错误类型码

例： 00 5A 00 0E

  • 00 0E：图片文件异常
  • 00 5A：异常图片编号 0x005A（十进制 90）→ 查第 90 号图片

错误类型一览 ​

前两字节（示意）类型码说明
00000x0001SPI 初始化异常
00000x0002系统参数 sysinitial 异常
00000x0003读取 Config 异常
BIN_ID0x0004用户数据文件异常
WAV_ID0x0005Wav 文件异常（多为 VTb）
Mp3_ID0x0006Mp3 文件异常（多为 VTb）
AVI_ID0x0007AVI 视频文件异常（多为 VTb）
FT0_ID0x00080 号字库异常
V22_ID0x0009变量初始化文件异常
UNICODE_ID0x000AUNICODE 字库异常
FT_ASC_ID0x000B用户 ASCII 字库异常
FT_GB_ID0x000C用户全角字库异常
图标库/图标编号组合0x000D图标文件异常
PIC_ID0x000E图片文件异常
00000x0010工程校验错误（可读自检寄存器，见 常用寄存器）
00000x0011串口接收到异常指令
00000x0012控件内存使用率大于 90%
00000x0013页面异常
00000x0014TTF 矢量字库异常

类型码 0x000F 在开发指南错误码表中未列出。

对照示例：

屏上显示含义
00 5A 00 0E图片 0x005A（90 号）异常
37 11 00 0D第 0x37 号图标库中第 0x11 号图标异常
00 00 00 12控件内存使用率大于 90%
00 00 00 14TTF 矢量字库异常

如何关闭左上角提示 ​

调试阶段建议保留显示。出厂不希望用户看到时：在窗口顶部打开 屏参（「屏参配置」），在 miscellaneous选项 分组中取消勾选 .4位。该位控制是否在屏幕上显示系统自检错误代码，默认勾选（开启显示）。分组下方的说明文字对应该位的开/关语义。

关闭后仍应通过工程检查与串口抓包排查问题，只是屏上不再叠加提示。

常见类型与处理 ​

图片异常（… 00 0E） ​

常见原因：

  1. 工程中不存在该编号图片
  2. 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 矢量字库缺失或异常，在字库列表核对并重新添加。

替换资源后的必要步骤 ​

  1. 仅通过 VGUS Next 工程树/资源列表 替换 图片或图标
  2. 生成配置文件（或完整编译/生成下载包，以软件实际菜单为准）
  3. 重新 下载工程 到屏

相关 ​