开发手册

历史曲线把采样记录画成趋势线，也能把连续寄存器中的一组值画成曲线。

核心功能

• 最多同时显示 16 条曲线。
• 缩放、翻页、通道显隐和触摸读值。
• 平滑连线、区域填充及数据点标记。

下载海景版范例 · 全部工程与背景素材

1. 属性说明

位置、字体、触摸伴音、动态特效和操作权限统一见通用属性。下图展开本控件的专有设置，红色序号与表格对应。

1.1 曲线数据

序号	属性	作用
1	数据源	选择资料取样或连续地址；两种方式的绑定项不同。
2	资料取样索引	选择已启用的采样组。索引 0 对应第 1 组。
3	线性变换	启用数值换算：显示值＝原始值×缩放＋偏移。

1.2 连续地址

序号	属性	作用
2	数据点数	连续地址中每条曲线的数据点数量。
3	数据地址	连续数据的起始寄存器。
4	数据类型	与源数据类型一致；多字数据按类型占用连续地址。

1.3 数值换算

序号	属性	作用
5	线性变换	启用数值换算：显示值＝原始值×缩放＋偏移。
6	缩放	原始值相乘的系数。
7	偏移	缩放后再相加的数值。

1.4 曲线设置

序号	属性	作用
1	线条粗细	曲线线宽，选 1 或 2 像素。
2	通道数量	同时显示的曲线数量，1～16 条。
3	通道1颜色	设置通道1曲线的颜色。
4	通道2颜色	设置通道2曲线的颜色。
5	圆滑曲线	用平滑连线显示相邻数据点。
6	区域填充	设置曲线下方的填充强度；“无”只画线。
7	数据标记	在采样点绘制圆点或方格；“无”不显示。
8	控制地址	控件运行控制区的起始地址，偏移用途见下表。
9	隐藏控制	用控制地址的 bit0～bit15 分别隐藏通道 1～16；0 显示，1 隐藏。
10	翻页控制	允许通过控制区切换首页、尾页或相邻页。
11	时间戳定位	按控制区写入的时间戳定位记录日期。
12	时间宽度控制	允许通过寄存器调整一屏显示的点数。
13	Y轴范围控制	允许通过寄存器调整 Y 轴上下限。

16 通道设置

图中 3～18 分别设置通道 1～16 的颜色；19～27 对应上表的曲线样式和控制项，用法相同。

1.5 X 轴

序号	属性	作用
1	时间宽度	一屏显示的采样点数；与采样周期共同决定可见时长。
2	显示时间	选择 X 轴时间的显示格式。
3	刻度数	将坐标轴分成指定数量的刻度。
4	显示刻度	选择不显示、刻度线或分隔线。
5	方向	选择时间轴从左到右或从右到左。

1.6 Y 轴

序号	属性	作用
1	最大值	Y 轴显示范围上限。
2	最小值	Y 轴显示范围下限。
3	越界不显示	不绘制超出 Y 轴范围的数据点。
4	刻度数	将坐标轴分成指定数量的刻度。
5	显示数值	显示 Y 轴刻度值。
6	显示刻度	选择不显示、刻度线或分隔线。

1.7 外观

序号	属性	作用
1、2、3	字体与文字	见通用属性。
4	显示边框	显示控件外围边框。
5	边框颜色	设置外围边框颜色。
6	显示背景	启用控件背景填充。
7	背景颜色	设置内容区背景色。
8	分隔线颜色	设置坐标网格线的颜色。
9	显示滚动条	记录超过显示范围时，显示可拖动的滚动条。
10	位置	选择滚动条位于上方或下方。
11	递增触控范围	扩大滚动条的可触摸区域。
12	显示触控标记	触摸曲线时显示对应位置的时间和数值。

1.8 数据点标记

序号	属性	作用
6	数据标记	在采样点绘制圆点或方格；“无”不显示。
7	标记大小	设置采样点标记的尺寸。
8	标记颜色	设置采样点标记的颜色。

1.9 控制地址

以下以第 10 页的 LW5200 为起点。

地址	用途
LW5200	通道隐藏掩码，bit0～bit15 对应通道 1～16。
LW5201	翻页：1 上一页，2 下一页，3 首页，4 尾页。
LW5202	可翻页状态；bit1～bit4 对应上述动作。
LW5203～LW5204	UINT32 时间戳，按日期定位。
LW5205	一屏显示点数。
LW5206～LW5207	FLOAT：Y 轴最大值。
LW5208～LW5209	FLOAT：Y 轴最小值。

2. 应用

2.1 开始与停止

第 10 页使用索引 0，采集 LW3000、LW3001 两个 INT16 值。LW3100=1 继续采样，写 0 停止；停止后保留已有曲线。

2.2 X／Y 轴缩放

点击“X 放大／缩小”调整显示点数，“Y 放大／缩小”调整数值范围。“恢复视图”返回原范围。缩放不改变采样容量。

2.3 翻页与读值

第 11 页先停止采样，再查看最旧、较新和最新记录；触摸曲线可读取对应点。控制区从 LW5210 开始。

2.4 通道显隐

第 12 页配置 16 条曲线。向 LW5220 写 1 隐藏通道 1，写 2 隐藏通道 2；写 65535 全部隐藏，写 0 全部显示。

2.5 连续地址

第 20 页读取 LW6000 起的连续 UINT16 数据，切换正弦波和阶梯波可直接更新整组曲线。第 21～27 页提供其他数据类型。

2.6 显示样式

第 14～16 页分别对比折线与平滑、面积填充、圆点与方块。显示样式不改变源数据。

2.7 清空后重新采样

第 30～31 页共用 Flash 采样组。先停止，再清除记录，表格清空后重新开始；返回曲线页查看本轮数据。实体屏的断电恢复需按第 32 页步骤验证。

---

海景：Filitheyo bar.jpg，作者见来源页，Public domain。已裁切并调整明暗，改编图片沿用原许可。