SIEMENS西门子 ET200SP输出模块 6ES71326BD200DA0

              AS_MAIL： 发送电子邮件 (S7-300, S7-400) AS_MAIL 说明 (S7-300, S7-400) 所需指令 指令“AS_MAIL”使用简单邮件传输协议（SMTP），将电子邮件从 CPU 传输至邮件服务器。为 了运行“AS_MAIL”，需要使用以下指令： • "S_COMP： 比较字符串 (页 7637)" • "FIND： 在字符串中查找字符 (页 7650)" • "INSERT： 在字符串中插入字符 (页 7648)" • "LEFT： 读取字符串左边的字符 (页 7645)" • "LEN： 确定字符串的长度 (页 7644)" • "RIGHT： 读取字符串右边的字符 (页 7646)" 说明 "AS_MAIL" 指令为异步执行，也就是说，它的执行可以延长并跨越多个调用。调用“AS_MAIL” 指令时，必须指定一个背景数据块。 调用 COM_RST = 1，完成块的初始化工作。 参数 REQ 出现“0”至“1”的上升沿时，将启动电子邮件的发送任务。 TS 适配器从已连接的调制解调器收到一条不确 定的错误消息。 检查是否连接了 GSM 无线调制解调器。 Cxxx “SMS_SEND”的执行因 GSM 调制解调器的错误 代码而被终止。 xxx：错误编号 关于错误编号表，请参见无线调制解调器的 手册或者 GSM 标准 GSM 04.11、GSM 03.40 和 GSM 07.05。 示例： • C136 = GSM 调制解调器中未检测到 SIM 卡 • C137 = GSM 调制解调器的 PIN 不正确 （参见将 PIN 传送到无线调制解调器） • C001 = 服务中心电话号码错误。

              作业状态由 BUSY、“DONE”、“ERROR”、“STATUS”和“SFC_STATUS”输出参数指示。 "这种情况 下，“SFC_STATUS”相当于被调用通信块或者指令“BLKMOV”的输出参数“STATUS”。 如果输出参数 BUSY 的状态由“1”变为“0”，则输出参数 DONE、ERROR、STATUS 和 SFC_STATUS 均仅显示一个周期。 下表列出了 BUSY、DONE 和 ERROR 之间的关系。 使用该表，可以确定指令“AS_MAIL”的当 前状态，或者电子邮件的发送完成时间。 BUSY DONE ERROR 说明 1 无关 无关 作业正在处理。 0 1 0 作业已成功完成。 0 0 1 由于出错，导致作业结束。 错误原因可以在参数 STATUS 和 SFC_STATUS 中找到。 0 0 0 没有为“AS_MAIL”指令分配（新）作业。 “AS_MAIL”处于激活状态期间，如果 CPU 转变为 STOP 模式，则至邮件服务器的通信连接将 会终止。如果工业以太网总线出现通信故障，至邮件服务器的通信连接也会丢失。这种情况 下，电子邮件的传送将被中断，电子邮件将不会送至收件人。 注意 更改用户程序 可以更改直接影响“AS_MAIL”调用的用户程序部分的时机： • CPU 处于 STOP 模式时，或者 • 未发送任何邮件（REQ = 0 且 BUSY = 0）。 这尤其涉及含有“AS_MAIL”调用或者“AS_MAIL”背景数据块调用的程序块的删除和替换操作。 如果忽略这一限制，可能导致占用连接资源。 通过工业以太网的 TPC/IP 通信功能，自动化 系统可能改变为某种不确定的状态。 传输更改后，在 CPU 上执行一次暖启动或者冷启动，或者将指令“AS_MAIL”的参数 COM_RST 设置为“1”。 数据一致性 每次触发电子邮件的发送过程时，指令“AS_MAIL”都会重复使用该指令的输入参数 ADDR_MAIL_SERVER。如果在操作期间进行了更改，则“新”值仅在电子邮件再次触发时才 会生效。与此相反的是，WATCH_DOG_TIME、TO_S、CC、FROM、SUB、TEXT、ATTACHMENT 和 （如果适用）USERNAME 与 PASSWORD 参数设置的修改会在指令“AS_MAIL”运行期间立即应 用。这意味着，这些参数仅能在作业完成之后（BUSY = 0）才能修改。 设置 TS Adapter IE 的参数 在 TS Adapter IE 上，需要指定呼出拨号的参数，使 TS Adapter IE 可以建立与服务提供商拨 号服务器的连接。 如果将连接建立设置为“按需”，则在需要发送电子邮件时才会建立连接。 对于模拟调制解调器连接，连接建立可能需要较长的时间（约 1 分钟）。 指定参数 WATCH_DOG_TIME 时，必须为连接建立预留足够的时间。 参数 指令“AS_MAIL”的参数如下表所示： 参数 声明 数据类型 存储区 说明 COM_RST Input / Output BOOL I、Q、M、D、L 输入/输出参数“COMPLETE”： RESTART：该块有一个初始化程序。输入 COM_RST 被置位后，就会执行该程序。 指令“AS_MAIL”的参数 COM_RST 必须被设 置为“1”： • 在首次调用之前，以及 • 每次重新装载相应的背景数据块时。 初始化之后，指令“AS_MAIL”，会复位 COM_RST 参数。 REQ Input BOOL I、Q、M、D、L 控制参数 REQUEST： 上升沿时激活电子邮 件的发送任务。 ADDR_MAIL_ SERVER Input DWORD I、Q、M、D、L 邮件服务器的 IP 地址输入参数： 以十六进 制格式指定一个数据字，参数 声明 数据类型 存储区 说明 WATCH_DOG_ TIME Input TIME I、Q、M、D、L Zui大持续时间输入参数： 指令“AS_MAIL”应该在 WATCH_DOG_TIME 所定义的持续时间之内建立连接。若超过了 该持续时间，则该块会因错误而退出。由于 连接终止也需要一定的时间，因此，在该块 退出并输出错误信息之前，其时间有可能超 出 WATCH_DOG_TIME。开始时，应该将持 续时间设置为 2 分钟。 对于 ISDN 拨号连 接，可以选用更短的持续时间。 USERNAME Input ANY D 用户名输入参数： 指向 STRING 类型变量（Zui大长度为 180 个 字符）的引用。 对于授权，用户名是必须 的。 PASSWORD Input ANY D 密码输入参数： 指向 STRING 类型变量（Zui大长度为 180 个 字符）的引用。 授权密码必不可少。 TO_S Input ANY D 收件人地址输入参数： 指向 STRING 类型变量（Zui大长度为 240 个 字符）的引用（请参见调用示例）。 CC Input ANY D 抄送收件人地址输入参数： 指向 STRING 类型变量（Zui大长度为 240 个 字符）的引用（请参见调用示例）。 FROM Input ANY D 发件人地址输入参数： 指向 STRING 类型变量（Zui大长度为 240 个 字符）的引用（请参见调用示例）。 SUB Input ANY D 电子邮件主题输入参数： 指向 STRING 类型变量（Zui大长度为 240 个 字符）的引用。 TEXT Input ANY D 电子邮件文本输入参数。 指向数据字符串（Zui大长度为 240 个字符） 的引用。 ATTACHMENT Input ANY I、Q、M、D、L 电子邮件附件输入参数： 指向字节/字/双字字段（Zui大长度为 65534 个字节）的引用。参数 声明 数据类型 存储区 说明 BUSY Output BOOL I、Q、M、D、L • BUSY = 1：电子邮件传送尚未完成。 • BUSY=0：“AS_MAIL”的处理已停止。 DONE Output BOOL I、Q、M、D、L • DONE = 0：作业未启动，或仍在执行。 • DONE = 1：作业已成功执行完毕。 ERROR Output BOOL I、Q、M、D、L ERROR=1：处理期间出错。STATUS 和 SFC_STATUS 提供了有关该类型错误的详细 信息。 STATUS (页 9452) Output INT I、Q、M、D、L 输出/状态参数 STATUS： 指令“AS_MAIL”的返回值或者错误信息。 SFC_STATUS (页 9452) Output INT I、Q、M、D、L 输出/状态参数“SFC_STATUS”： 已调用的通信块或者指令“BLKMOV”的错误 信息。 有关有效数据类型的更多详细信息，请参见“有效数据类型概述 (页 255)”。 说明 关于指令参数的说明 • 在调用“AS_MAIL”的块内，如果删除、重新输入或者更改了 USERNAME 和 PASSWORD 的参数 分配，则仅当重新加载了相应的背景数据块或者设置了参数 COM_RST 之后，该更改才生效。 否则，指针仍然会指向背景数据块内的相应参数。 • 考虑到运行时间和存储空间的开销，对于参数 TO_S、CC 和 FROM，“AS_MAIL”指令不执行任 何语法检查。 请注意该参数的正确语法。 • 对于可选参数 CC、TEXT 和 ATTACHMENT，如果它们在调用指令“AS_MAIL”的块内完成了赋 值，则它们仅能采用电子邮件进行发送。 如果指令“AS_MAIL”的调用接口删除了此类赋值，只 有重新加载相应的背景数据块且置位了参数 COM_RST 之后，这种更改才生效。 否则，该指 针仍指向实例 DB 内的相应参数。 请注意，参数赋值中不允许使用空字符串。 • 如果参数 ATTACHMENT 指向数据块内的某个数组、且更改并保存了该数组的大小，则参数 ATTACHMENT 的 ANY 指针必须再次进入指令“AS_MAIL”的接口内。 SMTP 授权 此处，授权指身份确认程序，例如，通过密码查询。 指令“AS_MAIL”支持 SMTP 授权程序 AUTH-LOGIN，绝大多数邮件服务器要求使用该授权程序。 有关邮件服务器授权程序的信息，请参见邮件服务器的使用手册或者 Internet 服务提供商的 网站。