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 widgets

2.2 STM32开发环境准备

下位机端需要准备：

  1. STM32CubeMX：用于生成初始化代码
  2. Keil MDK或STM32CubeIDE：用于编译和调试
  3. 蓝牙模块驱动：如HC-05或HC-06的AT指令集文档

建议使用STM32F103C8T6这类性价比较高的芯片，它内置了USART接口，可以直接连接蓝牙模块。

3. 通信协议设计

3.1 数据帧格式定义

为了保证通信可靠性，需要设计简单的通信协议。一个典型的控制帧可以这样定义：

字节位置内容说明
00xAA帧头标识符
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：

  1. 启用USART1/2/3（根据实际硬件）
  2. 配置波特率为115200
  3. 启用接收中断
  4. 生成代码

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 常见问题排查

  1. 串口无法打开：

    • 检查设备管理器确认COM口号
    • 确保没有其他程序占用串口
    • 检查蓝牙模块是否已配对

  2. 数据接收不完整：

    • 确认双方波特率设置一致
    • 检查硬件连接是否稳定
    • 增加接收超时处理机制

  3. 控制响应延迟：

    • 优化数据帧长度
    • 增加数据校验重传机制
    • 检查STM32中断优先级设置

6.2 性能优化建议

  1. 使用DMA方式传输数据，减轻CPU负担
  2. 实现数据压缩，减少传输量
  3. 添加心跳包机制检测连接状态
  4. 实现数据缓存队列，处理突发数据

7. 功能扩展思路

  1. 实时数据显示： 使用Qt Charts模块实现速度、距离等数据的实时曲线显示

  2. 路径记录与回放： 添加SD卡模块，记录小车运动轨迹

  3. 摄像头监控： 通过WiFi模块传输实时视频流

  4. 自动避障： 添加超声波或红外传感器实现自动避障功能

在实际项目中，我发现蓝牙通信的稳定性对整体性能影响很大。建议在关键控制指令上添加应答机制，确保指令可靠执行。另外，Qt的界面刷新频率不宜过高，否则会影响串口数据的及时处理。一个实用的技巧是将数据接收处理和界面更新分线程处理，通过信号槽机制进行通信。