DataLogCreate：创建数据日志 (S7-1200, S7-1500) 说明 通过指令“DataLogCreate”，可以创建一个数据记录。 数据记录保存在存储卡或内部装载存储器的“\DataLogs”目录中。数据日志中可存储的数据量 取决于存储卡上的可用空间，或所用 CPU 内部装载存储器中的存储空间。对于 S7-1200 CPU， 生成的 CSV 文件的Zui大大小为 500,000,000 字节；而 S7-1500 CPU 为 1,000,000,000 字节。 在参数 RECORDS 中，可指定数据日志中所存储数据记录的Zui大数目。如果达到了数据日志 中数据记录指定的Zui大数目，则覆盖Zui早的数据记录。要避免覆盖现有数据记录，可以使用 “DataLogNewFile (页 3325)”指令。达到参数 RECORDS 中指定的数量时，可通过该指令创建 一个相同结构的新数据日志（“DataLogWrite (页 3318)”指令中，参数 STATUS 的返回值为 1）。之后数据记录将保存在新的数据记录中。 在参数 NAME 中，可指定数据日志的名称。创建的数据日志将保存为 CSV（逗号分隔的值） 格式。通过参数 HEADER，可创建数据日志的标头（可选）。 创建数据记录后，将自动打开该文件。这表示可写入数据。可按以下方式将数据记录文件复制到 PC 中： • 如果 PROFINET 接口连接到 PC，则使用 Web 浏览器通过 Web 服务器来访问数据记录。要 执行此操作，CPU 可处于 RUN 模式或 STOP 模式。如果 CPU 处于“RUN”模式，程序将在 Web 服务器进行数据传送期间继续运行。 • 如果 CPU 上装有存储卡，则可以移除该卡并将其插入到 PG/PC 上的 SD（安全数字）卡或 MMC（多媒体卡）标准插槽中。可以通过文件管理器将数据记录文件从存储卡传送到 PC 中。移除存储卡时，CUP 将转至“STOP”模式。 说明 存储卡的使用寿命 存储卡的使用寿命有限。更多信息，请参见“AUTOHOTSPOT” 数据记录的属性 将根据环形缓冲区的原理执行数据记录的数据记录写操作。在达到Zui大数据记录数（RECORD 参数）之前，将一直添加新数据记录。下一条数据记录将覆盖数据记录中“Zui旧”的数据记 录。 如果要防止覆盖数据记录，则可使用“DataLogNewFile (页 3325)”指令根据当前数据记录来 创建一个新的数据记录文件。然后将新的数据记录写入到新的数据记录中。创建数据记录 使用“DataLogCreate (页 3303)”指令，可在装载存储器的“"\DataLogs”目录下创建一个新的 数据记录文件。 • 数据记录的名称在 NAME 参数中指定，该名称也可用作 CSV 文件的文件名。文件存储在 目录“DataLogs”中。 • 块参数 DATA 可确定新数据记录对象的数据缓冲区以及数据日志的列和数据类型。数据日 志中数据记录的列和数据类型，取决于该数据缓冲区中结构声明的元素或数组声明的元 素。一个结构或数组中的每个元素都对应于数据记录某行中的一列。 • 使用 HEADER 块参数可指定各个列的列标题文本。 • “DataLogCreate (页 3303)”指令将返回一个 ID。其它数据记录指令将通过该 ID 对已创建 数据记录进行引用。 打开数据记录 使用指令“DataLogOpen”（S7-1200 和 S7-1500），可以打开存储卡上的现有数据记录。必 须先打开一个数据记录，才能写入新的数据记录。 执行“DataLogCreate (页 3303)”和“DataLogNewFile (页 3325)”指令时，将自动打开数据 记录。 Zui多可同时打开 10 个数据记录。可通过数据日志的 ID 或名称，选择需打开的数据日志。 • 如果在 ID 和 NAME 参数中分别指定了数据记录的 ID 和名称，则将根据 ID 标识数据记录， 而不会再比较数据记录的名称。 • 如果使用参数 NAME 选择数据日志并将 0 指定为 ID，则在打开数据日志时，将在 ID 参 数中显示该数据日志的 ID。 • 如果使用 ID 参数选择了数据记录而未指定名称，在打开数据记录时名称将显示在 NAME 参数中。 可以使用 MODE 参数指定在打开时是否删除数据记录中的数据记录。 可对 DataLogOpen (S7-1500) 运行一致性检查。

             写入数据记录 数据记录写入数据记录前，必须打开数据记录（“DataLogOpen (页 3311)”指令）。 “DataLogWrite (页 3318)”指令将数据记录写入数据记录。 说明 更改数据记录文件的内容 由于数据记录文件巨大 (500,000 KB)，这些文件的内容无法在接通期间或执行“DataLogWrite” 之前进行检查。用户不得在 CPU 外更改内容，这样会造成文件损坏。 关闭数据记录 使用“DataLogClose (页 3321)”指令可关闭和打开数据日志。使用 ID 参数，选择数据记录。 当 CPU 切换到 STOP 及重新启动时，将自动关闭该数据记录。 删除数据记录 使用“DataLogDelete (页 3323)”指令 (S7-1500)，可以删除存储卡上的数据记录文件。仅当 通过指令“DataLogCreate (页 3303)”创建数据记录的情况下才能删除该日志及其所含数据 记录。 使用 NAME 和 ID 参数选择要删除的数据记录。首先，对 ID 参数求值。如果存在相关 ID 的 数据记录，则将不会再判断 NAME 参数。如果 ID 参数中使用值“0”，则 NAME 参数中必须 使用数据类型为 STRING 的值。 说明 删除存储卡中的数据日志 通过 PC 读卡器，可以复制存储卡中的数据日志，但无法对其进行更改或删除。 除数据记录指令之外，还建议通过 Web 服务器显示、下载（复制）和删除数据日志。 在文件浏览器中调用存储卡中的文件系统时，可能会导致数据日志及其它系统文件的意外删 除或更改，造成文件损坏或存储卡不可用。在 PLC 外更改存储卡中的数据记录，将导致 PLC 的开机时间延长。 清空数据记录 使用“DataLogClear (页 3316)”指令 (S7-1500)，可以删除现有数据记录中的所有数据记录。 该指令不会删除 CSV 文件的可选标题（请参见指令“DataLogCreate (页 3303)”的 HEADER 参数说明）。新建数据记录文件 使用指令“DataLogNewFile (页 3325)”(S7-1200) 或“DataLogTypedNewFile (页 3327)”(S7-1500)，可以创建一个与现有数据记录具有相同属性的新数据记录。这样，即 可保留现有数据日志的内容。 调用时，该指令将在存储卡中或内部装载存储器中创建一个新的数据记录，日志名称在 NAME 参数中已定义。ID 参数用于指定旧数据记录的 ID，该数据记录的属性将应用于新的数据记录。 随后，新数据记录的 ID 将通过 ID 参数输出。 通过该指令的 RECORDS 参数，可以指定新数据记录的文件大小。 对于“DataLogTypedNewFile (页 3327)”(S7-1500)，可运行一致性检查。下表列出了“DataLogCreate”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500，T 和 C 只能在 LAD 和 FBD 中使用） 执行指令 在参数 REQ 的上升沿处创建一个数据记录。 RECORDS Input UDInt I、Q、M、L、D 或 常量 数据记录中的数据记录的Zui大数量 如果由“DataLogWrite (页3318)”指令写入的 记录数量大于该参数中指定的记录数，则覆盖 Zui早的记录。 FORMAT Input UInt I、Q、M、L、D 或 常量 数据格式： • 0：内部（不支持） • 1：CSV (Comma separated values) TIMESTAMP Input UInt I、Q、M、L、D 或 常量 时间戳；详细信息，请见下文 如果激活时间戳时，则系统将自动添加标题中 的其它列。 NAME Input VARIANT L、D 数据记录的名称 指定的名称也将作为 csv 文件的文件名。 在 S7-1200 CPU 中，数据日志名称具有以下限 制： • 名字长度不得超过 35 个字符。 • 支持 0x20 和 0x7E 范围内的所有 ASCII 字 符，但 \ ' / " : ; [ ] | = . * ? < > 除外 在 S7-1500 CPU 中，数据日志名称具有以下限 制： • 名字长度不得超过 55 个字符。 • 支持以下字符：0 ... 9, a ... z, A ... Z 以及 - 和 _ ID InOut DWORD I、Q、M、L、D 数据记录的对象 ID（仅用于输出） 在后续数据记录指令寻址所创建的数据记录 时，需要使用该数据记录 ID。数据记录的标题（可选） 在添加指令后，将隐藏该参数。 该标题将写在 CSV 文件的第一行。 DATA InOut VARIANT D 执行指令“DataLogWrite (页3318)”时，指向 作为数据记录写入数据结构的指针。 DONE Output BOOL I、Q、M、L、D 状态参数： • 0：处理操作尚未完成。 • 1：指令的处理操作成功完成。 BUSY Output BOOL I、Q、M、L、D 状态参数： • 0：对指令的处理尚未启动、已完成或已取 消。 • 1：该指令正在处理过程中。 ERROR Output BOOL I、Q、M、L、D 状态参数： • 0：无错误。 • 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORD I、Q、M、L、D 详细的状态信息： 在参数 STATUS 处输出详细的错误和状态信 息。该参数设置仅维持一次调用所持续的时 间。因此，要显示其状态，应将 STATUS 参数 复制到可用数据区域。 有关有效数据类型的更多信息，请参见“有效数据类型概述。