SIEMENS西门子 3VA1 IEC断路器 3VA1116-4ED26-0AA0

           程序块 FTP_CMD（FTP 客户端功能） FTP_CMD 通过 FTP_CMD 指令，可以建立 FTP 连接，并从 FTP 服务器传送文件或将文件传送到 FTP 服务器。 可以通过 FTP 或 FTPS（安全 SSL 连接）传送数据。当 Main [OB1] 打开时，可在 STEP 7 中“指令”(Instructions) 任务卡的“通信 > 通信处理器 > SIMATIC NET CP”(Communication > Communications processor > SIMATIC NET CP) 下找到块。 说明 块版本 在工作站中，V2.x 版的 FTP_CMD 必须结合 CPU V2.x 和 CP V2.x 一起使用。 只要工作站采用 CPU V1.x 或 CP V1.x，就必须在旧版 V1.x（例如 V1.4）中使用 FTP_CMD。为此，需将“SIMATIC NET CP”库的版本更改为 V3.4。之后，便可以选择旧版的块。 下表列出了兼容性。可以访问 SIMATIC 存储卡的下列文件夹： – /DATALOGS 日志文件的目录 – /RECIPES 配方文件的目录 说明 对 CPU 的 SIMATIC 存储卡进行 FTP 访问：CPU 可切换到 STOP 模式 请注意，存储卡的容量有限。如果 SIMATIC 存储卡的存储空间因存储大量数据而被完全占满，则 CPU 会切换到 STOP 模式。 • 更换一个具有足够存储容量的存储卡。 • 避免经常使用 FTP 向 SIMATIC 存储卡写入大量数据。 通过 CPU 的 DB 进行读取/写入 要通过数据块使用 FTP 传送数据，请在 CPU 中创建需要的 DB。因为结构特殊，所以将其称为文件 DB。 在收到 FTP 命令时，充当 FTP 服务器的 CP 会查询分配表以找出 CPU 中用于文件传送的数据块与文件的映射关系。在 CP 的 STEP 7 组态中进行数据块分配（FTP 组态）。有关语法的注意事项 下列内容适用于文件数据块的文件名： • 文件名以“cpuX”开始（对于 S7-1500，其中的 X = 1）。 说明 请遵循适当的表示法（“cpu”小写，行开头没有前导空格）。否则，文件将无法识别。 • 长度：Zui多 64 个字符（包括“cpuX”）FTPS：比较证书 FTPS 需要对 FTP 服务器和 FTP 客户端之间的证书进行比较。如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器，则需要导入 FTP 服务器的证书。将 FTP 服务器的证书作为受信任证书导入证书管理器。 工作原理 FTP_CMD 指令引用指定了 FTP 命令的作业块 (ARG)。根据 FTP 命令 (CMD) 的类型，此作业块使用不同的数据结构执行参数分配。这些不同的结构可以使用适当的数 据类型 (UDT)。 下图显示了调用结构：作业块 (UDTs) 以下数据结构用于作业块： • 连接建立 基于以下访问类型的连接建立可使用不同数据结构： – FTP_CONNECT_IPV4：基于 IPv4 通过 IP 地址建立连接 – FTP_CONNECT_IPV6：基于 IPv6 通过 IP 地址建立连接 – FTP_CONNECT_NAME：通过服务器名称 (DNS) 建立连接 • 数据传送 有两种不同的数据结构可用于实现数据传送： – FTP_FILENAME：用于访问整个文件的数据结构 – FTP_FILENAME_PART：用于读取数据区的数据结构 File_DB 中的数据传送 数据传送通过包含作业数据报头和用户数据区域的数据块实现。该数据块在作业缓冲区中 加以指定。 有关示例文件 DB 的描述，请参见 STEP 7 信息系统。

              CPU 组态要求 使用以下设置启用 FTP 访问： • 针对所有用作文件 DB 的数据块，禁用“优化块访问”(Optimized block access) 属性。 • 仅当使用 CPU V1.x 和 CP V1.1.x 时： 在“保护和安全”(Protection & Security) 下的 CPU 组态数据中，启用“通过 PUT/GET 通信访问...”(Access via PUT/GET communication...) 选项（必须释放 PUT/GET）。调用该指令时要执行的 FTP 命令。可在此表后找到 FTP 命令类型的值范围。 此处指定的 FTP 命令必须与作业块中指定的命令相同（ ARG 参数）。 如果CP固件不支持命令，则输出一条带 STATUS = 8F6BH的出错消息。作业块 引用具有适合于 FTP 命令的执行参数的数据区。 根据不同的 FTP 命令，使用特定的数据类型 (UDT)。这些 UDT 如下所示。 此处指定的指针不允许使用 ANY 数据类型！“CMD”参数中的FTP命令 下表显示了“CMD”参数命令的含义以及提供给作业块所用的 UDT。 表格 3- 4 命令类型 CMD（命令类型） 相关作业块/UDT 含义/处理 0 (NOOP) * 调用的 FC 不执行任何动作。当提供这些参数时，按如下规定设置状态 代码： DONE=1; ERROR=0; STATUS=0 1 (CONNECT) FTP_CONNECT_IPV4 FTP_CONNECT_IPV6 FTP_CONNECT_NAME 建立 FTP 连接 通过该命令，FTP客户端将与FTP服务器建立FTP连接(端口 21)。 在此处为所有其他FTP命令指定的连接ID下，该连接可用。 然后与为该用户指定的FTP服务器交换数据。 2 (STORE) FTP_FILENAME 该函数调用将一个数据块(文件DB)从FTP客户端(S7- CPU)传送到FTP服务器。 注意：如果该文件(文件DB)已经存在于FTP服务器上，则该 文件将被覆盖。 3 (RETRIEVE) FTP_FILENAME 该函数调用将文件从FTP服务器传送到FTP客户端(S7-CPU)。 注意：如果FTP客户端上的数据块(文件DB)已经包含一个文 件，则该文件被覆盖。 4 (DELETE) FTP_FILENAME 通过该函数调用，删除FTP服务器上的文件。 5 (QUIT) * 通过该函数调用，可关闭在“ID”中指定的 FTP 连接。 6 (APPEND) FTP_FILENAME 与“STORE”类似，“APPEND”命令将文件保存在 FTP 服务器上。但“APPEND”命令不会覆盖 FTP 服务器上的文件。为现有文件添加新内容。 如果FTP服务器上不包含该文件(文件DB)，则创建该文件。 7 (RETR_PART) FTP_FILENAME_PART 使用“RETR_PART”命令(检索部分)，可以从FTP服务器请求文 件的一部分。 如果涉及非常大的文件，则该命令允许jinxian于读取当前要求 的部分。 为此，需要获知文件的结构。 在FB40中，使用“OFFSET”和“LEN”两个参数输入所要求的文 件部分。 * 对于命令类型 0 (NOOP) 和 5 (QUIT)，必须指定可自由选择的作业块 (UDT)。不进行评估。FTP_CMD 的作业块 含义 为 FTP_CMD 指令提供使用 ARG 参数的作业块。结构取决于 FTP 命令类型。通过使用默认数据类型 (UDT)，该指令可识别作业块类型。您将在下文中找到下列作业块的相关数据类型 (UDT)： • 基于 IPv4 通过 IP 地址建立 FTP 连接 • 基于 IPv6 通过 IP 地址建立 FTP 连接 • 通过服务器名称建立 FTP 连接 • 读写访问和其它 FTP 命令 • FTP 命令 RETR_PART 基于 IPv4 通过 IP 地址建立 FTP 连接的作业块 对于基于 IPv4 通过 IP 地址建立的 FTP 连接，将使用以下数据结构。 表格 3- 5 FTP_CONNECT_IPV4 参数 类型 取值范围 含义/说明 InterfaceID HW_ANY 模块起始地址 调用指令时，在 LADDR 参数中传送 CP 的模块起始地址。 在“属性 > 地址 > 输入”(Properties > Addresses > Inputs) 下，可以找到 CP 组态中 CP 的模块起始地址。 ID CONN_OUC 1, 2...64 在 FTP 连接上处理 FTP 作业。该参数可识别所用的连接。 ConnectionType BYTE 0 连接类型“FTP” ActiveEstablishm ent BOOL TRUE TRUE = 主动连接建立 FTPCmd BYTE 1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP 命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD (页 56)”部分。 注意： 此处指定的 FTP 命令必须与在 CMD在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器，则必须导入 FTP 服务器的证书。FTP_CONNECT_IPV6 参数 类型 取值范围 含义/说明 InterfaceID HW_ANY 模块起始地址 调用指令时，在 LADDR 参数中传送 CP 的模块起始地址。 在“属性 > 地址 > 输入”(Properties > Addresses > Inputs) 下，可以找到 CP 组态中 CP 的模块起始地址。 ID CONN_OUC 1, 2...64 在 FTP 连接上处理 FTP 作业。该参数可识别所用的连接。 ConnectionType BYTE 0 连接类型“FTP” ActiveEstablishm ent BOOL TRUE TRUE = 主动连接建立 FTPCmd BYTE 1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP 命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD (页 56)”部分。 注意： 此处指定的 FTP 命令必须与在 CMD 输入参数中指定的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS 在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器，则必须导入 FTP 服务器的证书。 UserName STRING[32] ‘用户’ 用于登录 FTP 服务器的用户名 Password STRING[32] ‘密码’ 用于登录 FTP 服务器的密码 FTPserverIPaddr IP_V6 ADDR(1) ... ADDR(16) Array[1..16] of Byte 形式的 FTP 服务器的 IP 地址，其中 2 个字节指定一个地址块。 示例：ADDR(1) + ADDR(2) 指定第一个地址块。