Microsoft Word - DGUS开发指南_V10.doc

Transcription

1 专业素养. 诚实守信. 追求卓越 迪文 DGUS 屏用户开发指南 (Ver ) 北京迪文科技有限公司

2 目录 1 硬件配置 SD 卡配置接口 CONFIG.TXT 配置文件说明 存储器空间说明 字库空间 图片空间 寄存器空间 ( 使用 0x80/0x81 串口指令访问 ) 变量存储器空间 ( 使用 0x82/0x83 串口指令访问 ) 曲线数据缓冲区 ( 使用 0x84 串口指令访问 ( 只写 )) 软件升级步骤 触摸屏校准 SD 卡接口的禁止和重新启用 基于 DWIN OS 的用户程序运行 串口操作 数据帧架构 指令集 数据格式 触控配置文件 (13.BIN) 说明 变量数据录入 (0x00) 弹出菜单选择 (0x01) 增量调节 (0x02) 拖动调节 (0x03) RTC 设置 (0x04) 按键值返回 (0x05) 文本录入 (0x06) ASCII 文本录入 GBK 汉字文本录入 硬件参数配置 (0x07) 显示变量配置文件 (14.BIN) 说明 图标变量 变量图标显示 (0x00) 动画图标显示 (0x01) 滑块刻度指示 (0x02) 艺术字变量显示 (0x03) 图片动画显示 (0x04) 图标旋转指示 (0x05) 位变量图标显示 (0x06) 文本变量 数据变量显示 (0x10) 文本显示 (0x11) RTC 显示 (0x12) 时间变量显示 (0x13) 图形变量 实时曲线显示 (0x20) 基本图形显示 (0x21) 列表显示 (0x22) 特殊行业应用需求 (0x23) 开发步骤 ( 首次使用必读 )...36 附录 1 修订记录...38 北京迪文科技有限公司 dwinhmi@dwin.com.cn

3 1 硬件配置 1.1 SD 卡配置接口迪文 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 号字库 生成 输入法词库 12*.BIN 12_PY_DGUS.BIN 迪文预装 触控配置 13*.BIN 13 触控配置文件.BIN 迪文 DGUS 组态软件生成 变量配置 14*.BIN 14 变量配置文件.BIN 迪文 DGUS 组态软件生成 变量初始化 22*.BIN 22 变量初始化.BIN 用户代码 23*.BIN 23 水处理.BIN 基于 DWIN OS 硬件设置 CONFIG.TXT CONFIG.TXT 检测到 SD 卡后,DGUS 会显示蓝屏提示用户检测到 SD 卡, 然后开始数据下载 ; SD 卡下载完成后,DGUS 屏会自动复位一次 北京迪文科技有限公司 dwinhmi@dwin.com.cn

4 1.2 CONFIG.TXT 配置文件说明 CONFIG.TXT 文件采用类似脚本语言的方式来描述参数寄存器, 每一行描述一个参数, 不用的参数可以不写, 说明如下 : 参数寄存器名称取值范围说明 R0 取决于 DGUS 屏 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 0x11 波特率 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 串口帧头高字节 R4 取决于 DGUS 屏 DGUS 屏驱动模式选择, 配置错误会导致显示异常, 用户不要配置 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 串口帧头低字节 RC 不定 AUX_CFG 配置字, 按位 (bit) 定义, 说明如后 配置文件的参数均为一字节的 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= 不启用串口通信的 CRC16 帧校验 1= 启用串口通信的 CRC16 帧校验.3 0x08 TPSAUTO 0= 触摸屏录入参数后不自动上传 ( 用户查询 ); 1= 触摸屏录入参数后是否自动上传到串口由相应触控变量的配置决定.2 0x04 L22_Init_En 0=56KB 变量存储器上电初始化数据为 0x00; 1=56KB 变量存储器上电初始化数据由 22(0x16) 字库文件加载 设置 DGUS 周期,DGUS 周期越小则变量响应越灵敏, 但处理变量的能力越低.1 0x02 FRS1 DGUS 周期 80mS 120mS 160mS 200mS FRS FRS x01 FRS0 对于 1024*768 分辨率, 建议 DGUS 周期设置成 120mS 以上 DGUS 周期会影响动画图标显示的动画速度 VDS 和 HDS 控制屏显示模式说明 北京迪文科技有限公司 dwinhmi@dwin.com.cn

5 RC(AUX_CFG 配置字 ) 说明 位 权重 定义 说明.7 0x80 系统保留 写 0.6 0x40 RUN_OS_EN 0= 不运行 DWIN OS 程序, 等效在 CONFIG.TXT 文件中写 STOP_DWIN_OS ; 1= 运行 DWIN OS 程序, 等效在 CONFIG.TXT 文件中写 RUN_DWIN_OS.5 0x20 TP_BUZZ_EN 0= 点击触摸屏有效区域时有蜂鸣器提示音 ; 1= 点击触摸屏有效区域时无蜂鸣器提示音, 但仍旧可以通过向 0x02 寄存器写入数据控制蜂鸣器鸣叫.4 0x10 PAGE128_EN 0= 每页最大显示变量数目为 64 个 1= 每页最大显示变量数目为 128 个.3 0x08 未定义 写 0.2 0x04 未定义 写 0.1 0x02 未定义 写 0.0 0x01 未定义 写 存储器空间说明 字库空间迪文 DGUS 软件使用用 32MB FLASH 存储器做为字库存储器, 并划分为 128 个大小为 256KB 的字库空间, 对应字库文件 ID 为 0-127, 说明如下 : 字库 ID 大小 说明 备注 KB 0#ASCII 字库 0_DWIN_ASC.HZK KB 拼音输入法词库 12_PYK.BIN KB 触控配置文件 13_ 触控.BIN KB 变量配置文件 ( 最多 1024 或 512 页, 每页最多 64 或 128 个变量 ) 14_ 变量.BIN KB 变量初始化文件 (56KB 变量存储器上电初始值 ) 22_ 变量初始化.BIN KB 可后台运行的基于 DWIN OS 用户程序存储空间 23_ 用户程序.BIN MB 字库 图标库 ( 其中 字库也可以做为用户数据库 ) 用户自定义 字库空间保存的数据可以用 SD 卡直接导出, 方法是在 DWIN_SET 文件夹下事先放置一个以字库 ID 命名, 后缀为 DAT 的 ( 比如,32 测试.DAT) 文件, 文件须大于或等于 256KB 的文件 DGUS 会读取相应的字库并覆盖该文件的前 256KB 数据 图片空间 迪文 DGUS 软件使用 224MB(256MB 版本 K600+) 或者 2016MB(2GB 版本 K600+) 来保存图片, 对应不同分 辨率的图片保存数量如下表所示 : 屏幕分辨率 256MB 版本 K600+ 2GB 版本 K 北京迪文科技有限公司 dwinhmi@dwin.com.cn

6 1.3.3 寄存器空间 ( 使用 0x80/0x81 串口指令访问 ) 迪文 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 RUN_TIME 4 上电后运行时间,BCD 码时分秒, 其中小时为两个字节, 最大 9999:59:59 0x10-0x1C R0-RC 13 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-0x3F 保留 16 未定义 0x40 En_Lib_OP 1 0x5A 表示用户申请进行字库存储器操作,DGUS 操作完后清零 0x41 Lib_OP_Mode 1 0x50: 把指定的变量存储器空间数据写入指定字库空间 0xA0: 把指定字库空间的数据读入变量存储器空间 0x42 Lib_ID 1 指定的字库空间,0x40-0x7F, 每个字库 128KW, 对应最大 Flash 空间为 8MW(16MB) 0x43 Lib_Address 3 指定字库空间的数据操作首 ( 字 ) 地址,0x00:00:00-0x01:FF:FF 0x046 VP 2 指定变量存储器空间的数据操作首 ( 字 ) 地址,0x00:00-0x6F:FF 0x48 OP_Length 2 数据操作的 ( 字 ) 长度,0x00:01-0x6F:FF 把 0x1000 开始的 1KW 变量数据保存到 64# 字库 0x0000 开始的位置, 串口下发指令举例 : A5 5A 0C A x4A Timer0 2 16bit 软件定时器, 单位为 4mS, 自减到零停止 0x4C Timer1 1 8bit 软件定时器, 单位为 4mS, 自减到零停止 0x4D Timer2 1 8bit 软件定时器, 单位为 4mS, 自减到零停止 0x4E Timer3 1 8bit 软件定时器, 单位为 4mS, 自减到零停止 设置值和实际运行值之间有 +/-4mS 误差, 比如设置为 2, 实际运行值在 4-12mS 之间 0x4F Key_code 1 用户键码, 用于触发 0x13 触控文件 ;0x01-0xFF,0x00 表示无效 DGUS 处理键码后会自动清零键码寄存器 0x50-0xED 保留 158 未定义 0xEE-0xEF Reset_Triger 2 写入 0x5AA5 导致 DGUS 屏软件复位一次 0xF0-0xFF 保留 16 保留 变量存储器空间 ( 使用 0x82/0x83 串口指令访问 ) 迪文 DGUS 屏提供了 28KW(56KB) 的 SRAM 做为用户变量存储器, 用于 GUI 变量数据的存储 在读写实时 性 (ms 级别 ) 要求不高时, 可以做为用户的外扩串口访问存储器 (RMA) 变量存储器空间只能按照字 (Word) 读写, 对应地址空间为 0x0000-0x6FFF 曲线数据缓冲区 ( 使用 0x84 串口指令访问 ( 只写 )) 为了简化实时曲线的显示, 迪文 DGUS 屏设计有一个曲线数据缓冲区用来缓存用户的曲线数据, 曲线缓冲区不占用数据存储器空间, 最多可以同时缓冲 8 条曲线 曲线数据缓冲区只能按照字 (Word) 写, 每个曲线点的数据均用 2 字节无符号整数表示 北京迪文科技有限公司 dwinhmi@dwin.com.cn

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

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

9 2 串口操作迪文 DGUS 屏采用异步 全双工串口 (UART), 串口模式为 8n1(51 单片机的 MOD1,9bit UART), 即每个数据传送采用 10 个位 :1 个起始位,8 个数据位,1 个停止位 串口波特率通过 SD 卡来配置 串口的所有指令或者数据都是 16 进制 (HEX) 格式 ; 对于字型 (2 字节 ) 数据, 总是采用高字节先传送 (MSB) 方式 比如 0x1234 传送时先传送 0x12 升级安装 DGUS 软件后, 原来 DGUS 屏上的 BUSY 信号无效, 请保持浮空即可 DGUS 屏的串口接收 FIFO 为 4KB, 即 1 个 DGUS 周期 (80/120/160/200mS) 内可以传送至少 4KB 数据 ( 约等于 bps 波特率连续发送 ); 一个 DGUS 周期能够传送的最大数据长度取决于用户界面的复杂程度 ; 推荐客户在一个 DGUS 周期内不要发送超过 4KB 的数据给 DGUS 屏 2.1 数据帧架构迪文 DGUS 屏的串口数据帧由 4 个数据块组成, 如下表所述 : 数据块 定义帧头数据长度指令数据指令和数据的 CRC 校验 数据长度 N 2 CONFIG.TXT 配置文数据长度包括指 CONFIG.TXT 配置文件的 R2 决说明 0x80-0x84 件的 R3:RA 定义 令 数据和校验定是否启用一个数据包能够传送的最大数据长度为 254 字节 ( 不要 CRC 校验 ) 或 252 字节 ( 带 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 读寄存器的 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 读数据存储器的 DGUS 屏应答写曲线缓冲区数据 CH_Mode 定义了后续数据的通道排列顺序 : CH_Mode 的每个位 (bit) 对应 1 个通道 ; CH_Mode.0 对应 0 通道,.7 对应 7 通道 ; 写曲线缓冲区 0x84 CH_Mode(Byte)+DATA0(Word)+ +DATAn 位置 1 表示对应的通道数据存在 ; 数据按照低通道数据在前排列 比如 CH_Mode=0x83( B), 表示后续数据格式为 : ( 通道 0+ 通道 1+ 通道 7)+ +( 通道 0+ 通道 1+ 通道 7) 寄存器的访问以字节 (Byte) 为数据单位, 而数据存储器 曲线缓冲区的访问以字 (Word) 为数据单位 关于存储器的定义和说明, 请参考 1.3 存储器空间说明 3 数据格式由于主要面向 MCU 等嵌入式系统应用, 为了用户处理的方便, 迪文 DGUS 软件使用的数据采用整数 ( 字 ) 无符号整数 ( 字 ) 长整数 ( 双字 ) 超长整数 (4 个字 ) 表示, 相关表示范围如下 : 整数 :-32768(0x8000) 到 (0x7FFF) 无符号整数 :0(0x0000) 到 65535(0xFFFF) 长整数 : (0x ) 到 (0x7FFFFFFF) 超长整数 : 到 小数采用定点小数表示, 用户自定义小数位数, 比如 0x4D2(1234), 规定小数为 2 位时, 表示 迪文 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

10 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**( 或者 0xFD**) 表示触控功能按键, 比如 0xFE00 表示启动变量数据触摸屏录入 0xFE** 的功能按键可以由 R2.3 设置成变量改变后是否自动上传,0xFD** 的功能按键始终禁止变量改变后自动上传 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 字节变量, 整数 到 32767, 无符号整数 x01=4 字节变量, 长整数 到 无符号长整数 x02=*VP 高字节, 无符号数 0 到 255 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x14 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 输入过程中有效键码 : 0x0030-0x0039,0x002E(.),0x002D(+/-),0x00F0( 取消 ),0x00F1( 确认 ),0x00F2( 退格 ) 北京迪文科技有限公司 dwinhmi@dwin.com.cn

11 键盘和输入启动按钮在一个页面 (KB_Source=0x00) 键盘不在当前界面上 (KB_Source=0x01): 触发输入法后 键盘不在当前界面上 (KB_Source=0x01): 键盘所在页面 北京迪文科技有限公司 dwinhmi@dwin.com.cn

12 4.2 弹出菜单选择 (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

13 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

14 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

15 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

16 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

17 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 键盘区域粘贴在当前页面显示的位置, 左上角坐标 0x35 DISPLAY_EN 1 0x00: 输入过程正常显示 0x01: 输入过程显示 "*", 用于密码输入 0x36 NULL 10 写 0x00 注 : 迪文预装的 0# 字库包含 4*8-64*128 点阵的所有 ASCII 字符 北京迪文科技有限公司 dwinhmi@dwin.com.cn

18 4.7.2 GBK 汉字文本录入 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_GBK1 1 汉字字符显示使用的 GBK 字库 ID,ASCII 字符默认使用 0x00 字库 0x16 Lib_GBK2 1 录入过程, 汉字字符显示使用的 GBK 字库 ID 0x17 Font_Scale1 1 Lib_GBK1 字体大小, 点阵数目 0x18 Font_Scale2 1 Lib_GBk2 字体大小, 点阵数目 0x19 Cusor_Color 1 光标颜色,0x00= 黑色其它 = 白色 0x1A Color0 2 录入文本显示颜色 0x1C Color1 2 录入过程中文本显示颜色 0x1E PY_Disp_Mode 1 录入过程中, 拼音提示和对应汉字的显示方式 : 0x00= 拼音提示显示在上边, 对应的汉字显示另起一行显示在下面 ; 拼音提示和汉字显示左对齐, 行间距为 Scan_Dis 0x01= 拼音提示显示在左边, 对应的汉字提示在右边显示 ; 汉字提示起始显示 x 位置在 Scan1_Area_Start+3 Font_Scale2+Scan_Dis 0x1F Scan_Return_Mode 1 0xAA: 在 *(VP-1) 位置保存输入结束标记和有效数据长度 : *(VP-1) 高字节, 输入结束标记 :0x5A 表示输入结束, 输入过程为 0x00 *(VP-1) 低字节, 有效输入数据长度, 字节单位 0xFF: 不返回输入结束标记和长度 ; 0x20 0xFE 1 0x21 Scan0_Area_Start 4 录入文本显示区域左上角坐标 (Xs,Ys) 0x25 Scan0_Area_End 4 录入文本显示区域右下角坐标 (Xe,Ye) 0x29 Scan1_Area_Start 4 录入过程中拼音提示文本显示区域的左上角坐标 0x2D Scan_Dis 1 录入过程显示中, 每个汉字显示的间距 每行固定显示最多 8 个汉字 0x2E 0x00 1 0x2F KB_Source 1 键盘页面位置选择 :0x00= 键盘在当前页面 ; 其它 = 键盘不在当前页面 0x30 0xFE 1 0x31 PIC_KB 2 以下数据, 仅当 KB_Source 不为 0x00 时有效 键盘所在页面 ID 0x33 AREA_KB 8 键盘页面上键盘区域坐标 : 左上角 (Xs,Ys) 右下角(Xe,Ye) 0x3B AREA_KB_Position 4 键盘区域粘贴在当前页面显示的位置, 左上角坐标 0x3F 0x02 1 注 : 拼音 bd 对应所有 GBK 编码的全角标点符号录入 ; 迪文预装的 0# 字库包含 4*8-64*128 点阵的所有 ASCII 字符 不使用触摸屏, 使用键盘 (0x4F 寄存器保存的键码 ) 来做 GBK 录入时, 必须用 0x01-0x08 键码来选择对 应的汉字 北京迪文科技有限公司 dwinhmi@dwin.com.cn

19 GBK 汉字文本录入的两种模式说明 : 北京迪文科技有限公司 dwinhmi@dwin.com.cn

20 4.8 硬件参数配置 (0x07) 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 0xFE07 0x10 0xFE 1 0xFE 0x11 Mode 1 操作模式选择, 见 操作模式表 说明 0x12 DATA_PACK 14 操作模式数据包, 见 操作模式表 说明 操作模式表 Mode Data_Pack Data_Pack 说明 功能 0x00 无 无 加载寄存器变量区数据到 0x6F00-0x6FFF 变量存储器空间 ( 占据低字节 ); 0x01 无 无 加载 0x6F00-0x6FFF 变量存储器空间 ( 占据低字节 ) 数据到寄存器变量区 ; 同时改写对应的 R1-R3,R5-RA SD 卡接口配置变量 Tran_Area 将要转换的区域坐标 : 将指定区域的内容转换成单色位图 ( 纵向取模打印位图格式 ), 并保存左上角 右下角到 VP 指针指向的数据存储器 *VP 保存转换位图数据的 1. 区域宽度 (Xe-Xs+1) 必须是偶数 ; 缓冲区首地址 2. 区域高度 (Ye-Ys+1) 必须是 8 的倍数 ; 3.*VP 指针保存数据格式如下 : 0x02 *VP: 状态位, 处理完成后设置成 0x5555; *VP+1: 横向字长度 =(Xe-Xs+1)&0xFFFE/2; *VP+2: 数据段个数 =(Ye-Ys+1)&0xFFF8/8; *VP+3: 位图数据开始,MSB 方式 如果启用了 参数自动上传功能 (R2.3=1), 那么转换完成后, 会按照 *VP 内容被修改成 0x5555 而自动上传一条提示信息 本指令主要用于屏幕内容的打印输出 0x03 *VP 数据指针把 *VP 指针位置开始的,Tx_Len 字节长度的数据发送到用户串口 Tx_LEN 要发送的数据长度 Tx_Len 是一个字变量, 长度从 0x0001-0xFFFF 0x04 功能同 0x03, 区别在于数据发送到 COM2( 系统保留串口 ) 将指定区域的内容转换成单色位图 ( 横向取模打印位图格式 ), 并保存 Tran_Area 将要转换的区域坐标 : 到 VP 指针指向的数据存储器 左上角 右下角 1. 区域宽度 (Xe-Xs+1) 必须是 16 的倍数 ; 2.*VP 指针保存数据格式如下 : *VP: 状态位, 处理完成后设置成 0x5555; 0x05 *VP+1: 横向字长度 =(Xe-Xs+1)&0xFFF0/16; *VP+2: 数据段个数 =(Ye-Ys+1); *VP 保存转换位图数据的 *VP+3: 位图数据开始,MSB 方式 缓冲区首地址如果启用了 参数自动上传功能 (R2.3=1), 那么转换完成后, 会按照 *VP 内容被修改成 0x5555 而自动上传一条提示信息 本指令主要用于屏幕内容的打印输出 0x06 Frame_Head 帧头 (2 字节 ) 把当前点击位置的触摸屏坐标发到 COM2( 系统保留串口 ), 格式如下 : Frame_End 帧尾 (2 字节 ) Frame_Head+X+Y+Check(X,Y 的 1 字节累加和 )+Frame_end 北京迪文科技有限公司 dwinhmi@dwin.com.cn

21 5 显示变量配置文件 (14.BIN) 说明 显示变量配置文件由 N 条按照页面配置的变量指令组成, 每条变量指令固定占用 32 字节存储空间 每个页面固定分配 2KB 或 4KB(0x0800 或 0x1000) 变量存储空间, 每个页面最多可以设置 64 或 128 个变量 显示变量配置文件最大 2MB, 可以配置最多 1024 个页面 相同类型的变量, 存储位置越靠后, 显示优先级越高 一条显示变量配置指令由以下 6 部分组成 : 序号 定义 数据长度 说明 1 0x5A 1 固定 2 Type 1 变量类别 3 *SP 2 变量描述文件从 Flash 加载后存储到数据存储区的地址指针,0xFFFF 表示不转存到数据存储区 4 Len_Dsc 2 变量描述内容的字长度 5 *VP 2 变量地址,0x0000-0x6FFF, 有些无需指定地址的变量, 写 0x0000 即可 当变量地址高字节为 0xFF 时, 本条指令将被取消 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

22 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

23 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

24 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= 透明 ( 不显示背景 ) 其它 = 显示图标背景 0x10 0x05:H 整数位数 1 显示的整数位数 0x11 0x05:L 小数位数 1 显示的小数位数 0x00= 整数 (2 字节 ), 到 x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x12 0x06:H 变量数据类型 1 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x05= 无符号整数 (2 字节 ) 0 到 x06= 无符号长整数 (4 字节 ) 0 到 x13 0x06:L 对齐模式 1 0x00= 左对齐 0x01= 右对齐 北京迪文科技有限公司 dwinhmi@dwin.com.cn

25 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

26 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

27 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

28 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 显示小数位 整数位数和小数位数之和不能超过 20 0x00= 整数 (2 字节 ), 到 x01= 长整数 (4 字节 ) 到 x02=*VP 高字节, 无符号数 0 到 255 0x13 0x06:L 变量数据类型 1 0x03=*VP 低字节, 无符号数 0 到 255 0x04= 超长整数 (8 字节 ) 到 x05= 无符号整数 (2 字节 ) 0 到 x06= 无符号长整数 (4 字节 ) 0 到 x14 0x07:H Len_unit 1 变量单位 ( 固定字符串 ) 显示长度,0x00 表示没有单位显示 0x15 0x07:L String_Unit Max11 单位字符串,ASCII 编码 北京迪文科技有限公司 dwinhmi@dwin.com.cn

29 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 编码方式 0x01-0x04 时 ASCII 字库位置 0x19 0x09:L Font1_ID 1 编码方式 0x00 0x05, 以及 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 1.7 定义了文本显示的字符间距是否自动调整 :.7=0 字符间距自动调整 ;.7=1 字符间距不自动调整, 字符宽度固定为设定的点阵数.6-.0 定义了文本编码方式 : 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

30 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

31 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

32 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-0x07 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

33 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 半径 0x03 1 Color 圆颜色 0x00 1 Pic_ID 剪切图片区域所在页面 ID; 高字节为判断条件 0x0006 图片区域 0x01 2 (x,y)s 剪切图片区域左上角坐标 剪切 粘贴 0x03 2 (x,y)e 剪切图片区域右下角坐标 0x05 2 (x,y) 剪切图片区域粘贴到当前页面的坐标位置, 左上角坐标 0x**07 0x00 2 (x,y) 显示坐标位置,x 坐标高字节为判断条件 ICON 图标图标 ID, 图标库位置由指令高字节指定 显示 0x02 1 ICON_ID 图标固定为不显示背景色 0x0008 区域填充 0x00 2 (x,y) 种子点坐标,x 坐标高字节为判断条件 0x02 1 COLOR 填充颜色 0x0009 垂直线条 0x00 1 Color0 把 (X0,Y0s)(X0,Y0e) 用 Color0 颜色连线,X0 高字节为判断条件 0x01 3 X0,Y0s,Y0e 0x00 1 Color 把 (Xs,Ys)(Xe,Ye) 用 Color 颜色连线,Xs 高字节为判断条件 0x000A 线段显示 0x01 2 (Xs,Ys) 0x03 2 (Xe,Ye) 0x00 1 Color0 圆弧显示颜色 0x01 2 (X,Y)0 圆心 (X,Y) 坐标,X 坐标高字节为判断条件 0x000B 圆弧显示 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 字库位置 0x000C 字符显示 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 方向点阵数 0x05 1 Text0 字符编码模式, 对 8bit 编码, 仅高字节有效 当编码方式为 时, 如果字符编码为 ASCII 字符, 将自动使用 0# 预装字库显示 北京迪文科技有限公司 dwinhmi@dwin.com.cn

34 0x000D 0x00 2 (x,y)s 矩形域左上角坐标,x 坐标高字节为判断条件 矩形域 XOR 0x02 2 (x,y)e 矩形域右下角坐标 0x04 1 Color 矩形域做 XOR 的颜色,0xFFFF 将进行反色操作 判断条件 :0xFF 绘图操作结束 0xFE 本次操作跳过 ( 忽略 ) 北京迪文科技有限公司 dwinhmi@dwin.com.cn

35 5.3.3 列表显示 (0x22) 0x00 0x5A22 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x000C 2 0x06 0x00 *VP 2 表格内容指针, 即 TAB[TAB_X_Num][TAB_Y_Num] 数组的首地址 0x08 0x01:H TAB_X_Num 1 列数目,0x01-0xFF 0x09 0x01:L TAB_Y_Num 1 行数目,0x01-0xFF 0x0A 0x02:H TAB_X_Start 1 表格起始显示列位置,0x00-0xFF 0x0B 0x02:L TAB_Y_Start 1 表格起始显示行位置,0x00-0xFF 0x0C 0x03:H Unit_Data_Num 1 0x01-0x7F 所有单元格存储数据长度相同一个单元格所占的数据空间长度 (Word, 字长度 ) 0x00 由 *VP 指针指向的变量存储空间定义了不同列单元格的数据长度 (Word, 字长度 ) 当 Unit_Data_Num=0x00 时, 表格数据内容存储位置相应后延 (TAB_X_Num/2) 向上取整个字地址 比如,*VP=0x1000,TAB_X_Num=0x07, 那么 : 0x1000-0x1003 依次存储了第 0-6 列的表格数据长度, 其中 1003 的低字节未使用 0x1004 地址开始存储表格内容 0x0D 0x03:L Encode_Mode 1.7 定义了文本显示的字符间距是否自动调整 :.7=0 字符间距自动调整 ;.7=1 字符间距不自动调整, 字符宽度固定为设定的点阵数.6 定义了表格内容格式.6=0 表格内容为文本格式 ;.6=1 表格内容格式由单元格数据的前两个字表示, 见备注 [1];.5 定义了边框线条是否显示,.5=0 显示边框,0.5=1 不显示边框.4 未定义, 写 定义了文本编码方式 : 0=8bit 编码 1=GB2312 内码 2=GBK 3=BIG5 4=SJIS 5=UNICODE 0x0E 0x04 Xs Ys Xe Ye 8 表格显示区域定义, 表格左上角 右下角坐标 ; 表格总是总是从左上角位置开始显示, 越界将结束显示 0x16 0x08 Color_line 2 表格边框线条颜色 0x18 0x09 Color_text 2 表格文本显示颜色 0x1A 0x0A:H Font0_ID 1 编码方式 0x01-0x04 时 ASCII 字库位置 0x1B 0x0A:L Font1_ID 1 编码方式 0x00 0x05, 以及 0x01-0x04 的非 ASCII 字符使用的字库 0x1C 0x0B:H Font_X_Dots 1 字体 X 方向点阵数 (0x01-0x04 模式,ASCII 字符 X 按照 X/2 计算 ) 0x1D 0x0B:L Font_Y_Dots 1 字体 Y 方向点阵数目 0x1E 0x0C:H TAB_X_Adj_Mod 1 当设置 TAB_X_Start 不为零时, 进行显示表头控制 : 0x00= 首列不显示 ; 0x01= 首列显示 0x1F 0x0C:L TAB_Y_Adj_Mod 1 当设置 TAB_Y_Start 不为零时, 进行显示表头控制 : 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:56 BCD 码串 0x11= 时间格式 2, BCD 码串 0x12= 时间格式 3,YYYY-MM-DD HH:MM:SS BCD 码串 0xFF= 文本格式 第一个字低字节 : Mode=0x00-0x06 定义了变量数据的定点显示格式, 高 4bit 表示整数位数, 低 4bit 表示小数位数 Mode=0x10-0X11 时间 BCD 码串的字节长度 Mode= 其它 无定义 第 2 个字 : 定义单元格文本颜色 如果表格实际内容短于 Unit_Data_Num 规定的长度时, 使用 0xFFFF 做为单元格文本结束符 对于特别大的表格, 通过触摸屏修改 TAB_X_Start TAB_Y_Start 值可以很方便的实现表格的定位和拖动 北京迪文科技有限公司 dwinhmi@dwin.com.cn

36 5.3.4 特殊行业应用需求 (0x23) 0x00 0x5A23 2 0x02 *SP 2 变量描述指针,0xFFFF 表示由配置文件加载 0x04 0x x06 0x00 *VP 2 变量数据指针 0x08 24 写 0x00 变量数据格式说明地址 定义 说明 VP CMD 指令 VP+1 Data_Pack_Num_Max 最大数据包数目 ; 遇到结束条件会自动终止 VP+2 DATA_Pack 指令数据包说明 指令 (CMD) 0x0001 操作 多个圆域交集填充 绘图数据包格式说明 ( 相对地址和长度单位均为字 (word)) 相对地址 长度 定义 说明 0x00 1 Color0 安全区域填充颜色 0x01 1 Color1 一般干涉区域 ( 一次相交 ) 填充颜色 0x02 1 Color2 严重干涉区域 ( 两次及以上相交 ) 填充颜色 0x03 1 Color3 圆域外廓线显示颜色 0x04 1 Color4 回避颜色 ( 比如不填充的背景文本颜色或网格线 ) 0x05 4 Disp_Area 显示区域, 越界将不显示 0x09+4*n 2 (x,y)n 第 n 个同心圆域圆心坐标,x 坐标高字节为 0xFF 表示无效 0x0B+4*n 1 RADn_1 第 n 个同心圆域的大圆半径 0x0C+4*n 1 RAD2n_2 第 n 个同心圆域的小圆半径 北京迪文科技有限公司 dwinhmi@dwin.com.cn

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

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

39 附录 1 修订记录 日期 修订内容 DGUS 版本 首次发布 V 在 CONFIG.TXT 配置文件中增加对 R2.2 的定义, 允许从 22# 字库加载变量初始化数据 ; 2.0x5A12 RTC 显示中增加了指针表盘时钟显示功能 ; 3. 增加 0xFE07_02 打印位图处理触控指令, 实现屏幕内容打印 ; V 增加 0xFE07_03 变量数据发送到串口指令, 支持无线遥控等应用 修订基本图形显示指令 0x5A21 中 0xFF 结束符定义 : 由结束整个指令变更为结束本次操作 ; 2. 增加了 0x5A21_08 封闭区域填充指令 ; 3. 增加了 0x5A23_01 圆域交集显示指令, 适应特殊行业防碰撞显示应用 ; V 在寄存器空间 (0x05-0x0B) 增加了触摸屏坐标读取和触控使能控制功能, 以方便设备运行时锁触摸屏 防止误操作的应用 在 0xFE00 变量录入指令增加了字节 (byte) 类型数据返回和上下限设置 ; 2. 在 0x5A10 数据变量显示中, 增加了字节 (byte) 类型数据的显示 ; 3. 增加了 SD 卡升级 DGUS 软件的功能 ; V 在 0x5A21 基本图形显示中定义了判断条件 :0xFF 为结束绘图操作,0xFE 为跳过本次操作 ; 5. 在 0x5A21 基本图形显示中定义了垂直线条显示指令, 用于频谱 刻度线的显示 文档中增加指令说明, 增加应用实例 ; 2. 应用实例中加入指令说明 ; 3. 增加 0x001F 寄存器定义, 以允许用户通过串口修改 RTC V2.0 增加 0x0040-0x0049 寄存器定义, 允许用户在变量存储器和字库之间交换数据, 可实现以下功能 : 历史数据的存储和记录, 最大 8MW(16MB) 空间 ; 把配置参数等需要掉电保存的数据保存到字库空间, 并可以方便的加载到变量存储器操作 ; V2.2 对字库内容的读取 ; 由于字库内容可以通过 SD 卡写入, 间接实现了用户软件对 SD 卡数据的读取 通过配置 CONFIG.TXT 文件 : 增加 SD 卡升级禁止功能 ; V3.0 增加了基于 DWIN OS 的用户应用软件 (23.BIN) 执行功能 增加了对键盘的支持, 方便不使用触摸屏的用户快速开发 HMI, 实现方法如下 : 13 触控配置文件中触摸按钮位置换成键码 (0x01-0xFF, 最多 255 个键 ); 用户键盘接口定义在 0x4F 寄存器 V3.2 用户软件只需要把键码通过串口传到 0x4F 寄存器, 即可让 DGUS 按照 13 文件要求实现界面控制 对 14.BIN 变量配置文件的 *VP, 增加了高字节为 0xFF 可以取消本条变量显示指令的功能以方便显示指令的用户控制开 / 关 V3.3 在 0xFE06 文本录入指令中, 增加了返回输入结束标记和有效数据长度的定义选择 增加了对位 (bit) 变量的支持, 实现和 DCT100 基本 I/O 设备的无缝连接 0xFE01 0xFE02 0xFE05 参数录入中, 增加了位 (bit) 变量录入功能 ; 增加了 0x5A06 位变量图标显示功能 2. 增加 0x5A13 BCD 码时间变量显示功能 V 对 0x5A11 0x5A22 文本显示增加了字符间距自动调整开 / 关功能 定义 Encode_Mode.7 来控制是否启用字符间距自动调整 在 0xFE06 触摸屏输入法的 ASCII 录入中, 增加了录入过程中显示 "*" 的选择, 用于文本密码输入 V 修订了 CONFIG.TXT 文件 R2 寄存器 (SYS_CFG 配置字 ) 低两 bit 的定义, 以设置 DGUS 周期为 200mS/160mS/120mS/80mS, 提高 DGUS 响应的实时性 2.0x5A10 数据变量显示中, 增加了对 64 位整数 32 位无符号数 16 位无符号数的支持 ; V xFE00 变量数据录入中, 增加了对 64 位整数的支持 ; 4.SD 卡接口禁止后将不能校准触摸屏 为方便用户现场应用, 增加了以下功能 : 1. 增加了 SD 卡 CONFIG.TXT 文件触发触摸屏校准操作的指令 :TP_CORRECT; 2. 增加了 SD 卡 CONFIG.TXT 文件来输入密码取消 SD 卡禁止的指令 :SD_UNLOCK_8 位密码 ; V4.5 3.PC 组态软件可以通过串口下载文件 ( 字库 配置文件 用户程序 ), 实现在线调试功能 A03 艺术字显示增加了右对齐功能 ; 2.5A21 绘图指令增加了 0x000A 线段显示指令 ; V 增加了上电运行时间, 保存在寄存器空间 0C-0F 寄存器 在寄存器空间 (0xEE-0xEF) 增加了 DGUS 屏复位触发寄存器 ; 2.0x5A03 艺术字显示增加了对超长整数等变量类型的支持 ; 3. 对 0x5A22 列表显示增加了对 HEX 单元格数据, 以及单元格数据显示颜色指定的支持 ; V 增加了 RC AUX_CFG 辅助配置寄存器的定义, 支持对触摸屏蜂鸣器伴音的关断 / 开启 A21 绘图指令增加了 0x000B 线段显示指令 ; 2. 对 0x5A22 列表显示增加了对 BCD 格式时间数据的支持 ; V5.0 北京迪文科技有限公司 dwinhmi@dwin.com.cn

40 对 5A21 绘图指令增加了字符显示指令 1. 页最大显示变量数目由 64 个增加到 128 个 ( 加上 OS 控制的 32 个, 最大页显示变量可以达到 160 个 ), 通过 RC AUX_CFG.4 位定义来选择页变量数目 (64 或 128 个 / 页 ) 2.5A21 绘图指令增加了 0x000D 区域 XOR 指令用于区域的渲染 ; V5.3 使用本文档或迪文 DGUS 屏过程中如存在任何疑问, 或欲了解更多迪文 DGUS 屏的最新信息, 欢迎 mail 到 dwinhmi@dwin.com.cn 联系我们 感谢大家一直以来对迪文的支持, 您的支持是我们进步的动力! 谢谢大家! 北京迪文科技有限公司 dwinhmi@dwin.com.cn

41 北京迪文科技有限公司是全球领先的从事工业串口屏技术研发 产品生产和营销的高新技术企业 公司现有员工约 150 人, 总部位于被称为中国 硅谷 的北京中关村核心区, 在深圳 上海 苏州 南京 济南 青岛 武汉, 以及北欧和美国设有驻外办事处, 在印度 土耳其 巴西等地建立了销售渠道, 并在北京上地信息产业基地建立了包括高清洁度装配线 质量提升中心 实验室和老化车间, 总面积约 5000 m2的生产基地 迪文自 2003 年成立至今, 秉承 专业素养 诚实守信 追求卓越 的经营理念, 强调为客户创造价值, 实现共赢, 使公司获得了快速发展和壮大 依托产品在功能 品质 服务 价格上的领先和竞争优势, 迪文屏在工业用 TFT 显示屏市场, 尤其在注重可靠性的工程机械 医疗仪器 出口机电产品上占据重要地位, 赢得了众多客户的信任和支持 迪文始终坚持为客户创造价值, 专注科技创新, 力求与人双赢 共同成长 北京迪文科技有限公司地址 : 北京市海淀区知春路 108 号豪景大厦 A 座 9 层邮编 : 电话 : 传真 : ( 业务联系 ) ( 其他事宜 ) 网站 : 邮箱 :dwinhmi@dwin.com.cn 企业 QQ: