可以访问 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 组态）。图 3-3 将配备 CP 154x-1 的 S7-CPU 作为 S7 CPU数据的 FTP 服务器组态，程序块3.9 FTP 通信CP 1543-1操作说明, 07/2021,C79000-G8952-C289-08 53STEP 7 中的 DB 分配STEP 7 数据块分配表中的字段的含义和语法如下：列标题CPU DB 文件名 注释含义 CPU 分配可从下拉列表中选择数据块（文件DB）的编号可从下拉列表中选择分配给文件DB的文件名自动名称推荐；条目可以编辑。简略的注释示例 cpu1 [PLC_1] 20 cpu1_db20.dat 测量值设备1有关语法的注意事项下列内容适用于文件数据块的文件名：• 文件名以“cpuX”开始（对于 S7-1500，其中的 X =1）。说明请遵循适当的表示法（“cpu”小写，行开头没有前导空格）。否则，文件将无法识别。• 长度：Zui多 64个字符（包括“cpuX”）3.9.2 FTP 客户端3.9.2.1 程序块 FTP_CMD（FTP 客户端功能）FTP_CMD通过FTP_CMD 指令，可以建立 FTP 连接，并从 FTP 服务器传送文件或将文件传送到 FTP服务器。可以通过 FTP 或FTPS（安全 SSL 连接）传送数据。组态，程序块3.9 FTP 通信CP 1543-154 操作说明, 07/2021,C79000-G8952-C289-08当 Main [OB1] 打开时，可在 STEP 7 中“指令”(Instructions)任务卡的“通信 > 通信处理器 >SIMATIC NET CP”(Communication >Communications processor > SIMATIC NET CP)下找到块。说明块版本在工作站中，V2.x版的 FTP_CMD 必须结合 CPU V2.x 和 CP V2.x 一起使用。只要工作站采用 CPU V1.x 或 CPV1.x，就必须在旧版 V1.x（例如 V1.4）中使用FTP_CMD。为此，需将“SIMATIC NETCP”库的版本更改为V3.4。之后，便可以选择旧版的块。下表列出了兼容性。表格 3- 2 程序块 FTP_CMD 与 CPU 和 CP版本的兼容性FTP_CMD CPU CP 1543-1V1.5 V1.x 任意V1.5 任意 V1.xV2.0 V2.xV2.x可以通过 FTP 或 FTPS（安全 SSL 连接）传送数据。说明FTPS：比较证书FTPS 需要对 FTP 服务器和 FTP客户端之间的证书进行比较。如果在 FTP 客户端的 STEP 7项目外组态 FTP 服务器，则需要导入 FTP 服务器的证书。将FTP服务器的证书作为受信任证书导入证书管理器。工作原理FTP_CMD 指令引用指定了 FTP 命令的作业块 (ARG)。根据 FTP命令 (CMD)的类型，此作业块使用不同的数据结构执行参数分配。这些不同的结构可以使用适当的数据类型(UDT)。下图显示了调用结构：组态，程序块3.9 FTP 通信CP 1543-1操作说明, 07/2021,C79000-G8952-C289-08 55作业块 (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 信息系统。组态，程序块3.9 FTP 通信CP 1543-156 操作说明, 07/2021,C79000-G8952-C289-08CPU 组态要求使用以下设置启用 FTP 访问：• 针对所有用作文件 DB的数据块，禁用“优化块访问”(Optimized block access) 属性。• 仅当使用 CPU V1.x 和 CPV1.1.x 时：在“保护和安全”(Protection & Security) 下的 CPU 组态数据中，启用“通过PUT/GET通信访问...”(Access via PUT/GET communication...) 选项（必须释放PUT/GET）。3.9.2.2 输入参数 - FTP_CMD输入参数的说明将以下输入参数提供给 FTP_CMD 指令：表格 3- 3FTP_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”的值。组态，程序块3.9 FTP 通信CP 1543-1操作说明,07/2021, C79000-G8952-C289-0857“CMD”参数中的FTP命令下表显示了“CMD”参数命令的含义以及提供给作业块所用的 UDT。表格 3- 4命令类型CMD（命令类型） 相关作业块/UDT 含义/处理0 (NOOP) * 调用的FC不执行任何动作。当提供这些参数时，按如下规定设置状态 代码：DONE=1; ERROR=0; STATUS=01(CONNECT) FTP_CONNECT_IPV4FTP_CONNECT_IPV6FTP_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)。不进行评估。组态，程序块3.9 FTP通信CP 1543-158 操作说明, 07/2021, C79000-G8952-C289-083.9.2.3 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- 5FTP_CONNECT_IPV4参数 类型 取值范围 含义/说明InterfaceID HW_ANY 模块起始地址调用指令时，在LADDR 参数中传送 CP的模块起始地址。在“属性 > 地址 > 输入”(Properties >Addresses >Inputs) 下，可以找到 CP 组态中 CP的模块起始地址。ID CONN_OUC 1, 2...64在 FTP 连接上处理 FTP作业。该参数可识别所用的连接。ConnectionType BYTE 0连接类型“FTP”ActiveEstablishmentBOOL TRUE TRUE = 主动连接建立FTPCmd BYTE 1FTP 命令 "CONNECT"调用该指令时执行的 FTP命令。关于命令类型的取值范围，可参见“输入参数- FTP_CMD (页56)”部分。注意：此处指定的 FTP 命令必须与在 CMD输入参数中指定的命令相同。CertIndex BYTE 0 = FTP1= FTPS在此处选择协议类型 FTP 或 FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态FTP服务器，则必须导入 FTP 服务器的证书。组态，程序块3.9 FTP 通信CP 1543-1操作说明, 07/2021,C79000-G8952-C289-08 59参数 类型 取值范围 含义/说明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)指定第一个地址块（地址的第一个字节）。基于IPv6 通过 IP 地址建立 FTP 连接的作业块对于基于 IPv6 通过 IP 地址建立的 FTP 连接，将使用以下数据结构。表格3- 6 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”ActiveEstablishmentBOOL TRUE TRUE = 主动连接建立FTPCmd BYTE 1FTP 命令 "CONNECT"调用该指令时执行的 FTP命令。关于命令类型的取值范围，可参见“输入参数- FTP_CMD (页56)”部分。注意：此处指定的 FTP 命令必须与在 CMD输入参数中指定的命令相同。CertIndex BYTE 0 = FTP1= FTPS在此处选择协议类型 FTP 或 FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态FTP服务器，则必须导入 FTP 服务器的证书。UserName STRING[32] ‘用户’ 用于登录 FTP服务器的用户名Password STRING[32] ‘密码’ 用于登录 FTP 服务器的密码FTPserverIPaddrIP_V6 ADDR(1) ...ADDR(16)Array[1..16] of Byte 形式的 FTP 服务器的 IP地址，其中2 个字节指定一个地址块。示例：ADDR(1) + ADDR(2) 指定第一个地址块。组态，程序块3.9 FTP 通信CP1543-160 操作说明, 07/2021, C79000-G8952-C289-08通过服务器名称建立 FTP连接的作业块对于建立指定了服务器名称的 FTP 连接，将使用以下数据结构。使用 DNS将服务器名称分配给 IP 地址。表格 3- 7FTP_CONNECT_NAME参数 类型 取值范围 含义/说明InterfaceID HW_ANY 模块起始地址调用指令时，在LADDR 参数中传送 CP的模块起始地址。在“属性 > 地址 > 输入”(Properties >Addresses >Inputs) 下，可以找到 CP 组态中 CP的模块起始地址。ID CONN_OUC 1, 2...64在 FTP 连接上处理 FTP作业。该参数可识别所用的连接。ConnectionType BYTE 0连接类型“FTP”ActiveEstablishmentBOOL TRUE TRUE = 主动连接建立FTPcmd BYTE 1FTP 命令 "CONNECT"调用该指令时执行的 FTP命令。关于命令类型的取值范围，可参见“输入参数- FTP_CMD (页56)”部分。注意：此处指定的 FTP 命令必须与在 CMD输入参数中指定的命令相同。CertIndex BYTE 0 = FTP1= FTPS在此处选择协议类型 FTP 或 FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态FTP服务器，则必须导入 FTP 服务器的证书。UserName STRING[32] ’benutzer’ 用于登录 FTP服务器的用户名Password STRING[32] ’passwort’ 用于登录 FTP 服务器的密码FTPserverNameSTRING[254] FTP 服务器的 IP 地址组态，程序块3.9 FTP 通信CP 1543-1操作说明, 07/2021,C79000-G8952-C289-08 61读写访问和其它 FTP 命令的作业块以下数据结构可用于 FTP 命令store、retrieve、delete 和 append。表格 3- 8 FTP_FILENAME参数 类型 取值范围含义/说明InterfaceID HW_ANY 模块起始地址调用指令时，在 LADDR 参数中传送 CP的模块起始地址。在“属性> 地址 > 输入”(Properties > Addresses >Inputs) 下，可以找到 CP组态中 CP的模块起始地址。ID CONN_OUC 1, 2...64 在 FTP 连接上处理FTP作业。该参数可识别所用的连接。ConnectionType BYTE 0连接类型“FTP”ActiveEstablishmentBOOL TRUE TRUE = 主动连接建立FTPcmd BYTE 2,3, 4, 6 FTP 命令 "STORE / RETRIEVE / DELETE / APPEND"调用该指令时执行的FTP命令。关于命令类型的取值范围，可参见“输入参数- FTP_CMD (页 56)”部分。注意：此处指定的 FTP 命令必须与在CMD输入参数中指定的命令相同。CertIndex BYTE 0 = FTP1 = FTPS在此处选择协议类型 FTP 或FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态 FTP服务器，则必须导入 FTP服务器的证书。DataBlockNumberUINT 在此指定的数据块包含要读取/写入的文件 DB。LenFilename UINT0...1000不评估用于指定文件名总长度的参数“LenFilename”。而是评估“Filename”参数字符串中的长度信息。FilenameARRAY[0..3]OFSTRING[254]目标文件或源文件的文件名。文件名的四个字符串连在一起，作为一个完整字符串传输给服务器。RETR_PARTFTP 命令的作业块以下数据结构用于 RETR_PART FTP 命令。组态，程序块3.9 FTP 通信CP 1543-162操作说明, 07/2021, C79000-G8952-C289-08表格 3- 9 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”ActiveEstablishmentBOOL TRUE TRUE = 主动连接建立FTPcmd BYTE 7FTP 命令 "RETR_PART"调用该指令时执行的 FTP命令。关于命令类型的取值范围，可参见“输入参数- FTP_CMD (页56)”部分。此处指定的 FTP 命令必须与在 CMD输入参数中指定的命令相同。CertIndex BYTE 0 = FTP1 =FTPS在此处选择协议类型 FTP 或 FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的STEP 7 项目外组态 FTP服务器，则必须导入 FTP服务器的证书。Offset DWORD 从将要读取的那个文件算起的偏移量(以字节计)。LengthDWORD 在“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)。组态，程序块3.9 FTP 通信CP 1543-1操作说明, 07/2021,C79000-G8952-C289-08 63参数 类型 取值范围 含义/说明DataBlockNumberUINT在此指定的数据块包含要读取/写入的文件 DB。LenFilename UINT 0...1000不评估用于指定文件名总长度的参数“LenFilename”。而是评估“Filename”参数字符串中的长度信息。FilenameARRAY[0..3]OFSTRING[254]目标文件或源文件的文件名。文件名的四个字符串连在一起，作为一个完整字符串传输给服务器。命令类型NOOP 和 QUIT 的参数提供同时为 FTP_CMD 提供对具有以下命令类型的作业块的引用：CMD = 0 (NOOP)CMD =5 (QUIT)由于这些命令类型执行时，不对作业块的内容进行评估，因此指定作业块的类型 (UDT)不重要。说明对 FTP作业块的引用丢失时的响应如果未提供引用，则不执行命令。指令将在保持锁定在明显的执行状态下，不会为接口上的用户程序提供任何反馈。3.9.2.4输出参数和状态信息FTP_CMD参数 BUSY、DONE 和 ERROR使用参数 BUSY、DONE、ERROR 和 STATUS控制执行状态。BUSY参数指示处理状态。使用 DONE 参数检查作业是否已正确执行。如果在执行 "FTP_CMD"的期间出错，则会设置ERROR 参数。错误信息在 STATUS 参数中输出。下表列出了参数 BUSY、DONE 和 ERROR 之间的关系：BUSYDONE ERROR 说明1 - - 正在处理作业。0 1 0 作业已成功完成。0 0 1 出错，作业终止。STATUS参数中指定了错误的产生原因。0 0 0 未分配新作业。组态，程序块3.9 FTP 通信CP 1543-164 操作说明,07/2021, C79000-G8952-C289-08评估状态代码说明评估• 评估 BUSY = 0BUSY = 0之前，请勿评估状态显示。• 状态 8FxxH有关以状态 8FxxH 编码的条目，请参见“STEP7标准和系统函数”参考手册中的信息。描述通过RET_VAL输出参数进行错误评估的章节含详细信息。表格 3- 10FTP_CMD：STATUS参数与DONE和ERROR一起使用时的含义DONE ERROR STATUS 含义0 0 0000H没有任何作业在执行中。1 0 0000H 无错完成了作业。0 0 7001H 第一次发起作业。0 0 7002H 作业仍在运行。0 180C4H 通信错误(临时发生，通常建议在用户程序中重复执行该作业)。0 1 8183H 组态与作业参数不匹配。0 1 8401H未知错误可能的原因：• 检测到连接超时。• FTP 服务器已中止连接。解决方法：再次发送 QUIT 和CONNECT命令以重新建立连接。0 1 8402H 连接处于出错状态。可能已超出连接的超时时间或 FTP服务器已终止连接。解决方法：发送 QUIT 和 CONNECT 命令以重新建立连接。0 1 8403H 登录失败。0 1 8404H无法获取 FTP 服务器。0 1 8405H 传送失败。