修改记录 日期 初稿 增加音频播放功能 增加视频播放功能 修改内容 增加二维码显示功能 增加文本滚动显示功能 增加 ViewTech OS 编程指令 ; 2 增加 RTC 录入后

Transcription

1 VGUS 4.3 用户开发指南 适用于 SDWe 系列串口屏

2 修改记录 日期 初稿 增加音频播放功能 增加视频播放功能 修改内容 增加二维码显示功能 增加文本滚动显示功能 增加 ViewTech OS 编程指令 ; 2 增加 RTC 录入后自动上传功能 ; 3 文件夹名称为 VT_SET-REPLACE 时, 只更新同名文件, 不删除其它工程文件 ; 4 支持大图标 ( 大于 255 点阵 ) 显示 插入 USBMini 后支持串口接收指令 ; 2 增加 指令写显存功能 ; 3 上电启动亮度为屏保点亮亮度 R6, 可在工程中设置启动亮度, 修改亮度寄存器中亮度值最高位为 1 保存亮度 ; 4 数据变量录入和数据变量显示增加数据反色显示 ; 5 数据变量增加无效位补零选项 ; 6 变量数据录入增加输入长度限制 增加寄存器和变量存储器的指令操作举例 增加设置音频播放模式指令 增加寄存器 0x10-0x1D 配置寄存器映射功能 更新第 1 2 章内容 修订 节中数据变量显示格式以及 节中 R1/0x 带小数点的数据变量显示, 增加小数点宽度自动调整功能 ; 单位长度为 10 字节 更新第 4 5 章次序 增加第 7 章 VGUS4.3 开发工具使用说明 及虚拟串口屏

3 目录 1 VGUS 屏概述 产品介绍 认识组态 系统架构 存储空间 数据加密 固件更新 串口指令集 格式约定 寄存器读写指令 0X80 0X 变量存储器读写指令 0X82 0X 扩展指令 0X CRC 校验 寄存器 寄存器一览表 常用寄存器 读取版本号 修改背光亮度 控制蜂鸣器 切换图片 按键触发 时钟 RTC 触摸屏校准 语音播放 视频播放 用户数据文件 数据库读写 屏参配置读写 显示控件 显示控件介绍 数据与文本变量 数据变量 文本变量 滚动文本 图标与图片 制作 Icon 文件 变量图标... 33

4 4.2.3 动画图标 动画图片 滑动刻度 艺术字变量 旋转图标 位变量图标 图形变量 实时曲线 ( 趋势图 ) 基本图形 ( 绘图 ) 列表显示 ( 表格 ) 二维码 实时时钟 RTC 的显示 触摸控件 触摸控件介绍 基本按钮 按钮 按钮键值返回 按钮状态返回 弹出菜单 键盘录入 制作键盘 数据录入 英文 ASCII 录入 中文 GBK 录入 时钟设置 调节控件 增量调节 拖动调节 转动调节 硬件参数配置 描述指针 VGUS4.3 开发工具使用说明 操作界面 屏参配置 设计流程 工程下载 文件格式及命名规则 附 1 外接键盘转接板 KAP

5 1 VGUS 屏概述 1.1 产品介绍 256 字节寄存器空间 ; 64K 字 (128K 字节 ) 变量存储器空间 8 通道曲线存储 极快 (80ms) 的变量显示响应速度 ; 128M 字节 /1Gbit Flash 存储器空间, 可扩展到 1G 字节 ; 单页最多支持 128 个显示变量 ; 集成实时时钟 RTC 触控蜂鸣器伴音功能; 支持软件 90 度 180 度 270 度屏幕旋转, 调整合适的可视角度 ; 支持背光亮度调节 自动待机屏保功能 ; 支持外接矩阵键盘 ; 行业领先的电磁辐射指标, 助您轻松应对 ClassB; 支持 U 盘脱机批量下载, 有效提高批量下载效率 降低对操作人员专业素质要求 ; 支持 USBmini 接口在线调试下载, 有效提高研发效率 ; 支持硬件 JPG 解码, 存储更高效 显示更快速 ; 支持音频 视频播放 ; 配套提供操作简单的 VGUS4.3 组态开发工具软件 ; 文件名命名规则简单, 无需与 Flash 块编号对应, 也无需进行繁琐的手工分配 Flash 块功能 ; 支持虚拟串口屏功能, 让调试更轻松 让学习更简单! 外接键盘 USB-mini 口 外接喇叭 U 盘接口 串口及供电 图 英寸 SDWe070T05T 实物图 ( 更换图片 )

6 1.2 认识组态 图 指令集屏与组态屏的区别 表 指令集屏与组态屏的差异 控制操作 显示内容 显示格式 指令集屏不同功能使用不同的指令 不同类型的显示内容分配不同的指令 发送显示内容的指令必须包含显示格式信息 组态屏不同的功能分配不同的寄存器单元, 用户通过相同的写指令 (0x80) 更新寄存器单元内容实现 所有的显示对象 ( 变量 ) 用户自行分配不同的变量存储器单元, 用户通过相同的指令 (0x82) 更新变量单元内容, 实现显示刷新 显示格式与显示内容分开, 显示格式是在使用 VGUS4.3 开发工具设计变量时已经设计好, 连同显示界面一起预先保存在串口屏里 特点指令多 指令格式各不相同且复杂 指令少, 指令格式统一且简单 关键词指令寄存器 变量存储器 举例 : 在 1 号界面上显示浮点型变量 25.3 指令集屏实现步骤 : 图 指令集屏

7 组态屏实现步骤 : 图 组态屏 1.3 系统架构 VGUS(Viewtech GraphicalUser Software) 是武汉中显科技有限公司一款组态型 用户图形界面设计软件,VGUS 屏系统架构如图 所示 VGUS4.3 是针对 SDWe 系列串口屏开发的最新版本组态软件 图 1-3-1VGUS 屏系统架构所有用到的图片 图标 字库 音频文件需要导入到 VGUS 开发工具中, 然后在开发工具中设计显示控件 触摸按钮等, 设计完毕后生成下载文件夹 ( 视频文件需要手工拷贝到 VT-SET 文件夹下 ) 并通过 U 盘下载到串口屏里 VGUS 串口屏与用户 MCU 之前通过串口连接, 通过 0x80 和 0x81 指令实现控制 设置等相关功能, 通过 0x82 0x83 指令实现显示和触摸等相关功能 指令详细介绍见第 2 章内容 VGUS 屏开发只需要三个步骤, 便可完成复杂的人机交互设计, 如图 详细信息见第 7.3 节

8 图 VGUS 屏开发步骤 1.4 存储空间为了顺利学习 VGUS 屏的使用方法, 本节内容必须充分理解 VGUS 屏内部存储空间分为三个部分 : 寄存器区 变量存储器区和 Flash 存储器 寄存器区共 256 个单元 ( 地址 0x00~0xFF), 每个单元对应一个字节, 共 256 字节 用于硬件配置和控制操作, 典型功能如背光亮度调节 版本信息读取 发串口指令控制图片显示 音频播放控制 视频播放控制等, 完整的寄存器汇总表见第三章 用户单片机可以分别通过 0x80 0x81 指令写入和读取寄存器单元内容 寄存器详细介绍见第三章内容 变量存储器区共 64K 单元 ( 地址 0x0000~0xFFFF), 每个单元对应两个字节, 共 128K 字节 顾名思义, 变量存储器就是用来存储变量值的 用户单片机分别通过 0x82 0x83 指令写入和读取变量存储器单元内容 变量存储器详细介绍见第四章 第五章内容 Flash 存储器共 128M 字节 /1Gbit, 可以扩展到 1G 字节 系统占用 14M 字节, 用户实际可使用 Flash 存储器空间为 114M 字节 Flash 存储器主要用于存储配置文件 ( 如变量显示格式 ) 图片文件 图标文件 字库文件 音频文件 视频文件等 在界面工程设计完毕后, 以上内容通过 U 盘下载到串口屏里并永久保 存 VGUS 屏采用了 JPG 数据压缩算法和连续存储模式, 极大地提高了存储效率和存储图片的数量, 对于一般图片应用场合已经足够, 例如分辨率为 1024*768 的满幅面图片, 大约可以存储近千张 ( 实际存储张数与图片色彩有关 ) 当客户有较多的视频文件需要存储的时候, 可能就需要扩大存储空间 表 寄存器与变量存储器的区别 图 VGUS 屏存储空间 寄存器 变量存储器 容量 256 字节 64K 字 (128K 字节 )

9 地址范围 00-FF 0000-FFFF 单元大小一个单元对应一个字节一个单元对应两个字节 读写指令写 0x80/ 读 0x81 写 0x82/ 读 0x83 功能 单元功能已经定义好, 用于硬件配置和控制操作, 典型功能如背光亮度调节 版本信息读取 发串口指令控制图片切换 音频播放控制 视频播放控制等 单元功能由用户定义, 用于存储变量值 在使用 VGUS4.3 开发工具设计变量时, 用户要指定每个变量对应的存储地址 ( 定义变量存储器单元功能 ) 不同的变量分配的存储地址不能冲突 1.5 数据加密由于 VGUS 屏通过 USB-mini 接口连接到电脑后, 实际是被虚拟成硬盘, 通过电脑可以直接拷贝 VGUS 屏内部数据 因此, 当用户设计完成以后, 必须对 VGUS 屏内的数据进行加密保护, 防止拷贝抄袭 用户首先自行制作一个加密文件 password.txt, 该文件包含一个不超过 128 字节的任意中英文字符串作为密码, 用户需要牢记该密码 ; 然后将密码文件 password.txt 复制到 U 盘根目录下, 当将 U 盘插到 VGUS 屏上后, 密码将自动拷贝到 VGUS 屏里, 实现对 VGUS 屏内部数据的加密保护 VGUS 屏一旦加密后,VGUS 屏内部数据无法读出,USB-mini 口无法再连接电脑 解密过程与加密相似, 首先是将解密文件 de_password.txt ( 密码必须与加密文件 password.txt 相同 ) 复制到 U 盘根目录下, 当将 U 盘插到 VGUS 屏上后, 系统将自动对解密密码进行核对, 如果与加密密码一致, VGUS 屏将自动解密 解密后,VGUS 屏可以重新通过 USB-mini 接口连接到电脑 加密文件 password.txt 与解密文件 de_password.txt 内的密码相同, 仅仅是文件名不同 密码是一个不超过 128 字节的任意中英文字符串, 必须妥善保存, 密码一旦遗失, 将无法再次解密 1.6 固件更新在固件更新过程中, 请保证供电稳定! 在固件更新过程中, 显示屏会有多次自动重新启动, 期间切不可断电! 1. 将固件程序 VGUS-PlusII.bin 文件复制到 U 盘根目录下 ; 2. 将 U 盘插入串口屏, 保证供电稳定, 系统自动开始更新固件 ; 3. 在出现 Please plug out the U disk. 提示信息后 ( 蜂鸣器也会有提示音发出 ), 请拔出 U 盘 4. 在出现 Update success. 提示信息后, 固件更新已经完成, 停留 3 秒后自动重启进入工作状态

10 2 串口指令集 VGUS 屏采用变量驱动模式工作, 屏的工作模式和 GUI 状态完全由变量和寄存器来控制 相应的, 串口指令也只需要对变量和寄存器进行读 写即可, 一共 6 条指令 VGUS 屏采用异步 全双工串口 (UART), 每字节数据传送采用 10 个位 :1 位起始位 8 位数据位 1 位停止位, 无校验位 串口波特率可通过 VGUS 4.3 开发工具中 屏参配置 设置 2.1 格式约定 数据格式 VGUS 屏支持整数 ( 双字节 ) 无符号整数( 双字节 ) 长整数(4 字节 ) 超长整数(8 字节 ) 等数据格式, 其数值范围如表 2-1 所示 表 2-1 数值范围 数据格式 最小值 最大值 整数 ( 双字节 ) (0x8000) (0x7FFF) 无符号整数 ( 双字节 ) 0(0x0000) 65535(0xFFFF) 长整数 (4 字节 ) (0x ) (0x7FFFFFFF) 超长整数 (8 字节 ) 小数采用定点小数表示, 用户自定义小数位数, 比如 0x4D2(1234), 规定小数为 2 位时, 表示 色彩定义 VGUS 屏所有颜色数据均为 16 位, 两个字节, 如表 1-1 所示, 其格式为 Red5-Green6-Blue5, 即红色 占高 5 位, 绿色占中间 6 位, 蓝色占低 5 位 可以显示的颜色为 2 16 色, 即 色 表 2-2 色彩定义 D15 D14 D13 D12 D11 D10 D9 D8 D7 D6 D5 D4 D3 D2 D1 D0 R4 R3 R2 R1 R0 G5 G4 G3 G2 G1 G0 B4 B3 B2 B1 B0 红色 绿色 蓝色 例 : 红色 :0xF800, 绿色 :0x07E0, 蓝色 :0x001F, 白色 :0xFFFF, 黑色 :0x0000 指令帧结构 所有的串口指令或者数据采用 16 进制 (HEX) 格式 对于双字节数据采用高字节先传送 (MSB) 的方 式 例如 0x1234 发送时先发送 0x12, 再发送 0x34 表 2-3 指令帧结构 指令帧头 指令长度 指令 起始地址 [ 数据长度 ] [ 数据内容 ] [CRC 校验码 ] 每条指令都包括有指令帧头 指令长度 指令 起始地址四个部分 [ 数据长度 ] [ 数据内容 ] [CRC 校验码 ] 这三个参数不是每条指令都有 指令帧头为双字节, 其内容用户可以自定义 ( 寄存器 R3 RA), 通过 VGUS 4.3 开发工具中 屏参配置 设置 用户可以通过设定不同的帧头, 实现多台 VGUS 屏的并联应用

11 指令长度为单字节, 包括指令及后面所有的内容 指令为单字节, 包括两条寄存器读写指令 (0x80 0x81) 两条变量存储器读写指令 (0x82 0x83) 一条写曲线缓冲区指令 0x84 一条扩展功能指令 0x 寄存器读写指令 0x80 0x81 VGUS 屏有 256Byte 的寄存器, 主要用于相关硬件控制操作, 按照字节 (Byte) 寻址 起始地址对于寄存器读写指令 (0x80 0x81) 是单字节, 地址范围为 0x00~0xff 数据长度 (N) 以字节为单位, 表示连续读寄存器单元个数 支持顺序读写多个寄存器 表 2-4 串口发送 0x80 指令帧结构 ( 写寄存器 ) 定义 指令帧头 指令长度 指令 起始地址 数据内容 长度 ( 字节 ) 2 1 1(0x80) 1 N 举例 : 寄存器 0x03 和 0x04 单元连续写入 0x00 0x01 发送 :0xA5 0x5A 0x04 0x80 0x03 0x00 0x01 表 2-5 串口发送 0x81 指令帧结构 ( 读寄存器发送 ) 定义 指令帧头 指令长度 指令 起始地址 数据长度 长度 ( 字节 ) 2 1 1(0x81) 1 1(N) 表 2-6 串口接收 0x81 指令帧结构 ( 读寄存器接收, 串口屏发送的 ) 定义 指令帧头 指令长度 指令 起始地址 数据长度 数据内容 长度 ( 字节 ) 2 1 1(0x81) 1 1(N) N 举例 : 连续读取寄存器寄存器 0x03 和 0x04 单元 发送 :0xA5 0x5A 0x03 0x81 0x03 0x02 返回 :0xA5 0x5A 0x05 0x81 0x03 0x02 0x00 0x01 表 2-7 寄存器读写指令详解 功能指令数据说明 0x80 下发 : 寄存器地址 (0x00-0xFF)+ 写入数据指定地址写寄存器数据 访问 寄存器 接口 0x81 下发 : 寄存器地址 (0x00-0xFF)+ 读取字节长度 (0x00-0xFF) 应答 : 寄存器地址 (0x00-0xFF)+ 字节数据长度 + 读取的寄存器数据 指定地址开始读指定字节长度的寄存器数据 读寄存器的 VGUS 屏应答 VGUS 屏有 256Byte 的寄存器, 主要用于相关硬件控制操作, 按照字节 (Byte) 寻址

12 2.3 变量存储器读写指令 0x82 0x83 VGUS 屏有 64K word(128k Byte) 的变量存储器, 按照字 (word) 寻址操作, 地址为 0x0000-0xFFFF 用户在规划变量时, 要根据变量长度手工分配变量存储器地址 起始地址对于变量存储器读写指令 (0x82 0x83) 是双字节, 地址范围为 0x0000~0xffff 数据长度 (N) 以字 ( 双字节 ) 为单位, 表示连续读变量存储器单元个数 数据内容是 2N 字节, 因为每个变量存储单元包含 2 个字节 支持顺序读写多个变量存储器单元 表 2-8 串口发送 0x82 指令帧结构 ( 写变量存储器单元 ) 定义 指令帧头 指令长度 指令 起始地址 数据内容 长度 ( 字节 ) 2 1 1(0x82) 2 2N 举例 : 变量存储器 0x0003 单元写入 0x00 0x01 发送 :0xA5 0x5A 0x05 0x82 0x00 0x03 0x00 0x01 表 2-9 串口发送 0x83 指令帧结构 ( 读变量存储器发送 ) 定义 指令帧头 指令长度 指令 起始地址 数据长度 长度 ( 字节 ) 2 1 1(0x83) 2 1(N) 表 2-10 串口接收 0x83 指令帧结构 ( 读变量存储器接收, 串口屏发送的 ) 定义 指令帧头 指令长度 指令 起始地址 数据长度 数据内容 长度 ( 字节 ) 2 1 1(0x83) 2 1(N) 2N 举例 : 连续读取变量存储器 0x0003 和 0x0004 单元 发送 :0xA5 0x5A 0x04 0x83 0x00 0x03 0x02 返回 :0xA5 0x5A 0x08 0x83 0x00 0x03 0x02 0x00 0x01 0xff 0xff 表 2-11 变量存储器读写指令详解 功能指令数据说明 0x82 下发 : 变量地址 (0x0000-0xFFFF)+ 写入的变量数据 指定变量地址开始写入数据 ( 字数据 ) 到变量存储区 访问 变量 存储器 0x83 下发 : 变量地址 (0x0000-0xFFFF)+ 读取变量数据字长度 (0x00-0x7F) 应答 : 变量存储器地址 + 变量数据长度 + 读取的变量数据 从变量存储区指定地址开始读入指定字长度的数据 读数据存储器的 VGUS 应答 接口 VGUS 屏采用变量驱动方式, 将变量数值和变量显示格式分开 变量显示格式是预先通过配置文件形式下载在 显示终端里 而变量数值是通过串口实时传送给显示终端的, 变量存储器就是用来存储接收到的变量数值 VGUS 屏有 64K word(128k Byte) 的变量存储器, 按照字 (word) 寻址操作, 地址为 0x0000-0xFFFF 用户在 规划变量时, 要根据变量长度手工分配变量存储器地址

13 2.4 扩展指令 0x85 表 2-12 直接写显存 0x85 00 定义 长度 ( 字节 ) 指令 指令 帧头 长度 2 1 指令数据说明 X(2byte)+Y(2byte) 2 X 为起始位置的 X 坐标,Y 为起始位置的 Y 坐标 ; +DATA0(2byte)+ (85 00) DATA 为像素点颜色值, 双字节 写入数据超过一行时自动换行 +DATAn(2byte) 表 2-13 串口下载指定文件 0x85 01 定义 长度 ( 字节 ) 指令 指令 指令 数据 说明 帧头 长度 2 1 5a a5 + filesize 文件大小, 单位字节 ; 2 filesize(4bytes)+ filename 下载文件的文件名, 完整的文件名, 含扩展名, (85 01) filename(ascii) 如文件名为 1.jpg, 发送的 ASCII 码应为 31 2e 6a Please Tx file! 串口屏正确收到 指令后, 返回提示信息 ( 无帧头 ) file 单片机收到返回提示后, 可以开始发送文件 ( 无帧头 ) One file Saved OK! 串口屏完整收到文件并保存完成后, 返回提示信息 ( 无帧头 ) 0x a a5 指令下载指定文件, 可以通过串口下载各种文件到串口屏里, 包括图片 字库 语音 视频等各种文件 如果客户主板可以连接网络, 可以用该功能实现远程更新部分显示内容 串口屏固件不能通过该指令实现升级 连接 USB 线时用串口下载文件会导致文件出错 表 2-14 连续播放音频文件 0x85 03 指令指令定义指令数据说明帧头长度 Mode(1byte)+ Mode 定义播放模式 :0 循环播放,1 顺序播放, 其他停止播放 ; 长度 NUM0(2byte)+ NUM 指定音频文件名编号 ( 双字节, 取值范围 0x0000-0xFFFE), ( 字节 ) (85 03) +NUMn(2byte) 如果设为不存在的音频文件名将直接跳过 为提高播放效果, 指令中的音频文件格式必须一致, 如同为 WAV 或者 MP3 格式 WAV 格式必须用 22KHz 双声道数据, 指令中音频文件总大小不得大于 2M MP3 格式音频文件总大小没有限制 0x85 03 指令连续播放指定的多个语音文件 该指令可用于实现窗口 / 柜台的数字播报 ( 音频文件必须用 WAV 格式 ), 也可以用于娱乐应用 ( 音频文件必须用 MP3 格式 )

14 2.5 CRC 校验用户可以自定义是否启用 CRC 检验, 通过 VGUS 4.3 开发工具中 屏参配置 设置 启用 CRC 校验后, 所有指令尾部将增加一个双字节的 CRC 校验码 CRC 校验不包括指令帧头和指令长度, 采用 ANSI-16(X16+X15+X2+1) 格式 举例 : 带 CRC 校验方式将寄存器 0x03 和 0x04 单元连续写入 0x00 0x01 发送 :0xA5 0x5A 0x06 0x80 0x03 0x00 0x01 0x18 0x24 定义 帧头 指令长度 指令 起始地址 数据内容 CRC 校验码 举例 0xA5,0x5A 0x06 0x80 0x03 0x00,0x01 0x18,0x24 当同时启用 CRC 校验和 CRC 校验结果应答后 ( 通过 VGUS 4.3 开发工具中 屏参配置 设置 ),VGUS 屏会在 CRC 校验后自动通过串口外发校验结果 CRC 检验结果应答帧结构如表 2-2 所示 表 2-16 CRC 校验结果应答帧结构 定义 帧头 数据长度 指令 数据 CRC 校验码 长度 ( 字节 ) 说明用户自定义固定为 0x02 接收到的指令 0xff 表示 CRC 校验正确 0x00 表示 CRC 校验错误 举例 0xA5,0x5A 0x02 0x81 0xff 0x21,0xA0 CRC 校验程序 uint8_t uchcrchi; uint8_t uchcrclo; //CRC 高字节 //CRC 低字节 static uint8_t auchcrchi[] = { /* CRC 高位字节值表 */ 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0,0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1,0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1,0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1,0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0,0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1,0x81, 0x40, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41, 0x01, 0xC0,0x80, 0x41, 0x00, 0xC1, 0x81, 0x40} ; static uint8_t auchcrclo[] = { /* CRC 低位字节值表 */ 0x00, 0xC0, 0xC1, 0x01, 0xC3, 0x03, 0x02, 0xC2, 0xC6, 0x06,0x07, 0xC7, 0x05, 0xC5, 0xC4, 0x04, 0xCC, 0x0C, 0x0D, 0xCD,

15 0x0F, 0xCF, 0xCE, 0x0E, 0x0A, 0xCA, 0xCB, 0x0B, 0xC9, 0x09,0x08, 0xC8, 0xD8, 0x18, 0x19, 0xD9, 0x1B, 0xDB, 0xDA, 0x1A, 0x1E, 0xDE, 0xDF, 0x1F, 0xDD, 0x1D, 0x1C, 0xDC, 0x14, 0xD4,0xD5, 0x15, 0xD7, 0x17, 0x16, 0xD6, 0xD2, 0x12, 0x13, 0xD3, 0x11, 0xD1, 0xD0, 0x10, 0xF0, 0x30, 0x31, 0xF1, 0x33, 0xF3,0xF2, 0x32, 0x36, 0xF6, 0xF7, 0x37, 0xF5, 0x35, 0x34, 0xF4, 0x3C, 0xFC, 0xFD, 0x3D, 0xFF, 0x3F, 0x3E, 0xFE, 0xFA, 0x3A,0x3B, 0xFB, 0x39, 0xF9, 0xF8, 0x38, 0x28, 0xE8, 0xE9, 0x29, 0xEB, 0x2B, 0x2A, 0xEA, 0xEE, 0x2E, 0x2F, 0xEF, 0x2D, 0xED,0xEC, 0x2C, 0xE4, 0x24, 0x25, 0xE5, 0x27, 0xE7, 0xE6, 0x26, 0x22, 0xE2, 0xE3, 0x23, 0xE1, 0x21, 0x20, 0xE0, 0xA0, 0x60,0x61, 0xA1, 0x63, 0xA3, 0xA2, 0x62, 0x66, 0xA6, 0xA7, 0x67, 0xA5, 0x65, 0x64, 0xA4, 0x6C, 0xAC, 0xAD, 0x6D, 0xAF, 0x6F,0x6E, 0xAE, 0xAA, 0x6A, 0x6B, 0xAB, 0x69, 0xA9, 0xA8, 0x68, 0x78, 0xB8, 0xB9, 0x79, 0xBB, 0x7B, 0x7A, 0xBA, 0xBE, 0x7E,0x7F, 0xBF, 0x7D, 0xBD, 0xBC, 0x7C, 0xB4, 0x74, 0x75, 0xB5, 0x77, 0xB7, 0xB6, 0x76, 0x72, 0xB2, 0xB3, 0x73, 0xB1, 0x71,0x70, 0xB0, 0x50, 0x90, 0x91, 0x51, 0x93, 0x53, 0x52, 0x92, 0x96, 0x56, 0x57, 0x97, 0x55, 0x95, 0x94, 0x54, 0x9C, 0x5C,0x5D, 0x9D, 0x5F, 0x9F, 0x9E, 0x5E, 0x5A, 0x9A, 0x9B, 0x5B, 0x99, 0x59, 0x58, 0x98, 0x88, 0x48, 0x49, 0x89, 0x4B, 0x8B,0x8A, 0x4A, 0x4E, 0x8E, 0x8F, 0x4F, 0x8D, 0x4D, 0x4C, 0x8C, 0x44, 0x84, 0x85, 0x45, 0x87, 0x47, 0x46, 0x86, 0x82, 0x42,0x43, 0x83, 0x41, 0x81, 0x80, 0x40} ; uint16_t CRC16(uint8_t * pmsg, uint16_t Len) { uint8_t i; uchcrchi = 0xFF; uchcrclo = 0xFF; while (Len--) {i = uchcrchi ^ (*pmsg++); uchcrchi = uchcrclo ^ auchcrchi[i]; uchcrclo = auchcrclo[i]; } return (uchcrchi << 8 uchcrclo); }

16 3 寄存器 VGUS 屏内部都设计有 256 字节的寄存器, 用于实现硬件相关操作, 如背光调整 时钟读写 语音播放等 3.1 寄存器一览表表 3-1 寄存器一览表 寄存器 地址 定义 R/W 字节 长度 说明 0x00 Version R 1 VGUS 版本号,BCD 码表示,0x40 表示 V4.0 0x01 LED_NOW R/W 1 LED 亮度控制寄存器,0x00-0x40 0x02 BZ_TIME W 1 蜂鸣器鸣叫控制寄存器, 单位 10ms 0x03-0x04 PIC_ID R/W 2 读 : 当前显示页面 ID; 写 : 切换到指定页面 0x05 TP_Flag R/W 1 0x5A 表示触摸屏坐标有更新 ; 其他表示触摸屏坐标未更新 0x06 TP_Status R 1 0x01 表示第一次按下 ;0x03 表示一直按下中 ;0x02 表示抬起 ; 其他表示无效 0x07-0x0A TP_Position R 4 触摸屏按压坐标位置 X_H:L Y_H:L 0x0B TPC_Enable R/W 1 0x00 表示触控不启用 ; 其他表示触控启用 ( 上电默认 0xFF) 0x0C-0x0F RUN_TIME R 4 上电后运行时间,BCD 码时分秒, 其中小时为两个字节, 最大 9999:59:59 0x10-0x1C R0-RC R/W 13 屏参配置寄存器映射, 当 1D 寄存器配置时,11-1C 寄存器可改写 R1-RC 的数据 0x1D CONFIG_EN W 1 写入 0x5A,R1-RC 重新设置并保存 ; 写入 0xA5, 只重新设置, 不保存 0x1F-0x26 RTC_COM_ADJ W 1 0x5A 表示用户串口申请改写 RTC 数据,VGUS 修改 RTC 后清零 RTC_NOW R/W 7 YY:MM:DD:WW:HH:MM:SS, 年 : 月 : 日 : 星期 : 时 : 分 : 秒, 格式为 BCD 码 0x27-0X3F 保留 16 未定义 En_Lib_OP R/W 1 0x5A 表示申请用户数据文件加载到变量空间,VGUS 操作完后清零 每个 VGUS 周期执行一次读操作 Lib_OP_Mode W 1 固定为 0xA0 0x40-0x49 Lib_ID W 1 指定用户数据文件名 0x00-0xff Lib_Address W 3 指定数据操作首 ( 字 ) 地址,0x00:00:00-0x01:FF:FF VP W 2 指定变量空间的数据操作 ( 首 ) 地址 0x0000-0xFFFF OP_Length W 2 操作的 ( 字 ) 数据长度,0x0001-0xFFFF 0x4A-0x4b Timer0 R/W 2 16bit 软件定时器, 单位 4ms, 自减到零停止 设置值和实际运行值之间 0x4C Timer1 R/W 1 8bit 软件定时器, 单位 4ms, 自减到零停止 0x4D Timer2 R/W 1 8bit 软件定时器, 单位 4ms, 自减到零停止 0x4E Timer3 R/W 1 8bit 软件定时器, 单位 4ms, 自减到零停止 有 +/-4ms 误差, 比如设置 位 2, 实际运行值在 4-12ms 之间 0x4F Key_code W 1 用户键码, 用于触发配置文件,0x01-0xFF,0x00 表示无效 VGUS 处理键码后会自动清零键码寄存器

17 0x50-0x52 Music_Set W 1 0x5b: 播放语音 0x5c: 停止播放 Music_Num W 2 音频播放设定值 (0-4095) 0x53-0x54 Vol_Adj_En W 1 0x5A 表示申请调整播放音乐的音量 Vol W 1 音量值, 范围 0x00-0x40, 上电默认值是 0x40 0x55 Vol_Status R 1 音频播放状态 0x00: 播放停止 ;0x01: 播放中 0x56-0x5F En_DBL_OP R/W 1 OP_Mode W 1 DBL_Address W 4 0x5A 表示用户申请进行数据库操作,VGUS 操作完后清零每个 VGUS 周期执行一次数据库读或写操作 0x50 表示把变量存储器空间数据写入数据库空间 0xA0 表示把数据库空间的数据读入变量存储器空间数据库首 ( 字 ) 地址 ( 数据库和用户的 VT_SET 文件夹均存放在 VGUS_USER 盘符下 ) VP W 2 变量空间的首 ( 字 ) 地址,0x0000-0xFFFF OP_Length W 2 数据库操作的 ( 字 ) 长度,0x0001-0xFFFF Play_Avi_Set R/W 1 0x5a: 申请播放 avi 视频,VGUS 播放完后清零 0x00: 单曲播放 VGUS 屏内视屏 ( 默认模式 ) 0x01: 单曲循环播放 VGUS 屏内视屏 0x02: 顺序循环播放 VGUS 屏内视屏 0x03: 单曲播放 U 盘内视频 Avi_Type W 1 0x04: 单曲循环播放 U 盘内视频 0x60-0x67 0x05: 顺序循环播放 U 盘内视频 注 : 视频文件扩展名必须是 *.avi; Play_Positio n W 4 单曲播放时文件名必须为阿拉伯数字, 如 123.avi ; 顺序播放时文件名可以为字母 + 数字, 如 wuhan123.avi 视频窗口左上角坐标位置 (X_H,X_L,Y_H,Y_L) 注 :(0,0) 表示居中显示 Play_Avi_Num W 2 通过视频文件名选择播放视频曲目, 最多允许 个视频 ; 仅用于单曲播放, 顺序播放时无效 0x68-0x69 Vol_Adj_En W 1 0x5A 表示申请调整播放视频音量 Vol W 1 播放视频音量值, 范围 0x00-0x3F, 上电默认值是 0x3F 0x6a Play_Control W 1 0x6b Play_Stop W 1 0x5A: 播放 / 暂停对于单曲播放方式, 当播放完当前视频后, 系统自动跳回到当前图片界面 0x5A: 停止执行停止播放视频后, 系统自动跳回到当前图片界面, 也可以按照按钮跳转 0x6c Play_Next W 1 0x5a: 播放下一首 (VGUS 处理后清零, 单曲播放时结束 ) 0x6d Play-Prev W 1 0x5A: 播放前一首 0x6e Play_Status R 1 0x00= 空闲 ; 0x01= 播放中 ; 0x02= 暂停

18 0x6f-0xE8 保留 122 未定义 0xE9 Scan_Status R/W 1 读 :0x00 表示触摸屏未处于录入状态 0x01 表示触摸屏录入状态 ; 写 : 如果触摸屏在录入状态下写 0x00, 强制退出录入状态 0xEA TPCal_Triger W 1 写入 0x5A 启动一次触摸屏校准, 校准完成后会被 VGUS 清零 0xEB Trendline _Clear W 1 0x55 表示清除全部 8 条曲线缓冲区数据 ; 0x56-0x5D 表示分别清除 CH0-CH7 通道的曲线缓冲区数据 曲线缓冲区数据清除后, 本寄存器会被 VGUS 清零 0xEC-0xED 保留 2 保留 0xEE-0xEF Reset_Triger W 2 写入 0x5AA5 导致 VGUS 屏软件复位一次 0xF0-0xFF 保留 16 保留 3.2 常用寄存器 读取版本号 寄存器 地址 定义 R/W 字节 长度 说明 0x00 Version R 1 VGUS 版本号,BCD 码表示,0x43 表示 V4.3 读取版本信息, 串口下发指令 A5 5A 返回 A5 5A 说明 :A5 5A: 帧头 04: 指令的字节长度, 共 4 字节 ( 不含帧头 ) 81: 读寄存器指令 00: 寄存器地址 01: 返回数据的字节长度,43 为 1 字节 43: 返回的数据信息 修改背光亮度 寄存器 地址 定义 R/W 字节 长度 说明 0x01 LED_NOW R/W 1 LED 亮度控制寄存器,0x00-0x40 例如, 关闭背光 A5 5A 建议 :1 设备对功耗要求较高时, 可以通过修改屏的背光亮度达到降低功耗的目的 ; 2 如有需要单片机控制达到屏保效果的情况, 可用该指令控制背光亮灭从而达到屏保的效果 ; 3 开机亮度以及屏保功能可以通过屏参配置设置 控制蜂鸣器 寄存器 地址 定义 R/W 字节 长度 说明 0x02 BZ_TIME W 1 蜂鸣器鸣叫控制寄存器, 单位 10ms 例如, 控制蜂鸣器鸣叫 2s, 发送指令 A5 5A C 切换图片

19 寄存器 地址 定义 R/W 字节 长度 说明 0x03-0x04 PIC_ID R/W 2 读 : 当前显示页面 ID; 写 : 切换到指定页面例如, 切换到 2 号界面的指令 A5 5A 按键触发用户键码, 使用用户主板上的键盘来触发显示页面上的按钮 ( 详见第 5 章 ), 有 0x4F Key_code W 1 效键码范围 0x01-0xFF,0x00 表示无效 4F 寄存器可以与串口屏外接键盘 触 摸屏同时使用 VGUS 处理键码后会自动清零键码寄存器 例如, 画面上有个按钮的键码属性设置为 01, 当用单片机口发送指令 A5 5A F 01 后, 串口屏会响应该按钮的操作, 执行该按钮被按下的所有操作 时钟 RTC 表 3-2 时钟读写寄存器 寄存器 地址 定义 R/W 字节 长度 说明 0x1F-0x26 RTC_COM_ADJ W 1 0x5A 表示用户串口申请改写 RTC 数据,VGUS 修改 RTC 后清零 RTC_NOW R/W 7 YY:MM:DD:WW:HH:MM:SS, 年 : 月 : 日 : 星期 : 时 : 分 : 秒, 格式为 BCD 码 串口读取时钟 RTC 0x20 寄存器开始保存了当前 RTC 值, 使用 0x81 指令读取 读取日历 (YY:MM:DD:WW:HH:MM:SS): A5 5A 读取时间 (HH:MM:SS): A5 5A 时间显示需要使用文本时钟或者表盘时钟控件, 详见本文 4.4 节 串口修改 ( 写 / 设置 ) 时钟 RTC 用 0x80 指令改写 0x1F 寄存器为 0x5A, 并给 0x20 开始的寄存器写入需要修订的时间, 即改写了 RTC 例如把 RTC 设置为 星期一 18:56:00, 串口发送以下指令 : A5 5A 0A 80 1F 5A VGUS 屏会自动换算星期, 改写时间时星期可以写任意值 触摸屏校准所有 VGUS 屏出厂前均已经校准, 用户使用前无需逐个再次校准 VGUS 屏提供了两种启动触摸屏校准方法, 分别适用于不同应用场合 方法 1 产品集成用户 MCU 通过串口向 VGUS 屏 0xEA 寄存器写入 0x5A 将启动一次触摸屏校准 通过该方法, 可以将触摸屏校准功能作为最终设备的一个选项功能, 提供给设备操作人员 该方法适用于用户 MCU 发串口指令使用 表 3-7 触摸屏校准寄存器 寄存器 地址 定义 R/W 字节 长度 说明

20 0xEA TPCal_Triger W 1 写入 0x5A 启动一次触摸屏校准, 校准完成后会被 VGUS 清零触摸屏校准发送指令 A5 5A EA 5A 方法 2 批量生产在 VGUS 4.3 开发工具 屏参配置 中, 勾选 U 盘下载配置文件后启动触摸校准, 则在每次下载配置文件完毕后,VGUS 屏将立即自动启动一次触摸屏校准 如果客户希望在生产环节, 每块屏都再次校准一次, 可以使用该方法, 该方法适用于批量生产阶段使用 所有 VGUS 屏出厂都已经进行校准, 不建议客户再次校准 无论使用上述哪种方法, 一旦触摸屏校准启动后, 需要按照屏幕提示操作, 依次点击屏幕 左上角 左下角 右下角 右上角 和 中心点 十字交叉点提示的触摸位置 ; 当校准完成时, 显示终端会自动进入触摸测试状态, 点击触摸屏可观察触摸位置准确度 3.3 语音播放 音频文件格式 VGUS4.3 支持 WAV 和 MP3 两种音频文件格式, 扩展名分别为 *.wav 或 *.mp3 WAV 格式占用空间大, 语音立即输出无延迟, 适合按键伴音 数字播报等较短时间播放场合 WAV 格式文件必须选用 22KHz 双声道数据 MP3 格式占用空间小, 语音输出稍有延迟 (0.5 秒 ), 适合开机音乐 背景音乐 语音提示等较长时间播放场合 音频文件播放用户通过 VGUS 组态软件将语音文件添加到工程中, 再通过 0x80 指令写相关寄存器控制语音播放和进行音量调节 表 3-3 语音播放寄存器 寄存器 地址 定义 R/W 字节 长度 说明 0x50-0x52 Music_Set W 1 0x5b: 播放语音 0x5c: 停止播放 Music_Num W 2 音乐播放设定值 (0-4095) 0x53-0x54 Vol_Adj_En W 1 0x5A 表示申请调整播放音乐的音量 Vol W 1 音量值, 范围 0x00-0x40, 上电默认值是 0x40 0x55 Vol_Status R 1 音频播放状态 0x00: 播放停止 ;0x01: 播放中举例, 一段语音 ( 比如 欢迎光临武汉中显 ) 保存为 6.wav, 要以 100% 音量播放, 串口下发 : A5 5A b A 40 要停止语音播放, 串口下发 : A5 5A c 此外, 扩展指令 0x85 03 提供连续播放音频功能, 详细参见 2.4 节内容 3.4 视频播放 SDWe 系列产品在不增加硬件成本, 创新实现了串口屏播放视频的设计, 满足开机动画 广告视频 娱

21 乐视频 设备维护视频等场合对播放视频功能的需求 1. 开机动画 : 是展现设备档次 企业形象的有力手段 目前同行产品都是通过连续显示图片来实现动画, 一方面因为受到存储图片张数限制, 播放时长都很有限, 同时也不可能实现声音的同步播放 2. 广告视频 : 如零售设备 自助售卖设备, 在设备工作间隙可以兼备播放广告视频 3. 娱乐视频 : 如健身器材 美容设备 医疗器械等, 在设备工作同时可以播放娱乐影像视频 4. 设备维护视频 : 如设备的日常保养 常见故障处理等, 可以将视频嵌入到设备中, 有力提高日常售后服务效率 降低售后服务成本 视频文件格式视频文件的扩展名为 *.avi, 允许最多 个视频文件 视频文件在使用前要先按照 avi 文件格式要求, 采用 格式工厂 软件设置格式, 如下图 分辨率可小于或等于屏幕分辨率, 视频编码为 mjpeg 格式, 音频编码 mp3( 采样频率 16kHz) 图 3-1 音视频文件格式编辑软件 格式工厂 如果要将视频文件保存到串口屏中, 需要先手工将视频文件复制到 VT-SET 文件下, 视频文件会随 VT-SET 文件夹一起下载到串口屏里 如果直接播放 U 盘中的视频文件, 则需要将视频文件直接保存在 U 盘根目录下 此外, 直接播放 U 盘中的视频文件时, 要求视频文件比特率不得大于 4096KB/ 秒, 否则会受 USB 传输速度限制而有卡顿现象 视频文件播放表 3-4 视频播放寄存器 寄存器 地址 定义 R/W 字节 长度 说明

22 Play_Avi_Set R/W 1 0x5A: 申请设置播放器参数 0x00: 单曲播放 VGUS 屏内视屏 ( 默认模式 ) 0x01: 单曲循环播放 VGUS 屏内视屏 0x02: 顺序循环播放 VGUS 屏内视屏 0x03: 单曲播放 U 盘内视频 Avi_Type W 1 0x04: 单曲循环播放 U 盘内视频 0x60-0x67 0x05: 顺序循环播放 U 盘内视频 注 : 视频文件扩展名必须是 *.avi; 单曲播放时文件名必须为阿拉伯数字, 如 123.avi ; 顺序播放时文件名可以为字母 + 数字, 如 wuhan123.avi Play_Position W 4 Play_Avi_Num W 2 视频窗口左上角坐标位置 (XH,XL,YH,YL) 注 :(0,0,0,0) 表示居中显示 通过视频文件名选择播放视频曲目, 最多允许 个视频 ; 仅用于单曲播放, 顺序播放时无效 0x68-0x69 Vol_Adj_En W 1 0x5A: 申请调整播放视频音量 Vol W 1 播放视频音量值, 范围 0x00-0x3F, 上电默认值是 0x3F 0x6a Play_Control W 1 0x6b Play_Stop W 1 0x5A: 播放 / 暂停对于单曲播放方式, 当播放完当前视频后, 系统自动跳回到当前图片界面 0x5A: 停止执行停止播放视频后, 系统自动跳回到当前图片界面, 也可以按照按钮跳转 0x6c Play_Next W 1 0x5A: 播放下一首 0x6d Play-Prev W 1 0x5A: 播放前一首 0x6e Play_Status R 1 0x00= 空闲 ; 0x01= 播放中 ; 0x02= 暂停 小技巧 : 用户寄存器 0x61-0x6e 映射于用户变量存储器 0xff01-0xff0e, 即操作用户变量存储器 0xff01-0xff0e 可实现相同的功能 ( 主要是用来触控实现播放 avi 视频, 无须用户 MCU 指令干预 ) 可以通过用户指令控制和触控两种方式, 来控制视频播放 方式一 : 用户指令控制方式 用户 MCU 通过 0x80 指令写寄存器 0x60-0x6d, 实现 avi 视频的播放 暂停 继续 停止等功能 方式二 : 触控方式 在播放器界面, 用户制作播放 / 暂停 停止 下一曲 音量调节等按钮, 通过 按钮键值返回 功能修改变量存储器 0xff01-0xff0e, 实现无需用户 MCU 干预下播放 avi 视屏 ; 小技巧 : 实现开机默认播放开机动画 通过 VGUS4.3 组态软件将 0xff0a 单元初值设置为 0x5a, 将开机动画视频文件名设置为 0.avi, 串口屏上电后将自动播放开机动画 0.avi 具体方法为设置一个数据变量, 地址设为 0xff0a, 初始值设为 90 举例, 在显示屏 (10,10) 位置单曲播放 U 盘内 01 号视频 :

23 首先修改播放参数 A5 5A 0A A A 00 0A 00 01, 然后发送播发视频指令 A5 5A A 5A 播放视频功能时显示屏上变量不再刷新 上一节中语音播放不可用 3.5 用户数据文件用户数据文件必须命名为 *.bin, 文件名编号为 0-255( 文件名不可以使用 22 和 23, 系统占用 ) 通过 U 盘导入用户数据文件用户数据文件 *.bin 必须手动复制到 VT_SET 文件夹下 通过 U 盘下载工程文件时, 用户数据文件会自动导入到串口屏里 通过串口读取用户数据文件通过寄存器 0x40-0x49, 可以将用户数据文件里面指定位置数据读出加载到变量存储器里面, 如表 3-5 所示 如果用户单片机需要使用, 可以使用 0x83 指令再从变量存储器中读取 表 3-5 用户数据文件加载到变量空间寄存器 寄存器 地址 定义 R/W 字节 长度 说明 En_Lib_OP R/W 1 0x5A 表示申请用户数据文件加载到变量空间,VGUS 操作完后清零 每个 VGUS 周期执行一次读操作 Lib_OP_Mode W 1 固定为 0xA0 0x40-0x49 Lib_ID W 1 指定用户数据文件名编号 0x00-0xff Lib_Address W 3 指定数据操作首 ( 字 ) 地址,0x00:00:00-0x01:FF:FF VP W 2 指定变量空间的数据操作 ( 首 ) 地址 0x0000-0xFFFF OP_Length W 2 操作的 ( 字 ) 数据长度,0x0001-0xFFFF 例如从 80.bin 用户数据文件的 0x 地址开始读取 4KW(0x10 00) 数据到变量存储器 0x1000 单元开始的位置, 串口下发指令 : A5 5A 0C A A 读取用户数据文件大约需要花费十毫秒级时间, 用户单片机发送连续指令时需要注意插入延时

24 3.6 数据库读写用户数据库的文件名为 UserDb.bin, 且具有掉电存储用户数据的功能 UserDb.bin 和 VT_SET 文件夹一样, 也存放在 VGUS_USER 盘符下 允许数据库文件的大小与用户工程文件有关, 可查看 VGUS_USER 的剩余空间, 确定可用数据库文件的大小 通过串口读写数据库用户单片机使用串口访问数据库, 需要通过变量存储器实现 通过寄存器 0x56-0x5F, 可以将变量存储器指定位置的数据写入保存到 FLASH 里面, 也可以将 FLASH 里面的指定位置数据读出加载到变量存储器里, 如表 3-6 所示 表 3-6 数据库读写寄存器 寄存器 地址 定义 R/W 字节 长度 说明 0x56-0x5F En_DBL_OP R/W 1 OP_Mode W 1 DBL_Address W 4 0x5A 表示用户申请进行数据库操作,VGUS 操作完后清零每个 VGUS 周期执行一次数据库读或写操作 0x50 表示把变量存储器空间数据写入数据库空间 0xA0 表示把数据库空间的数据读出加载到变量存储器空间数据库首 ( 字 ) 地址 ( 数据库和用户的 VT_SET 文件夹均存放在 VGUS_USER 盘符下 ) VP W 2 变量空间的首 ( 字 ) 地址,0x0000-0xFFFF OP_Length W 2 数据库操作的 ( 字 ) 长度,0x0001-0xFFFF 例如把变量存储器地址 的数据写入数据库地址 , 数据长度为 256W (0x01 00), 串口下发指令 :A5 5A 0C A 把数据库地址 的数据读出保存到变量存储器地址 , 数据长度为 256W (0x01 00), 串口下发指令 :A5 5A 0C A A 如果用户单片机需要使用数据库里数据, 可以先把数据库读出加载到变量存储器, 然后再使用 0x83 指令从变量存储器中读取, 反之亦然 通过 U 盘导出数据库 VGUS 屏工作状态下插入 U 盘 (Fat32 格式 ),VGUS 屏会自动将数据库文件 UserDb.bin 拷贝到 U 盘根目录下 出厂默认状态下, 串口屏里面没有数据库文件 UserDb.bin, 只有通过寄存器 0x56-0x5F 执行了数据库写入操作后, 串口屏里面才会生成数据库文件 UserDb.bin 数据库保存在 FLASH 存储器里面, 因此其具有掉电保存功能 VGUS 串口屏采用的是 NAND 型 FLASH 存储器, 具有容量大的优点, 但是也具有两点劣势 : 一是写入次数较少, 理论写入次数为 10 万次 ; 二是只支持块写入, 写入过程复杂 因此, 不推荐将数据库作为重要数据的存储介质使用, 也不推荐频繁修改写入数据库! 该类应用建议用户单片机外扩一个 24 系列 SPI EEPROM 存储器或者 25 系列 SPI NOR FLASH 存储器 此外, 读写数据库大约需要花费十毫秒级时间, 用户单片机发送连续指令时需要注意插入延时

25 3.7 屏参配置读写对于简单应用场合屏参配置通过 VGUS 4.3 开发工具设置实现, 参见第 7 章, 无需了解本节知识 屏参配置除了通过 VGUS4.3 开发工具设置外, 用户也可以用串口通过 0x10-0x1C 寄存器读写相关设置值,R0-RC 与寄存器地址 0x10-0x1C 一一对应 表 3-8 屏参配置寄存器 寄存器 地址 定义 R/W 字节 长度 说明 0x10-0x1C R0-RC R/W 13 VGUS 开发工具 屏参配置 的映射寄存器, 串口可通过寄存器地址读写 0x1D CONFIG_EN W 1 写入 0x5A,R1-RC 重新设置并保存 ; 写入 0xA5, 只重新设置, 不保存 注 : 先写入 0x10-0x1C 寄存器, 后写入 0x1D 寄存器设置生效 串口波特率设置 (R1/0x11) 当 R1 取值在 时,R5 R9 无效, 可以选择 17 档固定波特率之一, 如下表 ( 波特率单位为 bps): 表 3-9 串口波特率设置寄存器 R1(0x) 波特率 (bps) R1(0x) a 0b 0c 0d 0e 0f 10 波特率 (bps) 当 R1 取值为 11 时, 此时波特率由 R5 R9 决定, 并由下式计算 : R5:R9= / 波特率 R5:R9 表示一个双字节参数,R5 为高字节,R9 为低字节 比如, 设定 10000bps 波特率,R5:R9= /10000=625=0x0271 R5=02 R9= 串口指令帧头设置 (R3/0x13 RA/0x1A) R3 为帧头高字节,RA 为帧头低字节 工作模式配置寄存器 1(R2/0x12) R2 寄存器按位 (bit) 定义, 用于配置 VGUS 屏软件工作模式, 如下表所示 ( 阴影部分表示出厂设置值 ) 表 3-10 寄存器 R2 位功能定义 位 权重 定义 说明.7 0x80 VDS 未定义.6 0x40 HDS 未定义.5 0x20 TP_LED 0= 禁止屏保功能, 背光不受触摸屏状态控制 1= 启用屏保功能, 背光受触摸屏状态控制, 控制参数由 R6 R7 R8 寄存器设定 R6 为上电启动时的显示亮度, 用户可在工程中设置启动亮度.4 0x10 FCRC 0= 禁止串口通信的 CRC16 帧校验 1= 启用串口通信的 CRC16 帧校验.3 0x08 TPSAUTO 0= 触摸屏录入参数后不自动上传 ( 用户查询 ) 1= 触摸屏录入参数后是否自动上传到串口由相应触控变量的配置决定.2 0x04 变量初值 0=128KB 变量存储器上电初始化为 0x00 1=128KB 变量存储器上电初值由配置文件决定.1 0x02 FRS1 设置 VGUS 周期,VGUS 周期越小则变量响应越灵敏, 但处理变量的能力越低 VGUS 周期 80ms 120ms 160ms 200ms

26 FRS x01 FRS0 FRS 对于 1024*768 分辨率, 建议 VGUS 周期设置成 120ms 以上 VGUS 周期会影响动画图标显示的动画速度 工作模式配置寄存器 2(RC/0x1C) RC 寄存器 (AUX_CFG 配置字 ) 按位 (bit) 定义, 用于配置 VGUS 屏软件工作模式, 如下表所示 ( 阴 影部分表示出厂设置值 ) 表 3-11 寄存器 RC 位功能定义 位 权重 定义 说明.7 0x80 系统保留 必须写 0.6 0x40 未定义 写 0.5 0x20 TP_BUZZ_EN 0= 点击触摸屏有效区域时有蜂鸣器提示音 1= 点击触摸屏有效区域时无蜂鸣器提示音, 但可以通过向 0x02 寄存器写入数据控制蜂鸣器鸣叫.4 0x10 未定义 写 0.3 0x08 CRC_ACK_EN 0= 启动 CRC 帧校验后, 不应答帧校验结果 1= 启动 CRC 帧校验后, 应答帧校验结果.2 0x04 TP_CAL_MOD 未定义.1 0x02 未定义 写 0.0 0x00 未定义 写 屏保 / 触摸屏控制背光 (R2.5 R6 R7 R8) 当设置 R2.5=1 时, 设置启用屏保 R6 为点亮亮度 R7 为屏保亮度 R8 为屏保延时时间 上述屏参配置寄存器都存储于 FLASH 存储器中, 具有掉电保存功能 不允许频繁修改屏参配置寄存 器 此外, 修改屏参配置寄存器大约需要花费十毫秒级时间, 用户单片机发送连续指令时需要注意插入延时

27 4 显示控件 4.0 显示控件介绍 显示控件汇总 显示控件通过 VGUS4.3 开发工具 - 变量配置工具栏 添加, 该工具栏各图标定义如图 所示 数据变量 滚动文本 旋转图标表盘时钟动画图标位变量图标 时钟变量 基本图形 二维码 文本变量 滑块刻度 动画图片 实时曲线 变量图标 艺术字 文本时钟 列表显示 图 变量配置工具栏 表 显示控件汇总表 序号功能说明 10 数据变量 把一个数据变量按照指定格式 ( 整数 小数 是否带单位 ) 用指定字体和大小的阿拉伯数 字显示出来 11 文本变量 把字符串按照指定的格式, 在指定的文本框显示区域显示 14 滚动文本 从右向左滚动文本显示 12_00 文本时钟 利用串口屏自带的 RTC 时钟外设, 按照用户编辑的格式 用文本方式显示公历 RTC 12_01 表盘时钟 利用串口屏自带的 RTC 时钟外设, 用表盘方式显示公历 RTC 13 时钟变量 利用用户主板上的 RTC 时钟, 以文本方式显示时间 00 变量图标 01 动画图标 02 滑块刻度 将一个数据变量的变化范围线性对应一组 ICON 图标显示 ; 当变量变化时, 图标也自动相应切换 多用于精细的仪表板 进度条显示 将一个定值数据变量对应 3 种不同的图标指示状态 : 不显示 显示固定图标 显示动画图标 将一个数据变量的变化范围对应一个图标 ( 滑块 ) 的显示位置变化 多用于液位 刻度盘 进度表的指示 03 艺术字变量用 ICON 图标取代字库来显示变量数据 04 动画图片将一组全屏图片按照指定速度播放 多用于开机界面或屏保 05 旋转图标 把一个数据变量的变化范围线性对应角度数据, 然后把一个 ICON 图标按照对应的角度数 据旋转后显示出来, 多用于指针仪表板显示 把一个数据变量的每个位 (bit) 的 0/1 状态对应 8 种不同显示方案中的两种, 06 位变量图标 用 ICON 图标 ( 或图标动画 ) 来对应显示 多用于开关状态显示, 比如风机的运转 ( 动画 ) 停止 ( 静止图标 )

28 20 实时曲线 ( 趋势图 ) 结合 0x84 串口写曲线缓冲区数据来自动匹配显示实时曲线 ( 趋势图 ) 可以指定显示区 域 中心轴坐标 显示比例 ( 放大 / 缩小 ) 可控 21 基本图形 画点 线 矩形 圆形等, 详细见 节 22 列表显示 把按照二维数组定义的数据用表格分栏显示出来 23 二维码显示 根据指定内容在屏上显示指定的二维码图形信息 显示控件的添加方法 控件设计在 VGUS4.3 开发工具中完成, 所有控件设计都分为 2 个步骤 : 第一步 : 在需要添加相应显示功 能的页面下, 点击相应控件, 把该控件添加到页面上, 并拖动控件框调整显示位置和大小 第二步 : 在该 页面上点选已经添加的控件, 在右侧窗口中设置控件属性 添加的控件 控件的属性设置 图 点选控件及属性设置举例 显示控件的典型属性显示控件的典型属性如图 所示, 控件属性分为区域范围设置 变量属性和显示格式三大类 区域范围设置与变量属性对所有控件都是类似, 而显示格式对不同显示控件可能完全不同 学习显示控件的用法, 务必了解清楚变量存储地址的作用和用法 以及显示格式属性栏的功能 鼠标点击指定属性, 在属性设置窗口下方会显示关于该属性的详细介绍 X/Y 坐标指定变量显示左上角位置, 宽度 / 高度指定变量显示框大小 可以拖动控件调整或者直接修改数字 超出区域范围的变量不显示 定义变量的显示格式, 不同控件显示格式属性不同 主要定义如显示颜色 字体种类 是否透明等显示格式 设置变量的存储单元地址 变量类型 占用单元长度 以及初始值等 单元地址为字地址 ( 一个单元包含 2 个字节 ), 范围 0000~FFFF, 不同的控件占用长度不同 存储地址需要用户自行分配, 不同变量的存储地址不允许重叠, 否则会显示异常 图 显示控件属性说明

29 4.1 数据与文本变量串口屏预装了 0 号字库, 包含 4*8 到 64*128 点阵的所有 ASCII 码字符 当需要用到其它类型字库时, 可以在官网下载 ( 或者找技术支持索取 或者自行通过 TS3 软件生成相应字库文件 新字库需要从 1 开始命名, 不要与 0 号字库重名 数据变量用于整数 小数的显示 小数显示采用定点方式, 先化整并设置好整数位数和小数位数 ( 整数位数和小数位数之和不能超过 20), 例如显示 , 需要发送数据 并设置整数位数为 2 小数位数为 3 字地址, 范围 0000~FFFF, 用于存储变量值, 长度由变量类型设定 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 支持显示负数, 负数采用补码 负号要占一位整数位, 例如显示 -123, 那么整数位数就要设置为 4 位 发送 0xFF85(-123 的补码 ) 就会显示 -123 设置数据小数位数 VGUS 屏中没有实际意义的小数, 实际存储都是整数形式的, 小数只是整数中按照指定位置加小数点显示 比如 10.1, 实际存储的 串口通讯的都处理为 0x0065( 十进制为 101), 而在显示的时候根据设置的小数位数为 1 显示为 10.1 设置字体点阵大小 (Y 方向 ), 必须与 上面选择的字库实际点阵一致 图 数据变量属性设置 图 数据变量举例例如, 按照图 属性设置, 在图 中显示整数 1234, 串口发送指令 :A5 5A D2 说明 :A5 5A: 帧头 05: 指令字节长度, D2 共 5 字节 ( 不含帧头 ) 82: 写变量存储器指令 00 20: 变量地址, 在控件属性中设置 04 D2: 数据内容,1234 的十六进制数据支持负数显示, 负数采用补码 且负号要占一位整数位, 例如显示 -123, 那么整数位数就要设置为 4 位 发送 0xFF85(-123 的补码 ) 就会显示 -123

30 4.1.2 文本变量 用于中英文字符串的显示 对于页面上的固定文字提示信息, 建议直接做到背景图片上, 一方面在图 片上可以设计出更好的字体显示效果, 另一方面可以减少页面上的变量, 有利于提高串口屏的响应速度 字地址, 范围 0000~FFFF, 用于存储变量值, 长度由字长度设定 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 选择 2 种字库 FONT0 用于显示字符串中的字母和数字, 必须为 ASCII 码字库 FONT1 用于显示中文, 常用编码方式为 GB2312 或者 GBK 1 个汉字占用长度为 1,1 个 ASCII 码字符占用长度为 0.5, 范围 遇到 0xFFFF 结束符或者显示到文本框尾则不再显示 例如设置为 GB2312 编码, 要显示 4 个汉字则字长度至少设置为 4 指定字库的 Y 方向点阵数,2 种字库的 Y 方向点阵数必须一样, 且必须与上面选择的字库实际点阵一致 图 文本变量属性设置文本变量允许最长文本长度为 1024 字 (2K 字节 ), 实际文本显示长度取决于以下三个条件 : 文本长度限制 ( 属性设置中的字长度 ) 文本结束符 0xFFFF 或者文本框尾, 当遇到上述任意一个条件后, 显示就会结束 因此, 当把字长度设置的大于实际文本显示长度时, 在用 0x82 指令写入文本显示内容, 必须要在文本结尾的地方写入文本结束符 0xFFFF, 否则会在文本尾部显示多余的信息 VIEW123 武汉中显 图 文本变量举例例如, 按照图 属性设置, 在图 中显示英文加数字 VIEW123, 串口发送指令 : A5 5A 0C FF FF 说明 :A5 5A: 帧头 0C: 指令字节长度, FF FF( 不含帧头 ) 82: 写变量存储器指令

31 01 00: 变量地址, 在控件属性中设置 : 数据内容, VIEW123 的 ASCII 码 FF FF: 文本结束符 例如 : 显示中文 武汉中显, 串口发送指令 : A5 5A 0D CE E4 BA BA D6 D0 CF D4 FF FF 说明 :A5 5A: 帧头 0D: 指令字节长度, CE E4 BA BA D6 D0 CF D4 FF FF 共 13 字节 ( 不含帧头 ) 82: 写变量存储器指令 01 40: 变量地址, 在控件属性中设置 CE E4 BA BA D6 D0 CF D4: 数据内容, 武汉中显 的汉字内码 FF FF: 文本结束符如果需要显示日文 韩文 俄文等文字, 通常可以使用 unicode 编码字库 日文也可以使用 SJIS 编码字库 关于特殊语种显示欢迎联系技术支持 滚动文本滚动文本的属性设置与文本变量基本类似, 只是多了滚屏模式选择和滚屏间距设置 需要注意的是 : 1. 变量存储地址开始的三个单元没有使用, 文本从 变量存储地址 +3 单元开始存储 ; 例如变量存储单元地址为 0x0100, 我们在用 0x82 指令写入文本时, 要从 0x0103 单元开始写入 2. 属性设置中的字长度仅用于 VGUS4.3 开发工具自动分配变量存储地址和检查单元地址冲突, 实际长度以文本结束标志为准, 遇到文本结束标志 0xFFFF 后不再显示 3. 文本实际长度没有限制, 最大允许长度为 1024 字, 使用 0x82 指令写入文本时必须以 0xFFFF 结尾, 作为文本结束标记 字地址, 范围 0000~FFFF, 用于存储变量值, 长度由文本结束标志 0xFFFF 指定 ( 字地址一个单元包含 2 个字节 ), 文本实际长度没有限制 使用 0x82 指令刷新显示内容时需要使用该地址 需要注意上文中的三点 1 个汉字占用长度为 1,1 个 ASCII 码字符占用长度为 0.5, 范围为 字 该长度仅用于 VGUS4.3 开发工具自动分配变量存储地址和检查单元地址冲突 实际长度以文本结束标志为准, 遇到文本结束标 志 0xFFFF 后不再显示, 最大允许文 本长度为 1024 字 选择文本滚动方向, 仅支持自右向左滚动 设置每个 VGUS 刷新周期文本滚动的 像素点阵数 图 滚动文本属性设置

32 4.2 图标与图片 VGUS4.3 中, 约定将分辨率与串口屏分辨率一致的图片称为 图片, 而将所有分辨率小于串口屏分辨率的图片称为 图标 所有的图片都有编号, 通过寄存器 0x003-0x04 以 0x80 指令直接调用 切换图片显示 本节中会介绍动画图片功能 图标其实就是小图片, 图标素材不能直接使用, 需要先制作 Icon 文件后才能使用 制作 Icon 文件首先将所有图标素材进行编号, 然后通过 VGUS4.3 开发工具中的 工具 - Icon 生成工具 导入这些素材, 并生成一个 Icon 文件 一个工程里面, 允许存在多个 Icon 文件, 一个 Icon 文件里面允许存在若干个图标 图标是通过 Icon 文件名 + 图标编号 的方式来调用 第一步 : 准备图标素材 给图标素材命名编号 并放到同一文件夹下 ; 下图为显示电池容量准备的一组图标素材 图标素材支持 bmp jpg gif png 等格式 需要用到图标透明显示场合, 图标素材必须使用 BMP 格式, 图标左上角像素颜色为背景色 图标素材尺寸建议不要超过 255*255, 过大尺寸的图标会影响显示速度 图 图标素材展示第二步 : 打开图标文件生成器, 点击 选择素材路径, 选择图标素材所在的文件夹位置, 导入所有图标素材 点击 生成 Icon 文件, 生成 Icon 文件,Icon 文件命名必须以数字开头, 生成的 Icon 文件会自动添加到图标文件列表中 点击 预览 可以查看生成的 ICO 文件 图 图标文件生成器

33 4.2.2 变量图标该控件是把图标编号映射到变量存储单元, 通过向变量单元里写入不同的变量, 然后串口屏根据变量值检索图标编号, 再调用对应图标显示 通常用于串口发 0x82 指令方式, 来调用不同的图标在相同的位置显示, 例如实现进度条的显示功能 电池电量显示 需要注意的是 : 图标编号不是变量值, 图标编号与变量值等比均分对应 变量上下限设定的变量范围与图标数量可以不一一对应, 串口屏会自动将变量或者图标数进行均分, 例如变量为 0 到 100 而图标为 5 到 14, 这样变量 0 到 10 对应的图标都是 5 字地址, 范围 0000~FFFF, 用于存储变量值, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 支持透明显示和带背景显示, 透明显示要求 素材必须是 BMP 格式 选择 Icon 文件 指定图标范围 图 变量图标属性设置 图 变量图标应用举例例如, 按照图 图标素材 图 属性设置, 为让上图中左边进度条显示 10 种不同状态, 串口可以分别发送指令 : A5 5A A5 5A A5 5A 说明 :A5 5A: 帧头 05: 指令字节长度, 共 5 字节 82: 写变量存储器指令 01 20: 设置的变量地址, 如上图变量属性所示 00 00: 设置的变量值, 变量的上下限 0-9 与编号为 5-14 的图标一一对应, 即发送 显示 5 号图标, 00 01: 显示 6 号图标, 以此类推

34 4.2.3 动画图标该控件是在显示屏某一区域连续循环显示一串图标, 实现动画效果, 动画播放时间间隔为一个 VGUS 刷新周期 ( 约 100 毫秒 ) 变量只有 2 个取值 : 一个为开始值, 一个为停止值 当通过 0x82 指令向变量单元写入开始值时, 动画开始播放 ; 当写入停止值时, 动画停止播放 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 变量只取 2 个值 : 一个为开始值, 一个停止值 当通过 0x82 指令向该单元写入开始值时, 动画开始播放 ; 当写入停止值时, 动画停止播放 选择 ICON 文件 停止播放后画面停留位置 选择动画图标的播放范围 图 动画图标属性设置按照图 设置 : 当向 0121 单元写入 1 后, 将把 24.ICO 文件中的 15 到 28 号图标循环播放 当向 0121 单元写入 0 后, 动画停止播放, 画面停留到 15 号图标上 当向 0121 单元写入其它值时, 不显示图标和动画 图 动画图标举例为在上图中间位置显示旋转的 VGUS 动画, 需要准备右侧的图标素材 按照图 所示设置, 为让上图中间动画图标显示动画效果, 可以发送指令 : 开始动画指令 A5 5A 停止动画指令 A5 5A 说明 :A5 5A: 帧头 05: 指令字节长度, 共 5 字节 82: 写变量存储器指令 01 21: 设置的变量地址, 如上图变量属性所示 00 00: 设置的变量开始值, 发送开始值后循环播放开始图标到结束图标, 发送停止值后显示停止图标 小技巧 : 如果把图 中的初始值设置为 1, 就可以实现开机动画, 上电自动播放

35 4.2.4 动画图片与动画图标不同, 动画图片播放整张图片 播放的起始 / 终止图片和播放时间间隔可以在属性中设置 播放到终止位置图片后自动结束播放 需要特别注意的是, 动画图片没有分配变量存储地址单元, 显示动画图片控件所在的页面, 将自动启动播放 选择起始图片编号 选择终止图片编号 设置图片显示时间间隔 图 动画图片属性设置上图设置从第 35 号图片开始, 播放到第 49 号图片结束, 播放时间间隔为 8*10mS=0.08 秒 启动播放方法 : 显示动画图片控件所在的页面, 将自动启动播放 停止播放方法 : 播放到终止图片位置自动停止播放 循环播放方法 : 在终止图片页面上也添加一个属性一样的动画图片控件 串口发送指令切换图片或者触控按钮切换图片可以结束循环播放 开机自动播放 : 在 0 号图片上 ( 开机页面上 ) 添加动画图片控件 注意 : 动画图片控件所在页面无法驻留显示 滑动刻度该控件是指定一个图标 ( 滑块 ), 在水平方向或者垂直方向上 在指定范围内变化位置显示 ( 滑动 ), 显示位置通过变量设定 通常可以配合拖动调节控件使用 ( 详见 节 ) 需要注意的是: 变量值不是坐标, 滑块显示位置与变量值等比均分对应 起始 / 终止刻度值设定的变量范围与滑动区域坐标可以不一一对应, 串口屏会自动将变量或者滑动区域坐标进行均分后对应 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新滑块显示位置时需要使用该地址 最小变量值 横向滑动图标对应位于最 左边, 纵向对应位于最上边 最大变量值 横向滑动图标对应位于 最右边, 纵向对应位于最下边 选择滑动图标 ( 滑块 ) 选择滑动方向 : 横向或者纵向 图 滑动刻度属性设置

36 图 滑动刻度举例为在上图中实现人形滑块显示, 可以横线上方添加一个滑块刻度控件, 属性设置如图 让滑动刻度显示在指定位置, 串口可以发送指令 : A5 5A A5 5A A5 5A E7 A5 5A E8 说明 :A5 5A: 帧头 05: 指令字节长度, 共 5 字节 82: 写变量存储器指令 01 80: 设置的变量地址, 如上图变量属性所示 00 00: 设置的变量刻度值, 即从 变化到 03 E 艺术字变量该控件与数据变量应用一样, 都是可以实现一个数据显示 与数据变量不同的是, 艺术字变量使用图标 ( 共 12 个图标 ) 代替字库, 可以实现各种特殊字体效果 特殊颜色效果的数据显示 常见的数码管字体建议使用数据变量实现, 显示速度更快 字地址, 范围 0000~FFFF, 用于存储变量值, 长度由变量类型设定 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 指定数字 0-9 中划线 小数点对应的图标 起始图标对应数字 0, 其它顺延 VGUS 屏中没有实际意义的小数, 实际存储都是整数形式的, 小数只是整数中按照指定位置加小数点显示 比如 10.1, 实际存储的 串口通讯的都处理为 0x0065( 十进制为 101), 而在显示的时候根据设置的小数位数为 1 显示为 10.1 图 艺术字变量属性设置

37 图 艺术字变量举例为实现上图中的数据显示效果, 只能使用艺术字变量 首先要制作图标素材如上图右侧 在文本框位置添加一个艺术字变量, 属性设置参照 , 当向 0160 单元写入 345 后, 就可以显示出上图艺术字出来 旋转图标该控件控件通常用于仪表盘的显示, 需要预先设计一张表盘背景图片和一个指针图标, 指针图标根据变量值确定显示角度, 指针图标旋转中心坐标可以设置 指针图标旋转中心在表盘背景图片上的显示位置也可以设置 表盘效果表盘背景图片指针图标 图 旋转图标举例 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新指针 ( 图标 ) 显示角度时需要使用该地址 选择指针图标 设置指针旋转中心 变量最小 最大值 变量最大值对应的旋转角度 1-720, 单位 0.5 度 变量最小值对应的旋转角度 0-719, 单位 0.5 度 图 旋转图标属性设置

38 需要注意的是 : 变量值不是角度值, 指针显示角度与变量值等比均分对应 起始 / 终止值设定的变量范围 与起始 / 终止角度角度设定的旋转角度可以不一一对应, 串口屏会自动将变量或者转动角度均分后对应 按照上图属性设置, 通过向 0040 单元写入不同的值, 就可以控制指针的旋转显示位置 旋转始终约定为 顺时针 转动, 即终止旋转角度必须大于起始旋转角度 ( 如果终止旋转角度小于起始旋转角度, 系统处理时会自动加上 360 ) 图 旋转方向 位变量图标该控件是把一个数据变量 ( 双字节 / 共 16 个位 ) 的每个位 (bit) 的 0/1 状态对应 8 种不同显示方案 ( 显示模式 ) 中的两种, 用 ICON 图标 ( 或图标动画 ) 来对应显示 多用于开关状态显示 报警指示灯的显示 风机状态显示 ( 运转为动画 停止为静止图标 ) 图 中, 有 5 个指示灯状的图标, 就是使用位变量图标实现的 该例中使用了变量图标中 16 个位的低 5 位, 位值为 0 显示的是蓝色方块图标, 位值为 1 显示的是带有红色指示灯的图标,5 个图标自上向下依次排列 图 位变量图标典型应用举例 表 八种显示方案 ( 显示模式 ) 显示模式 位值 0 1 0x00 ICON0S ICON1S 0x01 ICON0S 不显示 0x02 ICON0S ICON1S-ICON1E 动画 0x03 不显示 ICON1S 0x04 不显示 ICON1S-ICON1E 动画 0x05 ICON0S-ICON0E 动画 ICON1S 0x06 ICON0S-ICON0E 动画 不显示

39 0x07 ICON0S-ICON0E 动画 ICON1S-ICON1E 动画 表 位变量图标排列模式 (16 个图标的排列方向 ) 排列模式 说 明 0x00 水平方向排列, 自左向右 高位在左, 不保留未启用位的图标位置 ; 0x01 垂直方向排列, 自上向下 高位在上, 不保留未启用位的图标位置 ; 0x02 水平方向排列, 自左向右 高位在左, 保留未启用位的图标位置 ; 0x03 垂直方向排列, 自上向下 高位在上, 保留未启用位的图标位置 字地址, 范围 0000~FFFF, 用于存储变量值, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 字地址, 范围 0000~FFFF, 用于存储变量值, 长度为 2 个单元 ( 字地址一个单元包含 2 个字节 ) 该地址单元用户禁止访问, 用于存储位变量图标显示的辅助数据 设置位变量图标中 16 个位哪些启用, 为 0 图标排列模式, 自上向下, 不保留未启用相应位不启用, 为 1 相应位启用 的图标位置 排列间隔定义相邻图标的中心距, 单位像素 选择图标, 图标用途见表 图 位变量图标属性设置图 中, 在每个图标位置还定义了一个增量调节按钮, 点击后, 控制位变量图标切换显示 控件设计如图 , 在位变量图标的每个图标上还设计了一个增减调节按钮, 实现复选功能 增量调节按钮 0 的属性设置如图 , 变量存储地址与位变量图标的一样, 变量模式为位调节 图 位变量图标控件设计举例 图 增量调节按钮属性设置

40 4.3 图形变量 实时曲线 ( 趋势图 ) VGUS 屏有一个 8K Word 可以存储 8 条曲线的缓冲区, 用于用户简单 快速显示曲线 曲线缓冲区的数据都是 16 位无符号数 8K word 的曲线缓冲区不占用 64K word 的变量存储器空间, 也没有分配变量存储地址 属性设置 曲线中心位置,Y 坐标值 MUL_Y, 单位是 1/256,0x0000-0xFFFF 放大倍数计算方法见下文 X 方向的像素间隔, 实现水平方向的放大 曲线中心位置对应的曲线数据值 最多可以显示 8 条曲线, 一条曲线对应有一 个数据源通道, 编号 0 到 7 图 实时曲线属性设置 图 实时曲线显示举例首先在属性设置中定义曲线显示区域, 如上图网格区域, 左上角坐标 (Xs,Ys) 右下角坐标(Xe,Ye) 然后设置波形中心线对应在显示屏上的 Y 坐标 以及中心线对应的曲线数据值, 这样就确定了波形显示位置 曲线水平方向放大倍数直接通过调整横轴间隔实现 满量程曲线纵轴放大倍数计算方法 : MUL_Y=(Ye-Ys)*256/(Vmax-Vmin) Ye,Ys 为曲线窗口的 Y 坐标, Vmax,Vmin 为曲线数据的最大, 最小值 例如一个 12bit A/D 采集数据 (Vmax=4095 Vmin=0) 要对应在 Ys=50,Ye=430 的屏幕区域满量程显示, 那么 :MUL_Y=(430-50)*256/(4095-0)=23.7 向下舍入取 23 如果需要显示粗线条的曲线, 可以把做好的曲线控件复制一个出来, 把属性设置中的 X 坐标加 1

41 Y_Central 加 1 其它属性不变, 这样就会把曲线复制并平移一个像素, 看起来就是曲线变粗了 利用第 6 章介绍的描述指针的方法 : 结合增量调节按钮, 把按钮的变量存储地址设置与纵轴放大倍数或者水平间隔存储地址一样, 可以实现通过增量调节按钮放大缩小曲线显示 无需用户程序干预 结合拖动调节按钮, 把按钮的变量存储地址设置与 Y_Central 的存储地址一样, 可以实现通过拖动调节按钮上下移动曲线 无需用户程序干预 曲线缓冲区写指令 0x84 表 曲线缓冲区写指令 0x84 帧结构 定义 指令帧头 指令长度 指令 曲线通道 曲线数据 长度 ( 字节 ) 2 1 1(0x84) 1(CH_Mode) 2n(DATA0(Word)+ +DATAn) 表 曲线通道 CH_Mode 定义 位 CH_Mode.0 CH_Mode.1 CH_Mode.2 CH_Mode.3 CH_Mode.4 CH_Mode.5 CH_Mode.6 CH_Mode.7 通道 通道 0 通道 1 通道 2 通道 3 通道 4 通道 5 通道 6 通道 6 CH_Mode 的每个位 (bit) 对应 1 个通道 ; CH_Mode 的相应位值为 1 表示该条曲线存在, 为 0 表示不存在, 允许同时存在多条曲线 ; 曲线数据按照低通道数据在前排列, 例如 CH_Mode=0x83( B), 表示曲线数据格式为 : ( 通道 0+ 通道 1+ 通道 7)+ +( 通道 0+ 通道 1+ 通道 7) 用户单片机通过 0x84 指令 按照通道号把曲线数据发送给串口屏 当串口屏收到 0x84 指令后, 接收到 的曲线数据总是靠曲线窗口右侧显示 之前的曲线会向左移动 超出窗口长度部分的曲线会移出

42 4.3.2 基本图形 ( 绘图 ) 表 基本图形指令汇总 图形指令 功能 说明 0x0001 置点 置点 (x,y,color) 0x0002 端点连线 端点连线 (color,(x0,y0), (xn,yn)) 0x0003 矩形 显示矩形, 颜色和位置 大小可控 0x0004 矩形填充 填充指定的矩形区域, 填充颜色和位置 大小可控 0x0005 画圆 显示整圆弧, 颜色和位置 大小可控 0x0006 图片剪切粘贴 从指定图片上剪切一个区域粘贴到当前显示页面上 0x0007 ICON 图标显示 ICON 图标显示, 图标库可以选择 0x0008 封闭区域填充 封闭区域填充, 种子点坐标 填充颜色可控 0x0009 频谱显示 根据变量数据显示频谱 ( 垂直线条 ), 线条颜色 位置可控 0x000A 线段显示 根据变量数据连接线段, 端点 颜色可控 0x000B 圆弧显示 显示圆弧, 半径 颜色 起止角度可控 0x000C 字符显示 根据变量数据进行单个字符显示 0x000D 矩形区域 XOR 对指定的矩形域位图数据用指定颜色进行 XOR 操作, 多用于高亮显示 0x000E 双色位图显示 变量存储器数据看成双色位图数据,0/1 对应颜色可指定, 多用于自定义光标 0x000F 位图显示 变量存储器数据位 65K 色位图数据, 多用于实时图标 ( 照片 ) 下载显示 0x0010 区域放大粘贴 把指定区域放大 1 倍粘贴到指定位置, 多用于配合 0F 指令实现照片实时显示 图 基本图形属性设置基本图形显示的属性设置非常简单, 如图 所示 区域范围设置必须足够大, 超出范围的图形不显示 变量属性中主要设置的也就是变量存储地址, 需要显示的图形数据内容需要写入该地址单元中, 实际占用地址单元数量取决于图形数据内容的多少, 不同基本图形指令 ( 表 4-3-3) 的图形数据内容格式不同, 参见表 表 表 图形数据内容格式定义 地址 ( 字 ) 定义 说明 VP CMD 双字节, 图形指令 VP+1 Data_Pack_Num_Max 双字节, 最大数据包数目, 连线指令 (0x0002) 定义为连线线条数目, 即顶点数 -1 VP+2 DATA_Pack 双字节, 数据包, 参见表 4-3-5

43 基本图形指令举例 :a5 5a f B 00 A4 02 EE C2 01 B9 a5 5a : 指令帧头 15 : 指令长度,21 个字节, 单位字节 82 : 写变量存储器指令 : 变量地址 : 端点连线的图形指令, CMD : 连线线条数目, Data_Pack_Num_Max f8 00 : 连线的颜色红色, 双字节 02 3B 00 A4 : 连线第一个点的坐标 DATA_Pack/ 数据包 02 EE : 连线第二个点的坐标 02 C2 01 B9 : 连线第三个点的坐标表 图形指令数据包格式定义 图形数据内容 图形 绘图 绘图数据包格式说明 ( 偏移量和长度单位均为字 (word)) 指令功能偏移量长度定义说明 0x00 2 (x,y) 置点坐标位置,x 坐标高字节为判断条件 0x0001 置点 0x02 1 color 置点颜色 0x00 1 color 线条颜色 端点 0x0002 连线 0x0003 矩形矩形 0x0004 填充整圆弧 0x0005 显示图片区域 0x0006 剪切 粘贴 ICON 0x0007 图标显示区域 0x008 填充频谱显示 0x0009 ( 垂直线条 ) 线段 0x000A 显示 0x01 2 (x,y) 0 连线顶点 0 坐标,X 坐标高字节为判断条件 0x03 2 (x,y) 1 连线顶点 1 坐标,X 坐标高字节为判断条件 0x01+2*n 2 (x,y) n 连线顶点 n 坐标,X 坐标高字节为判断条件 0x00 2 (x,y) s 矩形框左上角坐标,x 坐标高字节为判断条件 0x02 2 (x,y) e 矩形框右下角坐标 0x04 1 color 矩形颜色 0x00 2 (x,y) s 矩形域左上角坐标,X 坐标高字节为判断条件 0x02 2 (x,y) e 矩形域右上角坐标 0x04 1 color 矩形域填充颜色 0x00 2 (x,y) 圆心坐标,X 坐标高字节为判断条件 0x02 1 Rad 半径 0x03 1 color 圆颜色 0x00 2 Pic_ID 剪切图片区域所在页面 ID, 高字节为判断条件 0x02 2 (x,y) s 剪切图片区域左上角 0x04 2 (x,y) e 剪切图片区域右下角 0x06 2 (x,y) 剪切图片区域粘贴到当前页面的坐标位置, 左上角坐标 0x00 2 (x,y) 显示坐标位置,x 坐标高字节为判断条件 0x02 1 ICON_ID 图标 ID, 图标库位置由指令高字节指定图标固定为不显示背景色 0x00 2 (x,y) 种子点坐标,x 坐标高字节为判断条件 0x02 1 color 填充颜色 0x00 1 Color0 0x01 3 X0,Y0s,Y0e 把 (X0,Y0s)(X0,Y0e) 用 Color0 颜色连线,X0 高字节为判断条件 0x00 1 Color 0x01 2 (Xs,Ys) 把 (Xs,Ys)(Xe,Ye) 用 Color 颜色连线,Xs 高字节为判断条件 0x03 2 (Xe,Ye) 0x000B 圆弧 0x00 1 Color0 圆弧显示

44 0x000C 0x000D 0x000E 显示 0x01 2 (X,Y) 0 圆心 (X,Y) 坐标,X 坐标高字节为判断条件 0x03 1 RAD0 半径 0x04 1 DEG_S0 起始角度, 单位 0.5, x05 1 DEG_E0 终止角度, 单位 0.5, x00 1 Color0 字符显示颜色 0x01 2 (X,Y) 0 字符显示位置, 字符左上角坐标,X 坐标高字节为判断条件 0x03H 0.5 Lib_ID 字库位置 0x03L 0.5 En_Mode 字符编码模式 :0=8bit 1=GB2312 2=GBK 3=BIG5 4=SJIS 5=UNICODE 字符 0x04H 0.5 X_Dots 字符 X 方向点阵数显示 0x04L 0.5 Y_Dots 字符 Y 方向点阵数 字符数据, 8bit 编码, 对仅高字节有效 0x05 1 Text0 当编码方式为 时, 如果字符数据为 ASCII 字符, 将自动使 用 0# 预装字库显示 0x00 2 (x,y) s 矩形区域左上角坐标,x 坐标高字节为判断条件矩形区 0x02 2 (x,y)e 矩形区域左下角坐标域 XOR 0x04 1 Color 矩形区域 XOR 的颜色,0xFFFF 将进行反色操作 0x00 2 (x,y)s 位图显示矩形区域左上角坐标,x 坐标高字节为判断条件 0x02 1 X_Dots 位图 X 方向点阵数 0x03 1 Y_Dots 位图 Y 方向点阵数 双色位 0x04 1 Color1 1 bit 对应的显示颜色 图显示 0 bit 对应的显示颜色 : 如果设置 color0 和 color1 相同, 表示 0 0x05 1 Color0 bit 不需要显示, 直接跳过 0x06 N Data_Pack 显示数据,MSB 方式 ; 为方便用户读写数据, 每行数据必须对齐到一个字, 即下一行的数据总是从一个新数据字 (word) 开始 0x00 2 (x,y)s 位图显示矩形区域左上角坐标,x 坐标高字节为判断条件 0x000F 位图显 示 0x02 1 X_Dots 位图 X 方向点阵数目 受变量空间大小限制, 最大显示 0x03 1 Y_Dots 位图 Y 方向点阵数目 位图为 196*146 ( 4:3 ) 或 226*126(16:9) 0x04 N Data_Pack 显示数据, 每个像素点一个字 (MSB,565RGB 数据格式 ) 0x0010 区域放大一倍粘贴显示 放大一倍后图像粘贴在屏幕左 0x00 2 (x,y) 上角坐标,X 高字节为判断条件 0x02 2 (x,y)s 待放大矩形域左上角坐标 0x04 2 (x,y)e 待放大矩形域右上角坐标 待放大区域位于放大后图像区 域内时, 必须右下角对齐 嵌套 放大可以得到更大的放大倍数 判断条件 :0xFF 绘图操作结束,0xFE 本次操作跳过 ( 忽略 ) 基本图形显示举例 ( 以 0x0006 图片区域剪切 粘贴指令为例 ) Step1 在界面上定义一个基本图形显示控件, 变量存储地址设置为 0x1000;

45 图 基本图形显示举例 Step2 串口向 0x1000 地址单元写入 0x0006 指令相关内容 ( 把第三幅页面的 (100,100) (512,256) 区域 剪切粘贴到当前界面的 (0,0) 位置 ) 图 基本图形指令举例当显示切换到基本图形显示控件所在的页面时,VGUS 屏将执行剪切 粘贴 坐标 (340,237) 与坐标 (585,237) 端点连线 : A5 5A ED ED 坐标 (340,237) 置点 : A5 5A ED 左上角坐标 (340,237) 右下角坐标 (585,340) 矩形 : A5 5A ED 圆心坐标 (470,325), 半径为 50 整圆 : A5 5A 0F D 号界面左上角坐标 (265,64) 右下角坐标 (785,256) 剪切粘贴到当前界面坐标 (265,64): A5 5A 端点坐标 (80,80)( 128,128) 线段显示 : A5 5A A 说明 : 上面所有指令中 指最大数据包数目, 即执行画图指令的次数, 如画一条线段 一个矩形框 一个圆设置为 00 01, 画两条线段 两个矩形框 两个圆设置为 00 02

46 4.3.3 列表显示 ( 表格 ) 把按照二维数组定义的数据用表格分栏显示出来 图 列表显示举例 定义表格的列数 行数 表格的内容可以显示文本, 也可以显示变 量 显示变量时参照备注 1 来确定要显 示的变量的格式 单元格的数据长度 0x01-0xFF( 单位 : 字 ), 所有单元格的数据长度一样 当设置为 0 时, 表示可以按列设置单元格的数据长度, 表格数据存储位置相应后延 ( 列数 /2) 向上取整个字地址 例如, 变量地址为 0x1000, 列数为 7, 那么 :0x1000-0x1003 依次存储了第 0-6 列的表格数据长度, 其中 1003 的低字节未使用 0x1004 地址开始存储表格内容 图 列表显示属性设置备注 1 当勾选 直接变量显示, 每个单元格数据内容的前两个字定义了表格数据格式, 说明如下 : 第一个字高字节选择数据类型 Mode 0x00= 整数 (2 字节 ), 到 32767

47 0x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x05= 无符号整数 (2 字节 )0 到 x06= 无符号长整数 (4 字节 )0 到 x10= 时间格式 1,12:34:56BCD 码串 0x11= 时间格式 2, BCD 码串 0x12= 时间格式 3,YYYY-MM-DD HH:MM:SS BCD 码串 0xFF= 文本格式第一个字低字节 : Mode=0x00-0x06 定义了变量数据的定点显示格式, 高 4bit 表示整数位数, 低 4bit 表示小数位数 Mode=0x10-0X11 时间 BCD 码串的字节长度 Mode= 其它无定义第二个字定义单元格文本颜色 如果表格实际内容短于 Unit_Data_Num 规定的长度时, 使用 0xFFFF 做为单元格文本结束符 对于特别大的表格, 通过描述指针修改起始显示列 起始显示行可以很方便的实现表格的定位和拖动 二维码该控件实现将一段文字转换为二维码显示在串口屏上 把需要显示的二维码对应的文字 通过 0x82 指令写入变量存储地址单元中后, 串口屏会根据写入的文字内容生成二维码 并按照指定位置显示出来 首先在显示页面上添加一个二维码控件, 设置属性中的变量存储地址, 如图 然后把需要显示的二维码对应的文字 通过 0x82 指令写入变量存储地址单元中就可以了 VGUS 屏会根据写入的文字内容生成二维码 并按照指定位置显示出来 需要注意的是 : 使用 0x82 指令发送文本时, 需要在文本结束位置加上 0xFFFF 作为结束符 字地址, 范围 0000~FFFF, 用于存储变量值, 长度由文本结束标志 0xff 或者 0x00 指定 ( 字地址一个单元包含 2 个字节 ), 允许文本最长为 458 字节 使用 0x82 指令刷新显示内容时需要使用该地址 1 个汉字占用长度为 1,1 个 ASCII 码字符占用长度为 0.5, 范围为 字 该长度仅用于 VGUS4.3 开发工具自动分配变量存储地址和检查单元地址冲突 实际长度以文本结束标志为准, 遇到文本结束标志 0xFFFF 后不再显示 每个二维码单元像素所占的物理像素点阵大小, 0x01-0x07 设置 Unit_Pixels=4, 那么每个单元 像素将显示为 4*4 点阵大小 图 二维码属性设置 例如 : 显示网站 生成的二维码, 串口发送指令 : A5 5A E E 63 6E FF FF A5 5A: 帧头 14: 指令字节长度, 共 20 字节 ( 不含帧头 ) 82: 写变量存储器指令 00 00: 变量地址, 在控件属性中设置 E E 63 6E: 数据内容 的 ASCII 码 FF FF: 文本结束符

48 4.4 实时时钟 RTC 的显示 表盘时钟 文本时钟 图 时钟显示举例 文本时钟该控件用于实现图 中的文本时钟显示 需要注意的是 : 1. 不带 RTC 时钟的串口屏没有该功能 ( 消费类串口屏没有 RTC 功能 ) 2. 该控件没有分配变量存储地址, 串口屏通过自带的 RTC 功能, 读取时间并按照定义的格式显示, 显示时间与寄存器 0x20-0x26 单元内的内容同步 设置显示颜色 字库 点阵大小 时间格式可以自由组合, 分隔 符只支持 ASCII 码 图 文本时钟属性设置 时间显示格式支持 年 月 日 时 分 秒 星期 七个时间单元, 分别用表 的编码代替 可以在时间格式中任意组合这七个时间单元顺序 以及时间单元间的分隔符 表 时间格式编码定义 说明 编码 显示格式 公历 _ 年 Y 公历 _ 月 M 公历 _ 日 D 公历 _ 小时 H 公历 _ 分钟 Q 公历 _ 秒 S 公历 _ 星期 W SUN MON TUE WED THU FRI SAT

49 如果需要使用中文分隔符, 例如显示 2015 年 06 月 01 日, 需要设计三个文本时钟控件, 分别用于显示年 月 日, 并且把中文的年 月 日分隔符设计到背景图片上 表盘时钟该控件用于实现图 中的表盘时钟显示 需要注意的是 : 1. 不带 RTC 时钟的串口屏没有该功能 ( 消费类串口屏没有 RTC 功能 ) 2. 该控件没有分配变量存储地址, 串口屏通过自带的 RTC 功能, 读取时间并按照定义的格式显示, 显示时间与寄存器 0x20-0x26 单元内的内容同步 示 图 表盘时钟素材 在使用表盘时钟控件前, 需要先准备一张表盘背景图片和三张图标 ( 时针 分针 秒针 ), 如上图所 选择时针 分针 秒针所在的 ICON 文件 设置时针是否显示 图标编号和旋转中心 设置分针是否显示 图标编号和旋转中心 设置秒针是否显示 图标编号和旋转中心 图 表盘时钟属性设置 变量时钟文本时钟与表盘时钟都是使用串口屏自身的 RTC 外设功能, 而消费类串口屏都没有 RTC 功能, 这类产品就不支持上述的文本和表盘时钟显示功能 消费类串口屏如果需要显示时钟, 客户主板需要设计 RTC 功能, 通过串口把时间信息实时发送给串口屏, 然后使用变量时钟控件来显示 变量时钟只能显示文本形式的时钟 变量时钟分配了一段变量存储单元, 单元长度通过 BCD 码字节数设定, 单元功能用于存储单片机发送过来的 年 月 日 时 分 秒 星期 等时间信息, 格式是

50 BCD 码格式 用户单片机将 年 月 日 时 分 秒 星期 等时间信息以 BCD 码格式 通过 0x82 指令写入变量存储单元 串口屏依次取出变量单元里面的 BCD 时间并按照设置好的显示位置 颜色 字库 点阵大小显示出来, 字节与字节之间的分隔符客户可以设置 ( 例如习惯年月日用中划线 时分秒用冒号 ) 显示一个字节的 BCD 码时间 取一个分隔符显示 字地址, 范围 0000~FFFF, 用于存储 BCD 码格式的时钟, 长度由 BCD 码字节数设定 ( 字地址一个单元包含 2 个字节 ) 使用 0x82 指令刷新显示内容时需要使用该地址 用户单片机将 年 月 日 时 分 秒 星期 等时间信息以 BCD 码格式 通过 0x82 指令写入变量存储单元 设置分隔符, 每显示一个字节的 BCD 码数据, 依次取一个分隔符 以十六进制形式录入分隔符 图 变量时钟属性设置图 中的分隔符和 16 进制分隔符都是用来录入时间单元间的分隔符号, 时间显示中的常用分隔符号只有中划线 冒号和空格, 中划线用于分隔年月日 冒号用来分隔时分秒 空格用于分隔年月日和时分秒 ASCII 码中十六进制数 2D 是中划线 20 是空格 3A 是冒号 图 中时钟变量设置有 6 字节的 BCD 码时间数据 5 个分隔符号 (2 个中划线 +1 个空格 +2 个冒号 ), 假设变量存储单元里的 6 字节 BCD 数据依次是 , 那么显示出来的时间样式就是 :20:25 分隔符还支持 2 个特殊编码 00 和 0D, 只能通过 16 进制分隔符位置录入 00 不插入分隔符, 实现 2 个 BCD 连到一起显示, 常用与 4 位数的年份显示 0D 为换行显示, 实现纵向排列时间显示, 即 X=Xs, Y=Y+Font_X*2 例如设置变量时钟属性如图 所示,BCD 字节长度为 7 字节 6 个分隔符 (00+2 个中划线 +1 个空格 +2 个冒号 ), 假设变量存储单元里的 7 字节 BCD 是 , 那么显示出来的时间样式就是 :20:25 图 四位数的年份显示设置例如 : 显示时间变量 08:30, 串口发送指令 : A5 5A F 说明 :A5 5A: 帧头 05: 指令字节长度,82 6F 共 5 字节 ( 不含帧头 ) 82: 写变量存储器指令 6F 00: 变量存储地址, 在控件属性中设置 08 30: 数据内容, 的 BCD 码

51 5 触摸控件 5.0 触摸控件介绍 触摸控件汇总触摸控件需要通过 VGUS4.3 开发工具 - 触控配置工具栏 添加, 触控配置工具栏各图标定义如图 所示 本章将逐一介绍各触控 / 键控按钮的使用方法 属性设置等 按钮状态返回转动调节 GBK 录入按钮增量调节数据录入 按钮键值返回 拖动调节 ASCII 录入 弹出菜单 参数配置 时钟设置 图 触控配置工具栏 表 触控 / 键控汇总表 序号功能说明 1 按钮 按钮 与 按钮键值返回 是两种基本按钮控件, 都可以实现切换页面 2 按钮键值返回 按钮 不能返回键值, 常用于下文提到的 弹出菜单 数据 ASCII 与 GBK 录入 按钮键值返回 可以返回键值, 按键按下后可以通过串口以 0x83 指令形式把键值发送 3 按钮状态返回 给用户单片机 按钮状态返回 可以返回按钮的三种按压状态 按下 长按 抬起 4 弹出菜单利用 按钮 控件, 实现典型的弹出菜单 下拉菜单功能 先要利用 按钮 控件制作录入键盘 5 数据录入 ASCII 录入 GBK 录入 RTC 设置 数据录入支持录入整数 定点小数等各种数据到指定变量存储空间 文本方式录入各种字符, 录入过程支持光标移动 编辑 ; 直接支持 ASCII 字符 GBK 中文 繁体注音输入法录入 ; 修改字库和 0 号字库可以支持所有类似 ASCII 字符的 8bit 编码文本录入 RTC 设置需要完整录入公历年月日时分秒 6 增量调节 点击按钮, 对指定变量进行 +/- 操作, 可设置步长和上下限 设置 0-1 范围循环调节可以实现栏目复选框功能 7 拖动调节拖拉滑块实现变量数据录入, 可设置刻度范围 8 转动调节转动旋钮实现变量数据录入, 可设置刻度范围 9 硬件参数配置 提供了触摸屏改写寄存器空间的方法, 来间接控制硬件 比如把背光寄存器内容读取到变量, 调节变量后再回写来调节背光亮度

52 点击触摸屏, 把指定 VP 区域的数据发送到用户串口 (COM1) 触摸控件的典型属性触摸控件的典型属性如图 所示, 控件属性分为区域范围设置 按钮属性 变量属性和控件属性四大类 区域范围设置 按钮属性和变量属性对所有控件都是类似, 而控件属性对不同触摸控件可能完全不同 X/Y 坐标指定按钮左上角位置, 宽度 / 高度指定按钮大小 都可以直接在工作区拖动调整或者点击属性框修改 选定一张图片, 在该图片上设计另外一种按钮颜色, 当按钮按下后按钮自动变化颜色, 体现按钮按下效果 选定一张图片, 当按钮抬起后显示自动切换到该页面 提供了额外的两种按钮触发方式 : 一种是通过串口屏外接键盘触发, 一种是通过 4F 寄存器 以 0x80 指令触发 选定一个音频文件, 当按钮按下后自动播放该文件, 实现按键伴音 双字节的按钮编号 勾选后, 按钮抬起后键值会自动通过 0x83 指令发送给用户单片机 图 按钮区域范围设置属性区域范围设置用于设置按钮的大小和位置 按钮属性用于设置按钮按下反色显示效果 按钮按下后页面切换到那张图片显示 以及按钮按下播放哪个音频文件 变量属性用于设置变量存储地址 键值 以及按钮按下后是否发送键值等 学习触摸控件的用法, 务必了解清楚变量存储地址的作用和用法 以及控件属性的功能 变量存储单元用于存储键值, 键值是双字节的按钮编号 在把键值保存到变量存储单元之前, 先要把键值按照变量模式调整,0x83 指令发送的键值也是调整之后的 勾选数据自动上传, 按钮抬起后键值会自动通过 0x83 指令发送给用户单片机 触摸控件的区域范围设置 按钮属性 变量属性用法基本一样, 后续不再赘述 鼠标点击指定属性, 在属性设置窗口下方会显示关于该属性的详细介绍 按钮的基本触发方式按钮的基本触发方式是通过点击触摸屏按钮的有效区域 ( 由 X/Y 坐标和宽度 / 高度设置 ) 此外通过按键键码可以提供额外的两种按钮触发方式 : 一种是通过串口屏外接键盘触发 ( 见本文附 1), 一种是通过 4F 寄存器 以 0x80 指令方式触发 ( 通常以弹出菜单方式用于设备状态报警显示 或者通过用户单片机主板键盘触发 ) 注意区分按钮键码与键值 键码是用来触发按钮的 ; 键值是指按钮按下后, 通过串口发送给用户单片机的按钮编号

53 5.1 基本按钮 VGUS 屏设置有三种基本按钮控件 : 按钮 按钮键值返回 按钮状态返回, 三者之间各有异同 三种按钮都可以实现页面切换功能, 但是 按钮 不能返回键值, 按钮键值返回 可以返回键值, 按钮状态返回 可以返回按钮的三种按压状态 : 按下 持续按下和抬起 按钮按钮可以实现基本的页面切换, 但不能通过串口返回键值, 因为按钮没有分配变量存储地址 按钮一般用于弹出菜单和键盘录入 以及不需要返回按钮键值的场合 第一步 : 准备 2 张按钮的图片素材, 坐标位置重叠 一张是正常显示效果, 一张是按下显示效果 第二步 : 添加按钮并设置属性 图 按钮效果图片素材 双字节的按钮编号, 用于弹出菜单和键盘录入 用于弹出菜单中的按钮时高字节必须为 0, 范围 0000~00FF, 其中 00FF 表示不返回键值 ; 用于键盘录入时, 点击 "..." 正确设置键值 图 按钮属性设置区域范围设置 按钮属性的用法参见图 变量属性只有一栏键值, 没有分配变量存储地址, 因此不能通过 0x83 指令返回键值 ; 在 弹出菜单 控件中, 弹出窗口中设计的 按钮 控件, 会利用弹出菜单控件的变量存储地址来存储 按钮 控件键值, 同时也能实现通过 0x83 指令返回键值

54 5.1.2 按钮键值返回 相对 按钮 控件而言, 按钮键值返回 控件多出了键值自动上传功能 当按键抬起后, 可以通过 串口以 0x83 指令把键值发送给用户单片机 按钮键值返回属性设置如图 所示 字地址, 范围 0000~FFFF, 用于存储键值, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 按钮抬起后相应键值会保存到该单元中 通常把所有按钮都分配相同的变量存储地址, 通过键值来区分按钮 使用 0x83 指令发送键值时会使用该地址 图 按钮键值返回属性设置 图 按钮键值返回举例例如, 在图 串口通讯 位置添加有按钮键值返回按钮, 属性设置如图 5-1-3, 当点击 串口通讯 按钮后, 串口返回指令 :A5 5A 说明 :A5 5A: 帧头 06: 指令字节长度, 共 6 字节 ( 不含帧头 ) 83: 读变量存储器指令 00 00: 变量存储器地址 01: 数据字长度,02 22 共 1 字长 02 22: 数据内容, 设置的键值 按钮状态返回 持续按下触摸按钮后, 如图 所示, 分为三个状态 : 第一次按压状态 持续按压状态和抬起状态 在有些应用场合用户单片机可能需要识别这些状态, 可以通过按钮状态返回控件实现 图 按钮持续按压的三种状态

55 相对 按钮键值返回 控件而言, 按钮状态返回 控件可以返回按钮按下的三种状态, 并且返回值 用户可以灵活自定义 按钮状态返回按钮属性如图 所示, 分别定义了三种状态下的按压模式 S 变 量存储地址 S 变量数据长度 S 变量初始值 T 变量存储地址 T 变量初始值 定义按下属性 见表 S 变量与 T 变量的长度 定义持续按下属性 定义抬起属性 图 按钮状态返回属性设置 表 按压模式 按压模式 0x00 说明 不做任何处理 0x01 读取 S 地址处的指定长度数据写到 T 地址里 ( 数据长度必须为偶数字节 ) 0x02 把 S 变量数据通过串口发送给用户单片机 0x03 读取 S 地址处的指定长度数据写到 T 地址对应的寄存器里 (T 地址高字节必须为 0x00) 当把按压模式都设置为 0x02 时, 三种状态下串口屏都会将各自的 S 变量数据通过串口发送出去 ; 其中持续按压状态下, 每一个 VGUS 刷新周期 ( 约 100 毫秒 ) 都会重复发送一次 向 S 变量中写入特定的初始值, 用户单片机根据接收到的数据, 就可以识别出持续按钮的各个状态 需要注意的是, 在把 S 变量数据通过串口发送的时候, 是不加帧头的, 为了统一指令格式, 可以把帧头信息放到 S 变量里面 例如 S 变量地址是 0x0110 长度为 2 个字节 初始值是 0x6666, 那可以把 S 变量长度设置为 9 个字节, 初始值设置为 a5 5a , 这样用户单片机接收到的数据就符合统一指令格式 0x01 0x03 两种按压模式使用较少

56 5.2 弹出菜单利用 按钮 控件, 实现典型的弹出菜单 下拉菜单设计 点击 弹出菜单 按钮后会弹出一个新窗口, 新窗口上可以设计 按钮 控件, 按钮键值可以通过弹出菜单的变量存储地址返回 点击弹出菜单窗口上面任意一个按钮, 弹出窗口会自动消失 下拉菜单也可以使用本控件设计 第一步 : 在弹出菜单窗口上添加按钮并设置键值首先要把弹出菜单窗口保存成一张图片 然后在该弹出菜单窗口有效区域里, 添加需要的按钮 ( 见 节内容 ) 并设置好按钮键值 ( 取值范围 0000 到 00fe,00ff 专用于取消按钮 ) 弹出菜单上的按钮必须设置键值 图 在弹出菜单窗口上添加按钮弹出菜单窗口上设计了 2 个按钮, 一个 OK 按钮和一个取消按钮 OK 按钮的键值设置为 0001, 取消按钮的键值设置为 00ff 当弹出菜单窗口弹出后, 点击上面任意一个按钮, 弹出窗口会自动消失 当点击 OK 按钮时, 按钮键值 0001 会写入弹出菜单变量单元里, 变量单元地址见 弹出菜单按钮属性设置, 键值也可以通过串口指令 0x83 发送给用户单片机 取消按钮键值设置为 0x00ff, 点击取消按钮后不会把键值写入变量单元里, 也不会通过 0x83 指令发送键值给用户单片机 第二步 : 添加弹出菜单按钮并设置属性 图 添加弹出菜单按钮 上图为添加一个弹出菜单按钮 一般来讲, 弹出菜单是用于系统报警提示用, 不会通过按钮来触发的

57 所以实际使用中, 通常会把该图中的弹出菜单按钮隐藏起来 ( 触摸区域做的很小 放到角落位置 并且不 要在背景图片上体现按钮 ), 设置按键键码 通过 0x80 指令写 4F 寄存器来触发 字地址, 范围 0000~FFFF, 用于存储键值, 占用一个单元 ( 字地址一个单元包含 2 个字节 ) 弹出菜单页面上的按钮抬起后, 相应按钮键值会保存到该单元中 使用 0x83 指令上传键值时会使用该地址 选择弹出菜单所在的页面, 并拖动选 择弹出菜单窗口区域 选择弹出菜单在当前页面上的显示 位置 ( 窗口左上角坐标 ) 图 弹出菜单按钮属性设置 图 弹出菜单执行效果例如 : 设置 弹出菜单 变量存储地址为 0200, 在弹出菜单页面上添加 OK 按钮的键值为 0001 点击 弹出菜单 按钮会弹出菜单窗口, 点击菜单上的 OK 按钮, 会将按钮的键值 0001 返回到地址 0200 单元里, 弹出菜单窗口消失, 串口返回指令 : A5 5A 说明 :A5 5A: 帧头 06: 指令字节长度, 共 6 字节 ( 不含帧头 ) 83: 读变量存储器指令 02 00: 变量地址, 在弹出菜单控件属性中设置 01: 数据字长度,00 01 共 1 字长 00 01: 数据内容, 设置的按钮键值 00 01

58 5.3 键盘录入 VGUS4.3 支持数据录入 英文录入 中文全拼录入 时钟设置等 在使用录入控件之前, 必须先制作满足功能需要的录入键盘 制作键盘第一步 : 准备素材 键盘有效区域分为两个部分 : 录入过程中的文本显示窗口 和按钮区域 把所有需要用到的按钮做成图片, 按照实际使用的效果排列好 一张正常显示的图片, 一张按钮按下时显示的图片 录入过程中的文本显示窗口 键盘有效区域 图 数字小键盘素材第二步 : 添加按钮并设置键值 参照 节内容, 添加上图中的 15 个按钮并设置好属性 此处按钮键值不能任意写入数字, 必须首先将鼠标指向键值属性并点击, 键值属性右侧会出现图标, 点击该图标展开键值选择窗口, 根据每个按键的实际功能做相应选择, 选择后系统会自动正确提供该按钮的键值 图 数字键盘按钮 1 的键值设置过程

59 5.3.2 数据录入 点击 数据录入 按钮后, 会弹出录入键盘实现数据录入的功能 在学习数据录入之前, 需要先掌握 数据变量显示一节的内容 (4.1.1 节 ) 左方文本框是需要 录入的变量 点击文本框后 调出键盘 569 点击 OK 按钮后键盘消失, 录入的数字显 示在文本框中, 同时可以通过串口发送给 用户单片机 图 数据录入应用举例 上面三张图片介绍了我们将要实现的数据录入功能 为了实现上述功能, 我们需要在文本框位置添加 两个控件 : 一个是数据变量显示控件, 一个是数据录入控件 黄色区域为 数据录入控件 中间区域为 数据变量显示控件 图 数据录入控件设计 数据变量显示控件属性设置参见 节, 数据变量录入控件如图 所示

60 字地址, 范围 0000~FFFF, 用于存储录入数据, 长度由变量类型设定 ( 字地址一个单元包含 2 个字节 ) 使用 0x83 指令上传录入数据时会使用该地址 选择录入键盘所在的页面, 并拖动选择键盘有效区域, 以及键盘在当前页面上的显示位置 ( 左上角坐标 ) 定义数据格式, 数据写入变量存储单元前, 会按照数据格式化整 VGUS 屏中没有实际意义的小数, 实际存储都是整数形式的, 小数只是整数中按照指定位置加小数点 比如 10.1, 实际存储 串口通讯都处理为 0x0065( 十进制为 101), 而显示的时候根据小数位数为 1 显示为 10.1 设置录入过程中文本显示窗口位置 和数字显示格式 指录入过程中的数据显示窗口位置 ( 如图 5-3-1) 一般会把录入过程显示框与键盘做在一起, 所以需要先设置键盘属性, 然后才能看到键盘显示框位置, 点击拖动选取 图 数据录入按钮属性设置按钮属性栏里面有个变量 反色显示属性, 勾选后, 将对相应的存储单元内变量反色显示 一般用于页面上有多个录入变量时, 用此功能将当前录入的变量反色显示, 以示区分 如图 所示, 如希望录入完成后, 把录入的数据直接显示在文本框中, 需要要图 中的数据变量控件和数据录入控件设置相同的变量存储地址 例如, 按照图 设置属性, 设置录入数据整数位数为 4 位, 点击 数据录入 按钮输入 1234, 点击 OK, 串口返回指令 : A5 5A D2 说明 :A5 5A: 帧头 06: 指令字节长度, D2 共 6 字节 ( 不含帧头 ) 83: 读变量存储器指令 00 20: 变量地址, 在控件属性中设置 01: 数据字长度,04 D2 共 1 字长 04 D2: 数据内容,1234 的十六进制数据

61 5.3.3 英文 ASCII 录入 点击 ASCII 录入 按钮后, 会弹出录入键盘实现 ASCII 码字符录入 在学习 ASCII 录入之前, 需要 先掌握文本变量显示一节的内容 (4.1.2 节 ) 图 ASCII 录入举例 字地址, 范围 0000~FFFF, 用于存储录入的 ASCII 码字符, 长度由字节长度设定 ( 字地址一个单元包含 2 个字节 ), 实际占用地址单元个数 = 字长度 +2( 一个单元的输入状态和一个单元的结束符 ) 使用 0x83 指令上传录入文本会使用该地址 勾选表示要返回状态, 状态信息参见备注 1, 不勾选表示不返回 设定录入 ASCII 码字符串的长度, 范围 1-123,2 个 ASCII 码字符占用一个字 字符保存到指定地址时, 自动在字符串结束位置加上 0xFFFF 作为结束符, 输入结束上传到串口的数据也会加上 0xFFFF 结束符会占用一个变量存储单元, 分配变量存储地址时需要注意, 其它变量不能占用该单元地址 指录入过程中的文本显示窗口位置 一般会把录入过程显示框与键盘做在一起, 所以需要先设置下面的键盘属性, 然后才能看到键盘显示框位置, 点击拖动选取 设置录入过程中的文本显示位置和 显示格式 图 ASCII 录入按钮属性设置备注 1: 勾选输入状态返回后, 串口屏将把当前录入状态 (0x00 为录入中 0x5a 为录入结束 ) 和录入的有效数据长度 ( 单位为字节 ) 写在变量存储地址的前一个单元里 用户可以用 0x83 指令去读取录入状态和有效数据长度 例如上例中, 变量存储地址是 0x0100, 因此会占用 0x00ff 单元, 其中高字节用于存储录入状态 低字节用于存储录入的有效数据长度 在该例中因为占用了 0x00ff 单元, 所以其它变量不能再使用 ASCII 录入实际占用的变量存储单元 = 字长度 +2 额外占用的 2 个单元一个在变量存储位置前 ( 状态返回 ) 一个在变量存储位置后( 结束符 ) 在分配变量单元地址时要注意, 其它变量地址不能重叠

62 5.3.4 中文 GBK 录入点击 GBK 录入 按钮后, 会弹出录入键盘实现中英文字符录入 在学习之前, 需要先掌握文本变量显示 (4.1.2 节 ) 首先我们看一款经典中文全拼录入键盘的界面设计 拼音窗口上部显示录入的拼音 下部显示检索到的汉字, 文本窗口显示已经录入的汉字 拼音窗口与文本窗口中的汉字都必须使用 GBK 字库, 需要在属性窗口分别设置字库 点阵大小等显示格式 在 GBK 录入过程中, 可以用 enter 健直接把拼音转为字母录入, 实现 ASCII 码录入 拼音窗口和文本窗口中用到的 ASCII 码字符一律默认使用 0 号字库, 点阵大小与中文 GBK 字库一致 字地址, 范围 0000~FFFF, 用于存储录入中英文字符, 长度由字符串长度设定 ( 字地址一个单元包含 2 个字节 ), 实际占用地址单元个数 = 字长度 +2( 一个单元的输入状态和一个单元的结束符 ) 使用 0x83 指令上传录入文本时会使用该地址 勾选表示要返回状态, 状态信息参见备注 1, 不勾选这表示不返回 图 GBK 录入键盘举例 设定录入字符串的长度, 范围 1-123, 1 个汉字占用 1 个字 2 个 ASCII 码占用 1 个字 文本保存到指定地址时, 自动在字符串结束位置加上 0xFFFF 作为结束符, 输入结束上传到串口的数据也会加上 0xFFFF 结束符会占用一个变量存储单元, 分配变量存储地址时需要注意, 其它变量不能占用该单元地址 设置文本窗口的显示位置 显示格 式 必须先设置键盘属性 设置文本窗口汉字显示的字库 点阵 大小和颜色, 字库必须是 GBK 字库 ASCII 字母默认用 0 号字库 设置拼音窗口显示位置 显示格式 必须先设置键盘属性 设置拼音窗口中拼音字母与检索到的汉字排列关系 设置拼音窗口汉字显示的字库 点阵 大小和颜色, 字库必须是 GBK 字库 ASCII 字母默认用 0 号字库 图 GBK 录入按钮属性设置

63 备注 1: 与 ASCII 录入一样, 勾选输入状态返回后, 串口屏将把当前录入状态 (0x00 为录入中 0x5a 为录入结束 ) 和录入的有效数据长度 ( 单位为字节 ) 写在变量存储地址的前一个单元里 用户可以用 0x83 指令去读取录入状态和有效数据长度 例如上例中, 变量存储地址是 0x0180, 因此会占用 0x017f 单元, 其中高字节用于存储录入状态 低字节用于存储录入的有效数据长度 在该例中因为占用了 0x017f 单元, 所以其它变量不能再使用 与 ASCII 录入一样,GBK 录入实际占用的变量存储单元 = 字长度 +2 额外占用的 2 个单元一个在变量存储位置前 ( 状态返回 ) 一个在变量存储位置后( 结束符 ) 在分配变量单元地址时要注意, 其它变量不能再占用 图 GBK 录入举例例如 : 点击 GBK 录入 按钮输入 武汉中显, 点击 Enter 按钮, 串口返回指令 : A5 5A 0E CE E4 BA BA D6 D0 CF D4 FF FF 说明 :A5 5A: 帧头 0E: 指令字节长度, CE E4 BA BA D6 D0 CF D4 FF FF 共 14 字节 ( 不含帧头 ) 83: 读变量存储器指令 01 40: 变量地址, 在控件属性中设置 05: 数据字长度,CE E4 BA BA D6 D0 CF D4 FF FF 共 5 字长 CE E4 BA BA D6 D0 CF D4 FF FF: 数据内容, 武汉中显 的汉字内码 CE E4 BA BA D6 D0 CF D4, 最后 2 字节 FF FF 是录入结束的标志位, 文本录入及 ASCII 录入时有结束标志位 注 : 中显预装的 0# 字库包含 4*8-64*128 点阵的所有 ASCII 字符 不使用触摸屏, 使用键盘 (0x4F 寄存器保存的键码 ) 来做 GBK 录入时, 必须用 0x01-0x08 键码来选择对应的汉字

64 5.3.5 时钟设置点击时钟设置按钮, 会弹出录入键盘完成时间设置, 设置的时间会自动保存到 0x20-0x26 寄存器中 时钟设置按钮仅用于有 RTC 功能的串口屏, 也就是针对文本时钟和表盘时钟控件, 用于校准年月日 时分秒 由于 时钟设置 控件没有分配变量存储地址, 因此不能通过 0x83 指令返回设置时间 ; 设置时间是直接写入了 0x20-0x26 寄存器中, 因此是通过 0x81 指令返回设置时间 时钟设置控件属性与数据录入基本一样, 如图 图 时钟设置按钮属性 图 时钟设置举例例如 : 启动时钟设置按钮后, 输入时间 :09:00, 串口返回指令 : A5 5A 0A 说明 :A5 5A: 帧头 0A: 指令字节长度, 共 10 字节 ( 不含帧头 ) 81: 读寄存器指令 20: 控制 RTC 的寄存器地址 07: 数据字节长度, 共 7 字节长 : 时间变量的 BCD 码

65 5.4 调节控件 增量调节 点击增量调节按钮, 可以将指定变量 按照指定步长增加或者减小 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 增量调节按钮每按下一次, 该变量会按照指定步长变化一次 使用 0x83 指令上传变量时会使用该地址 变量值增加或减少超过设定的上下限的值时, 继续按按钮将会停止调节, 也可以选择循环调节 按照指定调整方式, 把变量值保存到变量存储单元 0x83 指令发送的变量值也是调整之后的 按下按钮后变量增加 (++) 或减小 (--) 一个调节步长的值 长按按钮下, 可以选择连续调节 ( 按钮按下 0.5S 后, 每个刷新周期调节一次 ) 或者单次调节 图 增量调节按钮属性设置 图 增量调节举例如图 左图, 点击左箭头文本框数据减小, 点击右箭头文本框数据增大 为实现上述增量调节功能, 如上图右侧, 需要设计两个增量调节按钮 一个数据变量显示 左箭头设置为 右箭头设置为 + +, 为了能让增量调节后的值能够显示在中间的数据变量位置, 图中的 2 个调节按钮和数据变量必须定义相同的变量存储地址 例如图 5-4-2, 右箭头增量调节按钮属性设置如图 所示, 连续点击右箭头按钮, 串口返回指令 : A5 5A f A5 5A f A5 5A f 说明 :A5 5A: 帧头 06: 指令字节长度,83 6f 共 6 字节 ( 不含帧头 ) 83: 读变量存储器指令 6f 01: 变量地址, 在控件属性中设置 01: 数据字长度,00 01 共 1 字长 00 01: 数据内容, 从设置的下限变化到上限, 即从 连续变化到 当把属性中下限和上限分别设置为 0 和 1 时, 遇限处理方式设置为循环调节, 配合变量图标显示, 可以方便的设计出栏目复选框功能 ( 点击一下选中, 再点击取消 ) 当把属性设置中的下限和上限都设置为 0, 遇限处理方式设置为停止, 可以用于实现连续按键识别 按键按下 0.5 秒后, 每个 VGUS 刷新周期 ( 约 100 毫秒 ) 都会发出串口数据

66 5.4.2 拖动调节 按下并移动 拖动调节 按钮, 可以将指定变量 按照设定的范围自动变化 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 按下拖动调节按钮后, 系统会根据拖动调节按钮的当前位置自动计算变量值 ( 根据起始值和终止值进行插值运算 ) 使用 0x83 指令上传变量时会使用该地址 拖动范围的起始位置对应的变量值 拖动范围的终止位置对应的变量值 图 拖动调节属性设置 图 拖动调节举例如图 左图, 点击并拖动人形滑块, 人形滑块会跟随移动, 同时上方文本框数值会跟随变化 为实现上述典型的拖动功能, 如上图右侧, 需要设计一个数据变量 一个拖动调节按钮 一个滑块刻度显示控件, 并且三者必须定义相同的变量存储地址 例如, 如图 设计, 拖动调节属性设置如图 5-4-3, 拖动 拖动调节 按钮, 串口返回指令 : A5 5A A5 5A E8 说明 :A5 5A: 帧头 06: 指令字节长度, 共 6 字节 ( 不含帧头 ) 83: 读变量存储器指令 01 80: 变量地址, 在控件属性中设置 01: 数据字长度,00 00 共 1 字长 00 01: 数据内容, 从设置的起始值变化到终止值, 即从 连续变化到 03 E8 拖动录入的优点是直接 快捷, 而且参数不会越界 拖动调节不支持按键控制 ( 不支持外接键盘和 4F 寄存器 ) 为防止误操作, 拖动调节须按压有效拖动区域超过 0.5 秒后拖动才启动

67 5.4.3 转动调节和 拖动调节 按钮类似, 按下并移动 转动调节 按钮, 可以将指定变量 按照设定的范围自动变化 转动调节不支持按键控制 ( 不支持外接键盘和 4F 寄存器 ) 转动调节始终假定为顺时针转动 定义按钮位置 大小, 以及环形调节区域 按钮必须包含转动调节环形区域 定义转动调节环形区域 字地址, 范围 0000~FFFF, 用于存储变量, 长度为一个单元 ( 字地址一个单元包含 2 个字节 ) 按下转动调节按钮后, 系统会根据转动调节按钮的当前位置自动计算变量值 ( 根据起始值和终止值进行插值运算 ) 使用 0x83 指令上传变量时会使用该地址 调节区域起始角度 0-719, 单位为 0.5 o 调节区域终止角度 1-720, 单位为 0.5 o 终止角度对应的返回值, 整数 起始角度对应的返回值, 整数 图 转动调节按钮属性设置 图 转动调节区域示意图 硬件参数配置常用于把变量存储器内的数据写入寄存器里, 或者把寄存器内的数据写入变量存储器里 在变量存储器区开辟了一块特殊区域 0x6F00-0x6FFF, 共 256 个单元 ( 仅仅使用低字节 ), 这 256 个单元与寄存器区单元 (0x00-0xff) 一一对应

68 四种操作模式, 具体功能请参照表 图 硬件参数配置按钮属性设置 表 硬件参数配置按钮操作模式 模式 Data_Pack Data_Pack 说明功能 0 无无 把 256 字节寄存器区数据复制到到变量存储器单元 0x6F00-0x6FFF( 占据低 字节 ) VGUS 屏上自动把寄存器区数据复制到 0x6F00-0x6FFF 单元 1 无无把变量存储器单元 0x6F00-0x6FFF( 占据低字节 ) 数据复制到寄存器区 3 *VP 数据指针 把 *VP 指针位置开始的,Tx_Len 字节长度的数据发送到用户串口 Tx_Len Tx_LEN 要发送的数据长度 是双字节变量, 长度从 0x0001-0xFFFF 5 Tran_Area 将要转换的区域坐标 : 左上角 右下角 保存转换位图数据的 *VP 缓冲区首地址 Frame_End 帧尾 ( 两字节 ) 将指定区域的内容转换成单色位图 ( 横向取模打印位图格式 ), 并保存到 VP 指针指向的数据存储器 1. 区域宽度 (Xe-Xs+1) 必须是 16 的倍数 ; 2.*VP 指针保存数据格式如下 : *VP: 状态位, 处理完成后设置成 0x5555; *VP+1: 横向字长度 =(Xe-Xs+1)&0xFFF0/16; *VP+2: 数据段个数 =(Ye-Ys+1); *VP+3: 位图数据开始,MSB 方式 如果启用了 参数自动上传功能 (R2.3=1), 那么转换完成后, 会按照 *VP 内容被修改成 0x5555 而自动上传一条提示信息 本指令主要用于屏幕内容的打印输出 图 硬件参数配置举例 在增量调节图 的例子中, 已经有用到上图例子, 通过左右键增量调节按钮我们可以修改文本框中的亮度值 如图 中, 再在右下角添加一个硬件参数配置按钮 OK, 就可以直接用文本框中的数值去控制液晶屏的亮度, 硬件参数配置按钮属性如图 为实现上述功能, 必须将增量调节按钮 数据变量的变量存储器地址都设置为 0x6F01, 正好对应亮度设置寄存器 0x01, 硬件参数配置按钮设置为模式 1 当硬件参数配置按钮按下后, 变量存储器 0x6F00-0x6FFF 单元里的数据 ( 仅低字节 ) 会复制到寄存器区, 其中 0x6F01 单元里的亮度值正好对应写入亮度寄存器 0x01 单元, 屏幕亮度跟随变化 如果工程中用到硬件参数配置按钮, 则所有变量地址必须避开 0x6F00-0x6FFF 区域

69 6 描述指针 对于简单应用场合, 用户无需了解本章知识 6.1 描述指针介绍 VGUS 屏采用变量驱动, 所有显示的字符 图标等都定义为一个变量, 并分配变量存储地址 定义显示格式, 然后生成配置文件并下载到显示终端上 在需要刷新显示时, 用户仅需将变量内容和变量存储地址通过串口对应发送到显示终端, 显示终端会自动按照定义好的显示格式显示 对于每个变量来讲, 其显示格式是固定的, 是由下载到 VGUS 屏中的配置文件定义的 当用户需要临时修改变量显示格式时, 可以通过本章介绍的描述指针实现 用户在定义每个变量的时候, 需要设置是否启用描述指针, 如图 6-1 所示 图 6-1 设置数据变量显示属性如图描述指针一栏填写 FFFF 表示当前变量禁止描述指针功能 如果填写的是其它数据 (0000-FFFE 中任意一个 ) 表示当前变量启用描述指针, 并且填写的数据用来指定变量存储器地址, 以该地址为起始单元, 在变量存储器内连续开辟了一块空间 ( 不同的变量类型, 块长度以及数据格式也都不同, 每种变量本章都有详细表格定义了对应数据格式 ), 用于存储变量的显示格式 用户可以通过变量存储器地址, 利用 0x82 指令去动态修改变量显示格式 因为最长的变量属性长度为 32bytes(16Words), 为了避免出现不同变量的描述指针重叠, 建议一律按照最长的变量属性 16word 分配描述指针地址 例如第一个变量描述指针地址为 0x0100, 则第二个变量描述指针地址设置为 0x0110, 这样就可以确保不同变量的描述指针地址不会出现重叠 每一个显示变量的属性都可以通过描述指针来读写 描述指针地址范围 0x0000-0xFFFE, 与用户变量共用变量存储器区, 因此用户定义的变量存储地址不能与描述指针的地址重叠

70 6.2 描述指针应用举例本节以改变一个数据变量的显示颜色为例, 介绍描述指针的简单应用 1 新建工程添加图片后, 在界面上添加一个数据变量显示控件, 设置描述指针为 4000, 变量存储地址为 如图 所示 ; 2 查看关于数据变量描述指针的说明 ; 图 添加数据变量 表 数据变量描述指针数据格式地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 变量指针 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x03 Color 2 显示颜色 0x04:H Lib_ID 1 ASCII 字库位置 0x04:L 字体大小 1 字符 X 方向的点阵数 0x05:H 对齐方式 1 0x00= 左对齐,0x01= 右对齐,0x02= 居中 0x05:L 整数位数 1 显示的整数位数 ( 整数位数和小数位数之和不能超过 20) 0x06:H 小数位数 1 显示的小数位数 ( 整数位数和小数位数之和不能超过 20) 0x00= 整数 ( 两字节 ): 到 x01= 长整数 (4 字节 ): 到 x02=VP* 高字节 :0 到 255 0x06:L 变量数据 类型 1 0x03=VP* 低字节 :0 到 255 0x04= 超长整数 (8 字节 ): 到 x05= 无符号整数 (2 字节 ):0 到 x06= 无符号长整数 (4 字节 ):0 到 x07:H Len_unit 1 变量单位显示长度,0x00 表示不显示单位 0x07:L String_unit 10 单位字符串,ASCII 编码

71 从图中可以看到, 颜色对应的偏移量为 03, 那么颜色属性对应的变量存储器地址为 0x =0x4003 通过 0x82 指令修改 0x4003 单元内的数据即改变了数据变量的显示颜色 例如串口发送 :A5 5A F8 00 那么就设置数据变量显示为红色 (0xF800 为红色 ) 本例中使用按钮键值返回控件, 按下按钮时, 直接将键值作为对应颜色值写入变量存储器 0x4003 单元 按键返回控件属性设置如图 所示 图 按键返回控件属性设置

72 6.3 描述指针汇总 表 6-3 描述指针汇总表 编号表 表 表 表 表 表 表 表 表 表 表 表 表 表 表 表 表 名称变量图标动画图标滑动刻度艺术字变量动画图片旋转图标位变量图标数据变量文本变量文本时钟表盘时钟时钟变量滚动文本实时曲线基本图形列表显示二维码 表 变量图标描述指针定义 地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 变量指针, 变量为整数格式 0x01 X,Y 4 变量显示位置, 图标左上角坐标位置 0x03 V_Min 2 变量下限, 越界不显示 0x04 V_Max 2 变量上限, 越界不显示 0x05 Icon_Min 2 V_Min 对应的图标 ID 0x06 Icon_Max 1 V_Max 对应的图标 ID 0x07:H Icon_Lib 1 图标库存储位置 0x07:L Mode 1 ICON 显示模式 0x00= 透明 ( 不显示背景 ), 其他 = 显示图标背景 表 动画图标描述指针定义 地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 初始图标变量指针, 变量为双字, 低位字保留, 高位字无符号数 0x01 x,y 4 变量显示位置, 图标左上角坐标位置 0x03 0x 固定 0x04 V_Stop 2 变量为该值时固定

73 0x05 V_Start 2 变量为该值时自动显示动画图标 0x06 Icon_Stop 2 变量为 V_Stop 时固定显示的图标 0x07 Icon_Start 2 0x08 Icon_End 2 变量为 V_Start 值时, 自动从 Icon_ Start 到 Icon_ End 显示图标, 形成动画 0x09:H Icon_Lib 1 图标库存储位置 0x09:L Mode 1 ICON 显示模式 0x00= 透明 表 滑动刻度描述指针定义 地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 变量指针, 变量格式由 VP_DATA_Mode 来决定 0x01 V_begain 2 对应起始变量刻度值 0x02 V_end 2 对应终止变量刻度值 0x03 X_ begain 2 起始刻度坐标 ( 纵向为 Y 坐标 ) 0x04 X_ end 2 终止刻度坐标 ( 纵向为 Y 坐标 ) 0x05 Icon_ ID 2 滑动刻度块的图标 ID 0x06 Y 2 刻度指示图标显示的 Y 坐标值 0x07:H X_adj 1 刻度指示图标显示的 X 坐标前移偏移量 0x07:L Mode 1 刻度模式 0x00= 横向刻度条, 其他 = 纵向刻度条 0x08:H Icon_Lib 1 图标库存储位置 0x08:L Icon_mode 1 ICON 显示模式 0x00= 透明 ( 不显示背景 ), 其他 = 显示图标背景 0x09:H VP_DATA_Mode 1 0x00=*VP 指向一个整型变量 ; 0x01=*VP 指向一个整型变量高字节数据 ; 0x02=*VP 指向一个整型变量低字节数据 表 艺术字变量 地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 变量指针 0x01 X,Y 4 起始显示位置左对齐模式, 坐标为显示字符串左上角坐标右对齐模式, 坐标为显示字符串的右上角坐标 0x03 Icon0 2 0 对应的 ICON_ID, 排列顺序为 x04:H Icon_Lib 1 图标库存储位置 0x04:L Icon_Mode 1 ICON 显示模式 :0x00= 透明 ( 不显示背景 ) 其他 = 显示图标背景 0x05:H 整数位数 1 显示的整数位数 0x05:L 小数位数 1 显示的小数位数 0x06:H 数据变量类型 1 0x00= 整数 (2 字节 ), 到 x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x05= 无符号整数 (2 字节 )0 到 x06= 无符号长整数 (4 字节 )0 到 x06:L 对齐模式 1 0x00= 左对齐,0x01= 右对齐

74 表 动画图片描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 0x 固定 0x01 Pic_begain 2 起始图标位置 0x02 Pic_end 2 终止图标位置 0x03:H Frame_Time 1 一幅图片显示的时间,8ms 表 旋转图标描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 变量指针, 变量格式由 Mode 决定 0x01 Icon_ID 2 指定图标 ID 0x02 Icon_Xc 2 Icon 图标上的指定旋转中心位置 X 坐标 0x03 Icon_Yc 2 Icon 图标上的指定旋转中心位置 Y 坐标 0x04 Xc 2 Icon 图标显示到当前屏幕的旋转中心位置 X 坐标 0x05 Yc 2 Icon 图标显示到当前屏幕的旋转中心位置 Y 坐标 0x06 V_Begain 2 对应起始旋转角度的变量值, 整型, 越界不显示 0x07 V_End 2 对应终止旋转角度的变量值, 整型, 越界不显示 0x08 AL_Begain 2 起始旋转角度 0-720(0x0000-0x02D0), 单位 0.5 度 0x09 AL_End 2 转动角度 =( 终止角度 - 起始角度 )/( 终止值 - 起始值 )* 输入值 ; 终止旋转角度 0-720(0x0000-0x02D0), 单位 0.5 度 0x00=*VP 指向一个整型变量 ; 0x0A:H VP_Mode 1 0x01=*VP 指向一个整型变量高字节数据 ; 0x0A:L Lib_ID 1 图标库存储位置 0x02=*VP 指向一个整型变量低字节数据 0x0B Mode 1 ICON 显示模式 0x00= 透明 ( 不显示背景 ), 其他 = 显示图标背景 表 位变量图标地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 位变量指针, 字变量 0x01 *VP_AUX 辅助变量指针, 双字, 用户禁用 0x02 Act_Bit_Set 2 为 1 的 bit 值说明 *VP 对应位置需要显示 显示模式定义 : 0x03:H Display_Mode 1 Display_Mode Bit 值 0 1

75 0x00 ICON0S ICON1S 0x01 ICON0S 不显示 0x02 ICON0S ICON1S-ICON1E 动画 0x03 不显示 ICON1S 0x04 不显示 ICON1S-ICON1E 动画 0x05 ICON0S-ICON0E 动画 ICON1S 0x06 ICON0S-ICON0E 动画 不显示 0x07 ICON0S-ICON0E 动画 ICON1S-ICON1E 动画 位图图标排列方式 : 0x00=X++,Act_Bit_Set 指定的不处理 bit 不保留位置 0x03:L Move_mode 1 0x01=Y++,Act_Bit_Set 指定的不处理 bit 不保留位置 0x02=X++,Act_Bit_Set 指定的不处理 bit 保留 Dis_MOV 位置 0x03=Y++,Act_Bit_Set 指定的不处理 bit 保留 Dis_MOV 位置 0x04:H Icon_Mode 1 ICON 显示模式 :0x00= 透明 ( 不显示背景 ) 其他 = 显示图标背景 0x04:L Icon_Lib 1 图标库存储位置 0x05 ICON0S 2 不显示动画模式,bit 0 图标 ID 显示动画模式,bit 0 图标动画起始 ID 位置 0x06 ICON0E 2 显示动画模式,bit 0 图标动画结束 ID 位置 0x07 ICON1S 2 不显示动画模式,bit 1 图标 ID 显示动画模式,bit 1 图标动画起始 ID 位置 0x08 ICON1E 2 显示动画模式,bit 1 图标动画结束 ID 位置 0x09 (x,y) 4 起始变量显示位置, 图标左上角坐标 0x0B Dis_MOV 2 下一个图标坐标移动的间隔 表 数据变量描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 变量指针 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x03 Color 2 显示颜色 0x04:H Lib_ID 1 ASCII 字库位置 0x04:L 字体大小 1 字符 X 方向的点阵数 0x05:H 对齐方式 1 0x00= 左对齐,0x01= 右对齐,0x02= 居中 0x05:L 整数位数 1 显示的整数位数 ( 整数位数和小数位数之和不能超过 20) 0x06:H 小数位数 1 显示的小数位数 ( 整数位数和小数位数之和不能超过 20) 0x06:L 变量数据 类型 1 0x00= 整数 ( 两字节 ): 到 x01= 长整数 (4 字节 ): 到

76 0x02=VP* 高字节 :0 到 255 0x03=VP* 低字节 :0 到 255 0x04= 超长整数 (8 字节 ): 到 x05= 无符号整数 (2 字节 ):0 到 x06= 无符号长整数 (4 字节 ):0 到 x07:H Len_unit 1 变量单位显示长度,0x00 表示不显示单位 0x07:L String_unit 10 单位字符串,ASCII 编码 表 文本变量描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 文本指针 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x03 Color 2 显示文本颜色 0x04 Xs,Ys,Xe,Ye 8 文本框 0x08 Text_Length 2 显示字节数量, 遇到 0xFFFF 数据或者显示到文本框尾则不再显示 0x09:H Font0_ID 1 编码方式为 0x01-0x04 时 ASCII 字库位置 0x09:L Font1_ID 1 编码方式为 0x00 0x05, 以及 0x01-ox04 的非 ASCII 字符使用的字库位置 0x0A:H Font_X_Dots 1 字体 X 方向点阵数,0x01-0x04 模式时 ASCII 字符 X 按照 Y/2 计算 0x0A:L Font_Y_Dots 1 字体 Y 方向点阵数, 字库中 Y 方向的点阵数必须为偶数.7 定义了文本显示字符间距是否自动调整 :.7=0 字符间距自动调整 0x0B:H Encode_Mode 1.7=1 字符间距不自动调整, 字符宽度为固定设定的点阵数.6-.0 定义了文本的编码方式 : 0x00=8bit 编码,0x01=GB2312 内码,0x02=GBK,0x03=BIG5,0x04=SJIS, 0x05=UNICODE 0x0B:L HOR_Dis 1 字符水平间距 0x0C:H VER_Dis 1 字符垂直间距 0x0C:L 未定义 1 写 0x00 表 文本时钟描述指针定义地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 0x x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x03 Color 2 字体颜色

77 0x04:H Lib_ID 1 字库位置 0x04:L 字体大小 1 X 方向的点阵数 编码字符串, 使用 RTC 编码表和 ASCII 字符组成 0x05 String_Code Max14 假设当前时间 :00:00 星期三 Y_M_D H:Q:S 0x00 将显示为 :00:00 M_D W H:Q 0x00 将显示为 WEN 12:00 RTC 编码表说明 编码 显示格式 公历 _ 年 Y 公历 _ 月 M 公历 _ 日 D 公历 _ 小时 H 公历 _ 分钟 Q 公历 _ 秒 S 公历 _ 星期 W SUN MON TUE WED THU FRI SAT 编码结束 0x00 表 表盘时钟描述指针定义地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 0x x01 X,Y 4 时钟表盘的指针中心 0x03 Icon_Hour 2 时针 ICON 的 ID,0xFFFF 表示时针不显示 0x04 Icon_Hour_cen tral 4 时针 ICON 的旋转中心位置 0x06 Icon_Minute 2 分针 ICON 的 ID,0xFFFF 表示分针不显示 0x07 Icon_Minute_ central 4 分针 ICON 的旋转中心位置 0x09 Icon_Second 2 秒针 ICON 的 ID,0xFFFF 表示秒钟指针不显示 0x0A Icon_Second_ central 4 秒针 ICON 的旋转中心位置 0x0C:H ICON_Lib 1 指针图标所在的 ICON 库文件 ID 未定义 1 写 0x00 表 变量时钟描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明

78 0x00 *VP 2 变量指针数据串首地址, 变量为 BCD 编码 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x03 Color 2 字体颜色 0x04:H Byte_Num 1 *VP 指针高字节开始显示的数目,0x01-0x0F 0x04:L Lib_ID 1 字库位置, 必须是半角字库, 如果 Lib_ID 不为 0, 则必须用 8bit 编码 0x05:H Font_X 1 X 方向点阵数目 编码字符串, 用来和时间变量组合出客户需要的显示格式, 每显示一个 BCD 编 码后, 会从编码字符串中顺序的取出一个 ASCII 字符来间隔显示 0x05:L String_Code Max13 编码字符串中特殊编码定义 : 0x00: 无效, 不显示字符, 两个 BCD 编码连在一起 0x0D: 换行显示 即 X=Xs,Y=Y+Font_X*2 表 滚动文本描述指针定义地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 文本指针 0x00 *VP 2 文本指针前 3 个字必须保留, 用户显示文本内容从 (VP+3) 开始存 放, 文本必须以 0xFF 或 0x00 结尾 0x01:H Rolling_Mode 1 滚屏模式 :0x00 表示从右向左滚屏 0x01:L Rolling_Dis 1 滚屏间距, 每个 VGUS 周期文本滚动的像素点阵数 0x02:H Adjust_Mode 1 对齐方式 :0x00= 左对齐,0x01= 右对齐,0x02= 居中 文本显示内容不足文本框时滚屏停止, 此时显示对齐模式方有效 0x02:L 未定义 1 写 0x00 0x03 Color 2 显示文本颜色 0x04 Xs Ys Xe Ye 8 文本框 0x08:H Font0_ID 1 0x08:L Font1_ID 1 编码方式为 0x01-0x04 时 :ASCII 字符显示的字库位置编码方式为 0x00 0x05 时 : 本参数不用设置, 写 0x00 即可编码方式为 0x01-0x04 时 : 非 ASCII 字符显示的字库位置编码方式为 0x00 0x05 时 : 显示字符使用的字库位置 0x09:H Font_X_Dots 1 字体 X 方向点阵数 (0x01-0x04 模式,ASCII 字符 X 将自动按照 Y/2 计算 ) 0x09:L Font_Y_Dots 1 字体 Y 方向点阵数目.7 定义了文本显示的字符间距是否自动调整 :.7=0 字符间距自动调整 ; 0x0A:H Encode_Mode 1.7=1 字符间距不自动调整, 字符宽度固定为设定的点阵数 0x0A:L Text_Dis 1 字符间隔.6-.0 定义了文本编码方式 : 0=8bit 编码,1=GB2312 内码,2=GBK,3=BIG5,4=SJIS,5=UNICODE

79 表 实时曲线描述指针定义地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 0x 无定义 0x01 Xs:Ys:Xe:Ye 8 曲线窗口 : 左上角坐标 (Xs,Ys), 右下角坐标 (Xe,Ye) 0x05 Y_Central 2 曲线中心位置 0x06 VD_Central 2 中心曲线对应的曲线数据值 0x07 Color 2 曲线颜色 0x08 NUL_Y 2 曲线放大倍数, 单位是 1/256,0x0000-0xFFFF 0x09:H CHANEL 1 数据源通道 :0x01-0x07 0x09:L Dis_HOR 1 横轴间隔 :0x01-0xFF 表 基本图形描述指针定义地址偏移量数据长度定义 ( 双字节 ) ( 字节 ) 说明 0x00 *VP 2 变量数据指针 0x01 Area 8 绘图显示区域定义 : 指定区域的左上角 右下角坐标绘图越界将不显示, 仅对 0x0001-0x0005 0x0009 0x000A 0x000B 指令有效 0x5A: 使用线段的绘图指令 (0x02 0x03 0x09 0x0A 指令 ) 将使用 Dashed_Line_ 0x05:H 1 虚线或者点划线显示线段 Ent 其它 : 使用线段的绘图指令使用实线显示线段 0x05:L Dash_Set 4 4 个字节依次设置了虚线 ( 点划线 ) 格式 : 第 1 段实线点阵数 第 1 段虚线点阵数 第 2 段实线点阵数 第 2 段虚线点阵数例如, 设置 0x10 0x04 0x10 0x04 将显示虚线, 设置 0x10 0x04 0x02 0x04 将显示点划线 13 保留, 写 0x00 表 列表显示描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 表格内容指针, 即 TAB_X_Num 与 TAB_Y_Num 数组的首地址 0x01:H TAB_X_Num 1 列数目,0x01-0xFF 0x01:L TAB_Y_Num 1 行数目,0x01-0xFF 0x02:H TAB_X_Start 1 表格起始显示的列位置,0x00-0xFF 0x02:L TAB_Y_ Start 1 表格起始显示的行位置,0x00-0xFF 0x01-0xFF 所有单元格存储的数据长度相同, 0x03:H Unit_Data_Num 1 0x00 由 *VP 变量地址指针指向变量存储空间定义不同列单元格的数据长 度 (word, 字长度 )

80 当 Unit_Data_Num=0x00 时, 表格数据内容存储位置相应后延 (TAB_X_Num/2) 向上取整个字地址例如,*VP=0x1000,TAB_X_Num=0x07, 那么 : 0x1000-0x1003 依次存储了第 0-6 列的表格数据长度, 其中 1003 的低字节未使用 0x1004 地址开始存储表格内容.7 定义了文本显示字符间距是否自动调整 :.7=0 字符间距自动调整.7=1 字符间距不自动调整, 字符宽度为固定设定的点阵数.6 定义了表格内容格式 : 0x03:L Encode_Mode 1.6=0 表格内容为文本格式.6=1. 未定义.5 定义了边框线条是否显示 :.5=0 显示边框,.5=1 不显示边框.4 未定义, 写 定义了文本的编码方式 :0x00=8bit 编码,0x01=GB2312 内码,0x02=GBK, 0x03=BIG5,0x04=SJIS,0x05=UNICODE 0x04 Xs,Ys,Xe,Ye 8 表格显示区域定义, 左上角坐标, 右下角坐标, 越界不显示 0x08 Color_line 2 表格边框颜色 0x09 Color_text 2 表格文本颜色 0x0A:H Font0_ID 1 编码方式为 0x01-0x04 时 ASCII 字库位置 0x0A:L Font1_ID 1 编码方式为 0x00 0x05, 以及 0x01-0x04 的非 ASCII 字符使用的字库位置 0x0B:H Font_X_Dots 1 字体 X 方向点阵数,0x01-0x04 模式时 ASCII 字符 X 按照 X/2 计算 0x0B:L Font_Y_Dots 1 字体 Y 方向点阵数, 字库中 Y 方向的点阵数必须为偶数 0x0C:H TAB_X_Adj_Mod 1 0x0C:L TAB_Y_Adj_Mod 1 设置 TAB_X_Start 不为 0 时, 进行表头显示控制,0x00= 首列不显示,0x01= 首列显示设置 TAB_Y_Start 不为 0 时, 进行表头显示控制,0x00= 首行不显示,0x01= 首行显示 备注 [1]: 当 Encode_mode.6=1 时, 每个单元格数据内容的前两个字定义了表格数据格式, 说明如下 : 第 1 个字高字节 :Mode 选择数据类型 0x00= 整数 (2 字节 ), 到 x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x05= 无符号整数 (2 字节 )0 到 x06= 无符号长整数 (4 字节 )0 到 x10= 时间格式 1,12:34:56BCD 码串 0x11= 时间格式 2, BCD 码串 0x12= 时间格式 3,YYYY-MM-DD HH:MM:SS BCD 码串 0xFF= 文本格式第 1 个字低字节 : Mode=0x00-0x06 定义了变量数据的定点显示格式, 高 4bit 表示整数位数, 低 4bit 表示小数位数 Mode=0x10-0X11 时间 BCD 码串的字节长度

81 Mode= 其它无定义第 2 个字 : 定义单元格文本颜色如果表格实际内容短于 Unit_Data_Num 规定的长度时, 使用 0xFFFF 做为单元格文本结束符对于特别大的表格, 通过触摸屏修改 TAB_X_Start TAB_Y_Start 值可以很方便的实现表格的定位和拖动 表 二维码描述指针定义地址偏移量定义 ( 双字节 ) 数据长度 ( 字节 ) 说明 0x00 *VP 2 二维码显示内容指针 二维码内容最长 458Bytes,0x0000 或 0xffff 为结束符 0x01 (x,y) 4 二维码显示的坐标位置 (x,y) 为二维码左上角在屏幕的坐标位置 二维码图形有 45*45 单元像素 ( 数据少于 155 字节 ) 和 73*73 单元像素 ( 数据少于 459 字节 ) 两种 0x03 Unit_Pixels 2 每个二维码单元像素所占的物理像素点阵大小,0x01-0x07 设置 Unit_Pixels=4, 那么每个单元像素将显示为 4*4 点阵大小

82 7 VGUS4.3 开发工具使用说明 本章内容提供有配套的视频教程 VGUS4.3 开发工具及设计流程 VGUS4.3 开发工具是一款组态型 图形用户界面设计软件 软件功能强大且易学, 一站式管理, 用户无需直接操作繁琐的配置文件, 开发工具内可完成所有的 GUI 交互设计, 使用户真正做到一周完成 GUI 交互设计 VGUS4.3 开发工具提供有虚拟串口屏功能, 可以在没有实物的情况下, 实现虚拟调试 VGUS4.3 开发工具免安装, 可直接运行 支持 Windows XP Win7 Win8 和 Win10 操作系统 Win8 或 Win10 系统下需要设置兼容性才能运行 7.1 操作界面软件界面如图 所示 图 VGUS4.3 开发工具软件界面 菜单栏文件菜单选项同其他常规软件 编辑菜单功能提供了复制粘贴等常规功能和针对控件的位置大小等编辑功能 视图菜单用于选择工具栏 各窗口是否显示, 显示的项目前面会有标记 工具菜单包含了 VGUS4.3 中提供的各类小工具软件, 功能如表 所示

83 触控配置用于设计各种触摸按钮控件, 详细内容见第 5 章 变量配置用于设计各种显示控件, 详细内容见第 4 章 帮助用于可查看当前软件版本 当打开一个工程时, 可查看生成该工程所使用的软件版本 图 文件菜单图 编辑菜单图 视图菜单图 工具菜单 表 工具软件功能说明 工具名称屏参配置 Icon 生成工具生成配置文件 功能说明用于设置串口波特率 指令帧头 CRC 校验 以及外设和屏保等特性, 详见 7.2 节将用户准备好的图标素材转换成 Icon 格式的图标文件界面设计完毕后, 生成下载文件夹 VT-SET 虚拟串口屏预览和虚拟调试设计效果, 参见文档 虚拟串口屏使用说明 在线下载下载到 U 盘变量查看串口调试工具导入工程旋转 180 度分辨率设置查找 通过 USBmini 接口, 直接将 VT-SET 文件夹下载到串口屏里面, 适合研发调试使用把 VT-SET 文件夹直接复制到 U 盘, 用于脱机下载, 适合批量生产使用查看所有控件的地址分配情况类似串口调试助手的功能, 可以直接生成指令, 调试串口屏更方便可以将 VGUS3.2 的工程 其它厂商 xgus 类的下载文件夹导入生成 VGUS4.3 的工程将已经设计好的工程旋转 180 度修改工程分辨率查找变量 16 位颜色数据将指定颜色转换为 格式数据 计算器 图像编辑工具 打开计算器 打开画图

84 图 触控配置菜单图 变量配置菜单图 帮助菜单 工具栏 提供了常用菜单的图标快捷方式, 鼠标短暂停留可显示文字提示 文件 编辑 触控配置 变量配置 工具 图 常用工具栏 文件列表区图片列表可以添加 替换 删除 上移下移图片 字库列表可以添加 删除字库 图标列表可以添加 删除 Icon 格式的图标文件 音频列表可以添加 删除音频文件 工作区用户在此区域进行图形化界面设计, 可以拖放移动控件等 点击工作区非控件的地方, 属性设置窗口会出现全局设置属性, 可以设置自动保存时间间隔 在设计过程中, 为防止因意外因素造成的数据丢失, 请设置自动保存, 或者及时手动保存文件 属性设置窗口用于显示选中控件的属性, 不同的控件对应不同的属性, 可以对其查看修改 ;

85 点击某项属性, 属性栏下方将显示相应的帮助内容 输出窗口显示工程导入 配置文件生成 下载等操作过程信息 状态栏显示鼠标所指工作区像素点的坐标和颜色信息, 以及项目分辨率 7.2 屏参配置 点击菜单栏上屏参配置, 弹出屏参配置窗口, 如图 所示 图 屏参配置 串口参数配置 : 设置串口波特率,VGUS 屏出厂波特率为 bps 设置指令帧头, 指令帧头的设置主要达到以下两个目的 :(1) 用于串口指令帧的识别和同步 ;(2) 多台 VGUS 屏并联工作时, 把帧头作为设备地址加以区分 VGUS 屏出厂帧头为 A5 5A 设置是否启用 CRC 校验 参数配置 : 设置变量初值, 可以全部设置为 0 或者启用变量属性设置的初始值 背光设置 ( 启用屏保 ) 设置是否启用屏保, 以及屏保延时动作时间 屏保亮度 和正常显示亮度, 如表 7-2-1; 当屏幕进入屏保后, 第一次点击触摸屏不会触发动作, 而只是恢复进入正常显示状态 ; 利用点亮亮度寄存器, 也可以实现设置串口屏的默认开机亮度 表 屏保功能寄存器名称取值范围说明 R6 0x00-0x40 触摸屏控制背光启动后, 点击触摸屏后背光点亮的亮度

86 R7 0x00-0x40 触摸屏控制背光启动后, 一段时间不点击触摸屏, 背光关闭的亮度 ( 屏保保护亮度 ) R8 0x01-0xFF 触摸屏控制背光启动后, 触摸屏背光点亮时间, 单位为 1.0 秒 ( 屏保延时时间 ) 如设置启用屏保 R6=0x40 R7=0x10 R8=0x1E, 当 30 秒 (0x1E) 不点击触摸屏, 背光亮度将自动降低到 0x10(25% 亮度 ); 点击触摸屏后, 背光亮度将自动调节到 0x40(100% 亮度 ) 设置 VGUS 运行周期 页面上的变量采用定时刷新, 建议将固定的背景提示语 单位提示符 表格等直接做到图片上, 减少串口屏的刷新任务, 有利于提高串口屏的刷新速度 设置 U 盘下载后启动触摸校准, 通过该功能可以很方便的实现设备出厂前校准触摸屏 设置触屏录入参数后自动上传到串口 设置关闭蜂鸣器 设置开机页面的图片序号 设置读指令的返回帧延时时间, 单位为毫秒 设置 miscellaneous 选项, 共 8 个, 其中各个位定义如表 表 miscellaneous 选项位功能定义 位 功能说明.7-.4 未定义 数据变量录入范围限制控制位 不勾选 : 不考虑小数位限制 ( 默认状态 );.3 勾选 : 要考虑小数位限制 例如 : 变量设置为 2 位整数 1 位小数, 范围设置为 1-100, 不勾选则实际允许录入范围为 1~100; 勾选后因为有一位小数位, 则实际允许录入范围是 0.1~10.0 是否启用触摸屏自动校准控制位.2 自动校准是指 4 秒内快速点击触摸屏的非按钮区域超过 20 次, 则进入触摸屏校准模式 不勾选 : 关闭自动校准 ( 默认状态 ); 勾选 : 打开自动校准 数据录入长度限制控制位.1 不勾选 : 非循环录入, 录入长度达到设置值后禁止录入 ( 默认状态 ); 勾选 : 循环录入, 录入长度超出设置值后高位挤出 触控和弹出键盘等像素控制位.0 不勾选 : 弹出图块在右侧和下侧各少一个像素 ( 默认状态 ); 勾选 : 弹出图块与控件指定大小位置一致

87 7.3 设计流程 详细设计流程如图 所示 图 详细设计流程 准备素材开始使用 VGUS4.3 开发工具设计界面前, 首先要准备好用到的背景图片 图标, 以及可能用到的字库 音频和视频文件等 文件格式要求参见 7.3 节 画面中固定显示的文字提醒语 符号 表格和图标等, 建议全部做到背景图片上, 切不可用变量方式来实现 因为页面上的变量越多, 会占用 CPU 的时间越多, 影响显示效果 新建项目打开软件, 选择 文件 新建 选项, 弹出如图 对话框 正确设置分辨率 旋转角度 项目名称和项目路径后, 点击确定后, 将在项目路径下生成名称与项目名称相同的项目文件夹, 如图 所示, 用以存放整个项目文件 图 新建项目对话框 图 项目文件夹 *.vt 是 VGUS4.3 项目工程文件, 用户可以使用 VGUS4.3 开发工具直接打开 VT_SET 文件夹是 VGUS4.3 开发工具生成的配置文件存放位置, 用于下载到串口屏里等 现在 VT_SET 文件夹是空的, 等生成配置文件后里面才会有文件 其他文件及文件夹为项目源文件, 用户无需了解和管理 如果设计用到视频文件, 视频文件需要手动拷贝到 VT_SET 文件夹下, 其他文件严禁拷贝进来, 也严禁手动删除 VT_SET 文件夹下任何文件 导入素材把准备好的图片 图标 字库 音频文件导入到 VGUS4.3 开发工具左侧的文件列表窗口中 屏参配置根据项目需要, 正确设置串口波特率 指令帧头 CRC 校验 蜂鸣器 触摸屏和屏保等外设特性 设计控件包括显示控件 ( 变量配置 / 第 4 章 ) 和触摸控件 ( 触控配置 / 第 5 章 ),VGUS4.3 开发工具提供有功能完善

88 的多种显示控件和触摸控件, 分别见第 4 章 第 5 章 在 VGUS4.3 开发工具菜单栏中或者工具栏上找到相应 控件按钮, 点击按钮并拖放到工作区, 调整控件大小及位置 并在右侧属性窗口中完成控件属性设置 生成配置文件设计完所有显示控件和触摸控件后, 点击菜单栏或者工具栏上的 生成配置文件 按钮, 会在 VT_SET 文件夹下生成用于下载的各种配置文件 输出窗口会提示配置文件是否生成成功 如果成功后, 再打开 VT_SET 文件夹, 里面会有需要下载到串口屏里的各种文件 虚拟调试 VGUS4.3 开发工具提供有虚拟串口屏和串口调试工具功能 在生成配置文件夹后, 可以预览及虚拟调 试设计效果 ( 实际效果以下载到 VGUS 屏内为准 ) 详细方法参见 虚拟串口屏使用方法 7.4 工程下载 VGUS 串口屏支持通过在线下载和脱机下载两种方式 USBmini 接口在线下载调试适合研发阶段使用, 有效提高研发效率, 避免调试过程中反复插拔 TF 卡 ; U 盘下载适合研发定型后的批量生产使用, 可以有效提高下载效率 降低对操作人员素质要求 在线下载 在线下载 按钮及窗口如下图所示 图 在线下载按钮 图 在线下载窗口打开在线下载窗口, 将 VGUS 屏的 USBmini 接口连接到电脑并上电后, 右下方将提示 USB 已连接 此时, 点击 下载 按钮, 系统自动将 VT_SET 文件夹下的内容下载到 VGUS 屏里 在研发调试过程中, 可能需要反复下载的是变量格式等信息, 而图片 字库或者图标可能并没有修改,

89 此时可以勾选上图中 不下载图片 不下载字库 不下载图标 等选项, 可以有效提高下载速度 如果图片 字库或者图标有修改, 此时就不能再勾选相应选项, 必须将修改的文件重新下载 温馨提示 : 由于 VGUS 屏通过 USB-mini 接口连接到电脑后, 实际是被虚拟成硬盘, 在电脑里面可以看到一个新的盘符 VGUS_USER 若出现配置文件下载失败的问题, 请在 我的电脑 中把盘符 VGUS_USER 重新格式化成 FAT32 的格式即可 脱机下载 通过 VGUS 软件中 下载到 U 盘 按钮, 直接把 VT_SET 文件夹拷贝到 U 盘中, 如下图 无 需通过复制 粘贴的繁琐过程 图 下载到 U 盘按钮 把 U 盘插入 VGUS 屏中, 系统将自动启动数据拷贝, 把 U 盘里面的数据逐一拷贝到 VGUS 屏里 拷贝完成后, 蜂鸣器会提示下载完成, 同时显示屏左上角提示 Please plug out the U disk. 同时会报告成功下载文件数量, 下载失败文件数量等信息 拔出 U 盘 说明 : U 盘首次使用前, 需要将 U 盘格式化为 FAT 或者 FAT32 文件格式, 推荐将 U 盘格式化为 FAT 文件格式 VT_SET 文件夹下包含了所有的配置文件 字库 图片 音频文件和图标库等信息, 用户不能对该文件夹内文件做任何修改 但文件夹名称用户可以在 VT_SET 后面追加字符如 VT_SETxxxx 当文件夹名称为 VT_SET_REPLACE 时, 下载时只更新同名文件, 不删除其它工程文件 该功能适用于终端用户自行修改开机画面 视频文件在下载前需要手工拷贝到 VT_SET 文件夹下

90 7.5 文件格式及命名规则 VUGS4.3 支持的文件格式如下表所示 表 VGUS 4.3 支持的文件格式 文件格式 含义 编号限制 *.Jpg 图片文件, 推荐 *.bmp 图片文件, 不推荐 *.ico 图标文件 *.dzk/*.hzk 用户字库文件 *.mp3 音频文件, 推荐 *.wav 音频文件, 不推荐 *.avi 视频文件 *.bin 用户数据文件 UserDb.bin 用户数据库文件 固定 文件命名规则 上表中所有类型文件的文件名必须以阿拉伯数字开头 例如, 要把一副图片序号编为 20, 图片文件可 以命名为 20_ 测试.jpg 或者 20.jpg, 但不能命名为 测试 20.jpg 图片文件格式 VGUS4.3 支持的图片文件格式为 JPG 和 BMP, 如果用户导入其它格式的图片文件, 系统将自动转换为 JPG 格式 强烈建议用户直接使用 JPG 格式, 因为 JPG 格式占用空间小, 显示速度快 JPG 格式种类繁多, VGUS4.3 仅支持 Baseline 模式 当使用其它模式的 JPG 图片后, 可能会导致显示异常! 图片的大小要和屏的分辨率一致, 液晶屏分辨率在产品规格书中都可以查到, 如果下载与屏分辨率不 匹配的图片会导致显示异常 图片文件命名必须从 0 开始编号, 上电默认显示 0 号图片, 用户也可以在屏参配置中自定义设置 不要用画图 QQ 截图等工具直接另存 JPG 格式文件, 这样显示效果较差, 因为 JPG 格式文件为有损压 缩文件 建议首先用使用画图 QQ 截图等工具保存 BMP 格式文件, 再用 PhotoShop 工具打开图片, 然后另 存为 JPG 格式, 具体步骤如下 : 1 用 PhotoShop 打开图片 ; 2 另存为 jpg 格式 ;

91 图 另存图片品质选项 3 选择图像效果 最佳 选项 BMP 格式为原始位图文件, 包含信息最全, 如果使用 JPG 格式文件显示效果不能满足要求, 用户可选择 BMP 格式文件 使用 BMP 格式会占用更多的存储空间, 画面刷新速度会明显变慢 图标文件格式图标素材源文件支持 bmp jpg gif pngd 等格式 但是需要做图标透明显示的场合, 必须使用 BMP 格式 图标素材源文件名一定要以数字开头命名, 不然无法生成 ICON 文件, 最好以连续的数字开头命名 不建议使用大尺寸的图标, 过大的图标显示速度会变慢 通过 VGUS4.3 开发工具中的 ICON 生成器, 将用户准备好的图标素材源文件转换成 VGUS4.3 所用的 ICON 格式的图标文件, 并自动添加到当前工程的图标列表中去 详见 节 字库文件格式 VGUS 屏出厂预装有 0 号字库文件 (0.dzk), 包含 4*8 到 64*128 点阵的所有 ASCII 码字库 当需要用到其它类型字库时, 可以找技术支持索取或者自行通过 TS3 软件生成相应字库文件 新字库需要从 1 开始命名, 不要与 0 号字库重名 TS3 软件及使用说明官网可以下载 字库编码支持 ASCII 码 GB2312 内码 GBK BIG5 SJIS 以及 UNICODE 音频文件格式支持 WAV MP3 两种音频文件格式 支持两种播放方式 : 扩展指令 0x8503 和寄存器 0x50-0x55, 详细信息分别参见本文 2.4 节 3.3 节 WAV 格式文件必须选用 22KHz 双声道数据 寄存器 0x50-0x55 播放时单个 WAV 文件不得超过 2M 字节, 扩展指令 8503 播放时播放列表的 WAV 文件总和不得大于 2M 字节 MP3 格式文件大小没有特殊限制 视频文件格式支持 AVI 格式视频文件, 视频文件大小没有特殊限制, 详细信息参见本文 3.4 节介绍 注意 1:FLASH 可用空间为 114M 字节, 所有文件总和不得大于 114M 字节 ; 注意 2: 字库 ICON 文件 以及 WAV 文件共同占用一个 17M 字节空间的临时缓存 正在使用的字库 ICON 图标和 WAV 文件总和不得大于 17M 字节 当缓存不足时, 串口屏左上角会提示信息 Out of memory! 字库首次使用时会读入缓存, 且永不释放, 单个字库文件不得超过 17M; ICON 图标文件首次使用时会将指定图标读入缓存, 当缓存满时, 会释放占用缓存 ; WAV 文件播放前会读入缓存, 播放后释放占用缓存 ;

92 附 1 外接键盘转接板 KAP02 SDWe 系列串口屏很多型号都提供有键盘接口, 如图附 1-1 所示, 该接口通过转接板 KAP02, 可以外 接最多 8 行 *8 列键盘 接 VGUS 屏键盘接口 图附 1-1 KAP02 实物图 如上图所示, 转接板 KAP02 提供两个插座, 一个是 6PIN 的 1.0 间距 FPC 插座, 用于连接到 SDWe 串 口屏上, 另一个是 16PIN 的 2.54 间距单排弯针, 用于外接最多 8 行 8 列键盘 图附 1-2 键盘行列线连接及键码分配键盘行列线连接关系及键码如上图所示 每个行线和列线交叉的位置都是一个按键, 最多共 64 个按键, 键码分别对应为 0~63 用户在通过 VGUS4.3 组态软件设计定义按钮的时候, 通过指定键码 ( 详见本文图 5-0-2), 就可以将特定按钮与外接键盘关联起来