Schneider Electric EcoStruxure Machine Expert ユーザーガイド

EIO0000004319.02

www.se.com

SQL Gateway

EIO0000002417 04/2020

EcoStruxure Machine Expert

一般库

用户指南

08/2023

EIO0000004319.02 08/20232

1 EcoStruxure Machine Expert - 数据记录功能

DataLogging 库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第I部分

2 EcoStruxure Machine Expert - FileFormatUtility

库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第II部分

3 EcoStruxure Machine Expert - PackML

库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第III部分

4 EcoStruxure Machine Expert - PD_ETest

库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第IV部分

5 EcoStruxure Machine Expert - 获取和设置实时时钟

SysTimeRtc 和 SysTimeCore - 库指南. . . . . . . . . . . . . . . . . . . . . . . 第V部分

库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第VI部分

8 EcoStruxure Machine Expert - Twido 仿真支持库

库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第VII部分

6 EcoStruxure Machine Expert - 通用功能 Toolbox

7 EcoStruxure Machine Expert - 管理循环任务间隔

Toolbox_Advance - 库指南. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

第VIII部分

EIO0000002943.00

www.se.com

EcoStruxure Machine Expert

EIO0000002943 06/2019

EcoStruxure Machine Expert

数据记录功能

DataLogging 库指南

06/2019

2EIO0000002943 06/2019

本文档中提供的信息包含有关此处所涉及产品之性能的一般说明和/或技术特性。本文档并非用于

(也不代替) 确定这些产品对于特定用户应用场合的适用性或可靠性。任何此类用户或设备集成商

都有责任就相关特定应用场合或使用方面对产品执行适当且完整的风险分析、评估和测试。

Schneider Electric 或其任何附属机构或子公司对于误用此处包含的信息而产生的后果概不负责。

如果您有关于改进或更正此出版物的任何建议、或者从中发现错误、请通知我们。

本手册可用于法律所界定的个人以及非商业用途。在未获得施耐德电气书面授权的情况下，不得

翻印传播本手册全部或部分相关内容、亦不可建立任何有关本手册或其内容的超文本链接。施耐

德电气不对个人和非商业机构进行非独占许可以外的授权或许可。请遵照本手册或其内容原义并

自负风险。与此有关的所有其他权利均由施耐德电气保留。

在安装和使用本产品时，必须遵守国家、地区和当地的所有相关的安全法规。出于安全方面的考

虑和为了帮助确保符合归档的系统数据，只允许制造商对各个组件进行维修。

当设备用于具有技术安全要求的应用场合时，必须遵守有关的使用说明。

未能使用施耐德电气软件或认可的软件配合我们的硬件，则可能导致人身伤害、设备损坏或不正

确的运行结果。

不遵守此信息可能导致人身伤害或设备损坏。

EIO0000002943 06/2019 3

安全信息 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

关于本书 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

第1章数据记录 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

数据记录简介 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

配置数据日志 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

管理数据日志文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

附加数据日志文件信息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

添加 LogRecord 和 Dump 功能块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

构建宽 WSTRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

附录 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

附录 A 功能和功能块表示形式 . . . . . . . . . . . . . . . . . . . . . . . . . . 25

功能与功能块的区别 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

如何通过 IL 语言使用功能或功能块 . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

如何通过 ST 语言使用功能或功能块 . . . . . . . . . . . . . . . . . . . . . . . . . . 30

术语表 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

4EIO0000002943 06/2019

EIO0000002943 06/2019 5

安全信息

重要信息

声明

在试图安装、操作、维修或维护设备之前，请仔细阅读下述说明并通过查看来熟悉设备。下述特

定信息可能会在本文其他地方或设备上出现，提示用户潜在的危险，或者提醒注意有关阐明或简

化某一过程的信息。

6EIO0000002943 06/2019

请注意

电气设备的安装、操作、维修和维护工作仅限于有资质的人员执行。施耐德电气不承担由于使用

本资料所引起的任何后果。

有资质的人员是指掌握与电气设备的制造和操作及其安装相关的技能和知识的人员，他们经过安

全培训能够发现和避免相关的危险。

人员资质

具备资质的人员是指具有以下资质的人员：

拥有与电气设备和系统的构造和操作相关的技能和知识。

拥有与在软件实施中提供机器功能相关的知识。

接受过安全相关培训，能够识别并避免相关风险。

具备资质的人员必须能够发现因设置参数和修改参数值所引起的、通常来自机械、电气或电子设

备的可能危险。具备资质的人员必须熟悉旨在预防工业事故的各种标准、条例和规定，并且在设

计和建造系统时必须加以遵守。

正确用途

此产品是结合控制系统和伺服放大器使用的库，仅用于本文档中描述的工业领域用途。

总是遵守适用的安全相关说明、指定条件和技术数据。

在使用本产品前，针对具体的用途执行风险评估。根据评估结果采取保护措施。

本产品是整个系统的组成部分，因此必须按照整个系统的设计（比如，机器设计）确保工作人员

的安全。

不可用于任何其他用途，否则可能有危险。

EIO0000002943 06/2019 7

关于本书

概览

文档范围

本指南介绍支持文件管理操作的控制器的数据记录功能。

有效性说明

本文档已随 EcoStruxureTM Machine Expert V1.1 的发布进行了更新。

关于产品的资讯

1 有关详细信息，请参阅 NEMA ICS 1.1（最新版）中的“安全指导原则 - 固态控制器的应用、安

装和维护”以及 NEMA ICS 7.1（最新版）中的“结构安全标准及可调速驱动系统的选择、安装与

操作指南”或您特定地区的类似规定。

在试图使用库中常见的 POU 为特定应用提供解决方案（机器或工艺）前，必须考虑、执行和完成

最佳行为准则。这些行为准则包括但不限于与此库相关的风险分析、功能安全、组件兼容性、测

试和系统验证。

警告

失去控制

任何控制方案的设计者都必须考虑到控制路径可能出现故障的情况，并为某些关键控制功能

提供一种方法，使其在出现路径故障时以及出现路径故障后恢复至安全状态。这些关键控制

功能包括紧急停止、越程停止、断电重启以及类似的安全措施。

对于关键控制功能，必须提供单独或冗余的控制路径。

系统控制路径可包括通讯链路。必须对暗含的无法预料的传输延迟或链路失效问题加以考虑。

遵守所有事故预防规定和当地的安全指南。1

为了保证正确运行，在投入使用前，必须对设备的每次执行情况分别进行全面测试。

不遵循上述说明可能导致人员伤亡或设备损坏。

8EIO0000002943 06/2019

摘自标准的术语

本手册中的或者出现在产品自身中/上的技术术语、术语、符号和相应描述基本上均源自国际标准

的条款或定义。

在功能安全系统、驱动器和一般自动化领域，这可能包括但不限于

安全

、

安全功能

、

安全状态

、

故障

、

故障复位

、

失灵

、

失效

、

错误

、

错误消息

、

危险

等词语。

这些标准包括：

警告

程序组织单元使用不当

针对用途和安装的设备执行安全相关分析。

确保程序组织单元 (POU) 兼容系统中的设备，不会对系统的正常功能产生意外影响。

使用正确的参数特别是限值，并遵守机器磨损和停止行为。

验证传感器和执行器与选定的 POU 兼容。

在验证和试运行期间，充分测试所有功能在所有操作模式下的工作情况。

根据安全相关分析、各自规则和规定为关键控制功能（急停、超出限值的条件等）提供独立

的方法

不遵循上述说明可能导致人员伤亡或设备损坏。

标准描述

IEC 61131-2:2007 编程控制器，第 2 部分：设备要求和测试。

ISO 13849-1:2015 机器安全：控制系统的安全相关部分。

设计通则。

EN 61496-1:2013 机械安全：电子感应式防护设备。

第 1 部分：一般要求和测试。

ISO 12100:2010 机械安全 - 设计的一般原则 - 风险评估和风险抑制

EN 60204-1:2006 机械安全 - 电气机械设备 - 第 1 部分：一般要求

ISO 14119:2013 机械安全 - 与防护设备关联的联锁设备 - 设计和选择原则

ISO 13850:2015 机械安全 - 紧急停止 - 设计原则

IEC 62061:2015 机械安全 - 安全相关的电气、电子和可编程电子控制系统的功能性安全

IEC 61508-1:2010 电气/电子/可编程电子安全相关系统的功能性安全：一般要求。

IEC 61508-2:2010 电气/电子/可编程电子安全相关系统的功能性安全：电气/电子/可编程电子

安全相关系统的要求。

IEC 61508-3:2010 电气/电子/可编程电子安全相关系统的功能性安全：软件要求。

IEC 61784-3:2016 工业通信网络 - 配置 - 第 3 部分：功能安全现场总线 - 一般规则和配置定义

2006/42/EC 机械指令

2014/30/EU 电磁兼容性规程

2014/35/EU 低电压规程

EIO0000002943 06/2019 9

此外，本文中所用的名词可能是被无意中使用，因为它们是从其他标准中衍生出来的，如：

最后，

操作区

一词可结合特定危险的描述一起使用，其定义相当于

机器指令

(

) 和 :2010

中的

2006/42/EC

风险区

ISO 12100

或

危险区

。

注意：对于当前文档中引用的特定产品，上述标准可能适用，也可能不适用。若要了解与适用于

此处所述产品的各项标准有关的更多信息，请参阅这些产品参考的特性表。

标准描述

IEC 60034 系列旋转电机

IEC 61800 系列可调速电力驱动系统

IEC 61158 系列用于测量和控制的数字数据通讯：用于工业控制系统的现场总线

10 EIO0000002943 06/2019

EIO0000002943 06/2019 11

EcoStruxure Machine Expert

数据记录

EIO0000002943 06/2019

数据记录

第1章

数据记录

简介

本文档介绍支持文件管理操作的控制器的数据记录功能。

数据日志是一种由用户定义的字符串组成的文本文件，包含某过程或机器的应用程序数据信息。

数据日志文件存储在控制器中。您可以上载该文件，并用标准文本编辑器打开。信息包括嵌入式

变量值及其相关文本。时间和日期戳是附加选项。

本章包含了哪些内容？

本章包含了以下主题：

主题页

数据记录简介 12

配置数据日志 14

管理数据日志文件 16

附加数据日志文件信息 20

添加 LogRecord 和 Dump 功能块 21

构建宽 WSTRING 22

数据记录

12 EIO0000002943 06/2019

数据记录简介

概述

通过检查数据日志文件 (.log)，可以监控和分析应用程序数据。

此图显示包含 2 个功能块 LogRecord 和 Dump 的应用程序。LogRecord 功能块将数据写入缓冲器，

缓冲器会将数据转储到位于控制器存储器中的数据日志文件 (.log)。当缓冲器使用了整个容量的

80% 时，会自动进行缓冲器转储，也可以通过 Dump 功能强制执行缓冲器转储。作为标准 FTP 客

户端，PC 可以在控制器充当 FTP 服务器时访问此数据日志文件。还可以通过 EcoStruxure

Machine Expert 或控制器的 Web 服务器上载该文件。

注意：只有具备文件管理功能的控制器才能支持数据记录。请参阅您的控制器编程手册以了解其

是否支持文件管理。软件本身不会评估控制器对数据记录活动的兼容性。

FB

㖍⽿存⻽

FB

弔⁐

㖍⽿㔯ẞ

䘬亻熚⋢

㔘㌖㖍⽿ x

㔘㌖㖍⽿ y

㔘㌖㖍⽿ z

㕘

㔘㌖㖍⽿

LogFile.log

㔘㌖㖍⽿ 1

㔘㌖㖍⽿ 2

㔘㌖㖍⽿ 3

㔘㌖㖍⽿ 4

㔘㌖㖍⽿ 5

㔘㌖㖍⽿ 6

…

冒肓

弔⁐

犣⇞亻熚⋢弔⁐

㍏⇞☐ 䘬

⸼䓐䦳⸷ ㍏⇞☐ 䘬

⬀⁐☐

㔯ẞᶲ弥冒 SoMachine,

㍏⇞☐ 䘬 Web 㚵肒☐

ㆾ FTP ⭊舻䪗実㯪

㖍⽿㔯ẞ

弔⁐

␥Ẍ

数据记录

EIO0000002943 06/2019 13

数据日志文件 (.log) 样本

Entries in File:8; Last Entry: 8;

18/06/2009;14:12:33;cycle: 1182;

18/06/2009;14:12:35;cycle: 1292;

18/06/2009;14:12:38;cycle: 1450;

18/06/2009;14:12:40;cycle: 1514;

18/06/2009;14:12:41;cycle: 1585;

18/06/2009;14:12:43;cycle: 1656;

18/06/2009;14:14:20;cycle: 6346;

18/06/2009;14:14:26;cycle: 6636;

实现过程

首先在应用程序中声明并配置数据日志文件，然后开始编写程序。

数据记录

14 EIO0000002943 06/2019

配置数据日志

添加 Data Log Manager

在配置数据记录前，向配置中添加 data log manager：

配置屏幕

此配置屏幕在您向配置中添加数据日志文件后出现：

步骤操作

1在工具树中，选择应用程序节点，单击绿色的加号并选择添加其他对象 → DataLogManager...。

结果：显示 Add Data Log Manager 对话框。

2在 Add Data Log Manager 对话框中，单击添加。

结果：DataLogManager 节点将显示在应用程序节点下。

3选择 DataLogManager 节点，单击绿色加号，然后选择数据日志...。

结果：显示 Add DataLog 对话框。

4在 Data Logging File Name 文本框中，输入数据日志文件的名称，然后单击添加。

结果：具有给定名称的数据日志文件显示在 DataLogManager 节点下，并且在 EcoStruxure

Machine Expert Logic Builder 屏幕中间的编辑器视图中打开配置屏幕。

注意：以后无法更改数据日志文件名。

5 设置数据日志文件参数 (参见第

14

页)。

6 重复第 3 步到第 5 步，创建更多数据日志文件。

数据记录

EIO0000002943 06/2019 15

配置参数

参数描述

Add Date 这些选项可分别为每个记录打印日期或时间。例如，与 2009 年 6 月 10 日下午 2:30

相关的实例可能会表示为 10/06/2009、06/10/2009 或 20090610 的 14:30 或

02:30:00 pm 等。

Add Time

Max number of entries 此选项可设置数据日志文件中包含的最大记录数。有效值为 10 到 65536。（缺省值

为 10000。）

Mode Circular（缺省

值）

当达到 Max number of entries 时，新记录将覆盖旧记录。数据

日志文件的第一行可用于获取上一个记录的实际位置以及其他记

录的排列。以下情况基于一个最多包含 10 个记录的文件：

情况 1：Entries in File: 8; Last Entry: 8

含义：文件中的条目数等于 Last Entry 的值。记录从 N°1

（最旧）到 N°8（最新）排列。

情况·2：Entries in File: 10; Last Entry: 5

含义：文件中的条目数大于 Last Entry 的值。文件已满，新

记录会替换文件中最旧的记录。10 条记录按以下顺序排列

（从最旧到最新）：6、7、8、9、10、1、2、3、4、5

Stop when full 当达到 Max number of entries 时，新记录尝试返回一条检测到

错误的消息。

Internal Buffer Size 配置用于存储添加的记录的 RAM 缓冲区大小。有效值为 1 到 Max number of entries

中配置的值。（缺省值为 10。）

Max characters per entry

(optimization)

设置每个条目的最大长度。有效值为 10 到 255。（缺省值为 64。）

最大长度包括分隔符以及可选日期和时间。每行末会添加额外空间，用于容纳已定

义字符数。

Separator between date, time

and record

定义要在数据日志中不同字段之间插入的字符。在记录后会添加一个额外分隔符。

注：对于每个已配置的数据日志文件，有一个与此数据日志文件同名的 LogRecord 功能块实例，用于处理所有内部数

据，并实现数据记录管理。

数据记录

16 EIO0000002943 06/2019

管理数据日志文件

简介

LogRecord 功能块用来将文本字符串条目写入数据日志文件。此功能块将输入字符串存储在内部缓

冲器中。当此缓冲器达到 80 % 的容量时，便会转移到控制器上的实际文件。可使用 Dump 功能块

来强制实施此保存机制。

关闭电源时，您可能会丢失内部缓冲区中的数据，或增加循环时间，直至缓冲区清空。

用 LogRecord 功能块添加记录

此功能块可用于将 UNICODE 字符串记录在特定日志中：

输入参数

注意

数据丢失

所有内部缓冲区信息移动到实际文件系统前，请勿拔除控制器的电源。

如果正在记录的数据对您的应用程序很重要，请将内部缓冲区大小配置为 1。

不遵循上述说明可能导致设备损坏。

参数类型注释

xExecute BOOL 此功能在此输入的上升沿上执行。

注：当 xExecute 在冷复位或热复位后的第一个运行模式任务循环中设置为 TRUE

时，不会检测到上升沿。

wsRecord WSTRING 此用户指定的 UNICODE 文本字符串会写入到数据日志文件中。

注意：当将数据日志管理器添加到应用程序中时，WSTRING (参见第

22

页) 类

型在自动插入的 Standard64.lib 库中可用。

数据记录

EIO0000002943 06/2019 17

输出参数

注意：如果记录超出配置的长度，则会被截断。

只要 xExecute 为 TRUE，xDone 和 xError 输出就会保持为 TRUE。如果 xExecute 在 xDone 或

xError 设置为 TRUE 之前（xBusy 仍为 TRUE）设置为 FALSE，则当功能块在一个控制器循环内

完成时，其中一个输出会设置为 TRUE，从而使应用程序可检测到这一结束：

1 Ex 为 FALSE 时的一个循环。

LogRecord 功能块包含与每个已配置数据日志文件相对应的实例。

注意：无需显式声明该功能块的实例，因为会自动声明该实例。如果显式声明该功能块的实例，

则会显示一条消息（2 次变量声明），且功能块不工作。

将该功能块添加到您的 POU 并使用输入帮助指定相应的数据日志文件实例（请参见添加

LogRecord (参见第

21

页)）。

参数类型注释

xDone BOOL 当记录在未出现错误消息的情况下成功保存到内部缓冲区时，此输出设置为

TRUE。

xBusy BOOL 当 LogRecord 繁忙时，此输出保持为 TRUE（直至到缓冲区的传输完成）。

xError BOOL 当发生错误时（如内部缓冲区已满），此输出设置为 TRUE。

eError ERROR 当 xError 为 TRUE 时，此输出包含错误代码：

NO_ERROR

INIT_ERROR

DUMP_ERROR

BUFFER_FULL_ERROR

FILE_FULL_ERROR

DUMP_INCOMPLETED

INPUT_ERROR

FILE_OPEN_ERROR

FILE_SETPOINTER_ERROR

FILE_WRITE_ERROR

FILE_CLOSE_ERROR

1

数据记录

18 EIO0000002943 06/2019

用 Dump 方法强制保存

您可以使用 Dump 方法（此方法可视为功能块的子功能，本例中可视为 LogRecord 功能块的子功

能）强制应用程序数据将存储在内部缓冲区的记录移到控制器文件系统中的实际文件：

参数

请参阅添加 Dump 方法 (参见第

21

页)了解 Dump 方法的实现。

输入类型注释

xExecute BOOL 保存功能在此输入的上升沿上执行。

注意：当 xExecute 在第一个控制器任务循环中设置为 1 时，不会检测上升沿。

输出类型注释

xDone BOOL 当记录在未出现错误消息的情况下成功保存时，此输出设置为 TRUE。

xBusy BOOL 当 TRUE 繁忙时，此输出保持为 Dump（直至文件完全写入）。

xError BOOL 当检测到错误时（如数据日志文件已满），此输出设置为 TRUE。

eError ERROR 当 xError 为 TRUE 时，此输出包含错误代码：

NO_ERROR

INIT_ERROR

DUMP_ERROR

BUFFER_FULL_ERROR

FILE_FULL_ERROR

DUMP_INCOMPLETED

INPUT_ERROR

FILE_OPEN_ERROR

FILE_SETPOINTER_ERROR

FILE_WRITE_ERROR

FILE_CLOSE_ERROR

ページが読み込まれています...

Schneider Electric EcoStruxure Machine Expert ユーザーガイド

このマニュアルも適しています

Schneider Electric EcoStruxure Machine Expert ユーザーガイド

関連論文

その他のドキュメント