SIEMENS西门子 WinCC V7.2冗余选项 6AV6371-1CF07-2AX0

             TeleService (S7-1200) TM_MAIL：发送电子邮件 (S7-1200) TM_MAIL 说明 (S7-1200) 说明 “TM_MAIL”指令异步执行，即，可通过多次调用执行这一指令。调用“TM_MAIL”指令时必须 指定实例。不得在实例中设置属性“可保持”。该属性确保在 CPU 从 STOP 切换到 RUN 时 初始化该实例，并确保以后可触发新的电子邮件发送作业。 参数 REQ 出现“0”至“1”的上升沿时，将启动电子邮件的发送任务。作业状态由输出参数 “BUSY”、“DONE”、“ERROR”、“STATUS”和“SFC_STATUS”指示。在这种情况下，“SFC_STATUS” 对应于被调用通信块的“STATUS”输出参数。

            如果输出参数 BUSY 的状态由“1”变为“0”，则输出参数 DONE、ERROR、STATUS 和 SFC_STATUS 均仅显示一个周期。下表列出了 BUSY、DONE 和 ERROR 之间的关系。使用该表， 可以确定指令“TM_MAIL”的当前状态，以及电子邮件发送完成的时间。 DONE BUSY ERROR 说明 0 1 0 作业正在处理。 1 0 0 作业已成功完成。 0 0 1 由于出错，导致作业结束。错误原因可以在参数 STATUS 和 SFC_STATUS 中找 到。 0 0 0 没有为“TM_MAIL”指令分配（新）作业。 “TM_MAIL”处于激活状态期间，如果 CPU 转变为 STOP 模式，则至邮件服务器的通信连接将 会终止。如果工业以太网总线发生通信故障，则与邮件服务器的通信连接也会丢失。此时， 电子邮件的传输将中断，将不会到达接收方。 注意 更改用户程序 仅在下列情况下，可以更改直接影响“TM_MAIL”调用的用户程序部分： • CPU 处于“STOP”模式时，或者 • 未发送任何邮件（REQ = 0 且 BUSY = 0）。 这具体是指删除和替换含有“TM_MAIL”调用或者“TM_MAIL”实例调用的程序块。 如果忽略这一限制，可能导致占用连接资源。通过工业以太网的 TPC/IP 通信功能，自动化 系统可能改变为某种不确定的状态。 传送更改之后，需要对 CPU 执行一次暖启动或冷启动。 数据一致性 每次触发电子邮件的发送过程时，都将从“TM_MAIL”指令重新获取该指令的输入参数 ADDR_MAIL_SERVER。如果在操作期间进行了更改，则“新”值仅在电子邮件再次触发时才 会生效。 比较而言，WATCH_DOG_TIME、TO_S、CC、FROM、SUBJECT、TEXT、ATTACHMENT 以及 USERNAME 和 PASSWORD（如果适用）参数在指令“TM_MAIL”运行时从该指令中获取，也就 是说，这些参数仅能在作业完成之后（BUSY = 0）进行修改 设置 TS Adapter IE 的参数 在 TS Adapter IE 上，需要指定呼出拨号的参数，使 TS Adapter IE 可以建立与服务提供商拨 号服务器的连接。如果将连接建立设置为“按需”，则在需要发送电子邮件时才会建立连接。 对于模拟调制解调器连接，连接建立可能需要较长的时间（约 1 分钟）。指定参数 WATCH_DOG_TIME 时，必须为连接建立预留足够的时间。 参数 下表列出了“TM_MAIL”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、D、L 或常量 控制参数 REQUEST：上升沿时激活电子邮件的 发送任务。 ID Input CONN_OU C (Word) D、L 或常量 指向要建立的连接的引用。请参见 TCON (页 5602)、TDISCON (页 5615)、TSEND (页5621) 和TRCV (页5625) 指令的参数 ID。必 须在此输入未在用户程序中用于该指令的任何其 它实例的编号。 TO_S (页 6352) Input STRING D 收件人地址输入参数： Zui大长度为 240 个字符的 STRING（请参见示例 调用）。 CC (页 6352) Input STRING D CC 收件人地址输入参数（可选）：Zui大长度为 240 个字符的 STRING（请参见示例调用）。 如果在此分配空字符串，电子邮件不会发送到 CC 收件人。 SUBJECT Input STRING D 电子邮件主题输入参数： Zui大长度为 240 个字符的 STRING。 TEXT Input STRING D 电子邮件文本输入参数（可选）： 指向数据字符串（Zui大长度为 240 个字符）的 引用。 如果在该参数中分配空字符串，将发送无文本的 电子邮件。 ATTACHMENT Input VARIANT I、Q、M、D、L 电子邮件附件输入参数（可选）：指向字节/字/ 双字字段（Zui大长度为 65534 个字节）的引 用。指定的附件必须为 BIN 文件格式。 如果未分配任何值，将发送无附件的电子邮件。参数 声明 数据类型 存储区 说明 DONE Output BOOL I、Q、M、D、L • DONE = 0：作业未启动，或者仍在执行之 中。 • DONE = 1：作业已执行，且无任何错误。 BUSY Output BOOL I、Q、M、D、L • BUSY = 1：电子邮件的发送尚未完成。 • BUSY = 0：“TM_MAIL”处理已终止 ERROR Output BOOL I、Q、M、D、L ERROR = 1：执行过程中发生错误。有关该类型 错误的详细信息，请参见 STATUS 和 SFC_STATUS。 STATUS (页 6352) Output WORD I、Q、M、D、L 输出/状态参数 STATUS： 指令“TM_MAIL”的返回值或者错误信息。 ADDR_MAIL_S ERVER Static* DWORD I、Q、M、D、L 邮件服务器的 IP 地址输入参数：以十六进制格 式指定一个数据字，例如：IP 地址 = 192.168.0.200。 ADDR_MAIL_SERVER = DW#16#C0A800C8， 其中： • 192 = 16#C0， • 168 =16#A8 • 0 = 16#00 和 • 200 = 16#C8。 WATCH_DOG_ TIME Static* TIME I、Q、M、D、L Zui大持续时间输入参数： 指令“TM_MAIL”应该在 WATCH_DOG_TIME 所定 义的持续时间之内建立连接。若超过了该持续时 间，则该块会因错误而退出。由于连接终止也需 要一定的时间，因此，在该块退出并输出错误信 息之前，其时间有可能超出 WATCH_DOG_TIME。开始时，应该将持续时间 设置为 2 分钟。对于 ISDN 拨号连接，可以选用 更短的持续时间。 USERNAME Static* STRING D 用户名输入参数： Zui大长度为 180 个字符的 STRING。对于授权， 用户名是必须的。 PASSWORD Static* STRING D 密码输入参数： Zui大长度为 180 个字符的 STRING授权密码必 不可少参数 声明 数据类型 存储区 说明 FROM (页 6352) Static* STRING D 发件人地址输入参数： Zui大长度为 240 个字符的 STRING（请参见示例 调用）。 SFC_STATUS (页 6352) Static* WORD I、Q、M、D、L 输出/状态参数“SFC_STATUS”： 被调用通信块的错误信息。 * 每次调用指令“TM_MAIL”时不会修改该参数的值。值位于实例的静态参数中，并且仅在第一次调用该指令时 写入一次。 有关有效数据类型的更多信息，请参见“有效数据类型概述 (页 255)”。 说明 可选参数 仅当可选参数 CC、TEXT 和 ATTACHMENT 包含长度大于 0 的字符串，才会通过电子邮件发 送相应的参数。 说明 参数 ATTACHMENT 指定的附件必须为 BIN 文件格式。可通过以下几种方式传送文本： • 在 Windows 中，将 BIN 文件格式与一个文本编辑器关联在一起。 • 可通过 Windows 功能“发送至”(Send to) 或“打开方式”(Open with)，进行关联。 SMTP 授权 此处，授权指身份确认程序，例如，通过密码查询。 “TM_MAIL”指令支持大部分邮件服务器请求的 SMTP 授权程序 AUTH-LOGIN。有关邮件服务 器授权程序的信息，请参见邮件服务器的使用手册或者 Internet 服务提供商的网站。 要使用授权程序 AUTH-LOGIN，需要为“TM_MAIL”指令提供登录邮件服务器所需的用户名。 该用户名相当于在邮件服务器上建立邮箱帐号时所用的用户名。可以在 USERNAME 参数中为 “TM_MAIL”指令提供该用户名。 若要登录，指令“TM_MAIL”还需要相关密码。该密码相当于建立邮箱帐号时指定的密码。可 以在参数 PASSWORD 中为指令“TM_MAIL”指定。 用户名和密码将以未加密形式分别传输到邮件服务器（BASE64 编码）。 如果数据块内没有指定用户名，则不使用 AUTH-LOGIN 授权程序此时，电子邮箱将以无授 权方式发送。