迪文DGUS屏开发指南.pdf

1、 专业素养.诚实守信.追求卓越 迪文 DGUS 屏用户开发指南（Ver4.3 2015.08）（Ver4.3 2015.08）北京迪文科技有限公司 WWW.DWIN.COM.CN 专业.诚信.成功 迪文 DGUS 屏开发指南 Ver4.3 北京迪文科技有限公司 -1- 400 018 9008 目 录 1 DGUS 概述.3 1.1 认识迪文 DGUS 屏.3 1.2 DGUS 屏主要特点.4 1.3 DGUS 屏数据格式.4 1.4 DGUS 软件处理流程图.5 1.5 DGUS 屏开发流程.6 2 DGUS 屏配置.7 2.1 SD/SDHC 配置接口.7 2.2 SD/SDHC 下载文件

2、格式说明.8 2.2.1 图片下载.8 2.2.2 字库下载.8 2.2.3 CONFIG.TXT 配置文件.8 2.2.4 声音文件下载.9 2.2.5 DGUS 应用程序升级.9 2.2.6 用户数据库 SD 卡导出.9 2.3 DGUS 屏参数配置.10 2.3.1 屏幕物理分辨率设置（R0）.10 2.3.2 显示位时钟相位选择（R4）.10 2.3.3 串口波特率设置（R1、R5、R9）.10 2.3.4 串口通信帧头设置（R3、RA）.10 2.3.5 软件工作模式配置寄存器（R2、RC）.11 2.3.6 屏幕显示方向设置（R2.7 R2.6）.11 2.3.7 触摸屏控制背光（

3、R2.5 R6 R7 R8）.12 2.3.8 触摸屏校准.12 2.3.9 SD/SDHC 接口禁止和解锁.12 2.4 ED2 下载器.13 3 串口操作.14 3.1 数据帧架构.14 3.2 指令集.14 3.3 串口 CRC 校验 C 程序参考.15 4 DGUS 寄存器.16 4.1 DGUS 寄存器一览表.16 4.2 读写 RTC.17 4.3 字库读取.17 4.4 128 段音乐播放.17 4.5 数据库读写.18 4.6 按键触发.18 5 DWIN OS 用户程序设计.19 5.1 基本约定.19 5.2 DWIN OS 汇编指令集.20 6 触控/键控配置文件（13.

4、BIN）说明.26 6.1 触控/键控功能一览表.26 6.2 变量数据录入（0 x00）.27 6.3 弹出菜单选择（0 x01）.29 6.4 增量调节（0 x02）.30 6.5 拖动调节（0 x03）.31 6.6 RTC 设置（0 x04）.32 6.7 按键值返回（0 x05）.33 6.8 文本录入（0 x06）.33 6.8.1 ASCII 文本录入.34 6.8.2 GBK 汉字文本录入.35 6.9 硬件参数配置（0 x07）.37 6.10 触摸屏按压状态同步数据返回（0 x08）.38 6.11 转动调节（0 x09）.39 专业.诚信.成功 迪文 DGUS 屏开发指南

5、 Ver4.3 北京迪文科技有限公司 -2- 400 018 9008 7 显示变量配置文件（14.BIN）说明.40 7.1 显示变量功能一览表.40 7.2 图标变量.41 7.2.1 变量图标显示（0 x00）.41 7.2.2 动画图标显示（0 x01）.42 7.2.3 滑块刻度指示（0 x02）.43 7.2.4 艺术字变量显示（0 x03）.44 7.2.5 图片动画显示（0 x04）.45 7.2.6 图标旋转指示（0 x05）.46 7.2.7 位变量图标显示（0 x06）.47 7.3 文本变量.48 7.3.1 数据变量显示（0 x10）.48 7.3.2 文本显示（0

6、x11）.49 7.3.3 RTC 显示（0 x12）.50 7.3.4 HEX 变量显示（0 x13）.51 7.3.5 文本滚屏显示（0 x14）.51 7.4 图形变量.52 7.4.1 实时曲线（趋势图）显示（0 x20）.52 7.4.2 基本图形显示（0 x21）.53 7.4.3 列表显示（0 x22）.55 7.4.4 二维 QR 码图形显示（0 x25）.56 8 DGUS 屏应用问答（FAQ）.57 9 DGUS 特殊应用软件使用说明.60 9.1 基于 Modbus 主机接口的 DGUS 软件应用说明.60 9.2 基于 Modbus 从机接口的 DGUS 软件应用说明.

7、61 10 DGUS 屏开发典型程序参考（ASM51、C51）.62 附录 修订记录.67 专业.诚信.成功 迪文 DGUS 屏开发指南 Ver4.3 北京迪文科技有限公司 -3- 400 018 9008 1 DGUS 概述 1.1 认识迪文 DGUS 屏 DGUS（DWIN Graphic Utilized Software）是北京迪文科技有限公司基于 K600+内核迪文屏所设计的智慧型、图形界面、人机系统软件，DGUS 软件架构如下图所示：出厂预装 DGUS 软件的屏称为 DGUS 屏，一个典型的 DGUS 屏（DMT80480T070_07WT）硬件组成如下图所示：专业.诚信.成功 迪

8、文 DGUS 屏开发指南 Ver4.3 北京迪文科技有限公司 -4- 400 018 9008 1.2 DGUS 屏主要特点 DGUS 屏的主要特点包括：?把 GUI 分解成控件并按页面来配置，控件显示直接由变量控制；在通过 PC 软件配置好控件文件（14.BIN）下载到 DGUS 屏后，用户仅仅需要通过串口改写变量值即可实现控件显示的相应改变。比如比如，要在某个页面显示两位小数要在某个页面显示两位小数（25.0025.00）的温度值的温度值，分两步开发完成分两步开发完成：Step1 Step1 配置配置：借助迪文提供的 PC 组态开发软件，在相应页面位置添加一个数据变量控件，设置好显示格式（

9、字体大小、显示颜色、单位、小数点长度、数据源、数据类别），预览 OK 后通过 SD 卡把生成的控件文件（14.BIN）下载到 DGUS 屏。Step2 Step2 运行运行：用户软件只需要定时（或者参数变化时）把温度值通过串口刷新到对应的数据源地址，当显示切换到对应页面时，屏幕就自动按照预先设定显示格式显示出来。?触摸屏或键盘录入过程，通过 PC 软件按照页面定义的触控文件（13.BIN）来控制，用户软件仅需要定时（或者参数改变时的串口中断触发）来读取录入变量值即可。比如比如，要在某个页面要在某个页面用触摸屏录入用触摸屏录入显示两位小数显示两位小数（25.0025.00）的的设定设定温度值温度

10、值，分两步开发完成分两步开发完成：Step1 Step1 配置配置：借助迪文提供的 PC 组态开发软件，在相应页面位置添加一个变量数据录入控件，设置好录入格式（字体大小、光标模式、显示颜色、小数点长度、数据源、数据类别），预览 OK 后通过SD 卡把生成的控件文件（13.BIN）下载到 DGUS 屏。Step2 Step2 运行运行：当切换到对应页面，并按压触摸屏触发相应控件，DGUS 会自动完成录入过程。用户软件只需要定时（或者配置为录入完成自动串口下发给用户）查询录入值即可。?56KB 变量空间，8 通道曲线趋势图存储器，极快（最快 80mS）的变量显示响应速度；?256 字节配置寄存器空

11、间，串口指令读写，用于硬件控制和操作；?256MB（可以扩展到 1GB、2GB）Flash 存储器，海量图片、图标、字库存储；?每页可设置多达 128 个显示控件（支持显示控件叠加）和任意多的触控控件。?SD/SDHC 接口，FAT32 文件格式，可以使用 SD 卡来实现 DGUS 屏硬件参数配置、图片数据下载、软件升级，批量生产时尤其方便，并便于生产档案管理。?集成了 RTC（公历/农历）、集成背光亮度调节、背光自动待机、触控蜂鸣器伴音功能；?支持语音播放功能、支持电容触摸屏、可以在图片存储器空间构造高可靠性用户数据库；?集成的 DWIN OS 平台，丰富的指令，可以允许用户把一部分代码放到

12、 DGUS 屏上运行，让用户二次开发变得简单，也提供了 DGUS 屏做为系统主控设备的可能。迪文 OS 平台集成了数学运算（包括 MAC、CRC）、数据存储（包括 Flash 数据库读写）、串口通信、常用通信协议处理（比如 Modbus 协议、DL/T645 电力抄表协议等）、串口外设（比如打印机）驱动、DGUS进程控制等指令，典型的应用案例包括 Modbus 总线管理、电力抄表、票据打印、POS 设备等。?可靠的硬件平台（基于迪文 ASIC 的 HMI 平台架构，已经历了将近 10 年的工业应用考验）、迪文自主知识产权的软件设计（DGUS 软件采用汇编代码设计，总代码量约 50KB），使 D

13、GUS 屏不仅性能优越，运行也极其稳定可靠。?通过 TUV CE 和 RoHS 认证。1.3 DGUS 屏数据格式 由于主要面向MCU等嵌入式系统应用，为了用户处理的方便，DGUS屏使用的数据采用整数（字）、无符号整数（字）、长整数（双字）、超长整数（4个字）表示，相关表示范围如下：整数：-32768（0 x8000）到+32767（0 x7FFF）无符号整数：0（0 x0000）到65535（0 xFFFF）长整数：-2147483648（0 x80000000）到+2147483647（0 x7FFFFFFF）超长整数：-9223372036854775808 到 922337203685

14、4775807 小数采用定点小数表示，用户自定义小数位数，比如0 x4D2（1234），规定小数为2位时，表示12.34。DGUS屏使用65K色颜色系统，调色板定义如下：DGUS 使用的 65K 设调色板位定义 Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 R4 R3 R2 R1 R0 G5 G4 G3 G2 G1 G0 B4 B3 B2 B1 B0 Define 红色 0 xF800 绿色 0 x07E0 蓝色 0 x001F 专业.诚信.成功 迪文 DGUS 屏开发指南 Ver4.3 北京迪文科技有限公司 -5- 400 018 9008 1.4 DG

15、US 软件处理流程图 说明：DWIN OS 程序在每个 DGUS 周期（80/120/160/200mS）都完整运行一遍，所以 DWIN OS 程序中不能出现死循环或者通过指令循环的延时。串口中断（串口数据处理）外设中断（RTC、语音等数据处理）触摸屏/按键中断（页面逻辑并处理 13.BIN）DEBUG 中断?DWIN OS 仿真；?系统运行监控和诊断。系统复位 变量初始化?56KB 变量空间清零；?曲线缓冲区清零。加载 CONFIG.TXT 配置 对 DGUS 屏硬件进行配置 加载 22.BIN 文件 到 56KB 变量空间 检查串口升级指令（DWIN_M600_BOOT!）串口升级 DGU

16、S 程序（也可以通过 SD 卡升级）加载 13.BIN 触控文件 加载 14.BIN 显示变量控件 显示第 0 幅图片，处理变量 背光打开，屏幕点亮 DGUS 处理周期到？（80/120/160/200mS）处理对应页面的显示变量（14.BIN），字库、数据库读写。加载并运行一遍 DWIN OS 程序（23.BIN）配置寄存器数据处理（硬件控制、页面切换等）SD/SDHC 接口插卡侦测到？（DWIN_SET 文件夹）SD 卡配置、下载、升级（热拔插间隔要超过 6 秒）复位 WDT 是否需要设置初始化数据？Y Y N N Y N Y N 专业.诚信.成功 迪文 DGUS 屏开发指南 Ver4.3 北京迪文科技有限公司 -6- 400 018 9008 1.5 DGUS 屏开发流程 与传统的 LCM 通过时序或者指令控制显示不同，DGUS 屏采用直接变量驱动显示方式，所有的显示和操作都是基于预先设置好的变量配置文件来工作的。两种不同的工作方式导致用户应用时的软件架构和二次开发难度完全不同。举例，假设做一个简单的触摸屏温控仪，要在当前页面显示测量温度，点击触摸屏切换到设置页面进行参数设置。两