迪文DGUS屏开发指南

专业素养.诚实守信.追求卓越迪文DGUS屏用户开发指南（Ver4.32015.08）北京迪文科技有限公司WWW.DWIN.COM.CN专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-1-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn目录1DGUS概述............................................................................................................................31.1认识迪文DGUS屏............................................................................................................................................................31.2DGUS屏主要特点..............................................................................................................................................................41.3DGUS屏数据格式..............................................................................................................................................................41.4DGUS软件处理流程图......................................................................................................................................................51.5DGUS屏开发流程..............................................................................................................................................................62DGUS屏配置........................................................................................................................72.1SD/SDHC配置接口............................................................................................................................................................72.2SD/SDHC下载文件格式说明............................................................................................................................................82.2.1图片下载......................................................................................................................................................................82.2.2字库下载......................................................................................................................................................................82.2.3CONFIG.TXT配置文件..............................................................................................................................................82.2.4声音文件下载..............................................................................................................................................................92.2.5DGUS应用程序升级..................................................................................................................................................92.2.6用户数据库SD卡导出...............................................................................................................................................92.3DGUS屏参数配置............................................................................................................................................................102.3.1屏幕物理分辨率设置（R0）....................................................................................................................................102.3.2显示位时钟相位选择（R4）....................................................................................................................................102.3.3串口波特率设置（R1、R5、R9）..........................................................................................................................102.3.4串口通信帧头设置（R3、RA）..............................................................................................................................102.3.5软件工作模式配置寄存器（R2、RC）..................................................................................................................112.3.6屏幕显示方向设置（R2.7R2.6）............................................................................................................................112.3.7触摸屏控制背光（R2.5R6R7R8）........................................................................................................................122.3.8触摸屏校准................................................................................................................................................................122.3.9SD/SDHC接口禁止和解锁......................................................................................................................................122.4ED2下载器.......................................................................................................................................................................133串口操作.............................................................................................................................143.1数据帧架构........................................................................................................................................................................143.2指令集................................................................................................................................................................................143.3串口CRC校验C程序参考............................................................................................................................................154DGUS寄存器......................................................................................................................164.1DGUS寄存器一览表........................................................................................................................................................164.2读写RTC..........................................................................................................................................................................174.3字库读取...........................................................................................................................................................................174.4128段音乐播放.................................................................................................................................................................174.5数据库读写.......................................................................................................................................................................184.6按键触发...........................................................................................................................................................................185DWINOS用户程序设计......................................................................................................195.1基本约定...........................................................................................................................................................................195.2DWINOS汇编指令集......................................................................................................................................................206触控/键控配置文件（13.BIN）说明....................................................................................266.1触控/键控功能一览表......................................................................................................................................................266.2变量数据录入（0x00）....................................................................................................................................................276.3弹出菜单选择（0x01）....................................................................................................................................................296.4增量调节（0x02）............................................................................................................................................................306.5拖动调节（0x03）............................................................................................................................................................316.6RTC设置（0x04）...........................................................................................................................................................326.7按键值返回（0x05）.......................................................................................................................................................336.8文本录入（0x06）...........................................................................................................................................................336.8.1ASCII文本录入.........................................................................................................................................................346.8.2GBK汉字文本录入...................................................................................................................................................356.9硬件参数配置（0x07）...................................................................................................................................................376.10触摸屏按压状态同步数据返回（0x08）....................................................................................................................386.11转动调节（0x09）..........................................................................................................................................................39专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-2-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn7显示变量配置文件（14.BIN）说明.....................................................................................407.1显示变量功能一览表......................................................................................................................................................407.2图标变量..........................................................................................................................................................................417.2.1变量图标显示（0x00）...........................................................................................................................................417.2.2动画图标显示（0x01）...........................................................................................................................................427.2.3滑块刻度指示（0x02）...........................................................................................................................................437.2.4艺术字变量显示（0x03）.......................................................................................................................................447.2.5图片动画显示（0x04）...........................................................................................................................................457.2.6图标旋转指示（0x05）...........................................................................................................................................467.2.7位变量图标显示（0x06）.......................................................................................................................................477.3文本变量..........................................................................................................................................................................487.3.1数据变量显示（0x10）...........................................................................................................................................487.3.2文本显示（0x11）...................................................................................................................................................497.3.3RTC显示（0x12）...................................................................................................................................................507.3.4HEX变量显示（0x13）..........................................................................................................................................517.3.5文本滚屏显示（0x14）...........................................................................................................................................517.4图形变量..........................................................................................................................................................................527.4.1实时曲线（趋势图）显示（0x20）.......................................................................................................................527.4.2基本图形显示（0x21）...........................................................................................................................................537.4.3列表显示（0x22）...................................................................................................................................................557.4.4二维QR码图形显示（0x25）................................................................................................................................568DGUS屏应用问答（FAQ）................................................................................................579DGUS特殊应用软件使用说明.............................................................................................609.1基于Modbus主机接口的DGUS软件应用说明..........................................................................................................609.2基于Modbus从机接口的DGUS软件应用说明..........................................................................................................6110DGUS屏开发典型程序参考（ASM51、C51）.................................................................62附录修订记录.......................................................................................................................67专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-3-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn1DGUS概述1.1认识迪文DGUS屏DGUS（DWINGraphicUtilizedSoftware）是北京迪文科技有限公司基于K600+内核迪文屏所设计的智慧型、图形界面、人机系统软件，DGUS软件架构如下图所示：出厂预装DGUS软件的屏称为DGUS屏，一个典型的DGUS屏（DMT80480T070_07WT）硬件组成如下图所示：专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-4-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn1.2DGUS屏主要特点DGUS屏的主要特点包括：�把GUI分解成控件并按页面来配置，控件显示直接由变量控制；在通过PC软件配置好控件文件（14.BIN）下载到DGUS屏后，用户仅仅需要通过串口改写变量值即可实现控件显示的相应改变。比如，要在某个页面显示两位小数（25.00）的温度值，分两步开发完成：Step1配置：借助迪文提供的PC组态开发软件，在相应页面位置添加一个数据变量控件，设置好显示格式（字体大小、显示颜色、单位、小数点长度、数据源、数据类别），预览OK后通过SD卡把生成的控件文件（14.BIN）下载到DGUS屏。Step2运行：用户软件只需要定时（或者参数变化时）把温度值通过串口刷新到对应的数据源地址，当显示切换到对应页面时，屏幕就自动按照预先设定显示格式显示出来。�触摸屏或键盘录入过程，通过PC软件按照页面定义的触控文件（13.BIN）来控制，用户软件仅需要定时（或者参数改变时的串口中断触发）来读取录入变量值即可。比如，要在某个页面用触摸屏录入显示两位小数（25.00）的设定温度值，分两步开发完成：Step1配置：借助迪文提供的PC组态开发软件，在相应页面位置添加一个变量数据录入控件，设置好录入格式（字体大小、光标模式、显示颜色、小数点长度、数据源、数据类别），预览OK后通过SD卡把生成的控件文件（13.BIN）下载到DGUS屏。Step2运行：当切换到对应页面，并按压触摸屏触发相应控件，DGUS会自动完成录入过程。用户软件只需要定时（或者配置为录入完成自动串口下发给用户）查询录入值即可。�56KB变量空间，8通道曲线趋势图存储器，极快（最快80mS）的变量显示响应速度；�256字节配置寄存器空间，串口指令读写，用于硬件控制和操作；�256MB（可以扩展到1GB、2GB）Flash存储器，海量图片、图标、字库存储；�每页可设置多达128个显示控件（支持显示控件叠加）和任意多的触控控件。�SD/SDHC接口，FAT32文件格式，可以使用SD卡来实现DGUS屏硬件参数配置、图片数据下载、软件升级，批量生产时尤其方便，并便于生产档案管理。�集成了RTC（公历/农历）、集成背光亮度调节、背光自动待机、触控蜂鸣器伴音功能；�支持语音播放功能、支持电容触摸屏、可以在图片存储器空间构造高可靠性用户数据库；�集成的DWINOS平台，丰富的指令，可以允许用户把一部分代码放到DGUS屏上运行，让用户二次开发变得简单，也提供了DGUS屏做为系统主控设备的可能。迪文OS平台集成了数学运算（包括MAC、CRC）、数据存储（包括Flash数据库读写）、串口通信、常用通信 协议 离婚协议模板下载合伙人协议 下载渠道分销协议免费下载敬业协议下载授课协议下载 处理（比如Modbus协议、DL/T645电力抄表协议等）、串口外设（比如打印机）驱动、DGUS进程控制等指令，典型的应用案例包括Modbus总线管理、电力抄表、票据打印、POS设备等。�可靠的硬件平台（基于迪文ASIC的HMI平台架构，已经历了将近10年的工业应用考验）、迪文自主知识产权的软件设计（DGUS软件采用汇编代码设计，总代码量约50KB），使DGUS屏不仅性能优越，运行也极其稳定可靠。�通过TUVCE和RoHS认证。1.3DGUS屏数据格式由于主要面向MCU等嵌入式系统应用，为了用户处理的方便，DGUS屏使用的数据采用整数（字）、无符号整数（字）、长整数（双字）、超长整数（4个字）表示，相关表示范围如下：整数：-32768（0x8000）到+32767（0x7FFF）无符号整数：0（0x0000）到65535（0xFFFF）长整数：-2147483648（0x80000000）到+2147483647（0x7FFFFFFF）超长整数：-9223372036854775808到9223372036854775807小数采用定点小数表示，用户自定义小数位数，比如0x4D2（1234），规定小数为2位时，表示12.34。DGUS屏使用65K色颜色系统，调色板定义如下：DGUS使用的65K设调色板位定义Bit1514131211109876543210R4R3R2R1R0G5G4G3G2G1G0B4B3B2B1B0Define红色0xF800绿色0x07E0蓝色0x001F专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-5-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn1.4DGUS软件处理流程图说明：DWINOS程序在每个DGUS周期（80/120/160/200mS）都完整运行一遍，所以DWINOS程序中不能出现死循环或者通过指令循环的延时。串口中断（串口数据处理）外设中断（RTC、语音等数据处理）触摸屏/按键中断（页面逻辑并处理13.BIN）DEBUG中断�DWINOS仿真；�系统运行监控和诊断。系统复位变量初始化�56KB变量空间清零；�曲线缓冲区清零。加载CONFIG.TXT配置对DGUS屏硬件进行配置加载22.BIN文件到56KB变量空间检查串口升级指令（DWIN_M600_BOOT!）串口升级DGUS程序（也可以通过SD卡升级）加载13.BIN触控文件加载14.BIN显示变量控件显示第0幅图片，处理变量背光打开，屏幕点亮DGUS处理周期到？（80/120/160/200mS）处理对应页面的显示变量（14.BIN），字库、数据库读写。加载并运行一遍DWINOS程序（23.BIN）配置寄存器数据处理（硬件控制、页面切换等）SD/SDHC接口插卡侦测到？（DWIN_SET文件夹）SD卡配置、下载、升级（热拔插间隔要超过6秒）复位WDT是否需要设置初始化数据？YYNNYNYN专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-6-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn1.5DGUS屏开发流程与传统的LCM通过时序或者指令控制显示不同，DGUS屏采用直接变量驱动显示方式，所有的显示和操作都是基于预先设置好的变量配置文件来工作的。两种不同的工作方式导致用户应用时的软件架构和二次开发难度完全不同。举例，假设做一个简单的触摸屏温控仪，要在当前页面显示测量温度，点击触摸屏切换到设置页面进行参数设置。两种不同开发方式下的软件流程图如下：上面的例子，只是一个两个参数、两个页面的最简单GUI，如果对于实际应用中稍微“高级”一点的产品，几十个参数，几十个页面，还要考虑动画、图标等等吸引眼球的GUI，前一种方式需要1个优秀工程师加班加点干1年，而使用DGUS屏开发，3-4个工程师（可以并行协同做）2-3天就搞定了。在有些中、小型工业自动化项目应用中，当整个系统由一些相对独立、功能完善的组件（比如支持Modbus协议的温控仪或其它二次仪表）构成时，用户可以直接把DGUS屏当成主机使用，用485网络把设备和DGUS屏组成一个网络，基于DGUS屏上搭载的DWINOS二次开发平台来开发用户主控软件直接在DGUS屏上运行，替代用户CPU的工作。总的来说，DGUS屏是基于配置文件来工作的，所以整个开发过程也就是通过PC软件辅助设计完成变量配置文件的过程，基本开发流程如下：第1步：变量规划推荐客户开发过程中用Excel 表格 关于规范使用各类表格的通知入职表格免费下载关于主播时间做一个表格详细英语字母大小写表格下载简历表格模板下载 来记录、整理好变量分配记录，便于将来的修改、升级维护。第2步：界面设计利用PS（或者其它绘图软件）进行界面及界面相关元素（图标、字库）设计。设计过程中，请选择调色板系统为65K色，确保最终显示效果和设计效果一致。如果想让您的产品至少看起来很有价值，建议委托专业美工或者工业设计公司来设计UI和相关界面，一般收费在200人民币/1个页面左右。第3步：界面配置利用迪文提供的工具软件进行界面的配置，生成触控配置文件(13.BIN)和变量配置文件(14.BIN)。第4步：测试修改把配置文件、图片、字库、图标库等借助SD卡下载到DGUS屏，进行界面测试和修改（第2-3步）。把串口连上用户MCU系统，进行数据联调。第5步：定版归档定版后，把配置文件、图片、字库、图标库等DGUS屏涉及的文件保存在一张SD卡转生产即可。如果不希望最终客户通过SD卡接口改变或者导出内部数据，可以对SD卡接口加密锁死(加密后用户必须保管好SD卡的开锁密码，一旦SD卡锁死，没有开锁密码，只能返厂更换内核CPU才能使SD卡接口再次启用)。专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-7-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn2DGUS屏配置2.1SD/SDHC配置接口DGUS屏的所有硬件参数设置和 资料 新概念英语资料下载李居明饿命改运学pdf成本会计期末资料社会工作导论资料工程结算所需资料清单 下载，都通过屏上的SD/SDHC接口来完成，文件必须使用FAT32文件格式。第一次使用SD卡前，推荐先格式化一次，流程如下：第1步：在windows的开始//运行,键入command运行DOS系统；第2步：把SD卡格式化，键入指令：format/qg:/fs:fat32/a:4096其中g是SD卡的盘符，不同的电脑用对应的盘符（比如h,i）替换即可；如下图所示：使用SD卡下载数据的流程�在SD卡根目录下建立DWIN_SET文件夹；�把需要下载的图片、字库、配置文件都放在DWIN_SET文件夹中，如下图所示：�把SD卡插到DGUS屏的SD卡接口上，DGUS屏 检测 工程第三方检测合同工程防雷检测合同植筋拉拔检测方案传感器技术课后答案检测机构通用要求培训 到SD卡后，会显示蓝屏提示用户检测到SD卡，然后开始屏参数配置，或将数据下载到屏上的Flash中；两次SD卡热拔插之间必须间隔至少6秒，不然DGUS屏会认为是同一张卡而不会启动SD卡操作。如果用户已经禁止SD卡接口，要启用SD卡接口，除非事先解锁或在SD卡的CONFIG.TXT文件中有解锁指令。�SD卡下载完成，DGUS屏会自动复位一次，用户拔出SD卡，下载结束。专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-8-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn2.2SD/SDHC下载文件格式说明为防止误操作，DGUS屏对SD/SDHC配置文件有严格的命名和格式要求，不然会导致出错。2.2.1图片下载图片文件必须是和DGUS屏分辨率相同的24位色BMP格式文件，文件的命名必须是表示图片存储位置的阿拉伯数字开头。比如，要把一副图片用SD卡存储到DGUS屏的第20个图片存储位置，图片文件可以命名成“20测试.BMP”、“20.BMP”或者“020测试.BMP”，但不能命名成“测试20.BMP”。不同分辨率DGUS屏最大存储图片数量如下表所示：不同分辨率DGUS屏最大存储图片数量类别存储器空间字库320*240480*272640*480800*480800*6001024*6001024*768标准256MB32MB836836278278209167139扩展到1GB1GB32MB3728372812421242932745621扩展到2GB2GB32MB75847584252825281896151612642.2.2字库下载DGUS屏一共有32MB字库空间，分割成128个容量固定为256KB的字库空间。和下载图片类似，字库文件的命名也必须是表示字库存储位置（0-127）的阿拉伯数字开头。下载的字库文件包括字库、输入法词库、配置文件、图标文件；字库文件格式说明如下表所示：SD卡文件格式说明文件类型命名规则举例说明字库文件字库存储位置+（可选的）文件名.BIN/HZK/DZK32_GBK12汉字库.DZK可以由TS3字库提取软件生成图标库字库存储位置+（可选的）文件名.ICO41图标库.ICO迪文工具箱生成专用ASCII字库0*.HZK，固定位置0-110_DWIN_ASC.HZK迪文工具箱生成输入法词库12*.BIN，固定位置1212_PY_DGUS.BIN迪文预装触控配置13*.BIN，固定位置1313触控文件.BINDGUS组态软件生成变量配置14*.BIN，固定位置14-2114变量文件.BINDGUS组态软件生成变量初始化22*.BIN，固定位置2222变量初始化.BINOS代码23*.BIN，固定位置2323水处理.BIN基于DWINOS0-23号字库（6MB）被DGUS系统预留做为将来系统升级使用，用户字库建议从24位置开始使用。2.2.3CONFIG.TXT配置文件CONFIG.TXT文件采用windows的文本文档格式，类似脚本语言的方式来描述参数寄存器，每一行描述一个参数(格式必须是R?=HH其中？是寄存器序号，HH是寄存器配置值的16进制（HEX）值，必须大写)，不用的参数可以不写，如下图所示。上例中，RA=A5表示把RA寄存器内容配置成0xA5。不能写成ra=5a或者RA=5a，并且每个寄存器配置后必须换行写下一个寄存器配置。CONFIG.TXT文件相关参数说明请参考“2.3DGUS屏硬件参数配置”。专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-9-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn2.2.4声音文件下载有些DGUS屏（具体看硬件规格书说明）支持128段语音播放，需要事先下载声音文件存储到屏里面。和下载字库类似，声音文件的命名也必须是表示声音存储位置（0-127）的阿拉伯数字开头（比如12请刷卡.WAV），声音文件的后缀是.WAV，采用32KHz采样，16bit单声道WAV文件格式。声音文件采用额外的Flash存储，不占用DGUS的FLASH空间，下载存储速度约为32KB/S。2.2.5DGUS应用程序升级DGUS屏支持SD卡升（降）级应用程序，把应用程序（DGUS_V*.BIN）放到SD卡DWIN_SET目录下即可。2.2.6用户数据库SD卡导出用户数据库是在DGUS屏的图片存储器中拿出一块空间进行数据存储，空间大小和位置由用户控制，不同内核其Flash大小不同，导致图片存储器空间和可用数据库空间也不相同，如下表所示：不同分辨率DGUS屏最大存储图片数量类别图片空间最大容量数据库空间最大容量320*240480*272640*480800*480800*6001024*6001024*768标准210MB89MB836836278278209167139扩展到1GB932MB450MB3728372812421242932745621扩展到2GB1896MB960MB7584758425282528189615161264用户数据库读写过程中，DGUS对数据进行了加密和前向纠错（FEC）操作，确保数据存储的可靠性。用户数据库导出 方法 快递客服问题件处理详细方法山木方法pdf计算方法pdf华与华方法下载八字理论方法下载 如下：�先计算出导出数据库的起始页位置假设要导出的数据库首地址为ADR，那么地址的最高两个字节+256即为对应的SD卡导出页ID。�用起始页位置命名创建一个和导出数据库等大（对齐到128KB）的DAT文件：字库起始页位置+（可选的）文件名.DAT�把这个DAT文件放到SD卡DWIN_SET文件夹下面，插入DGUS屏SD卡接口，DGUS屏会自动把指定的数据库内容读取出来覆盖SD卡上的DAT文件。举例，假设要导出数据库空间0x00100000到0x0017FFFF共1MB（512KW）数据，那么对应的SD导出页ID是：0x0010+256=272在SD卡的DWIN_SET目录下放置1个大小是1MB的文件272数据库记录.DAT（或者其它272***.DAT的文件名都可以），把SD卡插入DGUS屏SD/SDHC接口即可把数据库内容导出。数据库导出速度大约为180KB/S，对于很大的数据库导出，可以分成几个文件来处理。关于用户数据库的详细说明请见“4.5数据库读写”。专业.诚信.成功迪文DGUS屏开发指南Ver4.3北京迪文科技有限公司-10-www.dwin.com.cn4000189008dwinhmi@dwin.com.cn2.3DGUS屏参数配置DGUS屏参数配置通过在CONFIG.TXT文件中写好寄