S7-1500CM/CP (S7-1200, S7-1500) 工业以太网 (S7-1500) 用于 FTP 服务的指令 (S7-1500) 用于FTP 服务的 FTP_CMD (S7-1500) FTP_CMD 概述 (S7-1500) 含义 通过 FTP_CMD指令，可以建立 FTP 连接，并从 FTP 服务器传送文件或将文件传送到 FTP 服 务器。 说明 块版本 在工作站中，V2.x 版的FTP_CMD 必须结合 CPU V2.x 和 CP V2.x 一起使用。 只要工作站采用 CPU V1.x 或 CPV1.x，就必须在旧版 V1.x（例如 V1.4）中使用 FTP_CMD。为此，需将“SIMATIC NET CP”库的版本更改为 V3.4。之后，便可以选择旧版的块。 可以通过 FTP或 FTPS（安全 SSL 连接）传送数据。 说明 FTPS：比较证书 FTPS 需要对 FTP 服务器和 FTP客户端之间的证书进行比较。如果在 FTP 客户端的 STEP 7 项 目外组态 FTP 服务器，则需要导入 FTP 服务器的证书。将FTP 服务器的证书作为受信任证书 导入证书管理器。 工作原理 FTP_CMD 指令引用指定了 FTP 命令的作业块 (ARG)。根据FTP 命令 (CMD) 的类型，此作业 块使用不同的数据结构执行参数分配。这些不同的结构可以使用适当的数据类型 (UDT)。下图显示了调用结构：作业块 以下数据结构用于作业块： • 连接建立 基于以下访问类型的连接建立可使用不同数据结构： –FTP_CONNECT_IPV4：基于 IPv4 通过 IP 地址建立连接 – FTP_CONNECT_IPV6：基于 IPv6 通过IP 地址建立连接 – FTP_CONNECT_NAME：通过服务器名称 (DNS) 建立连接 • 数据传送有两种不同的数据结构可用于实现数据传送： – FTP_FILENAME：用于访问整个文件的数据结构 –FTP_FILENAME_PART：用于读取数据区的数据结构 File_DB 中的数据传送数据传送通过包含作业数据报头和用户数据区域的数据块实现。该数据块在作业缓冲区中加 以指定。 CPU 组态要求 使用以下设置启用 FTP访问： • 针对所有用作文件 DB 的数据块，禁用“优化块访问”(Optimized block access) 属性。 • 仅当使用CPU V1.x 和 CP V1.1.x 时： 在“属性 > 常规 > 保护”(Properties >General > Protection) 下的 CPU 组态数据中，禁用 “禁用 PUT/GET 通信”(DisablePUT/GET communication) 选项（必须释放 PUT/GET）。
有效性 FTP_CMD指令可与以下模块类型一起使用： • CP 1543‑1 • CP 1545‑1 调用接口 FBD表达式的调用接口输入参数 - FTP_CMD (S7-1500) 输入参数的说明 将以下输入参数提供给 FTP_CMD 指令： 表格4-138 FTP_CMD 指令的形式参数 - 输入参数 参数 声明 数据类型 存储区 含义/说明 REQ Input BOOL E,A, M, DB, L 在上升沿启动发送作业。 ID * INPUT INT 1, 2 ... 64 在 FTP 连接上处理 FTP作业。该参数可识 别所用的连接。参数 声明 数据类型 存储区 含义/说明 CMD * INPUT BYTE 请参见下表“命 令”。调用该指令时要执行的 FTP 命令。可在此 表后找到 FTP 命令类型的值范围。 此处指定的 FTP 命令必须与作业块中指定的命令相同（ARG 参数）。 如果 CP 固件不支持命令，则输出一条带 STATUS = 8F6BH 的出错消息。 ARG *INPUT VARIANT 请参见下表“命 令”。 作业块 引用具有适合于 FTP 命令的执行参数的数 据区。 根据不同的 FTP命令，使用特定的数据类 型 (UDT)。这些 UDT 如下所示。 此处指定的指针不允许使用 ANY 数据类 型！ *输入参数“ID”和“CMD”的值将覆盖输入参数“ARG”的值。 “CMD”参数中的 FTP 命令下表显示了“CMD”参数命令的含义以及提供给作业块所用的 UDT。 表格 4-139 命令类型 CMD（命令类型） 相关作业块/UDT含义/处理 0 (NOOP) * 调用的 FC 不执行任何动作。当提供这些参数时，按如下规定 设置状态代码： DONE=1;ERROR=0; STATUS=0 1 (CONNECT) FTP_CONNECT_IPV4 FTP_CONNECT_IPV6FTP_CONNECT_NAME 建立 FTP 连接 通过该命令，FTP 客户端将与 FTP 服务器建立 FTP 连接(端口 21)。在此处为所有其他 FTP 命令指定的连接 ID 下，该连接可用。 然后与为该用户指定的 FTP 服务器交换数据。 2 (STORE)FTP_FILENAME 该函数调用将一个数据块(文件 DB)从 FTP 客户端(S7-CPU)传送 到 FTP 服务器。注意：如果该文件(文件 DB)已经存在于 FTP 服务器上，则该文 件将被覆盖。CMD（命令类型） 相关作业块/UDT 含义/处理 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 的作业块 (S7-1500) 含义 为FTP_CMD 指令提供使用 ARG 参数的作业块。结构取决于 FTP 命令类型。通过使用默认数 据类型(UDT)，该指令可识别作业块类型。您将在下文中找到下列作业块的相关数据类型 (UDT)： • 基于 IPv4 通过 IP 地址建立FTP 连接 • 基于 IPv6 通过 IP 地址建立 FTP 连接 • 通过服务器名称建立 FTP 连接 • 读写访问和其它 FTP命令 • FTP 命令 RETR_PART基于 IPv4 通过 IP 地址建立 FTP 连接的作业块 对于基于 IPv4 通过 IP地址建立的 FTP 连接，将使用以下数据结构。 表格 4-140 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 TRUETRUE = 主动连接建立 FTPCmd BYTE 1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP命令。关于命令类型的取值 范围，可参见 输入参数 - FTP_CMD (页 6069) 部分。 注意： 此处指定的 FTP命令必须与在 CMD 输入参数中指定 的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS 在此处选择协议类型FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器， 则需要导入FTP 服务器的证书。 UserName STRING[32] ’benutzer’ 用于登录 FTP 服务器的用户名Password STRING[32] ’passwort’ 用于登录 FTP 服务器的密码 FTPserverIPaddrIP_V4 ADDR(1) ... ADDR(4) Array[1..4] of Byte 形式的 FTP 服务器的 IP 地址，其中 1 个字节指定一个地址块。 示例：ADDR(1) 指定第一个地址块（地址的第一个字 节）。