nbhkdz.com冰点文库

迪文MiniDGUS屏开发指南

时间:2015-03-30


专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

迪文 Mini DGUS 屏用户开发指南
(Ver2.1 2013.08)

北京迪文科技有限公司

北京迪文科技有限公司

- 1 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1





1 硬件配置...............................................................................................................................4
1.1 SD卡配置接口 ...................................................................................................................................................................4 1.2 CONFIG.TXT配置文件说明............................................................................................................................................5 1.3 存储器空间说明 ...............................................................................................................................................................6 1.3.1 字库空间 .....................................................................................................................................................................6 1.3.2 图片空间 .....................................................................................................................................................................6 1.3.3 寄存器空间(使用 0x80/0x81 串口指令访问) ......................................................................................................7 1.3.4 变量存储器空间(使用 0x82/0x83 串口指令访问) ..............................................................................................7 1.3.5 曲线数据缓冲区(使用 0x84 串口指令访问(只写) )..........................................................................................7 1.4 软件升级步骤 ...................................................................................................................................................................8 1.5 触摸屏校准 .......................................................................................................................................................................8 1.6 SD卡接口的禁止和重新启用 ...........................................................................................................................................9

2 串口操作.............................................................................................................................10
2.1 数据帧架构 ......................................................................................................................................................................10 2.2 指令集 ..............................................................................................................................................................................10

3 数据格式.............................................................................................................................10 4 触控配置文件(13.BIN)说明 ............................................................................................ 11
4.1 变量数据录入(0x00) .................................................................................................................................................. 11 4.2 弹出菜单选择(0x01) ..................................................................................................................................................13 4.3 增量调节(0x02) ..........................................................................................................................................................14 4.4 拖动调节(0x03) ..........................................................................................................................................................15 4.5 RTC设置(0x04) ..........................................................................................................................................................16 4.6 按键值返回(0x05) .....................................................................................................................................................17 4.7 文本录入(0x06) .........................................................................................................................................................17 4.7.1 ASCII文本录入 .........................................................................................................................................................18

5 显示变量配置文件(14.BIN)说明 ..................................................................................... 19
5.1 图标变量 ..........................................................................................................................................................................19 5.1.1 变量图标显示(0x00) ...........................................................................................................................................19

北京迪文科技有限公司

- 2 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

5.1.2 动画图标显示(0x01) ...........................................................................................................................................20 5.1.3 滑块刻度指示(0x02) ...........................................................................................................................................21 5.1.4 艺术字变量显示(0x03) .......................................................................................................................................22 5.1.5 图片动画显示(0x04) ...........................................................................................................................................23 5.1.6 图标旋转指示(0x05) ...........................................................................................................................................24 5.1.7 位变量图标显示(0x06) .......................................................................................................................................25 5.2 文本变量 ..........................................................................................................................................................................26 5.2.1 数据变量显示(0x10) ...........................................................................................................................................26 5.2.2 文本显示(0x11) ...................................................................................................................................................27 5.2.3 RTC显示(0x12)....................................................................................................................................................28 5.2.4 时间变量显示(0x13) ..........................................................................................................................................29 5.3 图形变量 ..........................................................................................................................................................................30 5.3.1 实时曲线显示(0x20) ...........................................................................................................................................30 5.3.2 基本图形显示(0x21) ...........................................................................................................................................31

6 开发步骤(首次使用必读) ................................................................................................32 附录 1 MINI DGUS主要功能一览 ...........................................................................................34 附录 2 修订记录 ....................................................................................................................36

北京迪文科技有限公司

- 3 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

1 硬件配置
1.1 SD卡配置接口
迪文 Mini DGUS 屏的所有参数设置和资料下载,只能通过 SD 卡接口来完成。SD 卡接口支持 SD 或 SDHC 两种 SD 卡格式,保存的文件必须使用 FAT32 文件系统。

文件格式说明
? ? 在 SD 卡根目录下建立 DWIN_SET 文件夹; 把需要下载的图片、字库、配置文件都放在 DWIN_SET 文件夹中,如下图所示。

SD 卡文件格式说明 文件类型 图片文件 字库文件 图标库 专用字库 触控配置 变量配置 变量初始化 硬件设置 命名规则 图片存储位置+(可选的)文件名.BMP 字库存储位置+(可选的)文件名.BIN/HZK/DZK 字库存储位置+(可选的)文件名.ICO 0*.HZK 13*.BIN 14*.BIN 22*.BIN CONFIG.TXT 举 例 00 开机界面.BMP 32_GBK12 汉字库.DZK 41 图标库.ICO 0_DWIN_ASC.HZK 13 触控配置文件.BIN 14 变量配置文件.BIN 22 变量初始化.BIN CONFIG.TXT 说 明 必须是和 DGUS 屏分辨率相同的 24 位色 BMP 文件。 可以由 TS3 字库提取软件生成 迪文工具箱“DWICON”生成 迪文工具箱“0 号字库”生成 迪文 DGUS 组态软件生成 迪文 DGUS 组态软件生成

? ?

检测到 SD 卡后,Mini DGUS 会显示蓝屏提示用户检测到 SD 卡,然后开始数据下载; SD 卡下载完成后,Mini DGUS 屏会重新对数据进行初始化。

北京迪文科技有限公司

- 4 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

1.2 CONFIG.TXT配置文件说明
CONFIG.TXT 文件采用类似脚本语言的方式来描述参数寄存器,每一行描述一个参数,不用的参数可以不 写,说明如下:
参数寄存器名称 R0 取值范围 取决于 Mini DGUS 屏 说明 Mini DGUS 屏驱动模式选择,配置错误会导致显示异常,用户不要配置。 波特率设置,0x00-0x10 对应 1200bps-921600bps R1 0x00-0x11
R1 波特率 R1 波特率 0x00 1.2K 0x09 76.8K 0x01 2.4K 0x0A 62.5K 0x02 4.8K 0x0B 125K 0x03 9.6K 0x0C 250K 0x04 19.2K 0x0D 230.4K 0x05 38.4K 0x0E 345.6K 0x06 57.6K 0x0F 691.2K 0x07 115.2K 0x10 921.6K 0x08 28.8K

R2 R3

0x00-0xFF 0x00-0xFF

SYS_CFG 配置字,按位(bit)定义,说明如后。 UART_SYNC_H 串口帧头高字节

当 R1=0x11 时,波特率配置字的高字节。 R5:R9=6250000/用户自定义波特率。 比如设定 10000bps 波特率,R5:R9=6250000/10000=625=0x0271 R5=02 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。 R5 不定

R9=71

?

R2(SYS_CFG 配置字)说明
位 .7 .6 .5 .4 .3 .2 权重 0x80 0x40 0x20 0x10 0x08 0x04 VDS HDS TP_LED FCRC TPSAUTO L22_Init_En 定义 说明 0=正常显示 1=偏转 90°显示 0=正常显示 1=偏转 180°(反视角)显示 0=背光不受触摸屏状态控制 1=背光受触摸屏状态控制,控制参数由 CONFIG.TXT 中的 R6、R7、R8 设定。 0=不启动串口通信的 CRC 帧校验; 1=启动串口通信的 CRC 帧校验。 0=触摸屏录入参数后不自动上传(用户查询) ; 1=触摸屏录入参数后是否自动上传到串口由相应触控变量的配置决定。 0=4KB 变量存储器上电初始化数据为 0x00; 1=4KB 变量存储器上电初始化数据由 22(0x16)字库文件加载。 设置 Mini DGUS 周期,Mini DGUS 周期小则变量响应更灵敏,但处理变量的能力相对变 低。 周期 100mS 200mS FRS1 .0 0x01 FBZ 0=蜂鸣器启动; 1=蜂鸣器禁止; 0 1

.1

0x02

FRS

?

VDS 和 HDS 控制屏显示模式说明

北京迪文科技有限公司

- 5 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

1.3 存储器空间说明
1.3.1 字库空间 迪文 Mini DGUS 软件使用用 32MB FLASH 存储器做为字库存储器,并划分为 128 个大小为 256KB 的字库空 间,对应字库文件 ID 为 0-127,说明如下:
字库 ID 0 13 14 24-127 大小 3072KB 256KB 2048KB 26MB 说 明 备注 0_DWIN_ASC.HZK 13_触控.BIN 14_变量.BIN 用户自定义 0#ASCII 字库 触控配置文件 变量配置文件(最多 1024 页,每页最多 64 个变量) 字库、图标库(其中 64-127 字库也可以做为用户数据库)

1.3.2 图片空间 迪文 Mini DGUS 软件使用 96MB 来保存图片,对应不同分辨率的图片保存数量如下表所示:
屏幕分辨率 320×240 480×272 可存储图片数量 384 384

北京迪文科技有限公司

- 6 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

1.3.3 寄存器空间(使用 0x80/0x81 串口指令访问) 迪文 Mini DGUS 屏提供 1 个 256B 寄存器接口,用于硬件操作或者图片显示等进程控制,寄存器空间定义 如下:
说 明 DGUS 版本号,BCD 码表示,0x10 表示 V1.0 LED 亮度控制寄存器,0x00-0x40 蜂鸣器鸣叫控制寄存器,单位为 10mS 读:当前显示页面 ID; 写:切换到指定页面(进程控制) 0x5A=触摸屏坐标有更新; 其它=触摸屏坐标未更新 0x05 TP_Flag 1 用户读取数据后未清零本标记,则触摸屏数据不再更新。 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 未定义 SD 卡配置寄存器的映射,除 R2 外串口只读,串口写无效。 0x10-0x1A R0-RA 11 其中 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 12 08 08 04 12 00 01 04 指星期四,实际可以写任何值 0x30-0x4E 保留 31 未定义 用户键码,用于触发 0x13 触控文件;0x01-0xFF,0x00 表示无效。DGUS 处理键码 0x4F Key_Code 1 后会自动清零键码寄存器。 0x50-0xEA 保留 155 未定义 用于清除曲线缓冲区: =0x5A,清除曲线缓冲区 0 0xEB CURVE_CLR 1 =0x5B,清除曲线缓冲区 1 清除完毕,系统把寄存器值清 0。 用户设置 0xEC=5A,然后进入快速刷新模式,用户此时读 0xEC 寄存器将返回 0x5C。 在快速刷新模式下触摸屏可以响应,系统对屏幕进行快速刷新,不刷新背景图,有 0xEC FAST_REF 1 必要,需要通过剪切指令恢复背景图。在快速刷新模式下设置 0xEC=00,则退出快 速刷新模式。 0xED-0xFF 保留 19 保留 寄存器地址 0x00 0x01 0x02 0x03 定 义 Version LED_NOW BZ_TIME PIC_ID 字节长度 1 1 1 2

1.3.4 变量存储器空间(使用 0x82/0x83 串口指令访问) 迪文 Mini DGUS 屏提供了 2KW(4KB)的 RAM 做为用户变量存储器,用于 GUI 变量数据的存储。在读写实 时性(mS 级别)要求不高时,可以做为用户的外扩串口访问存储器(RMA) 。 变量存储器空间只能按照字(Word)读写,对应地址空间为 0x0000-0x07FF。 如果用户读或写的变量存储空间大于 0x7FF, 系统会只取变量地址的低 11 位, 自动映射到 0x0000-0x07FF 地址空间。 1.3.5 曲线数据缓冲区(使用 0x84 串口指令访问(只写) ) 为了简化实时曲线的显示,迪文 Mini DGUS 屏设计有一个曲线数据缓冲区用来缓存用户的曲线数据,曲 线缓冲区不占用数据存储器空间,最多可以同时缓冲 2 条曲线。 曲线数据缓冲区只能按照字(Word)写,每个曲线点的数据均用 2 字节带符号整数表示。 曲线缓冲区可以通过往 0xEB 寄存器写 0x5A 或者 0x5B 进行清除。

北京迪文科技有限公司

- 7 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

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°显示,则不需要重新对触摸屏进行校准。

北京迪文科技有限公司

- 8 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

1.6 SD卡接口的禁止和重新启用
在客户测试完成正式量产后,为了防止在应用中通过 SD 卡进行错误的升级或下载操作,导致不正常。可 以通过在 CONFIG.TXT 文件中,增加一行特殊文本来禁止 SD 卡接口,说明如下:
第 1 部分 第 2 部分 第 3 部分 SD_LOCK_ 400 ABCD1234 CONFIG.TXT 文档中禁止 SD 接口文本的说明 固定 用来重新启用 SD 接口的密码保存在变量存储器空间的地址,0000-07F8。 重新启用 SD 接口的 8 位密码。

取消 SD 卡禁止的命令:SD_UNLOCK_ABCD1234,其中 ABCD1234 是用户设置的 8 位密码。 举例: 假设禁止 SD 卡后的重新启用密码为 12345678,密码保存在变量存储空间的 0x0400 位置。 禁止 SD 卡接口的过程: (1)在 CONFIG.TXT 文档中增加: SD_LOCK_400_12345678 (2)把 CONFIG.TXT 用 SD 卡(加密启用 SD 卡)下载到 Mini DGUS 中; (3)之后 Mini DGUS 将禁止 SD 卡接口。 重新启用 SD 卡的过程: 方法 1: 通过串口发送正确的密码到正确的存储空间位置,SD 卡将被激活一次。 假设用户设置的帧头为(0xA55A) :A5 5A 0B 82 60 00 31 32 33 34 35 36 37 38。 方法 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 卡即可正常使用,流程如下图所示:

北京迪文科技有限公司

- 9 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

2 串口操作
迪文Mini DGUS屏采用异步、全双工串口(UART) ,串口模式为8n1(51单片机的MOD1,9bit UART) ,即每 个数据传送采用10个位:1个起始位,8个数据位,1个停止位。 串口波特率通过SD卡来配置。 串口的所有指令或者数据都是16进制 (HEX) 格式; 对于字型 (2字节) 数据, 总是采用高字节先传送 (MSB) 方式。比如0x1234传送时先传送0x12。

2.1 数据帧架构
迪文 Mini DGUS 屏的串口数据帧由 4 个数据块组成,如下表所述:
数据块 定 义 数据长度 说 明 1 帧 头 2 CONFIG.TXT 配 置 文 件的 R3:RA 定义。 2 数据长度 1 数据长度包括指 令、数据,不包括 CRC 校验码 3 指令 1 0x80-0x84 4 数据 N

一个数据包能够传送的最大数据长度为 248 字节(不要 CRC 校验)或 246 字节(带 CRC 校验) 。 CRC 校验不包括帧头和数据长度,紧针对指令和数据,采用 ANSI CRC-16(X16+X15+X2+1)格式。

2.2 指令集
功能 访问 控制寄存器 指令 0x80 0x81 0x82 0x83 数据 ADR(0x00-0xFF)+Data_Pack ADR(0x00-0xFF)+RD_LEN(0x00-0xFF) ADR(0x00-0xFF)+RD_LEN+Data_Pack ADR_H:L(0x0000-0x6FFF)+DATA0…DATAn ADR_H:L(0x0000-0x6FFF)+RD_LEN(0x00-0x7F) ADR_H:L+RD_LEN+DATA0……DATAn 指定地址写寄存器数据 指定地址读 RD_LEN 字节寄存器数据 读寄存器的 Mini DGUS 屏应答 指定地址开始写入数据串(字数据)到变量存储区 从变量存储区指定地址开始读入 RD_LEN 长度字数据 读数据存储器的 Mini DGUS 屏应答 写曲线缓冲区数据。 CH_Mode 定义了后续数据的通道排列顺序: ? CH_Mode 的每个位(bit)对应 1 个通道; ? CH_Mode.0 对应 0 通道,.1 对应 1 通道; ? 位置 1 表示对应的通道数据存在; ? 数据按照低通道数据在前排列。 比如 CH_Mode=0x23(00000011B),表示后续数据格式 为: (通道 0+通道 1)+…+(通道 0+通道 1)。 说 明

访问 数据存储器

写曲线缓冲区

0x84

CH_Mode(Byte)+DATA0(Word)+…+DATAn

寄存器的访问以字节(Byte)为数据单位,而数据存储器、曲线缓冲区的访问以字(Word)为数据单位。 关于存储器的定义和说明,请参考 1.3 存储器空间说明。

3 数据格式
由于主要面向MCU等嵌入式系统应用,为了用户处理的方便,迪文Mini DGUS软件使用的数据采用字符 型(字节) 、整数(字) 、长整数(双字)表示,相关表示范围如下: 整数:-32768(0x8000)到+32767(0x7FFF) 长整数:-2147483648(0x80000000)到+2147483647(0x7FFFFFFF) 字符型:0(0x00)到256(0xFF) 。 小数采用定点小数表示,用户自定义小数位数,比如0x4D2(1234) ,规定小数为2位时,表示12.34。 迪文Mini DGUS软件使用65K色颜色系统,调色板定义如下:
Bit Define 15 R4 14 13 12 R3 R2 R1 红色 0xF800 11 R0 DGUS 使用的 65K 设调色板位定义 10 9 8 7 6 G5 G4 G3 G2 G1 绿色 0x07E0 5 G0 4 B4 3 B3 2 1 B2 B1 蓝色 0x001F 0 B0

北京迪文科技有限公司

- 10 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

4 触控配置文件(13.BIN)说明
触控配置文件由N条按照页面配置的触控指令组成,每条触控指令固定占用16、32或者48字节存储空间。 一条触控指令由以下6部分组成:
序号 1 2 3 4 5 6 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code TP_FUN 数据长度 2 8 2 2 2 32 说 明 页面ID 触控按钮区域:左上角坐标(Xs,Ys) ,右下角坐标(Xe,Ye) 当Xs=0xFFFF时,表示触发控制由0x4F寄存器的键码值触发,此时Ys_H为设定的触 发键码值(Ys_L,Xe,Ye值未定义,可任意写) ;由键码值触发时,请把按钮按压效 果设置为无效。 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 触控键码: 0xFF**表示无效的键码 0xFE**表示触控功能按键,比如0xFE00表示启动变量数据触摸屏录入。 0x00**表示触控键码,用ASCII表示;比如0x0031表示按键“1” 。 当TP_Code=0xFE**时,用来对触控功能按键进行描述。

4.1 变量数据录入(0x00)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP 数据长度 2 8 2 2 2 1 2 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE00 0xFE 录入数据对应的变量地址指针 返回变量类型: 0x00=2 字节变量,整数-32768 到 32767 0x01=4 字节变量,长整数-2147483648 到 2147483647 0x02=*VP 高字节,无符号数 0 到 255 0x03=*VP 低字节,无符号数 0 到 255 录入的整数位数。比如录入1234.56,则N_Int=0x04。 录入的小数位数。比如录入1234.56,则N_Dot=0x02。 输入过程显示位置:右对齐方式,(x,y)是字符串输入光标的右上角坐标。 输入字体显示颜色。 显示使用的 ASCII 字库位置,0x00=默认字库 字体大小,X 方向点阵数目 光标颜色,0x00=黑色 其它=白色 0x00=输入遮挡,显示为"*";其它,输入直接显示 0xFE 0x00=键盘在当前页面;其它=键盘不在当前页面。 键盘所在页面 ID,仅当 KB_Source 不等于 0x00 时有效。 键盘区域:(Xs,Ys)为左上角、,(Xe,Ye)为右下角坐标。 仅当 KB_Source 不等于 0x00 时有效。 键盘在当前页面显示位置,左上角坐标;仅当 KB_Source 不等于 0x00 时有效。 0xFE 0xFF:表示启用输入范围限制,输入越界无效(等同取消); 其它:输入无范围限制。 输入下限,4 字节(长整数)。 输入上限,4 字节(长整数)。 写 0x00

0x13

V_Type

1

0x14 0x15 0x16 0x1A 0x1C 0x1D 0x1E 0x1F 0x20 0x21 0x22 0x24 0x2C 0x30 0x31 0x32 0x36 0x3A

N_Int N_Dot (x,y) Color Lib_ID Font_Hor Cusor_Color Hide_En 0xFE KB_Source PIC_KB AREA_KB AREA_KB_Position 0xFE Limits_En V_min V_max 保留

1 1 4 2 1 1 1 1 1 1 2 8 4 1 1 4 4 6

输入过程中有效键码:

北京迪文科技有限公司

- 11 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

0x0030-0x0039,0x002E(.),0x002D(+/-),0x00F0(取消),0x00F1(确认),0x00F2(退格)。

键盘和输入启动按钮在一个页面(KB_Source=0x00)

键盘不在当前界面上(KB_Source=0x01) :触发输入法后

北京迪文科技有限公司

- 12 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南
键盘不在当前界面上(KB_Source=0x01) :键盘所在页面

Ver2.1

4.2 弹出菜单选择(0x01)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP 数据长度 2 8 2 2 2 1 2 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE01 0xFE 变量地址指针,返回数据由VP_Mode决定。 0x00=把 0x00**键码写入 VP 字地址(整型数); 0x01=把**键码写入 VP 字地址的高字节地址(VP_H); 0x02=把**键码写入 VP 字地址的低字节地址(VP_L); 0x10-0x1F: 把**键码最低位(1bit)变量并写入 VP 字地址的指定位 (0x10 修改 VP.0,0x1F 修改 VP.F) 弹出菜单的图片位置 菜单区域:左上角坐标(Xs,Ys),右下角坐标(Xe,Ye) 菜单在当前页面显示的位置:左上角 X 坐标 固定 菜单在当前页面显示的位置:左上角 Y 坐标 写 0x00

0x13

VP_Mode

1

0x14 0x16 0x1E 0x20 0x21 0x23

Pic_Menu AREA_Menu Menu_Position_X 0xFE Menu_Position_Y NULL

2 8 2 1 2 13

输入过程中有效键码:0x0000-0x00FF,其中 0x00FF 为取消(不选择参数直接返回)。

上图中:弹出的菜单在另外的界面上,"开启"和"关闭"两个按钮配置的键码(0x0000-0x00FE)将被返回给 0x01 触控按钮所指向的变量;取消按钮设置键码为 0x00FF,点击时不会返回值。

北京迪文科技有限公司

- 13 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 下拉式菜单也可以使用本指令设计。

迪文 Mini DGUS 屏开发指南

Ver2.1

4.3 增量调节(0x02)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP 数据长度 2 8 2 2 2 1 2 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。必须为0xFF**。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE02 0xFE 变量地址指针,返回数据由VP_Mode决定。 0x00=调节 VP 字地址(整型数); 0x01=调节 VP 字地址的高字节地址(1 字节无符号数,VP_H); 0x02=调节 VP 字地址的低字节地址(1 字节无符号数,VP_L); 0x10-0x1F:对 VP 字地址的指定位(0x10 对应 VP.0,0x1F 对应 VP.F)进行调 节,调节范围必须设置为 0-1。 调节方式:0x00=-- 其它=++ 逾限处理方式:0x00=停止(等于门限) 其它=循环调节 调节步长,0x0000-0x7FFF 下限:2 字节整数(VP_Mode=0x01 或 0x02 时,仅低字节有效) 上限:2 字节整数(VP_Mode=0x01 或 0x02 时,仅低字节有效) 写 0x00

0x13

VP_Mode

1

0x14 0x15 0x16 0x18 0x1A 0x1C

Adj_Mode Return_Mode Adj_Step V_Min V_Max NULL

1 1 2 2 2 4

上图中,"+" "-" 两个触控按钮分别被配置为++增量(Adj_mode=0x01)和――增量(Adj_mode=0x00)。 当把范围设置为 0-1 时,配合图标变量显示可以方便的设计出复选功能(点击 1 下选中,再点击取消)。

北京迪文科技有限公司

- 14 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

4.4 拖动调节(0x03)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP 数据长度 2 8 2 2 2 1 2 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。必须为0xFF**。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。必须为0xFF**。 0xFE03 0xFE 变量地址指针。 ? 高 4 比特定义了数据返回格式: 0x0*=调节 VP 字地址(整型数); 0x1*=调节 VP 字地址的高字节地址(1 字节无符号数,VP_H); 0x2*=调节 VP 字地址的低字节地址(1 字节无符号数,VP_L)。 ? 低 4bit 定义了拖动方式: 0x*0=横向拖动,0x*1=纵向拖动。 有效调节区域:Xs,Ys,Xe,Ye;必须和 TP_Area(触控区域)一致。 起始位置对应的返回值,整数。 终止位置对应的返回值,整数。

0x13

Adj_Mode

1

0x14 0x1C 0x1E

Area_Adj V_begain V_end

8 2 2

为防止误操作,须按压有效拖动区域超过 0.5 秒后拖动才启动。

上图中,刻度滑块是用滑块刻度指示(0x02 变量)实现的。 拖动录入的优点是直观、快捷,而且参数不会越界。当需要更精确的拖动录入时,可以把拖动修改的变 量同时用数据变量显示方式(0x10 变量)显示出来,如下图所示:

拖动调节不支持按键(0x4F 寄存器保存的键码)控制。

北京迪文科技有限公司

- 15 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

4.5 RTC设置(0x04)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 0x14 0x18 0x1A 0x1B 0x1C 0x1D 0x1E 0x20 0x21 0x29 0x2D 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE 0x00 00 00 (x,y) Color Lib_ID Font_Hor Cusor_Color KB_Source PIC_KB 0xFE AREA_KB AREA_KB_Position NULL 数据长度 2 8 2 2 2 1 3 4 2 1 1 1 1 2 1 8 4 3 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE04 0xFE 0x00 00 00 输入过程显示位置,右对齐方式,(x,y)是字符串右上角坐标。 输入字体显示颜色。 显示使用的 ASCII 字库位置,0x00=默认字库 字体大小,X 方向点阵数目 光标颜色,0x00=黑色 其它=白色 0x00=键盘在当前页面;其它=键盘不在当前页面 键盘所在页面 ID,仅当 KB_Source 不等于 0x00 时有效。 0xFE 键盘区域:左上角坐标(Xs,Ys),右下角坐标(Xe,Ye); 仅当 KB_Source 不等于 0x00 时有效。 键盘在当前页面显示位置,左上角坐标;仅当 KB_Source 不等于 0x00 时有效。 写 0x00

设计方法和

0x00 触控变量_键盘不在当前界面

基本一致。

键盘不在当前界面上(KB_Source=0x01) :触发输入法后

键盘不在当前界面上(KB_Source=0x01) :键盘所在页面

北京迪文科技有限公司

- 16 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

4.6 按键值返回(0x05)
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP 数据长度 2 8 2 2 2 1 2 说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE05 0xFE 变量地址指针 0x00=返回键值保存在 VP 字地址(整型数); 0x01=返回键值低字节保存在 VP 字地址的高字节地址(VP_H); 0x02=返回键值低字节保存在 VP 字地址的低字节地址(VP_L); 0x10-0x1F:把返回键值的最低位(1bit)写入 VP 字地址的指定位(0x10 修改 VP.0,0x1F 修改 VP.F) 返回键值。 写 0x00

0x13

VP_Mode

1

0x14 0x16

Key_Code NULL

2 10

4.7 文本录入(0x06)
输入文本键盘码表 在文本录入的触控文件中,两字节键码的低字节表示普通键码,高字节表示大写键码。 典型的文本录入键盘定义如下表所示:
键码 0x7E60 0x2131 0x4032 0x2333 0x2434 0x2535 0x5E36 0x2637 0x2A38 0x2839 0x2930 0x5F2D 0x2B3D 普通 ` 1 2 3 4 5 6 7 8 9 0 = 大写 ~ ! @ # $ % ^ & * ( ) _ + 键码 0x5171 0x5777 0x4565 0x5272 0x5474 0x5979 0x5575 0x4969 0x4F6F 0x5070 0x7B5B 0x7D5D 0x7C5C 普通 q w e r t y u i o p [ ] \ 大写 Q W E R T Y U I O P { } | 键码 0x4161 0x5373 0x4464 0x4666 0x4767 0x4868 0x4A6A 0x4B6B 0x4C6C 0x3A3B 0x2227 0x0D0D 普通 a s d f g h j k l ; ' Enter 大写 A S D F G H J K L : " Enter 键码 0x5A7A 0x5878 0x4363 0x5676 0x4262 0x4E6E 0x4D6D 0x3C2C 0x3E2E 0x3F2F 0x2020 普通 z x c v b n m , . / SP 大写 Z X C V B N M < > ? SP

注:文本键盘键码须小于 0x80(ASCII 码) 。0x0D 键码录入会自动转换成 0x0D 0x0A;0x00 和 0xFF 键码禁用。

键盘功能键码定义
键码 0x00F0 0x00F1 0x00F2 0x00F3 0x00F4 0x00F7 0x00F8 定义 Cancel Return Backspace Delete CapsLock Left Right 说明 取消录入返回,不影响变量数据。 确认录入返回,录入文本保存到指定变量位置。 向前(退格)删除一个字符。 向后删除 1 个字符。 大写锁定。如果启用,对应按钮必须定义按钮按下的效果。 光标前移一个字符;GBK 汉字录入中用于翻页。 光标后移一个字符;GBK 汉字录入中用于翻页。

使用键盘(0x4F 寄存器保存的键码)做文本录入时,如果使用 CapsLock 键,请把按钮的动画区域定义 在需要提示“CapsLock”的区域;这样定义后,发送 CapsLock 键时,屏幕的相应位置会自动显示“CapsLock” 的区域图标提示。

北京迪文科技有限公司

- 17 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 4.7.1 ASCII文本录入
地址 0x00 0x02 0x0A 0x0C 0x0E 0x10 0x11 0x13 0x14 0x15 0x16 0x17 0x18 0x19 0x1B 0x1F 0x20 0x21 0x25 0x26 0x28 0x30 0x31 0x36 定义 Pic_ID TP_Area Pic_Next Pic_On TP_Code 0xFE *VP VP_Len_Max Scan_Mode Lib_ID Font_Hor Font_Ver Cusor_Color Color Scan_Area_Start Scan_Return_Mode 0xFE Scan_Area_End KB_Source PIC_KB AREA_KB 0xFE AREA_KB_Position NULL 数据长度 2 8 2 2 2 1 2 1 1 1 1 1 1 2 4 1 1 4 1 2 8 1 4 11

迪文 Mini DGUS 屏开发指南

Ver2.1

说 明 页面ID 触控按钮区域: (Xs,Ys) (Xe,Ye) 目标切换页面,0xFF**表示不进行页面切换。 按钮按压效果图所处的页面,0xFF**表示没有按钮按压效果。 0xFE06 0xFE 变量地址指针 文本变量最大长度,字(Word)数目,0x01-0x7B; 文本保存到指定地址时,自动在文本结束处加上 0xFFFF 作为结束符; 录入的文本变量实际可能占用最大变量空间=VP_Len_Max+1。 录入模式控制:0x00=重新录入 0x01=打开原来文本再修改 显示使用的 ASCII 字库位置,0x00=默认字库 字体大小,X 方向点阵数目 字体大小,Y 方向点阵数目(Lib_ID=0x00 时,Y 方向点阵数目必须为 2*X) 光标颜色,0x00=黑色 其它=白色 文本显示颜色。 录入文本显示区域左上角坐标(Xs,Ys) 0x55:在*(VP-1)位置保存输入结束标记和有效数据长度: *(VP-1)高字节,输入结束标记:0x5A 表示输入结束,输入过程为 0x00。 *(VP-1)低字节,有效输入数据长度,字节单位。 0x00:不返回输入结束标记和长度; 录入文本显示区域右下角坐标(Xe,Ye) 键盘页面位置选择:0x00=键盘在当前页面;其它=键盘不在当前页面。 以下数据,仅当 KB_Source 不为 0x00 时有效。键盘所在页面 ID 键盘页面上键盘区域坐标:左上角(Xs,Ys)、右下角(Xe,Ye) 键盘区域粘贴在当前页面显示的位置,左上角坐标。 写 0x00

注:迪文预装的 0#字库包含 4*8-64*128 点阵的所有 ASCII 字符。

北京迪文科技有限公司

- 18 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

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

5.1 图标变量
5.1.1 变量图标显示(0x00)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x10 0x12 0x14 0x15 定义 0x5A00 *SP 0x0008 *VP (x,y) V_Min V_Max Icon_Min Icon_Max Icon_Lib Mode 数据长度 2 2 2 2 4 2 2 2 2 1 1 说 明

变量描述指针,0xFFFF 表示由配置文件加载 变量指针,变量为整数格式。 变量显示位置,图标左上角坐标位置 变量下限,越界不显示 变量上限,越界不显示 V_Min 对应的图标 ID V_max 对应的图标 ID 图标库存储位置 ICON 显示模式,0x00=透明(不显示背景) 其它=显示图标背景

0x00 0x01 0x03 0x04 0x05 0x06 0x07:H 0x07:L

北京迪文科技有限公司

- 19 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.2 动画图标显示(0x01)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x10 0x12 0x14 0x16 0x18 0x19 0x00 0x01 0x03 0x04 0x05 0x06 0x07 0x08 0x09:H 0x09:L 定义 0x5A01 *SP 0x000A *VP (x,y) 0x0000 V_Stop V_Start Icon_Stop Icon_Start Icon_End Icon_Lib Mode

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

数据长度 2 2 2 2 4 2 2 2 2 2 2 1 1

变量描述指针,0xFFFF 表示由配置文件加载 初始图标变量指针,变量为双字,低位字保留,高位字无符号数 (0x0000-0x0FFFF)用户数据控制动画图标显示。 变量显示位置,图标左上角坐标位置。 固定 变量为该值时显示固定图标 变量为该值时自动显示动画图标 变量为 V_STOP 值时固定显示的图标 变量为 V_Start 值时,自动从 Icon_Start 到 Icon_End 显示图标, 形成动画。 图标库存储位置 ICON 显示模式,0x00=透明

当变量不等于 V_Stop 或者 V_Start 时,不显示图标或者动画。

北京迪文科技有限公司

- 20 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.3 滑块刻度指示(0x02)
地址 0x00 0x02 0x04 0x06 0x08 0x0A 0x0C 0x0E 0x10 0x12 0x14 0x15 0x16 0x17 0x18 定义 0x5A02 *SP 0x000A *VP V_begain V_end X_begain X_end Icon_ID Y X_adj Mode Icon_Lib Icon_mode VP_DATA_Mode

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07:H 0x07:L 0x08:H 0x08:L 0x09:H

数据长度 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1

变量描述指针,0xFFFF 表示由配置文件加载 变量指针,变量格式由 VP_DATA_Mode 决定。 对应起始刻度的变量值 对应终止刻度的变量值 起始刻度坐标(纵向为 Y 坐标) 终止刻度坐标(纵向为 Y 坐标) 刻度滑动块的图标 ID 刻度指示图标显示的 Y 坐标位置(纵向为 X 坐标) 刻度指示图标显示的 X 坐标前移偏移量(纵向为 Y) ,0x00-0xFF 刻度模式:0x00=横向刻度条 01=纵向刻度条 图标库存储位置 ICON 显示模式,0x00=透明(不显示背景) 其它=显示图标背景 0x00:*VP 指向一个整型变量 0x01:*VP 指向一个整型变量的高字节数据 0x02:*VP 指向一个整型变量的低字节数据

北京迪文科技有限公司

- 21 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.4 艺术字变量显示(0x03)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x0F 0x10 0x11 0x12 0x13 定义 0x5A03 *SP 0x0007 *VP X,Y Icon0 Icon_Lib Icon_Mode 整数位数 小数位数 变量数据类型 对齐模式

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x03 0x04:H 0x04:L 0x05:H 0x05:L 0x06:H 0x06:L

数据长度 2 2 2 2 4 2 1 1 1 1 1 1

变量描述指针,0xFFFF 表示由配置文件加载 变量指针 起始显示位置: 左对齐模式,坐标为显示字符串左上角坐标; 右对齐模式,坐标为显示字符串的右上角坐标。 0 对应的 ICON_ID,排列顺序为 0123456789-. Icon 库位置 ICON 显示模式,0x00=透明(不显示背景) 0x01=显示图标背景 显示的整数位数 显示的小数位数 0x00=整数(2 字节), -32768 到 32767 0x01=长整数(4 字节) -2147483648 到 2147483647 0x02=*VP 高字节,无符号数 0 到 255 0x03=*VP 低字节,无符号数 0 到 255 0x00=左对齐 0x01=右对齐

北京迪文科技有限公司

- 22 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.5 图片动画显示(0x04)
地址 0x00 0x02 0x04 0x06 0x08 0x0A 0x0C 定义 0x5A04 *SP 0x0004 0x0000 Pic_Begain Pic_End Frame_Time

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x02 0x03:H

数据长度 2 2 2 2 2 2 1

变量描述指针,0xFFFF 表示由配置文件加载 固定 起始图片位置 终止图片位置 一帧(一幅图片)显示的时间,单位为 8mS

起始图片位置必须小于终止图片位置。 如果在 Pic_End 页面也设置图片动画变量,将可以实现不断重播。 串口指令切换图片或者触控指令切换图片可以结束重播

北京迪文科技有限公司

- 23 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.6 图标旋转指示(0x05)
地址 0x00 0x02 0x04 0x06 0x08 0x0A 0x0C 0x0E 0x10 0x12 0x14 0x16 0x18 0x1A 0x1B 0x1C 定义 0x5A05 *SP 0x000C *VP Icon_ID Icon_Xc Icon_Yc Xc Yc V_Begain V_End AL_Begain AL_End VP_Mode Lib_ID Mode

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A:H 0x0A:L 0x0B

数据长度 2 2 2 2 2 2 2 2 2 2 2 2 2 1 1 1

变量描述指针,0xFFFF 表示由配置文件加载 变量指针,变量格式由 VP_Mode 决定。 指定的图标 ID。 ICON 图标上的旋转中心位置:X 坐标。 ICON 图标上的旋转中心位置:Y 坐标。 ICON 显示到当前屏幕的旋转中心位置:X 坐标。 ICON 显示到当前屏幕的旋转中心位置:Y 坐标。 对应起始旋转角度的变量值,整型数,越界不显示 对应终止旋转角度的变量值,整型数,越界不显示 起始旋转角度,0-720(0x000-0x2D0) ,单位 0.5°。 终止旋转角度,0-720(0x000-0x2D0) ,单位 0.5°。 0x00:*VP 指向一个整型变量 0x01:*VP 指向一个整型变量的高字节数据 0x02:*VP 指向一个整型变量的低字节数据 ICON 图标库 ID。 ICON 显示模式,0x00=透明(不显示背景) 其它=显示图标背景

本指令主要用于仪表刻度盘的指针指示。 旋转始终假定为“顺时针”转动,即 AL_End 必须大于 AL_Begain(如果 AL_End 小于 AL_Begain,系统处理时 会自动加上 360°)。

北京迪文科技有限公司

- 24 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.1.7 位变量图标显示(0x06)
地址 0x00 0x02 0x04 0x06 0x08 0x0A 定义 0x5A06 *SP 0x000C *VP *VP_AUX Act_Bit_Set

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x02

数据长度 2 2 2 2 2 2

变量描述指针,0xFFFF 表示由配置文件加载 位变量指针,字变量 辅助变量指针,双字,用户软件不能访问。 为 1 的 bit 位置说明*VP 对应位置需要显示。 定义了显示模式: Display_Mode 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 Bit 值 0 ICON0S ICON0S ICON0S 不显示 不显示 ICON0S-ICON0E 动画 ICON0S-ICON0E 动画 ICON0S-ICON0E 动画 1 ICON1S 不显示 ICON1S-ICON1E 动画 ICON1S ICON1S-ICON1E 动画 ICON1S 不显示 ICON1S-ICON1E 动画

0x0C

0x03:H

Display_Mode

1

0x0D

0x03:L

Move_mode

1

0x0E 0x0F 0x10 0x12 0x14 0x16 0x18 0x1C 0x1E

0x04:H 0x04:L 0x05 0x06 0x07 0x08 0x09 0x0B

Icon_Mode Icon_Lib ICON0S ICON0E ICON1S ICON1E (x,y) DIS_MOV

1 1 2 2 2 2 4 2 2

位图图标排列方式: 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 位置; ICON 显示模式:0x00=透明 0x01=不透明 图标库存储位置 不显示动画模式,bit 0 图标 ID 显示动画模式,bit 0 图标动画起始 ID 位置 显示动画模式,bit 0 图标动画结束 ID 位置 不显示动画模式,bit 1 图标 ID 显示动画模式,bit 1 图标动画起始 ID 位置 显示动画模式,bit 1 图标动画结束 ID 位置 起始位变量显示位置,图标左上角坐标位置。 下一个图标坐标移动坐标间隔 写 0x00

北京迪文科技有限公司

- 25 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

5.2 文本变量
5.2.1 数据变量显示(0x10)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x0F 0x10 0x11 0x12 0x13 0x14 0x15 定义 0x5A10 *SP 0x000D *VP X,Y COLOR Lib_ID 字体大小 对齐方式 整数位数 小数位数 变量数据类型 Len_unit String_Unit 数据长度 2 2 2 2 4 2 1 1 1 1 1 1 1 Max11

变量描述指针,0xFFFF 表示由配置文件加载 变量指针 起始显示位置,显示字符串左上角坐标。 显示颜色 ASCII 字库位置 字符 X 方向点阵数 0x00=左对齐 0x01=右对齐 0x02=居中 显示整数位 整数位数和小数位数之和不能超过 10。 显示小数位 0x00=整数(2 字节), -32768 到 32767 0x01=长整数(4 字节) -2147483648 到 2147483647 0x02=*VP 高字节,无符号数 0 到 255 0x03=*VP 低字节,无符号数 0 到 255 变量单位(固定字符串)显示长度,0x00 表示没有单位显示 单位字符串,ASCII 编码

0x00 0x01 0x03 0x04:H 0x04:L 0x05:H 0x05:L 0x06:H 0x06:L 0x07:H 0x07:L

北京迪文科技有限公司

- 26 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.2.2 文本显示(0x11)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x16 0x18 0x19 0x1A 0x1B 0x1C 0x1D 0x1E 0x1F 定义 0x5A11 *SP 0x000D *VP X,Y Color Xs Ys Xe Ye Text_length Font0_ID Font1_ID Font_X_Dots Font_Y_Dots Encode_Mode HOR_Dis VER_Dis 未定义

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x03 0x04 0x08 0x09:H 0x09:L 0x0A:H 0x0A:L 0x0B:H 0x0B:L 0x0C:H 0x0C:L

数据长度 2 2 2 2 4 2 8 2 1 1 1 1 1 1 1 1

变量描述指针,0xFFFF 表示由配置文件加载 文本指针 起始显示位置,显示字符串左上角坐标。 显示文本颜色 文本框 显示字节数量,遇到 0xFFFF 数据或者显示到文本框尾将不再显示。 编码方式 0x00、0x05,以及编码方式 0x01-0x04 时 ASCII 字库位置。 0x01-0x04 的非 ASCII 字符使用的字库 字体 X 方向点阵数(0x01-0x04 模式,ASCII 字符 X 按照 X/2 计算) 字体 Y 方向点阵数目 .7-.0 定义了文本编码方式: 0=8bit 编码 1=GB2312 内码 2=GBK 3=BIG5 4=SJIS 5=UNICODE 字符水平间隔 字符垂直间隔 写 0x00

注意,文本显示时,字库中字体的 Y 方向点阵数目必须为偶数。 DGUS 屏预装的 0#字库,包含 4*8-64*128 点阵的所有 ASCII 字符。

北京迪文科技有限公司

- 27 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.2.3 RTC显示(0x12) ? 文本 RTC 显示
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x0F 0x10 定义 0x5A12 *SP 0x000D 0x0000 X,Y Color Lib_ID 字体大小 String_Code

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

0x00 0x01 0x03 0x04:H 0x04:L 0x05

数据长度 2 2 2 2 4 2 1 1 MAX16

变量描述指针,0xFFFF 表示由配置文件加载

显示位置,显示字符串左上角坐标。 字体颜色 字库位置 X 方向点阵数目 编码字符串,使用 RTC 编码表和 ASCII 字符构成。 假设当前时间是 2012-05-02 12:00:00 星期三,那么 ? Y-M-D H:Q:S 0x00 将显示为 2012-05-02 12:00:00 ? M-D W H:Q 0x00 将显示为 05-02 WED 12:00

RTC 编码表:
说 明 公历_年 公历_月 公历_日 公历_小时 公历_分钟 公历_秒 公历_星期 编码结束 编码 Y M D H Q S W 0x00 显示格式 2000-2099 01-12 01-31 00-23 00-59 00-59 SUN MON TUE WED THU FRI SAT

?

表盘时钟显示
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x12 0x14 0x18 0x1A 0x1E 0x1F 定义 0x5A12 *SP 0x000D 0x0001 X,Y Icon_Hour Icon_Hour_Central Icon_Minute Icon_Minute_Central Icon_Second Icon_Second_Central ICON_Lib 未定义 数据长度 2 2 2 2 4 2 4 2 4 2 4 1 1 说 明

变量描述指针,0xFFFF 表示由配置文件加载

0x00 0x01 0x03 0x04 0x06 0x07 0x09 0x0A 0x0C:H

时钟表盘的指针中心。 时针 ICON 的 ID,0xFFFF 表示时针不显示。 时针 ICON 的旋转中心位置。 分针 ICON 的 ID,0xFFFF 表示分针不显示。 分针 ICON 的旋转中心位置。 秒针 ICON 的 ID,0xFFFF 表示秒钟指针不显示。 秒针 ICON 的旋转中心位置。 指针图标所在的 ICON 库文件 ID 写 0x00

北京迪文科技有限公司

- 28 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.2.4 时间变量显示(0x13)
地址 0x00 0x02 0x04 0x06 0x08 0x0C 0x0E 0x0F 0x10 0x00 0x01 0x03 0x04:H 0x04:L 0x05:H 定义 0x5A13 *SP 0x000D *VP X,Y Color Byte_Num Lib_ID Font_x

迪文 Mini DGUS 屏开发指南
数据长度 2 2 2 2 4 2 1 1 1 说 明

Ver2.1

变量描述指针,0xFFFF 表示由配置文件加载 变量指针数据串首地址,变量为 BCD 编码。 如果半字节数据超过 0x9,将显示成 HEX 码,比如: 数据 0x32 显示为 32。 数据 0xBF 将显示为 BF。 显示起始位置,显示字符串左上角坐标。 字体颜色 *VP 指针高字节开始显示的字节数目,0x01-0x0F 字库位置;字库必须是半角方式。 如果 Lib_ID 不为 0,字库必须使用 8bit 编码。 X 方向点阵数目,始终使用 0#字库,半角显示。 编码字符串,用来和时间变量组合出客户需要的显示格式。 每显示一个 BCD 时间码后,会到编码字符串顺序取出一个 ASCII 字 符来间隔显示。 编码字符串中,特殊字符定义如下: 0x00:无效,本字符不显示,两个 BCD 时间码将连在一起显示; 0x0D:换行显示,即 X=Xs,Y=Y+Font_X*2。

0x11

0x05:L

String_Code

MAX15

北京迪文科技有限公司

- 29 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1
说 明

5.3 图形变量
5.3.1 实时曲线显示(0x20)
地址 0x00 0x02 0x04 0x06 0x08 0x10 0x12 0x14 0x16 0x18 0x19 定义 0x5A20 *SP 0x000A 0x0000 Xs:Ys:Xe:Ye Y_Central VD_Central Color MUL_Y CHANEL Dis_HOR 数据长度 2 2 2 2 8 2 2 2 2 1 1

变量描述指针,0xFFFF 表示由配置文件加载 无定义 曲线窗口:左上角坐标(Xs,Ys) ,右下角坐标(Xe,Ye) ; 曲线越界将不显示。 曲线中心轴位置 中心轴对应的的曲线数据值,一般取最大数据和最小数据和的 50%。 曲线颜色 纵轴放大倍数,单位是 1/256,0x0000-0x7FFF。 数据源通道,0x00-0x01 横轴间隔,0x01-0xFF。

0x00 0x01 0x05 0x06 0x07 0x08 0x09:H 0x09:L

曲线数据用 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。

北京迪文科技有限公司

- 30 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功 5.3.2 基本图形显示(0x21)
地址 0x00 0x02 0x04 0x06 0x08 定义 0x5A21 *SP 0x0005 *VP Area

迪文 Mini DGUS 屏开发指南
数据长度 2 2 2 2 8 说 明

Ver2.1

变量描述指针,0xFFFF 表示由配置文件加载 变量数据指针。 绘图显示区域定义:指定区域的左上角、右下角坐标;绘图越界将 不显示。仅对 0x0001-0x0005、0x0009、0x000A、0x000B 指令有效。

0x00 0x01

变量数据格式说明
地 址 VP VP+1 VP+2 定 义 CMD Data_Pack_Num_Max DATA_Pack 说明 绘图指令 最大数据包数目: 连线指令 (0x0002) , 定义为连线线条数目 (顶点数-1) ; 数据 绘图数据包格式说明(相对地址和长度单位均为字(word) ) 定 义 说 明 (x,y) 置点坐标位置,x 坐标高字节为判断条件。 Color 置点颜色 Color 线条颜色 连线顶点 0 坐标,x 坐标高字节为判断条件。 (x,y)0 (x,y)1 连线顶点 1 坐标,x 坐标高字节为判断条件。 (x,y)n 连线顶点 n 坐标,x 坐标高字节为判断条件。 (x,y)s 矩形框左上角坐标,x 坐标高字节为判断条件。 (x,y)e 矩形框右下角坐标。 Color 矩形颜色 (x,y)s 矩形域左上角坐标,x 坐标高字节为判断条件。 (x,y)e 矩形域右下角坐标。 Color 矩形域填充颜色 (x,y) 圆心坐标,x 坐标高字节为判断条件。 Rad 半径。 Color 圆颜色。 Pic_ID 剪切图片区域所在页面 ID;高字节为判断条件。 (x,y)s 剪切图片区域左上角坐标。 (x,y)e 剪切图片区域右下角坐标。 (x,y) 剪切图片区域粘贴到当前页面的坐标位置,左上角坐标。 (x,y) 显示坐标位置,x 坐标高字节为判断条件。 图标 ID,图标库位置由指令高字节指定。 ICON_ID 图标固定为不显示背景色。 把(X0,Y0s)(X0,Y0e)用 Color0 颜色连线,X0 高字节为判断条件。 Color0 X0,Y0s,Y0 e

绘图指令数据包说明
指 令 (CMD) 0x0001 操 作 相对地址 0x00 0x02 0x00 0x01 0x03 0x01+2*n 0x00 0x02 0x04 0x00 0x02 0x04 0x00 0x02 0x03 0x00 0x01 0x03 0x05 0x00 0x02 0x00 0x0009 垂直线条 0x01 长度 2 1 1 2 2 2 2 2 1 2 2 1 2 1 1 1 2 2 2 2 1 1 3

置点

0x0002

连线

0x0003

矩形

0x0004

矩形域填充

0x0005



0x0006

图片区域 剪切、粘贴 ICON 图标 显示

0x**07

判断条件:0xFF

绘图操作结束

0xFE

本次操作跳过(忽略) 。

北京迪文科技有限公司

- 31 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

6 开发步骤(首次使用必读)

迪文 Mini DGUS 屏功能架构简图 与传统的 LCM 通过时序或者指令控制显示不同,Mini DGUS 屏采用直接变量驱动显示方式,所有的显示 和操作都是基于预先设置好的变量配置文件来工作的。两种不同的工作方式导致用户应用时的软件架构和二 次开发难度完全不同。举例,假设做一个简单的触摸屏温控仪,要在当前页面显示测量温度,点击触摸屏切 换到设置页面进行参数设置。两种不同开发方式下的软件流程图如下:

上面的例子,只是一个两个参数、两个页面的最简单 GUI,如果对于实际应用中稍微“高级”一点的产 品,几十个参数,几十个页面,还要考虑动画、图标等等吸引眼球的 GUI,前一种方式需要 1 个优秀工程师 加班加点干 1 年,而使用 Mini DGUS 屏开发,3-4 个工程师(可以并行协同做)2-3 天就搞定了。

北京迪文科技有限公司

- 32 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

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

北京迪文科技有限公司

- 33 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

附录 1 Mini DGUS主要功能一览

① 变量录入及显示:0xFE00 变量数据录入(选择键盘不在当前页面实现弹出键盘) ;0x5A10 数据变量显示。 ② 变量“++” 、 “--”调节及显示:0xFE02 增量调节 ;0x5A10 数据变量显示。 ③ 变量拖动调节(滑块跟随) :0xFE03 拖动调节;0x5A02 滑块刻度指示。 ④ 时间的设置及显示:0xFE04 RTC 设置(与 0xFE00 变量数据录入类似) ;0x5A12 RTC 显示(有表盘和文 本两种时间显示方式) 。 ⑤ 刻度条、状态条:0x5A00 变量图标显示(对应不同变量值显示不同图标) 、0x5A01 动画图标显示(当变 量为某特定值时依次显示多个图标,循环形成动画) 。 ⑥ 仪表盘:0x5A05 图标旋转指示。 ⑦ 文本输入及显示:0xFE06 文本录入(支持 ASSII 码文本输入) ;0x5A11 文本显示。 ⑧ 开机动画、电子相册:0x5A04 图片动画显示。 ⑨ 曲线显示及调节:0x5A20 实时曲线显示(最多支持 2 条通道同时接收数据显示实时曲线) ;0xFE03 拖动 调节;0x5A02 滑块刻度指示;0xFE01 增量调节。可实现无代码干涉,调节曲线缩放及中心轴位置。

北京迪文科技有限公司

- 34 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1

北京迪文科技有限公司

- 35 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn

专业.诚信.成功

迪文 Mini DGUS 屏开发指南

Ver2.1
Mini DGUS 版本 V1.0 V2.0 V2.1

附录 2 修订记录
日 期 2013.01.30 2013.07.25 2013.08.27 修订内容 首次发布 增加 CRC 校验、快速刷新、R2 寄存器可写功能 修改 CRC 校验格式表述错误

使用本文档或迪文 Mini DGUS 屏过程中如存在任何疑问,或欲了解更多迪文 Mini DGUS 屏的最新信息, 欢迎 mail 到 dwinhmi@dwin.com.cn 联系我们。 感谢大家一直以来对迪文的支持,您的支持是我们进步的动力!谢谢大家!

北京迪文科技有限公司

- 36 -

www.dwin.com.cn

400 018 9008

dwinhmi@dwin.com.cn


赞助商链接