VGUS Next

外观

描述指针 ​

描述指针用于在运行时临时修改控件的显示格式（颜色、位置、字库等）。多数简单工程不必启用；默认填写 FFFF 即关闭。

适用范围： VGUS Next 面向 VTx（VTc / VTb）。旧指南中不支持描述指针的系列不在本期文档范围。

它解决什么问题 ​

屏端采用变量驱动：显示格式一般写在组态配置里并随工程下载。运行时 MCU 用 0x82 写变量值即可刷新内容。

当需要临时改显示格式（例如把某数据变量改成红色告警色），可为该控件启用描述指针：在变量存储器中开辟一块与控件属性对应的格式区，再用 0x82 按偏移写入。

如何启用 ​

  1. 在 VGUS Next 选中控件，找到属性 描述指针(0x)
  2. 填 FFFF：关闭（默认，推荐多数场景）
  3. 填 0000–FFFE：启用，该值即为描述区在变量存储器中的起始字地址

启用后，屏按该基址连续占用一段空间，长度与字段布局因控件而异，详见分类偏移表。

地址规划注意 ​

  • 描述指针与业务变量地址共用变量存储器，不得重叠
  • 不同控件的描述区也不得重叠
  • 建议在对照偏移表估算长度后，再额外预留若干字（旧指南建议至少约 16 word 裕量，以实际表长为准）
  • 可用 地址地图 检查冲突

用 0x82 修改格式 ​

实际写入地址 = 描述指针基址 + 字偏移。

例如：数据变量描述指针 = 0x4000，颜色字段偏移 = 0x03，则向 0x4003 写颜色字即可改显示色。

帧格式与更多举例见 串口指令 · 0x82。

完整示例：改数据变量颜色 ​

  1. 添加「数据变量」，变量存储地址 = 0x0000，描述指针 = 0x4000
  2. 查 数据变量偏移表：颜色 Color 偏移为 0x03
  3. MCU 发送（帧头 A5 5A，写变量 0x82，向 0x4003 写入红色 0xF800）：
text
发送：A5 5A 05 82 40 03 F8 00

数据变量将按红色显示。也可用「按钮键值返回」等控件，在按下时把键值直接写到 0x4003。

哪些控件支持 ​

标清「摄像头」偏移见 描述指针 — 显示控件。高清摄像头、4 路同显若属性面板有描述指针项，偏移以面板帮助与固件为准（旧指南第 7.3 未单独列出）。

偏移表入口 ​

分类页面
显示控件desc-pointer-display
触摸控件desc-pointer-touch
高级控件desc-pointer-advanced

相关 ​