昌吉回族自治州网站建设_网站建设公司_测试上线_seo优化

在工业软件、设备配置工具或上位机系统中，**固件升级（Firmware Upgrade）**是一个非常常见但又容易出问题的功能点。
典型需求包括：

• 调用厂商提供的 Windows DLL 执行升级
• 升级过程不能阻塞 UI
• 实时显示升级进度
• 升级过程中禁止用户误操作
• 升级完成后给出明确反馈

本文通过一个真实工程级示例，完整讲解如何使用Qt + Windows DLL实现一个可靠的固件升级进度弹窗。

一、应用场景说明（为什么要这样做）

在实际项目中，固件升级逻辑通常由硬件厂商提供的 DLL完成，例如：

• LVDS / V-by-One 显示控制器
• FPGA / MCU 配置工具
• 工控采集设备
• 显示驱动板卡升级程序

Qt 作为上位机 UI 层，只负责：

• 加载 DLL
• 调用升级接口
• 显示升级状态
• 控制用户交互

升级过程本身必须在后台线程执行，否则 UI 会卡死。

二、设计思路概览

整体架构如下：

1. 使用LoadLibrary / GetProcAddress动态加载 DLL
2. 在后台线程中调用升级函数
3. 通过定时器轮询 DLL 中的升级进度接口
4. 使用QDialog + QProgressBar显示进度
5. 升级完成后释放 DLL 并允许用户关闭窗口

这是工业软件中最常见、最稳定的一种升级实现方式。

三、DLL 接口定义说明

假设厂商 DLL 中提供如下接口：

// 启动固件升级voidUploadProgram(constchar*filePath);// 查询升级进度（0 ~ 100）intGetUploadProgramSchedule();

Qt 端通过函数指针方式调用。

四、核心实现代码（完整案例）

1. 函数整体结构

voidLVDSVbyOneSignalCollector::firmwareUpInformationBox(QString path)

该函数的职责是：

• 弹出升级对话框
• 启动固件升级
• 显示升级进度
• 等待升级完成

2. 动态加载 DLL

HMODULE hDll=LoadLibraryA("LVDSVbyOneSignalCollectorDLL.dll");if(!hDll){return;}autopUploadProgram=(PFN_UploadProgram)GetProcAddress(hDll,"UploadProgram");autopGetUploadProgramSchedule=(PFN_GetUploadProgramSchedule)GetProcAddress(hDll,"GetUploadProgramSchedule");if(!pUploadProgram||!pGetUploadProgramSchedule){FreeLibrary(hDll);return;}

为什么使用动态加载？

• DLL 由第三方提供
• 可选功能模块
• 避免启动时强依赖
• 方便版本替换

3. 构建升级 UI（不可中断）

QDialog*dialog=newQDialog(nullptr);dialog->setWindowTitle(tr("Firmware Upgrade"));dialog->setWindowModality(Qt::ApplicationModal);dialog->setFixedSize(360,140);// 禁止右上角关闭dialog->setWindowFlags(dialog->windowFlags()&~Qt::WindowCloseButtonHint);

这是一个应用级模态窗口，升级过程中用户无法操作主界面。

4. UI 元素布局

QLabel*label=newQLabel(tr("Upgrading firmware, please wait..."),dialog);QProgressBar*progressBar=newQProgressBar(dialog);progressBar->setRange(0,100);progressBar->setValue(0);QPushButton*btnOk=newQPushButton(tr("OK"),dialog);btnOk->setEnabled(false);

升级未完成前，OK 按钮不可点击，避免误关闭。

5. 后台线程执行升级（关键）

QFuture<void>future=QtConcurrent::run([=](){pUploadProgram(rInfor.filePath);});

这里使用QtConcurrent::run的目的非常明确：

• 避免 UI 阻塞
• 升级逻辑与界面解耦
• 不需要手写 QThread

这是 Qt 工程中推荐的做法之一。

6. 使用 QTimer 轮询升级进度

QTimer*timer=newQTimer(dialog);QObject::connect(timer,&QTimer::timeout,dialog,[=](){intvalue=pGetUploadProgramSchedule();// 0~100progressBar->setValue(value);if(future.isFinished()){timer->stop();progressBar->setValue(100);label->setText(tr("Firmware upgrade completed."));btnOk->setEnabled(true);FreeLibrary(hDll);}});timer->start(300);

这种设计的优点：

• 不需要 DLL 回调
• 逻辑简单、稳定
• 工业项目中极其常见

7. 升级完成后退出

QObject::connect(btnOk,&QPushButton::clicked,dialog,[=](){dialog->accept();dialog->deleteLater();});

只有在升级完成后，用户才能关闭窗口。

五、工程级注意事项（非常重要）

1️⃣ 文件路径生命周期问题

std::string str=path.toStdString();rInfor.filePath=str.c_str();

如果 DLL 在内部异步使用该指针，这里存在风险。
更安全的方式是保证字符串长期有效（如成员变量或深拷贝）。

2️⃣ DLL 卸载时机

FreeLibrary必须确保：

• 升级线程完全结束
• DLL 内部没有残留线程

否则可能导致随机崩溃。

3️⃣ 建议增加失败与超时处理

生产环境中建议补充：

• 升级失败状态
• 超时检测
• 错误码提示
• 日志记录

六、总结

本文通过一个真实工业项目中的固件升级案例，展示了：

• Qt 如何调用 Windows DLL
• 如何在后台线程执行耗时任务
• 如何安全地显示升级进度
• 如何设计不可中断的升级 UI

这种结构在工业上位机 / 设备工具 / 显示控制软件中非常通用，具有很高的工程参考价值。

voidLVDSVbyOneSignalCollector::firmwareUp(){QMessageBox msgBox;msgBox.setWindowTitle("提示");msgBox.setText("你确定要继续吗？");msgBox.setIcon(QMessageBox::Question);msgBox.setStandardButtons(QMessageBox::Ok|QMessageBox::Cancel);msgBox.button(QMessageBox::Ok)->setText("更新");msgBox.button(QMessageBox::Cancel)->setText("取消");intret=msgBox.exec();if(ret==QMessageBox::Ok){qDebug()<<"用户点击了确定按钮";QString path=ui.lineEdit_bootPath->text();QFileInfofileInfo(path);if(fileInfo.exists()){if(fileInfo.isDir()){qDebug()<<"路径是有效的目录";}elseif(fileInfo.isFile()){qDebug()<<"路径是有效的文件";}}else{qDebug()<<"路径无效";QMessageBox::information(this,"path",QString("The path is invalid."));return;}firmwareUpInformationBox(path);}elseif(ret==QMessageBox::Cancel){qDebug()<<"用户点击了关闭按钮";}}voidLVDSVbyOneSignalCollector::firmwareUpInformationBox(QString path){HMODULE hDll=LoadLibraryA("LVDSVbyOneSignalCollectorDLL.dll");if(!hDll){return;}PFN_UploadProgram pUploadProgram=(PFN_UploadProgram)GetProcAddress(hDll,"UploadProgram");PFN_GetUploadProgramSchedule pGetUploadProgramSchedule=(PFN_GetUploadProgramSchedule)GetProcAddress(hDll,"GetUploadProgramSchedule");if(!pUploadProgram||!pGetUploadProgramSchedule){FreeLibrary(hDll);return;}std::string str=path.toStdString();rInfor.filePath=str.c_str();/* ================== UI ================== */QDialog*dialog=newQDialog(nullptr);dialog->setWindowTitle(tr("Firmware Upgrade"));dialog->setWindowModality(Qt::ApplicationModal);dialog->setFixedSize(360,140);// 禁止关闭dialog->setWindowFlags(dialog->windowFlags()&~Qt::WindowCloseButtonHint);QLabel*label=newQLabel(tr("Upgrading firmware, please wait..."),dialog);QProgressBar*progressBar=newQProgressBar(dialog);progressBar->setRange(0,100);progressBar->setValue(0);QPushButton*btnOk=newQPushButton(tr("OK"),dialog);btnOk->setEnabled(false);// 完成前不可点击QVBoxLayout*layout=newQVBoxLayout(dialog);layout->addWidget(label);layout->addWidget(progressBar);layout->addWidget(btnOk,0,Qt::AlignRight);dialog->setLayout(layout);dialog->show();/* ================== 后台线程 ================== */QFuture<void>future=QtConcurrent::run([=](){pUploadProgram(rInfor.filePath);});/* ================== 进度轮询 ================== */QTimer*timer=newQTimer(dialog);QObject::connect(timer,&QTimer::timeout,dialog,[=](){intvalue=pGetUploadProgramSchedule();// 0~100progressBar->setValue(value);if(future.isFinished()){timer->stop();progressBar->setValue(100);label->setText(tr("Firmware upgrade completed."));btnOk->setEnabled(true);FreeLibrary(hDll);}});timer->start(300);/* ================== 完成后退出 ================== */QObject::connect(btnOk,&QPushButton::clicked,dialog,[=](){dialog->accept();dialog->deleteLater();});}