程序块 FTP_CMD（FTP 客户端功能）FTP_CMD 通过 FTP_CMD 指令，可以建立 FTP 连接，并从 FTP 服务器传送文件或将文件传送到 FTP 服务器。可以通过 FTP 或 FTPS（安全 SSL 连接）传送数据。当 Main [OB1] 打开时，可在 STEP 7中“指令”(Instructions) 任务卡的“通信 > 通信处理器 > SIMATIC NETCP”(Communication > Communications processor > SIMATIC NETCP) 下找到块。 说明 块版本 在工作站中，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 blockaccess) 属性。 • 仅当使用 CPU V1.x 和 CP V1.1.x 时： 在“保护和安全”(Protection &Security) 下的 CPU 组态数据中，启用“通过 PUT/GET 通信访问...”(Access via PUT/GETcommunication...) 选项（必须释放 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 服务器的用户名 PasswordSTRING[32] ‘密码’ 用于登录 FTP 服务器的密码 FTPserverIPaddr IP_V6 ADDR(1) ...ADDR(16) Array[1..16] of Byte 形式的 FTP 服务器的 IP 地址，其中 2 个字节指定一个地址块。示例：ADDR(1) + ADDR(2) 指定第一个地址块。