Modbus 教程 6：数据记录控件（串口屏 Modbus 告警记录）

数据记录控件是大彩串口屏里专门用来做告警/事件记录的工具。在 Modbus 工程里，它最常干两件事：把从机（PLC、变频器、温控模块）上来的报警状态记下来，按时间排好，显示在屏上。本教程以「当前告警」和「历史告警」两种记录类型为例，走一遍从协议配置到画面联调的完整流程。文档整理自广州大彩光电科技有限公司《MODBUS 教程_数据记录控件 V1.0》，版权归大彩。

1 适用范围与开发环境

该文档适用于大彩所有支持 Modbus 协议的串口屏产品：基本型、经济型、商业型、F 型、物联型、86 盒、485 系列。NANO 系列除外（NANO 仅支持大彩组态协议，不支持 Modbus）。

搭建工程前先确认版本够用，版本不够会在编译或运行期出诡异问题，调半天发现是固件旧了：

本例程硬件验证平台为大彩基本型 7 寸屏 DC80480B070，其它尺寸串口屏照此教程即可。上位机用大彩自研的 VisualTFT，官网 http://www.gz-dc.com 下载。

2 串口屏 Modbus 协议基础

大彩除 NANO 外的所有系列串口屏，都同时支持两种协议版本：大彩组态协议、Modbus RTU 协议。屏的串口物理规格固定为：1 起始位 / 8 数据位 / 无校验 / 1 停止位（8N1）。波特率范围：RS232 支持 1200～921600bps（典型 115200），RS485 支持 1200～115200bps（典型 9600）。

开发 Modbus 工程时，你在 VisualTFT 里配好的变量和协议，编译后会固化进工程包下到屏里。屏作主机时，按你设的轮询周期周期性地往从机发读指令，收到从机应答后解析，刷新绑定的控件或触发预设动作；屏作从机时则响应外部主站的轮询。

3 Modbus 协议与变量配置

打开 VisualTFT 菜单【工具】→【协议与变量设置】，左侧选文件路径，右侧协议设置栏设协议类型。数据记录控件本身不绑定具体寄存器读取，它显示的是「变量」的状态变化，而变量是从 Modbus 寄存器映射上来的——所以协议和变量是前置条件。

3.1 屏作主机配置项

存储设置里「全部存储」不推荐——频繁写 Flash 会加速坏块。要掉电保存的，用「存储指定变量」勾选特定变量即可。屏作从机时配置项少一些：启用协议、协议类型选「Modbus 从机」、从机地址（默认 1）、存储设置、存储标记。

3.2 建立变量

添加变量节点后在属性窗口设置。几个关键属性：

变量参数里：变量类型支持线圈、离散输入、保持寄存器、输入寄存器、内存变量、系统变量；屏作主机时才需要填从机地址和变量地址（16 进制填写）；「初始化从机」是上电后把变量值写回从机；「读取失败归零」是读不到时变量归零（报警场合慎用，可能误显）。

4 教程实现：数据记录控件做告警记录

数据记录控件支持三种记录类型：当前告警、历史告警、历史告警与解除（比「历史告警」多了每条告警的解除时间）。本例程对前两种做示范。整体分三步：准备素材 → 功能实现 → 下载工程。

4.1 准备工程素材

硬件用 DC80480B070 基本型 7 寸屏；软件用 VisualTFT；UI 用准备好的美工图。工程结构采用首页导航 + 分画面：首页放两个按钮切到【当前告警】和【历史告警】画面，每个子画面有返回首页按钮。另外配【当前告警说明】和【历史告警说明】两个纯说明画面。

4.2 功能实现

流程：新建工程 → 配置 Modbus 协议 → 建变量 + 配置画面控件 → 运行预览。核心在【工具】→【协议与变量设置】。

4.2.1 新建工程

菜单【文件】→【新建工程】，填工程名、路径、设备类型，确定。

4.2.2 配置 Modbus 主机

进入【工具】→【协议与变量设置】，协议类型设「Modbus 主机」，参数按 3.1 节。轮询周期 1 秒、轮询延时 100ms、应答超时 100ms 是默认，一般不用动。

4.2.3 画面与控件配置

首页放两个按钮（控件 ID:1），触控类型「切换画面」，目标画面分别指【当前告警】和【历史告警】。

首页按钮（控件 ID:1）属性里把触控类型设为「切换画面」、目标画面选【当前告警】，另一个同理。

4.2.4 当前告警画面

从机产生报警时，数据记录控件显示当前的告警和触发时间；报警解除后控件不再显示该条。配置步骤：

1. 画面加一个数据记录控件（控件 ID:1），把「记录类型」设为当前告警；
2. 在「告警解析」里设置各事件 ID 的数值、显示颜色、描述；
3. 针对每个事件 ID，加一条用途为「事件记录[触发]」的逻辑处理，执行条件设成该位 == 1。

记录类型下拉有四个选项：当前告警 / 历史告警 / 当前告警与解除 / 历史告警与解除，按需求选。

「告警解析」对话框三列：告警 ID（事件号）、颜色 ID、告警描述。本例建了离散输入类型变量「机组故障」，取它的前 4 个位分别映射为：压缩机故障、风机故障、烟感报警、过滤网堵塞。

每个事件 ID 对应一条「事件记录[触发]」逻辑。逻辑写法形如：事件记录[触发] / (事件ID, 1, 条件&数值, '压缩机故障' == 1)，即该位为 1 时触发一条告警记录。四个事件分别为压缩机故障(2)、风机故障(3)、烟感报警(4)、过滤网堵塞(5)——事件 ID 要和「告警解析」里填的数值对上。

4.2.5 历史告警画面

历史告警与当前告警配置几乎一样，唯一区别是记录类型选历史告警。不同点：报警解除后，历史告警的这条记录仍然留在表格里；如果在 Modbus 协议里开了存储设置，还能掉电保存，重新上电不丢。

4.2.6 运行预览

本例程屏作主机，用 Modbus Slave 软件模拟从机应答。运行虚拟屏，与 Modbus Slave 联机即可看到效果。具体操作参考大彩《【MODBUS】串口屏_应用文档_V1.0.pdf》。

5 下载工程

VisualTFT 编译成功后输出窗口会提示「编译成功」，再下到屏里，两种方式：

• USB 下载：点菜单【下载到设备】，用 USB 线把配置下进屏；
• SD 卡下载：菜单【工具】→【量产向导】→ 选「SD 卡下载」，把弹窗里所有文件拷到 SD 卡根目录，插屏后重新上电，烧录完取下 SD 卡。

6 工程实操要点（踩坑提示）

• 事件 ID 必须对齐：「告警解析」里填的 ID 数值，和「事件记录[触发]」逻辑里的事件 ID 是同一个东西，对不上屏上就不显示那条告警。这是最容易漏的点。
• 位映射要数清楚：本文「机组故障」是离散输入变量，前 4 个位（bit0~bit3）分别对应压缩机/风机/烟感/滤网。写逻辑时变量名要绑到具体的位，别整字节比。
• 历史告警要掉电保存，记得开存储：只在 Modbus 协议配置里开了「存储设置 = 存储指定变量」，且变量属性里勾了「是否储存」，历史告警断电后才不丢。两处都要设，只设一处不生效。
• 当前告警 vs 历史告警的语义：当前告警是「活的」——解除即消失；历史告警是「记账」——解除也留痕。选型时想清楚你要的是实时状态还是审计记录。
• 轮询周期别太狠：从机响应慢或总线设备多时，1 秒轮询 + 100ms 延时要酌情放大，否则会出现读到一半超时、报警跳变。

整理自广州大彩光电科技有限公司《MODBUS 教程_数据记录控件 V1.0》（www.gz-dc.com），版权归大彩所有。如需联机调试细节，参见大彩《【MODBUS】串口屏_应用文档_V1.0.pdf》。