SIEMENS西门子 移动操作屏电缆 6AV21815AF150AX0

               S7-1500 CM/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 或 CP V1.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 通信”(Disable PUT/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_IPV6 FTP_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 TRUE TRUE = 主动连接建立 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 服务器的密码 FTPserverIPaddr IP_V4 ADDR(1) ... ADDR(4) Array[1..4] of Byte 形式的 FTP 服务器的 IP 地址，其 中 1 个字节指定一个地址块。 示例：ADDR(1) 指定第一个地址块（地址的第一个字 节）。