北京迪文科技有限公司 400客服中心 产品购买、技术咨询、售后服务热线：400 018 9008 企业QQ ：400 018 9008
======================================================================
一、本文档基本约定
本文档中，约定如下书写规范：
1、本文档总的参考源：迪文DGUS屏开发指南_V43
2、用数据前加“0x”或数据后加“H”的方式表示16进制数据，比如：0xAA或AAH都表示16进制数据AA。为了方便用户直接应用，本文档DGUS指令都使用16进制书写，并不加任何标记，比如：5A A5 05 82 0001 0002 表示串口发送的一条指令，等同0x5A 0xA5 0x05 0x82 0x0001 0x0002
3、用（x,y）表示显示屏的坐标位置：比如（0,0）表示x=0,y=0的坐标点。
4、串口的所有指令或者数据都是16进制（HEX）格式：对于字型（2字节）数据，总是采用高字节先发送（MSB）方式。比如0x1234传送时先传送0x12. 5、用单引号‘’表示文本信息，比如：‘北京迪文科技’对应的汉字内码是0xB1B1 0xBEA9 0xB5CF 0xCEC4 0xBFC6 0xBCBC
======================================================================
二、新屏通讯注意事项
1、DGUS屏有三种通讯方式：TTL\\232\\485。注意有些种类的屏后面通信短接点的情况。 2、屏和电脑连接，在确认连接正常、波特率正确，串口号正确的情况下，发送指令： 5A A5 03 81 00 01，（推荐用串口工具比如sscom32） 3、如果有返回值5A A5 04 81 00 01 **,表示通讯正常。
注：发送的指令是读取屏的当前内核版本号，以此来检查通讯发送和接收收是否正常。
5A A5 表示：帧头（默认帧头，如果用户已自行修改，请根据当前帧头发送指令）， 03 表示：数据长度（以字节为单位）， 81 表示：读取DGUS屏寄存器指令
00 表示：寄存器（存储DGUS 屏内核版本号的寄存器序号）， 01 表示：版本号为01个字节长度。 返回：5A A5 04 81 00 01 68
返回的数据68，表示当前内核为V68 版本（由于内核不断升级中，根据购买时间的不同，内核版本也不一样，如62,61,60,59,58......都表示正确的版本号，版本号的高低只跟DGUS 屏的功能有关）
======================================================================
北京迪文科技有限公司 400客服中心 产品购买、技术咨询、售后服务热线：400 018 9008 企业QQ ：400 018 9008
======================================================================
三、DGUS屏DWIN_SET内文件说明
字库说明：DGUS屏一共有32MB字库空间，分割128个成固定容量大小256kB
说明：
0号字库（大小可以随意调用 最大是64*128 ），它的大小占用了12个空间， 12是GBK录入输入法文件， 13是触控配置文件， 14是显示配置文件， 15-21是系统预留， 22是初始值加载文件，
23是os二次开发软件写ASM文件编译生成后下载到屏里面的文件，
24开始是用户自定义从：如图标库大小大于256KB，假设为257KB，那么将占用两个字库空间，假设字库命名“40-指示灯.ICO” 大小为257KB，那么占用了40,41 两个字库空间，下一个图标库不能写为41.ICO，必须由42序号命名开始；
---------------------------------------------------------------------------------------------------------------------
图片说明：图片文件必须是和DGUS屏分辨率相同的24位色BMP格式文件
命名从0号界面开始（图片命名序号和字库命名序号不冲突），后面可加入注释比如：00_密码进入界面.bmp ，01_密码按钮效果.bmp等等
---------------------------------------------------------------------------------------------------------------------
系统配置说明：
config.txt 下图是一个标准配置，DGUS软件系统配置点击自动生成或手动修改 R1=07 ;波特率,07=115200
R2=2C ;2CH=00101100B 参考开发指南R2寄存器定义表格.2 .3 .5位配置 R3=5A ;帧头高字节
R6=40 ;触摸屏控制背光启用后，点击触摸屏后背光亮度（00-40） R7=10 ;触摸屏控制背光启用后，一段时间不点击，背光关闭的亮度 R8=1E ;30秒不点击触摸屏，触摸屏背光降低到上面R7=10 RA=A5 ;帧头低字节
RUN_DWIN_OS;启用os (STOP_DWIN_OS;关闭os) TP_CORRECT ;插卡配置时开启触摸屏校准一次 RC=00 ;参考RC寄存器8个位的配置。
---------------------------------------------------------------------------------------------------------------------
北京迪文科技有限公司 400客服中心 产品购买、技术咨询、售后服务热线：400 018 9008 企业QQ ：400 018 9008
四、DGUS寄存器读写指令。 读DGUS屏寄存器指令（81）
如读版本号：上一节有讲到。下面举例读图片地址为说明：
以读当前图片地址为例 （假设当前页面地址是第 5 幅）向屏发指令如下：
5A A5 03 81 03 02
5A A5 表示：帧头（默认帧头，如果用户已自行修改，请根据当前帧头发送指令） 03 表示：数据长度（以字节为单位） 81 表示：读DGUS屏寄存器
03 表示：寄存器（存储DGUS 屏页面寄存器（03和04寄存器存放的页面）） 02 表示：02个字节长度（图片地址是两个字节）
指令发送完毕后以后屏会向串口返回读的应答： 5A A5 05 81 03 02 0005 5A A5 表示：帧头 05 表示：数据长度
81 表示：读DGUS屏寄存器
03 表示：寄存器（存储DGUS 屏页面寄存器（03和04寄存器存放的页面）） 02 表示：02个字节长度（图片地址是两个字节）
0005 表示：读回来的03和04寄存器里面放的数，也就是页面号
------------------------------------------------------------------------------------------------------------------ 写DGUS屏寄存器指令（80）
此处以切换图片为例，如从当前页面切换到第6幅图片，向屏发指令如下：
5A A5 04 80 03 0005 5A A5 表示：帧头
04 表示：数据长度
80 表示：写DGUS屏寄存器
03 表示：寄存器（存储DGUS 屏页面寄存器（03和04寄存器存放的页面）） 0005 表示：向寄存器03和04分别写00和05，也就是切换到第5页
（此条指令还可以这样写 ：5A A5 03 80 04 05，只写04寄存器，针对页面不超过FF）
其他寄存器写指令举例：
控制亮度： 5A A5 03 80 01 20 一半的亮度范围（亮度范围00~40） 蜂鸣器： 5A A5 03 80 02 20 单位10ms最大FF
复位指令： 5A A5 04 80 EE 5A A5 相当如掉电之后再上电的效果 页面切换： 5A A5 04 80 03 0001
RTC： 5A A5 0A 80 1F 5A 15 07 03 00 16 05 59
（更改为2015年07月03日16：05：59星期 用的00自动换算）
5A A5 03 81 20 10 返回：公历时间加农历年月日癸巳蛇
5A A5 13 81 20 10 13 11 08 05 18 18 56 13 10 06 B9 EF CB C8 C9 DF 触摸屏校准： 5A A5 03 80 EA 5A
(后会一次出现白色小叉叉，推荐用笔尖点击,电阻屏)
关闭触摸功能：5A A5 03 80 0B 00
北京迪文科技有限公司 400客服中心 产品购买、技术咨询、售后服务热线：400 018 9008 企业QQ ：400 018 9008
5A A5 03 80 0B 01 （01-FF开启）
按键触发： 5AA5 03 80 4F (00~FF) 勾选后指令控制触摸按键功能
（右上角键控选项是01到FF之间可以设置255个键，把按钮设置键控之后，软件界面显示颜色会变灰，这个时候就需要：发指令触发5a a5 03 80 4F 01。触控就不起作用 如果想触控和键控同时触发，需要再复制一个上去，一个设置键控，一个不设置，‘黄色’和‘灰色’的方块可以覆盖存在的，灰色的键控放在此页面的任意位置都可以）
======================================================================
五、DGUS变量地址读写指令。
写变量存储器指令指令（82）
此处以往 0000 变量地址里写数值 2 为例： 5A A5 05 82 0000 0002 5A A5 表示：帧头 05 表示：数据长度
82 表示：写变量存储器指令 0000 表示：变量地址（两个字节） 0002 表示：数据2（两个字节）
解释：通过指令往0000地址里面赋值2.屏上的显示，数据变量整数类型2
--------------------------------------------------------------------------------------------------------------------- 读变量存储器指令指令（83）
此处以读 0000 变量地址里的数值（假设当前数值为 2）为例： 5A A5 04 83 0000 01 5A A5 表示：帧头 04 表示：数据长度
83 表示：读数据存储区指令 0000 表示：变量地址（两个字节）
01 表示：从 0000 地址开始读 1 个字长度数据 读完以后屏会向串口返回读应答： 5A A5 06 83 0000 01 0002 5A A5 表示：帧头
06 表示：数据长度
83 表示：读变量存储器指令指令 0000 表示：变量地址（两个字节）
01 表示：从 0000 地址开始读 1 个字长度数据 00 02 表示：0000 地址里的数据值是 2
--------------------------------------------------------------------------------------------------------------------- 触摸按键返回到串口数据（83）
此处以按返回变量地址0001，键值0002为例： 5A A5 06 83 00 01 01 00 02 5A A5 表示：帧头
06 表示：数据长度
83 表示：读变量存储器指令指令 0001 表示：变量地址（两个字节）
北京迪文科技有限公司 400客服中心 产品购买、技术咨询、售后服务热线：400 018 9008 企业QQ ：400 018 9008
01 表示：1 个字长度数据 00 02 表示：键值0002
======================================================================
VP（变量地址）和SP（描述指针）通常是指显示变量功能的两种定义，两者共用0000
到6FFF地址：
1、VP指某个变量显示功能必须需要的实际地址，必须要定义。
2、SP指某个VP地址显示的控件的属性地址，以便在应用中可以让用户指令修改，达到实时控制不同显示效果目的如字体颜色、位置、状态等属性。可以不定义（默认FFFF）。 ======================================================================
六、变量地址如何规划：
DGUS标准屏变量地址0000H~6FFFH，注：Mini DGUS屏变量地址和描述指针范围是0000——07FF
总体规律：上图是一个基本图形剪切指令的地址分配情况，可以清晰的看到，大致的一个变量地址的占用其实是根据指令发送的地址后面接的数据字长来决定的。
实际变量地址规划注意事项：
1、变量图标 占用一个地址。可以根据指令情况来看是依照总体规律的，如5A A5 05 82 0001 0001显示0001地址的1号图标
2、动画变量图标 占用两个地址。没有依照总体规律。如5A A5 05 82 0002 0001显示0002地址的 动画图标开始动画。另一个地址理解为辅助用。
3、位变量图标 占用三个地址，实际指令是占用一个地址，如5a a5 05 82 0004 FFFF将0004地址的16个位写满，另外两个地址，是辅助地址，主要是辅助位变量图标的动画显示用的，辅助地址不可以访问，可以接在后面设置如0005，0006。
4、文本变量 占用地址依据上面的总体规律，如 发指令显示北京，5A A5 07 82 0008 B1B1 BEA9。注意，如果文本用了GBK录入或者ASCII录入，前面一个地址要预留，所以这里假设0007H要空着。
5、数据变量 占用地址依照总体规律，如设置整数，发送5A A5 05 82 000A 000B，在0x000A地址里写入11，如长整数：5A A5 07 82 000B 0000 000B 在000B和000C地址里面写入数11，数据变量显示的单位占用的是描述指针地址，最多可显示11个ASCII码。 6、RTC时间 不占用变量地址，可以用描述指针 7、动画图片 不占用变量地址，可以用描述指针
8、HEX变量 占用变量地址根据右边设置 Byte_Mum的长度来的，比如Byte_Mum设置4，那么地址占用是4个字节，也就是2个变量地址，编码字符串占用描述指针的地址。 ======================================================================
DGUS指令说明文档7.1
