一、前言
短信告警这个模块在很多项目中都用上了,比如之前做过的安防系统,温湿度报警系统等,主要的流程就是收到数据判断属于某种报警后,组织短信字符串内容,发送到指定的多个手机号码上面,使用的是短信猫硬件设备,其实就是个短信模块,没有使用网络的发送短信的api,毕竟大部分的软件应用场景都不能要求连通外网,安全考虑,所以必须采用本地的硬件来实现发送短信。这个短信猫设备在8年前开始用过,当时用的C#去写了个纯协议解析短信的收发,后面用Qt重新写了个。特意写了个类SendMsgThread封装了所有的操作,这样就通用任何开发环境了,掌握了原理,从底层原理上着手,好处还是很多的,我看很多初学者热衷于去调用第三方厂家封装好的SDK,一旦换了操作系统,完蛋了歇菜,没有嵌入式linux系统的SDK开发包咋搞。
二、功能特点
2.1 软件模块
设备监控模块,包括数据监控(表格形式展示)、设备面板(面板形式展示)、地图监控(地图形式展示)、曲线监控(曲线形式展示)。数据查询模块,包括报警记录、运行记录、操作记录。系统设置模块,包括基本设置、端口管理、控制器管理、探测器管理、报警联动、类型设置等。其他设置模块,包括用户管理、地图管理、位置调整、组态设计、设备调试等。2.2 基础功能
设备数据采集,支持串口、网络,串口可设置串口号、波特率,网络可设置IP地址、通讯端口。每个端口支持采集周期时间,默认1秒钟一个设备。支持设置通讯超时次数,默认3次。支持最大重连时间,用于重新读取离线的设备。控制器信息,能够添加控制器名称,选择控制器地址、控制器型号,设置该控制器下面的探测器数量。探测器信息,能够添加位号、探测器型号、气体种类、气体符号、高报值、低报值、缓冲值、清零值、是否启用、报警声音、背景地图、存储周期、数值换算小数点位数、报警延时时间、报警的类型(HH,LL,HL)等。类型管理可配置控制器型号、探测器型号、气体种类、气体符号等。地图支持导入和删除,所有的探测器在地图上的位置可自由拖动保存。端口信息、控制器信息、探测器信息、类型信息、用户信息等,都支持导入、导出、导出到excel、打印。运行记录、报警记录、操作记录,都支持多条件组合查询,比如时间段、控制器、探测器等,所有记录支持导出到excel/pdf和打印。运行记录、报警记录、操作记录都可删除指定时间范围内的数据。系统设置可选择对应表最大保存记录数,自动清理早期数据,留出足够的空间存储重要的数据。报警短信转发,支持多个接收手机号码,可设定发送间隔,比如即时发送或者6个小时发送一次所有的报警信息,短信内容过长,自动拆分多条短信。报警邮件转发,支持多个接收邮箱,可设定发送间隔,比如即时发送或者6个小时发送一次所有的报警信息,支持附件发送。设置软件的中文标题、英文标题、logo路径、版权所有等。开关设置开机运行、报警声音、自动登录、记住密码等。报警声音可设置播放次数,界面风格样式提供18套皮肤文件选择。用户管理,包括用户权限配置,不同用户可以有不同模块的权限。用户登录和用户退出,可以记住密码和自动登录,超过三次报错提示并关闭程序。四种监控模式,设备面板监控、地图监控、表格数据监控、曲线数据监控,可自由切换,四种模式下都实时展示采集到的数据,报警闪烁等。报警继电器联动,一个位号可以跨串口联动多个模块和继电器号,支持多对多。2.3 特色功能
通信协议支持modbus_com、modbus_tcp_rtu,后期拓展mqtt等协议。数据源除了真实的硬件设备采集,还可选数据库采集,这样用户可以安排其他程序员比如java程序员将前端采集好的数据放到数据库,本系统直接从数据库采集即可。数据库采集模式可以作为通用的系统使用,更适合多人多系统协作。智能跳过超时的设备,加快对在线设备的采集速度,当设备数量很多的时候尤其有用。对智能跳过的超时的设备,在设定的重连时间自动采集一次,以便探测设备是否又重新上线。每个探测器可控是否启用,不启用则不会采集,也不会在界面显示,相当于运行阶段临时关闭。探测器可设置缓冲值和报警延时时间,在该值附近波动产生的报警,不计入报警,只有持续处于报警值且超过报警延时时间才算真正报警,这样可以规避很多波动导致的误报。探测器可设置存储周期,按照设定的时间来存储一条运行记录,可以按照重要程度对重要性高的设定存储周期短一些,不重要的设定大一些,这样可以节省不少的存储空间,也保证了重要的数据及时存储。探测器可设置清零值,在一些高精度高灵敏的设备可能出厂的时候默认值未必是0,需要设定清零值来表示初始值。探测器可设置小数点,用于计算后的真实数据控制小数点点位显示,相当于除以10、除以100、除以1000,这样大部分的探测器数据直接通过小数点位设置控制真实换算后的值,极个别的需要特殊转换的可以在通信协议中约定。探测器报警的类型支持多种,有些设备是高于某个值高报,低于某个值低报,而有些设备是在最小值最大值范围内是高报,低于最小值低报,高于最大值正常。这样可以分情况处理,涵盖各种报警类型。原创数据导入、导出、打印机制,跨平台不依赖任何组件,瞬间导出数据。导出到excel的记录支持所有excel、wps等表格文件版本,不依赖excel等软件。高报颜色、低报颜色、正常颜色、默认值颜色等,都可以自由设置。支持云端数据同步,将本地采集到的数据实时同步到云端。支持网络转发和网络接收,网络接收开启后,软件从udp接收数据进行解析。网络转发支持多个目标IP,这样就实现了本地采集的软件,自由将数据转到客户端,随时查看采集到的数据。自动记住用户最后停留的界面以及其他配置信息,重启后自动应用。报警自动切换到对应的地图,探测器按钮闪烁,表格数据对应颜色显示。双击探测器图标,弹出对应探测器详细信息,可以根据需要定制回控操作。数据库支持多种,包括sqlite、mysql、sqlserver、postgresql、oracle、人大金仓等。本地设备采集到的数据实时上传到云端,以便手机APP或者web等其他方式提取。自带设备模拟工具,支持不同型号的多个设备数据模拟,同时还带数据库数据模拟,以便在没有设备的时候测试数据。标准modbus协议,各种控制器类型、探测器类型、种类、符号等全部自定义,非常灵活和强大,通信协议示例数据非常完整,通用各种modbus协议系统,适用于各种应用场景接入。同时集成了串口通信、网络通信、数据库通信、数据导入导出打印、通信协议解析、界面UI、全局换肤等众多组件和知识点,非常适合新手入门和进阶。支持xp、win7、win10、、win11、linux、mac、各种国产系统(UOS、中标麒麟、银河麒麟等)、嵌入式linux等系统。注释完整,项目结构清晰,超级详细完整的使用开发手册,精确到每个代码文件的功能说明,不断持续迭代版本。三、体验地址
国内站点:/feiyangqingyun国际站点:/feiyangqingyun个人主页:/feiyangqingyun知乎主页:/people/feiyangqingyun产品主页:/feiyangqingyun/article/details/97565652在线文档:https://feiyangqingyun.gitee.io/qwidgetdemo/iotsystem/体验地址:/s/1ZxG-oyUKe286LPMPxOrO2A 提取码:o05q 文件名:bin_iotsystem.zip。文章导航:https://qtchina./article/details/121330922四、效果图
五、核心代码
#include "sendserver.h"#include "quiwidget.h"#include "dbhelper.h"#include "devicehelper.h"#include "sendmsgthread.h"#include "sendemailthread.h"QScopedPointer<SendServer> SendServer::self;SendServer *SendServer::Instance(){if (self.isNull()) {static QMutex mutex;QMutexLocker locker(&mutex);if (self.isNull()) {self.reset(new SendServer);}}return self.data();}SendServer::SendServer(QObject *parent) : QObject(parent){//初始化发送报警短信定时器timerMsg = new QTimer(this);connect(timerMsg, SIGNAL(timeout()), this, SLOT(checkMsg()));changeMsgInterval();//初始化发送报警邮件定时器timerEmail = new QTimer(this);connect(timerEmail, SIGNAL(timeout()), this, SLOT(checkEmail()));changeEmailInterval();}SendServer::~SendServer(){this->stop();}void SendServer::receiveMsgResult(const QString &result){if (App::MsgInterval != 10000) {//DeviceHelper::addMsg(result, 0);DBHelper::addUserLog("设备上报", result);if (result.contains("失败")) {QUIHelper::showMessageBoxError(result, 3);} else {QUIHelper::showMessageBoxInfo(result, 3);}}}void SendServer::receiveEmailResult(const QString &result){if (App::EmailInterval != 10000) {//DeviceHelper::addMsg(result, 0);DBHelper::addUserLog("设备上报", result);if (result.contains("失败")) {QUIHelper::showMessageBoxError(result, 3);} else {QUIHelper::showMessageBoxInfo(result, 3);}}}void SendServer::start(){if (App::MsgInterval != 10000) {QStringList tels = App::MsgTel.split(";");foreach (QString tel, tels) {if (!QUIHelper::isTel(tel)) {//DeviceHelper::addMsg("转发手机号码错误", 0);break;}}}//启动发送报警短信线程发送短信,防止界面卡住if (SendMsgThread::Instance()->open(App::MsgPortName)) {connect(SendMsgThread::Instance(), SIGNAL(receiveResult(QString)), this, SLOT(receiveMsgResult(QString)));SendMsgThread::Instance()->init();SendMsgThread::Instance()->start();//DeviceHelper::addMsg("短信端口打开成功",0);DBHelper::addUserLog("设备上报", "短信端口打开成功");} else {if (App::MsgInterval != 10000) {//DeviceHelper::addMsg("短信端口打开失败",0);DBHelper::addUserLog("设备上报", "短信端口打开失败");}}if (App::MsgInterval != 10000) {if (!QUIHelper::isEmail(App::SendEmailAddr)) {//DeviceHelper::addMsg("发件人邮箱格式错误",0);DBHelper::addUserLog("设备上报", "发件人邮箱格式错误");}QStringList emails = App::ReceiveEmailAddr.split(";");foreach (QString email, emails) {if (!QUIHelper::isEmail(email)) {//DeviceHelper::addMsg("收件人邮箱格式错误",0);DBHelper::addUserLog("设备上报", "收件人邮箱格式错误");break;}}}//启动发送报警邮件线程发送邮件,防止界面卡住connect(SendEmailThread::Instance(), SIGNAL(receiveEmailResult(QString)), this, SLOT(receiveEmailResult(QString)));SendEmailThread::Instance()->setEmialTitle(App::LogoCn + "报警邮件");SendEmailThread::Instance()->setSendEmailAddr(App::SendEmailAddr);SendEmailThread::Instance()->setSendEmailPwd(App::SendEmailPwd);SendEmailThread::Instance()->setReceiveEmailAddr(App::ReceiveEmailAddr);SendEmailThread::Instance()->start();}void SendServer::stop(){timerMsg->stop();timerEmail->stop();}void SendServer::changeMsgInterval(){//如果间隔是0则按照10秒间隔发送,如果是10000则不启动if (App::MsgInterval == 0) {timerMsg->start(10000);} else if (App::MsgInterval == 10000) {timerMsg->stop();} else {timerMsg->start(App::MsgInterval * 60 * 1000);}}void SendServer::changeEmailInterval(){//如果间隔是0秒则按照10秒间隔发送,如果是10000则不启动if (App::EmailInterval == 0) {timerEmail->start(10000);} else if (App::EmailInterval == 10000) {timerEmail->stop();} else {timerEmail->start(App::EmailInterval * 60 * 1000);}}void SendServer::appendMsg(const QString &msg){if (App::MsgInterval <= 1440 && listMsg.count() <= 30) {listMsg << msg;}}void SendServer::appendEmail(const QString &email){if (App::EmailInterval <= 1440 && listEmail.count() <= 30) {listEmail << email;}}void SendServer::append(const QString &content){appendMsg(content);appendEmail(content);}void SendServer::clearMsg(){listMsg.clear();}void SendServer::clearEmail(){listEmail.clear();}void SendServer::checkMsg(){int count = listMsg.count();if (count == 0) {return;}//一条短信最多70个汉字160个全英文数字字符,同时保证是一条完成的报警信息//将要发送的手机号码和短信内容追加到发送报警短信线程中for (int i = 0; i < count; i++) {QString msg = listMsg.takeFirst();QStringList tels = App::MsgTel.split(";");foreach (QString tel, tels) {SendMsgThread::Instance()->append(tel, msg);}}}void SendServer::checkEmail(){int count = listEmail.count();if (count == 0) {return;}//邮件内容,无论多长都可以拼在一起发送,<br>用来换行显示QStringList listContent, listFileName;for (int i = 0; i < count; i++) {QString str = listEmail.takeFirst();if (str.contains("|")) {QStringList list = str.split("|");listContent.append(list.at(0));listFileName.append(list.at(1));} else {listContent.append(str);}}//将字符串转换为表格形式,先取出字段名,然后取出内容//位号: AT-40002 控制器: 1#调度室控制器 探测器: 2#阀站CO 触发值: 78.7 %LEL 类型: 浓度上限报警 时间: -02-24 21:01:30<br>//位号: AT-40003 控制器: 1#调度室控制器 探测器: 3#阀站CO 触发值: 57 %VOL 类型: 浓度下限报警 时间: -02-24 21:01:30<br>//位号: AT-40004 控制器: 1#调度室控制器 探测器: 4#阀站CO 触发值: 88 PPM 类型: 浓度下限报警 时间: -02-24 21:01:30//先取出字段名QString str = listContent.first();QStringList list = str.split(" ");QStringList columnNames;foreach (QString str, list) {columnNames << str.split(": ").first();}//字段宽度QList<int> columnWidth;columnWidth << 150 << 200 << 180 << 130 << 160 << 200;//再遍历取出所有数据QList<QStringList> rowContents;foreach (QString str, listContent) {QStringList list = str.split(" ");QStringList rowContent;foreach (QString temp, list) {rowContent << temp.split(": ").last();}rowContents << rowContent;}//构建html字符串QStringList html;//表格开始html.append("<table border='1' cellspacing='0' cellpadding='3'>");//标题字段名称QString title;for (int i = 0; i < columnNames.count(); i++) {title += QString("<td width='%1' bgcolor='lightgray' align='center' style='vertical-align:middle;'>%2</td>").arg(columnWidth.at(i)).arg(columnNames.at(i));}html.append(QString("<tr>%1</tr>").arg(title));//内容for (int j = 0; j < rowContents.count(); j++) {QString row;QStringList rowContent = rowContents.at(j);for (int i = 0; i < rowContent.count(); i++) {row += QString("<td width='%1' align='center' style='vertical-align:middle;'>%2</td>").arg(columnWidth.at(i)).arg(rowContent.at(i));}html.append(QString("<tr>%1</tr>").arg(row));}//表格结束html.append("</table>");qDebug() << html;//将邮件内容和附件链接追加到发送报警邮件线程中SendEmailThread::Instance()->setSendEmailAddr(App::SendEmailAddr);SendEmailThread::Instance()->setSendEmailPwd(App::SendEmailPwd);SendEmailThread::Instance()->setReceiveEmailAddr(App::ReceiveEmailAddr);SendEmailThread::Instance()->append(html.join(""), listFileName.join(";"));//SendEmailThread::Instance()->append(listContent.join("<br>"), listFileName.join(";"));}