连接参数 InterfaceID 和 ID 的扩展值范围 通过 S7-1500 CPU中的集成端口在不安全连接的条件下发送电子邮件时，以下内容适用于 SDT TMAIL_V4_SEC 和 TMAIL_中的连接参数 InterfaceID 和 ID。 参数 说明 InterfaceID 接口硬件标识符的值范围： •0（新）：操作系统自行选择一个适合的集成端口。 • 要使用的集成端口的硬件标识符。 ID 引用该连接：值范围： •0（新）：操作系统从内部范围选择一个自由连接 ID。 • 1 到 4095：要使用的连接 ID TMAIL_C V6.0及更高版本的说明 (S7-1200, S7-1500) 简介 下文介绍了 TMAIL_C 指令 V6.0及更高版本。在此并非为该指令的详细介绍，而是介绍了与 V6.0 以下版本指令相比的不同之处。 说明 S7-1200 CPU 从指令版本V6.0 开始，“TMAIL_C V5.0 及以上版本的说明”部分中所述的全部扩展也适用于 S7-1200 CPU。 概述 从TMAIL_C 指令版本 V6.0 开始，可以通过 CPU 的集成接口以电子邮件附件形式发送 SIMATIC存储卡上的数据日志、配方和用户文件。如果没有 SIMATIC 存储卡，则可使用 S7-1200 CPU 中 CPU内置装置存储器中的文件。 在 ATTACHMENT 参数处，使用 TMail_FileReference 系统数据类型。SDTTMail_FileReference 在 TIA Portal V16.0 及以上版本、S7-1200 CPU 固件版本 V4.4及以上版 本和 S7-1500 CPU 固件版本 V2.8 及以上版本中可用。 在 MAIL_ADDR_PARAM支持的结构中，WatchDogTime 参数值现在也可以为 null。 使用 TMail_FileReference SDT时，附件的名称会自动分配给 ATTACHMENT_NAME 参数。 引入了新的错误信息，指示路径或文件名无效。
TMail_FileReference系统数据类型的结构 参数 数据类型 起始值 说明 DirectoryP ath 字符串 [254] “/ DataLogs/ ”要附加的文件的路径 FileName 字符串 [254] “datalog.c sv” 有扩展名或无扩展名的文件名称 TMAIL_C指令不会限制待发送文件的大小。 使用 TMail_FileReference SDT 寻址文件的规则 首先给出的是同时适用于DirectoryPath 参数和 FileName 的规则。若未遵守这些规则，则会 通过参数 STATUS 输出错误信息。 •任何参数都不可以是空字符串。 • 不能使用 ASCII 控制字符（0x00 到 0x1F）。 •不允许使用以下字符：TMail_FileReference SDT 的 DirectoryPath 参数 注意，当在 SDT 的DirectoryPath 参数中输入所需路径时，用户可以通过 PLC 的固件逻辑推断出根目录，而不需要知道该目录。要正确寻址目录，DirectoryPath 参数必须以“/”开头和结尾。因此，每个路径都采用“/abcdef/”的格式。 用户还可以访问深度比根目录 + 1更深的目录。在这种情况下，路径的格式为“/abc/def/”，其 中每个“/”表示一个新目录。包括根目录在内的Zui大深度为 8。如果要在根目录中寻址文件，请在 DirectoryPath中放置一个“/”。除了上一部分的规则之外，还必须注意，不允许使用相对路径。这意味着“../”为无效的路径名称。此外，也不允许使用点来表示当前目录。例如，不允许使用“./”。 TMail_FileReference SDT 的Filename 参数 除了指定的规则外，请注意，由于 PLC 操作系统的限制，文件名称Zui多可包含 60 个字符。如果尝试输入包含超过 60 个字符的文件名，则 TMAIL_C 指令会中止并显示错误。 可以使用文件扩展名，但并未强制使用。 参数WatchDogTime 可在 MAIL_ADDR_PARAM 参数中使用的每个结构都包含 WatchDogTime 参数。该参数用于定义发送操作的Zui大执行时间。 从 TMAIL_C 指令版本 V6.0 开始，还可以将值 null 分配给此参数。值 null 表示未对TMAIL_C 的执行进行时间监视。 从指令版本 V6.0 开始，背景数据块的 SFB_STATUS 参数中不再出现值W#16#8090。 参数 ATTACHMENT_NAME 在 ATTACHMENT_NAME参数中，可以定义收件人收到电子邮件时电子邮件附件显示的名称。 使用 TMail_FileReference 时，其 FileName参数会自动分配给 ATTACHMENT_NAME 参数。 因此，在这种情况下，请勿为 ATTACHMENT_NAME参数赋值。否则，TMAIL_C 指令将生成 一个错误。 新错误代码 从 TMAIL_C 版本 V6.0 开始，TMAIL_C 的STATUS 参数或背景数据块的 SFB_STATUS 参数也 会返回以下值： TMAIL_C 的 STATUS 参数或背景数据块的SFB_STATUS 参数 (W#16#...) 说明 8088 文件不存在或者当前不可用。 8089无法打开文件，因为已达到可同时打开的Zui大文件数 （S7-1500 CPU 为 59，S7-1200 CPU 为 26）。 808ADirectoryPath 参数中包含无效字符串或者为空。输入这些参数时请注意下列规则： • 对于版本<v6.0(s7-1500)="" 或="" <v7.0="" (s7-1200)="" 的=""ouc，建议在每个地址前面输入空格和="" “<”。在其它所有应用程序版本中，可选择输入“<”。="" •=""对于版本="" ”。在其它所有应用程序版本中，可选择输入“>”。 • 必须在 TO_S 和 CC 地址之间输入逗号。由于运行时间和存储空间方面的原因，“TMAIL_C”指令不对 TO_S 或 CC 参数执行任何语法检 查。MAIL_ADDR_PARAM 参数 (S7-1200, S7-1500) 说明 在 MAIL_ADDR_PARAM 参数处，可使用TMail_V4、TMail_V6 或 Tmail_FQDN 结构定义发送 电子邮件的连接，并保存电子邮件服务器地址和登录详情。 在MAIL_ADDR_PARAM 参数中使用的结构取决于电子邮件服务器的寻址格式： • TMail_V4：通过 IP 地址寻址到IPv4。 • TMail_V6：通过 IP 地址寻址到 IPv6。 • TMail_FQDN：通过完全限定域名 (FQDN)寻址。
可使用的结构取决于InterfaceId 参数指定的接口： • 如果要将“TMAIL_C”指令用于内部接口，必须在 MAIL_ADDR_PARAM参数中使用 TMail_V4 结构。 • 如果正使用通信处理器 (CP) 或通信模块(CM)，就可使用所有的三种寻址选项（IPv4、Pv6 和 FQDN）。 表格 4-72 TMail_V4：通过 IP 地址(IPv4) 寻址邮件服务器 参数 数据类型 说明 TMail_V4 Struct InterfaceId LADDR接口的硬件标识符 ID CONN_OUC 连接 ID ConnectionType BYTE 连接类型。选择 16#20 作为IPv4 的连接类型。 ActiveEstablished BOOL 状态位。建立连接后设置为“1”。 CertIndex BYTE• =0：使用了 SMTP (Simple Mail Transfer Protocol)。如果正通过 S7-1500 CPU的接口发送 电子邮件，就必须使用 SMTP。 • ≠0：连接建立前使用 SMTPS 保障其安全（使用 CP/CM 时）。WatchDogTime TIME 运行看门狗程序。该参数用于定义发送操作的Zui大执 行时间。注：如果连接速度较慢，则连接的建立时间可能比较 长（约 1 分钟）。指定参数 WATCH_DOG_TIME 时，必须为连接的建立预留足够的时间。 超出指定的时间后，连接将立即终止。 MailServerAddres s IP_V4 邮件服务器的IP 地址。IPv4 的格式如下所示： （十进制）。 示例： UserName STRING[254] 邮件服务器登录名称PassWord STRING[254] 邮件服务器密码 From EMAIL_ADDR 电子邮件的发件方地址，由以下两个STRING 参数定 义。例如，参数 数据类型 说明 LocalPartPlusAt Sign STRING[64]发件方地址的本地部分，包括 @ 符号。示例： “myname@” Full mainNameSTRING[254] 邮件服务器的 Fully Domain Name（缩写为FQDN）。如，“mymailserver.com”