串口屏MODBUS教程_曲线控件和历史曲线控件的使用教程

工程技术笔记类别关键词摘要内容MOUDBUS、曲线控件、历史曲线控件广州大彩光电科技有限公司广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0修订历史版本V1.0日期2019/06/4原因创建文档编制陈鹏审查刘启鑫广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0目录

1.适合范围...........................................................................................................12.开发环境版本...................................................................................................23.概述...................................................................................................................3

3.13.23.33.4串口屏协议说明.........................................................................................................3MODBUS协议运行说明..........................................................................................3MODBUS协议配置说明..........................................................................................3建立变量说明..............................................................................................................教程实现...........................................................................................................7

4.1准备工程素材.............................................................................................................74.1.1硬件平台........................................................................................................74.1.2软件平台........................................................................................................84.1.3UI素材准备...................................................................................................84.2功能实现.....................................................................................................................84.2.1新建工程........................................................................................................84.2.2配置modbus协议.......................................................................................94.2.3画面配置........................................................................................................94.2.4运行预览......................................................................................................134.3下载工程...................................................................................................................144.3.1USB下载......................................................................................................144.3.2SD卡下载....................................................................................................155.免责声明.........................................................................................................16

广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.01.适合范围

文档适合广州大彩基本型、经济型、商业型、F型、物联型、86盒、485系列等所有MODBUS协议的串口屏产品。1/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.02.开发环境版本

1.VisualTFT软件版本：V3.0.0.1037及以上的版本，版本查看方式：(1)打开VisualTFT软件启动页面如图2-1所示，右上角显示的软件版本号；图2-1软件版本(2)打开VisualTFT，在软件右下角可以查看软件版本图2-2所示，最新版本可登录http://www.gz-dc.com/下载。图2-2软件版本2.串口屏固件版本：基本型（经济型、商业型）：MB2.22.912.259及以上的版本支持；物联型：V3.0.301.0及以上的版本支持；F型：V4.1.66.0及以上的版本支持。版本查看方式：(1)查看屏幕背面版本号贴纸；(2)画面中创建一个文本控件，属性“输入方式”选择“系统变量”，“系统变量”选择“固件版本号”，编译工程下载到屏中查看。2/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.03.概述

3.1

串口屏协议说明

大彩所有系列串口屏除NANO系列外，均支持两种协议版本：一种是大彩组态协议，一种是MODBUSRTU协议版本。串口屏的串口通讯规格为：起始位：1bit；数据位：8bit；校验位：无；停止位：1bit；串口波特率：RS232协议：支持1200～921600bps，典型波特率：115200bps；RS485协议：支持1200～115200bps，典型波特率：9600bps。3.2MODBUS协议运行说明

开发MODBUS工程，通过VisualTFT编译后，生成下载到串口屏中的工程包，编译过程会将配置的MODBUS信息转换为串口屏的工程文件；串口屏会根据工程文件运行，自动生成符合MODBUS协议的指令格式。屏做主机时，通过串口周期性地发送这些指令到从机，接收从机响应的指令并解析后，更新绑定的控件或执行预先配置的动作等。3.3MODBUS协议配置说明

1.(1)(2)(3)(4)(5)(6)(7)(8)屏作为主机，如图3-1所示；启用协议：需要启用协议，才支持MODBUS协议；协议类型：选择MODBUS主机；轮询周期：屏作主机时，周期性地读取变量，默认1秒；轮询延时：屏作主机时，相邻两次读取命令的时间间隔，默认为100毫秒；应答超时：屏作主机时，允许从机的最大延时，默认100毫秒；连续读取：设置连续地址变量的最大读取数；优化读取：开启优化读取后，只读取与当前画面相关的变量；存储设置：不存储：不存储，断电重启后变量恢复默认值；全部存储：不推荐，因为频繁存储会导致FLASH坏块增加；存储指定变量：推荐使用，一般用来存储很少更改的系统配置参数；(9)存储标记：识别存储在屏幕中的数据版本标记，当存储数据格式发生改动时，一般需要手动修改此存储标记值。3/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图3-1屏作主机2.(1)(2)(3)(4)屏作从机，如图3-2所示：启用协议：需要启用协议，才支持MODBUS协议；协议类型：选择MODBUS从机；从机地址：默认为1；存储设置：不存储：不存储，断电重启后变量恢复默认值；全部存储：不推荐，因为频繁存储会导致FLASH坏块增加；存储指定变量：推荐使用，一般用来存储很少更改的系统配置参数；(5)存储标记：识别存储在屏幕中的数据版本标记，当存储数据格式发生改动时，一般需要手动修改此存储标记值。图3-2屏做从机4/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.03.4建立变量说明

添加变量节点后，需要通过属性窗口进行设置。1.详细变量解析如下，如图3-3所示；(1)名称：默认的变量名称为“Varialbe1、Varialbe2、Varialbe3……”，可以定义有意义的名称，如：机组状态；如果需要对变量分段，默认的名称为“Field1、Field2、Field3……”，可以定义有意义的名称，如：开/关机、运行/停止；(2)格式：支持短整形、长整型、单精度浮点数、字符串；(3)符号：可设置无符号、有符号；(4)读写设置：设置变量的读写权限，支持可读写、只读取、只写入；(5)默认值：默认显示值；(6)数值转换：对变量进行转换，例如：实际值=原始值*缩放+平移；(7)显示格式：设置整数和小数部分的位数；(8)数组类型：开启数组类型，从该变量的地址开始，操作连续N个寄存器；(9)是否储存：当在配置MODBUS主/从协议时开启存储设置，此处若选择存储，可掉电保存数据。图3-3建立变量说明2.(1)(2)(3)(4)(5)详细参数设置解析如下，图3-4所示；变量类型：线圈、离散输入、保持寄存器、输入寄存器、内存变量、系统变量；从机地址：屏作主机时，才需要设置；变量地址：变量（或寄存器）的地址，16进制填写；初始化从机：屏作主机时，屏上电后，把变量的值写入从机设备；读取失败归零：屏作主机时，当变量读取失败时，变量的值归零。5/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图3-4建立参数说明6/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.04.教程实现

本章节主要实现曲线控件、历史曲线控件在MODBUS协议串口屏的应用。将分为以下3个阶段讲述教程DEMO是如何实现的：1.准备工程素材；2.功能实现；3.下载工程。4.1准备工程素材

在实现工程前需要作以下3个准备：1.硬件平台；2.软件平台；3.UI素材。4.1.1硬件平台该例程使用大彩基本型7寸串口屏DC80480B070为验证开发平台。如图4-1所示；图4-1基本型7寸串口屏其他尺寸的串口屏均可借鉴此教程。7/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.04.1.2软件平台使用大彩自主研发的上位机软件VisualTFT配置工程，登录http://www.gz-dc.com/下载。如图4-2所示。图4-2下载软件4.1.3UI素材准备准备好相应的美工UI。如图4-3所示；图4-3UI准备4.2功能实现

MODBUS工程的开发流程主要包括以下4个步骤：1.新建工程；2.配置MODBUS协议；3.创建变量并配置画面和控件；4.运行预览。本MODBUS例程主要涉及VisualTFT菜单【工具】→【协议与变量设置】部分。4.2.1新建工程打开VisualTFT软件的菜单栏【文件】→【新建工程】，弹出新建工程窗口，设置好工程名称、路径、设备类型，点击【确定】，如图4-4所示；8/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图4-4新建工程4.2.2配置modbus协议如图4-5所示，打开VisualTFT软件的菜单栏【工具】→【协议与变量设置】，点击左侧文件路径，在右侧的协议设置栏，设置协议类型，本例程设置MODBUS主机模式。详细设置说明参考3.3章节。图4-5配置协议类型4.2.3画面配置工程配置方式采用画面和MODBUS逻辑同时进行。工程逻辑结构采用首页建立导航按钮控件，不同按钮控件切换到不同的画面，每个画面有返回首页按钮控件。如图4-6所示，以下为对工程各个画面配置的介绍。9/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图4-6工程画面1.首页【首页】画面中建立两个按钮控件，如图4-7所示，按钮控件可以切换到对应的画面。图4-7工程首页在按钮控件（控件ID：1）的属性栏中，触控类型为“切换画面”；目标画面为【曲线控件】，按钮配置如图4-8所示，另一个按钮控件同理。10/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图4-8按钮设置2.曲线控件【曲线控件】画面，主要对曲线控件的使用做示例说明。MODBUS协议版本中，曲线控件用于显示关联的变量，曲线控件周期性的采样变量值，然后将所有采样值绘制到曲线控件内，连接形成曲线；曲线控件的每个通道都可以关联一个变量，最多可以设置8个通道。曲线控件配置步骤：(1)画面中添加一个曲线控件（ID：1），作为显示从机“温度”值。同时添加两个按钮控件（ID为2和4）作为增减“温度”变量的控制，以及添加一个文本控件（ID：3），直接绑定“温度”，作为数值的显示。曲线控件的相关参数配置，如图4-9所示；图4-9曲线控件(2)在【协议与变量设置】中添加3条逻辑处理:第1条：用途为“曲线绑定”，画面为“1”；控件为“1”；通道为“0”，变量为“温度”；采集周期为“1”；第2条和第3条：用途为按钮按下，执行动作为增量调节，用于控制“温度”的增减。如图4-10所示。11/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图4-10曲线控件逻辑处理此时，编译工程并下载到串口屏，和MODBUSSlave软件联机，曲线控件实时显示温度的变化。同时按下按钮控件（ID：2和ID：4）可以对“温度”变量的控制，曲线控件的显示也随着改变。注：把本例程的工程下载到串口屏或运行虚拟屏时，和Modbus《【modbus】串口屏_应用文档_V1.0.pdf》文档，后面不在累述。Slave软件联机，相关操作参考3.历史曲线控件【历史曲线控件】画面，主要对历史曲线控件的使用做示例说明。历史曲线控件和曲线控件都可以实时采样、显示绑定的变量值。不同处是历史曲线控件保存前期的数据，可以查看历史数据。MODBUS协议版本中，历史曲线控件用于显示关联的变量值，历史曲线控件周期性的采样变量值，然后将所有采样值绘制到历史曲线控件内，连接形成曲线；历史曲线控件的每个通道都可以关联一个变量，最多可以设置8个通道。历史曲线控件配置步骤：(1)画面中添加一个历史曲线控件（ID：1），作为显示从机“湿度”值。同时添加两个按钮控件（ID为2和4）作为增减“湿度”变量的控制；以及添加一个文本控件（ID：3），直接绑定变量“湿度”，作为数值的显示。历史曲线控件的相关参数配置如图4-11所示；12/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0图4-11历史曲线控件(2)在【协议与变量设置】中添加3条逻辑处理：第1条：用途为“曲线绑定”，画面为“2”；控件为“1”；通道为“0”，变量为“湿度”；采集周期为“1”；第2条和第3条：用途为按钮按下，执行动作为增量调节，用于控制“湿度”的增减。如图4-12所示；图4-12进度条逻辑处理此时，编译工程并下载到串口屏，和MODBUSSlave软件联机，历史曲线控件实时显示温度的变化。当屏幕显示的采样点数大于设置的值（默认为100），可以通过曲线控件上方的滚动条查看历史数据。同时按下按钮控件（ID：2和ID：4）可以对“温度”变量的控制，曲线控件的显示也随着改变。4.曲线控件说明和历史曲线控件说明【曲线控件说明】和【历史曲线控件】画面分别对曲线控件、历史曲线控件的操作方法说明，无其它功能。4.2.4运行预览13/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.0本例程屏幕作主机，使用ModbusSlave软件作从机；ModbusSlave软件模拟响应串口屏的请求指令。运行虚拟屏，与ModbusSlave建立联机，运行效果如图4-13所示。

图4-13虚拟屏运行效果注：把本例程的曲线控件的效果体验需要下载到实体屏运行，历史曲线可以在虚拟屏上体验。4.3下载工程

在我司的上层软件VisualTFT把工程编译成功后，可以通过以下两种方法下载到大彩串口屏设备中：1.USB下载；2.SD卡下载。4.3.1USB下载工程编译成功后在输出窗口会提示编译成功，如图4-14所示。然后点击VisualTFT菜单栏中【下载到设备】所示；按钮，即可以通过USB线将工程配置下载到串口屏中，如图4-14图4-14USB下载14/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.04.3.2SD卡下载1.点击编译工程，在输出窗口中提示编译成功后，点击VisualTFT菜单栏中的【工具】然后选择“量产向导”，如图4-15所示；图4-15SD卡量产下载2.在“量产向导”的选择窗口中，点击“SD卡下载”然后把弹窗中所有文件拷贝到SD卡根目录下，如图4-16所示；图4-16量产下载把SD卡插入串口屏后，将串口屏重新上电，等待烧录成功后把SD卡取下。15/15广州大彩光电科技有限公司MODBUS教程_曲线控件和历史曲线控件V1.05.免责声明

本文档提供有关广州大彩光电科技有限公司（以下简称：大彩科技）产品的信息，旨在协助客户加速产品的研发进度，在服务过程中或者其他渠道所提供的任何例程程序、技术文档、CAD图等资料和信息都仅供参考，客户有权不使用或自行参考修改。本公司不提供任何的完整性、可靠性等保证，若在客户使用过程中因任何原因造成的特别的、偶然的或间接的损失，本公司不承担任何责任。大彩科技产品不能在用于军事、医疗、救生或维生等用途中作为唯一控制设备。本文档并未授予任何知识产权的许可，并未以明示或暗示，或以禁止发言或其它方式授予任何知识产权许可。除大彩科技在其产品的销售条款和条件中声明的责任之外，大彩科技概不承担任何其它责任。并且，大彩科技对大彩科技产品的销售和/或使用不作任何明示或暗示的担保，包括对产品的特定用途适用性、适销性或对任何专利权、版权或其它知识产权的侵权责任等，均不作担保。大彩科技可能随时对产品规格及产品描述做出修改，恕不另行通知。16/15