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”指令的参数： 参数 声明 数据类型 存储区 说明 REQInput BOOL I、Q、M、D、L 或常量 控制参数 REQUEST：上升沿时激活电子邮件的 发送任务。 ID InputCONN_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) InputSTRING D CC 收件人地址输入参数（可选）：Zui大长度为 240 个字符的 STRING（请参见示例调用）。如果在此分配空字符串，电子邮件不会发送到 CC 收件人。 SUBJECT Input STRING D 电子邮件主题输入参数：Zui大长度为 240 个字符的 STRING。 TEXT Input STRING D 电子邮件文本输入参数（可选）：指向数据字符串（Zui大长度为 240 个字符）的 引用。 如果在该参数中分配空字符串，将发送无文本的 电子邮件。 ATTACHMENTInput 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、LZui大持续时间输入参数： 指令“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* STRINGD 发件人地址输入参数： 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) 或“打开方式”(Openwith)，进行关联。 SMTP 授权 此处，授权指身份确认程序，例如，通过密码查询。“TM_MAIL”指令支持大部分邮件服务器请求的 SMTP 授权程序 AUTH-LOGIN。有关邮件服务器授权程序的信息，请参见邮件服务器的使用手册或者 Internet 服务提供商的网站。 要使用授权程序AUTH-LOGIN，需要为“TM_MAIL”指令提供登录邮件服务器所需的用户名。该用户名相当于在邮件服务器上建立邮箱帐号时所用的用户名。可以在 USERNAME 参数中为 “TM_MAIL”指令提供该用户名。若要登录，指令“TM_MAIL”还需要相关密码。该密码相当于建立邮箱帐号时指定的密码。可 以在参数 PASSWORD中为指令“TM_MAIL”指定。 用户名和密码将以未加密形式分别传输到邮件服务器（BASE64 编码）。如果数据块内没有指定用户名，则不使用 AUTH-LOGIN 授权程序此时，电子邮箱将以无授 权方式发送。