基于 IPv6 通过IP 地址建立 FTP 连接的作业块 对于基于 IPv6 通过 IP 地址建立的 FTP 连接，将使用以下数据结构。 表格 4-141FTP_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 BYTE1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP 命令。关于命令类型的取值 范围，可参见 输入参数 - FTP_CMD(页 6069) 部分。 注意： 此处指定的 FTP 命令必须与在 CMD 输入参数中指定 的命令相同。 CertIndexBYTE 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) 指定第一个地址块。
通过服务器名称建立 FTP 连接的作业块对于建立指定了服务器名称的 FTP 连接，将使用以下数据结构。使用 DNS 将服务器名称分 配给 IP 地址。 表格 4-142FTP_CONNECT_NAME 参数 类型 取值范围 含义/说明 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 BYTE1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP 命令。关于命令类型的取值 范围，可参见 输入参数 - FTP_CMD(页 6069) 部分。 注意： 此处指定的 FTP 命令必须与在 CMD 输入参数中指定 的命令相同。 CertIndexBYTE 0 = FTP 1 = FTPS 在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP客户端的 STEP 7 项目外组态 FTP 服务器， 则需要导入 FTP 服务器的证书。 UserName STRING[32]’benutzer’ 用于登录 FTP 服务器的用户名 Password STRING[32] ’passwort’ 用于登录 FTP服务器的密码 FTPserverName STRING[254] FTP 服务器的 IP 地址。读写访问和其它 FTP 命令的作业块以下数据结构可用于 FTP 命令 store、retrieve、delete 和 append。 表格 4-143FTP_FILENAME 参数 类型 取值范围 含义/说明 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 BYTE2, 3, 4, 6 FTP 命令 "STORE / RETRIEVE / DELETE / APPEND" 调用该指令时执行的FTP 命令。关于命令类型的取值 范围，可参见 输入参数 - FTP_CMD (页 6069) 部分。 注意： 此处指定的FTP 命令必须与在 CMD 输入参数中指定 的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的 STEP 7 项目外组态 FTP服务器， 则需要导入 FTP 服务器的证书。 DataBlockNumbe r UINT 在此指定的数据块包含要读取/写入的文件DB。 LenFilename UINT 0...1000 不评估用于指定文件名总长度的参数“LenFilename”。而是评估“Filename”参数字符串中的长度信息。 Filename ARRAY[0..3] OF STRING[254]目标文件或源文件的文件名。 文件名的四个字符串连在一起，作为一个完整字符串 传输给服务器。RETR_PART FTP 命令的作业块以下数据结构用于 RETR_PART FTP 命令。 表格 4-144 FTP_FILENAME_PART 参数 类型 取值范围含义/说明 InterfaceID HW_ANY 模块起始地址 调用指令时，在 LADDR 参数中传送 CP 的模块起始地 址。在“属性 > 地址 > 输入”(Properties > Addresses > Inputs) 下，可以找到CP 组态中 CP 的模块起始地址。 ID CONN_OUC 1, 2...64 在 FTP 连接上处理 FTP作业。该参数可识别所用的连 接。 ConnectionType BYTE 0 连接类型“FTP” ActiveEstablishment BOOL TRUE TRUE = 主动连接建立 FTPcmd BYTE 7 FTP 命令 "RETR_PART"调用该指令时执行的 FTP 命令。关于命令类型的取值 范围，可参见 输入参数 - FTP_CMD (页 6069) 部分。此处指定的 FTP 命令必须与在 CMD 输入参数中指定 的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态 FTP服务器，则必须导入 FTP 服务器的证 书。 Offset DWORD 从将要读取的那个文件算起的偏移量(以字节计)。参数 类型取值范围 含义/说明 Length DWORD 在“OFFSET”中指定的数值处开始读取的子长(以字节 计)。 特性： •如果指定“DW#16#FFFFFFFF”，将读取文件的可用 剩余部分。 如果没有出现其它错误，则结果“正确”(DONE =1，STATUS = 0)。 • 当 OFFSET > 原始文件长度时： 目标文件长度(文件 DB 中的ACT_LENGTH)：CPU 上的 0 字节。 如果没有出现其它错误，则结果“正确”(DONE = 1，STATUS = 0)。 •当 OFFSET + LEN > 原始文件长度(且 LEN ≠ 0xFFFFFFFF)时： 目标文件长度(文件 DB 中的ACT_LENGTH)：从 “OFFSET”开始的可用字节。 如果没有出现其它错误，则结果“正确”(DONE = 1， STATUS= 0)。 DataBlockNumbe r UINT 在此指定的数据块包含要读取/写入的文件 DB。 LenFilenameUINT 0...1000 不评估用于指定文件名总长度的参数“LenFilename”。而是评估“Filename”参数字符串中的长度信息。 Filename ARRAY[0..3] OF STRING[254]目标文件或源文件的文件名。 输出参数和状态信息 FTP_CMD (S7-1500) 参数 BUSY、DONE 和 ERROR 使用参数BUSY、DONE、ERROR 和 STATUS 控制执行状态。BUSY 参数指示处理状态。使用 DONE参数检查作业是否已正确执行。如果在执行 "FTP_CMD" 的期间出错，则会设置 ERROR 参数。错误信息在 STATUS参数中输出。