外观
常用寄存器
本页对应开发指南 §3.2，说明联调中最常用的寄存器用法与 HEX 举例。完整地址一览见 寄存器一览。读写指令见 串口指令（0x80 写 / 0x81 读）。下文帧头默认 A5 5A（可在屏参中自定义）。
1. 版本 0x00
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x00 | Version | R | 1 | VGUS 版本号，BCD（如 0x43 表示 V4.3） |
读取版本：
text
A5 5A 03 81 00 01应答示例：
text
A5 5A 04 81 00 01 43说明：04 为指令及后续字节长度；43 为返回的版本数据。
2. 背光 0x01
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x01 | Brightness | R/W | 1 | 背光亮度 0x00–0x40 |
关闭背光：
text
A5 5A 03 80 01 00建议：功耗敏感时可降低背光；开机亮度与屏保也可在屏参中配置。
3. 蜂鸣 0x02
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x02 | BZ_TIME | W | 1 | 蜂鸣时间，单位 10ms |
蜂鸣 2s（0xC8 = 200 × 10ms）：
text
A5 5A 03 80 02 C84. 切页 0x03-0x04
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x03–0x04 | PIC_ID | R/W | 2 | 读：当前页 ID；写：切换到指定页面 |
切换到 2 号界面：
text
A5 5A 04 80 03 00 025. 按键 0x4F
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x4F | Key_code | W | 1 | 有效键码 0x01–0xFF（0x00 无效）；处理后自动清零 |
用于触发画面上已配置键码的按钮（可与外接键盘、触摸并用）。例如按钮键码为 01 时：
text
A5 5A 03 80 4F 01屏将执行该按钮被按下时的全部操作。相关控件：按钮、多功能按钮。
6. RTC 0x1F-0x26
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x1F | RTC_COM_ADJ | W | 1 | 写 0x5A 申请串口改写 RTC；完成后清零 |
0x20–0x26 | RTC_NOW | R/W | 7 | YY:MM:DD:WW:HH:MM:SS，BCD |
机型说明： VTb 支持（VTc 不支持） 通过上述地址访问 RTC（以目标机型说明书为准）。时钟显示可配合 文本时钟、表盘时钟、时钟设置。
读取完整日历：
text
A5 5A 03 81 20 07仅读取时分秒：
text
A5 5A 03 81 24 03设置 RTC（先写 0x1F=0x5A，再写 0x20 起的时间）。例如设为 2015-06-01 星期一 18:56:00：
text
A5 5A 0A 80 1F 5A 15 06 01 00 18 56 00屏会自动换算星期；写时间时星期字节可填任意值。
7. 触摸校准 0xEA
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0xEA | TPCal_Triger | W | 1 | 写 0x5A 启动一次校准；完成后清零 |
出厂前一般已校准，日常无需重复。产品集成场景可由 MCU 下发：
text
A5 5A 03 80 EA 5A启动后按屏幕提示依次点击左上、左下、右下、右上与中心十字点；完成后进入触摸测试状态。批量生产也可在屏参中勾选「TF 卡下载配置文件后启动触摸校准」。
8. 屏参动态配置 0x12/0x16-0x18/0x1C/0x1D
简单场合请直接用开发工具「屏参配置」。需要运行时改屏保或触摸伴音时，可用下列寄存器。
固件条件： VTc / VTb 支持动态设置屏保与蜂鸣器伴音（具体以目标机型固件为准）。设置掉电不保存。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x12 | MODE_CONFIG1 | R/W | 1 | bit5：0 禁止屏保 / 1 启用屏保（参数由 0x16–0x18 决定）；其余位未定义 |
0x16 | Rel_Brighness | R/W | 1 | 点亮亮度 0x00–0x40 |
0x17 | Saver_Brighness | R/W | 1 | 屏保亮度 0x00–0x40 |
0x18 | Saver_Delay | R/W | 1 | 屏保延时，单位秒 |
0x1C | MODE_CONFIG2 | R/W | 1 | bit5：0 触摸有效区有伴音 / 1 无伴音（仍可用 0x02 控蜂鸣） |
0x1D | CONFIG_EN | W | 1 | 写 0xA5 使上述设置生效 |
未定义位写入无效。改完后务必写 0x1D = 0xA5。
9. 语音 0x50-0x55
VTb 支持（VTc 不支持）。 音频可为 *.wav（建议 22kHz 单声道，即时播放）或 *.mp3（体积小，约 0.5s 延迟）。工程中添加语音文件后，用 0x80 写寄存器控制。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x50 | Music_Set | W | 1 | 0x5B 播放；0x5C 停止 |
0x51–0x52 | Music_Num | W | 2 | 音频编号 0–4095 |
0x53 | Vol_Adj_En | W | 1 | 0x5A 申请调音量 |
0x54 | Vol | W | 1 | 音量 0x00–0x40（默认 0x40） |
0x55 | Vol_Status | R | 1 | 0x00 停止；0x01 播放中 |
以 100% 音量播放 6.wav：
text
A5 5A 07 80 50 5B 00 06 5A 40停止播放：
text
A5 5A 05 80 50 5C 00 06播放中若收到新的播放指令，会立即结束当前并播放新内容。连续播放见扩展指令 0x85 03。
10. 视频 0x60-0x6E
VTb 支持（VTc 不支持）。 文件扩展名须为 *.avi。相关控件：视频播放。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x60 | Play_Avi_Set | R/W | 1 | 0x5A 申请设置播放器参数 |
0x61 | Avi_Type | W | 1 | 0x00/0x01/0x02 屏内单曲/单曲循环/顺序循环；0x03/0x04/0x05 对应 TF 卡三种模式 |
0x62–0x65 | Play_Position | W | 4 | 窗口左上角；(0,0,0,0) 居中 |
0x66–0x67 | Play_Avi_Num | W | 2 | 单曲模式下的文件编号 |
0x68 | Vol_Adj_En | W | 1 | 0x5A 申请调视频音量 |
0x69 | Vol | W | 1 | 音量 0x00–0x3F（默认 0x3F） |
0x6A | Play_Control | W | 1 | 0x5A 播放/暂停 |
0x6B | Play_Stop | W | 1 | 0x5A 停止 |
0x6C | Play_Next | W | 1 | 0x5A 下一首 |
0x6D | Play-Prev | W | 1 | 0x5A 上一首 |
0x6E | Play_Status | R | 1 | 0x00 空闲；0x01 播放；0x02 暂停 |
单曲文件名须为数字（如 123.avi）；顺序播放可用字母+数字。
MCU 控制示例： 在坐标 (10,10) 单曲播放 TF 卡内 01 号视频——先写参数再启动：
text
A5 5A 0A 80 60 5A 03 00 0A 00 0A 00 01
A5 5A 03 80 6A 5A触控方式： 0x61–0x6E 映射变量 0xFF01–0xFF0E，可用按钮等改变量实现播放控制。注意：播放视频时画面变量不刷新，且语音播放不可用。
11. 用户数据文件 0x40-0x49
用户数据文件命名为 *.bin，编号 0–255（勿使用 13、14、22、23，系统占用）。可通过工程随 TF 卡导入；也可经下列寄存器读入变量空间，再用 0x83 由 MCU 读取。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x40 | En_Lib_OP | R/W | 1 | 0x5A 申请加载；完成后清零 |
0x41 | Lib_OP_Mode | W | 1 | 固定 0xA0 |
0x42 | Lib_ID | W | 1 | 文件编号 |
0x43–0x45 | Lib_Address | W | 3 | 文件内首字地址 |
0x46–0x47 | VP | W | 2 | 变量空间首字地址 |
0x48–0x49 | OP_Length | W | 2 | 操作字长度 |
从 80.bin 的 0x000000 起读 0x1000 字到变量 0x1000：
text
A5 5A 0C 80 40 5A A0 50 00 00 00 10 00 10 00操作约需数十毫秒级，连续发指令时请插入延时。VTc / VTb 均支持本段寄存器。
12. 数据库 0x56-0x5F
数据库文件名为 UserDb.bin，可掉电保存。VTc / VTb 容量固定 64K 字节。访问需经变量存储器中转。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0x56 | En_DBL_OP | R/W | 1 | 0x5A 申请操作；完成后清零 |
0x57 | OP_Mode | W | 1 | 0x50 变量→DB；0xA0 DB→变量 |
0x58–0x5B | DBL_Address | W | 4 | 数据库首字地址 |
0x5C–0x5D | VP | W | 2 | 变量空间首字地址 |
0x5E–0x5F | OP_Length | W | 2 | 操作字长度 |
变量 0x0000 起 256 字写入数据库 0x00000000：
text
A5 5A 0C 80 56 5A 50 00 00 00 00 00 00 01 00从数据库读回变量：
text
A5 5A 0C 80 56 5A A0 00 00 00 00 00 00 01 00TF 卡（FAT32）上电后可将屏内 UserDb.bin 拷到卡根目录。仅执行过写入后屏内才会生成该文件。不推荐作关键数据介质或频繁写入；连续指令请加延时。VTc / VTb 均支持本段寄存器。
系统自检 0xF3-0xF6
对应开发指南附 1。
| 地址 | 名称 | R/W | 长度 | 说明 |
|---|---|---|---|---|
0xF3–0xF6 | 系统自检 | R | 4 | 错误代码 |
启动方式：
- 读取
0xF3–0xF6：系统自动对全部文件做一次校验 - 运行中：实时检查当前用到的文件
校验出错时，错误码写入本寄存器，并可在屏幕左上角显示。是否显示由屏参 miscellaneous.4 控制（勾选则显示）。
错误代码表
(0xF3 0xF4) | (0xF5 0xF6) | 描述 |
|---|---|---|
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 | 工程校验错误（读 F3 启动自检时返回） |
0000 | 0x0011 | 串口接收到异常指令 |
0000 | 0x0012 | 控件内存使用率大于 90% |
0000 | 0x0013 | 页面异常 |
0000 | 0x0014 | TTF 矢量字库异常 |
类型码 0x000F 在开发指南错误码表中未列出。
其中 BIN_ID / WAV_ID / PIC_ID 等为出错资源编号；图标异常时 0xF3–0xF4 携带 ICON_ID 与 ICON_NUM。