4.2 历史曲线

版本	内容摘要	日期
v1.0	初次发布	2026/6/13

什么是历史曲线控件？

历史曲线控件是一种用于记录、存储、可视化记录“变量随时间变化趋势”的高级图形组件。支持对 PLC 或内部寄存器数据进行长期采集，并以多通道曲线形式呈现，广泛应用于监控、能效评估等场景。

核心功能如下：

最大支持 16 个独立通道，可同时绘制 16 条不同变量的趋势线；
掉电数据持久化：采样数据自动保存至 Flash，断电不丢失；
数据管理功能：支持 翻页浏览、缩放查看（时间轴/数值轴）、手动清除、CSV 导出；

两种核心采样模式

1. 资料采样

定义：对单个寄存器在不同时间点的数值进行周期性采集，形成一条时间序列曲线。 用途：观察某一参数的历史变化趋势。

2. 连续采样

定义：在同一时刻，读取连续 N 个寄存器的值，并将这 N 个值作为“一组”数据绘制到同一条曲线上。 用途：展示空间分布或批量数据快照。

例程下载链接

https://help.simtutai.cn/docs/xia-zai-lian-jie

1.属性说明

1.1.曲线数据

历史曲线控件的曲线数据的来源：可以选择“资料采集”、“连续地址”，属性如下所示：

1.资料采样

• 资料采集：采集同一寄存器的数据，将不同时刻的数据绘制在同一曲线上，资料采集详细说明，参考 https://help.simtutai.cn/docs/4-1-zi-liao-qu-yang
• 连续地址：采集同一时刻连续寄存器的数据，并将数据绘制在同一曲线上，属性下所示：
  • 数据点数：采集连续寄存器的个数。范围1~40000；
  • 数据地址：采集连续寄存器的起始地址；
  • 数据类型：支持UINT16、INT16、UINT32、INT32、UINT64、INT64、FLOAT、DOUBLE；
  • 数值转换：实际的数据 = 传输的数据 * 缩放 + 偏移；
    

1.2.曲线设置

历史曲线控件的曲线设置属性如下所示：

1.曲线粗细：支持1像素、2个像素；
2.曲线通道：最大支持16条曲线

• 通道颜色：设备每个通道的颜色

3.控制地址：填入控制通道的寄存器地址

• Addr+0：通道显示隐藏，设置隐藏/ 显示每一个通道的曲线，bit0_{bit15对应通道1}通道15，为0显示，为1隐藏，默认显示；

• Addr+1：翻页控制，设置历史曲线的翻页，Addr+1：。1-上一页（曲线移动方向）；2-下一页；3-首页（最新数据）；4-尾页（最旧数据）；

• Addr+2：读取翻页操作是否可行，BIT1表示 “上一页”、BIT2表示“下一页”、BIT3表示“首页”、“BIT4”表示尾页。若该位为1，表示翻页可以执行；若该位为0，表示翻页操作不可以执行；

• Addr+3~Addr+4：时间戳定位，UINT32，时间戳定位，可以搭配下拉菜单关联，当下拉选择对应的时间，滚动条会自动定位到对应的时间节点。精度，天为单位；

• Addr+5：时间宽度控制，X轴上，表示一屏显示的点数。如控件的大小宽度400，时间宽度控制为100，那么400/100，即4个像素显示描绘一个点，如果采集了101个点，则会显示滚动条，可拖动查看。

1.3.X轴（时间）

X轴方向相关的设置，属性如下所示

1. 时间宽度：一页的显示的采样点数，如100，添加到第101个数据，满屏。曲线会从左往右移动；
2. 刻度数：X轴的刻度数；范围：2~10，一个刻度对应一个时间显示；
3. 显示刻度：可设置无、分割线或刻度线；

1.4.Y轴（值）

Y轴方向相关的设置，属性如下所示：

1. 最大值：Y轴上的最大值，可以在LUA脚本动态修改，调用wgt_set_param(...) API实现；
2. 最小值：Y轴上的最小值，可以在LUA脚本动态修改，调用wgt_set_param(...) API实现；
3. 越界不显示：√或不选，当值大于最大值或最小值，该店参数可以不显示
4. 刻度数：2~11
5. 显示数值：显示Y轴刻度上的值
6. 显示刻度：可设置无、分割线或刻度线

1.5.外观设置

历史曲线控的外观属性如下所示：

1. 字体：字库选择
2. 字体大小：字号设置
3. 文字颜色：字体颜色设置
4. 显示边框：可设置曲线外围边框颜色
5. 显示背景：可设置透明不显示或纯色背景
6. 分割线颜色：若X、Y设置了显示刻度，可设置分割线的颜色
7. 显示滚动条：√，当采样点数大于“时间宽度”，可显示滚动条拖动查看数据
8. 显示触摸标识：√，勾选上，当用户触摸曲线控件，对应位置显示采样时间和值

2.应用

2.1.历史曲线-资料采样

2.1.1.资料采样配置

资料采集配置，如下所示：

1. 描述信息：历史曲线；
2. 采样模式：定时采样
3. 记录条数：2000；
4. 采样周期：100；
5. 采样单位：毫秒；
6. 数据地址：LW1010
7. 数据类型：UINT16
8. 数据个数：3
9. 控制地址：LW1001
10. 导出标题：
11. 采样控制地址：√
12. 控制地址：LW1000
13. 启动模式OFF→ON

2.1.2.历史曲线-控件配置

历史曲线控件配置如下所示：

1 数据来源：资料采集，资料取样索引为“[0]历史数据”

2 通道数：为3。（资料采集→数据个数→3）

3 控制地址：0x1003，UINT16类型

• 隐藏控制：√，地址为0x1003，UINT16类型
• 翻页控制：√，地址为0x1004，UINT16类型
• 允许翻页：地址为0x1005，UINT16，只读
• 时间戳定位：√，地址为0x1006，UINT32类型
• 时间宽度：√，地址为0x1008

4 显示滚动条：√

5 显示触摸标识：√，点击曲线控件，将显示对应点的时间、参数值

2.1.3.历史曲线-采样使能配置

添加2个位状态指示灯控件，关联LW1000地址，和资料采集配置的“采样控制地址：LW1000对应，配置如下所示：

1. 读取地址：LW1000
2. 切换开关：√
3. 开关类型：设为ON（开始采集）/ 设为OFF(停止采集)

运行预览

2.1.4.历史曲线-清除记录

添加一个字状态按钮，关联LW1001地址，和资料采集配置的“控制地址LW1001”对应，配置如下所示：

1. 写入地址：LW1001

2. 操作模式：写入常量
   常量值：85

   

运行预览

2.1.5.历史曲线-通道显示隐藏

添加3个位状态按钮，关联LW1003.0、LW1003.1、LW1003.2地址，和历史曲线控件配置的控制地址 LW1003对应，配置如下所示：

1. 读取地址：LW1003.0/LW1003.1/LW1003.2
2. 切换开关：√
3. 开关类型：切换开关

运行预览

2.1.6.历史曲线控件-通道翻页控制

添加4个字按钮控件，均关联LW1004地址，和曲线控件配置的“翻页控制 0x1004”对应，配置如下所示

1. 写入地址：LW1004
2. 操作模式：写入常量
   • 常量值：1/2/3/4
3. 控制权限：√。显示隐藏，表示还有下一页、上一页操作
   • 条件控制：LW1005.1/LW1005.2
   • 比较：==
   • 值：1

运行预览

2.1.7.历史曲线控件-X轴缩放

添加一个数值控件，关联地址LW1008，和曲线控件配置的“时间宽度”的地址对应，配置如下所示：

1. 启用输入：√
2. 读取地址：LW1008
   

效果预览

2.1.8.历史曲线控件-Y轴缩放

添加两个数值控件，关联地址LW1009和LW10B0，和曲线控件配置的“Y轴范围”的地址对应，配置如下所示：

1. 启用输入：√
2. 读取地址：LW1009
   

效果预览

2.2.历史曲线-连续采样

2.2.1.工程配置

历史曲线控件配置如下所示：

1. 数据来源：连续采样
2. 数据点数：为50。
3. 数据地址：0x4000
4. 数据类型：UINT16类型
5. 通道数量：2

通道1 LW4000 LW4002 LW4004 ...... LW405E LW4060 LW4062
通道2 LW4001 LW4003 LW4005 ...... LW405F LW4061 LW4063