一、前言
设备调试核心就是将整个系统中的所有打印数据统一显示到一个模块上，一般都会将硬件通信的收发数据和对应的解析信号发出来或者qdebug出来，这个在调试阶段非常有用，可以具体追踪问题出在哪，哪个数据解析不对直接定位过去，这个模块直接留出界面进行打印查看等，可以在各种现场捕捉异常情况，让现场工程师将调试的数据保存好发给开发人员即可，帮助分析问题，因为很多时候是家里公司测试的好好的，到了现场各种千奇百怪的情况都会出现的，开发人员不可能一天到晚在各种现场跑来跑去，太浪费精力了，不如直接做好对应的设备调试模块，捕捉错误数据将日志文件发过来分析。
作为一个做了十年的这种软硬件通信项目开发的人员来说，这种设备调试的模块肯定考虑的比较多，比如可以直接在界面上过滤某个通信端口、某个设备进行捕捉，可以只监听发送数据、接收数据、解析数据等，最关键的一点，可以自由设定关键字进行捕捉，关键字的数据特殊颜色显示，可以设定多个关键字，这样效率大大提高，毕竟设备数据的收发是很快的，刷刷刷的，一秒钟一个屏幕就过去了，设定关键字进行捕捉自动打印不同颜色，防止眼睛疲劳，一眼老远就看到了，多么美好，在这个模块中还可以勾选输出到日志文件，设定最大行数用来自动清空数据，毕竟文本框不能一直加载数据下去，到了最大行数自动清空。
二、功能特点
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等系统。
- 注释完整，项目结构清晰，超级详细完整的使用开发手册，精确到每个代码文件的功能说明，不断持续迭代版本。
三、体验地址
四、效果图
五、核心代码
#include "frmconfigdebug.h"
#include "ui_frmconfigdebug.h"
#include "quiwidget.h"
#include "deviceserver.h"
#include "dblocalthread.h"
#include "dbtcpclientthread.h"
#include "dbreceive.h"
frmConfigDebug::frmConfigDebug(QWidget *parent) : QWidget(parent), ui(new Ui::frmConfigDebug)
{
ui->setupUi(this);
this->initForm();
this->initConfig();
}
frmConfigDebug::~frmConfigDebug()
{
delete ui;
}
void frmConfigDebug::initForm()
{
QFont font;
font.setPixelSize(QUIConfig::FontSize + 5);
ui->txtMain->setFont(font);
ui->frameRight->setFixedWidth(App::RightWidth);
ui->cboxPortName->addItem("所有端口");
ui->cboxPortName->addItems(DBData::PortInfo_PortName);
QUIHelper::setLabStyle(ui->labPortName, 1);
QUIHelper::setLabStyle(ui->labDeviceName, 1);
QUIHelper::setLabStyle(ui->labKeyValue1, 3);
QUIHelper::setLabStyle(ui->labKeyValue2, 3);
QUIHelper::setPushButtonQss(ui->btnClearData);
QUIHelper::setPushButtonQss(ui->btnReadValueAll);
#if (QT_VERSION >= QT_VERSION_CHECK(5,2,0))
ui->txtKeyValue1->setPlaceholderText("支持多个关键字,用 | 隔开");
ui->txtKeyValue2->setPlaceholderText("支持多个关键字,用 | 隔开");
#endif
//颜色下拉框
QStringList colorList = QColor::colorNames();
foreach (QString strColor, colorList) {
QPixmap pix(ui->cboxKeyColor1->iconSize());
pix.fill(strColor);
ui->cboxKeyColor1->addItem(QIcon(pix), strColor);
ui->cboxKeyColor2->addItem(QIcon(pix), strColor);
}
//绑定设备采集服务信号槽
connect(DeviceServer::Instance(), SIGNAL(sendData(QString, quint8, QByteArray)),
this, SLOT(sendData(QString, quint8, QByteArray)));
connect(DeviceServer::Instance(), SIGNAL(receiveData(QString, quint8, QByteArray)),
this, SLOT(receiveData(QString, quint8, QByteArray)));
connect(DeviceServer::Instance(), SIGNAL(receiveInfo(QString, quint8, QString)),
this, SLOT(receiveInfo(QString, quint8, QString)));
connect(DeviceServer::Instance(), SIGNAL(receiveError(QString, quint8, QString)),
this, SLOT(receiveError(QString, quint8, QString)));
}
void frmConfigDebug::initConfig()
{
ui->cboxPortName->setCurrentIndex(App::PortNameIndex);
connect(ui->cboxPortName, SIGNAL(currentIndexChanged(int)), this, SLOT(saveConfig()));
ui->cboxDeviceName->setCurrentIndex(App::DeviceNameIndex);
connect(ui->cboxDeviceName, SIGNAL(currentIndexChanged(int)), this, SLOT(saveConfig()));
keys1 = App::KeyValue1.split("|");
ui->txtKeyValue1->setText(App::KeyValue1);
connect(ui->txtKeyValue1, SIGNAL(textChanged()), this, SLOT(saveConfig()));
ui->cboxKeyColor1->setCurrentIndex(ui->cboxKeyColor1->findText(App::KeyColor1));
connect(ui->cboxKeyColor1, SIGNAL(currentIndexChanged(int)), this, SLOT(saveConfig()));
keys2 = App::KeyValue2.split("|");
ui->txtKeyValue2->setText(App::KeyValue2);
connect(ui->txtKeyValue2, SIGNAL(textChanged()), this, SLOT(saveConfig()));
ui->cboxKeyColor2->setCurrentIndex(ui->cboxKeyColor2->findText(App::KeyColor2));
connect(ui->cboxKeyColor2, SIGNAL(currentIndexChanged(int)), this, SLOT(saveConfig()));
}
void frmConfigDebug::saveConfig()
{
App::PortNameIndex = ui->cboxPortName->currentIndex();
App::DeviceNameIndex = ui->cboxDeviceName->currentIndex();
App::KeyValue1 = ui->txtKeyValue1->toPlainText().trimmed();
App::KeyColor1 = ui->cboxKeyColor1->currentText();
App::KeyValue2 = ui->txtKeyValue2->toPlainText().trimmed();
App::KeyColor2 = ui->cboxKeyColor2->currentText();
if (App::KeyValue1.isEmpty()) {
App::KeyValue1 = "|";
}
if (App::KeyValue2.isEmpty()) {
App::KeyValue2 = "|";
}
App::writeConfig();
keys1 = App::KeyValue1.split("|");
keys2 = App::KeyValue2.split("|");
}
void frmConfigDebug::append(int type, const QString &portName, quint8 addr, const QString &data, bool clear)
{
static int currentCount = 0;
static int maxCount = 500;
//执行清空数据命令
if (clear) {
ui->txtMain->clear();
currentCount = 0;
return;
}
//执行条数到了清空数据
if (currentCount >= maxCount) {
ui->txtMain->clear();
currentCount = 0;
}
//暂停显示
if (ui->ckPause->isChecked()) {
return;
}
//过滤端口
QString currentPortName = ui->cboxPortName->currentText();
if (currentPortName != "所有端口") {
if (currentPortName != portName) {
return;
}
}
//过滤地址
quint8 deviceAddr = ui->cboxDeviceName->itemData(App::DeviceNameIndex).toInt();
if (deviceAddr != 255) {
if (deviceAddr != addr) {
return;
}
}
//过滤回车换行符
QString strData = data;
strData = strData.replace("\r", "");
strData = strData.replace("\n", "");
//不同类型不同颜色显示
QString strType;
if (type == 0) {
strType = "发送";
ui->txtMain->setTextColor(QColor("#009679"));
} else if (type == 1) {
strType = "接收";
ui->txtMain->setTextColor(QColor("#D64D54"));
} else if (type == 2) {
strType = "解析";
ui->txtMain->setTextColor(QColor("#B59481"));
} else if (type == 3) {
strType = "错误";
ui->txtMain->setTextColor(QColor("#A279C5"));
} else if (type == 4) {
strType = "解析";
ui->txtMain->setTextColor(QColor("#047058"));
} else if (type == 5) {
strType = "解析";
ui->txtMain->setTextColor(QColor("#9157C8"));
} else if (type == 6) {
strType = "解析";
ui->txtMain->setTextColor(QColor("#BA5656"));
}
//过滤关键字1,设置不同颜色
foreach (QString key, keys1) {
if (!key.isEmpty() && data.contains(key)) {
ui->txtMain->setTextColor(QColor(App::KeyColor1));
break;
}
}
//过滤关键字2,设置不同颜色
foreach (QString key, keys2) {
if (!key.isEmpty() && data.contains(key)) {
ui->txtMain->setTextColor(QColor(App::KeyColor2));
break;
}
}
QString strAddr = QString("%1").arg(addr, 3, 10, QChar('0'));
strData = QString("%1 %2[%3] %4: %5").arg(TIMEMS).arg(portName).arg(strAddr).arg(strType).arg(strData);
ui->txtMain->append(strData);
currentCount++;
//输出数据
if (ui->ckDebug->isChecked()) {
qDebug() << strData;
}
}
void frmConfigDebug::sendData(const QString &portName, quint8 addr, const QByteArray &data)
{
if (!ui->ckSendData->isChecked()) {
return;
}
append(0, portName, addr, QUIHelper::byteArrayToHexStr(data));
}
void frmConfigDebug::receiveData(const QString &portName, quint8 addr, const QByteArray &data)
{
if (!ui->ckReceiveData->isChecked()) {
return;
}
append(1, portName, addr, QUIHelper::byteArrayToHexStr(data));
}
void frmConfigDebug::receiveInfo(const QString &portName, quint8 addr, const QString &data)
{
if (!ui->ckReceiveInfo->isChecked()) {
return;
}
append(2, portName, addr, data);
}
void frmConfigDebug::receiveError(const QString &portName, quint8 addr, const QString &data)
{
append(3, portName, addr, data);
}
void frmConfigDebug::debugDbLocalThread(const QString &msg)
{
append(4, "本地数据库", 255, msg);
}
void frmConfigDebug::debugDbTcpClientThread(const QString &msg)
{
append(5, "云端数据库", 255, msg);
}
void frmConfigDebug::debugDbReceive(const QString &msg)
{
append(6, "下载数据库", 255, msg);
}
void frmConfigDebug::on_btnClearData_clicked()
{
append(0, "", 255, "", true);
}
void frmConfigDebug::on_btnReadValueAll_clicked()
{
DeviceServer::Instance()->readValueAll();
}
void frmConfigDebug::on_cboxPortName_currentIndexChanged(const QString &arg1)
{
//重新载入该端口对应的所有设备
ui->cboxDeviceName->clear();
ui->cboxDeviceName->addItem("所有设备", 255);
for (int i = 0; i < DBData::DeviceInfo_Count; i++) {
if (DBData::DeviceInfo_PortName.at(i) == arg1) {
QString deviceName = DBData::DeviceInfo_DeviceName.at(i);
quint8 deviceAddr = DBData::DeviceInfo_DeviceAddr.at(i);
ui->cboxDeviceName->addItem(deviceName, deviceAddr);
}
}
}
void frmConfigDebug::on_ckOther_stateChanged(int arg1)
{
on_btnClearData_clicked();
if (arg1 != 0) {
//先解除设备采集服务信号槽
disconnect(DeviceServer::Instance(), SIGNAL(sendData(QString, quint8, QByteArray)),
this, SLOT(sendData(QString, quint8, QByteArray)));
disconnect(DeviceServer::Instance(), SIGNAL(receiveData(QString, quint8, QByteArray)),
this, SLOT(receiveData(QString, quint8, QByteArray)));
disconnect(DeviceServer::Instance(), SIGNAL(receiveInfo(QString, quint8, QString)),
this, SLOT(receiveInfo(QString, quint8, QString)));
disconnect(DeviceServer::Instance(), SIGNAL(receiveError(QString, quint8, QString)),
this, SLOT(receiveError(QString, quint8, QString)));
//绑定其他信号槽
connect(DbLocalThread::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbLocalThread(QString)));
connect(DbTcpClientThread::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbTcpClientThread(QString)));
connect(DbReceive::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbReceive(QString)));
} else {
//先绑定设备采集服务信号槽
connect(DeviceServer::Instance(), SIGNAL(sendData(QString, quint8, QByteArray)),
this, SLOT(sendData(QString, quint8, QByteArray)));
connect(DeviceServer::Instance(), SIGNAL(receiveData(QString, quint8, QByteArray)),
this, SLOT(receiveData(QString, quint8, QByteArray)));
connect(DeviceServer::Instance(), SIGNAL(receiveInfo(QString, quint8, QString)),
this, SLOT(receiveInfo(QString, quint8, QString)));
connect(DeviceServer::Instance(), SIGNAL(receiveError(QString, quint8, QString)),
this, SLOT(receiveError(QString, quint8, QString)));
//解除其他信号槽
disconnect(DbLocalThread::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbLocalThread(QString)));
disconnect(DbTcpClientThread::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbTcpClientThread(QString)));
disconnect(DbReceive::Instance(), SIGNAL(debug(QString)), this, SLOT(debugDbReceive(QString)));
}
}
本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。
