Qt与STM32蓝牙小车串口通信开发指南
1. 项目背景与核心需求
在嵌入式开发领域，上位机与下位机的通信是常见需求。基于Qt开发串口上位机控制蓝牙小车，是一个典型的嵌入式控制案例。这种方案结合了Qt强大的跨平台GUI能力与STM32的高效实时控制特性，广泛应用于智能小车、机器人控制等场景。
蓝牙通信本质上是通过虚拟串口实现的，这使得我们可以用串口通信的方式来处理蓝牙数据传输。Qt提供了完善的串口通信类QSerialPort，能够方便地实现与STM32的通信。这种架构下，上位机负责发送控制指令和接收传感器数据，下位机则执行具体控制逻辑。
2. 开发环境搭建
2.1 Qt开发环境配置
首先需要安装Qt开发环境。推荐使用Qt 5.15 LTS版本，它提供了长期支持且稳定性好。安装时务必勾选以下组件：
- Qt Creator（集成开发环境）
- Qt Charts（用于数据显示可视化）
- 对应平台的编译工具链（如MinGW或MSVC）
安装完成后，需要配置串口支持模块。在项目.pro文件中添加：
QT += serialport charts widgets2.2 STM32开发环境准备
下位机端需要准备：
- STM32CubeMX：用于生成初始化代码
- Keil MDK或STM32CubeIDE：用于编译和调试
- 蓝牙模块驱动：如HC-05或HC-06的AT指令集文档
建议使用STM32F103C8T6这类性价比较高的芯片，它内置了USART接口，可以直接连接蓝牙模块。
3. 通信协议设计
3.1 数据帧格式定义
为了保证通信可靠性，需要设计简单的通信协议。一个典型的控制帧可以这样定义：
| 字节位置 | 内容 | 说明 |
|---|---|---|
| 0 | 0xAA | 帧头标识符 |
| 1 | 指令类型 | 0x01:前进 0x02:后退等 |
| 2 | 数据长度 | 后续数据字节数 |
| 3~N | 数据内容 | 具体控制参数 |
| N+1 | 校验和 | 前面所有字节的异或和 |
3.2 蓝牙模块配置
常见的HC-05蓝牙模块需要先通过AT指令进行配置：
AT+NAME=MyCar // 设置设备名称 AT+PSWD=1234 // 设置配对密码 AT+UART=115200,0,0 // 设置串口参数配置完成后，模块会以从机模式工作，等待上位机连接。
4. Qt上位机实现
4.1 串口通信核心代码
// 初始化串口 QSerialPort *serial = new QSerialPort(this); serial->setPortName("COM3"); // 根据实际情况修改 serial->setBaudRate(QSerialPort::Baud115200); serial->setDataBits(QSerialPort::Data8); serial->setParity(QSerialPort::NoParity); serial->setStopBits(QSerialPort::OneStop); if(!serial->open(QIODevice::ReadWrite)) { qDebug() << "串口打开失败:" << serial->errorString(); return; } // 连接信号槽 connect(serial, &QSerialPort::readyRead, this, &MainWindow::readData);4.2 数据发送函数实现
void MainWindow::sendCommand(uchar cmd, uchar len, QByteArray data) { QByteArray frame; frame.append(0xAA); // 帧头 frame.append(cmd); // 指令 frame.append(len); // 数据长度 if(len > 0) { frame.append(data); } // 计算校验和 uchar checksum = 0; for(int i=0; i<frame.size(); i++) { checksum ^= frame.at(i); } frame.append(checksum); // 发送数据 if(serial->isOpen()) { serial->write(frame); } }4.3 数据接收处理
void MainWindow::readData() { static QByteArray buffer; buffer.append(serial->readAll()); // 查找帧头 int headPos = buffer.indexOf(0xAA); if(headPos < 0) { buffer.clear(); return; } // 检查数据长度是否足够 if(buffer.size() - headPos < 4) { return; // 等待更多数据 } uchar len = buffer.at(headPos + 2); if(buffer.size() - headPos < 4 + len) { return; } // 提取完整帧 QByteArray frame = buffer.mid(headPos, 4 + len); buffer = buffer.mid(headPos + 4 + len); // 校验 uchar checksum = 0; for(int i=0; i<frame.size()-1; i++) { checksum ^= frame.at(i); } if(checksum != frame.at(frame.size()-1)) { qDebug() << "校验失败"; return; } // 处理有效数据 processFrame(frame); }5. STM32下位机实现
5.1 串口初始化
使用STM32CubeMX配置USART：
- 启用USART1/2/3（根据实际硬件）
- 配置波特率为115200
- 启用接收中断
- 生成代码
5.2 接收中断处理
#define FRAME_HEADER 0xAA uint8_t rxBuffer[64]; uint8_t rxIndex = 0; uint8_t frameLen = 0; uint8_t dataLen = 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { static uint8_t state = 0; uint8_t rxByte = rxBuffer[rxIndex]; switch(state) { case 0: // 等待帧头 if(rxByte == FRAME_HEADER) { state = 1; frameLen = 0; rxBuffer[frameLen++] = rxByte; } break; case 1: // 获取指令 rxBuffer[frameLen++] = rxByte; state = 2; break; case 2: // 获取数据长度 dataLen = rxByte; rxBuffer[frameLen++] = rxByte; state = (dataLen > 0) ? 3 : 4; break; case 3: // 接收数据 rxBuffer[frameLen++] = rxByte; if(frameLen >= 3 + dataLen) { state = 4; } break; case 4: // 校验 uint8_t checksum = 0; for(int i=0; i<frameLen; i++) { checksum ^= rxBuffer[i]; } if(checksum == rxByte) { processCommand(rxBuffer[1], dataLen, &rxBuffer[3]); } state = 0; frameLen = 0; break; } rxIndex = (rxIndex + 1) % sizeof(rxBuffer); HAL_UART_Receive_IT(huart, &rxBuffer[rxIndex], 1); }5.3 电机控制实现
void controlMotor(uint8_t cmd, uint8_t speed) { switch(cmd) { case 0x01: // 前进 HAL_GPIO_WritePin(MOTOR1_IN1_GPIO_Port, MOTOR1_IN1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(MOTOR1_IN2_GPIO_Port, MOTOR1_IN2_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(MOTOR2_IN1_GPIO_Port, MOTOR2_IN1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(MOTOR2_IN2_GPIO_Port, MOTOR2_IN2_Pin, GPIO_PIN_RESET); break; case 0x02: // 后退 HAL_GPIO_WritePin(MOTOR1_IN1_GPIO_Port, MOTOR1_IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(MOTOR1_IN2_GPIO_Port, MOTOR1_IN2_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(MOTOR2_IN1_GPIO_Port, MOTOR2_IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(MOTOR2_IN2_GPIO_Port, MOTOR2_IN2_Pin, GPIO_PIN_SET); break; // 其他控制指令... } // 设置PWM占空比控制速度 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, speed); __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_2, speed); }6. 调试与优化
6.1 常见问题排查
串口无法打开：
- 检查设备管理器确认COM口号
- 确保没有其他程序占用串口
- 检查蓝牙模块是否已配对
数据接收不完整：
- 确认双方波特率设置一致
- 检查硬件连接是否稳定
- 增加接收超时处理机制
控制响应延迟：
- 优化数据帧长度
- 增加数据校验重传机制
- 检查STM32中断优先级设置
6.2 性能优化建议
- 使用DMA方式传输数据，减轻CPU负担
- 实现数据压缩，减少传输量
- 添加心跳包机制检测连接状态
- 实现数据缓存队列，处理突发数据
7. 功能扩展思路
实时数据显示： 使用Qt Charts模块实现速度、距离等数据的实时曲线显示
路径记录与回放： 添加SD卡模块，记录小车运动轨迹
摄像头监控： 通过WiFi模块传输实时视频流
自动避障： 添加超声波或红外传感器实现自动避障功能
在实际项目中，我发现蓝牙通信的稳定性对整体性能影响很大。建议在关键控制指令上添加应答机制，确保指令可靠执行。另外，Qt的界面刷新频率不宜过高，否则会影响串口数据的及时处理。一个实用的技巧是将数据接收处理和界面更新分线程处理，通过信号槽机制进行通信。