TMAIL_C V4.0及更高版本的说明 (S7-1200, S7-1500) 简介 在下文中介绍了 TMAIL_C 指令 V4.0及更高版本。在此并非为该指令的详细介绍，而是介绍 了与低于 V4.0 版本指令相比之间的不同之处。 所需的证书操作，在此也未涉及。使用 Secure Communication 的 CP 以下 CP 通过自版本 V4.0 起的 TMAIL_C指令发送安全电子邮件。 • CP 1543‑1 ‑ V2.0 • CP 1545‑1 •CP 1542SP‑1 IRC ‑ V1.0, CP 1543SP‑1 ‑ V1.0 •CP 1243‑1 ‑ V2.1 • CP 1242‑7 GPRS V2 ‑ V2.1 •CP 1243‑7 LTE ‑ V2.1 • CP 1243‑8 IRC ‑ V2.1待发送数据和电子邮件服务器的 TCP 端口由以下系统数据类型的参数 MAIL_ADDR_PARAM 设 置：TMAIL_V4_SEC,TMAIL_V6_SEC, TMAIL_QDN_SEC 说明 与 TMAIL_C V4.0 以下版本的兼容性出于兼容性考虑，也可按如下方式使用现有的系统数据类型 TMAIL_V4、TMAIL_V6 和 TMAIL_FQDN： • CPU：TMAIL_V4, TMAIL_FQDN • 上述所有 CP 以及 CP 1542SP‑1： TMAIL_V4,TMAIL_V6, TMAIL_FQDN CP 规则 请遵守以下规则： • CPU 的每个 TMAIL_C 实例必须只使用一个 CP作为电子邮件客户端。 • CP（电子邮件客户端）的电子邮件服务器必须可从 IP 网络访问。 •如果要通过完全限定域名访问一个电子邮件服务器，则 CP 中组态的 DNS 服务器在该 IP 网 络中也必须可访问。 参数 参数 声明数据类 型 存储区 说明 ... MAIL_ADDR _PARAM (页 5571) Input VARIAN T D发送过程所需的数据（含连接参数、电 子邮件服务器的地址和所用的 TCP 端口） 为此，需选择以下系统数据类型： •TMail_V4_SEC • TMail_V6_SEC • TMail_QDN_SEC
出错时需执行的诊断选项发生错误时，可执行以下两种诊断方式： • 评估 STATUS 参数 指令版本低于 V4.0 时，可能发生值同样现象。 只有值W#16#8015 才接收扩展。参见“STATUS 参数 (页 5579)” • 评估 TMAIL_C 背景数据块中的MS_STATUS 变量。在 TMAIL_C 的 V4.0 版本中，该变量已添加。其中，包含协议代码及其相应的文本描述信息。协议代码在 RFC 5321 "Simple Mail TransferProtocol" 中定义。也可在相应的扩展或其它媒介中找到相关文本描述。 MS_STATUS 中的诊断信息示例： – 提交前请求550 SMTP AUTH – 请求 550 StartTLS – 550 请求的动作未执行 – 550 要求使用有效地址。TMAIL_C V5.0 及更高版本的说明 (S7-1200, S7-1500) 简介 下文介绍了 TMAIL_C 指令 V5.0及更高版本。在此并非为该指令的详细介绍，而只是介绍了 相比 V5.0 以下版本指令的不同之处。 说明 从 TMAIL_C 指令的V5.0 版本开始，ATTACHMENT 参数支持其它数据类型。 自版本 V5.0 起，可使用 TMAIL_C指令发送电子邮件，通过 S7-1500 CPU 上的集成以太 网端口进行 Secure Communication。只有在S7-1500 CPU 固件版本不低于 V2.5 时才适用 此条件。发送过程所需的数据由系统数据类型为 TMAIL_V4_SEC 或TMAIL_QDN_SEC 的参数 MAIL_ADDR_PARAM 进行定义。 如果使用系统数据类型 TMAIL_V4，则只能通过S7-1500 CPU 的集成以太网端口在不安全的 条件下发送电子邮件。通过 S7-1500 CPU集成以太网端口发送电子邮件时，不支持系统数据类型 TMAIL_FQDN 和 TMAIL_V6。 说明 S7-1500 软件控制器 使用ID=59 的 S7-1500 软件控制器时，不能使用系统数据类型 TMAIL_V4_SEC 或 TMAIL_QDN_SEC。ATTACHMENT 参数 从 TMAIL_C 指令的 V5.0 版本开始，ATTACHMENT 参数还支持以下数据类型：ARRAYof CHAR、ARRAY of LWORD（jinxian S7-1500 CPU）和 STRING（注意：如果ATTACHMENT 参数 中的字符串为空，则电子邮件发送时无附件）。 这还会影响 STATUS 的 W#16#8016值：在指令版本 V5.0 及更高版本中使用数据类型 ARRAY of CHAR、ARRAY of LWORD（jinxianS7-1500 CPU）和 STRING 时，不再输出该值。 STATUS 参数中的其它返回值 对于版本 V5.0 的 TMAIL_C指令，参数 STATUS (页 5579) 还会输出以下返回值： STATUS (W#16#...) 说明 备注 8009内部函数错误 内部函数返回一个错误。有关详细信息，请参见背景数据块的 SFB_STATUS 参数。下面列出了可能的值。下表列出了背景数据块“SFB_STATUS”参数可能的值： 参数 SFB_STATUS （用于背景数 据块 (W#16#...)）说明 8080 评估 T_MAIL 子实例的 Status 参数： • 8080_04xx：SMTP服务器发出暂时性否定回复。请重试。相关详细信息，请参见 RFC 5321。 • 8080_05xx：SMTP服务器发出yongjiu性否定回复。相关详细信息，请参见 RFC 5321。 8085 连接 ID（ID参数）已经被已组态的连接使用。 8086 ID 参数超出了有效范围。参数 SFB_STATUS （用于背景数 据块(W#16#...)） 说明 8087 已达到Zui大连接数；无法建立更多连接 8090 看门狗时间必须大于等于零。 8092 TO_S和 CC 参数为空，或子参数 From 为空或不完整。 8093 MAIL_ADDR_PARAM参数要求将连接升级为安全连接，但邮件服务器不支持 STARTTLS 命令。 8095 邮件服务器响应无效，邮件服务器可能不符合RFC。 809A 集成接口不支持参数 MAIL_ADDR_PARAM 的 SDT 结构。 809B MAIL_ADDR_PARAM的 SDT 中的接口 ID 无效。 80A1 指定的连接或远程端口正在使用中。 80A3 ID 已由用户程序创建的连接使用。 80A4远程连接端点的 IP 地址无效，或者与本地伙伴的 IP 地址重复。 80A7 通信错误：在 TMAIL_C 完成前执行了TDISCON。 80B7 远程端口为 0，或伙伴端点的 IP 地址已设置为 0.0.0.0。 80C3 CPU 中资源不足 80C4临时通信错误： • 此时无法建立连接。 • 由于连接路径中防火墙的指定端口未打开，无法建立连接。 • 接口当前正在接收新参数。 •TDISCON 指令当前正在删除已组态的连接。 80C5 邮件服务器拒绝建立连接，已终止或主动结束该连接。 80C6无法访问连接伙伴（网络错误）。 80C7 执行超时 80C8 正尝试重新建立现有连接。 80C9 连接伙伴验证失败。邮件服务器不对应于Parameter MailServerAddress 定义的伙伴。 80CE 本地接口的 IP 地址为 0.0.0.0。 80D0在尝试使用 DNS 时，MailServerAddress 参数包含一个空字符串。 80D1 MailServerAddress参数不是全限定域名。结尾处的点号可能缺失。 80D2 DNS 服务器的地址未组态。参数 SFB_STATUS （用于背景数 据块(W#16#...)） 说明 80D3 全限定的域名无法解析。可能的原因： • DNS-服务器无法访问，可能服务器已关闭或远程端口不可访问。 • 与 DNS- 服务器进行通信时出错。 • DNS 服务器返回一个有效的DNS 响应，但该响应中未包含 IPv4 地址。 80E0 由于消息出错，与邮件服务器之间的通信失败。可能的原因： •消息认证代码无效 • 消息解码失败。 • 消息解压出错 • 内部容量溢出 80E1 通信握手过程中发生错误。可能的原因： •用户中止该过程 • 安全等级不足 • 不支持重新协商 • 不支持该 SSL/TLS 版本。 • 说明错误 80E2 证书不支持/无效可能的原因：所连接模块的时间日期未设置，或模块未同步。 示例：模块默认的日期设置为 2012 年 1 月 1日，且不是在调试过程中设置的。证书的有效 期从 2016 年 8 月 20 日开始，到 2024 年 8 月 20日结束。此时，模块的日期超出证书的有 效期；该模块的证书无效。 80E3 邮件服务器证书已丢弃。 80E4未找到邮件服务器证书的有效证书颁发机构。 80E5 邮件服务器证书过期。 80E6 Transport-Layer-Security协议出现完整性错误 80E7 不支持邮件服务器证书扩展 80E9 不支持不含服务器证书的 TLS 服务器。