介绍库

一般信息

库概述

FtpRemoteFileHandling 库针对远程文件处理提供以下 FTP 客户端功能：

o读取文件

o写入文件

o删除文件

o列出远程目录的内容

o添加目录

o删除目录

1 控制器作为 FTP 客户端

2 上载文件（Store 命令）

3 FTP 服务器（在 PC 或控制器上）

4 下载文件（Retrieve 命令）

库的特性

下表说明库的特性：

特性	值
库标题	FtpRemoteFileHandling
公司	Schneider Electric
类别	通讯
组件	互联网协议套装
缺省名称空间	SE_FTP
语言模型属性	（仅限符合条件时访问）
向上兼容库	是 (FCL)

注意：对于此库，设置“仅限定访问”。这意味着 POU、数据结构、枚举和常量必须通过使用库的名称空间进行访问。此库的缺省名称空间是 SE_FTP。

项目示例

结合此库，提供了示例项目 FTPRemoteFileHandlingExample.project。示例项目显示了如何实施 FtpRemoteFileHandling 库的组件。

步骤	操作	注释
1	在 EcoStruxure Machine Expert Logic Builder中，执行命令新建项目。	–
2	在新建项目对话框中，从项目类型列表中选择来自示例。	–
3	在新建项目对话框的右侧，从控制器列表中选择控制器 ⁽¹⁾。	结果：可用的示例在匹配示例文本框中列出。
4	从匹配示例列表中选择您的示例。	–
5	为新项目输入名称，然后选择文件位置。	–
6	单击确定按钮。	结果：基于所选择的示例选择了新项目。

一般考虑

考虑以下 FTP 数据传输限制：

o在与 FTP 服务器进行交换时，文件名和目录名仅支持 ASCII 符号。

o仅支持 IPv4（互联网协议版本 4）。

o仅支持被动模式 FTP。

o一次仅允许一个 FTP 连接。

o由于 FTP 服务器的响应时间无法控制，因此，以低优先级循环任务执行该功能块。调节此任务的看门狗功能，允许足够的连接时间。或者，执行自由运行任务中的功能块。对于这种类型的任务，没有定义循环时间。

本文档所用的库在内部使用 TcpUdpCommunication库。

TcpUdpCommunication(Schneider Electric) 和 CAA Net Base Services 库（CAA 技术工作组）在控制器上使用相同的相同资源。若在同一应用程序中同时使用这两个库，则可能导致控制器工作受到干扰。

警告

意外的设备操作

不要在同一应用程序中同时使用库 TcpUdpCommunication(Schneider Electric) 和库 CAA Net Base Services（CAA 技术工作组）。

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

有关网络安全的考虑

FtpRemoteFileHandling 库功能不支持使用 TLS（传输层安全）或 SSL（安全套接层）的安全连接。因此，通讯必须只能在您的工业网络内部进行，与您公司的其他网络隔离，并防止接入互联网。

注意： Schneider Electric 在控制系统的开发和实施过程中严格遵循行业最佳实践。这其中包括一种“深度防御”方法，旨在保护工业控制系统的安全。此方法将控制器置于一个或多个防火墙之后，将访问范围限制为仅经过授权的人员和协议。

警告

未经授权访问及其导致的未经授权的机器操作

o评估环境或机器是否已连接到关键基础结构，如果已连接，请在将自动化系统连接到任何网络之前，基于深度防护采取适当的预防措施。

o将连接到网络的设备数限制为所需的最小数量。

o将工业网络与公司内部的其他网络隔离。

o使用防火墙、VPN 或其他经证实的安全措施，防止意外访问任何网络。

o监控系统内的活动。

o防止未经授权方或未经身份验证的操作直接访问或直接链接主体设备。

o准备恢复计划，包括系统和过程信息的备份。

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

POU 概述

功能块	用途
FB_FTPClient	实现 FTP 客户端，该客户端连接 FTP 服务器，用于文件和目录操作。

模块相关接口中的结构的概述

结构	用途
ST_Credentials	包含针对用户的信息，用于连接外部 FTP 服务器。
ST_Content	包含有关选中目录的用户信息。
ST_Element	ST_Content 的子结构，它包含针对元素的信息。

枚举概述

枚举	用途
ET_FtpCommand	定义可由功能块 FB_FTPClient 通过 i_etCommand 执行的命令。
ET_Result	包含代表功能块所执行运算的结果的可能值。