RF

Transcription

1 迪文 Mini DGUS 屏用户开发指南 (Ver ) 北京迪文科技有限公司 北京迪文科技有限公司 dwinhmi@dwin.com.cn

2 目录 1 硬件配置 SD 卡配置接口 CONFIG.TXT 配置文件说明 存储器空间说明 字库空间 图片空间 寄存器空间 ( 使用 0x80/0x81 串口指令访问 ) 变量存储器空间 ( 使用 0x82/0x83 串口指令访问 ) 曲线数据缓冲区 ( 使用 0x84 串口指令访问 ( 只写 )) 软件升级步骤 触摸屏校准 SD 卡接口的禁止和重新启用 串口操作 数据帧架构 指令集 数据格式 触控配置文件 (13.BIN) 说明 变量数据录入 (0x00) 弹出菜单选择 (0x01) 增量调节 (0x02) 拖动调节 (0x03) RTC 设置 (0x04) 按键值返回 (0x05) 文本录入 (0x06) ASCII 文本录入 显示变量配置文件 (14.BIN) 说明 图标变量 变量图标显示 (0x00)...19 北京迪文科技有限公司 dwinhmi@dwin.com.cn

3 5.1.2 动画图标显示 (0x01) 滑块刻度指示 (0x02) 艺术字变量显示 (0x03) 图片动画显示 (0x04) 图标旋转指示 (0x05) 位变量图标显示 (0x06) 文本变量 数据变量显示 (0x10) 文本显示 (0x11) RTC 显示 (0x12) 时间变量显示 (0x13) 图形变量 实时曲线显示 (0x20) 基本图形显示 (0x21) 开发步骤 ( 首次使用必读 )...32 附录 1 MINI DGUS 主要功能一览...34 附录 2 修订记录...36 北京迪文科技有限公司 dwinhmi@dwin.com.cn

4 1 硬件配置 1.1 SD 卡配置接口迪文 Mini DGUS 屏的所有参数设置和资料下载, 只能通过 SD 卡接口来完成 SD 卡接口支持 SD 或 SDHC 两种 SD 卡格式, 保存的文件必须使用 FAT32 文件系统 文件格式说明 在 SD 卡根目录下建立 DWIN_SET 文件夹 ; 把需要下载的图片 字库 配置文件都放在 DWIN_SET 文件夹中, 如下图所示 SD 卡文件格式说明 文件类型 命名规则 举例 说明 图片文件 图片存储位置 +( 可选的 ) 文件名.BMP 00 开机界面.BMP 必须是和 DGUS 屏分辨率相同的 24 位色 BMP 文件 字库文件 字库存储位置 +( 可选的 ) 文件名.BIN/HZK/DZK 32_GBK12 汉字库.DZK 可以由 TS3 字库提取软件生成 图标库 字库存储位置 +( 可选的 ) 文件名.ICO 41 图标库.ICO 迪文工具箱 DWICON 生成 专用字库 0*.HZK 0_DWIN_ASC.HZK 迪文工具箱 0 号字库 生成 触控配置 13*.BIN 13 触控配置文件.BIN 迪文 DGUS 组态软件生成 变量配置 14*.BIN 14 变量配置文件.BIN 迪文 DGUS 组态软件生成 变量初始化 22*.BIN 22 变量初始化.BIN 硬件设置 CONFIG.TXT CONFIG.TXT 检测到 SD 卡后,Mini DGUS 会显示蓝屏提示用户检测到 SD 卡, 然后开始数据下载 ; SD 卡下载完成后,Mini DGUS 屏会重新对数据进行初始化 北京迪文科技有限公司 dwinhmi@dwin.com.cn

5 1.2 CONFIG.TXT 配置文件说明 CONFIG.TXT 文件采用类似脚本语言的方式来描述参数寄存器, 每一行描述一个参数, 不用的参数可以不写, 说明如下 : 参数寄存器名称 取值范围 说明 R0 取决于 Mini DGUS Mini DGUS 屏驱动模式选择, 配置错误会导致显示异常, 用户不要配置 屏 波特率设置,0x00-0x10 对应 1200bps bps R1 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 R1 0x00-0x11 波特率 1.2K 2.4K 4.8K 9.6K 19.2K 38.4K 57.6K 115.2K 28.8K R1 0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F 0x10 波特率 76.8K 62.5K 125K 250K 230.4K 345.6K 691.2K 921.6K R2 0x00-0xFF SYS_CFG 配置字, 按位 (bit) 定义, 说明如后 R3 0x00-0xFF UART_SYNC_H 串口帧头高字节 R5 不定 当 R1=0x11 时, 波特率配置字的高字节 R5:R9= / 用户自定义波特率 比如设定 10000bps 波特率,R5:R9= /10000=625=0x0271 R5=02 R9=71 R6 0x00-0x40 触摸屏控制背光启动后, 点击触摸屏后背光点亮亮度 R7 0x00-0x40 触摸屏控制背光启动后, 一段时间不点击触摸屏, 背光关闭的亮度 R8 0x01-0xFF 触摸屏控制背光启动后, 触摸屏背光点亮时间, 单位为 1.0 秒 R9 不定 当 R1=0x11 时, 波特率配置字的低字节 RA 0x00-0xFF UART_SYNC_L 串口帧头低字节 配置文件的参数均为一字节的 HEX 模式 ( 必须大写 ), 比如 0A 表示 10 进制的 10; 配置文件的参数必须为 2 位, 比如 00 不得写成 0 R2(SYS_CFG 配置字 ) 说明 位 权重 定义 说明.7 0x80 VDS 0= 正常显示 1= 偏转 90 显示.6 0x40 HDS 0= 正常显示 1= 偏转 180 ( 反视角 ) 显示.5 0x20 TP_LED 0= 背光不受触摸屏状态控制 1= 背光受触摸屏状态控制, 控制参数由 CONFIG.TXT 中的 R6 R7 R8 设定.4 0x10 FCRC 0= 不启动串口通信的 CRC 帧校验 ; 1= 启动串口通信的 CRC 帧校验.3 0x08 TPSAUTO 0= 触摸屏录入参数后不自动上传 ( 用户查询 ); 1= 触摸屏录入参数后是否自动上传到串口由相应触控变量的配置决定.2 0x04 L22_Init_En 0=4KB 变量存储器上电初始化数据为 0x00; 1=4KB 变量存储器上电初始化数据由 22(0x16) 字库文件加载 设置 Mini DGUS 周期,Mini DGUS 周期小则变量响应更灵敏, 但处理变量的能力相对变 低.1 0x02 FRS 周期 100mS 200mS FRS x01 FBZ 0= 蜂鸣器启动 ; 1= 蜂鸣器禁止 ; VDS 和 HDS 控制屏显示模式说明 北京迪文科技有限公司 dwinhmi@dwin.com.cn

6 1.3 存储器空间说明 字库空间迪文 Mini DGUS 软件使用用 32MB FLASH 存储器做为字库存储器, 并划分为 128 个大小为 256KB 的字库空间, 对应字库文件 ID 为 0-127, 说明如下 : 字库 ID 大小说明备注 KB 0#ASCII 字库 0_DWIN_ASC.HZK KB 触控配置文件 13_ 触控.BIN KB 变量配置文件 ( 最多 1024 页, 每页最多 64 个变量 ) 14_ 变量.BIN MB 字库 图标库 ( 其中 字库也可以做为用户数据库 ) 用户自定义 图片空间迪文 Mini DGUS 软件使用 96MB 来保存图片, 对应不同分辨率的图片保存数量如下表所示 : 屏幕分辨率 可存储图片数量 北京迪文科技有限公司 dwinhmi@dwin.com.cn

7 1.3.3 寄存器空间 ( 使用 0x80/0x81 串口指令访问 ) 迪文 Mini DGUS 屏提供 1 个 256B 寄存器接口, 用于硬件操作或者图片显示等进程控制, 寄存器空间定义 如下 : 寄存器地址 定义 字节长度 说明 0x00 Version 1 DGUS 版本号,BCD 码表示,0x10 表示 V1.0 0x01 LED_NOW 1 LED 亮度控制寄存器,0x00-0x40 0x02 BZ_TIME 1 蜂鸣器鸣叫控制寄存器, 单位为 10mS 0x03 PIC_ID 2 读 : 当前显示页面 ID; 写 : 切换到指定页面 ( 进程控制 ) 0x05 TP_Flag 1 0x5A= 触摸屏坐标有更新 ; 其它 = 触摸屏坐标未更新用户读取数据后未清零本标记, 则触摸屏数据不再更新 0x06 TP_Status 1 0x01= 第一次按下 ;0x03= 一直按压中 ;0x02= 抬起 ; 其它 = 无效 0x07 TP_Position 4 触摸屏按压坐标位置 :X_H:L Y_H:L 0x0B TPC_Enable 1 0x00= 触控不启用 其它 = 触控启用 ( 上电默认为 0xFF) 0x0C-0x0F 保留 4 未定义 0x10-0x1A R0-RA 11 SD 卡配置寄存器的映射, 除 R2 外串口只读, 串口写无效 其中 R2 串口可读, 也可写, 但 DGUS 不永久保存 R2 由串口写的结果, 即每次初始化结果都为 SD 配置值 0X1F RTC_COM_ADJ 1 0X5A 表示用户串口改写了 RTC 数据,DGUS 修改 RTC 后清零 0x20 RTC_NOW 16 YY:MM:DD:WW:HH:MM:SS YY:MM:DD+ 天干地支 + 生肖 串口修改 RTC 举例 :A5 5A 0A 80 1F 5A 指星期四, 实际可以写任何值 0x30-0x4E 保留 31 未定义 0x4F Key_Code 1 用户键码, 用于触发 0x13 触控文件 ;0x01-0xFF,0x00 表示无效 DGUS 处理键码后会自动清零键码寄存器 0x50-0xEA 保留 155 未定义 0xEB CURVE_CLR 1 用于清除曲线缓冲区 : =0x5A, 清除曲线缓冲区 0 =0x5B, 清除曲线缓冲区 1 清除完毕, 系统把寄存器值清 0 0xEC FAST_REF 1 用户设置 0xEC=5A, 然后进入快速刷新模式, 用户此时读 0xEC 寄存器将返回 0x5C 在快速刷新模式下触摸屏可以响应, 系统对屏幕进行快速刷新, 不刷新背景图, 有必要, 需要通过剪切指令恢复背景图 在快速刷新模式下设置 0xEC=00, 则退出快速刷新模式 0xED-0xFF 保留 19 保留 变量存储器空间 ( 使用 0x82/0x83 串口指令访问 ) 迪文 Mini DGUS 屏提供了 2KW(4KB) 的 RAM 做为用户变量存储器, 用于 GUI 变量数据的存储 在读写实时性 (ms 级别 ) 要求不高时, 可以做为用户的外扩串口访问存储器 (RMA) 变量存储器空间只能按照字 (Word) 读写, 对应地址空间为 0x0000-0x07FF 如果用户读或写的变量存储空间大于 0x7FF, 系统会只取变量地址的低 11 位, 自动映射到 0x0000-0x07FF 地址空间 曲线数据缓冲区 ( 使用 0x84 串口指令访问 ( 只写 )) 为了简化实时曲线的显示, 迪文 Mini DGUS 屏设计有一个曲线数据缓冲区用来缓存用户的曲线数据, 曲线缓冲区不占用数据存储器空间, 最多可以同时缓冲 2 条曲线 曲线数据缓冲区只能按照字 (Word) 写, 每个曲线点的数据均用 2 字节带符号整数表示 曲线缓冲区可以通过往 0xEB 寄存器写 0x5A 或者 0x5B 进行清除 北京迪文科技有限公司 dwinhmi@dwin.com.cn

8 1.4 软件升级步骤 Mini DGUS 屏关电, 把串口跟计算机串口 ( 比如 COM1) 连接 ; 打开 SSCOM3.2 软件, 点击选择 Mini DGUS 程序, 比如 K100V27.BIN; 在发送栏写上 DWIN_M600_BOOT!, 设置定时发送时间为 10 ; 勾上 发送新行 和 定时发送, 然后给 Mini DGUS 屏上电 ; 串口会收到 Erase..., 如果收不到请检查串口是否连接好, 或者 Mini DGUS 屏损坏 ; 大约 1 秒, 收到 Please Tx File! 后, 勾掉 自动发送, 然后点击等待 3-10 秒, 串口收到 ***************END*************** 表示下载完成 ; 重新给 Mini DGUS 屏掉电, 软件升级成功 ; 1.5 触摸屏校准 方式 1: Mini DGUS 屏开机状态下, 如果 4 秒内快速点击触摸屏的非触控区域超过 20 次, 则进入触摸屏校准模式, 步骤如下 : 4 秒内快速点击触摸屏非触控区域超过 20 次 ; 蜂鸣器长鸣 1 秒, 听到蜂鸣器鸣叫时停止点击 ; 进入校准模式, 按照十字交叉线的提示点击触摸屏的指定位置校准触摸屏 ; 校准结束, 返回进入校准前的画面 方法 2: 在 CONFIG.TXT 文件中, 写入一行特殊文本 TP_CORRECT 将启动一次触摸屏校准过程 (1) 当 SD 卡接口被禁止后, 将不能进行触摸屏校准 (2) 当 SD 卡从原来的 0 显示配置为 180 显示或者从 180 显示配置回 0 显示, 必须对触摸屏进行重新校准, 通过串口修改为 0 或 180 显示, 则不需要重新对触摸屏进行校准 北京迪文科技有限公司 dwinhmi@dwin.com.cn

9 1.6 SD 卡接口的禁止和重新启用 在客户测试完成正式量产后, 为了防止在应用中通过 SD 卡进行错误的升级或下载操作, 导致不正常 可以通过在 CONFIG.TXT 文件中, 增加一行特殊文本来禁止 SD 卡接口, 说明如下 : CONFIG.TXT 文档中禁止 SD 接口文本的说明第 1 部分 SD_LOCK_ 固定第 2 部分 400 用来重新启用 SD 接口的密码保存在变量存储器空间的地址, F8 第 3 部分 ABCD1234 重新启用 SD 接口的 8 位密码 取消 SD 卡禁止的命令 :SD_UNLOCK_ABCD1234, 其中 ABCD1234 是用户设置的 8 位密码 举例 : 假设禁止 SD 卡后的重新启用密码为 , 密码保存在变量存储空间的 0x0400 位置 禁止 SD 卡接口的过程 : (1) 在 CONFIG.TXT 文档中增加 : SD_LOCK_400_ (2) 把 CONFIG.TXT 用 SD 卡 ( 加密启用 SD 卡 ) 下载到 Mini DGUS 中 ; (3) 之后 Mini DGUS 将禁止 SD 卡接口 重新启用 SD 卡的过程 : 方法 1: 通过串口发送正确的密码到正确的存储空间位置,SD 卡将被激活一次 假设用户设置的帧头为 (0xA55A):A5 5A 0B 方法 2: 使用触摸屏 ASCII 文本录入功能来设置一个 解锁 操作菜单, 也可以激活一次 SD 卡 方法 3: CONFIG.TXT 文档中写入取消 SD 卡禁止的命令, 然后存入 SD 卡去重新激活 SD 卡接口 如果 SD 卡被禁止, 用户务必妥善保管好启用密码, 否则 Mini DGUS 屏将不能更新数据 资料和校准触摸屏 由于 FAT32 文件系统的复杂性, 当出现 Mini DGUS 可以识别 SD 卡但不能正确读取数据时 ( 插入 SD 卡后屏幕显示蓝屏一下就结束了 ), 请按照下面的步骤对 SD 卡进行格式化, 然后再使用 第 1 步 : 在 windows 的开始 // 运行, 键入 command 运行 DOS 系统 ; 第 2 步 : 把 SD 卡格式化, 键入指令 : format/q g:/fs:fat32/a:4096 其中 g 是 SD 卡的盘符, 不同的电脑用对应的盘符 ( 比如 h,i) 替换即可 ; 注意格式化会导致原来 SD 卡上的所有数据都丢失 一路回车到格式化结束,SD 卡即可正常使用, 流程如下图所示 : 北京迪文科技有限公司 dwinhmi@dwin.com.cn

10 2 串口操作迪文 Mini DGUS 屏采用异步 全双工串口 (UART), 串口模式为 8n1(51 单片机的 MOD1,9bit UART), 即每个数据传送采用 10 个位 :1 个起始位,8 个数据位,1 个停止位 串口波特率通过 SD 卡来配置 串口的所有指令或者数据都是 16 进制 (HEX) 格式 ; 对于字型 (2 字节 ) 数据, 总是采用高字节先传送 (MSB) 方式 比如 0x1234 传送时先传送 0x 数据帧架构迪文 Mini DGUS 屏的串口数据帧由 4 个数据块组成, 如下表所述 : 数据块 定义帧头数据长度指令数据 数据长度 N 数据长度包括指 CONFIG.TXT 配置文说明令 数据, 不包括 0x80-0x84 件的 R3:RA 定义 CRC 校验码一个数据包能够传送的最大数据长度为 248 字节 ( 不要 CRC 校验 ) 或 246 字节 ( 带 CRC 校验 ) CRC 校验不包括帧头和数据长度, 紧针对指令和数据, 采用 ANSI CRC-16(X16+X15+X2+1) 格式 2.2 指令集 功能 指令 数据 说明 0x80 ADR(0x00-0xFF)+Data_Pack 指定地址写寄存器数据访问 ADR(0x00-0xFF)+RD_LEN(0x00-0xFF) 指定地址读 RD_LEN 字节寄存器数据控制寄存器 0x81 ADR(0x00-0xFF)+RD_LEN+Data_Pack 读寄存器的 Mini DGUS 屏应答 0x82 ADR_H:L(0x0000-0x6FFF)+DATA0 DATAn 指定地址开始写入数据串 ( 字数据 ) 到变量存储区访问 ADR_H:L(0x0000-0x6FFF)+RD_LEN(0x00-0x7F) 从变量存储区指定地址开始读入 RD_LEN 长度字数据数据存储器 0x83 ADR_H:L+RD_LEN+DATA0 DATAn 读数据存储器的 Mini DGUS 屏应答 写曲线缓冲区数据 CH_Mode 定义了后续数据的通道排列顺序 : CH_Mode 的每个位 (bit) 对应 1 个通道 ; 写曲线缓冲区 0x84 CH_Mode(Byte)+DATA0(Word)+ +DATAn CH_Mode.0 对应 0 通道,.1 对应 1 通道 ; 位置 1 表示对应的通道数据存在 ; 数据按照低通道数据在前排列 比如 CH_Mode=0x23( B), 表示后续数据格式为 : ( 通道 0+ 通道 1)+ +( 通道 0+ 通道 1) 寄存器的访问以字节 (Byte) 为数据单位, 而数据存储器 曲线缓冲区的访问以字 (Word) 为数据单位 关于存储器的定义和说明, 请参考 1.3 存储器空间说明 3 数据格式由于主要面向 MCU 等嵌入式系统应用, 为了用户处理的方便, 迪文 Mini DGUS 软件使用的数据采用字符型 ( 字节 ) 整数 ( 字 ) 长整数 ( 双字 ) 表示, 相关表示范围如下 : 整数 :-32768(0x8000) 到 (0x7FFF) 长整数 : (0x ) 到 (0x7FFFFFFF) 字符型 :0(0x00) 到 256(0xFF) 小数采用定点小数表示, 用户自定义小数位数, 比如 0x4D2(1234), 规定小数为 2 位时, 表示 迪文 Mini DGUS 软件使用 65K 色颜色系统, 调色板定义如下 : DGUS 使用的 65K 设调色板位定义 Bit Define R4 R3 R2 R1 R0 G5 G4 G3 G2 G1 G0 B4 B3 B2 B1 B0 红色 0xF800 绿色 0x07E0 蓝色 0x001F 北京迪文科技有限公司 dwinhmi@dwin.com.cn

11 4 触控配置文件 (13.BIN) 说明触控配置文件由 N 条按照页面配置的触控指令组成, 每条触控指令固定占用 或者 48 字节存储空间 一条触控指令由以下 6 部分组成 : 序号定义数据长度说明 1 Pic_ID 2 页面 ID 2 TP_Area 8 触控按钮区域 : 左上角坐标 (Xs,Ys), 右下角坐标 (Xe,Ye) 当 Xs=0xFFFF 时, 表示触发控制由 0x4F 寄存器的键码值触发, 此时 Ys_H 为设定的触发键码值 (Ys_L,Xe,Ye 值未定义, 可任意写 ); 由键码值触发时, 请把按钮按压效果设置为无效 3 Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 4 Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 5 TP_Code 2 触控键码 : 0xFF** 表示无效的键码 0xFE** 表示触控功能按键, 比如 0xFE00 表示启动变量数据触摸屏录入 0x00** 表示触控键码, 用 ASCII 表示 ; 比如 0x0031 表示按键 1 6 TP_FUN 32 当 TP_Code=0xFE** 时, 用来对触控功能按键进行描述 4.1 变量数据录入 (0x00) 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE00 0x10 0xFE 1 0xFE 0x11 *VP 2 录入数据对应的变量地址指针 0x13 V_Type 1 返回变量类型 : 0x00=2 字节变量, 整数 到 x01=4 字节变量, 长整数 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x14 N_Int 1 录入的整数位数 比如录入 , 则 N_Int=0x04 0x15 N_Dot 1 录入的小数位数 比如录入 , 则 N_Dot=0x02 0x16 (x,y) 4 输入过程显示位置 : 右对齐方式,(x,y) 是字符串输入光标的右上角坐标 0x1A Color 2 输入字体显示颜色 0x1C Lib_ID 1 显示使用的 ASCII 字库位置,0x00= 默认字库 0x1D Font_Hor 1 字体大小,X 方向点阵数目 0x1E Cusor_Color 1 光标颜色,0x00= 黑色其它 = 白色 0x1F Hide_En 1 0x00= 输入遮挡, 显示为 "*"; 其它, 输入直接显示 0x20 0xFE 1 0xFE 0x21 KB_Source 1 0x00= 键盘在当前页面 ; 其它 = 键盘不在当前页面 0x22 PIC_KB 2 键盘所在页面 ID, 仅当 KB_Source 不等于 0x00 时有效 0x24 AREA_KB 8 键盘区域 :(Xs,Ys) 为左上角,(Xe,Ye) 为右下角坐标 仅当 KB_Source 不等于 0x00 时有效 0x2C AREA_KB_Position 4 键盘在当前页面显示位置, 左上角坐标 ; 仅当 KB_Source 不等于 0x00 时有效 0x30 0xFE 1 0xFE 0x31 Limits_En 1 0xFF: 表示启用输入范围限制, 输入越界无效 ( 等同取消 ); 其它 : 输入无范围限制 0x32 V_min 4 输入下限,4 字节 ( 长整数 ) 0x36 V_max 4 输入上限,4 字节 ( 长整数 ) 0x3A 保留 6 写 0x00 输入过程中有效键码 : 北京迪文科技有限公司 dwinhmi@dwin.com.cn

12 0x0030-0x0039,0x002E(.),0x002D(+/-),0x00F0( 取消 ),0x00F1( 确认 ),0x00F2( 退格 ) 键盘和输入启动按钮在一个页面 (KB_Source=0x00) 键盘不在当前界面上 (KB_Source=0x01): 触发输入法后 北京迪文科技有限公司 dwinhmi@dwin.com.cn

13 4.2 弹出菜单选择 (0x01) 键盘不在当前界面上 (KB_Source=0x01): 键盘所在页面 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE01 0x10 0xFE 1 0xFE 0x11 *VP 2 变量地址指针, 返回数据由 VP_Mode 决定 0x13 VP_Mode 1 0x00= 把 0x00** 键码写入 VP 字地址 ( 整型数 ); 0x01= 把 ** 键码写入 VP 字地址的高字节地址 (VP_H); 0x02= 把 ** 键码写入 VP 字地址的低字节地址 (VP_L); 0x10-0x1F: 把 ** 键码最低位 (1bit) 变量并写入 VP 字地址的指定位 (0x10 修改 VP.0,0x1F 修改 VP.F) 0x14 Pic_Menu 2 弹出菜单的图片位置 0x16 AREA_Menu 8 菜单区域 : 左上角坐标 (Xs,Ys), 右下角坐标 (Xe,Ye) 0x1E Menu_Position_X 2 菜单在当前页面显示的位置 : 左上角 X 坐标 0x20 0xFE 1 固定 0x21 Menu_Position_Y 2 菜单在当前页面显示的位置 : 左上角 Y 坐标 0x23 NULL 13 写 0x00 输入过程中有效键码 :0x0000-0x00FF, 其中 0x00FF 为取消 ( 不选择参数直接返回 ) 上图中 : 弹出的菜单在另外的界面上," 开启 " 和 " 关闭 " 两个按钮配置的键码 (0x0000-0x00FE) 将被返回给 0x01 触控按钮所指向的变量 ; 取消按钮设置键码为 0x00FF, 点击时不会返回值 北京迪文科技有限公司 dwinhmi@dwin.com.cn

14 下拉式菜单也可以使用本指令设计 4.3 增量调节 (0x02) 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 必须为 0xFF** 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE02 0x10 0xFE 1 0xFE 0x11 *VP 2 变量地址指针, 返回数据由 VP_Mode 决定 0x13 VP_Mode 1 0x00= 调节 VP 字地址 ( 整型数 ); 0x01= 调节 VP 字地址的高字节地址 (1 字节无符号数,VP_H); 0x02= 调节 VP 字地址的低字节地址 (1 字节无符号数,VP_L); 0x10-0x1F: 对 VP 字地址的指定位 (0x10 对应 VP.0,0x1F 对应 VP.F) 进行调节, 调节范围必须设置为 0-1 0x14 Adj_Mode 1 调节方式 :0x00=-- 其它 =++ 0x15 Return_Mode 1 逾限处理方式 :0x00= 停止 ( 等于门限 ) 其它 = 循环调节 0x16 Adj_Step 2 调节步长,0x0000-0x7FFF 0x18 V_Min 2 下限 :2 字节整数 (VP_Mode=0x01 或 0x02 时, 仅低字节有效 ) 0x1A V_Max 2 上限 :2 字节整数 (VP_Mode=0x01 或 0x02 时, 仅低字节有效 ) 0x1C NULL 4 写 0x00 上图中,"+" "-" 两个触控按钮分别被配置为 ++ 增量 (Adj_mode=0x01) 和 增量 (Adj_mode=0x00) 当把范围设置为 0-1 时, 配合图标变量显示可以方便的设计出复选功能 ( 点击 1 下选中, 再点击取消 ) 北京迪文科技有限公司 dwinhmi@dwin.com.cn

15 4.4 拖动调节 (0x03) 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 必须为 0xFF** 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 必须为 0xFF** 0x0E TP_Code 2 0xFE03 0x10 0xFE 1 0xFE 0x11 *VP 2 变量地址指针 0x13 Adj_Mode 1 高 4 比特定义了数据返回格式 : 0x0*= 调节 VP 字地址 ( 整型数 ); 0x1*= 调节 VP 字地址的高字节地址 (1 字节无符号数,VP_H); 0x2*= 调节 VP 字地址的低字节地址 (1 字节无符号数,VP_L) 低 4bit 定义了拖动方式 : 0x*0= 横向拖动,0x*1= 纵向拖动 0x14 Area_Adj 8 有效调节区域 :Xs,Ys,Xe,Ye; 必须和 TP_Area( 触控区域 ) 一致 0x1C V_begain 2 起始位置对应的返回值, 整数 0x1E V_end 2 终止位置对应的返回值, 整数 为防止误操作, 须按压有效拖动区域超过 0.5 秒后拖动才启动 上图中, 刻度滑块是用滑块刻度指示 (0x02 变量 ) 实现的 拖动录入的优点是直观 快捷, 而且参数不会越界 当需要更精确的拖动录入时, 可以把拖动修改的变量同时用数据变量显示方式 (0x10 变量 ) 显示出来, 如下图所示 : 拖动调节不支持按键 (0x4F 寄存器保存的键码 ) 控制 北京迪文科技有限公司 dwinhmi@dwin.com.cn

16 4.5 RTC 设置 (0x04) 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE04 0x10 0xFE 1 0xFE 0x11 0x x x14 (x,y) 4 输入过程显示位置, 右对齐方式,(x,y) 是字符串右上角坐标 0x18 Color 2 输入字体显示颜色 0x1A Lib_ID 1 显示使用的 ASCII 字库位置,0x00= 默认字库 0x1B Font_Hor 1 字体大小,X 方向点阵数目 0x1C Cusor_Color 1 光标颜色,0x00= 黑色其它 = 白色 0x1D KB_Source 1 0x00= 键盘在当前页面 ; 其它 = 键盘不在当前页面 0x1E PIC_KB 2 键盘所在页面 ID, 仅当 KB_Source 不等于 0x00 时有效 0x20 0xFE 1 0xFE 0x21 AREA_KB 8 键盘区域 : 左上角坐标 (Xs,Ys), 右下角坐标 (Xe,Ye); 仅当 KB_Source 不等于 0x00 时有效 0x29 AREA_KB_Position 4 键盘在当前页面显示位置, 左上角坐标 ; 仅当 KB_Source 不等于 0x00 时有效 0x2D NULL 3 写 0x00 设计方法和 0x00 触控变量 _ 键盘不在当前界面基本一致 键盘不在当前界面上 (KB_Source=0x01): 触发输入法后 键盘不在当前界面上 (KB_Source=0x01): 键盘所在页面 北京迪文科技有限公司 dwinhmi@dwin.com.cn

17 4.6 按键值返回 (0x05) 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE05 0x10 0xFE 1 0xFE 0x11 *VP 2 变量地址指针 0x13 VP_Mode 1 0x00= 返回键值保存在 VP 字地址 ( 整型数 ); 0x01= 返回键值低字节保存在 VP 字地址的高字节地址 (VP_H); 0x02= 返回键值低字节保存在 VP 字地址的低字节地址 (VP_L); 0x10-0x1F: 把返回键值的最低位 (1bit) 写入 VP 字地址的指定位 (0x10 修改 VP.0,0x1F 修改 VP.F) 0x14 Key_Code 2 返回键值 0x16 NULL 10 写 0x 文本录入 (0x06) 输入文本键盘码表在文本录入的触控文件中, 两字节键码的低字节表示普通键码, 高字节表示大写键码 典型的文本录入键盘定义如下表所示 : 键码 普通 大写 键码 普通 大写 键码 普通 大写 键码 普通 大写 0x7E60 ` ~ 0x5171 q Q 0x4161 a A 0x5A7A z Z 0x2131 1! 0x5777 w W 0x5373 s S 0x5878 x X 0x4032 0x4565 e E 0x4464 d D 0x4363 c C 0x # 0x5272 r R 0x4666 f F 0x5676 v V 0x $ 0x5474 t T 0x4767 g G 0x4262 b B 0x % 0x5979 y Y 0x4868 h H 0x4E6E n N 0x5E36 6 ^ 0x5575 u U 0x4A6A j J 0x4D6D m M 0x & 0x4969 i I 0x4B6B k K 0x3C2C, < 0x2A38 8 * 0x4F6F o O 0x4C6C l L 0x3E2E. > 0x ( 0x5070 p P 0x3A3B ; : 0x3F2F /? 0x ) 0x7B5B [ { 0x2227 ' " 0x2020 SP SP 0x5F2D - _ 0x7D5D ] } 0x0D0D Enter Enter 0x2B3D = + 0x7C5C \ 注 : 文本键盘键码须小于 0x80(ASCII 码 ) 0x0D 键码录入会自动转换成 0x0D 0x0A;0x00 和 0xFF 键码禁用 键盘功能键码定义 键码 定义 说明 0x00F0 Cancel 取消录入返回, 不影响变量数据 0x00F1 Return 确认录入返回, 录入文本保存到指定变量位置 0x00F2 Backspace 向前 ( 退格 ) 删除一个字符 0x00F3 Delete 向后删除 1 个字符 0x00F4 CapsLock 大写锁定 如果启用, 对应按钮必须定义按钮按下的效果 0x00F7 Left 光标前移一个字符 ;GBK 汉字录入中用于翻页 0x00F8 Right 光标后移一个字符 ;GBK 汉字录入中用于翻页 使用键盘 (0x4F 寄存器保存的键码 ) 做文本录入时, 如果使用 CapsLock 键, 请把按钮的动画区域定义在需要提示 CapsLock 的区域 ; 这样定义后, 发送 CapsLock 键时, 屏幕的相应位置会自动显示 CapsLock 的区域图标提示 北京迪文科技有限公司 dwinhmi@dwin.com.cn

18 4.7.1 ASCII 文本录入 0x00 Pic_ID 2 页面 ID 0x02 TP_Area 8 触控按钮区域 :(Xs,Ys)(Xe,Ye) 0x0A Pic_Next 2 目标切换页面,0xFF** 表示不进行页面切换 0x0C Pic_On 2 按钮按压效果图所处的页面,0xFF** 表示没有按钮按压效果 0x0E TP_Code 2 0xFE06 0x10 0xFE 1 0xFE 0x11 *VP 2 变量地址指针 0x13 VP_Len_Max 1 文本变量最大长度, 字 (Word) 数目,0x01-0x7B; 文本保存到指定地址时, 自动在文本结束处加上 0xFFFF 作为结束符 ; 录入的文本变量实际可能占用最大变量空间 =VP_Len_Max+1 0x14 Scan_Mode 1 录入模式控制 :0x00= 重新录入 0x01= 打开原来文本再修改 0x15 Lib_ID 1 显示使用的 ASCII 字库位置,0x00= 默认字库 0x16 Font_Hor 1 字体大小,X 方向点阵数目 0x17 Font_Ver 1 字体大小,Y 方向点阵数目 (Lib_ID=0x00 时,Y 方向点阵数目必须为 2*X) 0x18 Cusor_Color 1 光标颜色,0x00= 黑色其它 = 白色 0x19 Color 2 文本显示颜色 0x1B Scan_Area_Start 4 录入文本显示区域左上角坐标 (Xs,Ys) 0x1F Scan_Return_Mode 1 0x55: 在 *(VP-1) 位置保存输入结束标记和有效数据长度 : *(VP-1) 高字节, 输入结束标记 :0x5A 表示输入结束, 输入过程为 0x00 *(VP-1) 低字节, 有效输入数据长度, 字节单位 0x00: 不返回输入结束标记和长度 ; 0x20 0xFE 1 0x21 Scan_Area_End 4 录入文本显示区域右下角坐标 (Xe,Ye) 0x25 KB_Source 1 键盘页面位置选择 :0x00= 键盘在当前页面 ; 其它 = 键盘不在当前页面 0x26 PIC_KB 2 以下数据, 仅当 KB_Source 不为 0x00 时有效 键盘所在页面 ID 0x28 AREA_KB 8 键盘页面上键盘区域坐标 : 左上角 (Xs,Ys) 右下角(Xe,Ye) 0x30 0xFE 1 0x31 AREA_KB_Position 4 键盘区域粘贴在当前页面显示的位置, 左上角坐标 0x36 NULL 11 写 0x00 注 : 迪文预装的 0# 字库包含 4*8-64*128 点阵的所有 ASCII 字符 北京迪文科技有限公司 dwinhmi@dwin.com.cn

19 5 显示变量配置文件 (14.BIN) 说明 显示变量配置文件由 N 条按照页面配置的变量指令组成, 每条变量指令固定占用 32 字节存储空间 每个页面固定分配 2KB(0x0800) 变量存储空间, 每个页面最多可以设置 64 个变量 显示变量配置文件最大 2MB, 可以配置最多 1024 个页面 相同类型的变量, 存储位置越靠后, 显示优先级越高 一条显示变量配置指令由以下 6 部分组成 : 序号 定义 数据长度 说明 1 0x5A 1 固定 2 Type 1 变量类别 3 *SP 2 变量描述文件从 Flash 加载后存储到数据存储区的地址指针,0xFFFF 表示不转存到数据存储区 4 Len_Dsc 2 变量描述内容的字长度 5 *VP 2 变量地址,0x0000-0x07FF, 有些无需指定地址的变量, 写 0x0000 即可 6 Description N 变量描述内容 5.1 图标变量 变量图标显示 (0x00) 0x00 0x5A00 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x x06 0x00 *VP 2 变量指针, 变量为整数格式 0x08 0x01 (x,y) 4 变量显示位置, 图标左上角坐标位置 0x0C 0x03 V_Min 2 变量下限, 越界不显示 0x0E 0x04 V_Max 2 变量上限, 越界不显示 0x10 0x05 Icon_Min 2 V_Min 对应的图标 ID 0x12 0x06 Icon_Max 2 V_max 对应的图标 ID 0x14 0x07:H Icon_Lib 1 图标库存储位置 0x15 0x07:L Mode 1 ICON 显示模式,0x00= 透明 ( 不显示背景 ) 其它 = 显示图标背景 北京迪文科技有限公司 dwinhmi@dwin.com.cn

20 5.1.2 动画图标显示 (0x01) 0x00 0x5A01 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000A 2 0x06 0x00 *VP 2 初始图标变量指针, 变量为双字, 低位字保留, 高位字无符号数 (0x0000-0x0FFFF) 用户数据控制动画图标显示 0x08 0x01 (x,y) 4 变量显示位置, 图标左上角坐标位置 0x0C 0x03 0x 固定 0x0E 0x04 V_Stop 2 变量为该值时显示固定图标 0x10 0x05 V_Start 2 变量为该值时自动显示动画图标 0x12 0x06 Icon_Stop 2 变量为 V_STOP 值时固定显示的图标 0x14 0x07 Icon_Start 2 变量为 V_Start 值时, 自动从 Icon_Start 到 Icon_End 显示图标, 0x16 0x08 Icon_End 2 形成动画 0x18 0x09:H Icon_Lib 1 图标库存储位置 0x19 0x09:L Mode 1 ICON 显示模式,0x00= 透明 当变量不等于 V_Stop 或者 V_Start 时, 不显示图标或者动画 北京迪文科技有限公司 dwinhmi@dwin.com.cn

21 5.1.3 滑块刻度指示 (0x02) 0x00 0x5A02 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000A 2 0x06 0x00 *VP 2 变量指针, 变量格式由 VP_DATA_Mode 决定 0x08 0x01 V_begain 2 对应起始刻度的变量值 0x0A 0x02 V_end 2 对应终止刻度的变量值 0x0C 0x03 X_begain 2 起始刻度坐标 ( 纵向为 Y 坐标 ) 0x0E 0x04 X_end 2 终止刻度坐标 ( 纵向为 Y 坐标 ) 0x10 0x05 Icon_ID 2 刻度滑动块的图标 ID 0x12 0x06 Y 2 刻度指示图标显示的 Y 坐标位置 ( 纵向为 X 坐标 ) 0x14 0x07:H X_adj 1 刻度指示图标显示的 X 坐标前移偏移量 ( 纵向为 Y),0x00-0xFF 0x15 0x07:L Mode 1 刻度模式 :0x00= 横向刻度条 01= 纵向刻度条 0x16 0x08:H Icon_Lib 1 图标库存储位置 0x17 0x08:L Icon_mode 1 ICON 显示模式,0x00= 透明 ( 不显示背景 ) 其它 = 显示图标背景 0x18 0x09:H VP_DATA_Mode 1 0x00:*VP 指向一个整型变量 0x01:*VP 指向一个整型变量的高字节数据 0x02:*VP 指向一个整型变量的低字节数据 北京迪文科技有限公司 dwinhmi@dwin.com.cn

22 5.1.4 艺术字变量显示 (0x03) 0x00 0x5A03 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x x06 0x00 *VP 2 变量指针 0x08 0x01 X,Y 4 起始显示位置 : 左对齐模式, 坐标为显示字符串左上角坐标 ; 右对齐模式, 坐标为显示字符串的右上角坐标 0x0C 0x03 Icon0 2 0 对应的 ICON_ID, 排列顺序为 x0E 0x04:H Icon_Lib 1 Icon 库位置 0x0F 0x04:L Icon_Mode 1 ICON 显示模式,0x00= 透明 ( 不显示背景 ) 0x01= 显示图标背景 0x10 0x05:H 整数位数 1 显示的整数位数 0x11 0x05:L 小数位数 1 显示的小数位数 0x00= 整数 (2 字节 ), 到 x12 0x06:H 变量数据类型 1 0x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x13 0x06:L 对齐模式 1 0x00= 左对齐 0x01= 右对齐 北京迪文科技有限公司 dwinhmi@dwin.com.cn

23 5.1.5 图片动画显示 (0x04) 0x00 0x5A04 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x x06 0x00 0x 固定 0x08 0x01 Pic_Begain 2 起始图片位置 0x0A 0x02 Pic_End 2 终止图片位置 0x0C 0x03:H Frame_Time 1 一帧 ( 一幅图片 ) 显示的时间, 单位为 8mS 起始图片位置必须小于终止图片位置 如果在 Pic_End 页面也设置图片动画变量, 将可以实现不断重播 串口指令切换图片或者触控指令切换图片可以结束重播 北京迪文科技有限公司 dwinhmi@dwin.com.cn

24 5.1.6 图标旋转指示 (0x05) 0x00 0x5A05 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000C 2 0x06 0x00 *VP 2 变量指针, 变量格式由 VP_Mode 决定 0x08 0x01 Icon_ID 2 指定的图标 ID 0x0A 0x02 Icon_Xc 2 ICON 图标上的旋转中心位置 :X 坐标 0x0C 0x03 Icon_Yc 2 ICON 图标上的旋转中心位置 :Y 坐标 0x0E 0x04 Xc 2 ICON 显示到当前屏幕的旋转中心位置 :X 坐标 0x10 0x05 Yc 2 ICON 显示到当前屏幕的旋转中心位置 :Y 坐标 0x12 0x06 V_Begain 2 对应起始旋转角度的变量值, 整型数, 越界不显示 0x14 0x07 V_End 2 对应终止旋转角度的变量值, 整型数, 越界不显示 0x16 0x08 AL_Begain 2 起始旋转角度,0-720(0x000-0x2D0), 单位 0.5 0x18 0x09 AL_End 2 终止旋转角度,0-720(0x000-0x2D0), 单位 0.5 0x1A 0x0A:H VP_Mode 1 0x00:*VP 指向一个整型变量 0x01:*VP 指向一个整型变量的高字节数据 0x02:*VP 指向一个整型变量的低字节数据 0x1B 0x0A:L Lib_ID 1 ICON 图标库 ID 0x1C 0x0B Mode 1 ICON 显示模式,0x00= 透明 ( 不显示背景 ) 其它 = 显示图标背景 本指令主要用于仪表刻度盘的指针指示 旋转始终假定为 顺时针 转动, 即 AL_End 必须大于 AL_Begain( 如果 AL_End 小于 AL_Begain, 系统处理时 会自动加上 360 ) 北京迪文科技有限公司 dwinhmi@dwin.com.cn

25 5.1.7 位变量图标显示 (0x06) 0x00 0x5A06 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000C 2 0x06 0x00 *VP 2 位变量指针, 字变量 0x08 0x01 *VP_AUX 2 辅助变量指针, 双字, 用户软件不能访问 0x0A 0x02 Act_Bit_Set 2 为 1 的 bit 位置说明 *VP 对应位置需要显示 0x0C 0x03:H Display_Mode 1 定义了显示模式 : Display_Mode Bit 值 0 1 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 动画 0x0D 0x03:L Move_mode 1 位图图标排列方式 : 0x00=X++,Act_Bit_Set 指定的不处理 bit 不保留位置 ; 0x01=Y++,Act_Bit_Set 指定的不处理 bit 不保留位置 ; 0x02=X++,Act_Bit_Set 指定的不处理 bit 保留 DIS_MOV 位置 ; 0x03=Y++,Act_Bit_Set 指定的不处理 bit 保留 DIS_MOV 位置 ; 0x0E 0x04:H Icon_Mode 1 ICON 显示模式 :0x00= 透明 0x01= 不透明 0x0F 0x04:L Icon_Lib 1 图标库存储位置 0x10 0x05 ICON0S 2 不显示动画模式,bit 0 图标 ID 显示动画模式,bit 0 图标动画起始 ID 位置 0x12 0x06 ICON0E 2 显示动画模式,bit 0 图标动画结束 ID 位置 0x14 0x07 ICON1S 2 不显示动画模式,bit 1 图标 ID 显示动画模式,bit 1 图标动画起始 ID 位置 0x16 0x08 ICON1E 2 显示动画模式,bit 1 图标动画结束 ID 位置 0x18 0x09 (x,y) 4 起始位变量显示位置, 图标左上角坐标位置 0x1C 0x0B DIS_MOV 2 下一个图标坐标移动坐标间隔 0x1E 2 写 0x00 北京迪文科技有限公司 dwinhmi@dwin.com.cn

26 5.2 文本变量 数据变量显示 (0x10) 0x00 0x5A10 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000D 2 0x06 0x00 *VP 2 变量指针 0x08 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x0C 0x03 COLOR 2 显示颜色 0x0E 0x04:H Lib_ID 1 ASCII 字库位置 0x0F 0x04:L 字体大小 1 字符 X 方向点阵数 0x10 0x05:H 对齐方式 1 0x00= 左对齐 0x01= 右对齐 0x02= 居中 0x11 0x05:L 整数位数 1 显示整数位 0x12 0x06:H 小数位数 1 显示小数位 整数位数和小数位数之和不能超过 10 0x00= 整数 (2 字节 ), 到 x13 0x06:L 变量数据类型 1 0x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x14 0x07:H Len_unit 1 变量单位 ( 固定字符串 ) 显示长度,0x00 表示没有单位显示 0x15 0x07:L String_Unit Max11 单位字符串,ASCII 编码 北京迪文科技有限公司 dwinhmi@dwin.com.cn

27 5.2.2 文本显示 (0x11) 0x00 0x5A11 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000D 2 0x06 0x00 *VP 2 文本指针 0x08 0x01 X,Y 4 起始显示位置, 显示字符串左上角坐标 0x0C 0x03 Color 2 显示文本颜色 0x0E 0x04 Xs Ys Xe Ye 8 文本框 0x16 0x08 Text_length 2 显示字节数量, 遇到 0xFFFF 数据或者显示到文本框尾将不再显示 0x18 0x09:H Font0_ID 1 编码方式 0x00 0x05, 以及编码方式 0x01-0x04 时 ASCII 字库位置 0x19 0x09:L Font1_ID 1 0x01-0x04 的非 ASCII 字符使用的字库 0x1A 0x0A:H Font_X_Dots 1 字体 X 方向点阵数 (0x01-0x04 模式,ASCII 字符 X 按照 X/2 计算 ) 0x1B 0x0A:L Font_Y_Dots 1 字体 Y 方向点阵数目 0x1C 0x0B:H Encode_Mode 定义了文本编码方式 : 0=8bit 编码 1=GB2312 内码 2=GBK 3=BIG5 4=SJIS 5=UNICODE 0x1D 0x0B:L HOR_Dis 1 字符水平间隔 0x1E 0x0C:H VER_Dis 1 字符垂直间隔 0x1F 0x0C:L 未定义 1 写 0x00 注意, 文本显示时, 字库中字体的 Y 方向点阵数目必须为偶数 DGUS 屏预装的 0# 字库, 包含 4*8-64*128 点阵的所有 ASCII 字符 北京迪文科技有限公司 dwinhmi@dwin.com.cn

28 5.2.3 RTC 显示 (0x12) 文本 RTC 显示 0x00 0x5A12 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000D 2 0x06 0x00 0x x08 0x01 X,Y 4 显示位置, 显示字符串左上角坐标 0x0C 0x03 Color 2 字体颜色 0x0E 0x04:H Lib_ID 1 字库位置 0x0F 0x04:L 字体大小 1 X 方向点阵数目 0x10 0x05 String_Code MAX16 编码字符串, 使用 RTC 编码表和 ASCII 字符构成 假设当前时间是 :00:00 星期三, 那么 Y-M-D H:Q:S 0x00 将显示为 :00:00 M-D W H:Q 0x00 将显示为 WED 12:00 RTC 编码表 : 说明 编码 显示格式 公历 _ 年 Y 公历 _ 月 M 公历 _ 日 D 公历 _ 小时 H 公历 _ 分钟 Q 公历 _ 秒 S 公历 _ 星期 W SUN MON TUE WED THU FRI SAT 编码结束 0x00 表盘时钟显示 0x00 0x5A12 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000D 2 0x06 0x00 0x x08 0x01 X,Y 4 时钟表盘的指针中心 0x0C 0x03 Icon_Hour 2 时针 ICON 的 ID,0xFFFF 表示时针不显示 0x0E 0x04 Icon_Hour_Central 4 时针 ICON 的旋转中心位置 0x12 0x06 Icon_Minute 2 分针 ICON 的 ID,0xFFFF 表示分针不显示 0x14 0x07 Icon_Minute_Central 4 分针 ICON 的旋转中心位置 0x18 0x09 Icon_Second 2 秒针 ICON 的 ID,0xFFFF 表示秒钟指针不显示 0x1A 0x0A Icon_Second_Central 4 秒针 ICON 的旋转中心位置 0x1E 0x0C:H ICON_Lib 1 指针图标所在的 ICON 库文件 ID 0x1F 未定义 1 写 0x00 北京迪文科技有限公司 dwinhmi@dwin.com.cn

29 5.2.4 时间变量显示 (0x13) 0x00 0x5A13 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000D 2 变量指针数据串首地址, 变量为 BCD 编码 0x06 0x00 *VP 2 如果半字节数据超过 0x9, 将显示成 HEX 码, 比如 : 数据 0x32 显示为 32 数据 0xBF 将显示为 BF 0x08 0x01 X,Y 4 显示起始位置, 显示字符串左上角坐标 0x0C 0x03 Color 2 字体颜色 0x0E 0x04:H Byte_Num 1 *VP 指针高字节开始显示的字节数目,0x01-0x0F 0x0F 0x04:L Lib_ID 1 字库位置 ; 字库必须是半角方式 如果 Lib_ID 不为 0, 字库必须使用 8bit 编码 0x10 0x05:H Font_x 1 X 方向点阵数目, 始终使用 0# 字库, 半角显示 0x11 0x05:L String_Code MAX15 编码字符串, 用来和时间变量组合出客户需要的显示格式 每显示一个 BCD 时间码后, 会到编码字符串顺序取出一个 ASCII 字符来间隔显示 编码字符串中, 特殊字符定义如下 : 0x00: 无效, 本字符不显示, 两个 BCD 时间码将连在一起显示 ; 0x0D: 换行显示, 即 X=Xs,Y=Y+Font_X*2 北京迪文科技有限公司 dwinhmi@dwin.com.cn

30 5.3 图形变量 实时曲线显示 (0x20) 0x00 0x5A20 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000A 2 0x06 0x00 0x 无定义 0x08 0x01 Xs:Ys:Xe:Ye 8 曲线窗口 : 左上角坐标 (Xs,Ys), 右下角坐标 (Xe,Ye); 曲线越界将不显示 0x10 0x05 Y_Central 2 曲线中心轴位置 0x12 0x06 VD_Central 2 中心轴对应的的曲线数据值, 一般取最大数据和最小数据和的 50% 0x14 0x07 Color 2 曲线颜色 0x16 0x08 MUL_Y 2 纵轴放大倍数, 单位是 1/256,0x0000-0x7FFF 0x18 0x09:H CHANEL 1 数据源通道,0x00-0x01 0x19 0x09:L Dis_HOR 1 横轴间隔,0x01-0xFF 曲线数据用 0x84 指令发送, 请参考 2.2 指令集说明 如果把变量描述内容存储在数据存储空间 (*SP 指定存储位置 ), 那么 : 结合 0x02 增量触控指令, 可以实现无需要用户代码干预的曲线自动缩放 ; 结合 0x03 拖动触控指令修改 Y_Central 值, 可以实现无需要用户代码干预的曲线上下移动 满量程曲线的纵轴放大倍数计算 : 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 北京迪文科技有限公司 dwinhmi@dwin.com.cn

31 5.3.2 基本图形显示 (0x21) 0x00 0x5A21 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x x06 0x00 *VP 2 变量数据指针 0x08 0x01 Area 8 绘图显示区域定义 : 指定区域的左上角 右下角坐标 ; 绘图越界将不显示 仅对 0x0001-0x0005 0x0009 0x000A 0x000B 指令有效 变量数据格式说明地址 定义 说明 VP CMD 绘图指令 VP+1 Data_Pack_Num_Max 最大数据包数目 : 连线指令 (0x0002), 定义为连线线条数目 ( 顶点数 -1); VP+2 DATA_Pack 数据 绘图指令数据包说明 指令绘图数据包格式说明 ( 相对地址和长度单位均为字 (word)) 操作 (CMD) 相对地址长度定义说明 0x0001 置点 0x00 2 (x,y) 置点坐标位置,x 坐标高字节为判断条件 0x02 1 Color 置点颜色 0x00 1 Color 线条颜色 0x0002 连线 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 坐标高字节为判断条件 0x0003 矩形 0x02 2 (x,y)e 矩形框右下角坐标 0x04 1 Color 矩形颜色 0x00 2 (x,y)s 矩形域左上角坐标,x 坐标高字节为判断条件 0x0004 矩形域填充 0x02 2 (x,y)e 矩形域右下角坐标 0x04 1 Color 矩形域填充颜色 0x00 2 (x,y) 圆心坐标,x 坐标高字节为判断条件 0x0005 圆 0x02 1 Rad 半径 0x0006 图片区域剪切 粘贴 0x03 1 Color 圆颜色 0x00 1 Pic_ID 剪切图片区域所在页面 ID; 高字节为判断条件 0x01 2 (x,y)s 剪切图片区域左上角坐标 0x03 2 (x,y)e 剪切图片区域右下角坐标 0x05 2 (x,y) 剪切图片区域粘贴到当前页面的坐标位置, 左上角坐标 0x00 2 (x,y) 显示坐标位置,x 坐标高字节为判断条件 ICON 图标 0x**07 图标 ID, 图标库位置由指令高字节指定 显示 0x02 1 ICON_ID 图标固定为不显示背景色 0x00 1 Color0 把 (X0,Y0s)(X0,Y0e) 用 Color0 颜色连线,X0 高字节为判断条件 0x0009 垂直线条 X0,Y0s,Y0 0x01 3 e 判断条件 :0xFF 绘图操作结束 0xFE 本次操作跳过 ( 忽略 ) 北京迪文科技有限公司 dwinhmi@dwin.com.cn

32 6 开发步骤 ( 首次使用必读 ) 迪文 Mini DGUS 屏功能架构简图 与传统的 LCM 通过时序或者指令控制显示不同,Mini DGUS 屏采用直接变量驱动显示方式, 所有的显示和操作都是基于预先设置好的变量配置文件来工作的 两种不同的工作方式导致用户应用时的软件架构和二次开发难度完全不同 举例, 假设做一个简单的触摸屏温控仪, 要在当前页面显示测量温度, 点击触摸屏切换到设置页面进行参数设置 两种不同开发方式下的软件流程图如下 : 上面的例子, 只是一个两个参数 两个页面的最简单 GUI, 如果对于实际应用中稍微 高级 一点的产品, 几十个参数, 几十个页面, 还要考虑动画 图标等等吸引眼球的 GUI, 前一种方式需要 1 个优秀工程师加班加点干 1 年, 而使用 Mini DGUS 屏开发,3-4 个工程师 ( 可以并行协同做 )2-3 天就搞定了 北京迪文科技有限公司 dwinhmi@dwin.com.cn

33 总的来说,Mini DGUS 屏是基于配置文件来工作的, 所以整个开发过程也就是通过 PC 软件辅助设计完成变量配置文件的过程, 基本开发流程如下 : 第 1 步 : 变量规划变量规划基本遵循两个基本原则 : a. 数据变量尽可能地址连续, 以便于读 / 写 ; b. 参数描述变量和数据变量的地址要分开, 并且不要交叉 强烈推荐客户开发过程中用 Excel 表格来记录 整理好变量分配记录, 便于将来的修改 升级维护 第 2 步 : 界面设计利用 PS( 或者其它绘图软件 ) 进行界面及界面相关元素 ( 图标 字库 ) 设计 设计过程中, 请选择调色板系统为 65K 色, 确保最终显示效果和设计效果一致 如果想让您的产品至少看起来很有价值, 建议委托专业美工或者工业设计公司来设计 UI 和相关界面, 一般收费在 200 人民币 /1 个页面左右, 一般的产品, 界面页面数目都在 个之间 第 3 步 : 界面配置利用迪文提供的工具软件进行界面的配置, 生成触控配置文件和变量配置文件 第 4 步 : 测试修改把配置文件 图片 字库 图标库等借助 SD 卡下载到 Mini DGUS 屏, 进行界面测试和修改 ( 第 2-3 步 ) 把串口连上用户 MCU 系统, 进行数据联调 第 5 步 : 定版归档定版后, 把配置文件 图片 字库 图标库等 Mini DGUS 屏涉及的文件保存在一张 SD 卡转生产即可 Mini DGUS 屏只能通过 SD 卡接口来进行资料的更新和字库数据的倒出 如果不希望最终客户通过 SD 卡接口改变或者倒出内部数据, 可以对 SD 卡接口加密锁死 注意, 用户必须保管好 SD 卡的开锁密码, 一旦 SD 卡锁死, 除非输入开锁密码, 没有其它办法能够使 SD 卡接口再次启用 北京迪文科技有限公司 dwinhmi@dwin.com.cn

34 附录 1 Mini DGUS 主要功能一览 1 变量录入及显示 :0xFE00 变量数据录入 ( 选择键盘不在当前页面实现弹出键盘 );0x5A10 数据变量显示 2 变量 调节及显示 :0xFE02 增量调节 ;0x5A10 数据变量显示 3 变量拖动调节 ( 滑块跟随 ):0xFE03 拖动调节 ;0x5A02 滑块刻度指示 4 时间的设置及显示 :0xFE04 RTC 设置 ( 与 0xFE00 变量数据录入类似 );0x5A12 RTC 显示 ( 有表盘和文 本两种时间显示方式 ) 5 刻度条 状态条 :0x5A00 变量图标显示 ( 对应不同变量值显示不同图标 ) 0x5A01 动画图标显示 ( 当变 量为某特定值时依次显示多个图标, 循环形成动画 ) 6 仪表盘 :0x5A05 图标旋转指示 7 文本输入及显示 :0xFE06 文本录入 ( 支持 ASSII 码文本输入 );0x5A11 文本显示 8 开机动画 电子相册 :0x5A04 图片动画显示 9 曲线显示及调节 :0x5A20 实时曲线显示 ( 最多支持 2 条通道同时接收数据显示实时曲线 );0xFE03 拖动调节 ;0x5A02 滑块刻度指示 ;0xFE01 增量调节 可实现无代码干涉, 调节曲线缩放及中心轴位置 北京迪文科技有限公司 dwinhmi@dwin.com.cn

35 北京迪文科技有限公司 dwinhmi@dwin.com.cn

36 附录 2 修订记录日期 修订内容 Mini DGUS 版本 首次发布 V 增加 CRC 校验 快速刷新 R2 寄存器可写功能 V 修改 CRC 校验格式表述错误 V2.1 使用本文档或迪文 Mini DGUS 屏过程中如存在任何疑问, 或欲了解更多迪文 Mini DGUS 屏的最新信息, 欢迎 mail 到 dwinhmi@dwin.com.cn 联系我们 感谢大家一直以来对迪文的支持, 您的支持是我们进步的动力! 谢谢大家! 北京迪文科技有限公司 dwinhmi@dwin.com.cn