通过服务器名称建立 FTP 连接的作业块对于建立指定了服务器名称的 FTP 连接，将使用以下数据结构。使用 DNS 将服务器名称分配给 IP 地址。FTP_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(页 56)”部分。 注意： 此处指定的 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服务器的密码 FTPserverName STRING[254] FTP 服务器的 IP 地址。
读写访问和其它 FTP 命令的作业块以下数据结构可用于 FTP 命令 store、retrieve、delete 和 append。 表格 3- 8FTP_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 (页 56)”部分。 注意： 此处指定的 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 命令。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 7 FTP 命令"RETR_PART" 调用该指令时执行的 FTP 命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD (页56)”部分。 此处指定的 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)。命令类型 NOOP 和 QUIT 的参数提供 同时为 FTP_CMD提供对具有以下命令类型的作业块的引用： CMD = 0 (NOOP) CMD = 5 (QUIT)由于这些命令类型执行时，不对作业块的内容进行评估，因此指定作业块的类型 (UDT) 不重要。 说明 对 FTP作业块的引用丢失时的响应 如果未提供引用，则不执行命令。指令将在保持锁定在明显的执行状态下，不会为接口上的用户程序提供任何反馈。输出参数和状态信息FTP_CMD 参数 BUSY、DONE 和 ERROR 使用参数BUSY、DONE、ERROR 和 STATUS 控制执行状态。BUSY 参数指示处理状态。使用 DONE参数检查作业是否已正确执行。如果在执行 "FTP_CMD" 的期间出错，则会设置 ERROR 参数。错误信息在 STATUS参数中输出。 下表列出了参数 BUSY、DONE 和 ERROR 之间的关系评估 • 评估 BUSY = 0 BUSY = 0之前，请勿评估状态显示。 • 状态 8FxxH 有关以状态 8FxxH 编码的条目，请参见“STEP 7标准和系统函数”参考手册中的信息。描述通过RET_VAL输出参数进行错误评估的章节 含详细信息。可能的原因： • CMD参数的数值错误 允许使用 0 至 15 范围内的数值。 • 不支持FB40命令。 可能原因：CP 的固件不正确解决方法：固化程序更新(对于较早的CP，使用函数FC 40...FC 44 ，而不是FB 40。)用于 FTP客户端操作的数据块（文件 DB）的结构 工作原理 要使用 FTP 传送数据，请在 S7 站的 CPU 上创建数据块（文件DB）。这些数据块必须具有特定结构，以便作为可传送文件由 FTP 服务进行处理。它们由下列部分组成： • 部分1：文件DB报头(具有固定长度，20字节) • 部分 2：“Array [..] of Byte”或“Array [..] ofChar”类型的用户数据（具有可变的长度和结构） 数据一致性 确保不在同一时间多次访问同一文件 DB。 创建文件 DB 1. 在STEP 7 中创建一个新数据块。 2. 打开块编辑器。 3. 在 DB 的块编辑器中，选择要用作文件 DB 起始行的行。 4.在“数据类型”(Data type) 列中，使用键盘输入类型“FILE_DB_HEADER”。 将创建文件 DB所需的带报头结构的数据结构。 5. 将“WRITEACCESS”参数设置为“true”以启用访问。 6.在“MAX_LENGTH”参数中输入用户数据长度的值。 7. 之后，为要发送的用户数据创建一个“Array [..] ofByte”或“Array [..] of Char”类型的数据字段。字段的大小必须与报头中所规定的“MAX_LENGTH”相匹配。用于FTP客户端模式的文件DB报头 此处描述的文件 DB报头与服务器模式的文件 DB 报头相同。 参数 类型 数值/含义 电源 EXIST BOOL EXIST 位指示用户数据区是否包含有效的数据。 只有在 EXIST=1 时，retrieve FTP 命令才执行作业。 • 0：文件 DB 不包含有效的用户数据（文件不存在）。 • 1：文件 DB 包含有效的用户数据（文 件存在）。 DELETE FTP 命令设置 EXIST=0。 STOREFTP 命令设置 EXIST=1。NEW BOOL NEW 位指示自上一次读操作到现在 ，数据是否被修改。 •0：自上次写访问以来，文 件 DB 的内容没有发生改变。S7 CPU 的用户程序已经记录Zui近 一次修改。 • 1：S7 CPU的用户程序尚未记录上次 写访问。 执行以后，“RETRIEVE”FTP 命令设置 NEW=1。 读取数据后，S7 CPU中的用户程序必须设置 NEW=0 以允许新的“RETRIEVE”命令。 WRITEACCESS BOOL • 0：用户程序对 S7CPU 上的文件 DB 具有写访问权限。 • 1：用户程序对 S7 CPU 上的文件 DB 不具有写访问权限。 在组态 DB期间，将此位置位为初始值。 建议： 如有可能，应该保持此位不变！在 特殊情况下，可以在操作期间对此 进行调整。 ACT_LENGTHDINT 用户数据区的当前长度。 只有在 EXIST = 1 时，该字段的内容才有效。 在进行写入操作以后更新当前长度 。MAX_LENGTH DINT 用户数据区的Zui大长度（整个 DB 的长度减去 20 个字节的文件头）。 应在 DB组态期间指定Zui大长度。 还可在操作期间通过用户程序修改 该数值。 FTP_REPLY_CODE INT 无符号整型(16位)，包含Zui后一个来自FTP的返回代码，代 码为二进制数值。 只有当 EXIST=1 时，此字段的内容才有效。 通过 FTP 协议句柄及服务器的FTP 命令处理更新。 DATE_TIME DATE_AND_TIME 文件Zui近一次修改的日期和时 间。 只有当 EXIST=1时，此字段的内容才有效。 在写访问以后更新当前日期。 如果使用了转发时钟的功能，则输 入对应于已传递的时间。如果未使用转发时钟的功能，则输 入相对时间。参考为 CP 的启动时间。