1. 项目概述：基于Qt与STM32的Modbus-TCP远程控制系统
这个项目实现了一套完整的工业控制通信系统，由Qt开发的上位机作为Modbus-TCP主站，STM32作为从站设备，支持Modbus协议中的01（读取线圈状态）、02（读取离散输入）、03（读取保持寄存器）、04（读取输入寄存器）、05（写单个线圈）、06（写单个寄存器）等基础功能码。在实际工业场景中，这种架构常用于设备监控、数据采集和远程控制，比如生产线设备状态监测、智能楼宇控制系统等。
我最初开发这套系统是为了解决某自动化产线上PLC与HMI之间的通信问题。传统方案采用RS485总线，布线复杂且传输距离受限，改用TCP/IP网络后，不仅实现了百米级稳定通信，还能通过路由器扩展至整个厂区网络。系统核心价值在于：Qt上位机提供友好的人机界面和数据处理能力，STM32负责实时响应控制指令，两者通过标准Modbus-TCP协议交互，既保证了兼容性又提升了系统扩展性。
2. 系统架构设计与技术选型
2.1 整体通信架构
系统采用典型的主从式结构：
code复制[Qt上位机] ←TCP/IP→ [路由器/交换机] ←以太网→ [STM32从机]
- 网络层：基于标准TCP/IP协议栈，端口号固定为502（Modbus-TCP默认端口）
- 应用层：遵循Modbus Application Protocol (MBAP)规范
- 物理连接：上位机通过网线接入局域网，STM32使用内置ETH接口或外置W5500等模块
2.2 硬件选型要点
STM32端推荐配置：
- 主控芯片：STM32F407/F429（自带MAC控制器）或STM32F103+W5500方案
- PHY芯片：DP83848、LAN8720等常用型号
- 电路设计：注意RJ45接口的变压器选型，推荐使用HR911105A等集成磁耦的插座
- 电源设计：网络接口需隔离电源，建议使用B0505S等DC-DC隔离模块
2.3 软件框架对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| 裸机+LWIP | 资源占用小(约30KB RAM) | 开发复杂度高 |
| FreeRTOS+LWIP | 任务管理方便 | 需要额外学习RTOS |
| HAL库+NetX Duo | 图形化配置方便 | 仅支持STM32CubeIDE |
最终选择FreeRTOS+LWIP方案，因其在STM32CubeMX中可快速配置，且社区资源丰富。
3. Qt上位机实现细节
3.1 Modbus-TCP主站开发
使用Qt自带的QModbusTcpClient类实现核心通信功能：
cpp复制// 创建Modbus客户端实例
QModbusTcpClient *modbusDevice = new QModbusTcpClient(this);
modbusDevice->setConnectionParameter(QModbusDevice::NetworkPortParameter, 502);
modbusDevice->setConnectionParameter(QModbusDevice::NetworkAddressParameter, "192.168.1.100");
modbusDevice->setTimeout(1000); // 1秒超时
// 发送读取请求示例
QModbusDataUnit readUnit(QModbusDataUnit::HoldingRegisters, 0, 10);
if (auto *reply = modbusDevice->sendReadRequest(readUnit, 1)) {
if (!reply->isFinished())
connect(reply, &QModbusReply::finished, this, &MainWindow::handleReadResponse);
else
delete reply;
}
关键参数说明：
NetworkAddressParameter：从机IP地址，需与STM32端设置一致Unit Identifier：从机地址（示例中为1），对应Modbus-RTU的站号Start Address：寄存器起始地址，需与从机程序匹配
3.2 数据可视化设计
推荐采用QCustomPlot库实现实时曲线显示：
cpp复制// 初始化曲线
QCPGraph *graph = ui->customPlot->addGraph();
graph->setPen(QPen(Qt::blue));
graph->setBrush(QBrush(QColor(0, 0, 255, 20)));
// 更新数据
void MainWindow::updatePlot(QVector<double> values) {
static QVector<double> xData, yData;
xData.append(QDateTime::currentDateTime().toMSecsSinceEpoch()/1000.0);
yData.append(values[0]);
ui->customPlot->graph(0)->setData(xData, yData);
ui->customPlot->rescaleAxes();
ui->customPlot->replot();
}
4. STM32从机实现详解
4.1 LWIP协议栈配置
通过STM32CubeMX配置以太网参数：
- 在Pinout界面启用ETH外设
- 配置PHY地址（LAN8720通常为0）
- 设置MAC地址（需保证局域网内唯一）
- 生成代码后检查lwipopts.h中的关键参数：
c复制#define MEM_SIZE (16*1024) // 内存池大小
#define TCPIP_THREAD_STACKSIZE 1024 // TCP/IP线程栈大小
#define DEFAULT_ACCEPTMBOX_SIZE 6 // 并发连接数
4.2 Modbus协议处理核心
建议采用开源的FreeMODBUS协议栈进行移植：
c复制// 寄存器映射示例
uint16_t usRegHoldingBuf[REG_HOLDING_NREGS] = {0};
// 回调函数实现
eMBErrorCode eMBRegHoldingCB(UCHAR *pucRegBuffer, USHORT usAddress,
USHORT usNRegs, eMBRegisterMode eMode) {
if ((usAddress + usNRegs) > REG_HOLDING_NREGS)
return MB_ENOREG;
if (eMode == MB_REG_READ) {
while (usNRegs--) {
*pucRegBuffer++ = (UCHAR)(usRegHoldingBuf[usAddress] >> 8);
*pucRegBuffer++ = (UCHAR)(usRegHoldingBuf[usAddress] & 0xFF);
usAddress++;
}
} else { // 写操作
while (usNRegs--) {
usRegHoldingBuf[usAddress] = *pucRegBuffer++ << 8;
usRegHoldingBuf[usAddress] |= *pucRegBuffer++;
usAddress++;
}
}
return MB_ENOERR;
}
5. 系统联调与性能优化
5.1 通信稳定性测试
建议使用以下测试方案：
- 压力测试：连续发送1000个请求，统计丢包率
python复制# Python测试脚本示例 from pyModbusTCP.client import ModbusClient client = ModbusClient(host="192.168.1.100", port=502) success = 0 for i in range(1000): if client.write_single_register(0, i): success +=1 print(f"成功率: {success/10}%") - 长连接测试：保持连接24小时，监测内存泄漏
- 异常测试：随机断开网线，验证重连机制
5.2 性能优化技巧
- TCP窗口调整：修改lwipopts.h中的
TCP_WND和TCP_SND_BUFc复制#define TCP_WND (4 * TCP_MSS) // 默认2144字节 #define TCP_SND_BUF (2 * TCP_MSS) // 发送缓冲区 - Qt线程优化：将Modbus通信放在子线程中
cpp复制class ModbusThread : public QThread { void run() override { QModbusTcpClient modbus; // ...通信逻辑 } }; - STM32中断优化：在ETH中断中快速处理数据包
c复制void HAL_ETH_RxCpltCallback(ETH_HandleTypeDef *heth) { osSignalSet(ethTaskHandle, ETH_RX_SIGNAL); // 通知LWIP任务 }
6. 常见问题与解决方案
6.1 连接建立失败
现象：Qt端报错"Connection refused"
- 检查STM32是否正常启动TCP服务（netstat -a查看502端口）
- 验证IP地址冲突（ping测试）
- 确认防火墙未拦截502端口（特别是Windows Defender）
6.2 数据响应超时
排查步骤：
- 用Wireshark抓包分析通信过程
- 检查STM32的PHY芯片Link状态（LED指示灯）
- 测量网络延迟（ping -t观察抖动）
6.3 寄存器地址错乱
典型原因：
- Qt和STM32的地址偏移不一致（Modbus协议有0-based和1-based两种）
- 大小端模式不匹配（STM32默认小端，需统一处理）
解决方案：
c复制// 统一使用大端格式
uint16_t reg_value = __REV(usRegHoldingBuf[addr]);
7. 项目扩展方向
7.1 安全增强
- 实现Modbus-TCP Security（TLS加密）
- 添加访问白名单功能
- 使用HMAC进行报文认证
7.2 云端集成
通过MQTT协议转发数据到云平台：
cpp复制// Qt端示例
void publishModbusData() {
QMqttClient client;
client.setHostname("iot.example.com");
client.connectToHost();
QModbusReply *reply = modbusDevice->sendReadRequest(...);
connect(reply, &QModbusReply::finished, [&]() {
client.publish("modbus/data", QJsonDocument(data).toJson());
});
}
7.3 多从机管理
开发设备扫描功能自动发现网络中的从机：
cpp复制void scanDevices(QString subnet) {
for (int i=1; i<255; i++) {
QString ip = subnet + QString::number(i);
QModbusTcpClient testClient;
testClient.setConnectionParameter(..., ip);
if (testClient.connectDevice()) {
emit deviceFound(ip);
testClient.disconnectDevice();
}
}
}
在开发过程中，最容易被忽视的是网络字节序问题。我曾遇到一个案例：上位机显示的温度值总是比实际高256倍，最终发现是STM32端没有对浮点数进行正确的字节序转换。建议在项目初期就建立完善的测试用例，特别是边界值测试（如寄存器地址0xFFFF、浮点数NaN等特殊值）。